sasmgr(1M)

NAME

sasmgr — utility to manage HP-UX Serial Attached SCSI (SAS) Mass Storage I/O cards / HBAs

SYNOPSIS

Path: /opt/sas/bin

sasmgr [-h][-f] add -D device_file -q raid -q level=raid_level -q enc_bay=enc :bay[,enc :bay] [-q size=size] [-q rebuild_rate=rate]

sasmgr [-h][-f] add -D device_file -q raid -q spare -q enc_bay=enc :bay

sasmgr [-h][-f] bdr -D device_file -q lun={all | lun_dsf}

sasmgr [-h] clear_stat -D device_file

sasmgr [-h] clear_stat -D device_file -q all

sasmgr [-h] clear_stat -D device_file -q phy={all | phy_id}

sasmgr [-h] clear_stat -D device_file -q phy_in_port={all | phy_id}

sasmgr [-h] clear_stat -D device_file -q target={all | sasaddr}

sasmgr [-h][-f] delete -D device_file -q raid -q raid_vol={rvol_id | all}

sasmgr [-h][-f] delete -D device_file -q raid -q spare

sasmgr [-h][-f] disable -D device_file

sasmgr [-h][-f] download -D device_file -q downloadfile=filename -q enc_bay=enc :bay

sasmgr [-h][-f] download -D device_file -q downloadfile=filename -q ctrl=ctrl_device_file

sasmgr [-h] enable -D device_file

sasmgr [-h] get_info -D device_file

sasmgr [-h] get_info -D device_file -q lun={all | lun_dsf}

sasmgr [-h][-v] get_info -D device_file -q lun={all | lun_dsf} -q lun_locate

sasmgr [-h] get_info -D device_file -q pci_id

sasmgr [-h] get_info -D device_file -q phy={all | phy_id}

sasmgr [-h] get_info -D device_file -q phy_in_port={all | phy_id}

sasmgr [-h] get_info -D device_file -q raid

sasmgr [-h] get_info -D device_file -q reg={all | offset} [-q reg_type={ pci_config | mmio }]

sasmgr [-h] get_info -D device_file -q smp=file_name

sasmgr [-h] get_info -D device_file -q smp_addr

sasmgr [-h] get_info -D device_file -q target={all | sasaddr}

sasmgr [-h] get_info -D device_file -q vpd

sasmgr [-h] get_stat -D device_file

sasmgr [-h] get_stat -D device_file -q phy={all | phy_id}

sasmgr [-h] get_stat -D device_file -q phy_in_port={all | phy_id}

sasmgr [-h] get_stat -D device_file -q target={all | sasaddr}

sasmgr [-h][-f] replace_tgt -D device_file -q old_dev=lun_dsf -q new_tgt_hwpath=new_hw_path

sasmgr [-h][-f] reset -D device_file

sasmgr [-h] set_attr -D device_file -q lun=lun_dsf -q locate_led={on | off}

sasmgr [-h][-f] set_attr -D device_file -q raid -q raid_vol =rvol_id -q state =vol_state

sasmgr [-h][-f] set_attr -D device_file -q raid -q raid_vol =rvol_id -q rebuild_rate =rebuild_rate

DESCRIPTION

sasmgr is a common diagnostic tool used for all Serial Attached SCSI (SAS) I/O cards / Host Bus Adapters (HBAs). sasmgr requires the use of a device file to indicate the interface over which the requested command needs to be performed.

Options

sasmgr recognizes the following command-line options:

-f: Suppresses the warning messages and continues executing the command.
-h: Provides a brief description of what the command does.
-q: Describes the command's qualifiers. A command is defined by a set of qualifiers which must be specified after the command name. Each qualifier is proceeded by the -q option. Some qualifiers can take one or more values and are given as -q qualifier_name ={x | y} where qualifier_name can take either the value x or y.
-v: Provides verbose information. For example, if you use this option with the get_info command and qualifiers lun and lun_locate, sasmgr will print additional header information.

Commands

sasmgr recognizes the following commands. A command is defined by a set of qualifiers. Qualifiers are specified with the -q option. All keywords are case-sensitive.

add

One of the following sets of qualifiers must be specified with the add command:

raid

level

enc_bay

size

rebuild_rate

This set of qualifiers is used to create a RAID volume with the specified RAID level, volume size and physical disks. The value specified for the level qualifier determines the RAID level for the volume. For example, -q level=1 specifies that a RAID1 volume should be created. The enc_bay qualifier defines or specifies the enclosure and bay of each physical disk of the RAID volume. If the physical disks in a RAID volume are different sizes, then some disk space will be wasted. Volume expansion is not supported; once a volume has been created, its size cannot be increased. If the size qualifier is not specified, then the volume is created with a maximum possible size based on the size of the physical disks specified. If the rebuild_rate qualifier is not specified, then the default rebuild_rate of 20% will be used for the volume.

If the -f option is not specified, sasmgr displays a warning message before continuing the command. Otherwise, it suppresses the warning and executes the command. This command requires superuser privileges. Refer to the Security Restrictions section below.

raid

spare

enc_bay

This set of qualifiers is used to add a global spare disk. The global spare disk is used whenever a physical disk in any RAID volume on the Core I/O card / HBA fails. The enc_bay qualifier defines or specifies the enclosure and bay of the global spare disk. The size of the disk specified should be greater than the size of at least one of the physical disks in the volume.

If the -f option is not specified, sasmgr displays a warning message before continuing the command. Otherwise, it suppresses the warning message and continues executing the command. This command requires superuser privileges. Refer to the Security Restrictions section below.

bdr

The following qualifier must be specified with the bdr command:

lun: Resets the specified target device. This is a destructive operation. If the -f option is not specified with this command, sasmgr displays a warning message before continuing. Otherwise, it suppresses the warning message and executes the command.

clear_stat

When the clear_stat command is run without qualifiers, it clears statistics of the SAS I/O card / HBA represented by device_file.

The following qualifiers are specified with the clear_stat command:

all: Clears all statistics for the SAS I/O card / HBA, all PHYs, all ports, and all targets.
phy: Clears statistics for all PHYs or a specific PHY.
phy_in_port: Clears statistics for a port to which the specified PHY belongs to or clears statistics for all ports.
target: Clears statistics for a specific target or all targets.

delete

One of the following sets of qualifiers must be specified with the delete command:

raid

raid_vol

This set of qualifiers is used to delete the RAID volume given by the volume ID. The volume ID can be obtained from the get_info command using the raid qualifier. If a volume ID of all is specified, then all the RAID volumes will be deleted.

raid

spare

This set of qualifiers is used to delete the Core I/O card / HBA spare disk.

disable

Disables the SAS I/O card / HBA. This is a destructive operation. The SAS I/O card / HBA will become offline, all current I/Os will be aborted, and new I/Os will fail. An enable operation must be performed in order to bring the SAS I/O card / HBA back online.

If the -f option is not specified with this command, sasmgr displays a warning message before continuing. Otherwise, it suppresses the warning message and executes the command.

download

The following qualifiers must be specified with the download command:

downloadfile

enc_bay

Updates the firmware on a SAS disk. The command will update disk firmware for regular physical disks, as well as those that are part of a RAID volume. The downloadfile qualifier takes the name of the file containing the new disk firmware. The enc_bay qualifier takes the enclosure and bay of the disk for which the firmware update is to be done.

If the -f option is not specified, sasmgr displays a warning message before continuing the command. Otherwise, it suppresses the warning message and continues executing the command.

downloadfile

ctrl

Updates the firmware on the specified enclosure. The downloadfile qualifier takes the name of the file containing the new firmware. The ctrl qualifier takes the enclosure device file for which the firmware update is to be done.

If the -f option is not specified, sasmgr displays a warning message before continuing the command. Otherwise, it suppresses the warning message and continues executing the command.

enable: Enables the SAS I/O card / HBA and brings it back online. This command causes the driver to initialize the SAS I/O card / HBA.

get_info

When the get_info command is run without qualifiers, it returns information about the SAS I/O card / HBA represented by device_file.

The following qualifiers are specified with the get_info command:

lun: Shows hardware path and SAS address information for a specific lun or all luns.
lun_locate: Shows lun location information for the lun specified with the lun qualifier.
pci_id: Shows PCI ID information for the SAS I/O card / HBA.
phy: Shows information about all PHYs or a specific PHY.
phy_in_port: Shows information about a port to which the specified PHY belongs or provides information about all ports.
raid: Shows RAID configuration information for the Core I/O card / HBA.
reg: Displays the contents of a specific PCI config space or MMIO register or all PCI config spaces or MMIO registers. PCI config space or MMIO register type is specified with the reg_type qualifier. If reg_type is not specified, then the command assumes a default register type of MMIO.
smp: Issues a SMP command. The file_name must contain the SMP request frame.
smp_addr: Shows the SMP initiator SAS address to send SMP requests.
target: Shows information about a specific target or all targets.
vpd: Shows vital product data information for the SAS I/O card / HBA.

get_stat

When the get_stat command is run without qualifiers, it shows statistics about the SAS I/O card / HBA represented by device_file.

The following qualifiers are specified with the get_stat command:

phy: Shows statistics for all PHYs or a specific PHY.
phy_in_port: Shows statistics for a port to which the specified PHY belongs to or provides statistics for all ports.
target: Shows statistics for a specific target or all targets.

replace_tgt

The following qualifiers must be specified with the replace_tgt command:

old_dev

new_tgt_hwpath

Allows the lun_dsf specified with old_dev to be associated with a new SAS target which is specified with the new_tgt_hwpath qualifier.

If the -f option is not specified, sasmgr displays a warning message before proceeding. Otherwise, it suppresses the warning message and executes the command.

reset

Resets the SAS I/O card / HBA and performs a complete re-initialization. This is a destructive operation. Some I/Os can be aborted by this command.

If the -f option is not specified with this command, sasmgr displays a warning message before continuing. Otherwise, it suppresses the warning message and executes the command.

set_attr

One of the following sets of qualifiers must be specified with the set_attr command:

lun
locate_led: This set of qualifiers is used to turn on or turn off the locate LED for the specified lun. If it is a RAID device lun, then this command turns on or turns off the LOCATE LED for all the physical disks that are part of the RAID volume.

raid

state

raid_vol

This set of qualifiers is used to change the state of the volume based on the value specified by the state qualifier and the volume specified by raid_vol.

If the -f option is not specified, sasmgr displays a warning message before proceeding with the operation. Otherwise, it suppresses the warning message and continues executing the command.

raid

raid_vol

rebuild_rate

This set of qualifiers is used to change the rebuild rate of the volume specified by raid_vol based on the rate specified by the rebuild_rate.

If the -f option is not specified, sasmgr displays a warning message before proceeding with the operation. Otherwise, it suppresses the warning message and continues executing the command.

Security Restrictions

sasmgr requires either superuser privilege or DEVOPS, DACREAD, and DACWRITE privileges for RAID configurations. See privileges(5) for more information about privileged access on systems that support fine-grained privileges.

EXAMPLES

Display all PHY statistics of the SAS I/O card / HBA whose device file is /dev/sasd0:

sasmgr get_info -D /dev/sasd0 -q phy=all 

Display all RAID volume information of the Core I/O card / HBA whose device file is dev/sasd0:

sasmgr get_info -D /dev/sasd0 -q raid 

Clear statistics for a port with PHY ID 1 of the SAS I/O card / HBA whose device file is /dev/sasd0:

sasmgr clear_stat -D /dev/sasd0 -q phy_in_port=1 

Forcefully issue disable request to the SAS I/O card / HBA whose device file is /dev/sasd0:

sasmgr -f disable -D /dev/sasd0 

Add a RAID volume with size 34000 (MB), level 1 (RAID1), and enc_bay 1:4,1:5 to the Core I/O card / HBA whose device file is /dev/sasd0:

sasmgr add -D /dev/sasd0 -q raid -q level=1 -q size=34000 
-q enc_bay=1:4,1:5 

Add a spare disk to the Core I/O card / HBA whose device file is /dev/sasd0 :

sasmgr add -D /dev/sasd0 -q raid -q spare -q enc_bay=1:4,1:5

Delete a RAID volume with volume ID 4 to the Core I/O card / HBA whose device file is /dev/sasd0 :

sasmgr delete -D /dev/sasd0 -q raid -q raid_vol=4

Delete the Core I/O card / HBA Spare on the HBA whose device file is /dev/sasd0 :

sasmgr delete -D /dev/sasd0 -q raid -q spare

Change the state to ACTIVE for the RAID volume with volume id 3.

sasmgr set_attr -D /dev/sasd0 -q raid -q raid_vol=3 
-q state=ACTIVE 

Change the rebuild rate to 20% for the RAID volume with volume id 3.

sasmgr set_attr -D /dev/sasd0 -q raid -q raid_vol=3 
-q rebuild_rate=20 

AUTHOR

sasmgr was developed by HP.

sasmgr(1M)

Technical documentation

» Table of Contents

» Index

NAME

SYNOPSIS

DESCRIPTION

Options

Commands

Security Restrictions

EXAMPLES

SEE ALSO

AUTHOR