Changing the hostname or IP address for the Experience Portal single server system

Last Updated : Jun 05, 2026 |

About this task

If you need to change the IP address or hostname of the Experience Portal server after the EPM and MPP software has been installed, or if you need to move the Experience Portal 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 one or more dedicated servers, follow the steps in Changing the hostname or IP address on a dedicated primary EPM server.

Procedure

  1. Log on to Linux on the 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. Stop the mpp service by entering the systemctl mpp stop command.
  4. 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 Experience Portal server.
  5. Stop the vpms service by entering the systemctl stop vpms command.
  6. Stop the mpp service by entering the systemctl stop mpp command.
  7. Navigate to the do_UpdateHost script directory by entering the cd $AVAYA_HOME/Support/UpdateHostAddress command.
  8. Enter the bash do_UpdateHost command to change the hostname in the database to the hostname of the current server.
  9. Start the vpms service by entering the systemctl start vpms command.
  10. Start the mpp service by entering the systemctl start mpp command.
  11. If the Primary EPM hostname and IP exists as an entry in the /etc/hosts on the Auxiliary EPM and MPP servers, update these entries with the new hostname and IP address of the Primary EPM.
  12. If the application server is co-resident with the Experience Portal single server system, verify and change the hostname or IP address referenced in the Applications page.
    1. On the EPM navigation pane, click System Configuration > Applications.
    2. Verify the hostname or IP address.

Next Steps

Reconnect the existing MPP server and Auxiliary EPM servers with the Primary EPM server.

For more information, see the following: