How do I restore the CLM deployer host?

Purpose

The following steps describe how to restore the CLM deployer host in a CLM cluster, for example, if the deployer host VM fails and must be recreated.

Note: The steps describe how to restore a CLM deployer host in a KVM virtualization environment; for OpenStack or VMware ESXi, see the RHEL or VMware documentation for information about how to restore a VM.

Note: In order to perform the procedure, you require a backup of the CLM deployer host configuration. A backup is created during CLM system deployment or reconfiguration, and also by performing How do I back up the CLM deployer host?.

Steps
 
1 

Log in as the root user on the station that hosts the CLM deployer host VM.


2 

Open a console window.


3 

Create a temporary local directory.

Note: The directory must be empty.


4 

Enter the following:

# cd directory ↵

where directory is the temporary directory created in Step 3.


5 

Copy the CLM deployer host backup file set to the temporary directory.


6 

Enter the following to convert the backup CLM deployer host qcow2 image to raw format:

# qemu-img convert -f qcow2 backup_image.qcow2 -O raw new_image.img ↵

where

backup_image is the backup image file name

new_image is a name to assign to the new image file


7 

If the CLM deployer host is running, enter the following to stop the VM:

# virsh destroy VM ↵

where VM is the VM name


8 

Enter the following to deploy the VM:

Note: One “--network bridge=bridge_name” entry is required for each VM interface that you intend to configure.

# virt-install --connect qemu:///system --ram RAM --vcpu=vCPUs -n instance --os-type=linux --os-variant=rhel7 --disk path="new_image", device=disk,bus=virtio,format=raw,io=native,cache=none --network bridge=bridge_name --import & ↵

where

RAM is the required amount of VM RAM in Mbytes; for example, 64 Gbytes is expressed as 65536, which is 64 x 1024 Mbytes

vCPUs is the required number of vCPU threads

instance is the name to assign to the VM

new_image is the name of the disk image created in Step 6

bridge_name is the name of the network bridge for a VM interface


9 

When the VM creation is complete, enter the following:

# virsh domiflist deployer_host | awk '{print $5}' ↵

where deployer_host is the instance name assigned to the VM

The CLM deployer host MAC address is displayed.


10 

Record the MAC address for use in a later step.


11 

Enter the following to open a console session as the root user on the CLM deployer host:

# virsh console deployer_host ↵


12 

Open the following file with a plain-text editor such as vi:

/etc/sysconfig/network-scripts/ifcfg-ethn

where

n is the Ethernet interface number; for example, eth0 is the first interface


13 

Edit the following line as shown below:

HWADDR=MAC_address

where MAC_address is MAC address recorded in Step 9


14 

Save and close the file.


15 

Enter the following:

# init 6 ↵

The CLM deployer host station reboots, and the CLM deployer host is restored.


16 

Close the console window.

End of steps