System Requirements

Downloading the Entuity Agent Software

Installing an Entuity Agent

Confirming Installation Service Status

Trusting certificates on an Entuity Agent

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 the Main Menu, click Administration and navigate to the Entuity Agent Administration section of the Entuity Administration page.
2. Click Entuity Agent Software, which brings you to a page where you can download the Entuity Agent installation packages.

3. Select the installer based on the operating system of the server onto which you plan to install the software.

   Note, options are an msi installer for Windows, an rpm installer for Red Hat and Oracle Linux, and a .deb installer for Debian and Ubuntu Linux.

4. Download the installer, and then return to the Entuity Administration page.
5. Navigate to the Entuity Agent Administration section of the page and click Entuity Agents.
   The Entuity Agents page is displayed.
6. Click Add Agent, and on the Register form that opens, enter a unique name for the Entuity Agent. 
   Note, the Entuity URL field on the Register 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.
7. Click Done on the Register form to save your changes. Otherwise, click Cancel.
   Once the form is submitted, a new agent ID is generated and a registration token is displayed. 
8. Copy the registration token, as you must enter the token later during agent installation.

Installing an Entuity Agent

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

Note, the commands in [square brackets] in the following procedure are variables - you must enter your own input.

1. On the Entuity server, navigate to the directory where you downloaded the msi installer file, and then upload the file to the server onto which you plan to install the agent software. 
2. On the target server, navigate to the directory where you uploaded the installer file in the previous step, and 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 Entuity Agents 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 Entuity Agents 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. From the Entuity Agent, open the Windows Services snap-in tool and locate the Entuity Agent Updater service. 

2. Verify that the Status value of the Entuity Agent Updater service is Running and the Startup Type value is Automatic.

   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, the Entuity Collector service.
   
   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 completes, verify the Status value of the Entuity Collector service is Running and the Startup Type value is Automatic.

Trusting certificates on an Entuity Agent

If the Entuity server is configured to use SSL communication with a self-signed or wildcard certificate, the Entuity Agent might fail to register with the Entuity server, as the Java SSL implementation does not trust the certificate of the Entuity server. To address this issue, the certificate of the Entuity server must be imported into the keystore of the Entuity Agent, or a full chain certificate must be used on the server. For instructions on how to trust a certificate, see this article. 

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

   • At the 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 following format: 

   <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

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

Note, the commands in [square brackets] in the following procedure are variables - you must enter your own input.

1. At the command prompt, manually stop both Entuity Agent services.

   sc.exe stop ParkPlaceTechCollector
   sc.exe stop ParkPlaceTechAgentUpdater

    

2. Navigate to the directory where you uploaded the msi installer file (see Step 2), 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.