| Platform Notes: Using luxadm Software |
|
| Platform Notes: Using luxadm Software |
|
| C H A P T E R 1 |
luxadm Command Basics |
The luxadm command is an administrative command for managing the Sun Enterprise Network Array (SENA) specifically the Sun StorEdge A5x00 disk array, the SPARCstorage Array (SSA), and the Sun Fire 880 internal disk arrays. The luxadm command performs a variety of control and query tasks, depending on the command-line arguments and options used.
This chapter describes the command syntax for luxadm and explains how to specify or address an individual disk or disk array.
Topics covered in this chapter include:
The command line for luxadm must contain a subcommand. You can enter options, usually at least one enclosure name or path name, and other parameters depending on the subcommand. The basic syntax is as follows:
When specifying a subcommand, you need to enter only as many characters as are required to uniquely identify the subcommand. For example, to run the display subcommand on an enclosure named box1 , you could enter:
You specify the device with which a subcommand interacts by entering a path name. The path name is the logical or physical path of a Sun StorEdge A5x00 SENA Interface Board (IB), Sun Fire 880 enclosure services device (SES), SPARCstorage Array or RSM controller, or individual Fibre Channel-Arbitrated Loop (FC-AL) device. A path name can also be the World Wide Name (WWN) of the Sun StorEdge A5x00 IB, an individual FC-AL disk, or the Sun Fire 880 SES.
For a Sun StorEdge A5x00 SENA subsystem IB or individual disk, or a Sun Fire 880 SES or individual disk, you can also specify a device by enclosure name and an optional identifier for a particular disk in the enclosure. See About Addressing a Disk or Disk Array for more information.
This section explains how to specify, or address, a disk or disk array.
There are several ways to specify an individual disk or an array to luxadm . You can specify the path name, the World Wide Name (WWN), or the enclosure name.
The path name is the complete physical path name or logical path name to a device or array. A logical link to the physical path to a Sun StorEdge A5x00 array (and all SENA IBs on the system) is kept in the directory /dev/es .
The WWN is a unique 16-digit hexadecimal value that is programmed into each device during manufacturing. You can use the WWN in place of a path name to select an individual FC-AL disk or an array.
You can specify a device by its enclosure name and slot number, as follows:
You can specify an individual disk in a Sun StorEdge A5x00 disk array in any of the following ways:
Using the disk's complete physical path name. A typical physical path name for a Sun StorEdge A5x00 disk is:
Using the disk's complete logical path name. A typical logical path name for a Sun StorEdge A5x00 disk is:
Using the disk's unique WWN. A typical WWN for a Sun StorEdge A5x00 disk is:
Using the Sun StorEdge A5x00 enclosure name ( box_name ,[ f|r slot_number ]) followed by a disk slot identifier. A typical example for a Sun StorEdge A5x00 is:
|
Note Note - When addressing an entire array, the path names, WWN, and enclosure name (box_name) specify the Sun StorEdge A5x00 IB. |
You can address an entire Sun StorEdge A5x00 disk array in any of the following ways:
Using the complete physical path name of a Sun StorEdge A5x00 IB. A typical physical path name of an IB is:
Using the complete logical path name of a Sun StorEdge A5x00 IB. A typical logical path name for a Sun StorEdge A5x00 IB is:
Using the unique WWN for the Sun StorEdge A5x00 IB. A typical WWN for a Sun StorEdge A5x00 IB is:
Using only the enclosure name ( box_name ) for the Sun StorEdge A5x00 IB. A typical enclosure name for a Sun StorEdge A5x00 IB is:
There are several ways to specify an individual disk or an array to luxadm . You can specify a path name, the World Wide Name (WWN), or the enclosure name. You can determine these values for an array or an individual disk by using the luxadm probe , enclosure_name, and display commands.
A path name is either the complete physical or logical path name of an individual internal disk or the complete physical or logical path name to an array's SES controller. To determine a logical path name, use the probe subcommand. To determine a physical path name, use the probe -p subcommand. Logical links to the physical paths for Sun Fire 880 devices are kept in /dev/rdsk and /dev/dsk .
The WWN for an array is a unique 16-digit hexadecimal value that is programmed into the firmware on the FC-AL backplane during manufacturing. Each array has its own unique WWN. When two backplanes are joined as a single array, only the WWN for the base backplane is used.
The WWN for an individual FC-AL disk is a unique 16-digit hexadecimal value that specifies either the port used to access a device or the device itself. Both ports on a disk share a single WWN. The WWN for each disk is programmed into the firmware of each device during manufacturing.
Use the probe command to determine the WWN of the SES. Use the display command to determine the WWN of each FC-AL disk in the enclosure.
You can specify a device by its enclosure name and slot number, as follows:
|
The name you assign to the SES using the luxadm enclosure_name subcommand. See Renaming a Sun StorEdge A5x00 Disk Array or Sun Fire 880 Internal Storage Array (enclosure_name) for more information. |
|
|
The slot number of the device in the Sun Fire 880 enclosure. Each slot is numbered 0 to 11 on the Sun Fire 880 enclosure. |
You can specify an individual internal disk in a Sun Fire 880 enclosure in any of the following ways:
Using the disk's complete physical path name. A typical physical path name for a Sun Fire 880 internal disk is:
Using the disk's complete logical path name. A typical logical path name for a Sun Fire 880 internal disk is:
Using the disk's unique WWN. A typical WWN for a Sun Fire 880 internal disk is:
Using the enclosure name followed by ,s followed by a disk slot number ( box_name,sslot_number ), for example:
|
Note Note - When addressing an entire array, the path names, WWN, and enclosure name (box_name) specify the SES. |
You can address an entire Sun Fire 880 disk array in any of the following ways:
Using the complete physical path name to the array's SES controller. A typical physical path name is:
Using the complete logical path name to the array's SES controller. A typical logical path name is:
Using the unique WWN for the FC-AL backplane. A typical WWN is:
Using only the enclosure name ( box_name ) for a Sun Fire 880 internal array, for example:
When addressing the SPARCstorage Array, the path name specifies the SPARCstorage Array controller or a disk in the SPARCstorage Array. The controller name is specified by its physical name. For example:
You can also specify the controller name by a name of the form cN , where N is the logical controller number. The luxadm command uses the cN name to find an entry in the /dev/rdsk directory of a disk that is attached to the SPARCstorage Array controller. The /dev/rdsk entry is then used to determine the physical name of the SPARCstorage Array controller.
A disk in the SPARCstorage Array is specified by its logical or physical device name. For example:
See the disks(1M) and devlinks(1M) man pages for more information on logical names for disks and subsystems.
When addressing the SPARCstorage RSM tray, the path name specifies the controller or a disk in the SPARCstorage RSM tray. The controller name is specified by its physical name. For example:
You can also specify the controller name by a name of the form cN , where N is the logical controller number. The luxadm command uses the cN name to find an entry in the /dev/rdsk directory of a disk that is attached to the SPARCstorage Array controller. The /dev/rdsk entry is then used to determine the physical name of the controller.
A disk in the SPARCstorage RSM tray is specified by its logical or physical device name. For example:
See the disks(1M) and devlinks(1M) man pages for mdore information on logical names for disks and subsystems.
| Platform Notes: Using luxadm Software | 816-5074-10 |
|
Copyright © 2002, Sun Microsystems, Inc. All rights reserved.