C H A P T E R 5 |
SAS Domain Access Configuration Commands for JBOD Arrays |
This chapter describes the sscs commands and their options for SAS domain access configuration on Sun JBOD arrays, including Sun Storage J4200, J4400, and J4500 arrays, Sun Storage F5100 Flash Array, and the Sun Blade 6000 disk module.
For monitoring and administration commands for all Sun arrays, see Chapter 3. For configuration and other commands that apply only to arrays with RAID controllers, see Chapter 4.
This chapter begins with an overview of using the CLI to perform access configuration tasks, followed by the individual commands and their details:
This section provides a brief overview of using the CLI to perform SAS domain access configuration tasks. For detailed information concerning access configuration, see the Sun StorageTek Common Array Manager User Guide for Open Storage, part number 820-6663-xx.
The following topics are discussed:
To view a list of SAS domains, issue the following command:
sscs list sas-domain
This will provide a brief summary of all SAS domains known to the management station. To obtain detailed information for a specific SAS domain or multiple domains, issue the following command:
sscs list sas-domain <sas-domain-name>[,sas-domain-name...]
For detailed information on these commands, including examples, see list sas-domain.
When a SAS domain has been discovered by the management station, its name defaults to the domain’s SAS ID. After viewing the list of discovered SAS domains, if you would like to rename a domain to something more identifiable or meaningful, issue the following command:
sscs modify -n <sas-domain-name> sas-domain <sas-domain-name>
Note that the first instance of sas-domain-name is the new name you choose for the domain, while the second instance is the current domain name.
For detailed information on this command, including alternate variations which change other SAS domain properties, see modify sas-domain.
Access between initiators and disks within a SAS domain can be configured manually, with a factory pre-configured template, or with a user-configured template. These options are descibed below.
To configure initiator to disk access manually, stop all I/O operations to any disks within the specified SAS domain, then issue the following command:
modify -A -i <initiator-address[,initiator-address...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name>
This will associate specified initiators with specified disks to create an access configuration. You can associate one or multiple initiators with one or multiple disks. Note that disk SAS addresses are also acceptable for the -d option.
For detailed information on this command, including alternate variations which change other SAS domain properties, see modify sas-domain.
The Common Array Manager software includes factory default templates which represent common SAS domain access configuration options. TABLE 5-1 lists the available factory templates.
Once you have chosen the best template for your configuration, use the list template command to obtain valid anchor point and candidate values for that template. Then, stop all I/O operations to any disks within the specified SAS domain and issue the following command:
import -t <template-name> -A <anchorPoint-name[,anchorPoint-name...]> -c <candidate-name[,candidate-name...]> sas-domain <sas-domain-name>
The factory template configuration will then be applied to the specified SAS domain. For detailed information on this command, including examples, see import sas-domain.
In addition to the factory default templates, you can create your own templates to save access configurations for future use.
To save a configuration, issue the following command:
export -t <filename> [ -D <template-description> ] sas-domain <sas-domain-name[,sas-domain-name...]>
Replace <filename> with a template name of your choice. If desired, replace <template-description> with a description of your choice. Replace <sas-domain-name> with the name of the SAS domain whose configuration you want to save. The new template will then be included in the list of available templates. For detailed information on this command, including examples, see export sas-domain.
To restore a user template access configuration, use the list template command to obtain valid anchor point and candidate values for that template. Then, stop all I/O operations to any disks within the specified SAS domain and issue the following command:
import -t <template-name> -A <anchorPoint-name[,anchorPoint-name...]> -c <candidate-name[,candidate-name...]> sas-domain <sas-domain-name> The user template configuration will then be applied to the specified SAS domain. For detailed information on this command, including examples, see import sas-domain.
Access configuration passwords are stored in both the CAM Array Registration Database and JBOD Array SAS Expander, and must match in order to allow modification operations on a SAS domain. Passwords can be administered in three ways, each using a variation of the modify sas-domain command. See modify sas-domain for complete details.
To clear the access configuration password in the Array Registration Database, issue the following command:
modify -c sas-domain <sas-domain-name>
This will erase the password on the specified SAS domain and reset it to the factory default of no password.
To change (or set) the access configuration password in both the Array Registration Database and Array SAS Expander, issue the following command:
modify -C -P <old-password> -N <new-password> sas-domain <sas-domain-name>
Use this command to update the password in the Array Registration Database and Array SAS Expander at the same time. If setting a new password after it has been previously cleared, substitute "" for <old-password>, making sure to escape each quote mark (\"\").
To change the access configuration password in the Array Registration Database only, issue the following command:
modify -s -N <new-password> sas-domain <sas-domain-name>
Use this command to synchronize the Array Registration Database password with the Array SAS Expander password.
The CLI can be used to perform two functions in the overall storage cascading process:
For full details concerning these functions and storage cascade configuration in general, see the Sun StorageTek Common Array Manager User Guide for Open Systems.
To prepare a storage system (i.e. JBOD) for cascading, issue the following command:
modify -p sas-domain <sas-domain-name>
This will clear any previous access configurations on the specified SAS domain.
To synchronize the access configurations of cascaded arrays, issue the following command:
modify -y sas-domain <sas-domain-name>
This will synchronize the merged SAS domain in the cascaded storage (synchronizes access configurations and initializes the connections between arrays).
Disables SAS zoning for a specified SAS domain.
disable sas-domain <sas-domain-name>
Disables SAS zoning for a specified SAS domain.
disable sas-domain <sas-domain-name>
Disables the specified SAS domain.
disable sas-domain HowiesPlace
Enables SAS zoning for a specified SAS domain.
enable sas-domain <sas-domain-name>
Enables SAS zoning for a specified SAS domain.
enable sas-domain <sas-domain-name>
Enables the specified SAS domain.
enable sas-domain HowiesPlace
Copies the configuration of a specified SAS domain to a specified template file.
export -t <filename> [ -D <template-description> ] sas-domain <sas-domain-name[,sas-domain-name...]>
Copies the configuration of a specified SAS domain to a specified template file.
NOTE: For backup purposes, templates should be exported periodically in case of hardware failure. Current SAS domain access configuration data is auto-saved, however, when any access configuration change has been made by the user. This auto-save data is stored in a template file and can be used to recover a previous configuration. By default, a maximum of two auto-save template files are stored. When a new auto-save file is created for a SAS domain, it replaces the oldest file stored for that SAS domain.
-D,--template-description <template-description>
Specifies an optional template description.
-t,--template <filename>
Specifies the name of the XML file to which the SAS domain configuration information is saved.
sas-domain <sas-domain-name[,sas-domain-name...]>
Specifies the SAS domain from which configuration information is exported.
Export current configuration for SAS domain PikesPlace to a new template file named test_template:
export -t test_template sas-domain PikesPlace
Restores specified SAS domain configuration information from a specified template.
import -t <template-name> -A <anchorPoint-name[,anchorPoint-name...]> -c <candidate-name[,candidate-name...]> sas-domain <sas-domain-name>
Restores specified SAS domain configuration from a specified template file. CAUTION: Before executing this command, stop all I/O operations to any disk within the specified SAS domain.
-A,--anchor-point <anchorPoint-name[,anchorPoint-name...]>
Specifies the name of a sample JBOD configuration found within the specified template. This sample configuration is then applied to an actual JBOD in your live configuration. NOTE: Anchor points and candidates must be specified when performing a template import, and those specified must agree with the output provided from the list template command.
-c,--candidates <candidate-name[,candidate-name...]>
Specifies the name of an actual JBOD in your live configuration to be configured using values specified by the specified anchor point. NOTE: Anchor points and candidates must be specified when performing a template import, and those specified must agree with the output provided from the list template command.
-t,--template <template-name>
Specifies the name of the template file from which SAS domain configuration information is imported.
sas-domain <sas-domain-name>
Specifies the SAS domain to which imported configuration information is copied.
Import template Simple-zone-split to SAS domain PikesPlace using anchor point Array1 and candidate storage system JBOD_Test1:
import -t Simple-zone-split -A Array1 -c JBOD_Test1 sas-domain PikesPlace
List host-agents in a specified SAS domain or the details for specified host-agents in a specified SAS domain.
list [ -d <sas-domain> ] host-agent [<host-agent-name[,host-agent-name...]>]
Lists the host-agents in a specified SAS domain or the details for specified host-agents in a specified SAS domain.
-d,--sas-domain <sas-domain>
Specifies the SAS domain for which host-agents will be listed.
host-agent [<host-agent-name[,host-agent-name...]>]
If no host agent names are provided, lists host-agents in a specified SAS domain. If host agent names are provided, lists details for specified host-agents in a specified SAS domain.
List host-agents in a specified SAS domain:
list host-agent Name: cam-buffalo Name: rocky
List details for specified host-agents in a specified SAS domain:
list host-agent cam-buffalo Name: cam-buffalo Host IP: 10.30.12.118 Host ID: 0bba236c OS Type: SunOS x86 OS Version: 5.10 CAM Version: 6.3.0.6 Registered Arrays Name: 5080020000592B80 Health: Degraded Type: F5100 Total Capacity: 68.663 GB Available Capacity:0.000 MB Firmware Version: 5.3.62.0 SAS Domains Name: 508002000046743f.508002000046747f Entry SAS Address: 508002000046743f.508002000046747f No. of Expanders: 2 No. of End Devices: 7 Name: 5080020000592bbf Entry SAS Address: 5080020000592bbf No. of Expanders: 1 No. of End Devices: 5 HBAs SAS Address: 500605b000809e40 SAS Address: 500605b000809e44
Lists SAS domains or the details of specified SAS domains.
list sas-domain [<sas-domain-name[,sas-domain-name...]>]
Lists SAS domains or the details of specified SAS domains.
sas-domain [<sas-domain-name[,sas-domain-name...]>]
If no SAS domain names are provided, lists all SAS domains. If SAS domain names are provided, lists the details of the specified SAS domains.
list sas-domain Name Devices Expanders ---------------- ------- --------- 5080020000467a3f 5 2 5001636000050abf 17 1
List details of a specified SAS domain:
list sas-domain 50016360000418bf
NOTE: For reference, in the following output, “Group” is the current zone group, while “Groups” lists the other zone groups that have permission to view the current group.
Name : 50016360000418bf Id : 50016360000418bf ArrayId : 50016360000418bf Zoning state : Disabled End Device Count : 4 Expander Count : 1 Expanders : 50016360000418bf Endpoint Count : 40 Initiator Count : 1 Initiator : 500605b00080ac80:0,1,2,3 cam-shaggy:hba:camshaggy:\?\ pci#ven_1000&dev_0058&subsys_31501000&rev_08#4&31a80f53&0&005 0#{2accfe60-c130-11d2-b082-00a0c91efb8b} ZPSDS : 50016360000418bf Group : 0 Groups : 1 Member : Expander 50016360000418bf:3 AlamoSata:sasexpander Member : Expander 50016360000418bf:4 AlamoSata:sasexpander Member : Expander 50016360000418bf:5 AlamoSata:sasexpander Member : Expander 50016360000418bf:6 AlamoSata:sasexpander Member : Expander 50016360000418bf:7 AlamoSata:sasexpander Member : Expander 50016360000418bf:8 AlamoSata:sasexpander Member : Expander 50016360000418bf:9 AlamoSata:sasexpander Member : Expander Sun Feb 22 16:27:04 2009 -:- 50016360000418bf:10 AlamoSata:sasexpander Member : Expander 50016360000418bf:11 AlamoSata:sasexpander Member : Expander 50016360000418bf:12 AlamoSata:sasexpander Member : Expander 50016360000418bf:13 AlamoSata:sasexpander Member : Expander 50016360000418bf:14 AlamoSata:sasexpander Member : Expander 50016360000418bf:15 AlamoSata:sasexpander Member : Expander 50016360000418bf:16 AlamoSata:sasexpander Member : Expander 50016360000418bf:17 AlamoSata:sasexpander Member : Expander 50016360000418bf:18 AlamoSata:sasexpander Member : Expander 50016360000418bf:19 AlamoSata:sasexpander Member : Expander 50016360000418bf:24 AlamoSata:sasexpander Member : Expander 50016360000418bf:25 AlamoSata:sasexpander Member : Expander 50016360000418bf:26 AlamoSata:sasexpander Member : Expander 50016360000418bf:27 AlamoSata:sasexpander Member : Expander 50016360000418bf:28 AlamoSata:sasexpander Sun Feb 22 16:27:04 2009 -:- Member : Expander 50016360000418bf:29 AlamoSata:sasexpander Member : Expander 50016360000418bf:30 AlamoSata:sasexpander Member : Expander 50016360000418bf:31 AlamoSata:sasexpander Member : Expander 50016360000418bf:32 AlamoSata:sasexpander Member : Expander 50016360000418bf:33 AlamoSata:sasexpander Member : Expander 50016360000418bf:34 AlamoSata:sasexpander Member : Expander 50016360000418bf:35 AlamoSata:sasexpander Group : 1 Groups : 1 Member : Expander 50016360000418bf:20,21,22,23 AlamoSata:sasexpander -> Initiator 500605b00080ac80:0,1,2,3 cam-shaggy:hba:camshaggy:\?\ pci#ven_1000&dev_0058&subsys_31501000&rev_08#4&31a80f53&0&005 0#{2accfe60-c130-11d2-b082-00a0c91efb8b} Member : Expander 50016360000418bf:0 AlamoSata:sasexpander -> Target 5001636000041888:0 AlamoSata:disk:Disk.00 250.55GB Member : Expander 50016360000418bf:1 AlamoSata:sasexpander -> Target 5001636000041889:0 AlamoSata:disk:Dis Sun Feb 22 16:27:04 2009 -:- k.01 250.55GB Member : Expander 50016360000418bf:2 AlamoSata:sasexpander -> Target 500163600004188a:0 AlamoSata:disk:Disk.02 250.55GB Member : Expander 50016360000418bf:36 AlamoSata:sasexpander -> sas.endpoint.type.VIRTUAL 50016360000418bd:0 Member : Expander 50016360000418bf:37 AlamoSata:sasexpander
Provides a list of all SAS access configuration (zone) groups and details of those groups.
list sas-zone
Provides a list of all SAS access configuration (zone) groups and their details.
NOTE: The following example output is truncated. Actual output is often much longer than what is represented here.
list sas-zone SAS Zone Groups: Group: 1 Group With Permission To Id: 1 Key: 50800200004696bf.50800200004696ff.0x1 ZpsdsKey: 50800200004696bf.50800200004696ff Members: SAS Address: 50800200004696ff Type: EXPANDER Key: 50800200004696ff:28,29,30,31,32,33,34,35 SES Reference: j4500:J4500-2-bottom-test2:sasexpander Attach Point: 50800200004696bf:28,29,30,31,32,33,34,35 Capacity: null Model: j4500 Device Name: J4500-2-bottom-test2 Component Name: Class: sasexpander SAS Address: 50800200004696bf Type: EXPANDER Key: 50800200004696bf:28,29,30,31,32,33,34,35 SES Reference: j4500:J4500-2-bottom-test2:sasexpander Attach Point: 50800200004696ff:28,29,30,31,32,33,34,35 Capacity: null Model: j4500 Device Name: J4500-2-bottom-test2 Component Name: Class: sasexpander SAS Address: 50800200004696bf Type: EXPANDER Key: 50800200004696bf:36 SES Reference: j4500:J4500-2-bottom-test2:sasexpander Attach Point: 50800200004696bd:0 Capacity: null Model: j4500 Device Name: J4500-2-bottom-test2 Component Name: Class: sasexpander
Lists a summary of SAS domain templates or details of specified templates.
list [-d <sas-domain-name>] template [<template-name[,template-name...]>]
Lists a summary of all SAS domain templates known by the current management station, a summary of templates in a specified SAS domain, or details of specified templates. Use this command to obtain valid anchor point and candidate values for a specified template when executing the import sas-domain command.
-d,--sas-domain <sas-domain-name>
Specifies the SAS domain for which a template summary is requested.
template [<template-name[,template-name...]>]
If no specific template names are specified, a summary of templates will be listed. If specific template names are specified, details for those templates will be listed.
sscs list template Name: F5100-dual-host Name: F5100-quad-host Name: J4200-dual-host Name: J4400-dual-host Name: J4500-dual-host Name: J4500-quad-host Name: Simple-zone-split Name: Unassigned-zone-split
List templates within a specified SAS domain:
sscs list -d SAS_Breckenridge template Name: F5100-dual-host Name: F5100-quad-host Name: J4200-dual-host Name: J4400-dual-host Name: J4500-dual-host Name: J4500-quad-host Name: Simple-zone-split Name: Unassigned-zone-split
List details of a specified template:
sscs list template “Simple-zone-split” Name: Simple-zone-split Description: A template that splits all current disks evenly across all current initiators. Anchor Points Name:JBOD Description:SAS JBOD Array Candidates:J4500-2-bottom-test2,J4500-2-bottom-test2
Modifies specified properties of a SAS domain. There are eight variations of this command:
modify -n <new-sas-domain-name> sas-domain <sas-domain-name> modify -c sas-domain <sas-domain-name> modify -C -P <old-password> -N <new-password> sas-domain <sas-domain-name> modify -s -N <new-password> sas-domain <sas-domain-name> modify -A -i <initiator-address[,initiator-address...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name> modify -D -i <initiator-address[,initiator-address...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name> modify -p sas-domain <sas-domain-name> modify -y sas-domain <sas-domain-name>
This command modifies the specified properties of a SAS domain.
-A,--associate
Associates specified initiators and disks in a SAS domain (i.e. defines an access configuration). Disk common names (e.g., JBOD_Test:disk:Disk.01) and SAS addresses (e.g., 5000c50001b9c83d) are used in place of <disk-name>. Initiator SAS addresses are used in place of <initiator-address>. When creating a new initiator-disk association (i.e. access configuration), disks not targeted for the new access configuration must first be dissociated from the initiator. CAUTION: Before executing this command, stop all I/O operations to any disks within the specified SAS domain.
-C,--change-password
Modifies the access configuration password in the Array Registration Database and the Array SAS Expander so both passwords match. The password can be a maximum of 32 alphanumeric characters. If setting a new password after it has been previously cleared, substitute "" for <old-password>, making sure to escape each quote mark (\"\").
-c,--clear-password
Clears the access configuration password in the Array Registration Database and resets it to the factory default of no password. NOTE: If the password in the Array SAS Expander is also not set to the default, modification operations on the SAS domain will be prevented.
-D,--dissociate
Dissociates specified initiators and disks in a SAS domain (i.e. defines an access configuration). Disk common names (e.g., JBOD_Test:disk:Disk.01) and SAS addresses (e.g., 5000c50001b9c83d) are used in place of <disk-name>. Initiator SAS addresses are used in place of <initiator-address>. CAUTION: Before executing this command, stop all I/O operations to any disks within the specified SAS domain.
-d,--disk <disk-name[,disk-name...]>
Specifies the common names of the disks. Disk SAS addresses can also be used. If using this option, a value must be supplied or else an error message will be returned.
-i,--initiator <initiator-address[,initiator-address...]>
Specifies the SAS addresses of the initiators. Initiator common names cannot be used. If using this option, a value must be supplied or else an error message will be returned.
-N,--new-password <new-password>
Specifies a new access configuration password.
-n,--new-name <new-sas-domain-name>
Specifies a new name for the specified SAS domain.
-P,--old-password <old-password>
Specifies the existing access configuration password in the Array Registration Database. If setting a new password after it has been previously cleared, substitute "" for <old-password>, making sure to escape each quote mark (\"\").
-p,--prepare-cascade
Clears any previous access configurations on the specified SAS domain in preparation for storage cascading. NOTE: Refer to the procedures in the Sun StorageTek Common Array Manager User Guide for Open Systems for information about configuring cascaded arrays.
-s,--synch-password
Modifies the access configuration password stored in the Array Registration Database only. The password can be a maximum of 32 alphanumeric characters. NOTE: If the password in the Array SAS Expander does not match, modification operations on the SAS domain will be prevented.
-y,--synch-cascade
Synchronizes the merged SAS domain in cascaded storage. This action synchronizes the zoning permissions and initializes the connections between arrays. NOTE: Refer to the procedures in the Sun StorageTek Common Array Manager User Guide for Open Systems for information about configuring cascaded arrays.
These examples use the following sample data:
Current SAS domain name (SAS Address): Current access configuration password: |
modify -n SAS_Breckenridge sas-domain 50016360000514ff
modify -c sas-domain SAS_Breckenridge
modify -C -P key!stone -N colo!rado sas-domain SAS_Breckenridge
modify -s -N colo!rado sas-domain SAS_Breckenridge
Single initiator to multiple disks:
modify -A -i 500605b0008085d4 -d JBOD_Test:disk:Disk.01,JBOD_Test:disk:Disk.02,5000c50001b9c83d sas-domain SAS_Breckenridge
Multiple initiators to a single disk:
modify -A -i 500605b0008085d4,500605b0008088d3 -d JBOD_Test:disk:Disk.01 sas-domain SAS_Breckenridge
Multiple initiators to multiple disks:
modify -A -i 500605b0008085d4,500605b0008088d3 -d JBOD_Test:disk:Disk.02,5000c50001b9c83d sas-domain SAS_Breckenridge
Multiple initiators from a single disk:
modify -D -i 500605b0008085d4,500605b0008088d3 -d JBOD_Test:disk:Disk.02 sas-domain SAS_Breckenridge
Dissociate multiple initiators from multiple disks:
modify -D -i 500605b0008085d4,500605b0008088d3 -d JBOD_Test:disk:Disk.01,JBOD_Test:disk:Disk.02,5000c50001b9c83d sas-domain SAS_Breckenridge
modify -p sas-domain SAS_Breckenridge
modify -y sas-domain SAS_Breckenridge
Returns the specified SAS domains to their default settings. CAUTION: Carefully review the below command description before executing this command.
reset sas-domain <sas-domain-name>
Upon execution, this command performs the following:
sas-domain <sas-domain-name>
Specifies the SAS domain to reset to default settings.
reset sas-domain SAS_Breckenridge
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.