This section explains how to reinstall Entrust Deployment Manager 2.0.2 when the following conditions are met.

  • The pki-hub-upgrade prepare command prompts "The node needs to be reinstalled".
  • Entrust Deployment Manager was installed using an ISO file.
  • Entrust Deployment Manager was upgraded from 2.0.0 at some point.
  • Entrust Deployment Manager runs on more than one node.

In this case, you must repeat the following steps sequentially on each node.

In the steps below, the "target node" is the node on which the Entrust Deployment Manager is being reinstalled.

Getting information on the target node

Run the clusterctl node join-token on the target node to get the joining token.

Get also system information on this node. As detailed in the following table, you need to save fewer settings when the node uses DHCP (Dynamic Host Configuration Protocol).

Setting

Command

DHCP 

No-DHCP 

The IP address of the node

Run hostname -I and copy the first listed IP address

(tick) 

(tick) 

The hostname of the node

Run hostname

(tick) 

(tick) 

The IP addresses of the DNS servers

Run cat /etc/resolv.conf

(error) 

(tick)

The IP address of the gateway

Run route -n 

(error) 

(tick)

The IP addresses of the NTP servers

Run chronyc sources -v 

(error) 

(tick)

The chrony config file

Copy the /etc/chrony/chrony.conf file

(tick) 

(tick)

Removing the target node from the cluster

In any of the other cluster nodes, run the pki-hub-upgrade remove-node using the IP address previously obtained when Getting information on the target node.

Run also the clusterctl node join-token command to get the node joining token of this node.

Uninstalling Entrust Deployment Manager 2.0.2 on the target node

Uninstall Entrust Deployment Manager 2.0.2 on the target node.

To uninstall Entrust Deployment Manager 2.0.2

  1. Run the clusterctl uninstall command to uninstall Entrust Deployment Manager 2.0.2.
  2. Remove the node hostname and IP address from the DNS server and load balancer.

Reinstalling Entrust Deployment Manager 2.0.2 on the target node

Reinstall Entrust Deployment Manager 2.0.2 on the target node.

The below steps only apply to VMware platforms. Contact customer support to reinstall from ISO image on other platforms.

To reinstall Entrust Deployment Manager 2.0.2

  1. Power off the Virtual Machine hosting the node.
  2. Right-click on the machine name and select Edit Settings.
  3. Select the Virtual Hardware tab.
  4. Expand the CD/DVD drive section:
    • Select the installation ISO image for Entrust Deployment Manager 2.0.2.
    • Check the  Connect At Power On box.
  5. Select the VM Options tab.
  6. Expand the Boot Options section:
    • If the machine firmware is configured to boot using the BIOS, set the Boot Delay to the maximum allowed value (for example, 10000 milliseconds).
    • If the machine firmware is configured to use UEFI, check the Force EFI setup box.
  7. Click OK to save the settings.
  8. Power on the virtual machine.
  9. Click Launch Web Console to access the boot menu.
    • If the machine firmware is configured to boot using the BIOS, press ESC before the Boot Delay period expires, select the CD-ROM Drive option to boot from the ISO, and press Enter.
    • If the machine firmware is configured to use UEFI, select the <EFI VMware Virtual SATA CDROM Drive (0.0)> option and press Enter.
  10. Wait while the installation completes.

Completing Entrust Deployment Manager 2.0.2 reinstall on the target node

Perform the below steps on the target node to complete the Entrust Deployment Manager 2.0.2 reinstall.

To complete Entrust Deployment Manager 2.0.2 reinstall

  1. Restore the system information obtained when Getting information on the target node.
  2. Run the clusterctl node add command using the joining token obtained when Removing the target node from the cluster.
  3. Add the node IP address to the DNS server and the load balancer (if any).
  4. Use an SFTP client to copy the pki-hub-upgrade-1.1.0.rpm package in the /home/sysadmin node directory.
  5. Run the following command to install the upgrade package; you will need it to continue the upgrade process. 
    sudo dnf install pki-hub-upgrade.rpm --assumeyes