luxadm(1M)




NAME

     luxadm - administration program for the Sun Enterprise  Net-
     work Array (SENA), RSM, SPARCstorage Array (SSA) subsystems,
     Sun Fire 880  internal  storage  subsystem,  and  individual
     Fiber Channel Arbitrated Loop (FC_AL) devices


SYNOPSIS

     luxadm  [options...]   subcommand   [options...]   enclosure
     [,dev] | pathname...


DESCRIPTION

     The luxadm program is an administrative command that manages
     the  SENA,  RSM, SPARCstorage Array subsystems, Sun Fire 880
     internal storage subsystem, and  individual  FC_AL  devices.
     luxadm performs a variety of control and query tasks depend-
     ing on the command line arguments and options used.

     The command line must contain a subcommand. The command line
     may  also  contain  options,  usually at least one enclosure
     name or pathname, and other parameters depending on the sub-
     command.  You  need  specify  only as many characters as are
     required to uniquely identify a subcommand.

     Specify the device  that  a  subcommand  interacts  with  by
     entering  a  pathname. For the SENA subsystem, a disk device
     or enclosure services controller may instead be specified by
     entering  the World Wide Name (WWN) for the device or a port
     to the device.  The device may also be specified by entering
     the  name  of the SENA enclosure, and an optional identifier
     for the particular device in the enclosure.  The  individual
     FC_AL  devices  may be specified by entering the WWN for the
     device or a port to the device.

  Pathname
     Specify the device or controller by either a complete physi-
     cal pathname or a complete logical pathname.

     For SENA, a typical physical pathname for a device is:

     /devices/sbus@1f,0/SUNW,socal@1,0/sf@0,0/ssd@w2200002037000f96,
              0:a,raw

     or

     /devices/io-unit@f,e0200000/sbi@0,0/SUNW,socal@2,0/sf@0,0/ssd@34,
              0:a,raw

     For all SENA IBs (Interface Boards) and  Sun  Fire  880  SES
     device controllers on the system, a logical link to the phy-
     sical paths is kept in the directory /dev/es. An example  of
     a logical link is /dev/es.

     The WWN may be used in place of the pathname  to  select  an
     FC_AL  device,  SENA  subsystem IB, or Sun Fire 880 internal
     storage subsystem. The WWN is a unique 16 hexadecimal  digit
     value that specifies either the port used to access the dev-
     ice or the device itself. A typical WWN value is:

          2200002037000f96

     See NOTES for more information on the WWN formats.

     For the SPARCstorage Array controller,  a  typical  physical
     pathname is:

     /devices/.../.../SUNW,soc@3,0/SUNW,pln@
          axxxxxxx,xxxxxxxx:ctlr

     whereas, a typical physical pathname for an  RSM  controller
     is:

          /devices/sbus@1f,0/QLGC,isp@1,10000:devctl

     In order to make it easier to address the SPARCstorage Array
     or RSM controller, a logical pathname of the form cN is sup-
     ported, where N is the  logical  controller  number.  luxadm
     uses the cN name to find an entry in the /dev/rdsk directory
     of a disk that is attached to the SPARCstorage Array or  RSM
     controller.  The  /dev/rdsk  entry is then used to determine
     the physical name of the  SPARCstorage  Array  or  RSM  con-
     troller.

     For a SPARCstorage Array disk, a typical  physical  pathname
     is:

     /devices/.../.../SUNW,soc@3,0/SUNW,
          pln@axxxxxxx,xxxxxxxx/ssd@0,0:c,raw

     and a typical logical pathname is:

          /dev/rdsk/c1t0d0s2

     For an  RSM a typical physical pathname is:

     /devices/sbus@1f,0/QLGC,isp@1,10000/sd@8,0:c,raw

     and a typical logical pathname is:

     /dev/rdsk/c2t8d0s2

     For a disk in a Sun Fire 880 internal storage  subsystem,  a
     typical physical pathname is:

     /devices/pci@8,600000/SUNW,qlc@2/fp@0,0/ssd@w2100002037a6303c,0:a

     and a typical logical pathname is:

     /dev/rdsk/c2t8d0s2

     For individual FC_AL devices, a  typical  physical  pathname
     is:

     /devices/sbus@3.0/SUNW,socal@d,10000/sf@0,0/ssd@w2200002037049fc3,0:a,raw

     and a typical logical pathname is:

     /dev/rdsk/c1t0d0s2

  Enclosure
     For SENA, a device may be identified by its  enclosure  name
     and slotname:

               box_name[,fslot_number]

               box_name[,rslot_number]

     box_name is the name of the SENA enclosure, as specified  by
     the   enclosure_name  subcommand.   When  used  without  the
     optional slot_number parameter, the box_name identifies  the
     SENA subsystem IB.
     f or r specifies the front or rear slots in the SENA  enclo-
     sure.

     slot_number specifies the slot number of the device  in  the
     SENA enclosure, 0-6 or 0-10.

     For a Sun Fire 880 internal storage subsystem, a device  may
     also be identified by its enclosure name and slot name. How-
     ever, there is only one set of disks:

     box_name[,sslot_number]

     box_name is the name of  the  Sun  Fire  880  enclosure,  as
     specified   by  the  enclosure_name  subcommand.  When  used
     without the optional slot_number parameter, box_name identi-
     fies  the  Sun Fire 880 internal storage subsystem enclosure
     services device. Use s to specify the disk  slot  number  in
     the Sun Fire 880 internal storage subsystem, 0 - 11.

     See disks(1M) and devlinks(1M) for additional information on
     logical names for disks and subsystems.


OPTIONS

     The following options are supported by all subcommands:

     -e    Expert mode. This option is not  recommended  for  the
           novice user.

     -v    Verbose mode.

     Options that are  specific  to  particular  subcommands  are
     described with the subcommand in the USAGE section.


OPERANDS

     The following operands are supported:

     enclosure
           The box_name of the SENA. or  Sun  Fire  880  internal
           storage subsystem.

     fibre_channel_HBA_port
           The path to the host controller port. A  typical  path
           is:

            /devices/pci@8,600000/pci@1/SUNW,qlc@4/fp@0,0:devctl

     pathname
           The logical or physical path of a SENA IB,,  Sun  Fire
           880  internal storage subsystem, SPARCstorage Array or
           RSM controller (cN name) or disk device. pathname  can
           also be the WWN of a SENA IB, SENA disk, or individual
           FC_AL device.


USAGE

  Subcommands
     display enclosure[,dev]...| pathname...

     display -p pathname ...

     display -r enclosure[,dev]...| pathname...

     display - v enclosure[,dev]...| pathname...
           Displays enclosure or device specific data.

           Subsystem data  consists  of  enclosure  environmental
           sense  information  and  status for all subsystem dev-
           ices, including disks.

           Disk data consists of inquiry,  capacity,  and  confi-
           guration information.

           -p    Displays performance information for the  device
                 or  subsystem specified by pathname. This option
                 only applies to subsystems that accumulate  per-
                 formance information.

           -r    Displays error information for the FC_AL  device
                 specified  by the pathname, or, if the path is a
                 SENA, for all devices on the loop. The -r option
                 only  applies  to SENA subsystems and individual
                 FC_AL devices.

           -v    Displays in verbose mode, including  mode  sense
                 data.

     download [ -s ] [ -w WWN ] [ -f filename_path ] enclosure...
           Download the prom image pointed to by filename_path to
           the  SENA subsystem Interface Board unit, the Sun Fire
           880 internal storage subsystem,  or  the  SPARCstorage
           Array  controllers specified by the enclosure or path-
           name. The SPARCstorage Array must be reset in order to
           use the downloaded code.

           When the SENA's download is complete, the SENA will be
           reset and the downloaded code executed. If no filename
           is specified, the default prom image will be used. The
           default  prom  image  for  the SPARCstorage Array con-
           troller is  in  usr/lib/firmware/ssa/ssafirmware.  The
           default  prom  image  for the SENA is in the directory
           usr/lib/locale/C/LC_MESSAGES and is named ibfirmware

           When the Sun Fire  880  internal  storage  subsystem's
           download  is  complete,  the  subsystem resets and the
           downloaded code begins execution. The default firmware
           image  for the Sun Fire 880 internal storage subsystem
           is          in:           /usr/platform/SUNW,Sun-Fire-
           880/lib/images/int_fcbpl_fw.

           -s    Save. The -s option is used to  save  the  down-
                 loaded  firmware  in  the  FEPROM.  If -s is not
                 specified, the downloaded firmware will  not  be
                 saved across power cycles.

                 The -s option does not apply to the SPARCstorage
                 Array  controller  as it always writes the down-
                 loaded firmware into the FEPROM.

                 The -s option does not apply to the Sun Fire 880
                 internal  storage  subsystem as it always stores
                 downloaded firmware in the flash memory.

                 When using the -s option, the  download  subcom-
                 mand  modifies  the  FEPROM on the subsystem and
                 should be used with caution.

           -w WWN
                 Change the SPARCstorage Array controller's World
                 Wide Name. WWN is a 12-digit hex number; leading
                 zeros are required. The -w option  applies  only
                 to the SPARCstorage Array.  The new SPARCstorage
                 Array controller's image  will  have  the  least
                 significant  6  bytes  of  the 8-byte World Wide
                 Name modified to WWN.

     enclosure_name new_name enclosure | pathname
           Change the enclosure name of the enclosure  or  enclo-
           sures  specified by the enclosure or pathname. The new
           name (new_name) must be 16 or  less  characters.  Only
           alphabetic  or numeric characters are acceptable. This
           subcommand applies only to the SENA and the  Sun  Fire
           880 internal storage subsystem.

     failover primary | secondary pathname
           Select which Sun  Storage  T3  storage  array  partner
           group  controller  accesses a given logical volume. If
           primary is specified, the logical volume  is  accessed
           through the primary controller. If secondary is speci-
           fied, the  logical  volume  is  accessed  through  the
           secondary controller specified by pathname.

     fc_s_download [ -F ] [ -f fcode-file ]
           Download the fcode contained in  the  file  fcode-file
           into all the FC/S Sbus Cards. This command is interac-
           tive and expects user confirmation before  downloading
           the fcode.

           Use fc_s_download  only  in  single-user  mode.  Using
           fc_s_download  to update a host adapter while there is
           I/O activity  through  that  adapter  will  cause  the
           adapter  to  reset.   Newly  updated FCode will not be
           executed or visible until a system reboot.

           -f fcode-file
                 When invoked without the -f  fcode-file  option,
                 the  current  version  of the fcode in each FC/S
                 Sbus card is printed.

           -F    Forcibly downloads the fcode,  but  the  command
                 still expects user confirmation before the down-
                 load. The version of the FC/S Sbus  Cards  fcode
                 that  was  released  with  this  version  of the
                 Operating  System  is  kept  in  the   directory
                 usr/lib/firmware/fc_s and is named fc_s_fcode.

     fcal_s_download [ -f fcode-file ]
           Download the fcode contained in  the  file  fcode-file
           into  all  the  FC100/S  Sbus  Cards.  This command is
           interactive and expects user confirmation before down-
           loading the fcode.

           Use fcal_s_download only in  single-user  mode.  Using
           fcal_s_download  to  update a host adapter while there
           is I/O activity through that adapter  will  cause  the
           adapter  to  reset.   Newly  updated FCode will not be
           executed or visible until a system reboot.

           -f fcode-file
                 When invoked without the -f option, the  current
                 version  of  the fcode in each FC100/S Sbus card
                 is printed.

     fcode_download -p

     fcode_download -d dir-name
           Locate  the  installed  FC/S,  FC100/S,  FC100/P,   or
           FC100/2P host bus adapter cards and download the FCode
           files in dir-name to the appropriate cards.  The  com-
           mand  determines  the  correct  card  for each type of
           file,  and  is  interactive.  User   confirmation   is
           required before downloading the FCode to each device.

           Use fcode_download to load FCode only  in  single-user
           mode.  Using  fcode_download  to update a host adapter
           while there  is  I/O  activity  through  that  adapter
           causes  the adapter to reset. Newly updated FCode will
           not be executed or visible until a system reboot.

           -d dir-name
                 Download the FCode files contained in the direc-
                 tory dir-name to the appropriate adapter cards.

           -p    Prints the current version of  FCode  loaded  on
                 each card. No download is performed.

     inquiry enclosure[,dev ]... | pathname...
           Display the inquiry information for the selected  dev-
           ice specified by the enclosure or pathname.

     insert_device [ enclosure,dev... ]
           Assist the user in the hot insertion of a  new  device
           or  a chain of new devices. Refer to NOTES for limita-
           tions on hotplug operations. This  subcommand  applies
           only  to  the SENA, Sun Fire 880 internal storage sub-
           system, RSM, and individual  FC_AL  drives.  RSM,  and
           individual  FC_AL  drives.  For the SENA, if more than
           one  enclosure  has  been  specified,  concurrent  hot
           insertions  on  multiple busses can be performed. With
           no arguments to the subcommand, entire  enclosures  or
           individual  FC_AL drives can be inserted. For the RSM,
           only one controller can be specified. For the SENA  or
           the  Sun  Fire  880 internal storage   subsystem, this
           subcommand guides the this subcommand guides the  user
           interactively through the hot insertion steps of a new
           device or chain of devices. If a  list  of  disks  was
           entered  it  will  ask  the user to verify the list of
           devices to be inserted is correct, at which point  the
           user  can continue or quit. It then interactively asks
           the user to insert the  disk(s)  or  enclosure(s)  and
           then  creates  and  displays the logical pathnames for
           the devices.

           For the RSM, the following steps are taken:

                   o  Quiesce the  bus  or  buses  which  support
                      quiescing and unquiescing.

                   o  Inform the user  that  the  device  can  be
                      safely inserted .

                   o  Request confirmation from the user that the
                      device has been inserted.

                   o  Unquiesce the bus or  buses  which  support
                      quiescing and unquiescing.

                   o  Create the logical device name for the  new
                      device.

     led enclosure,dev...| pathname...
           Display the current state of the LED  associated  with
           the  disk specified by the enclosure or pathname. This
           subcommand only applies  to  subsystems  that  support
           this functionality.

     led_blink enclosure,dev...| pathname...
           Requests the subsystem to start blinking the LED asso-
           ciated  with  the  disk  specified by the enclosure or
           pathname. This subcommand only applies  to  subsystems
           that support this functionality.

     led_off enclosure,dev...| pathname...
           Requests the subsystem to disable (turn off)  the  LED
           associated with the disk specified by the enclosure or
           pathname. On a SENA subsystem, this  may  or  may  not
           cause  the  LED to turn off or stop blinking depending
           on the state of the SENA subsystem.  Refer to the SENA
           Array  Installation and Service Manual (p/n 802-7573).
           This subcommand only applies to subsystems  that  sup-
           port this functionality.

     led_on pathname...
           Requests the subsystem to enable  (turn  on)  the  LED
           associated  with  the  disk specified by the pathname.
           This subcommand only applies to subsystems  that  sup-
           port this functionality.

     power_off [ -F ] enclosure[,dev]... | pathname ...


number

     power_off pathname [ enclosure-
           port  ]  ...  |  controller  tray-
           When a SENA is addressed, this subcommand  causes  the
           SENA  subsystem  to  go  into the power-save mode. The
           SENA drives are not available when in  the  power-save
           mode.  When  an  Enclosure  Services  card  within the
           SPARCstorage Array  is  addressed,  the  RSM  tray  is
           powered  down. When a drive in a SENA is addressed the
           drive is set to the drive off/unmated  state.  In  the
           drive  off/unmated  state,  the  drive  is  spun  down
           (stopped) and in bypass mode. This  command  does  not
           apply to the Sun Fire 880 internal storage subsystem.

           -F    The force  option  only  applies  to  the  SENA.
                 Instructs  luxadm to attempt to power off one or
                 more devices even if  those  devices  are  being
                 used by this host (and are, therefore, busy).

                 Warning: Powering off a device  which  has  data
                 that   is   currently   being  used  will  cause
                 unpredictable results. Users should  attempt  to
                 power  off  the  device  normally  (without  -F)
                 first, only resorting to this option  when  sure
                 of the consequences of overriding normal checks.

     power_on enclosure[,dev]..
           Causes the SENA subsystem to go out of the  power-save
           mode,  when  this  subcommand  is addressed to a SENA.
           There  is  no  programmatic  way  to  power   on   the
           SPARCstorage  Array  RSM tray. When this subcommand is
           addressed to a drive the drive is set  to  its  normal
           start-up state. This command does not apply to the Sun
           Fire 880 internal storage subsystem.

     probe [ -p ]
           Finds and displays information about all attached SENA
           subsystems,  Sun Fire 880 internal storage subsystems,
           and individual FC_AL devices,  including  the  logical
           pathname,  the WWNs, and enclosure names. This subcom-
           mand warns the user if it finds different  SENAs  with
           the same enclosure names.

           -p    Includes the physical pathname in the display.

     qlgc_s_download [ -f fcode-file ]
           Download the FCode contained in  the  file  fcode-file
           into all the FC100/P, FC100/2P PCI host adapter cards.
           This command is interactive and expects user confirma-
           tion before downloading the FCode to each device. Only
           use  qlgc_s_download  in  single-user    mode.   Using
           qlgc_s_download  to  update a host adapter while there
           is I/O activity through that adapter  will  cause  the
           adapter to reset. Newly updated FCode will not be exe-
           cuted or visible until a system reboot.

           -f fcode-file
                 When invoked without the -f option, the  current
                 version  of  the FCode in each FC100/P, FC100/2P
                 PCI card is printed.

     release pathname
           Release a reservation held on the specified disk.  The
           pathname  should  be  the physical or logical pathname
           for the disk. If the pathname is of  the  SPARCstorage
           Array  controller,  then  all  of  the  disks  in  the
           SPARCstorage Array will be released.

           This subcommand is included for historical  and  diag-
           nostic purposes only.

     remove_device [ -F ] enclosure[,dev]...| pathname...
           Assists the user in hot removing a device or  a  chain
           of devices. This subcommand can also be used to remove
           entire enclosures.  This  subcommand  applies  to  the
           SENA,  Sun  Fire  880 internal storage subsystem, RSM,
           and individual FC_AL drives. Refer to NOTES for  limi-
           tations  on hotplug operations. For the SENA, Sun Fire
           880 internal storage subsystem, and  individual  FC_AL
           devices,  this  subcommand guides the user through the
           hot removal of a device or devices.  During  execution
           it  will ask the user to verify the list of devices to
           be removed is correct, at which  point  the  user  can
           continue  or  quit.  It  then  prepares the disk(s) or
           enclosure(s) for removal and  interactively  asks  the
           user to remove the disk(s) or enclosure(s).

           For the RSM, the steps taken are:

              o  Take the device offline.

              o  Quiesce the bus or buses which support quiescing
                 and unquiescing.

              o  Inform  user  that  the  device  can  be  safely
                 removed.

              o  Request confirmation from the user that the dev-
                 ice has been removed.

              o  Unquiesce the bus or buses which support quiesc-
                 ing and unquiescing.

              o  Bring the (now removed) device back online.

              o  Remove the logical device name for  the  removed
                 device.

      For Multi-Hosted disk,  the  steps  taken  are:

              o  Issue the luxadm remove_device  command  on  the
                 first host. When prompted to continue, wait.

              o  Issue the luxadm remove_device  command  on  the
                 secondary   hosts.  When  prompted  to continue,
                 wait.

              o  Continue with the remove_device command  on  the
                 first  host.  Remove the device when prompted to
                 do so.

              o  Complete the luxadm remove_device command on the
                 additional hosts.

           -F    Instructs luxadm to attempt to hot plug  one  or
                 more  devices  even  if  those devices are being
                 used by this host (and are, therefore,  busy  or
                 reserved), to force the hotplugging operation.

                 Warning: Removal of a device which has data that
                 is currently being used will cause unpredictable
                 results. Users should attempt  to  hotplug  nor-
                 mally (without -F) first, only resorting to this
                 option when sure of the consequences of overrid-
                 ing normal hotplugging checks.

     replace_device [ -F ] pathname
           This subcommand applies only  to  the  RSM.  Refer  to
           NOTES for limitations on hotplug operations. This sub-
           command guides the user interactively through the  hot
           replacement of a device.

           For the RSM, the steps taken are:

              o  Take the device offline.

              o  Quiesce the bus or buses which support quiescing
                 and unquiescing.

              o  Inform  user  that  the  device  can  be  safely
                 replaced.

              o  Request confirmation from the user that the dev-
                 ice has been replaced.

              o  Unquiesce the bus or buses which support quiesc-
                 ing and unquiescing.

              o  Bring the device back online.

           -F    Instructs luxadm to attempt to hot plug  one  or
                 more  devices  even if those devices are busy or
                 reserved, (that is,  to  force  the  hotplugging
                 operation).
                 Warning: Removal of a device which has data that
                 is currently being used will cause unpredictable
                 results. Users should attempt  to  hotplug  nor-
                 mally (without -F) first, only resorting to this
                 option when sure of the consequences of overrid-
                 ing normal hotplugging checks.

     reserve pathname
           Reserve the specified disk for exclusive  use  by  the
           issuing host. The pathname used should be the physical
           or logical pathname for the disk. If the  pathname  is
           of  the SPARCstorage Array controller, then all of the
           disks in the SPARCstorage Array will be reserved.

           This subcommand is included for historical  and  diag-
           nostic purposes only.

     set_boot_dev [ -y ] pathname
           Set the boot-device variable in the system PROM to the
           physical  device name specified by pathname, which can
           be a block special  device  or  the  pathname  of  the
           directory  on  which  the boot file system is mounted.
           The command  normally  runs  interactively  requesting
           confirmation  for  setting  the default boot-device in
           the PROM. The -y option can be used  to  run  it  non-
           interactively,   in  which  case  no  confirmation  is
           requested or required.

     start [ -t tray-number ] pathname...
           Spin up the specified disk(s). If  pathname  specifies
           the SPARCstorage Array controller, this action applies
           to all disks in the SPARCstorage Array.

           -t    Spin up all  disks  in  the  tray  specified  by
                 tray-number.    pathname    must   specify   the
                 SPARCstorage Array controller.

     stop [ -t tray-number ] pathname...
           Spin down the specified disk(s). If pathname specifies
           the SPARCstorage Array controller, this action applies
           to all disks in the SPARCstorage Array.

           -t    Spin down all disks in  the  tray  specified  by
                 tray-number.    pathname    must   specify   the
                 SPARCstorage Array controller.

  SPARCstorage Array Subcommands
     fast_write [  -s ]  -c pathname

     fast_write [  -s ] -d pathname

     fast_write [  -s ]  -e pathname
           Enable or disable the use of the  NVRAM to enhance the
           performance of writes in the SPARCstorage Array. path-
           name refers to the SPARCstorage Array controller or to
           an individual disk.

           -s    Cause the SPARCstorage Array to save the  change
                 so it will persist across power-cycles.

           -c    Enable fast writes for synchronous writes only.

           -d    Disable fast writes.

           -e    Enable fast writes.

     nvram_data pathname
           Display the amount of fast write data in the NVRAM for
           the  specified disk. This command can only be used for
           an individual disk.

     perf_statistics -d pathname

     perf_statistics -e pathname
           Enable or  disable  the  accumulation  of  performance
           statistics  for  the specified SPARCstorage Array con-
           troller. The accumulation  of  performance  statistics
           must  be  enabled  before using the display -p subcom-
           mand. This  subcommand  can  be  issued  only  to  the
           SPARCstorage Array controller.

           -d    Disable the accumulation of performance  statis-
                 tics.

           -e    Enable the accumulation of  performance  statis-
                 tics.

     purge pathname
           Purge any fast write data from NVRAM for one disk,  or
           all  disks if the controller is specified. This option
           should be used with caution, usually only when a drive
           has failed.

     sync_cache pathname
           Flush all outstanding writes for  the  specified  disk
           from  NVRAM  to  the  media. If pathname specifies the
           controller, this action applies to all  disks  in  the
           SPARCstorage Array subsystem.

  Enclosure Services Card Subcommands
     The env_display and alarm*  subcommands  apply  only  to  an
     Enclosure   Services   Card   (SES)  in  a  RSM  tray  in  a
     SPARCstorage Array. The RSM tray is addressed by  using  the
     logical  or physical path of the SES device or by specifying
     the controller followed by the tray number.  The  controller
     is  addressed  by  cN or the physical path to the SSA's con-
     troller.

     alarm pathname | controller tray_number
           Display the current state of audible alarm.

     alarm_off pathname | controller tray_number
           Disable the audible alarm for this RSM tray.

     alarm_on pathname | controller tray_number
           Enable the audible alarm for this RSM tray.


]

     alarm_set controller-
           pathname | controller tray_number [  seconds
           Set the audible alarm setting to seconds.

     env_display pathname |  controller tray_number
           Display the environmental information for  the  speci-
           fied unit.

  SENA, Sun Fire 880 Internal Storage Subsystem,  and  Individual
     FC_AL Drive Expert Mode Subcommands
     The following subcommands are for expert use only,  and  are
     applicable  only  to the SENA, Sun Fire 880 internal storage
     subsystem, and fiber channel loops. They should only be used
     by users that are knowledgeable about the SENA subsystem and
     fiber channel loops.

     If you specify a disk to an expert subcommand that  operates
     on  a  bus,  the subcommand operates on the bus to which the
     specified disk is attached.

     -e bypass [-ab] enclosure,dev

     -e bypass -f enclosure
           Request the enclosure services controller to  set  the
           LRC  (Loop  Redundancy  Circuit) to the bypassed state
           for the port and device specified.

           This subcommand supports the following options:

           -a    Bypass port a of the device specified.

           -b    Bypass port b of the device specified.

     -e dump_map fibre_channel_HBA_port
           Display WWN data for  a  target  device  or  host  bus
           adapter  on the specified fibre channel port. If there
           are no target devices on the specified port, an  error
           is   returned.

     -e enable [-ab] enclosure,dev

     -e enable -f enclosure
           Request the enclosure services controller to  set  the
           LRC (Loop Redundancy Circuit) to the enabled state for
           the port and device specified.

           This subcommand supports the following options:

           -a    Enable port a of the device specified.

           -b    Enable port b of the device specified.

     -e forcelip enclosure[,dev] ... |  pathname...
           Force the link to reinitialize, using  the  Loop  Ini-
           tialization Primitive (LIP) sequence. The enclosure or
           pathname can specify any device on the loop.  Use  the
           pathname  to specify a specific path for multiple loop
           configurations.

           This is an expert only command and should be used with
           caution. It will reset all ports on the loop.

     -e rdls enclosure[,dev] ... |  pathname...
           Read and display the link error status information for
           all  available  devices  on the loop that contains the
           device specified by the enclosure or pathname.

  Other Expert Mode Subcommands
     See  NOTES for limitations of these subcommands. They should
     only  be used by users that are knowledgeable about the sys-
     tems they are managing.

         These commands do not apply to the Sun Fire 880 internal
     storage subsystem.

     -e bus_getstate pathname
           Get and display the state of the specified bus.

     -e bus_quiesce pathname
           Quiesce the specified bus.

     -e bus_reset pathname
           Reset the specified bus only.

     -e bus_resetall pathname
           Reset the specified bus and all devices.

     -e bus_unquiesce pathname
           Unquiesce the specified bus. the specified device.

     -e dev_getstate pathname
           Get and display the state of the specified device.

     -e dev_reset pathname
           Reset the specified device.

     -e offline pathname
           Take the specified device offline.

     -e online pathname
           Put the specified device online.


EXAMPLES

     Example 1: Displaying the SENAs and Individual FC_AL Devices
     on a System

     The following example finds and displays all  of  the  SENAs
     and individual FC_AL devices on a system:

     example% luxadm probe

     Example 2: Displaying an SSA

     The following example displays an SSA:

     example% luxadm display c1

     Example 3: Displaying  a  SENA  or  Sun  Fire  880  Internal
     Storage Subsystem

     The following example displays a SENA or Sun Fire 880 inter-
     nal storage subsystem:

     example% luxadm display /dev/es/ses0

     Example 4: Displaying Two Subsystems

     The following example  displays  two  subsystems  using  the
     enclosure names:

     example% luxadm display BOB system1

     Example 5: Displaying Information about the First Disk

     The following example displays  information about the  first
     disk  in  the  front  of  the enclosure named BOB. Use  f to
     specify the front disks. Use  r to specify the rear disks.

     example% luxadm display BOB,f0

     Example 6: Displaying Information on a Sun Fire 880 Internal
     Storage Subsystem

     The Sun Fire 880 internal storage subsystem has only one set
     of disks. In this case, use s to specify the slot:

     example% luxadm display BOB,s0

     Example 7: Displaying Information  about  a  SENA  disk,  an
     Enclosure, or an Individual FC_AL Drive

     The following example  displays  information  about  a  SENA
     disk,  an  enclosure,  or an individual FC_AL drive with the
     port WWN of 2200002037001246:

     example% luxadm display 2200002037001246

     Example 8: Using Unique Characters to Issue a Subcommand

     The following example uses only as many  characters  as  are
     required to uniquely identify a subcommand:

     example% luxadm disp BOB

     Example 9: Displaying Error Information

     The following example displays  error information about  the
     loop that the enclosure BOB is on:

     example% luxadm display -r BOB

     Example 10: Downloading  New  Firmware  into  the  Interface
     Board

     The following example downloads new firmware into the Inter-
     face  Board  in  the  enclosure named BOB (using the default
     path for the file to download):

     example% luxadm download -s BOB

     Example 11: Displaying Information from   the  SCSI  Inquiry
     Command

     The following example displays  information  from  the  SCSI
     inquiry  command  from  all  individual disks on the system,
     using only as many characters as necessary to uniquely iden-
     tify the inquiry subcommand:

     example% luxadm inq /dev/rdsk/c?t?d?s2

     Example 12: Hotplugging

     The following example hotplugs a new drive  into  the  first
     slot in the front of the enclosure named BOB:

     example% luxadm insert_device BOB,f0

     The following example hotplugs a new drive  into  the  first
     slot  in  the  Sun Fire 880 internal storage subsystem named
     SF880-1:

     example% luxadm insert_device SF880-1,s0

     Example 13: Running an Expert Subcommand

     The following example runs an expert subcommand.   The  sub-
     command  forces  a  loop initialization on the loop that the
     enclosure BOB is on:

     example% luxadm -e forcelip BOB

     Example 14: Using the Expert Mode Hot Plugging Subcommands

     An example of using the expert mode hot plugging subcommands
     to  hot  remove  a disk on a  SSA follows. See NOTES for hot
     plugging limitations.

     The first step reserves the SCSI device so that it can't  be
     accessed by way of its second SCSI bus:

     example# luxadm reserve /dev/rdsk/c1t8d0s2

     Example 15: Taking the Disk to be Removed Offline

     The next two steps take the disk to be removed offline  then
     quiesce the bus:

     example# luxadm -e offline /dev/rdsk/c1t8d0s2
     example# luxadm -e bus_quiesce /dev/rdsk/c1t8d0s2

     Example 16: Unquiescing the Bus

     The user then removes the disk and continues by  unquiescing
     the bus, putting the disk back online, then unreserving it:

     example# luxadm -e bus_unquiesce /dev/rdsk/c1t8d0s2
     example# luxadm -e online /dev/rdsk/c1t8d0s2
     example# luxadm release /dev/rdsk/c1t8d0s2


ENVIRONMENT VARIABLES

     See environ(5) for a description of  the   LANG  environment
     variable that affects the execution of luxadm.


EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     -1    An error occurred.


FILES

     usr/lib/firmware/fc_s/fc_s_fcode

     usr/lib/firmware/ssa/ssafirmware

     usr/lib/locale/C/LC_MESSAGES/ibfirmware


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

  usr/sbin
     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWluxop                   |
    |_____________________________|_____________________________|


SEE ALSO

     devlinks(1M),    disks(1M),    ssaadm(1M),    attributes(5),
     environ(5), ses( 7D)

     SENA Array Installation and Service Manual (p/n 802-7573).

     RAID Manager 6.1 Installation and Support Guide Answerbook

      RAID Manager 6.1 User's Guide Answerbook


NOTES

     See the SENA Array Installation and Service Manual for addi-
     tional  information  on the SENA. Refer to Tutorial for SCSI
     use of IEEE Company_ID, R. Snively, for additional  informa-
     tion  regarding  the   IEEE  extended  WWN.  See  SEE  ALSO.
     Currently, only some device drivers support hot plugging. If
     hot  plugging  is attempted on a disk or bus where it is not
     supported, an error message of the form:

     luxadm: can't acquire "PATHNAME": No such file or directory

     will be displayed.

     You must be careful not to quiesce a bus that  contains  the
     root  or  the   /usr filesystems or any swap data. If you do
     quiesce such a bus a deadlock can result, requiring a system
     reboot.


Man(1) output converted with man2html