Loading...

Knowledge Center


How to change the ePolicy Orchestrator agent-to-server communication port
Technical Articles ID:   KB67605
Last Modified:  9/30/2019
Rated:


Environment

McAfee ePolicy Orchestrator (ePO) 5.x

Summary

To change the ePO agent-to-server communication port:
  1. Stop the ePO services:
    1. Ensure all ePO consoles are closed.
    2. Click StartRun, type services.msc, and click OK.
    3. Right-click each of the following services and select Stop
       
      McAfee ePolicy Orchestrator Application Server
      McAfee ePolicy Orchestrator Event Parser
      McAfee ePolicy Orchestrator Server
       
  2. Modify the port value in the registry:
    CAUTION: This article contains information about opening or modifying the registry.
    • The following information is intended for System Administrators. Registry modifications are irreversible and could cause system failure if done incorrectly.
    • Before proceeding, Technical Support strongly recommends that you back up your registry and understand the restore process. For more information, see: http://support.microsoft.com/kb/256986.
    • Do not run a REG file that is not confirmed to be a genuine registry import file.
    1. Click StartRun, type regedit, and click OK.
    2. Navigate to the following appropriate key:

      ePO 5.10.0
      HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{E2C3579A-6B3B-40F6-88E8-BE08E78C8D1A}​
ePO 5.9.x
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{6DAACE3A-D62A-43B7-AD10-463FE542DF10}
 
ePO 5.3.x
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{53B73DFD-AFBE-4715-88A1-777FE404B6AF}
  1. Change the string value AgentPort to reflect the appropriate port. The default value for this port is 80.
  2. Close the registry editor.
 
  1. Change the port value in the ePO database:
    1. Click StartRun, type notepad, and click OK.
    2. Add the following lines to the blank Notepad document. Change 80 to the appropriate port number:

      UPDATE EPOServerInfo
      SET ServerHTTPPort=80
       
    3. Save the file as DefaultAgentPort.sql in a temporary location on the SQL or MSDE server.

      IMPORTANT: For SQL installations, see the Related Information section, Alternative Steps for SQL 2005/2008/2012/2014 installations. If you are using this alternative section for SQL installations, complete those steps and then continue to step 4. (Skip steps 3.d, 3.e, and 3.f.)
       
    4. Click StartRun, type cmd, and click OK.
    5. Run the following command for the DefaultAgentPort.sql file on the SQL or MSDE server (command is case sensitive):

      OSQL -d <Database_Name> -E -i <Path>\DefaultAgentPort.sql

      Where:
      <Database_Name> is the name of the ePO database
      <Path> is the folder containing the DefaultAgentPort.SQL file created above

      Example 
      If the ePO server name is MANAGE, script name is DefaultAgentPort.SQL, and the temporary folder is c:\TEMP, the command would be:

      OSQL -d ePO_MANAGE -E -i c:\TEMP\DefaultAgentPort.SQL

      IMPORTANTChanges in the OSQL command are required if you are using a named instance of SQL or MSDE, indicated by a <OSQL_server_name>\<instance_name>. In this case, you must use OSQL -d <Database_Name> -S <OSQL_server_name\instance_name> -E -i <Path>\DefaultAgentPort.sql.
       
    6. Close the command prompt.
       
  2. Change the port value in the ePO configuration files:
    1. Click StartRun, type explorer, and click OK.
    2. Navigate to: ...\Program Files\McAfee\ePolicy Orchestrator\DB\.
    3. Open Server.ini using a text editor, such as Notepad, and change the value for HTTPPort=80 to reflect the new port number.
    4. Save the file.
    5. Open Siteinfo.ini using Notepad and change the value for HTTPPort=80 to reflect the new port number.
    6. Save the file.
    7. Navigate to: ...\Program Files\McAfee\ePolicy Orchestrator\Apache2\conf.
    8. Open httpd.conf with Notepad and change the following lines to reflect the new port number:

      Listen 80
      ServerName<YourServerName>: 80

      If using VirtualHosts, change:

      NameVirtualHost *:80
      <VirtualHost *:80>
       
    9. Save the file and exit Notepad.
       
  3. Start the ePO services:
    1. Click StartRun, type services.msc, and click OK.
    2. Right-click each of the following services and click Start:
       
      McAfee ePolicy Orchestrator Application Server 
      McAfee ePolicy Orchestrator Event Parser 
      McAfee ePolicy Orchestrator Server
       
  4. Modify settings on Remote Agent Handlers:
    IMPORTANT: If you use Remote Agent Handlers in your environment, perform the steps below on each Remote Agent Handler.
    1. Ensure all ePO consoles are closed.
    2. Click StartRun, type services.msc, and click OK.
    3. Right-click each of the services below and select Stop:
       
      McAfee ePolicy Orchestrator Event Parser
      McAfee ePolicy Orchestrator Server (might be listed as MCAFEEAPACHESRV if the server has not been restarted since the Agent Handler was installed) 
       
    4. Navigate to: ...\Program Files\McAfee\Agent Handler\ Apache \conf.
    5. Open httpd.conf with Notepad and change the lines below to reflect the new port number:
       
      Listen 80 
      ServerName<YourServerName>: 80

      If using VirtualHosts, change:

      NameVirtualHost *:80
      <VirtualHost *:80
       
    6. Save the file and exit Notepad.
    7. Click StartRun, type services.msc, and click OK.
    8. Right-click each of the following services and click Start:
       
      McAfee ePolicy Orchestrator Event Parser 
      McAfee ePolicy Orchestrator Server 
      NOTE: (The above might be listed as MCAFEEAPACHESRV, if the server has not been restarted since the Agent Handler was installed.
IMPORTANT: If you previously deployed agents to clients, you must reinstall the agent on all clients using the /forceinstall switch to overwrite the existing Sitelist.xml file.

Rate this document

Glossary of Technical Terms


 Highlight Glossary Terms

Please take a moment to browse our Glossary of Technical Terms.