Changing the hostname or IP address on the auxiliary EPM server

Last Updated : Jun 05, 2026 |

About this task

To change the IP address or hostname of the auxiliary EPM server after the EPM software has been installed, or to move the auxiliary EPM software to a new server that has a different IP address and hostname, you must change the information stored in the Experience Portal database to match the new system configuration.

Note:

To change the IP address or hostname for the primary EPM server, follow the steps in Changing the hostname or IP address on a dedicated primary EPM server.

Procedure

  1. Log on to Linux on the Auxiliary 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. 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 auxiliary EPM server.
    4. After the reboot, stop the vpms service by entering the systemctl stop vpms command.
  4. Navigate to the do_UpdateHost script directory by entering the cd $AVAYA_HOME/Support/UpdateHostAddress command.
  5. Enter the bash do_UpdateHost command.
  6. Start the vpms service by entering the systemctl start vpms command.
  7. 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.

  8. 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.
  9. Update the Auxiliary EPM servers host details by doing the following:
    1. 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.

    2. On the EPM navigation pane, click System Configuration > EPM Servers.
    3. On the EPM Servers page, click the name of the auxiliary EPM server.
    4. On the Change EPM Server page, update the information in the Host Address field.

      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.

    5. Click Save.