Install Agent Handlers

Prev Next

Install Agent Handlers in your environment to help manage agent-server communication and load balancing. You can install Agent Handlers at any time.

Update the system with the latest Microsoft security updates, then turn off Windows updates during the installation process.

Each ePO - On-prem server contains a main Agent Handler. Installing more Agent Handlers can help manage an increased number of products and systems managed by one ePO - On-prem server in situations where the CPU and IO on the database server is not overloaded.

Agent Handlers require the same high-speed network access to your database as the primary ePO - On-prem server.

Important

Install additional Agent Handlers in the same data center as the SQL Server. Do not install Agent Handlers in remote locations or you risk impacting the performance of the entire ePO - On-prem environment.

To use more IP addresses for agent-server communication, create an Agent Handler group, and add the additional IP address to the virtual IP address input field.

  1. Open the folder where you extracted the contents of the ePO - On-prem software installation package.

  2. Copy the Agent Handler folder to the intended Agent Handler server system.

  3. Right-click Setup.exe and select Run as Administrator to start the Trellix Agent Handler InstallShield wizard.

    After some installation activities take place in the background, the InstallShield wizard opens. Click Next to begin the installation process.

  4. Accept the terms in the license agreement.

    The Destination Folder step opens

  5. Accept the default destination or click Change to select a different destination, then click Next.

    Important

    The destination path must not contain double-byte characters. The path characters are a limitation of the Apache web server. Using double-byte characters causes the installation to fail and the Apache web server service to fail on startup.

  6. Configure the server information.

    1. Type the system name of the ePO - On-prem server with which the Agent Handler must communicate.

    2. Specify which port to use for Agent Handler-to-server communication. The default port is 8443, the same port used for client-to-server authenticated communication.

    3. Type the name and password of a user with ePO - On-prem Global Administrator rights, and click Next.

    4. Provide the password for access to the ePO - On-prem SQL database, then click Next.

      The Database Information page is populated with these ePO - On-prem server settings.

      • Database Server with instance name. For example, DB-SERVER\SERVERNAME.

      • Authentication type.

      • Domain name where the database server is hosted.

      • User name and Password.

      • Database name if not provided automatically.

  7. Click Install to start the installation.

  8. When installation is complete, enable your Agent Handler from the ePO - On-prem interface.