User's Guide

The OneCommand Manager User Manual Page 32
• You can add multiple IP addresses for the same host. However, only one of the IP addresses
will be used by OneCommand Manager to manage the adapters on that host.
The Hosts File
The TCP/IP discovery function of the OneCommand Manager application discovery server relies on a
file called the hosts file. This plain text file contains a list of hosts the utility attempts to discover. The
discovery server does not attempt to discover hosts over TCP/IP through any other mechanisms (e.g.
ping sweeps, broadcasts, etc.).
The hosts file is automatically created or modified when you perform any of the following operations:
• Adding a single host from the Add Remote Host window. If the host is discovered, the
OneCommand Manager application adds its IP address and name to the host file.
• Scanning a range of IP addresses for hosts that can be managed. This function is performed in
the Add Remote Hosts window. For each discovered host, the OneCommand Manager
application adds its IP address and name to the host file.
• Removing a host from the host file using the Remove Remote Hosts window. For each removed
host, the OneCommand Manager application removes its IP address and name from the host
file.
• Adding or removing a host using the CLI.
Manually Editing the Hosts File
You can open the hosts file with any text editor, modify the contents and save the file. The name of the
host file is “hbahosts.lst”. Once the file is modified and saved, the updated file is used after the next
TCP/IP discovery cycle is complete. If the discovery server is running, it does not need to be restarted.
To manually edit the hosts file:
1. Locate and open the hosts file.
Windows: The file is located on the system drive in the directory "\Program Files\Emulex\Util" or
"\Program Files (x86)\Emulex\Util" for Itanium 64 hosts.
Solaris: The file is located in the directory "/opt/ELXocm".
Linux: The file is located in the directory "/usr/sbin/ocmanager".
2. Edit the file. Guidelines for editing the file are as follows:
• Each line of the file starts with an IPv4 or IPv6 address. Following the IP address can be any
number of tabs or spaces. This is followed by a “#” character, zero or more tabs or spaces
and the name of the host for that IP address. The host name is not required for discovery. Its
purpose is to make the file more readable and is used by the OneCommand Manager
application to display the host name in the Remove Remote Hosts window when the host is
not discovered. However, the discovery server only needs the IP address to discover the
host.
• IPv6 address tuples are delimited by colons and can be added in shortened notation as
defined by the IPv6 address specification.
• An IP port number can be specified after the IPv4 address by appending a colon and port
number to the address (e.g. 10.192.80.24:23333).
• An IP port number can be specified after an IPv6 address by putting the IPv6 address in
brackets and following it with a colon and the port number. For example,
[fe80::50f1:832:3ce4:8d30]:23333