SAS Domain Access Configuration Commands for JBOD Arrays

C H A P T E R 5

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:

Overview of Access Configuration with the CLI

disable sas-domain

enable sas-domain

export sas-domain

import sas-domain

list host-agent

list sas-domain

list sas-zone

list template

modify sas-domain

reset sas-domain

Overview of Access Configuration
with the CLI

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:

Viewing Discovered SAS Domains

Changing the Domain Name

Configuring Access

Administering Access Configuration Passwords

Viewing Discovered SAS Domains

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.

Changing the Domain Name

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.

Configuring Access

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.

Manual Configuration

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.

Factory Template Configuration

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.

TABLE 5-1 List of Factory Default Templates
Template Name	Description
F5100-dual-host	Allocate equal numbers of disks to each of two hosts. For use with a single enclosure.
F5100-quad-host	Allocate equal numbers of disks to each of four hosts. For use with a single enclosure.
J4200-dual-host	Allocate equal numbers of disks to each of two hosts. Supports cascade depth of four devices.
J4400-dual-host	Allocate equal numbers of disks to each of two hosts. Supports cascade depth of three devices.
J4400DualHost	Partition a single J4400 between two initiator ports.
J4500-dual-host	Allocate equal numbers of disks to each of two hosts. Supports cascade depth of three devices.
J4500-quad-host	Allocate equal numbers of disks to each of four hosts. Does not support any cascading.
Simple Zone Split	Split all current disks evenly across all current initiators.
Unassigned Zone Split	Split all unassigned disks evenly across all current initiators.

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.

User Template Configuration

In addition to the factory default templates, you can create your own templates to save access configurations for future use.

Saving a User Configuration

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.

Restoring a User Configuration

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.

Administering Access Configuration Passwords

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.

Clearing the Password

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.

Changing the 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>.

Synchronizing the 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.

disable sas-domain

Disables SAS zoning for a specified SAS domain.

Synopsis

disable sas-domain <sas-domain-name>

Description

Disables SAS zoning for a specified SAS domain.

Examples

disable sas-domain HowiesPlace

enable sas-domain

Enables SAS zoning for a specified SAS domain.

Synopsis

enable sas-domain <sas-domain-name>

Description

Enables SAS zoning for a specified SAS domain.

Examples

enable sas-domain HowiesPlace

export sas-domain

Copies the configuration of a specified SAS domain to a specified template file.

Synopsis

export -t <filename> sas-domain <sas-domain-name>

Description

Copies the configuration of a specified SAS domain to a specified template file.

Options

-t,--template <filename>

Specifies the name of the XML file to which the SAS domain configuration information is saved.

Examples

Export current configuration for SAS domain PikesPlace to a new template file named test_template:

export -t test_template sas-domain PikesPlace

import sas-domain

Restores specified SAS domain configuration information from a specified template.

Synopsis

import -t <template-name> sas-domain <sas-domain-name>

Description

Restores specified SAS domain configuration from a specified template file. CAUTION: Before executing this command, stop all I/O operations on any affected disks.

Options

-t,--template <template-name>

Specifies the name of the template file from which SAS domain configuration information is imported.

Examples

Import template test_template to SAS domain PikesPlace:

import -t test_template sas-domain PikesPlace

list host-agent

List host-agents in a specified SAS domain or the details for specified host-agents in a specified SAS domain.

Synopsis

list [ -d <sas-domain> ] host-agent
list [ -d <sas-domain> ] host-agent <host-agent name1>[,host-agent-name2,...]

Description

Lists the host-agents in a specified SAS domain or the details for specified host-agents in a specified SAS domain.

Options

-d,--sas-domain <sas-domain>

Specifies the SAS domain for which host-agents will be listed.

Examples

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

list sas-domain

Lists SAS domains or the details of specified SAS domains.

Synopsis

list sas-domain
list sas-domain <sas-domain-name>[,sas-domain-name...]

Description

Lists SAS domains or the details of specified SAS domains.

Examples

List 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

list sas-zone

Provides a list of all SAS access configuration (zone) groups and details of those groups.

Synopsis

list sas-zone

Description

Provides a list of all SAS access configuration (zone) groups and their details.

Examples

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

list template

Lists a summary of SAS domain templates or details of specified templates.

Synopsis

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.

Description

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.

Options

-d,--sas-domain <sas-domain-name>

Specifies the SAS domain for which a template summary is requested.

Examples

List all templates:

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

modify sas-domain

Modifies specified properties of a SAS domain. There are six variations of this command:

Rename specified SAS domain

Clear access configuration password in Array Registration Database

Modify (or set) access configuration password in Array Registration Database

Synchronize access configuration password between Array Registration Database and Array SAS Expander

Associate specified initiators and disks in a SAS domain

Dissociate specified initiators and disks in a SAS domain.

Synopsis

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.

Description

This command modifies the specified properties of a SAS domain.

Options

-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.

Examples

These examples use the following sample data:

Current SAS domain name (SAS Address):

50016360000514ff

New SAS domain name:

SAS_Breckenridge

Current access configuration password:

key!stone

New access configuration password:

colo!rado

Initiator-1 SAS address:

500605b0008085d4

Initiator-2 SAS address:

500605b0008088d3

Disk-1 SAS address:

5000c50001b9c8f5

Disk-2 SAS address:

5000c50001b9c4dd

Disk-3 SAS address:

5000c50001b9c83d

Note - When using special characters, such as “!” used in these example passwords, you must escape them or else the shell will misinterpret the command. The password key!stone would thus be entered key\!stone.

Example 1: Rename a SAS Domain

modify -n SAS_Breckenridge sas-domain 50016360000514ff

Example 2: Clear Password

modify -c sas-domain SAS_Breckenridge

Example 3: Change Password

modify -C -P key!stone -N colo!rado sas-domain SAS_Breckenridge

Example 4: Synchronize Passwords

modify -s -N colo!rado sas-domain SAS_Breckenridge

Example 5: Associate Initiators and Disks

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

Example 6: Dissociate Initiators and Disks

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

reset sas-domain

Returns the specified SAS domains to their default settings.

Synopsis

reset sas-domain <sas-domain-name>

Description

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.

Examples

reset sas-domain SAS_Breckenridge

Overview of Access Configuration with the CLI

Viewing Discovered SAS Domains

Changing the Domain Name

Configuring Access

Manual Configuration

Factory Template Configuration

User Template Configuration

Saving a User Configuration

Restoring a User Configuration

Administering Access Configuration Passwords

Clearing the Password

Changing the Password

Synchronizing the Password

disable sas-domain

Synopsis

Description

Examples

enable sas-domain

Synopsis

Description

Examples

export sas-domain

Synopsis

Description

Options

Examples

import sas-domain

Synopsis

Description

Options

Examples

list host-agent

Synopsis

Description

Options

Examples

list sas-domain

Synopsis

Description

Examples

list sas-zone

Synopsis

Description

Examples

list template

Synopsis

Description

Options

Examples

modify sas-domain

Synopsis

Description

Options

Examples

Example 1: Rename a SAS Domain

Example 2: Clear Password

Example 3: Change Password

Example 4: Synchronize Passwords

Example 5: Associate Initiators and Disks

Example 6: Dissociate Initiators and Disks

reset sas-domain

Synopsis

Description

Examples

Overview of Access Configuration
with the CLI