Changing the hostname or IP address on a dedicated primary EPM server

Last Updated : Jun 05, 2026 |

About this task

If you need to change the IP address or hostname of a dedicated primary EPM server after the EPM software is installed, or if you need to move the primary EPM 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 you want to change the IP address or hostname for a single server Experience Portal system, follow the steps in Changing the hostname or IP address for the Experience Portal single server system. If you want to change the IP address or hostname for a auxiliary EPM server, follow the steps in Changing the hostname or IP address on the auxiliary EPM server.

Procedure

  1. Log on to Linux on the Experience Portal Primary EPM 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 vpms service by entering the systemctl stop vpms 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 in an ASCII editor and change the IP address and hostname to the values you specified with the configuration tool.
    3. Reboot the EPM server.
    4. Stop the vpms service by entering the systemctl stop vpms command.
  4. Navigate to the do_UpdateHost script directory by entering the $AVAYA_HOME/Support/UpdateHostAddress command.
  5. Enter the bash do_UpdateHost command to change the hostname in the database to the hostname of the current server.
  6. Start the vpms service by entering the systemctl start vpms command.
  7. If the Primary EPM hostname and IP exists as an entry in the /etc/hosts file on the Auxiliary EPM and MPP servers, update these entries with the new hostname and IP address of the Primary EPM

Next Steps

Reconnect the existing MPP servers and Auxiliary EPM servers with the Primary EPM server. For more information, see: