Administer > Service Manager Service Portal administration > Service Manager Service Portal administration tips and tasks > Change the host name used in an existing Service Manager Service Portal installation

Change the host name used in an existing Service Manager Service Portal installation

Service Manager 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 Manager Service Portal is installed has changed.
  • You have installed Service Manager 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 Manager Service Portal. It does not work for distributed Service Manager Service Portal installation.

After you execute the script, the script completes the following tasks:

  • Change the host names in the configuration files
  • Generate a Service Manager Service Portal self-signed certificate for the new FQDN

    Note If you want to use your own certificate, you need to replace the Service Manager Service Portal self-signed certificate with your own certificate. For detailed instructions, see Replace the Service Manager Service Portal generated SSL certificates.

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

  1. Stop Service Manager 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 Manager 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.