What Is The OmegaAI Link Guardian?
The OmegaAI Link Guardian is a Windows service that runs on the same computer as OmegaAI Link. It keeps Link running, and it makes Link updates safe, so your site can keep sending and receiving studies. This article is for the IT team that looks after the Link computer.
Before You Begin
- No setup needed: The Guardian is installed automatically with Link, or with Link's next update. There's nothing to download or turn on.
- Administrator access: You need administrator access to the Link computer only if you stop Link for maintenance.
What The Guardian Does
One Guardian looks after every Link on the computer. It has two jobs:
- Keep Link running: If Link stops or stops responding, the Guardian starts it again.
- Keep updates safe: When Link updates, the Guardian checks that the new version works. If it doesn't, the Guardian switches Link back to the version it was running before.
What To Expect From Link Updates
RamSoft schedules and manages Link updates, so you don't need to start or approve them. Link installs updates during the quiet period it learns from your site's traffic. Link stops briefly while it switches to the new version.
If an update doesn't work, Link goes back to the version it was running and keeps working. The update is tried again later.
What You'll See On The Link Computer
- A new Windows service: RamSoft Omega AI Link Guardian, set to start automatically. There's one per computer, however many Links the computer runs.
- No other changes: Link's own service names, accounts, ports, settings, logs, and firewall rule stay the same, including after every update.
Important: Don't stop or disable the RamSoft Omega AI Link Guardian service, except when you uninstall Link. Without it, Link isn't restarted if it stops, and updates can't be checked.
Where Link's Files Are
After Link gets the Guardian, its files are organized differently inside the install folder. This is expected. Link isn't broken or out of date.
C:\Program Files\RamSoft.OmegaAILink\
├── configs\ Link's settings: edit these
│ ├── appsettings.json
│ └── DicomServerConfig.json
├── versions\
│ ├── 1.3.24728-994360\ previous version, kept so Link can go back to it
│ └── 1.3.24919-996883\ version that's running now
├── logs\ Link's logs (unchanged)
├── state\ used by Link and the Guardian: don't edit
├── .guardian\ used by Link and the Guardian: don't edit
├── RamSoft.OmegaAILink.exe, *.dll old program files: removed after the next update
└── appsettings.json, DicomServerConfig.json old copies: no longer used
The version folder names in this example will differ on your computer.
- configs: Link's settings. Every version uses these files.
- versions: The Link program. Each version has its own folder. The newest is the one running, and the one before it is kept so Link can go back to it.
- logs: Link's logs. Unchanged.
- state and .guardian: Files Link and the Guardian use to manage updates. Don't edit or delete them.
- Old files at the top level: The program files,
appsettings.json, andDicomServerConfig.jsonfrom before the change. Link no longer uses them. The old program files are removed after the next update.
Important: To change a Link setting, edit the file in the
configsfolder. Theappsettings.jsonandDicomServerConfig.jsonfiles at the top level are no longer read, so changes there have no effect.
Stop Link For Maintenance
Important: Before you stop Link for maintenance, set its Windows service to Manual. Otherwise, the Guardian starts Link again within about a minute.
- On the Link computer, open Services.
- Open the Link service, and set Startup type to Manual.
- Stop the Link service.
- Do your maintenance.
- Set Startup type back to Automatic.
- Start the Link service.
Expected result: Link stays stopped while you work. After you set it back to Automatic and start it, the Guardian looks after it again.
Caution: If you leave the Link service set to Manual, the Guardian won't restart Link if it stops.
Troubleshooting
| Problem | What to do |
|---|---|
| Link starts again after you stop it | This is expected. Set the Link service to Manual first. See Stop Link For Maintenance. |
| Link keeps stopping | Contact RamSoft Support. |
| Link isn't running after an update | Contact RamSoft Support right away. |
| You want a failed update tried again sooner | Contact RamSoft Support. |
When you contact RamSoft Support, include the Link name and the computer it runs on.
For connection problems, see OmegaAI Link is offline or studies aren't crossing.
Related Articles
- What Is OmegaAI Link?: How Link moves and protects your data.
- Install And Uninstall OmegaAI Link: Install Link, or remove it along with the Guardian.
- Add and set up an OmegaAI Link device: Add a Link device and download the installer.