Skip to main content
Most integrations run as the signed-in Windows user with no special rights. A few capture methods need administrator rights. Integration admin access installs a protected Windows component once. That component starts those integrations with administrator rights each time they run, so no one approves a Windows prompt at each start or update.
Integration admin access is Windows only. Two features use it: the RHEED Camera (GenTL) integration’s Network (GVSP Tap) frame source, which is the default, and the read-only Windows diagnostics of the Gateway assistant, the in-app helper for setup and computer issues. The Standard (GenTL) frame source doesn’t need it. Enable it on every workstation so integrations you add later work without another visit from an administrator.

Turning It On

There are three places to turn it on. All show the same Windows prompt, which someone with administrator credentials on the computer must approve once. The prompt names Windows PowerShell, verified publisher Microsoft Windows, because Atomscale runs its signed setup through PowerShell. It may open behind the Atomscale window. The setup checks that the component is signed by Atomic Data Sciences, Inc before installing it. Integrations that use admin access and are running at the time are paused briefly and restarted with administrator rights. If setup doesn’t complete, the setting stays off with Integration admin access setup did not complete. No setting was changed. Admin access can’t be turned on from the web app. For a remote gateway, the web app’s configuration page tells you to turn it on at the computer.

What It Installs

The setup is tied to the Windows user who enabled it and to this installation of Atomscale. When an elevated integration starts, the launcher copies it into the protected folder, checks its signature, and runs it there. The integration still has no network access to Atomscale and hands all data to the desktop app for upload.

When It Needs Repair

When a desktop app update ships a newer component, the setting shows An update to Integration admin access is available. An integration that needs the newer component shows … needs an update to Integration admin access on this computer. Click Update integration admin access in Settings, or Update admin access on the integration’s page, and approve the Windows prompt. The setting shows Integration admin access needs repair when the installed component no longer matches the app, for example:
  • A different Windows user is signed in to the computer.
  • An administrator or security software removed part of the setup.
Integrations that need admin access then fail to start with “Could not start integration with admin access: Integration admin access setup is missing or out of date.” Open Settings, click Repair integration admin access, and approve the Windows prompt. The RHEED configuration page offers the same with Repair admin access.

Turning It Off

Turn off Allow integration admin access and confirm with Disable. Windows asks for administrator approval once, then the scheduled task, launcher, protected folder, and firewall rules are removed. The setting turns off only after removal succeeds; if it fails, you see Integration admin access could not be removed. The setting is still on. With the setting off, integrations that need administrator rights can’t capture. A RHEED integration using Network (GVSP Tap) reports that it needs Integration admin access.

Uninstalling Atomscale

The uninstaller removes integration admin access automatically, asking for administrator approval only if it’s present. If removal fails, the uninstall continues and reports what was left behind; an administrator can then remove the components listed above by hand. The Atomscale Elevated Capture event log source is left in place so earlier events stay readable.

Troubleshooting

  • Setup or removal failed: Open Event Viewer, go to Windows Logs > Application, and look for errors from the source Atomscale Elevated Capture. Each event includes the output of the failed step. Administrative steps time out after 3 minutes, including the time spent on the approval prompt.
  • An elevated integration doesn’t start: Check C:\ProgramData\Atomscale\Atomscale\elevated-cache\launcher.log. The error elevated launcher did not connect in time points to this file.
  • Security software blocked the setup: Endpoint protection may block creating scheduled tasks or firewall rules. Ask IT to allow the signed launcher, then repair the setting.