 |
Index for
Section 8 |
|
 |
Alphabetical
listing for E |
|
 |
Bottom of
page |
|
emxmgr(8)
NAME
emxmgr - Maintains the Fibre Channel Worldwide name to Target ID mappings
for emx devices
SYNOPSIS
emxmgr [-h] [-s] [-d] [-m emx?| -t emx?] [[-f] -c mapping_file]
OPTIONS
To invoke the emxmgr utility interactively, enter the command with no
options.
When not invoked interactively, the following options are available:
-c Changes the emx driver Target ID mappings. The mapping_file is the name
of a file that contains the new mapping data.
Use the -s option to obtain syntax rules for the contents of
mapping_file.
-d Returns a list representing the instance numbers of Fibre Channel host
adapters currently present on the system, such as: emx0 emx1 emx2.
This instance is then used in place of the command argument emx? to
identify a specific host adapter on which an operation is to be
performed.
-f Forces Target ID mapping changes without prompting for confirmation.
-h Provides command help information.
-m Displays the Target ID mappings for a specific Fibre Channel host
adapter. Use the emx? argument to specify the adapter instance, such as
emx1.
Use the -d option to obtain the instance numbers for all host adapters
currently installed on the system.
-s Provides syntax information for the file used as the source of
mapping_file.
-t Displays information on an adapter's current Fibre Channel topology.
The emx? argument specifies which adapter instance, such as emx0 should
be displayed.
Use the -d option to obtain the instance numbers for all host adapters
currently installed on the system.
DESCRIPTION
The emxmgr utility enables you to maintain the mappings of Fibre Channel
Worldwide names to device Target IDs (identifiers) for the emx device
driver. When you use the emxmgr utility to maintain mappings, you do not
need to rebuild the kernel or reboot the system.
Use the emxmgr utility to update and maintain emx mappings when:
· A Fibre Channel device is removed from the system.
· A Fibre Channel device is replaced (swapped).
· You add or remove a host adapter, such as a KGPSA-BC.
· You need to create a symmetrical Fiber Channel configuration for a
cluster.
Note
Any changes made in the file emx_data.c and built into the running
kernel will supersede and changes made using emxmgr the next time the
system is booted.
The emxmgr utility interacts with the emx driver to change the driver's
mappings
The emx driver then saves the revise mappings to the /etc/emx.db and
/etc/emx.info files. The /etc/emx.db file is a binary database that
maintains the persistent emx driver mappings across system reboots. (Refer
to the emx(7) Reference Page for a description of the emx driver and its
associated data files.)
Use the -c command line option to manipulate the CAM Target ID (identifier)
mappings for the emx driver. Target IDs can be added, deleted, or remapped
to new values. The mapping_file argument specifies the name of the input
file containing the new mapping data. The input file syntax is described
later in the section titled The Mapping Syntaxes. Refer also to the
emx_data.c(4) Reference Page for a description of the file syntax.
When you modify the Target ID mappings using emxmgr, the following system
changes occur:
· The kernel immediately updates the emx driver with the changes.
· Target IDs that do not correspond to the IDs of local host adapters
will be changed immediately.
For a change to a local host adapter to take effect, the local system must
be rebooted.
Warning
Changing the Target ID of a device while it is in use may result in an
I/O failure. You may want to minimize target device activity before
using the emxmgr command.
The Mapping Syntaxes
When you provide revised mapping data using the mapping_file option, you
can specify multiple mapping changes at the same time using one of two
syntaxes.
The following rules apply to both syntaxes:
· Each input line contains either a Fibre Channel Worldwide name to CAM
Target ID mapping or a comment.
· Any text not matching one of the mapping syntaxes is considered a
comment.
The syntaxes for the mapping_file file are as follows:
Syntax 1 (the default)
When using this format, a mapping consists of four data fields
separated by whitespace as follows:
inst tgtid FC Port name FC Node Name
Where:
inst (Instance)
Is the Fibre Channel host adapter instance, in the format emx?.
tgid
Is either a decimal value or the string delete. If the decimal
value is negative, it is equivalent to delete.
FC Port Name
Is the N*_port's port name, specified in the XXXX-XXXX-XXXX-XXXX
byte-by-byte form of notation.
FC Node Name
Is the N*_port's node name, specified in the XXXX-XXXX-XXXX-XXXX
byte-by-byte form of notation.
Syntax 2
This syntax accepts mappings in the form that they are specified in the
/etc/emx.info and /sys/data/emx_data.c files. This form of mapping
consists of ten data fields in the format found in the /etc/emx.info
text file as follows:
{ ?, tgtid, pn0, pn1, pn2, pn3, nn0, nn1, nn2, nn3 }
Where:
? Is the Fibre Channel host adapter instance, specified as a single
postive decimal value such as 0 for emx0.
tgid
Is either a decimal value or the string delete. If the decimal
value is negative, it is equivalent to delete.
pn? Are the components of the N*_port's port name, specified 16 bits at
a time, byte swapped for endian-ness. (see the emx_data.c(4)
Reference Page for more information.)
nn? Are the components of the N*_port's node name, specified 16 bits at
a time, byte swapped for endian-ness. (see the emx_data.c(4)
Reference Page for more information.)
Note that you can cut and paste entries into the mapping_file using a text
editor such as vi. See EXAMPLES for sample syntax entries.
EXAMPLES
The following examples demonstrate the use of the emxmgr utility:
1. Use the following command to update the mappings specifying the
mapping_file named newmappings as a data source:
force99> emxmgr -c newmappings
2. The following mapping_file entry assigns the target id 5 on emx0 to
the Fibre Channel N*_port with port name 5000-1FE1-0000-0CB2, and the
node name 5000-1FE1-0000-0CB0:
emx0 5 5000-1FE1-0000-0CB2 5000-1FE1-0000-0CB0
3. The following mapping_file entry also assigns the target id 5 on emx0
to the Fibre Channel N*_port with port name 5000-1FE1-0000-0CB2, and
the node name 5000-1FE1-0000-0CB0, but uses the alternate format:
{0, 5, 0x0050, 0xe11f, 0x0000, 0xb20c, 0x0050, 0xe11f, 0x0000, 0xb00c}
FILES
/usr/sbin/emxmgr
The executable image.
/sys/BINARY/emx.mod
The device driver module.
/etc/emx.db
The binary file that contains persistent Fibre Channel Worldwide name
to CAM Target ID mappings.
/sys/data/emx_data.c
The configuration file for the emx device driver. The emxmgr utility is
used to maintain entries in this file.
/etc/emx.info
A text file representing the contents of the /etc/emx.db file. This is
a readable form of the persistent CAM Target ID to Fibre Channel
N*_Ports mappings for each emx adapter. Note that this file does not
reflect current connectivity, as devices may not be present, but their
Target ID mappings will continue to persist.
SEE ALSO
emx_data.c(4), emx(7),
The TruCluster documentation for information on symmetrical configurations.
|
Index for
Section 8 |
|
|
Alphabetical
listing for E |
|
 |
Top of
page |
|