Agent Installation

⚙️ Install GermainUX-Agent

📋 System Requirements

Before installing GermainUX-Agent, confirm that the target machine meets these requirements:

The Agent requires elevated privileges to detect and monitor application processes. If it starts without sufficient privileges, it displays an error and exits instead of operating with limited functionality.

📦 Select the Appropriate Installer

Two installation packages are available. They serve different purposes and are not simply equivalent 32-bit and 64-bit versions.

💻 Setup64

Use Setup64.msi for almost every deployment.

It installs:

This is the primary package required for real-user monitoring and Session Replay of native Windows applications.

⚙️ Setup x86

Install the x86 package only when:

The x86 package does not include GermainUX-Agent or RUM Windows.

Both packages can be installed on the same machine. They use separate product identities, installation directories, and upgrade configurations.

⬇️ Install the Agent

1. Launch Setup64.msi with administrator privileges.

2. On the welcome screen, click Next.

3. Enter the base URL of your GermainUX Enterprise environment.

4. Click Next.

5. Accept the default destination folder or choose another installation directory.

6. Click Install.

7. When installation is complete, click Finish.

8. Sign out and sign back in using a local administrator account.

The GermainUX URL can point to either:

Enter only the base URL provided for your organization.

✅ After Installation

The Agent does not start immediately when the installer finishes. It starts automatically the next time a local administrator signs in.

After signing in:

1. Confirm that the GermainUX-Agent icon appears in the Windows system tray.

2. Right-click the icon.

3. Confirm that Monitoring Enabled is selected.

4. Select Refresh Config to retrieve the latest configuration.

5. Open Configurations and confirm that the expected monitored application is listed.

6. Start or restart the monitored application.

7. Verify that telemetry appears in GermainUX Workspace.

📁 Installed Files

The standard 64-bit package installs the following primary files:

Do not independently move or rename these files. GermainUX-Agent locates RUM Windows and Code Profiler in the same directory as its own executable.

Moving one component without the others can prevent monitoring from starting correctly.

🚀 Automatic Startup

GermainUX-Agent must:

Because of these requirements, it does not run as a conventional Windows service.

The installer creates a machine-wide Windows Scheduled Task that:

👤 Administrator Account

When a local administrator signs in, the Agent starts automatically with the required privileges.

⛔ Non-Administrator Account

When a non-administrator signs in, the Scheduled Task cannot provide the elevation required by the Agent. The Agent displays an insufficient-privileges error and exits.

For machines dedicated to monitoring, ensure that the account that remains signed in is a local administrator.

The Scheduled Task is created during installation and removed during uninstallation. It can be reviewed using Windows Task Scheduler.

🖥️ Install the 32-Bit Code Profiler

When CLR-level monitoring is required for a 32-bit .NET application:

1. Install Setup64.msi to provide GermainUX-Agent and RUM Windows.

2. Install the x86 package on the same machine.

3. Enter the same GermainUX Enterprise URL when prompted.

4. Complete the installation.

5. Restart the monitored 32-bit application.

6. Validate that Code Profiler telemetry appears in GermainUX Workspace.

The x86 package may also be installed by itself if only 32-bit .NET profiling is required and GermainUX-Agent or RUM Windows is not needed.

⬆️ Upgrade

To upgrade GermainUX-Agent:

1. Obtain the newer installer.

2. Run it with administrator privileges.

3. Complete the installation using the existing installation location.

4. Sign out and sign back in if the Agent does not restart automatically.

5. Confirm the installed version from the system-tray menu.

6. Validate monitoring and data transmission.

An in-place upgrade preserves the existing GermainUX URL and other Agent settings.

The installer prevents an older version from being installed over a newer version.

🔧 Repair

Use the Windows repair option when installed files or installer-managed configuration may be damaged.

A repair:

After repairing the installation, sign out and sign back in before validating the Agent.

🗑️ Uninstall

To remove GermainUX-Agent:

1. Open Windows Settings > Apps > Installed apps or Control Panel > Programs and Features.

2. Select GermainUX-Agent.

3. Click Uninstall.

4. Complete the removal process.

Uninstallation removes:

Manually created monitoring rules under the following Registry location may remain:

HKLM\SOFTWARE\Germain Software\Germain Agent\Targets

Remove these rules manually if the machine will no longer be monitored.

If the optional 32-bit Code Profiler is installed, uninstall it separately.

✅ Validate the Installation

A successful installation should meet all of the following conditions:

If any of these checks fail, see: