Navigation
This version of the documentation is archived and no longer supported. To learn how to upgrade your version of MongoDB Ops Manager, refer to the upgrade documentation.
You were redirected from a different version of the documentation. Click here to go back.

Manage Ops Manager Ports

On this page

Overview

Ops Manager uses the ports and health-check endpoints described in Firewall Configuration. The endpoints are disabled by default. You can change Ops Manager’s default port and enable the endpoints.

Procedures

Change the Default Port on Unix-based Systems

To change the ports on Unix-based operating systems, you must edit the port settings in <install-directory>/conf/mms.conf, update the Ops Manager URL in Ops Manager Config settings, and restart Ops Manager.

1

Open mms.conf for editing.

Open the mms.conf file with root access. mms.conf is located in the <install_dir>/conf/ directory.

2

Set the BASE_PORT value to the port Ops Manager should use.

By default, Ops Manager uses port 8080. Change the BASE_PORT value to the desired port number.

BASE_PORT=11700

If you wish to change the port for Ops Manager connections over SSL, update BASE_SSL_PORT.

When changing the port, ensure that the chosen port is available for use.

3

Edit the Ops Manager URL to use the new port.

  1. In Ops Manager, click the Admin link in the upper right corner of the page.

  2. Click the General tab and then click Ops Manager Config.

  3. Update the URL to Access Ops Manager field to use the new port specified by the BASE_PORT:

    For example:

    http://mms.example.com:11700
    
  4. Click Save.

4

Restart Ops Manager.

Depending on how you installed Ops Manager, the command to restart Ops Manager will vary.

Installation with DEB or RPM package.

If you installed using a DEB or RPM package, use the following command to restart Ops Manager:

sudo service mongodb-mms restart
Installation from .tar.gz archive.

If you installed using a .tar.gz archive, use the following command to restart Ops Manager:

sudo /etc/init.d/mongodb-mms restart

Ops Manager will restart. The Ops Manager interface should be accessible at the new URL and port combination.

Change the Default Port on a Windows System

To change the ports on Windows, you need to edit the Windows registry, update the Ops Manager URL in Ops Manager Config settings, and restart Ops Manager.

1

Open the Registry Editor.

From the Start menu, click Run, and then type regedit, and click OK. The Registry Editor will open.

2

Set the port that Ops Manager should use.

By default, Ops Manager uses port 8080. You can change the port by editing the relevant registry value.

Open the following registry value:

SOFTWARE\Wow6432Node\Apache Software Foundation\Procrun 2.0\MMS\Parameters\Java\Options
3

Add -Dbase-port=<portnumber> to the Options registry value, setting the value to the desired port.

Add a new line in the Options file that resembles the following:

-Dbase-port=11700

When changing the port, ensure that the chosen port is available.

4

When you are done editing the settings, click OK, and exit the Registry Editor.

5

Edit the Ops Manager URL to use the new port.

  1. In Ops Manager, click the Admin link in the upper right corner of the page.

  2. Click the General tab and then click Ops Manager Config.

  3. Update the URL to Access Ops Manager field to use the new port specified by -DBase-port in the \\MMS\\Parameters\\Java\\Options registry value.

    For example:

    http://mms.example.com:11700
    
  4. Click Save.

6

Restart Ops Manager.

To restart the Ops Manager HTTP service, open the Control Panel, then System and Security, then Administrative Tools, and finally, double click to open the Services window.

In the Services list, restart the MongoDB Ops Manager HTTP Service by right-clicking and choosing Restart.

Ops Manager will restart. The Ops Manager interface should be accessible at the new URL and port combination.

Enable the Health Check Endpoint

Ops Manager provides an HTTP health-check endpoint on port 8090 that is disabled by default. Before you enable the endpoint, ensure that port 8090 is available for use.

To enable the endpoint:

1

Open mms.conf for editing.

Open the mms.conf file with root access. mms.conf is located in the <install_dir>/conf/ directory.

2

Uncomment DEBUG.PORT.

To enable the endoint, remove the # symbol so that the line reads:

DEBUG.PORT=8090
3

Save the changes.

4

Restart Ops Manager.