Emulex OneCommand Manager Application User Manual (P006979-01A Version 5.2, August 2011)

The OneCommand Manager User Manual Page 33
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
• Each line in the file can be up to 1023 characters, although this is longer than is typically
needed for a host IP address and host name. A line longer than 1023 characters is
truncated, possibly causing discovery to not discover some of the hosts.
• Blank lines are ignored.
3. Save the file.
Copying the File
A hosts file on one host can be copied and used on another host. This is useful when there are multiple
hosts on the same network running the OneCommand Manager application. For example, once the
remote hosts are added to the hosts file on one host, you can copy it to other hosts so you do not need
to create another hosts file.
Adding a Single Host
The OneCommand Manager application enables you to specify a single TCP/IP host to manage. You
can add a Remote Management Application Programming Interface (RMAPI) host or CIM host using the
host name or IP address. If the host is successfully discovered it is added to the hosts file. If it has not
been discovered over FC already, the host and its adapter ports are added to the discovery-tree. (Not
available in read-only mode.)
Prerequisites
• The OneCommand Manager application must be installed on the remote host.
Note: Due to the line terminator differences between Windows and Solaris or Linux hosts,
the files cannot be shared between Windows hosts and Solaris or Linux hosts.