Skip to main content
Version: 4.42

Windows agent installation and deployment

Overview​

This guide provides comprehensive instructions for installing and uninstalling the Redtrust agent in Windows environments. It includes steps for standard installations, silent installations (automated setups with no user interaction), and server mode installations (for unattended environments). This guide is intended for system administrators or anyone responsible for deploying and configuring Redtrust.

By the end of this guide, you will have installed the Redtrust agent and be able to set up the platform.

Background​

These are the details of the three types of installation:

  • Standard installation: Installs the agent with a guided setup wizard.
  • Server mode installation: Designed for unattended environments where Windows server-based applications need centralized certificates without user interaction. Certificates are loaded into the machine certificate store, not the user store.
  • Silent installation: Runs the installation in the background without showing the wizard or requiring user input.

Before you start​

If you install Redtrust on Windows, ensure you have the installation package, including an installer (MSI) file and a batch file (BAT).

The right installation type depends on your environment. Use standard installation if you install the agent on an end-user machine with an active user session, or silent installation for mass deployment via GPO, SCCM, or similar systems. If Windows server applications need to access certificates without a logged-in user, use server mode installation: The agent runs no processes in user space and loads certificates into the machine certificate store, not the user store.

warning

Close Google Chrome and Microsoft Edge before you install or upgrade the agent, whichever installation method you use. The Redtrust extension keeps a helper process (RTExtensionHostNet.exe) running that locks files in the installation directory.

With a browser open, the standard installation wizard asks you to close those applications. Silent installation shows no dialog, so you don't get that prompt.

System requirements​

The machine must meet the following. The Visual C++ Redistributable and the .NET Desktop Runtime are mandatory only for silent installations:

  • Microsoft Windows 10 or 11 (64-bit or ARM64), or Windows Server 2022, 2019, or 2016.
  • .NET Framework 4.8. The installer doesn't install it and stops the installation if it's missing. Some operating systems include it by default.
  • Visual C++ Redistributable for Visual Studio 2015-2022, x64 and x86 packages.
  • Microsoft .NET Desktop Runtime, x64 and x86 packages.
  • Administrator privileges (required only during installation).

On ARM64 machines, install only the ARM64 package of the Visual C++ Redistributable and the .NET Desktop Runtime.

Up to Redtrust 4.42.1, the agent requires .NET Desktop Runtime 8. From Redtrust 4.42.2, it requires .NET Desktop Runtime 10.

Install the Visual C++ Redistributable and the .NET Desktop Runtime before you run the MSI, in versions equal to or higher than the ones the installer requires. If you install older versions, the installer treats them as missing.

In a standard installation, installing them first is recommended but not required. If either one is missing, the installer downloads it from Microsoft's servers, so the machine needs access to download.visualstudio.microsoft.com and builds.dotnet.microsoft.com.

warning

In a silent installation, you must install those components first. If one is missing, the installation fails.

Step 1: Install the agent​

Redtrust distributes the agent as an MSI package, which accepts multiple parameters listed in the parameters page. Two versions are available: one for 64-bit systems and a native ARM64 build.

The MSI filename includes the architecture: rt-agent-x64-VERSION-SUFFIX.msi for 64-bit and rt-agent-ARM64-VERSION-SUFFIX.msi for ARM64.

An example of agent installation can be the following:

msiexec /i rt-agent-x64-VERSION-SUFFIX.msi RTPRIMARY=PRIMARY_SERVER RTSECONDARY=SECONDARY_SERVER CLIENTID=YOUR_CLIENT_ID LANGUAGE=en-US AuthMode=ActiveDirectory

Where:

  • PRIMARY_SERVER and SECONDARY_SERVER are the addresses of the primary and secondary Redtrust servers.
  • YOUR_CLIENT_ID is the client identifier for your Redtrust installation.

A wizard guides you through the installation and lets you choose the installation directory. The process takes only a few seconds.

Welcome screen of the Redtrust installation wizard with the Back, Next, and Cancel buttons

info

The LANGUAGE and AuthMode values shown in the commands are examples; see the installation parameters page for valid values and other supported parameters. Running the installer without parameters installs the agent with default configurations.

Step 2: Configure the browser​

After installing the agent, configure browsers to enable Redtrust certificate management. Follow the steps defined in How to configure your browser.

note

If you installed the agent in unattended browsers mode (UNATTENDED_BROWSERS=1), skip this step: The browser extension isn't installed and isn't needed. This option is available from version 4.42.3 onwards. See Set up unattended browsers.

note

If your organization manages browsers through enterprise policies, also authorize the Redtrust native messaging host. Without that authorization, the extension installs but never connects to the agent. See How to authorize Redtrust native messaging in managed browsers.

Step 3: Verify the installation​

Test the installation by uploading and using a certificate, as explained in the initial configuration tutorial.

Uninstallation​

warning

Close Google Chrome and Microsoft Edge before you uninstall. With a browser open, the extension's helper process (RTExtensionHostNet.exe) locks files in the installation directory and the uninstallation can fail to complete, which leaves the old Redtrust extension registered.

Check that the uninstallation has finished before you install the new version. If the old and new extensions coexist in the browser, the agent doesn't work correctly.

You can uninstall Redtrust in two ways:

Interactive uninstallation

Use the standard Windows Programs and Features interface to remove Redtrust.

Unattended uninstallation

For unassisted uninstallation, use the msiexec command:

msiexec /x {5F567E45-9801-4122-9213-1731DBC44E11} /q

To retrieve the installed agent's Globally Unique Identifier (GUID), query the Windows registry with the following PowerShell command:

Get-ItemProperty HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\* |
Where-Object { $_.DisplayName -like "*Redtrust*" } |
Select-Object DisplayName, DisplayVersion, PSChildName

This command outputs details such as:

DisplayName    : RedTrust
DisplayVersion : 4.10.5
PSChildName : {5F567E45-9801-4122-9213-1731DBC44E11}

The PSChildName value is the GUID that you pass to msiexec.

Next steps​

Now that you've verified the installation, you can:

Was this page helpful?