Chapter 6: Managing Hosts
This chapter describes viewing host information, managing host groups, and searching for hosts.
Two tabs show host information: the Host Information tab (Figure 11) and the Host Driver Parameters tab (Figure 47). The Host Information tab is read-only. The Host Driver Parameters tab enables you to view and define adapter driver settings for a specific host. See Section 7.17.2, Host Driver Parameters Tab, for more information about the Host Driver Parameters tab.
To view the Host Information tab, perform the following steps:
1. Perform one of the following actions:
– From the View menu, click Group Adapters by Host Name.
– From the toolbar, click the 
Group Adapters by Host Name button.
2. Select a host in the discovery-tree.
3. Select the Host Information tab (Figure 11).
Figure 11: Host Information Tab
The Host Information tab displays the following fields:
n Operating System – Details about the installed operating system.
n Management IP Address – The host's IP address; for example, 10.239.82.131. Local Host is displayed if you selected the host from which you are running the Emulex HBA Manager application.
n Remote Manager Server Version – The version of the Emulex HBA Manager application server that is running on the host.
n Number of Adapters – The number of adapters installed in the host.
n Number of Physical Ports – The number of discovered physical ports that can be managed by this host.
n CIM Provider Version – If the host is being managed using the CIM interface, displays the version of the CIM Provider that is running on the remotely managed system.
NOTE: The CIM Provider Version field appears only if the host is managed through the CIM interface.
The Function Summary area lists the total number of functions and targets.
6.2 Viewing Host Grouping Information
The Host Group Information tab (Figure 12) displays information about the selected host group, such as the group name and the total number of hosts. See Section 6.3, Grouping Hosts, to learn about creating host groups.
NOTE: Host grouping is not supported for VMware.
To view host grouping information, from the discovery-tree (Figure 4), select the host group whose information you want to view.
Figure 12: Host Group Information Tab
The following Host Group Information fields are displayed:
n Group Name – The name of the selected group.
n Number of Hosts – The total number of hosts assigned to the group.
n Number of Adapters – The total number of discovered adapters in the group.
n Number of Physical Ports – The total number of ports in the group.
The Emulex HBA Manager application enables you to assign related hosts to host groups. Typically, hosts within the same host group share some common functions, or they may simply reside within the same organizational unit within an enterprise, such as a payroll group or a shipping and receiving group.
You can display the hosts in the discovery-tree (Figure 4) in either a group-centric format or the host-based flat format. The host grouping capability is available in the Host view, vPort view, or Fabric view mode.
NOTE: The same fabric can appear under more than one host group. For example, some ports on the fabric can be attached to ports and hosts in one host group, and other ports on the same fabric can be attached to ports and hosts in a different host group.
You can also perform batch operations, such as firmware download and driver parameter updates, on a selected set of groups. See Section 8.2, Updating Firmware for Multiple Adapters, for more information.
NOTE: Grouping hosts is not supported on VMware.
To display all hosts without grouping, perform one of the following tasks:
n From the View menu, clear Show Groups.
n From the toolbar, clear the 
Show Host Groups button.
To display all hosts groups, perform the following steps:
1. Perform one of the following tasks:
– From the View menu, select Show Groups.
– From the toolbar, click the 
Show Host Groups button.
2. From the Available Host Group list, choose All.
To display all hosts assigned to a particular group, perform the following steps:
1. Perform one of the following tasks:
– From the View menu, select Show Groups.
– From the toolbar, click the 
Show Host Groups button.
2. From the Available Host Group list, choose the group whose hosts you want to view.
Use the Host Group Management dialog (Figure 13) to create and delete host groups, add and remove hosts, and restore host groups.
NOTE: Managing host groups is not supported on VMware.
Figure 13: Host Group Management Dialog
The following Host Group Management fields are displayed:
n Available Hosts – The list of hosts that can be added to a host group. You can select a host and right-click to see its group assignments.
n Show ungrouped hosts – If selected, displays only hosts that are not currently assigned to a host group.
n Hosts in Selected Group – The list of hosts assigned to the currently selected host group.
n Groups – The list of currently defined host groups. If you select a group in this list, its host members appear in the Hosts in Selected Group list.
The following icons are used in the Host Group Management window:
n 
Indicates that the host is currently assigned to a single host group.
n 
Indicates that the host is currently assigned to multiple host groups.
To create a new host group, perform the following steps:
1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13).
2. Click Create New Group. The Create New Host Group dialog appears (Figure 14).
Figure 14: Create New Host Group Dialog
3. Enter the name of the group that you want to create and click OK. The new group appears in the Groups list on the Host Group Management dialog.
To delete a host group, perform the following steps:
1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13).
2. From the Groups list, select the group that you want to delete. The Host Group Management warning popup appears (Figure 15).
Figure 15: Host Group Management Warning Popup
3. Click Yes to delete the selected host group.
6.3.4 Adding a Host to a Host Group
To add a host to a group, perform the following steps:
1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13).
2. From the Groups list, select the group to which you want to add the host.
3. From the Available Hosts list, select the host that you want to add or select multiple hosts by using Ctrl+Click or Shift+Click. Click the right arrow. The selected host is removed from the Available Hosts list and is added to the Hosts in Selected Group list.
4. Click OK to commit your changes. The discovery-tree (Figure 4) displays the new configuration.
6.3.5 Removing a Host from a Host Group
To remove a host from a host group, perform the following steps:
1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13).
2. From the Groups list, select the group containing the host that you want to remove.
3. From the Hosts in Selected Group list, select the host that you want to remove and click the left arrow. The selected host is removed from the Hosts in Selected Group list and is added to the Available Hosts list.
4. Click OK to commit your changes. The discovery-tree (Figure 4) displays the new configuration.
To restore a host group, perform the following steps:
1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13).
2. Click Restore Group to return the configuration settings for the currently selected host group to those in use when the dialog was opened.
NOTE: If the currently selected group was created during the current configuration session, clicking Restore Group deletes the new group name.
6.3.7 Restoring All Host Groups
To restore all host groups, perform the following steps:
1. From the View menu, select Manage Groups. The Host Group Management dialog appears (Figure 13).
2. Click Restore All Groups to return the entire host group configuration to the state that existed when the dialog was opened. All host group assignments are returned to their original configuration. Newly added host groups yet to be committed are removed, and host groups that were deleted are restored.
6.3.8 Exporting Host Grouping Configurations
To export the host grouping configuration to a remote host, you must copy the various host group configuration files from the host on which the configuration was created to the remote host. Copy the entire contents of the config/hostgroups subdirectory under the Emulex HBA Manager application installation directory to the equivalent location on the remote system.
The following are the hostgroups configuration file locations for the supported platforms:
n Windows: <InstallationDriveLetter>:\Program Files\Emulex\Util\Config\hostgroups
n Linux: /usr/sbin/ocmanager/config/hostgroups
The host group configuration files are completely interchangeable between different operating systems. For example, the host group configuration files created on a Linux host can be copied directly to a Windows host, with no conversion required.
6.4 Searching for Hosts in the Discovery-Tree
The Emulex HBA Manager application enables you to search the discovery-tree (Figure 4) for a particular host by the host’s name. If the specified host name is found, the discovery-tree scrolls up or down to bring the desired host name into view.
This capability is especially useful when you are searching for a host in a large installation with hundreds or thousands of hosts. It is also helpful in Fabric view mode because the ports on a specific host can be dispersed among several fabrics, making the ports on that host difficult to find in the discovery-tree (Figure 4).
To search for a host, perform the following steps:
1. Perform one of the following tasks:
– From the Edit menu, select Find and enter the name of the host that you are searching for into the Find Host field.
– From the toolbar, enter the name of the host that you are searching for into the Find Host field.
2. From the toolbar, click the 
Find Host button or press Enter on the keyboard.
The host that you are searching for is highlighted in the discovery-tree (Figure 4).
Selecting the Find Next option on the Edit menu, or pressing F3, enables you to continue searching for more instances of the name that you specified.