Administer > Service Portal Administration Guide > Change the host name used in an existing Service Portal installation

Change the host name used in an existing Service Portal installation

Service Portal provides a script that can change the host name being used in the current installation. You can run this script in any of the following example scenarios so that the installation can continue to work:

  • The host name of the machine on which Service Portal is installed has changed.
  • You have installed Service Portal on a virtual machine (VM), and then created another VM by using the first VM as a template.

Important This script works only for single instance installation of Service Portal. It does not work for distributed Service Portal installation.

To change the host name being used in the current installation, follow these steps:

  1. Stop Service Portal:

    propel stop
  2. Make sure that the rabbitmq-server service is stopped:

    service rabbitmq-server status

    If the service is not stopped, kill the process.

  3. Change to the /opt/hp/rename_fqdn directory.
  4. Run the host name renaming script with the fully qualified domain names (FQDNs) of the old and new hosts:

    ./rename_fqdn.sh <old FQDN> <new FQDN>

    When the script has finished execution, messages that resemble the following ones are displayed:

    Certificate was added to keystore
    Entry for alias mytestfqdn.mycompany.net successfully imported.
    Import command completed:  1 entries successfully imported, 0 entries failed or canceled
  5. Start Service Portal:

    propel start

    Note The rabbitmq-server service sometimes may fail to start during this step. If this happens, you need to run the "service rabbitmq-server restart" command to manually restart this service.