Applicable to Entuity v23.0 GA.
Downloading the Entuity Agent Software
Confirming Installation Service Status
Configuring Proxy Use With an Entuity Agent (Optional)
Important note regarding reinstalling Entuity Agent software
Entuity recommends creating and maintaining your own documentation and notes of the specifics of your installation to better inform future users. These details will also help if you need to contact the Entuity Support team.
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
- From Entuity, go to the Main Menu, Administration, and navigate to the Entuity Agent Administration section.
- Click Entuity Agent Software, which brings you to the page where you can download the installer.
- Select the installer based on the operating system of the server onto which you'll install the software.
-
Note, options are an
msiinstaller for Windows and anrpminstaller for Linux.
-
Note, options are an
- Download the installer, and then navigate to the Entuity Agents page from the Entuity Administration page.
-
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. - 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.
- Navigate to the directory where you downloaded the
msiinstaller file, and upload the file to the server where you'll install the Entuity Agent software. -
From the server, double-click or right-click the
EntuityAgentUpdater-[version].msiinstaller file.
The Setup Wizard popup window is displayed. - From the Setup Wizard, click Install, and then click Next.
- 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.
- Click Next to accept the default installation path, or optionally enter a custom installation path.
- Click Finish to complete the installation.
Confirming installation service status
- 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.
- 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.
- 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.
-
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
- Locate and stop the following services:
-
In command prompt, enter the following commands:
sc.exe stop ParkPlaceTechCollector sc.exe stop ParkPlaceTechAgentUpdater
- In the Windows Services snap-in tool:
-
Edit the
agent.cfgfile, located in theC:\Program Files\Entuity\Agent\etcdirectory, by adding anhttpProxyelement 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.
- Save the
agent.cfgfile, and restart both Entuity Agent services:- In the Windows Services snap-in tool:
- Locate and restart the following services:
- Entuity Agent Updater
- Entuity Collector
- Locate and restart the following services:
-
In command prompt, enter the following commands:
sc.exe start ParkPlaceTechCollector sc.exe start ParkPlaceTechAgentUpdater
- In the Windows Services snap-in tool:
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.
-
From command prompt, manually stop both Entuity Agent services.
sc.exe stop ParkPlaceTechCollector sc.exe stop ParkPlaceTechAgentUpdater
- Navigate to the directory where the
msiinstaller file (see Step 2) was uploaded onto the server, right-click theEntuityAgentUpdater-[version].msiinstaller file, and select Uninstall.
-
Return to the command prompt window, and delete the Entuity Collector service.
sc.exe delete ParkPlaceTechCollector
- Navigate to
C:\Program Files\Entuity, and delete theAgentdirectory.
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.
Comments
0 comments
Please sign in to leave a comment.