Pular para o conteúdo principal

Set Up OmegaAI Link Caching

Loading every image from the OmegaAI server is slow and costly. With Link caching, OmegaAI Link also runs as a lightweight, secure web server. It keeps a copy of the image pixel data it receives, so computers at your site can load images over your local network instead.

This article explains how Link caching works, how to find your Link's cache address, and how to set up a computer to use it.

Before You Begin​

  • When images come from the cache: OmegaAI loads images from a Link's cache only when the computer viewing them has the same public IP address as the Link. Otherwise, images load from the cloud, where browser pre-caching still helps (see How Browser Pre-Caching Works). All Links at a site should share the same public IP address.
  • How Link is identified: Link is verified by its IP address.
  • How cached images are protected: To keep protected health information (PHI) secure, pixel data is encrypted before it's written to the local cache. This prevents unauthorized access to sensitive content stored on the device. Link uses the AES-GCM encryption algorithm, which protects both confidentiality and integrity.
  • How the cache server runs: The secure web server starts when Link starts. It uses a domain certificate, so it's served over HTTPS.
  • How long images are kept: Cached images older than 30 days are deleted. If the drive gets too full, the oldest images are deleted first, so the cache keeps 20% of the drive free.
  • Port: The cache server uses port 443, or the next free port if 443 is in use.

Link can also cache images before anyone opens them, so studies load faster the first time:

  1. When a user signs in, OmegaAI starts pre-caching.
  2. If a Link is available, OmegaAI asks it for specific pixel data.
  3. If the Link doesn't have that data yet, it gets it from the server and caches it.

Expected result: The next time a user opens the study, its images load from the Link.

Each Link's cache server has its own subdomain of omegaailink.com:

OMEGAAILINK-{link-id}-{organization-name}.omegaailink.com
  • {link-id}: Found in the DICOM server configuration file, C:\Program Files\RamSoft.OmegaAILink\DicomServerConfig.json.
  • {organization-name}: The organization name, using only letters and numbers. Every other character is replaced with a hyphen (-).

In the configuration file, the Link ID is the ID value. For example, in this excerpt, the Link ID is 318:

"DicomServerAeTitle": "CORSAIR",
"ID": 318,

Set Up A Computer To Use The Cache​

  1. On the computer you view images on, open Notepad as an administrator.

  2. Open the Windows hosts file, C:\Windows\System32\drivers\etc\hosts. This file tells the computer which IP address to use for a domain name.

  3. Add a line with the Link computer's local IP address, one space, and the Link's domain name. For example:

    #local-ipaddress domainname
    192.168.XX.XX OMEGAAILINK-{link-id}-{organization-name}.omegaailink.com

    The first line, starting with #, is an optional comment that shows the format. When you type the entry:

    • Spacing: Use exactly one space between the IP address and the domain name.
    • Letter case: Type OMEGAAILINK in uppercase. Type the organization name in the same letter case as it's entered in OmegaAI.
  4. Save the file.

  5. Restart the RamSoft Omega AI Link Service.

  6. To test the address, open it in a browser:

    https://OMEGAAILINK-{link-id}-{organization-name}.omegaailink.com/DICOMcache

Expected result: The page shows the message Get Image blob API. This means Link caching is set up.

Troubleshooting​

ProblemWhat to check
The test address doesn't open, or doesn't show Get Image blob APICheck that the hosts file entry has exactly one space, OMEGAAILINK is uppercase, and the organization name matches the letter case in OmegaAI. Make sure you restarted the Link service after saving.
The domain doesn't match your LinkCheck that you used the ID value from DicomServerConfig.json, and that every non-alphanumeric character in the organization name is replaced with a hyphen.