Procedure 7.1. Adding a Red Hat Enterprise Linux Host

1. Click the Hosts resource tab to list the hosts in the results list.
2. Click New to open the New Host window.
3. Use the drop-down menus to select the Data Center and Host Cluster for the new host.
4. Enter the Name, Address, and SSH Port of the new host.
5. Select an authentication method to use with the host.
   • Enter the root user's password to use password authentication.
   • Copy the key displayed in the SSH PublicKey field to /root/.ssh/authorized_keys on the host to use public key authentication.
6. You have now completed the mandatory steps to add a Red Hat Enterprise Linux host. Click the Advanced Parameters button to expand the advanced host settings.
   1. Optionally disable automatic firewall configuration.
   2. Optionally disable use of JSON protocol.

      Note

      With Red Hat Enterprise Virtualization 3.5, the communication model between the Manager and VDSM now uses JSON protocol, which reduces parsing time. As a result, the communication message format has changed from XML format to JSON format. Web requests have changed from synchronous HTTP requests to asynchronous TCP requests.
   3. Optionally add a host SSH fingerprint to increase security. You can add it manually, or fetch it automatically.
7. You can configure the Power Management and SPM using the applicable tabs now; however, as these are not fundamental to adding a Red Hat Enterprise Linux host, they are not covered in this procedure.
8. Click OK.

Procedure 7.2. Adding a Foreman Host Provider Host

1. Click the Hosts resource tab to list the hosts in the results list.
2. Click New to open the New Host window.
3. Use the drop-down menus to select the Data Center and Host Cluster for the new host.
4. Select the Use Foreman Hosts Providers check box to display the options for adding a Foreman host provider host and select the provider from which the host is to be added.
5. Select either Discovered Hosts or Provisioned Hosts.
   • Discovered Hosts (default option): Select the host, host group, and compute resources from the drop-down lists.
   • Provisioned Hosts: Select a host from the Providers Hosts drop-down list.
   Any details regarding the host that can be retrieved from the external provider are automatically set, and can be edited as desired.
6. Enter the Name, Address, and SSH Port (Provisioned Hosts only) of the new host.
7. Select an authentication method to use with the host.
   • Enter the root user's password to use password authentication.
   • Copy the key displayed in the SSH PublicKey field to /root/.ssh/authorized_hosts on the host to use public key authentication (Provisioned Hosts only).
8. You have now completed the mandatory steps to add a Red Hat Enterprise Linux host. Click the Advanced Parameters drop-down button to show the advanced host settings.
   1. Optionally disable automatic firewall configuration.
   2. Optionally disable the use of JSON protocol.
   3. Optionally add a host SSH fingerprint to increase security. You can add it manually, or fetch it automatically.
9. You can configure the Power Management, SPM, Console, and Network Provider using the applicable tabs now; however, as these are not fundamental to adding a Red Hat Enterprise Linux host, they are not covered in this procedure.
10. Click OK to add the host and close the window.

Procedure 7.3. Approving a Registered Hypervisor

1. From the Administration Portal, click the Hosts tab, and then click the host to be approved. The host is currently listed with the status of Pending Approval.
2. Click Approve to open the Edit and Approve Hosts window. You can use the window to specify a name for the Hypervisor, fetch its SSH fingerprint before approving it, and configure power management. For information on power management configuration, refer to Section 7.5.4.2, “Host Power Management Settings Explained”.
3. Click OK. If you have not configured power management, you are prompted to confirm whether to proceed without doing so; click OK.

Procedure 7.4. Configuring Power Management Settings

1. Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
2. Click Edit to open the Edit Host window.
3. Click the Power Management tab to display the Power Management settings.
4. Select the Enable Power Management check box to enable the fields.
5. Select the Kdump integration check box to prevent the host from fencing while performing a kernel crash dump.

   Important

   When you enable Kdump integration on an existing host, the host must be reinstalled for kdump to be configured. See Section 7.5.12, “Reinstalling Virtualization Hosts”.
6. The Primary option is selected by default if you are configuring a new power management device. If you are adding a new device, set it to Secondary.
7. Select the Concurrent check box to enable multiple fence agents to be used concurrently.
8. Enter the Address, User Name, and Password of the power management device into the appropriate fields.
9. Use the drop-down menu to select the Type of power management device.
10. Enter the Port number used by the power management device to communicate with the host.
11. Enter the Options for the power management device. Use a comma-separated list of 'key=value' or 'key'.
12. Select the Secure check box to enable the power management device to connect securely to the host.
13. Click Test to ensure the settings are correct.
14. Click OK to save your settings and close the window.

Procedure 7.5. Configuring SPM settings

1. Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
2. Click Edit to open the Edit Host window.
3. Click the SPM tab to display the SPM Priority settings.
4. Use the radio buttons to select the appropriate SPM priority for the host.
5. Click OK to save the settings and close the window.

Procedure 7.6. Editing a Resource

1. Use the resource tabs, tree mode, or the search function to find and select the resource in the results list.
2. Click Edit to open the Edit window.
3. Change the necessary properties and click OK.

Procedure 7.7. Approving newly added Red Hat Enterprise Virtualization Hypervisor hosts

1. In the Hosts tab, select the host you recently installed using the Red Hat Enterprise Virtualization Hypervisor host installation media. This host shows a status of Pending Approval.
2. Click the Approve button.

Procedure 7.8. Moving a Host to Maintenance Mode

1. Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
2. Click Maintenance to open the Maintenance Host(s) confirmation window.
3. Click OK to initiate maintenance mode.

Procedure 7.9. Activating a Host from Maintenance Mode

1. Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
2. Click Activate.

Procedure 7.10. Removing a host

1. Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
2. Place the host into maintenance mode.
3. Click Remove to open the Remove Host(s) confirmation window.
4. Select the Force Remove check box if the host is part of a Red Hat Gluster Storage cluster and has volume bricks on it, or if the host is non-responsive.
5. Click OK.

Procedure 7.11. Reinstalling Red Hat Enterprise Virtualization Hypervisors and Red Hat Enterprise Linux Hosts

1. Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
2. Click Maintenance. If migration is enabled at cluster level, any virtual machines running on the host are migrated to other hosts. If the host is the SPM, this function is moved to another host. The status of the host changes as it enters maintenance mode.
3. Click Reinstall to open the Install Host window.
4. Click OK to reinstall the host.

Procedure 7.12. Customizing hosts with tags

1. Use the Hosts resource tab, tree mode, or the search function to find and select the host in the results list.
2. Click Assign Tags to open the Assign Tags window.
   ⁠

   

   Figure 7.1. Assign Tags Window

3. The Assign Tags window lists all available tags. Select the check boxes of applicable tags.
4. Click OK to assign the tags and close the window.

Procedure 7.13. 

1. Place the Hypervisor into maintenance mode so the virtual machines are live migrated to another Hypervisor. See Section 7.5.9, “Moving a Host to Maintenance Mode” for more information. Alternatively, manually shut down or migrate all the virtual machines to another Hypervisor. See Manually Migrating Virtual Machines for more information.
2. Click Remove, and click OK to remove the host from the Administration Portal.
3. Log in to your Hypervisor as the admin user.
4. Press F2, select OK, and press Enter to enter the rescue shell.
5. Modify the IP address by editing the /etc/sysconfig/network-scripts/ifcfg-rhevm file. For example:

   # vi /etc/sysconfig/network-scripts/ifcfg-rhevm
   ...
   BOOTPROTO=none	
   IPADDR=10.x.x.x
   PREFIX=24
   ...

6. Restart the network service and verify that the IP address has been updated.
   • For Red Hat Enterprise Linux 6:

     # service network restart

     # ifconfig rhevm

   • For Red Hat Enterprise Linux 7:

     # systemctl restart network.service

     # ip addr show rhevm

7. Type exit to exit the rescue shell and return to the text user interface.
8. Re-register the host with the Manager. See Installation Guide, Manually Adding a Hypervisor from the Administration Portal for more information.

Procedure 7.14. Updating the FQDN of a Hypervisor Host

1. Place the Hypervisor into maintenance mode so the virtual machines are live migrated to another Hypervisor. See Section 7.5.9, “Moving a Host to Maintenance Mode” for more information. Alternatively, manually shut down or migrate all the virtual machines to another Hypervisor. See Manually Migrating Virtual Machines for more information.
2. Click Remove, and click OK to remove the host from the Administration Portal.
3. • For RHEL-based hosts:
     • For Red Hat Enterprise Linux 6:
       Edit the /etc/sysconfig/network file, update the host name, and save.

       # vi /etc/sysconfig/network
       HOSTNAME=NEW_FQDN

     • For Red Hat Enterprise Linux 7:
       Use the hostnamectl tool to update the host name. For more options, see Red Hat Enterprise Linux 7 Networking Guide, Configure Host Names.

       # hostnamectl set-hostname NEW_FQDN

   • For Red Hat Enterprise Virtualization Hypervisors (RHEV-H):
     In the text user interface, select the Network screen, press the right arrow key and enter a new host name in the Hostname field. Select <Save> and press Enter.
4. Reboot the host.
5. Re-register the host with the Manager. See Installation Guide, Manually Adding a Hypervisor from the Administration Portal for more information.