% Librarian A09-30.r.r%&5FADD TDELETEbEXITOverviewDSETSHOW r 1 OverviewE The SAS utility (SAS$UTIL) is supported on Integrity servers only.B SAS is an OpenVMS system management and diagnostic tool that is@ capable of configuring Integrated RAID (IR) functionality forD the HP 8 Internal Port Serial Attached SCSI Host Bus Adapter (SAS Controller).@ Integrated RAID (IR) is used where extra performance, storageA capacity, or redundancy of a RAID configuration, or all three,D are required. OpenVMS Version 8.3 sup ports only Integrated RAID 1C or Integrated Mirroring (IM) and its associated Global Hot Spare capability. wwr1 ADD 2 UNIT- Creates a new Integrated RAID (IR) volume.? An IR volume ID is created whenever an IR volume is created. Format) ADD UNIT /DISK=sas_id (,...) /RAID=1 3 Qualifiers /CACHE /CACHE /NOCACHE (default)@ Enables or disables write caching to the physical disk. Write9 caching to  the physical disk is set to off by default. /DISK /DISK=sas_id(,...)C This qualifier is required. Specifies the SAS ID of the physical? disk to be added to the IR volume set. (The SAS ID is the IDD shown when you enter the SAS command SHOW DISK.) Enclose multiple SAS IDs in parentheses.D The effective size of the RAID volume is automatically determined? and set to the maximum size available. The firmware supports@ disks of varying sizes; however, the exce ss space of a larger@ disk or disks is unusable. Volume expansion is not supported;: once a volume is created, its size cannot be increased.A A physical disk must be dismounted in OpenVMS before it can be added to the IR volume set. /RAID /RAID=(0 | 1 | 10)A This qualifier is required. Specifies the RAID level of the IR volume set.! RAID levels are the following: RAID Level Description% RAID 0 Integrated Striping& RAID 1  Integrated Mirroring/ RAID 10 Integrated Mirroring Enhanced& NOTEA OpenVMS Version 8.3 supports RAID 1 (Integrated Mirroring). /SPARE /SPARE=sas_id? Specifies the SAS ID of the physical disk to be added as the Global Hot Spare disk.@ This qualifier is required when specifying a Global Hot Spare# disk for a RAID 1 configuration.B You can configure one Global Hot Spare disk per controller. TheB spa re drive can be shared between two RAID 1 IR volume sets perA controller. The size of the disk specified as /SPARE should beD greater than or equal to the size of at least one of the physical disks on the IR volume. /SYNCH /SYNCH /NOSYNCH (default)B This qualifier applies only to RAID 1 IR volumes. Specifies the@ use of high-priority or low-priority resynchronization. High-7 priority resynchronization is set to OFF by default. /UNSAFEB Overrid es the restriction that limits OpenVMS support to RAID 1 only. wwr 1 DELETE 2 DISKD Deletes a Global Hot Spare disk that is part of an IR volume set. Format DELETE DISK /SPARE 3 Qualifiers /SPAREC This qualifier is required. Deletes the Global Hot Spare disk in the IR volume set. 3 Example SAS> DELETE DISK /SPARE" Global Hot Spare disk deleted.D This example shows the deletion of the Glob!al Hot Spare disk in the IR volume set. 2 UNIT7 Deletes the IR volume specified by the IR volume ID. Format DELETE UNIT volume_id 3 Parameters volume_idD The IR volume ID number to be deleted. (To display IR volume IDs,0 enter the SAS command SHOW DISK or SHOW UNIT.? The IR volume must be dismounted in OpenVMS before it can be deleted. 3 Qualifiers /CONFIRM /CONFIRM (default) /NOCONFIRM? Controls whether a question about confirming the DELETE UNIT command is displayed. 3 Example SAS> DELETE UNIT 4@ WARNING: Proceeding with this operation may cause data loss.2 Would you like to continue (Yes/No) [NO]? Yes IR Volume ID 4 deleted.7 This example shows the deletion of IR Volume ID 4. ww.r1 EXIT; Exits the SAS utility and returns to the DCL prompt ($). Format EXIT 2 Example SAS> EXIT $( This command exits the SAS utility. ww.r1 SET 2 CONTROLLER? Selects the default controller specified by the device name.D This command is required before entering all SAS utility commands+ except SHOW CONTROLLER and SHOW VERSION. Format SET CONTROLLER device_name 3 Parameters device_name' The device name has the format ddcu, where: dd is the device code.6 c is the controller designation A through Z.0 u is the unit number (0 through 9999).B To display device names, enter the SAS command SHOW CONTROLLER. 3 Example SAS> SET CONTROLLER PKA06 Selected Controller _PKA0: is a LSISAS10XX device. SAS>B In this example, controller _PKA0: is selected as the default controller. 2 DISKC Modifies physical disk properties such as turning the Locate LEDC on or off and specifying the unique device ID (UDID) to external SAS and SATA devices. Format SET DISK sas_id 3 Parameters sas_idB Specifies the SAS ID of the target SAS disk to be modified. (To5 display SAS IDs, enter the SAS command SHOW DISK.) 3 Qualifiers /IDENT /IDENT=udidC Specifies the unique device ID (UDID), which is used as the unitB number in the device name for an external SAS or SATA disk. TheB device name is in the form $3$dgaxyz, where xyz is the UUID for external SAS and SATA disks./ The UDID can be a number between 1 and 9999.. See the /REMOVE qualifier to remove a UDID. /LED /LED=OFF /LED=ONA Sets the Locate LED, which can be used to find the SAS or SATA disk. /REMOVEA Remove the unique device ID (UUID) for an external SAS or SATA disk. 3 Example SAS> SET DISK 1 /LED=ON; In this example, the SAS ID 1 Locate LED is turned on. 2 UNIT& Modifies IR volume ch!aracteristics. Format SET UNIT volume_id 3 Parameters volume_id> Specifies the IR volume ID of the IR volume to be modified.A (To display all IR volume IDs in the SAS Controller, enter the/ SAS command SHOW DISK or SHOW UNIT command.) 3 Qualifiers /ACTIVE% Activates the specified IR volume. /CACHE /CACHE /NOCACHE (default)? Specifies write caching to a physical disk. Write caching is turned off by d"efault. /DISABLE= Temporarily disables all IR volumes on the SAS Controller. /ENABLE= Enables all IR volumes previously disabled by the /DISABLE qualifier. /INACTIVE' Deactivates the specified IR volume. /LED /LED=OFF /LED=ONA Sets the Locate LED for all physical disks on the IR volume to off or on. /SPARE /SPARE=sas_id@ Specifies the disk SAS ID to be added as the Global Hot Spare? disk. (The SAS ID is the ID displayed when you enter the SAS command SHOW DISK.)? This qualifier is required only when specifying a Global Hot) Spare disk for a RAID 1 configuration.B You can configure one Global Hot Spare disk per controller. TheB spare drive can be shared between two RAID 1 IR volume sets perA controller. The size of the disk specified as /SPARE should beD equal to or greater than the size of at least one of the physical disks on the IR volume. /SYNCH  /SYNCH /NOSYNCH (default)5 Specifies the use of high-priority or low-priority? resynchronization. High-priority resynchronization is off by default. ww.r1 SHOW 2 CONTROLLER1 Displays information about the SAS Controller. Format# SHOW CONTROLLER [device_name] 3 Parameters device_name: (OPTIONAL)D The device name is an SAS device name used to display informationD about a specific controller. The device name has the format ddcu, where: dd is the device code.6 c is the controller designation A through Z.0 u is the unit number (0 through 9999).; If you do not specify a device name, all controllers are displayed. 3 Qualifiers /DEFAULT5 Displays information about the default controller. /FULL< Displays additional information about the SAS Controller. 3 Example SAS> SHOW CONTROLLERI A default controller is not set. All matching controllers displayed. Adapter: _PKA0:& Controller Type : SAS LSISAS1068 Firmware version : 1.10.0.0) SAS WWID : 500605B0-00001A20= RAID Capabilities RAID 0 (Integrated Striping) supported.I RAID 0+1 (Integrated Mirroring Enhanced) supported.> RAID 1 (Integrated Mirroring) supported. Active IR Volumes : 1 of 2 Active PHYS disk : 3 of 10 Cache: Not Available. Battery: Not Available.3 This example shows SAS Controller information. 2 DISKA Displays a table of available SAS, SATA, and IR volumes in the SAS Controller.4 Each column in the table is displayed as follows: Volume Description* ID SAS ID for SAS/SATA device.2 RAID volume ID for RAID volume set. Enc Enclosure number:7 o Direct attached is displayed as "DA."@ o Non-direct attached shows the enclosure handle number.3 PHY SAS PHY number of the physical disk.D Slt Physical slot or element index in the enclosure where7 the target device is physically located.# Device OpenVMS device name. Type Device type. Size Disk size in MB.A SAS SAS address (World Wide Identifier) of the device. Address) Product Product model of the disk. Name Format SHOW DISK [sas&_id] 3 Parameters sas_idA The SAS ID is the ID shown when you enter the SAS command SHOW DISK.= If you do not enter a SAS ID, the SAS utility displays all available physical SAS disks. 3 Qualifiers /FULL/ Displays additional information about disks. 2 ENCLOSURED Displays information about the SAS enclosure connected to the SAS Controller. Format SHOW ENCLOSURE [encl_id] 3 Parameters encl_id7  Displays information about a specific SAS enclosure.A If the enclosure ID is not specified, the SAS utility displays: information about all available enclosures that the SAS Controller finds. 3 Qualifiers /FULL8 Displays additional information about SAS enclosures. 3 Example SAS> SHOW ENCLOSURE Enclosure 1, Encl WWID : 500605B0-00001A20 Num slots : 8 Start slot : 18 Encl Flags SEP BUS/Target ID is not valid.: Start BUS/Target ID is not valid.5 IOC (direct attached) SGPIO.> This example shows information about internal Enclosure 1% connected to the SAS Controller. 2 EXPANDERC Displays information about the SAS expander connected to the SAS Controller. Format SHOW EXPANDER [exp_id] 3 Parameters exp_id6 Displays information about a specific SAS expander.C If an exp ander ID is not specified, the SAS utility displays all9 available SAS expanders that the SAS Controller finds. 3 Qualifiers /FULLA Displays additional information about the expanders in the SAS domain. 3 Example SAS> SHOW EXPANDER Expander 1 Physical Port : 0, SAS WWID : 500508B3-00A1396F Dev Handle : 9 Num PHYs : 13 SAS Level : 1= Exp Flags Device has config!urable route table.1 Prog Link Rate Max 3.0Gbps Min 1.5Gbps1 HW Link Rate Max 3.0Gbps Min 1.5Gbps5 PHY Info Table Routing 3.0Gbps speed0 Att Dev Info SMP Target LSI DeviceB This example shows information about external SAS Expander 1,. which is connected to the SAS Controller. 2 PHY> Displays SAS PHY information for all connections in the SAS Controller. Format SHOW PHY [phy_id] 3 Parameters" phy_id@ Display information about a specific SAS PHY ID. (Use the SAS- command SHOW DISK to display SAS PHY IDs.)C If a PHY ID is not specified, the utility displays all available PHYs on the SAS Controller. 3 Qualifiers /ERROR# Displays SAS PHY error counters. /FULL2 Displays additional information about the PHYs. 3 Example SAS> SHOW PHY 0 PHY 0$ OwnerDev : 14 SAS WWID : 5#000C500-003306B1$ DevHandle : 9$ PhyIdentifier : 0= Device Info SSP Target Direct Attached< Flag SGPIO DA Enclosure present.. PHY Info 3.0Gbps speed SAS>9 This example shows the SAS PHY connection for PHY 0. 2 UNIT< Displays the IR volumes configured in the SAS Controller. Format SHOW UNIT [volume_id] 3 Parameters volume_id3 $ Displays information about a specific IR volume.@ If a volume ID is not specified, the SAS utility displays all6 available IR volumes that the SAS Controller finds. 3 Qualifiers /FULL4 Displays additional information about IR volumes. 3 Example SAS> SHOW UNIT IR Volume information: -------------- IR Volume 4 --------------= Volume Type : RAID 1 (LSI Logic Integrated Mirror) Volume State : Optimal4 Size % : 69495 MB / 142325760 blocks" IR Disk 1 Source Disk Disk State : Online Slot ID : 1* SAS WWID : 5000C500-0134CB8D% IR Disk 0 Secondary Disk Disk State : Online Slot ID : 7* SAS WWID : 5000C500-0134DBB5 IR Hot Spare 7 Hot Spare Status : Active Slot ID : 6* SAS WWID : 12210000-06000000D This example displays volume information and all physical disks( corresponding to the IR volume set. 2 VERSION> Displays the version number of the SAS utility that you are currently using. Format SHOW VERSION 3 Example SAS> SHOW VERSION SAS$UTIL Version 1.0 Build 05-May-2006D This example shows that this version of the SAS utility is 1.0.ww