HP-UX Reference (11i v3 07/02) - 1M System Administration Commands N-Z (vol 4)

s
scsimgr(1M) scsimgr(1M)
files with the new LUN. If all affected legacy DSFs are closed, it is not necessary to invoke
replace_leg_dsf after invoking replace_wwid on corresponding LUN paths.
Usage:
scsimgr [-f] replace_leg_dsf
identifier
Note: identifier identifies a legacy Device Special File for the LUN, a LUN, or a target
path.
replace_wwid
Validates the change of a LUN associated to a LUN path. It clears the binding of the LUN
path with an existing LUN and rescans the parent controller or target path so that the
LUN path can be associated with the new LUN.
Note: The scan of the parent object may result in change of state of unrelated LUN paths.
To prevent accidental data corruption, the SCSI stack implements an authentication
mechanism based on the LUN WorldWide Identifier (WWID). When a LUN with a
different WWID is discovered through a previously discovered LUN path, further access to
the device through that LUN path is prevented. The LUN path is put in "Authentication
Failure" state. Then, HP-UX logs a message in syslog which informs the user that the
replace_wwid operation needs to be performed.
If the user has intentionally replaced the LUN, the
scsimgr replace_wwid command
must be run to authorize the re-use of that LUN path for a different LUN.
In some situations, a replacement of a target controller may cause LUN paths of
corresponding target paths to be put in authentication failure state. To validate the
replacement and re-authorize all the affected paths,
scsimgr replace_wwid can be
used with the target path identifier.
If the LUN itself has been replaced and all its previous LUN paths are now connected to
the replaced LUN, scsimgr replace_wwid can be used with the LUN identifier to
allow replacement of all LUN paths associated with that LUN.
If the keyword dsf is specified, the DSF of the replaced LUN is re-assigned to the new
LUN. This allows applications such as volume groups or file systems to continue to use the
same DSF to access the replacing LUN.
This authentication mechanism replaced the one implemented by Fibre Channel Tachyon
TL, Tachyon TL2 and FCD drivers on releases prior to HP-UX 11i Version 3. The
scsimgr replace_wwid command combined with the scsimgr
replace_leg_dsf
command replaces the
fcmsutil replace_dsk command. See
the explanation of the
scsimgr replace_leg_dsf
command and the fcmsutil(1M)
manpage.
Usage:
scsimgr [-f] replace_wwid identifier [dsf]
Note: identifier identifies a LUN, LUN path, or a target path. In case of LUN replacement
(that is, the identifier is a LUN), the keyword dsf directs replace_wwid to also assign
the device file name of the replaced LUN to the new LUN. If the identifier is a LUN path,
or target path, dsf is just ignored.
save_attr Saves values, persistently, of global attributes or attributes of a single SCSI object. If the
keyword default is specified, or the argument is of the form: "-a attr=default", then
the default value is restored persistently across system reboots.
If the keyword default is not mentioned and the argument is of the form: "-a attr=value",
then the current value is replaced with the specified value, and it is saved in a persistent
store.
Attribute values saved in a persistent store are maintained across reboots.
Only values of attributes that are settable or read-write values can be saved. To view the
settable values, use get_attr command with the keyword settable. In case of the
value being saved is a string including a space, it should be put within double quotes
("...").
HP-UX 11i Version 3: February 2007 − 9 − Hewlett-Packard Company 317