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 system.
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 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 on any affected disks, then issue the following command:
modify -A -i <initiator-address[,initiator-address...]> -d <disk-address[,disk-address...]> 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.
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, stop all I/O operations on any affected disks and issue the following command:
import -t <template-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> sas-domain <sas-domain-name>
Replace <filename> with a template name 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, stop all I/O operations on any affected disks and issue the following command:
import -t <template-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 the Array Registration Database only, 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 if the password in the database does not match the password in the Array SAS Expander. If setting a new password after it has been previously cleared, substitute \"\" for <old-password>.
To change (or set) the access configuration password in both the Array Registration Database and Array SAS Expander, issue the following command:
modify -s -N <new-password> sas-domain <sas-domain-name>
The passwords for both locations will then match.
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 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 HowiesPlace
Copies the configuration of a specified SAS domain to a specified template file.
export -t <filename> sas-domain <sas-domain-name>
Copies the configuration of a specified SAS domain to a specified template file.
-t,--template <filename>
Specifies the name of the XML file to which the SAS domain configuration information is saved.
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> 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 on any affected disks.
-t,--template <template-name>
Specifies the name of the template file from which SAS domain configuration information is imported.
Import template test_template to SAS domain PikesPlace:
import -t test_template 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 list [ -d <sas-domain> ] host-agent <host-agent name1>[,host-agent-name2,...]
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.
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 list sas-domain <sas-domain-name>[,sas-domain-name...]
Lists SAS domains or the details of 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 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 template
Lists a summary of all templates known by the management station.
list -d <sas-domain-name> template
Lists a summary of templates in a specified SAS domain.
list template <template-name>[,template-name...]
Lists the details of a specified template or templates.
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.
-d,--sas-domain <sas-domain-name>
Specifies the SAS domain for which a template summary is requested.
sscs list template Name: Unassigned Zone Split Name: F5100-quad-host Name: F5100-dual-host Name: J4400DualHost Name: test_template Name: J4500-dual-host Name: Simple Zone Split Name: J4400-dual-host Name: J4500-quad-host Name: J4200-dual-host
List templates within a specified SAS domain:
sscs list -d SAS_Breckenridge template Name: Unassigned Zone Split Name: F5100-quad-host Name: F5100-dual-host Name: J4400DualHost Name: J4500-dual-host Name: Simple Zone Split Name: J4400-dual-host Name: J4500-quad-host Name: J4200-dual-host
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 six variations of this command:
modify -n <sas-domain-name> sas-domain <sas-domain-name>
Renames the specified SAS domain.
See Example 1: Rename a SAS Domain.
modify -c sas-domain <sas-domain-name>
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.
See Example 2: Clear Password.
modify -C -P <old-password> -N <new-password> sas-domain <sas-domain-name>
Modifies the access configuration password stored in the Array Registration Database only. 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>. NOTE: If the password in the Array SAS Expander does not match, modification operations on the SAS domain will be prevented.
See Example 3: Change Password.
modify -s -N <new-password> sas-domain <sas-domain-name>
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.
See Example 4: Synchronize Passwords.
modify -A -i <initiator-address[,initiator-address...]> -d <disk-address[,disk-address...]> sas-domain <sas-domain-name>
Associates specified initiators and disks in a SAS domain. CAUTION: Before executing this command, stop all I/O operations on any affected disks.
See Example 5: Associate Initiators and Disks.
modify -D -i <initiator-address[,initiator-address...]> -d <disk-address[,disk-address...]> sas-domain <sas-domain-name>
Dissociates specified initiators and disks in a SAS domain. CAUTION: Before executing this command, stop all I/O operations on any affected disks.
See Example 6: Dissociate Initiators and Disks.
This command modifies the specified properties of a SAS domain.
-A,--associate
Associates specified initiators and disks.
-C,--change-password
Specifies to change the access configuration password in the Array Registration Database.
-c,--clear-password
Specifies to clears the current SAS domain password and reset it to the factory default of no password.
-D,--dissociate
Dissociates specified initiators and disks.
-d,--disk <disk-address[,disk-address...]>
Specifies the SAS addresses of the disks. 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. 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 <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>.
-s,--synch-password
Specifies to synchronize the Array Registration Database and Array SAS Expander passwords.
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 5000c50001b9c8f5,5000c50001b9c4dd,5000c50001b9c83d sas-domain SAS_Breckenridge
Multiple initiators to a single disk:
modify -A -i 500605b0008085d4,500605b0008088d3 -d 5000c50001b9c8f5 sas-domain SAS_Breckenridge
Multiple initiators to multiple disks:
modify -A -i 500605b0008085d4,500605b0008088d3 -d 5000c50001b9c4dd,5000c50001b9c83d sas-domain SAS_Breckenridge
Multiple initiators from a single disk:
modify -D -i 500605b0008085d4,500605b0008088d3 -d 5000c50001b9c4dd sas-domain SAS_Breckenridge
Dissociate multiple initiators from multiple disks:
modify -D -i 500605b0008085d4,500605b0008088d3 -d 5000c50001b9c8f5,5000c50001b9c4dd,5000c50001b9c83d sas-domain SAS_Breckenridge
Returns the specified SAS domains to their default settings.
reset sas-domain <sas-domain-name>
Returns the specified SAS domain to the default settings. CAUTION: Resetting the SAS domain changes the zoning state to Disabled, clears the existing access configuration and resets the SAS domain to the default access configuration. The default access configuration is such that there is open access between all initiators and all disks within the SAS domain.
reset sas-domain SAS_Breckenridge
Copyright © 2009 Sun Microsystems, Inc. All rights reserved.