System requirements

Required Linux packages

Checking if required packages are installed

Installing missing required packages

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:

• Red Hat Enterprise Linux ES version 8
• Red Hat Enterprise Linux ES version 9
• Oracle Linux 8
• Oracle Linux 9

Required Linux packages

Before installing the Entuity Agent on any supported Linux platform, these 64-bit packages must already be installed:

• nfs-utils.x86_64
• libstdc++.x86_64
• libnsl2.x86_64
• glibc.x86_64
• libgcc.x86_64

Note, the following shared libraries cannot be installed using dnf or yum, but are present, by default, on most Linux distributions:

• linux-vdso.so.1
• /lib64/ld-linux-x86-64.so.2

Checking if required packages are installed

From the server command line, you can use RPM Package Manager (RPM) to check if the required packages are installed.

For example, to check if the nfs-utils.x86_64 package is installed:

rpm -q nfs-utils.x86_64

• If the package is not installed, a message similar to the following is displayed.

  nfs-utils.x86_64 is not installed

• If the package is installed, RPM provides full details about the package in the output. 

  nfs-utils.x86_64

   

To check if all required packages are installed:

• Use the following command, with the multi-line indicator \.

  for i in nfs-utils.x86_64 glibc.x86_64 libgcc.x86_64 libnsl2.x86_64 libstdc++.x86_64 \
  do rpm -q $i ;done

Installing missing required packages

You must install any missing required packages on the server before installing an Entuity Agent.

Note, refer to the Linux documentation for your environment before installing any missing packages.

Red Hat Linux users need to register their system with Red Hat Network to receive updates.

Oracle Linux users can obtain the required packages from the Oracle Public Yum Server.

To install a required package: 

• Use the yum install command.
  For example, to install the nfs-utils.x86_64 package:

  yum install nfs-utils.x86_64 

To install all required packages:

• Use the yum install command, with the multi-line indicator \.

  yum install nfs-utils.x86_64 glibc.x86_64 libgcc.x86_64 libnsl2.x86_64 \
  libstdc++.x86_64 \

Downloading the Entuity Agent software

1. From Entuity, go to the Main Menu, Administration, and navigate to the Entuity Agent Administration page.
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

Please find below instructions on how to install the Entuity Agent, with the commands required at each step. Note that the commands in [square brackets] are not fixed - the user will need to create their own input.

1. On the Entuity server, navigate to the directory the rpm file was downloaded to and upload it to the desired server the agent software will be installed on. 
    

2. On the target server, navigate to the directory where the rpm file was uploaded via the command line. 

   cd /[directory-path]

    

3. Run the installer. Note, you must run the installer as root or with sudo as a regular user.

   rpm --nodeps -i entuity-agent-updater-1.0.0-[version].x86_64.rpm

    

4. When prompted, 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.

Confirming installation service status

1. From the Entuity Agent's command line, verify that the parkplacetech-agent-updater service is successfully running.

   systemctl status parkplacetech-agent-updater

    

2. If the Entuity Agent service is not installed, a message similar to the following is shown in the output. 

   Unit parkplacetech-agent-updater.service could not be found.

    

3. If the Entuity Agent service is installed, the service status is shown as loaded and active (running) in the output.

   parkplacetech-agent-updater.service - Entuity Agent Updater service
      Loaded: loaded (/etc/systemd/system/ parkplacetech-agent-updater.service; enabled; vendor preset: disabled)
      Active: active (running) since Wed 2025-05-07 12:53:36 EDT; 1 weeks 2 days ago
     Process: 1199 ExecStart=/opt/entuity/agent/agentupdater/bin/starteye (code=exited, status=0/SUCCESS)
    Main PID: 1426 (starteye)
      CGroup: /system.slice/ parkplacetech-agent-updater.service
              ├─1426 /opt/entuity/agent/agentupdater/bin/starteye
              └─1430 /opt/entuity/agent/agentupdater/lib/jdk/LINUX.x64/bin/java -server -Xrs -Xmx512m -Dentuity.cfg.dir=/opt/entuity...
   May 07 12:53:34 EntuityAgent systemd[1]: Starting Entuity Agent Updater service...
   May 07 12:53:36 EntuityAgent systemd[1]: Started Entuity Agent Updater service.

    

4. The Entuity Agent Updater service starts automatically as part of the installation process and will attempt to register to the Entuity server through the Entuity URL (from Step 5). Once successfully registered, it will self-update, install and start an additional collector service.

   • Note, this process might take 5-10 minutes from completing the Entuity Agent installation, depending on the speed of your internet connection.

    

5. After the installation of the collector service has completed, you can verify that it is successfully running with the following command.

   systemctl status parkplacetech-collector

    

6. If the collector service is installed and running, the collector service status is shown as loaded and active (running) in the output, similar to the Entuity Agent service (see Step 3).

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.

   systemctl stop parkplacetech-agent-updater.service 
   systemctl stop parkplacetech-collector.service

    

2. Edit the agent.cfg file, located in the /opt/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.

   systemctl start parkplacetech-collector
   systemctl start parkplacetech-agent-updater

Uninstalling an Entuity Agent

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

1. Stop the Entuity Agent and collector services.

   systemctl stop parkplacetech-agent-updater.service 
   systemctl stop parkplacetech-collector.service

    

2. Uninstall the Entuity Agent service.

   rpm -e entuity-agent-updater

    

3. Manually delete the collector service.

   systemctl disable parkplacetech-collector.service
   rm /etc/systemd/system/parkplacetech-collector.service -f
   systemctl daemon-reload
   systemctl reset-failed

    

4. Remove the agent files.

   rm -rf /opt/Entuity/agent

Important note regarding reinstalling Entuity Agent software:

Be sure to remove all agent files from the Linux 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.