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
- OmegaAI Link: Link must be added in OmegaAI (Add and set up an OmegaAI Link device) and installed and running. See Install And Uninstall OmegaAI Link.
- Link caching turned on: RamSoft turns on Link caching for each Link. To use it, contact RamSoft Support.
- Administrator access: You need administrator rights on the computer where you edit the hosts file.
- Link ID: You need the Link ID from the DICOM server configuration file. See Find Your Link's Cache Address.
How Link Caching Works
- 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.
Predictive Link Caching
Link can also cache images before anyone opens them, so studies load faster the first time:
- When a user signs in, OmegaAI starts pre-caching.
- If a Link is available, OmegaAI asks it for specific pixel data.
- 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.
Find Your Link's Cache Address
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
-
On the computer you view images on, open Notepad as an administrator.
-
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. -
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.comThe 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
OMEGAAILINKin uppercase. Type the organization name in the same letter case as it's entered in OmegaAI.
-
Save the file.
-
Restart the RamSoft Omega AI Link Service.
-
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
| Problem | What to check |
|---|---|
The test address doesn't open, or doesn't show Get Image blob API | Check 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 Link | Check that you used the ID value from DicomServerConfig.json, and that every non-alphanumeric character in the organization name is replaced with a hyphen. |
Related Articles
- What Is OmegaAI Link?: How Link moves and protects your data.
- Install And Uninstall OmegaAI Link: Install Link on a dedicated computer.
- How Browser Pre-Caching Works: How the browser pre-caches studies, with or without a Link.
- Add and set up an OmegaAI Link device: Set up the Link device in OmegaAI.