Changing the hostname or IP address for a dedicated MPP server

Last Updated : Jun 05, 2026 |

About this task

If you need to change the IP address or hostname of a dedicated MPP server after the MPP software has been installed, or if you need to move the MPP software to a new server that has a different IP address and hostname, you need to change the information stored in the Experience Portal database to match the new system configuration.

Note:

If your Experience Portal system consists of a single server, follow the steps in Changing the hostname or IP address for the Experience Portal single server system.

Procedure

  1. Log on to Linux on the Experience Portal MPP server.
    • If you are an Avaya Services representative, and use Avaya Enterprise Linux, or if the Avaya Service accounts are installed on this server, log on to the local Linux console as root.

    • Otherwise, log on remotely as a non-root user, and then change the user to root by entering the su - root command.

  2. Stop the mpp service by entering the systemctl stop mpp command.
  3. If you want to change the hostname or IP address of the current server, do the following:
    1. Use the nmtui tool as described in the Red Hat documentation.
    2. Open the /etc/hosts file on the MPP server in an ASCII editor and change the IP address and hostname to the values you specified with the configuration tool.
    3. Reboot the MPP server.
    4. Log on to Linux on the Experience Portal Primary EPM server.

      If you are an Avaya Services representative, and use Avaya Enterprise Linux, the Avaya Service accounts will not be available after the Avaya Enterprise Linux upgrade. The Avaya Service accounts will be available through EASG configuration during the Experience Portal upgrade.

      • Log on to the local Linux console as root.

      • Or log on remotely as a non-root user and then change the user to root by entering the su - root command.

    5. Open the /etc/hosts file on the primary EPM server in an ASCII editor and change the IP address and hostname for the MPP to the values you specified with the configuration tool.
  4. Log on to the EPM web interface.

    If Avaya Services is maintaining this system and you are an Avaya Services representative, log on to EPM by using the init EPM account that is created during the EPM software installation.

    Otherwise, log on to EPM by using an account with the Administrator user role.

  5. On the EPM naviagtion pane, click System Configuration > MPP Servers.
  6. On the MPP Servers page, click on the name of the MPP whose hostname or IP address you changed.
  7. On the Change MPP Server page, make sure that the information in the Host Address field matches the new IP address or hostname.

    If you logged in using the init account, ensure that the LDN number specified in the LDN field matches the information in the Avaya Services database for this server.

  8. Click Save.