Pular para o conteúdo principal

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.

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.

  • 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.

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, and DicomServerConfig.json from 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 configs folder. The appsettings.json and DicomServerConfig.json files at the top level are no longer read, so changes there have no effect.

Important: Before you stop Link for maintenance, set its Windows service to Manual. Otherwise, the Guardian starts Link again within about a minute.

  1. On the Link computer, open Services.
  2. Open the Link service, and set Startup type to Manual.
  3. Stop the Link service.
  4. Do your maintenance.
  5. Set Startup type back to Automatic.
  6. 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​

ProblemWhat to do
Link starts again after you stop itThis is expected. Set the Link service to Manual first. See Stop Link For Maintenance.
Link keeps stoppingContact RamSoft Support.
Link isn't running after an updateContact RamSoft Support right away.
You want a failed update tried again soonerContact 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.