scsimgr.1m (2011 03)

ManualsBrandsHP ManualsSoftwareHP-UX Manpages

scsimgr(1M) scsimgr(1M)

NAME

scsimgr - SCSI management and diagnostic utility

SYNOPSIS

/usr/sbin/scsimgr

[-fpv] command [-d driver][identiﬁer][keyword]... [argument ]...

/usr/sbin/scsimgr

[-h][-d driver][command]

DESCRIPTION

scsimgr performs management and diagnostic operations on the SCSI objects and subsystems.

SCSI objects are identiﬁed by either their hardware path, hardware path alias, character Device Special

File (DSF), or their class and instance number. These are typically visible in the output of

ioscan.

Some SCSI objects may be identiﬁed by their object type and instance number. SCSI objects are typically

a single LUN (logical unit number), LUN path, target path, target port, enclosure, HBA controller, or a

group of these. The SCSI object is speciﬁed as an identiﬁer in the command line.

A SCSI subsystem is typically the SCSI services module, a SCSI class driver, or a SCSI interface (also

known as I/F) driver.

scsimgr provides generic management and diagnostic capabilities for the SCSI subsystem as well as

speciﬁc management and diagnostic capabilities for SCSI class drivers or SCSI interface drivers through

plug-ins provided by these drivers.

Refer to the respective manpages of the

scsimgr driver plug-ins for detailed description of commands

and other functions speciﬁc to that driver. The manpages of driver plug-ins are in section 7, and are of

the form: scsimgr_driver where driver is the name of the driver. For example scsimgr_esdisk(7) is the

manpage of the

scsimgr plug-in for the esdisk driver.

A SCSI subsystem may maintain a set of attributes. An attribute is a data value associated with either

the SCSI subsystem, a set of SCSI objects, or a single instance of a SCSI object. It has a name, a data

type, and may have one or more value instances: current (run-time value), saved (value in a persistent

store), and default.

An attribute can be read-only or read-write. Read-only attributes are global or per-object instance infor-

mation that can be queried individually through their name. Saved and default values are irrelevant for

such attributes.

Read-write (or settable) attributes are tunables. Users or user applications can change their current or

saved values. The saved value is used to set the current value of the attribute at system boot or other re-

initialization points. When no saved value exists, the default value is used to set the current value.

Attributes can be generic or driver speciﬁc. Generic attributes do not depend on a class or an interface

driver. They are described in this manpage. Driver speciﬁc attributes are maintained by a class or an

interface driver. They are described in the respective manpages of the driver plug-ins for

scsimgr.

To ease management, adapt to various resource conditions, and increase the interoperability and reliabil-

ity of the SCSI stack, settable attributes can be deﬁned at various scopes or levels:

• Global: A value of an attribute set at this scope, affects the default behavior for the SCSI stack, a class

driver or an interface driver. For instance, the default I/O timeout can be set to 60sec for all SCSI

devices.

• Device Set or DDR (Device Data Repository): This scope includes a set of devices bound to a driver,

and deﬁned by parameters such as device type, vendor identiﬁer, product identiﬁer or product revi-

sion. An attribute set at this scope affects the default behavior for the set of devices bound to the

speciﬁed driver and meeting the speciﬁed criteria. For instance, the default I/O time out can be set to

60sec for disk devices from HP and bound to driver esdisk, and to 120sec for all tape devices bound

to driver estape.

• Per a speciﬁc instance of an object: A value of an attribute set at this scope overwrites the default

behavior for a speciﬁc instance of an object. For instance, I/O time out can be set to 50sec for

disk0.

When the change to the current value of an attribute takes effect depends on the attribute and the level

or scope where the change is performed. In general, change of an attribute at a global or intermediate

level (such as, device type and vendor id) will immediately affect the current values of all existing objects

covered by the scope.

For example, if the default I/O timeout is changed for all HP disk devices, this will immediately affect I/O

timeout for all HP disk devices whether they are currently open or not. However, the change will not

HP-UX 11i Version 3: March 2011 − 1 − Hewlett-Packard Company 1

Summary of content (28 pages)

PAGE 1
scsimgr(1M) scsimgr(1M) NAME scsimgr - SCSI management and diagnostic utility SYNOPSIS /usr/sbin/scsimgr [-fpv] command [-d driver ] [identifier ] [keyword ]... [argument ]... /usr/sbin/scsimgr [-h] [-d driver ] [command] DESCRIPTION scsimgr performs management and diagnostic operations on the SCSI objects and subsystems. SCSI objects are identified by either their hardware path, hardware path alias, character Device Special File (DSF), or their class and instance number.
PAGE 2
scsimgr(1M) scsimgr(1M) affect any HP disk device for which the user has explicitly set a different value for I/O timeout. A given attribute can not necessary be set at all levels. Certain attributes can only be set at a global level. That is the case for attributes adjusting global resource usage. Other attributes can only be set at a per object instance level. Some drivers do not provide the possibility to set attributes at intermediate level; such as, device type and vendor identifier.
PAGE 3
scsimgr(1M) scsimgr(1M) get_attr Displays information on attributes. get_devid Gets an identifier for a device. get_info Displays information. get_stat Displays statistics. inquiry Requests information on parameters of the target and a component LUN. lun_map Displays information about LUN paths of a LUN. lun_reset Resets a LUN. replace_leg_dsf Validates the change of a LUN associated with a legacy DSF. replace_wwid Validates the change of a LUN associated to a LUN path.
PAGE 4
scsimgr(1M) scsimgr(1M) driver Name of the driver (for example, esdisk). pdt Peripheral device type in hex (for example, 0x0, 0x1) as returned from inquiry data.
PAGE 5
scsimgr(1M) scsimgr(1M) -a attribute where attribute is an attribute argument in one of the three forms below: attr | attr =value | attr =default with the following meaning: attr Name of an attribute. value Value to set current and/or saved value of the attribute. default When specified with the command save_attr, the default value of the attribute is persistently restored. Note: Valid attribute names can be obtained by running the command: scsimgr get_attr identifier They depend on the identifier.
PAGE 6
scsimgr(1M) scsimgr(1M) statistics, you must specify the option "-d driver" without any SCSI object identifier or keyword for a group of SCSI objects. If the identifier all is specified with clear_stat, clear_stat clears the statistics of all SCSI HBA controllers, all target paths, all LUN paths, and all LUNs in the system. You do not need to use any other identifiers. This operation also resets the global generic statistics.
PAGE 7
scsimgr(1M) scsimgr(1M) recommends that you consult your HP support representative before adding or deleting a settable attribute scope. Usage: scsimgr [-f] ddr_add -N attr_scope scsimgr [-f] ddr_del -N attr_scope ddr_list Lists driver settable attribute scopes registered on the system. Usage: scsimgr ddr_list Note: The attribute scope specifies the set of devices affected by attribute values set at this level.
PAGE 8
scsimgr(1M) scsimgr(1M) The SCSI object can be disabled either administratively by invoking the disable command, or by the SCSI stack upon detection of certain types of critical errors. When this condition has occurred, HP-UX logs a message in syslog which informs the user that a SCSI object has been disabled.
PAGE 9
scsimgr(1M) scsimgr(1M) scsimgr [-v] get_attr [ identifier | all_lun | all_ctlr | all_tport | all_encl | all_ddr] [current] [default] [saved] [ nonsettable | settable | { -a attr... -a attr } ] scsimgr -v get_attr [ identifier {all_lpt | all_tp | all_ddr}] [current] [default] [saved] [ nonsettable | settable | { -a attr... -a attr } ] scsimgr [-v] get_attr -A alias all_tp [ current | default |saved] [-a attr...
PAGE 10
scsimgr(1M) scsimgr(1M) device_file Device special file. Can be used for LUNs or HBA controllers. hw_path Hardware path of the SCSI object. Can be used for LUNs, LUN paths, target paths, and HBA controllers. hwp_alias Hardware path alias of the SCSI object. Can be used for LUNs, LUN paths, target paths, and HBA controllers. instance Instance number of the SCSI object. Should be used along with the class to identify a LUN, LUN path, target path, or an HBA controller. class Class of the SCSI object.
PAGE 11
scsimgr(1M) scsimgr(1M) scsimgr inquiry identifier [ page-key | page ] Note: page is page number in hexadecimal page-key is the page as ASCII string, and can be one of the following: supported: supported pages (0x00) wwid: identifier page (0x83) serial: serial number page (0x80) implemented: implemented operating definitions (0x81) ascii: ASCII operating definitions (0x82) extended: extended inquiry data page (0x86) Note: identifier identifies a LUN or a LUN path.
PAGE 12
scsimgr(1M) scsimgr(1M) 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.
PAGE 13
scsimgr(1M) scsimgr(1M) 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 ("...").
PAGE 14
scsimgr(1M) scsimgr(1M) certain devices or proper operation of the system. It should be done only by an experienced user. HP recommends that you consult your HP support representative before changing attribute values. set_devid See get_devid above. sync_cache Requests synchronization of the write cache of a block device. Data in the cache are written in the medium. Usage: scsimgr sync_cache identifier Note: identifier identifies only a LUN. warm_bdr See cold_bdr above.
PAGE 15
scsimgr(1M) scsimgr(1M) escsi_maxphys RW uint32 Maximum I/O size allowed by the SCSI subsystem in 4KB units. Range: 64 - 1048575 alua_enabled RO boolean Indicates whether Asymmetric Logical Unit Access (ALUA) functionality is enabled by default. A value of false (0) implies that by default ALUA functionality will be ignored for the devices supporting it. A value of true (1) implies that by default ALUA functionality will be handled for the devices supporting it.
PAGE 16
scsimgr(1M) Object LUN A scsimgr(1M) encl_discovery_enable RW boolean hwp_alias_enable boolean RW To enable/disable setting default hardware path aliases. This value is only applicable at boot time or when new storage objects are discovered during an ioscan. Values: false (0) or true (1).
PAGE 17
scsimgr(1M) Object LUN path scsimgr(1M) Range: 0 - 0xFFFFFFFE Enable (true) or disable (false) multi-pathing on legacy DSF of this LUN. Values: false (0) or true (1). leg_mpath_enable RW boolean max_q_depth RW uint32 Maximum queue depth. Range: 1 - 0xFFFFFFFE lpt_to_lockdown RW string User provided lunpath to lock down for the LUN. Hardware path, or class and instance number of the lunpath should be provided as the identifier.
PAGE 18
scsimgr(1M) A scsimgr(1M) protocol lunid RO RO string uint64 SCSI transport protocol LUN identifier within the target class instance RO RO string uint32 Class of the LUN path Instance number of the LUN path hw_path RO string Hardware path of the LUN path wrr_path_weight RW uint32 Weight assigned to the LUN path when I/O load balancing policy is set to weighted_rr (weighted round robin).
PAGE 19
scsimgr(1M) scsimgr(1M) global as well as HBA scopes. Values: false (0) or true (1). To enable/disable congestion control on the target port of the target path. Values: false (0) or true (1). tport_qdepth_enable RW boolean tport_max_qdepth RW uint32 Maximum queue depth assigned to the target port of the target path. Note: This attribute is only valid when tport_qdepth_enable has been set to true (1).
PAGE 20
scsimgr(1M) scsimgr(1M) string User friendly name assigned to the target port tport_qdepth_enable RW boolean To enable/disable congestion control on the target port. Values: false (0) or true (1). tport_max_qdepth RW uint32 Maximum queue depth assigned to the target port. Note: This attribute is only valid when tport_qdepth_enable has been set to true (1). Range: 1 - 0xFFFFFFFE tport_qd_dyn RW boolean To enable/disable dynamic congestion control on the target port.
PAGE 21
scsimgr(1M) scsimgr(1M) firmware_rev RO string Firmware revision of the controller cur_speed RO string Current configured link speed max_speed capability RO RO string string Maximum link speed Capabilities of Controller. The controller can have no capabilities ("none") or a combination of the following capabilities: boot: able to be used for boot. dump: able to be used for dump.
PAGE 22
scsimgr(1M) scsimgr(1M) tport_qd_dyn RW boolean (1). To enable/disable dynamic congestion control on the target port of the target path. Values: false (0) or true (1). Note: This attribute is only valid when tport_qdepth_enable has been set to true (1). Notes: • Setting the value of attribute max_q_depth for a LUN, will set the queue depth for all LUN paths of the LUN to the value specified.
PAGE 23
scsimgr(1M) scsimgr(1M) • The tport_max_qdepth attribute determines the maximum number of IOs issued to the target port. If a target port is seen through several target paths, tport_max_qdepth can be set and displayed through any one of the target paths. Automatic distribution of target port’s maximum queue depth over the servers in a HP ServiceGuard cluster may happen only if appropriate version of HP ServiceGuard software is installed. Please refer to HP ServiceGuard release notes for more information.
PAGE 24
scsimgr(1M) scsimgr(1M) To get statistics for legacy LUN /dev/rdsk/c0t0d0: scsimgr get_stat -D /dev/rdsk/c0t0d0 To get basic statistics for all LUN paths of disk0: scsimgr get_stat -D /dev/rdisk/disk0 all_lpt To get all statistics for the SCSI controller with class fc and instance number 1: scsimgr -v get_stat -C fc -I 1 To get all the statistics for target path with the hardware path of 0/4/1/0.0x60060b000014f45a0001000000000011: scsimgr -v get_stat -H 0/4/1/0.
PAGE 25
scsimgr(1M) scsimgr(1M) To display extended information on generic global attributes: scsimgr -v get_attr To display driver esdisk global attributes: scsimgr -v get_attr -d esdisk To display information on attribute for disk0: scsimgr get_attr -D /dev/rdisk/disk0 To display current values only of attributes for LUN whose class is disk and instance 0: scsimgr get_attr -D /dev/rdisk/disk0 current To display default values only of settable attributes for a SCSI HBA controller with DSF /dev/fcd3: scsimgr
PAGE 26
scsimgr(1M) scsimgr(1M) scsimgr ddr_add -N ’/escsi/esdisk/0x0/HP /ST39103FC’ To delete a settable attribute scope for disk devices from HP with product identifier "ST39103FC" bound to driver esdisk.
PAGE 27
scsimgr(1M) scsimgr(1M) scsimgr activate -D /dev/rdisk/disk47 To activate all LUN paths in standby state to active/optimized state for LUN associated with the LUN path having hardware path 0/4/1/0.0x50001fe1500170b9.0x401a000000000000: scsimgr activate -H 0/4/1/0.0x50001fe1500170b9.0x401a000000000000 WARNINGS The following actions may affect interoperability with certain devices or proper operation of the system. They should be done only by an experienced user.
PAGE 28
(Notes) A (Notes) sA 28 Hewlett-Packard Company −1− HP-UX 11i Version 3: March 2011