Red Hat Training

A Red Hat training course is available for Red Hat Gluster Storage

4.2. Hosts Operations

4.2.1. Adding Hosts

You must install hosts and configure them with a name and IP address before you can add them to the Red Hat Storage Console.

Important

If you re-install the Red Hat Storage Console, you must remove all hosts and reconnect them with the correct SSH keys for the new installation of Red Hat Storage Console.
Prerequisites

Before you can add a host to Red Hat Storage, ensure your environment meets the following criteria:

  • The host hardware is Red Hat Enterprise Linux certified. See https://hardware.redhat.com/ to confirm that the host has Red Hat certification.
  • The host should have a resolvable hostname or static IP address.

Procedure 4.1. To Add a Host

Before adding a host, ensure you have the correct IP and password for the host. The process of adding a new host can take some time; you can follow its progress in the Events pane.
  1. Click the Hosts tab to list available hosts.
  2. Click New to open the New Host window.
    New Host Window

    Figure 4.2. New Host Window

  3. Select the Host Cluster for the new host from the drop-down menu.

    Table 4.2. Add Hosts Properties

    Field
    Description
    Host Cluster
    		The cluster to which the host belongs.
    Name
    The name of the host. This text field has a 40-character limit and must be a unique name with any combination of uppercase and lowercase letters, numbers, hyphens, and underscores.
    If Nagios is enabled, the host name given in Name field of Add Host window should match the host name given while configuring Nagios.
    Address
    		The IP address or resolvable hostname of the host.
    Root Password
    		The password of the host's root user. This can only be given when you add the host, it cannot be edited afterwards.
    SSH Public Key
    		Copy the contents in the text box to the /root/.ssh/authorized_keys file on the host if you'd like to use the Manager's ssh key instead of using a password to authenticate with the host.
    Automatically configure host firewall
    When adding a new host, the Manager can open the required ports on the host's firewall. This is enabled by default. This is an Advanced Parameter.
    The required ports are opened if this option is selected.
    SSH Fingerprint
    		You can fetch the host's ssh fingerprint, and compare it with the fingerprint you expect the host to return, ensuring that they match. This is an Advanced Parameter.
  4. Enter the Name, and Address of the new host.
  5. Select an authentication method to use with the host:
    1. Enter the root user's password to use password authentication.
    2. Copy the key displayed in the SSH PublicKey field to /root/.ssh/authorized_keys on the host to use public key authentication.
  6. The mandatory steps for adding a Red Hat Storage host are complete. Click Advanced Parameters to show the advanced host settings:
    1. Optionally disable automatic firewall configuration.
    2. Optionally add a host SSH fingerprint to increase security. You can add it manually, or fetch it automatically.
  7. Click OK to add the host and close the window.
    The new host displays in the list of hosts with a status of "Installing" and then it goes to "Initialization" state and the host comes up.

    Note

    The host will be in Up status after the status of "Installing" and "Initialization" state. The host will have Non-Operational status when the host is not compatible with the cluster compatibility version. The Non-Responsive status will be displayed if the host is down or is unreachable.
    You can view the progress of the host installation in the Details pane.

4.2.2. Activating Hosts

After taking down a host for maintenance, you must reactivate it before using it. When you activate a host, the host's networks are checked and the check if the glusterd is operational is also performed.

Procedure 4.2. To Activate a Host

  1. In the Hosts tab, select the host you want to activate.
  2. Click Activate. The host status changes to Up.

4.2.3. Managing Host Network Interfaces

The Network Interfaces tab in Details pane of Hosts enables you to attach the management network to a host's physical network interface cards. The management network is defined, by default in the cluster. The administration portal automatically assigns the management network to the network interface which has the host address that was provided while adding a host.

Note

You cannot define new logical networks at the host level, only ovirtmgmt is supported.

4.2.3.1. Editing Host Network Interfaces

The Network Interfaces tab displays the name, network name, address, MAC address, speed, and link status for each interface. It also provides several options for managing host network interface cards.

Procedure 4.3. To Edit a Host Network Interface

  1. Click the Hosts tab to display a list of hosts. Select the desired host to display the Details pane.
  2. Click Setup Host Networks to open the Setup Host Networks window.
    Setup Host Networks Window

    Figure 4.3. Setup Host Networks Window

  3. Edit the management networks by hovering over an assigned logical network and clicking the pencil icon to open the Edit Management Network window.
  4. If your logical network definition is not synchronized with the network configuration on the host, select the Sync network check box.
  5. Select a Boot Protocol:
    • None
    • DHCP
    • Static - provide the IP and Subnet Mask.
  6. Click OK.
  7. Select Verify connectivity between Host and Engine to run a network check.
  8. Select Save network configuration if you want the network changes to be persistent when you reboot the environment.
  9. Click OK to implement the changes and close the window.

4.2.3.2. Editing Management Network Interfaces

The Network Interfaces tab displays the name, network name, address, MAC address, speed, and link status for each interface. In the course of editing the host network interface cards, you may need to check or edit the management network interface.

Important

Clusters and hosts communicate through the management interface. Changing the properties of the management interface can cause the host to become unreachable.

Procedure 4.4. To Edit a Management Network Interface

  1. Click the Hosts tab to display a list of hosts. Select the desired host to display the Details pane.
  2. Edit the logical networks by hovering over an assigned logical network and clicking the pencil icon to open the Edit Management Network window.
    Edit Management Network Dialog Box

    Figure 4.4. Edit Management Network Dialog Box

  3. If your logical network definition is not synchronized with the network configuration on the host, select the Sync network check box.
  4. Select a Boot Protocol:
    • None
    • DHCP
    • Static - provide the IP and Subnet Mask.
  5. Make the required changes to the management network interface:
    1. To attach the ovirtmgmt management network to a different network interface card, select a different interface from the Interface drop-down list.
    2. Select the network setting from None, DHCP or Static. For the Static setting, provide the IP, Subnet and Default Gateway information for the host.
    3. Click OK to confirm the changes.
    4. Select Verify connectivity between host and engine if required.
    5. Select Save network configuration to make the changes persistent when you reboot the environment.
  6. Click OK.
  7. Activate the host. See Section 4.2.2, “Activating Hosts”.

4.2.4. Configuring Network Interfaces

After connecting physical network interface cards to logical networks, you can perform further configuration. For example, you can aggregate links, separate bonded links, or detach network interface cards from the network. Before performing these actions, Red Hat recommends you save the current network configuration.

4.2.4.1. Saving Host Network Configurations

After connecting physical network interface cards to logical networks, you can perform further configurations. Before performing the configurations, Red Hat recommends you save the current network configuration.
After correctly configuring the network, Red Hat recommends you save the network configuration.

Procedure 4.5. To Save a Host Network Configuration

  1. Click the Hosts tab to display a list of hosts. Select the desired host to display the Details pane.
  2. Click Maintenance to place the host into maintenance. Click OK to confirm the action. The Status field of the host changes to Preparing for Maintenance, followed by Maintenance. The icon changes to indicate that the host is in maintenance mode.
  3. Click the Network Interfaces tab in the Details pane to display the list of network interface cards in the host, their addresses, and other specifications. Select the network interface card that you want to edit.
  4. Click Save Network Configuration to save the host network configuration. The Events pane displays the message: Network Changes were saved on Host HOSTNAME.

4.2.4.2. Deleting Hosts

You can permanently remove hosts that are not in use. Deleting unused hosts saves system resources, as existing hosts are contacted at regular intervals.

Note

You can not remove hosts if it has volumes in it. Removing a host will detach the host from the cluster.

Procedure 4.6. To Delete a Host

  1. Click the Hosts tab to display a list of hosts. Select the host you want to remove. If the required host is not visible, perform a search.
  2. Click Maintenance to place the host into maintenance. Click OK to confirm the action. The Status field of the host changes to Preparing for Maintenance, followed by Maintenance. The icon changes to indicate that the host is in maintenance mode.
  3. Click Remove.
  4. Click OK to confirm.

4.2.4.3. Managing Gluster Sync

Gluster Sync periodically fetches the latest cluster configuration from glusterFS and synchronizes it with the engine database. The Red Hat Storage Console continuously monitors storage clusters for the addition and removal of hosts. If a change is detected, an action item displays in the Cluster tab with the option to Import or Detach the host.

Procedure 4.7. To Import a Host to a Cluster

  1. Click the Cluster tab and select a cluster to display the General tab with details of the cluster.
  2. In Action Items, click Import to display the Add Hosts window.
    Add Hosts Window

    Figure 4.5. Add Hosts Window

  3. Enter the Name and Root Password. Select Use a common password if you want to use the same password for all hosts.
  4. Click Apply.
  5. Click OK to add the host to the cluster.

Procedure 4.8. To Detach a Host from a Cluster

  1. Click the Cluster tab and select a cluster to display the General tab with details of the cluster.
  2. In Action Items, click Detach to display the Detach Hosts window.
  3. Select the host you want to detach and click OK. Select Force Detach if you want to perform force removal of the host from the cluster.