How to change the ePO agent-to-server communication port
Technical Articles ID:
KB67605
Last Modified: 2022-01-28 22:33:27 Etc/GMT
Environment
ePolicy Orchestrator (ePO) 5.x
Summary
To change the ePO agent-to-server communication port:
- Stop the ePO services:
-
Make sure all ePO consoles are closed.
- Press the Windows key + R, type services.msc into the field, and press Enter.
- Right-click each of the services below and click Stop:
McAfee ePolicy Orchestrator Application Server
McAfee ePolicy Orchestrator Event Parser
McAfee ePolicy Orchestrator Server
- 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 the Microsoft Windows registry information for advanced users article.
- Do not run a REG file that is not confirmed to be a genuine registry import file.
- Press the Windows key + R, type regedit into the field and press Enter.
- Navigate to the key below:
ePO 5.10.0
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{E2C3579A-6B3B-40F6-88E8-BE08E78C8D1A}
- Change the string value AgentPort to reflect the appropriate port. The default value for this port is 80.
- Close the registry editor.
- Change the port value in the ePO database:
- Press the Windows key + R, type notepad, and click OK.
- Add the following lines to the blank Notepad document. Change 80 to the appropriate port number:
UPDATE EPOServerInfo
SET ServerHTTPPort=80
- 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’re 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.)
- Press the Windows key + R, type cmd, and click OK.
- 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
IMPORTANT: Changes in the OSQL command are needed if you’re 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.
- Close the command prompt.
- Change the port value in the ePO configuration files:
- Press the Windows key + R, type explorer, and click OK.
- Navigate to: ...\Program Files\McAfee\ePolicy Orchestrator\DB\.
- Open Server.ini using a text editor, such as Notepad, and change the value for HTTPPort=80 to reflect the new port number.
- Save the file.
- Open Siteinfo.ini using Notepad and change the value for HTTPPort=80 to reflect the new port number.
- Save the file.
- Navigate to: ...\Program Files\McAfee\ePolicy Orchestrator\Apache2\conf.
- 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>
- Save the file and exit Notepad.
- Start the ePO services:
- Press the Windows key + R, type services.msc, and click OK.
- Right-click each of the following services and click Start:
McAfee ePolicy Orchestrator Application Server
McAfee ePolicy Orchestrator Event Parser
McAfee ePolicy Orchestrator Server
- 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.
-
Make sure all ePO consoles are closed.
- Press the Windows key + R, type services.msc, and click OK.
- Right-click each of the services below and select Stop:
McAfee ePolicy Orchestrator Event Parser
McAfee ePolicy Orchestrator Server
NOTE: This item might be listed as MCAFEEAPACHESRV if the server hasn’t been restarted since the Agent Handler was installed.
- Navigate to: ...\Program Files\McAfee\Agent Handler\ Apache \conf.
- 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>
- Save the file and exit Notepad.
- Press the Windows key + R, type services.msc, and click OK.
- Right-click each of the following services and click Start:
McAfee ePolicy Orchestrator Event Parser
McAfee ePolicy Orchestrator Server
NOTE: This item might be listed as MCAFEEAPACHESRV, if the server hasn’t 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.
|
