Auxiliary Tasks for Hyper-V Deployment

Assigning or Changing the IP Address

To assign or change a static IP address, 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 Connecting to DPX Master Server via SSH. 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.

   
3. From the main menu, select Edit a connection.

4. On the NetworkManager Text User Interface, use the arrow keys to navigate. Select Edit a connection and press Enter. Under Ethernet, select the interface (e.g. eth0) to modify. Navigate to Edit... and press Enter.

   Note. In addition to Ethernet, the DPX Master Server has two additional devices docker_gwbridge and docker0. Do not modify any settings related to these two bridge devices.

5. On the Edit Connection screen, navigate to IPv4 CONFIGURATION field until Automatic is selected. Press Enter. Select Manual and press Enter. Navigate to Show (beside IPv4 CONFIGURATION) and press Enter. Beside each setting, navigate to Add and press Enter. Input the network parameters as described below that are specific to your environment as previously defined in the DNS settings:

   Addresses: An available and accessible IP address on your network in xxx.xxx.xxx.xxx/xx format.  
   Gateway: The network gateway in xxx.xxx.xxx.xxx format  
   DNS servers: DNS server(s) using one line per IP.  
   Search domains: Search domain(s) using one line per fully qualified domain name (FQDN).

6. Navigate to and select OK and press Enter to save and exit.

7. 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

8. Navigate to the /opt/catalogic directory. Issue the make stop command and wait for all processes to stop.

   $ sudo -s  
   $ cd /opt/catalogic  
   $ make stop

9. Issue the make start command. Wait a few minutes for the Docker swarm to fully initialize before attempting to log in to the DPX user interface.

   $ make start

10. Finally, restart the DPX Master Server virtual appliance.

Changing the System Hostname

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 Connecting to DPX Master Server via SSH. 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.

   
3. 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.

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

5. Reboot the DPX Master Server appliance.

6. 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.

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

8. 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