Install Agent Handlers

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

Before you begin

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

Each McAfee ePO server contains a master Agent Handler. Installing more Agent Handlers can help manage an increased number of products and systems managed by one McAfee ePO 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 McAfee ePO server.

Attention: 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 McAfee ePO 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 McAfee ePO 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 McAfee 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 McAfee ePO 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 McAfee ePO Global Administrator rights, and click Next.
    4. Provide the password for access to the McAfee ePO SQL database, then click Next.
      The Database Information page is populated with these McAfee ePO 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 McAfee ePO interface.