Change agent-server communication port

Follow these steps to change the agent-server communication port.

Important
This topic contains information about opening or modifying the registry. This information is for network and system administrators only. Registry modifications are irreversible and can cause system failure if done incorrectly.

We strongly recommend that you back up your registry and understand the restore process. For more information, see the Microsoft documentation.
Make sure that you run only .REG files that are confirmed to be genuine registry import files.

Modifying the agent-server communication port requires five steps and one optional step if you are using remote Agent Handlers.

Stop the ePO - On-prem services
Modify the port value in the registry
Modify the value in the ePO - On-prem database
Modify the port value in the ePO - On-prem configuration files
Restart the ePO - On-prem services
(Optional) Modify settings on remote Agent Handlers

For details about product features, usage, and best practices, click ? or Help.

Stop the ePO - On-prem services:
1. Close all ePO - On-prem consoles.
2. Click Start → Run, type services.msc, then click OK.
3. Right-click each of these services and select Stop:
  - Trellix ePolicy Orchestrator Application Server
  - Trellix ePolicy Orchestrator Event Parser
  - Trellix ePolicy Orchestrator Server
Modify the port value in the registry:
1. Click Start → Run, type regedit, then click OK.
2. Navigate to the key that corresponds to ePO - On-prem:
  [HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Uninstall\{ 53B73DFD-AFBE-4715-88A1-777FE404B6AF}]
3. Modify the string value AgentPort to reflect the appropriate port, then close the registry editor. The default value for this port is 80.
Modify the value in the ePO - On-prem database:
1. Open a text editor, and add these lines to the blank document:
```
UPDATE EPOServerInfo
ServerHTTPPort=80
```
2. Save the file as DefaultAgentPort.SQL in a temporary location on the SQL Server.
3. Click Start → All Programs → Microsoft SQL Server Management Studio to use Microsoft SQL Server Management Studio to install the DefaultAgentPort.sql file.
4. On the Connect to Server dialog box, click Connect.
5. Expand Databases, then select ePO database.
6. From the toolbar, select New Query.
7. Click File → Open → File, browse to and select the DefaultAgent.SQL file, then click Open → Execute.
8. Paste this line into a blank document:
```
UPDATE EPOServerInfo SET ServerHTTPPort =80
```
  Change 80 to the new port number.
9. Name the file DefaultAgentPort.SQL and save it to a temporary location on the SQL Server.
10. Use Microsoft SQL Server Management Studio to install the DefaultAgentPort.SQL file.
  - Click Start → All Programs → Microsoft SQL Server Management Studio.
  - On the Connect to Server dialog box, click Connect.
  - Expand Databases, then select ePO database.
  - From the toolbar, select New Query.
  - Click File → Open → File, browse to and select the DefaultAgentPort.SQL file, then click Open → Execute.
Modify the port value in the ePO - On-prem configuration files:
1. Navigate to C:\Program Files (x86)\McAfee\ePolicy Orchestrator\DB\....
2. Using a text editor, open Server.ini and change the value for HTTPPort=80 to reflect the new number, then save the file.
3. Using a text editor, open Siteinfo.ini and change the value for HTTPPort=80 to reflect the new number, then save the file.
4. Navigate to C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Apache2\conf\..., open httpd.conf, then change these lines to reflect the new port number:
```
Listen 80
ServerName<YourServerName>: 80
```
  If using VirtualHosts, change:
```
NameVirtualHost *:80
<VirtualHost *:80> 
```
5. Save the file and exit the text editor.
Restart the ePO - On-prem services:
1. Click Start → Run, type services.msc, then click OK.
2. Right-click each of these services and select Start:
  - Trellix ePolicy Orchestrator Application Server
  - Trellix ePolicy Orchestrator Event Parser
  - Trellix ePolicy Orchestrator Server
(Optional) Modify settings on remote Agent Handlers:
1. Make sure that all ePO - On-prem consoles are closed, then click Start → Run, type services.msc and click OK.
2. Right-click each of these services and select Start:
  - Trellix ePolicy Orchestrator Event Parser
  - Trellix ePolicy Orchestrator Server
    Note
    This server might be listed as MCAFEEAPACHESRV if the server wasn't restarted since the Agent Handler was installed.
3. Navigate to C:\Program Files (x86)\McAfee\ePolicy Orchestrator\Apache2\conf\..., using a text editor open httpd.conf, then change these lines to reflect the new port number:
```
Listen 80
ServerName<YourServerName>: 80
```
  If using VirtualHosts, change:
```
NameVirtualHost *:80
<VirtualHost *:80> 
```
4. Save the file and exit the text editor.
5. Click Start → Run, type services.msc, then click OK.
6. Right-click each of these services and select Start.
  - Trellix ePolicy Orchestrator Event Parser
  - Trellix ePolicy Orchestrator Server
    Note
    This server might be listed as MCAFEEAPACHESRV if the server has not been restarted since the Agent Handler was installed.
  If you previously deployed agents to clients, reinstall the agent on all clients using the /forceinstall switch to overwrite the existing Sitelist.xml file. For more information about specific Trellix Agent versions that allow the /forceinstall switch to work successfully, see Trellix KnowledgeBase article KB60555.