Changing the System Hostname

Procedure

To assign a new system hostname, ensure that the virtual machine is powered on and complete the following steps:

  1. Log in to the DPX Master Server appliance through the Hyper-V console or connect to the DPX Master Server appliance through SSH with the dpxadmin username. For default credentials, see Default User Names and Passwords for the Catalogic DPX Master Server in the Deployment Guide. When logging in for the first time, the password must be changed.

  2. Run the nmtui command to open the NetworkManager Text User Interface to modify the DPX Master Server appliance’s hostname or IP address to match what was previously set in the DNS.

    $ sudo nmtui
  3. Using the arrow keys, navigate to and press Enter to select the appropriate interface.

  4. Select Set system hostname and press Enter. Change the old name to the new hostname. Ensure that a unique hostname is provided as previously defined in the environment DNS.

  5. Navigate to Quit and press Enter to exit the NetworkManager Text User Interface tool.

  6. Reboot the DPX Master Server appliance.

  7. Once the DPX Master Server appliance has restarted, log in through the Hyper-V console or connect to the DPX Master Server appliance through SSH. Use the username of dpxadmin and the previously set password.

  8. Verify that the system hostname change succeeded by issuing either of the commands: hostname or hostnamectl

  9. Run the hyperv-init.sh script. This will reset docker, update the dpx.jnlp file, and backup the original dpx.jnlp to dpx.jnlp.<timestamp> where is the system time when the copy occurred.

    $ sudo /opt/hyperv/hyperv-init.sh

Results

The DPX Management Interface should now be accessible through the DPX Gateway service by entering the IP address or hostname in a modern web browser.

Last updated