sasmgr(1M)																sasmgr(1M)

NAME

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

SYNOPSIS


       lun_dsf}

       phy_id}

       phy_id}

       sasaddr}

       rvol_id |

       lun_dsf}

       lun_dsf}

       phy_id}

       phy_id}

       offset}

       sasaddr}

       phy_id}

       phy_id}

       sasaddr}

DESCRIPTION

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

   Options
       recognizes the following command-line options:

	      Suppresses the warning messages and continues executing the command.

	      Provides a brief description of what the command does.

	      Displays information for persistent device files
		     (see intro(7)).  If the command also displays hardware path information, then it shows the hardware path corresponding to the
		     persistent  device file.  For example, if you use this option with the command and the and qualifiers, will print information
		     for the persistent device files and display the corresponding lun hardware paths.

	      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  option.   Some qualifiers can take one or more values and are given as ={x | y} where qualifier_name can take either the
		     value x or y.

	      Provides verbose information.
		     For example, if you use this option with the command and qualifiers and will print additional header information.

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

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

		     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 qualifier determines the RAID level
			    for the volume.  For example, specifies that a RAID1 volume should be created.  The 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 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 qualifier is not specified, then the default of 20% will be
			    used for the volume.

			    If	the  option  is not specified, 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 section below.

		     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 qual-
			    ifier  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 option is not specified, 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
			    section below.

	      The following qualifier must be specified with the
		     command:

		     Resets the specified target device.
			    This is a destructive operation.

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

	      When the
		     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 command:

		     Clears all statistics for the SAS I/O card / HBA, all PHYs, all ports,
			    and all targets.

		     Clears statistics for all PHYs or a specific PHY.

		     Clears statistics for a port to which the specified
			    PHY belongs to or clears statistics for all ports.

		     Clears statistics for a specific target or all targets.

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

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

			    If the option is not specified, 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
			    section below.

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

			    If the option is not specified, 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
			    section below.

	      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 option is not specified with this command, displays a warning message before continuing.  Otherwise, it suppresses the
		     warning message and executes the command.

	      The following qualifiers must be specified with the
		     command:

		     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  qualifier takes the name of the file containing the new disk firmware.  The qualifier takes the enclosure and bay
			    of the disk for which the firmware update is to be done.

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

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

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

		     Updates the firmware on the specified HBA.
			    The qualifier takes the name of the file containing the new firmware.

			    If	the  option  is not specified, 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
			    section below.

			    NOTE:  If  the  firmware is being downgraded to a lower version, an incompatible older version of the firmware may get
			    rejected. This typically happens if the downgraded version of firmware is very old compared to the current one on  the
			    card.

	      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.

	      When the
		     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 command:

		     Shows hardware path and SAS address information for a specific
			    lun  or all luns.  If the option and the qualifier are specified with this command, then it displays persistent device
			    file information.

		     Shows lun location information for the lun specified with the
			    qualifier.	If the option and the qualifier are specified with this command, then it displays persistent  device  file
			    information with the lun location information.

		     Shows PCI ID information for the SAS I/O card / HBA.

		     Shows information about all PHYs or a specific PHY.

		     Shows information about a port to which the specified PHY belongs
			    or provides information about all ports.

		     Shows RAID configuration information for the Core I/O card / HBA.
			    If the option is specified with this command, then it displays persistent device file information.

		     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
			    qualifier.	If is not specified, then the command assumes a default register type of MMIO.

		     Issues a SMP command.
			    The file_name must contain the SMP request frame.

		     Shows the SMP initiator SAS address to send SMP requests.

		     Shows information about a specific target or all targets.

		     Shows vital product data information for the SAS I/O card / HBA.

	      When the
		     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 command:

		     Shows statistics for all PHYs or a specific PHY.

		     Shows statistics for a port to which the specified
			    PHY belongs to or provides statistics for all ports.

		     Shows statistics for a specific target or all targets.

	      The following qualifiers must be specified with the
		     command:

		     Allows the
			    lun_dsf specified with to be associated with a new SAS target, which is specified with  the  qualifier.   The  lun_dsf
			    must  be  the  legacy device file and the new_hw_path must be the legacy hardware path.  This command does not allow a
			    persistent device file or the new style hardware path to be specified with the and qualifiers.  For persistent  device
			    files,  please use the command.  See io_redirect_dsf(1M) for more information.  This command is typically intended for
			    replacing a bad drive.  This operation must not be used while there are outstanding I/O requests to the lun_dsf or	to
			    any LUNs under the new_hw_path.

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

		     Allows the
			    lun_dsf specified with to be associated with a new SAS target, which is specified with  the  qualifier.   The  lun_dsf
			    must  be  the  legacy  device  file.  This command does not allow persistent device files to be specified with the and
			    qualifiers.  For persistent device files, please use the command.  See io_redirect_dsf(1M) for more information.  This
			    command  is typically intended for replacing a bad drive.  This operation must not be used while there are outstanding
			    I/O requests to the new lun_dsf.

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

		     Allows the HW path specified with
			    to	be  associated with a new SAS target, which is specified with the qualifier.  The and the must be the legacy hard-
			    ware paths.  This command does not allow the new style hardware paths to be specified with the  and  qualifiers.   For
			    persistent lun hardware paths, please use the command.  See io_redirect_dsf(1M) for more information.  This command is
			    typically intended for replacing a bad drive.  This operation must	not  be  used  while  there  are  outstanding  I/O
			    requests to any LUNs under the

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

	      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 option is not specified with this command, displays a warning message before continuing.  Otherwise, it suppresses the
		     warning message and executes the command.

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

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

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

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

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

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

   Security Restrictions
       requires either superuser privilege or and 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

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

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

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

       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

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

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

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

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

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

       Update the firmware on the specified HBA.

AUTHOR

       was developed by HP.

SEE ALSO

       privileges(5), intro(7).

       at

																	sasmgr(1M)