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

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:

• Red Hat Enterprise Linux ES version 8
• Red Hat Enterprise Linux ES version 9
• Debian 12
• Debian 13
• Ubuntu 24.04 LTS
• Ubuntu 26.04.1 LTS 
• 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) (for Red Hat and Oracle Linux) or dpkg (for Debian and Ubuntu Linux) to check if the required packages are installed.

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

• for Red Hat and Oracle Linux:

  rpm -q nfs-utils.x86_64

• for Debian and Ubuntu Linux:

  dpkg -l | grep "nfs-utils.x86_64"

If the package is not installed, either no output or a message similar to the following is displayed:

nfs-utils.x86_64 is not installed

If the package is installed, details of the package are displayed in the output:

nfs-utils.x86_64

To check if all required packages are installed:

• For Red Hat and Oracle Linux, 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

• For Debian and Ubuntu Linux, use the following command, with the multi-line indicator \:

  apt list --installed nfs-utils.x86_64 glibc.x86_64 libgcc.x86_64 libnsl2.x86_64 \ 
  libstdc++.x86_64 \

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.

Debian and Ubuntu Linux users can obtain the required packages from official online repositories using the Advanced Package Tool (APT). 

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

To install a required package: 

• For Red Hat and Oracle Linux, use the yum install command.
  For example, to install the nfs-utils.x86_64 package:

  yum install nfs-utils.x86_64 

• For Debian and Ubuntu Linux, use the apt install command.
  For example, to install the nfs-utils.x86_64 package:

  apt install nfs-utils.x86_64

To install all required packages:

• For Red Hat and Oracle Linux, 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 \

• For Debian and Ubuntu Linux, use the apt install command, with the multi-line indicator \.

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

Downloading the Entuity Agent software

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

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. Do one of the following to download the Entuity Agent installer, based on the operating system of the server onto which you plan to install the software:

   • Click Download RPM (for Red Hat and Oracle Linux) or Download DEB (for Debian and Ubuntu Linux).
     
     Alternatively:
      
   • Run one of these commands at a Linux shell (Requires root privileges.):

     • For Red Hat and Oracle Linux:

       rpm -nodeps -ivh http://[local host]/EOS/entuityAgent/entuity-agent-updater-[version].x86_64.rpm

     • For Debian and Ubuntu Linux:

       dpkg -i http://[local host]/EOS/entuitySurePathAgent/entuity-agent-updater-[version]_amd64.deb
        

4. Return to the Entuity Administration page, navigate to the Entuity Agent Administration section, and click Entuity Agents.
   The Entuity Agents page is displayed.
5. 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.
6. 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. 
7. Copy the registration token, as you must enter the token later during agent installation.

Installing an Entuity Agent

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 rpm or deb installer file (see Step 3), 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. 

   cd /[directory path]

    

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

   For Red Hat and Oracle Linux:

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

    

   For Debian and Ubuntu Linux:

   apt install entuity-agent-updater-[version]_amd64.deb

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

Confirming installation service status

1. From the command line of the Entuity Agent, 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 displayed 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.

   
   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.

    

4. After the installation of the collector service completes, you can verify that the service is successfully running with the following command:

   systemctl status parkplacetech-collector

   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).

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.

   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 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.

   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.

   For Red Hat and Oracle Linux:

   rpm -e entuity-agent-updater

    

   For Debian and Ubuntu Linux:

   apt purge entuity-agent-updater
   apt autoremove

    

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.