⚠️ OPSWAT Central Management v7 and My OPSWAT On-Premises (My OPSWAT Central Management v8) will reach End of Sale on July 31, 2025, and End of Life on January 31, 2027. We encourage you to upgrade to My OPSWAT Central Management v10 before Janauary 31, 2027, to ensure continued support and access to the latest features.

OPSWAT Central Management cannot start due to port conflict issues

TermDetail
ProblemOPSWAT Central Management cannot start due to port conflict issues
CauseOne or more ports used by OPSWAT Central Management are already in use.
Troubleshooting(On Windows) The tray icon reports a port conflict issues via notification Port conflict is reported in log files
SolutionClose the program occupying the conflicted ports Change the ports OPSWAT Central Management uses

As of version 7.10, by default, OPSWAT Central Management requires ports 9000, 9005, 9009m 9026, and 27017 to be available.

On Windows, the tray icon can show a notification reporting possible port conflict issues when starting OPSWAT Central Management.

On all supported operating systems, port conflict issues are also reported in log files.

  • Windows: ProgramData\OPSWAT/Central\Logs\powershell_out.txt

  • Linux: /var/log/ocm/ocn_<current date>.log

One solution is to ensure that programs occupying the aforementioned ports are closed when starting OPSWAT Central Management.

A second solution is to change the ports OPSWAT Central Management uses as a workaround. Each port requires changing two configuration files. The first file is the main configuration which coordinates the services.

  • On Windows, this file is located at ProgramData\OPSWAT\Central\config.properties.

  • On Linux, this file is located at /usr/lib/ocm/set-port.sh.

The content should be similar to the below example:

Copy

Edit the port number as needed to solve the port conflicts.

The second configuration file to edit is listed below for each port.

Tomcat port (9009 by default):

  • On Windows: Program Files\OPSWAT\Central\tomcat\conf\server.xml

  • On Linux: /opt/ocm/tomcat/conf/server.xml

Find the configuration entry containing the current port used by Tomcat and edit it to match the main configuration file.

Copy

Mongodb port (27017 by default):

  • On Windows: ProgramData\OPSWAT\Central\mongod.conf

  • On Linux: /opt/ocm/mongo/mongod.conf

Find the configuration entry containing the current port used by Mongodb and edit it to match the main configuration file.

Copy

Nginx port (9000) Port 9000 is already supported to be configurable prior to version 7.10. Please follow the guide here.

Up port (9026 by default):

  • On Windows: Program Files\OPSWAT\Central\nginx\conf\nginx.conf

  • On Linux: /opt/ocm/nginx/conf/nginx.conf

Find the configuration entry containing the current port used to determine OPSWAT Central Management's status and edit it to match the main configuration file.

Copy

Except for nginx port, port changes do not carry over across reinstallation/upgrade.

Type to search, ESC to discard
Type to search, ESC to discard
Type to search, ESC to discard