Quick Links

Us2.AI Workflow Overview

Us2.AI Cloud + DICOM Router Installation

Us2.AI Setup DICOM Router

Us2.AI On Premises Installation

Requirements

• Will need to have an Us2.ai account
• Machine

  • Windows/Linux OS

  • DICOM Router software - choose a method of deployment:

    • Python
    • Docker
    • Installer
    • Executable

    <aside> 💡

    • Note that if the link gives the following 400 error, you will need to sign in on https://app.us2.ai </aside>

    

  • 2gb RAM per worker - Workers adjusted depending on workload

  • Static IP

• Firewall
  • Outbound
    • Port 443 (Us2.ai cloud https://api.us2.ai)
      • Also need to enable regional URLs i.e. https://us-east-1.api.us2.ai for US
      • Enable traffic to <bucket>.s3.amazonaws.com and <bucket>.s3.<region>.amazonaws.com
        • Region: bucket as per below
          • ap-northeast-1: upload-production-ap-northeast-1-xal0l3pxmxrpm0mh
          • ap-south-1: upload-production-ap-south-1-9no09hkkmussry4m
          • ap-southeast-1: upload-production-ap-southeast-1-v7c51hihgi7ku752
          • ap-southeast-2: upload-production-ap-southeast-2-z6l574nw6lykqjbt
          • ca-central-1: upload-production-ca-central-1-jhwrpcpb3gh1edip
          • eu-central-1: upload-production-eu-central-1-yedanni27i4h1d2i
          • us-east-1: upload-production-us-east-1-ng93c78urer2hncv
    • On-site PACS
  • Inbound
    • Port 11112 (from On-site PACS and/or Echo machines)

Setup

1. Log into the provided https://app.us2.ai/ account

2. Setup API Key

   1. Click username top right

   2. Click Settings

      

   3. Find the API Key tab

   4. Hit Create New Key

      

   5. Type in name for the API Key, i.e. Dicom Router

      

   6. Copy and save the API Key displayed on screen

3. Adjust settings on DICOM Router tab as desired

   

   1. Once settings has been updated, hit Save
   2. Once saved the router will automatically load the new configuration, so shouldn’t need to restart the service

4. Download router installer from https://app.us2.ai/cloud-assets/echoloader-installer.exe

   1. Note you need to be signed into the application to use this link
   2. If you get a 400 error, simply access https://app.us2.ai/ and try again

5. Run the installer

   1. Due to the installer not being signed, a warning might be shown
   2. Accept license agreement
   3. Setup with Us2.ai account
   4. Select folder where the DICOM Router should be installed
   • The Router should now be installed and running as a service [Us2.ai](<http://us2.ai/>) Echoloader

• for Linux use this command

Sending images to US2.AI Cloud

• The router by default will listen on port 11112
• Can Download demo data to send here ‣
• Can use https://dicom.offis.de/en/dcmtk/dcmtk-tools/ to send data to the router

Sending Us2.ai results back to PACS

• Need to get IP, port and AET of the PACS
• Go to settings > Workflow Integration > DICOM Router > Sync
• Expand the sync tab
• Fill in details of PACS

Echoloader Upload Guide

Use the web server URL:

<http://localhost/api>