System Requirements

Downloading the Entuity Agent Software

Installing an Entuity Agent

Confirming Installation Service Status

Configuring Proxy Use With an Entuity Agent (Optional)

Uninstalling an Entuity Agent

Important note regarding reinstalling Entuity Agent software

System requirements

The Entuity Agent is only certified for use with the 64-bit English edition variants of:

• Windows Server 2019
• Windows Server 2022
• Windows Server 2025

Downloading the Entuity Agent software

1. From Entuity, go to the Main Menu, Administration, and navigate to the Entuity Agent Administration section.
2. Click Entuity Agent Software, which brings you to the page where you can download the installer.
3. Select the installer based on the operating system of the server onto which you'll install the software.
   • Note, options are an msi installer for Windows and an rpm installer for Linux.
4. Download the installer, and then navigate to the Entuity Agents page from the Entuity Administration page.
5. Click Add Agent, and on the registration form that opens, enter a unique name for the Entuity Agent.
   The Entuity URL field on the form is automatically populated with a custom URL to which the agent can connect, but you can optionally edit the field to create a custom endpoint.
6. Once the form is submitted a new agent ID is generated and an installation token is displayed which will need to be used during agent installation.

Installing an Entuity Agent

Note, you must have local administrator permissions to run the Entuity Agent installer.

1. Navigate to the directory where you downloaded the msi installer file, and upload the file to the server where you'll install the Entuity Agent software. 
2. From the server, double-click or right-click the EntuityAgentUpdater-[version].msi installer file.
   The Setup Wizard popup window is displayed.
3. From the Setup Wizard, click Install, and then click Next. 
4. Enter the installation registration token that was generated on the Agent Management page (see Step 6).
   • Note, if you receive a "Please enter valid registration token." message, verify that the registration token you entered matches the one provided on the Agent Management page.
5. Click Next to accept the default installation path, or optionally enter a custom installation path.
6. Click Finish to complete the installation.

Confirming installation service status

1. Open the Windows Services snap-in tool and locate the Entuity Agent Updater service. Verify that its Status value is Running and its Startup Type value is Automatic.
2. Upon completion of the Entuity Agent installation, the Entuity Agent Updater service automatically starts running, and then attempts to register the Entuity server through the Entuity URL (from Step 5). If the Entuity Agent Updater service successfully registers the server, the service then self-updates, installs, and starts an additional collector service, Entuity Collector. 
   • Note, this process might take 5-10 minutes from completing the Entuity Agent installation, depending on the speed of your internet connection.
3. After the installation of the Entuity Collector service has completed, verify the Status value is Running and the Startup Type value is Automatic for the Entuity Collector service.

Configuring proxy use with an Entuity Agent (optional)

You can use a proxy with the Entuity Agent so that all communication goes through the proxy instead of directly between the Entuity Server and the Entuity Agent.

1. Stop the Entuity Agent and collector services.

   • In the Windows Services snap-in tool:
     • Locate and stop the following services:
       • Entuity Agent Updater
       • Entuity Collector

   • In command prompt, enter the following commands:

     sc.exe stop ParkPlaceTechCollector
     sc.exe stop ParkPlaceTechAgentUpdater

    

2. Edit the agent.cfg file, located in the C:\Program Files\Entuity\Agent\etc directory, by adding an httpProxy element in the format below. 

   <httpProxy>user:password@host:port</httpProxy>
   <httpProxy>host</httpProxy>

   The user, password, and port values are optional. In most cases, authentication is not used, and the proxy uses the standard port (3128), so only the host is required.

    

3. Save the agent.cfg file, and restart both Entuity Agent services:
   • In the Windows Services snap-in tool:
     • Locate and restart the following services:
       • Entuity Agent Updater
       • Entuity Collector

   • In command prompt, enter the following commands:

     sc.exe start ParkPlaceTechCollector
     sc.exe start ParkPlaceTechAgentUpdater

Uninstalling an Entuity Agent

You can fully uninstall an Entuity Agent by removing both Entuity Agent services, and then deleting the associated Agent directory from the server.

1. From command prompt, manually stop both Entuity Agent services.

   sc.exe stop ParkPlaceTechCollector
   sc.exe stop ParkPlaceTechAgentUpdater

    

2. Navigate to the directory where the msi installer file (see Step 2) was uploaded onto the server, right-click the EntuityAgentUpdater-[version].msi installer file, and select Uninstall. 
    

3. Return to the command prompt window, and delete the Entuity Collector service.

   sc.exe delete ParkPlaceTechCollector

    

4. Navigate to C:\Program Files\Entuity, and delete the Agent directory. 

Important note regarding reinstalling Entuity Agent software:

Be sure to remove the Agent directory from the Windows server before attempting to reinstall an Entuity Agent. Otherwise, old agent files could cause issues with the newly installed agent, such as preventing agent registration or agent application installations.