| Sun Storage Common Array Manager CLI Guide, Version 6.8.0 |     |
| 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 Storage Common Array Manager Software Installation and Setup Guide.
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...]
To list all initiators and targets visible by each port for a specific SAS domain or multiple domains, issue the following command:
sscs list -p 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.
Access configurations can be created manually with one of two variants:
Note that each variant must be exectuted separately (i.e. it is not possible to create an access configuration between initiators, SAS ports, and disks within the same command). The two variants are described 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.
To configure SAS port to disk access manually, stop all I/O operations to any disks within the specified SAS domain, then issue the following command:
modify -A -p <sas-port-name[,sas-port-name...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name>
This will associate specified SAS ports with specified disks to create an access configuration. You can associate one or multiple SAS ports 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 Sun Storage Common Array Manager 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 Storage Common Array Manager Software Installation and Setup Guide.
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.
-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. 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. 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 CAM_Demo_Rocky1:
import -t Simple-zone-split -A Array1 -c CAM_Demo_Rocky1 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 [-p] sas-domain [sas-domain-name[,sas-domain-name...]]
Lists SAS domains or the details of specified SAS domains.
-p,--port
Specifies to display a table that lists all initiators and targets visible by each port for specified SAS domain(s).
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.
| Note - If multiple SAS domains are specified, the output is grouped by SAS domain. |
list sas-domain Name Devices Expanders ---------------- ------- --------- 500163600004f03f 20 1 50800200004cb4bf 4 1
| Note - 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. |
list sas-domain 50800200004cb4bf
Name : 50800200004cb4bf
Id : 50800200004cb4bf
Array Name(s) : F5100-1
Zoning State : Disabled
End Device Count : 4
Expander Count : 1
Expanders : 50800200004cb4bf
Endpoint Count : 40
Initiator Count : 1
Initiator : 500605b000809e44:4,5,6,7 camtest16.mpt:3:4_5_6_7
ZPSDS : 50800200004cb4bf
Connectors :
Port : F5100-1.Chassis.Expander.02.Port_0 -> Initiator
500605b000809e44:4,5,6,7 camtest16.mpt:3:4_5_6_7
Port : F5100-1.Chassis.Expander.02.Port_1
Port : F5100-1.Chassis.Expander.02.Port_2
Port : F5100-1.Chassis.Expander.02.Port_3
Group : 1
Groups : 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17,
18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30, 31, 32,
33, 34, 35, 36, 37, 38, 39, 40, 41, 42, 43, 44, 45, 46, 47,
48, 49, 50, 51, 52, 53, 54, 55, 56, 57, 58, 59, 60, 61, 62,
63, 64, 65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77,
78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90, 91, 92,
93, 94, 95, 96, 97, 98, 99, 100, 101, 102, 103, 104, 105,
106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117,
118, 119, 120, 121, 122, 123, 124, 125, 126, 127
Member : Expander 50800200004cb4bf:0
F5100-1.Chassis.Expander.02.FMod_Slot_0
Member : Expander 50800200004cb4bf:1
F5100-1.Chassis.Expander.02.FMod_Slot_1
Member : Expander 50800200004cb4bf:10
F5100-1.Chassis.Expander.02.FMod_Slot_10
Member : Expander 50800200004cb4bf:11
F5100-1.Chassis.Expander.02.FMod_Slot_11
Member : Expander 50800200004cb4bf:12
F5100-1.Chassis.Expander.02.FMod_Slot_12
Member : Expander 50800200004cb4bf:13
F5100-1.Chassis.Expander.02.FMod_Slot_13
Member : Expander 50800200004cb4bf:14
F5100-1.Chassis.Expander.02.FMod_Slot_14
Member : Expander 50800200004cb4bf:15
F5100-1.Chassis.Expander.02.FMod_Slot_15
Member : Expander 50800200004cb4bf:16
F5100-1.Chassis.Expander.02.FMod_Slot_16
Member : Expander 50800200004cb4bf:17
F5100-1.Chassis.Expander.02.FMod_Slot_17
Member : Expander 50800200004cb4bf:18
F5100-1.Chassis.Expander.02.FMod_Slot_18
Member : Expander 50800200004cb4bf:19
F5100-1.Chassis.Expander.02.FMod_Slot_19
Member : Expander 50800200004cb4bf:2
F5100-1.Chassis.Expander.02.FMod_Slot_2
Member : Expander 50800200004cb4bf:20
F5100-1.Chassis.Expander.02.Port_3
Member : Expander 50800200004cb4bf:21
F5100-1.Chassis.Expander.02.Port_3
Member : Expander 50800200004cb4bf:22
F5100-1.Chassis.Expander.02.Port_3 Member : Expander 50800200004cb4bf:23
F5100-1.Chassis.Expander.02.Port_3
Member : Expander 50800200004cb4bf:24
F5100-1.Chassis.Expander.02.Port_1
Member : Expander 50800200004cb4bf:25
F5100-1.Chassis.Expander.02.Port_1
Member : Expander 50800200004cb4bf:26
F5100-1.Chassis.Expander.02.Port_1
Member : Expander 50800200004cb4bf:27
F5100-1.Chassis.Expander.02.Port_1
Member : Expander 50800200004cb4bf:28,29,30,31
F5100-1.Chassis.Expander.02.Port_0 -> Initiator
500605b000809e44:4,5,6,7 camtest16.mpt:3:4_5_6_7
Member : Expander 50800200004cb4bf:3
F5100-1.Chassis.Expander.02.FMod_Slot_3
Member : Expander 50800200004cb4bf:32
F5100-1.Chassis.Expander.02.Port_2
Member : Expander 50800200004cb4bf:33
F5100-1.Chassis.Expander.02.Port_2
Member : Expander 50800200004cb4bf:34
F5100-1.Chassis.Expander.02.Port_2
Member : Expander 50800200004cb4bf:35
F5100-1.Chassis.Expander.02.Port_2
Member : Expander 50800200004cb4bf:36
F5100-1.Chassis.Expander.02.Virtual_SSP_(SES)_Target ->
sas.endpoint.type.VIRTUAL 50800200004cb4bd:0
50800200004cb4bd:0
Member : Expander 50800200004cb4bf:37
F5100-1.Chassis.Expander.02.Virtual_STP_Target
Member : Expander 50800200004cb4bf:4
F5100-1.Chassis.Expander.02.FMod_Slot_4
Member : Expander 50800200004cb4bf:5
F5100-1.Chassis.Expander.02.FMod_Slot_5
Member : Expander 50800200004cb4bf:6
F5100-1.Chassis.Expander.02.FMod_Slot_6
Member : Expander 50800200004cb4bf:7
F5100-1.Chassis.Expander.02.FMod_Slot_7 -> Target
50800200004cb487:0 F5100-1.EXP2.FMod.07 24.575GB
Member : Expander 50800200004cb4bf:8
F5100-1.Chassis.Expander.02.FMod_Slot_8 -> Target
50800200004cb488:0 F5100-1.EXP2.FMod.08 24.575GB
Member : Expander 50800200004cb4bf:9
F5100-1.Chassis.Expander.02.FMod_Slot_9 -> Target
50800200004cb489:0 F5100-1.EXP2.FMod.09 24.575GB
list -p sas-domain 50800200004cb4bf
ZPSDS: 50800200004cb4bf
Zoning State: Disabled
Access by Logical SAS Port:
Initiators Connectors Targets
------------------------ ----------------------------------- -------------------
--
F5100-1.Chassis.Expander.02.Port_2 F5100-1.EXP2.FMod.0
7,
F5100-1.EXP2.FMod.0
8,
F5100-1.EXP2.FMod.0
9
------------------------ ----------------------------------- -------------------
--
F5100-1.Chassis.Expander.02.Port_1 F5100-1.EXP2.FMod.0
7,
F5100-1.EXP2.FMod.0
8,
F5100-1.EXP2.FMod.0
9
------------------------ ----------------------------------- -------------------
--
camtest16.mpt:3:4_5_6_7 F5100-1.Chassis.Expander.02.Port_0 F5100-1.EXP2.FMod.0
7,
F5100-1.EXP2.FMod.0
8,
F5100-1.EXP2.FMod.0
9
------------------------ ----------------------------------- -------------------
--
F5100-1.Chassis.Expander.02.Port_3 F5100-1.EXP2.FMod.0
7,
F5100-1.EXP2.FMod.0
8,
F5100-1.EXP2.FMod.0
9
------------------------ ----------------------------------- -------------------
--
ZPSDS Logical SAS Port Names:
Type Logical SAS Port Name
---- ---------------------
Connector F5100-1.Chassis.Expander.02.Port_0
Connector F5100-1.Chassis.Expander.02.Port_1
Connector F5100-1.Chassis.Expander.02.Port_2
Connector F5100-1.Chassis.Expander.02.Port_3
Hba camtest16.mpt:3:4_5_6_7
Disk F5100-1.EXP2.FMod.07
Disk F5100-1.EXP2.FMod.08
Disk F5100-1.EXP2.FMod.09
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 ten 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-name[,initiator-name...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name> modify -D -i <initiator-name[,initiator-name...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name> modify -z sas-domain <sas-domain-name> modify -y sas-domain <sas-domain-name> modify -A -p <sas-port-name[,sas-port-name...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name> modify -D -p <sas-port-name[,sas-port-name...]> -d <disk-name[,disk-name...]> sas-domain <sas-domain-name>
This command modifies specified properties of a SAS domain.
-A,--associate (in conjunction with -i,--initiator and -d,--disk)
Associates specified initiators and disks in a SAS domain (i.e. defines an access configuration). Disk common names (e.g., CAM_Demo_Rocky:disk:Disk.01) or SAS addresses (e.g., 5000c50001b9c83d) are used in place of <disk-name>. Initiator common names or SAS addresses are used in place of <initiator-name>. Association of initiators and disks in combination with ports and disks is not possible within a single command. Both variants of -A must be executed separately. When creating a new initiator-disk association (i.e. access configuration), note the following two conditions:
|
|
Caution - Before executing the above command, stop all I/O operations to any disks within the specified SAS domain. |
-A,--associate (in conjunction with -p,--port and -d,--disk)
Associates specified ports and disks in a SAS domain (i.e. defines an access configuration). Disk common names (e.g., CAM_Demo_Rocky:disk:Disk.01) or SAS addresses (e.g., 5000c50001b9c83d) are used in place of <disk-name>. Association of ports and disks in combination with initiators and disks is not possible within a single command. Both variants of -A must be executed separately. When creating a new port-disk association (i.e. access configuration), note the following two conditions:
|
|
Caution - Before executing the above 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 (in conjunction with -i,--initiator and -d,--disk)
Dissociates specified initiators and disks in a SAS domain (i.e. defines an access configuration). Disk common names (e.g., CAM_Demo_Rocky:disk:Disk.01) or SAS addresses (e.g., 5000c50001b9c83d) are used in place of <disk-name>. Initiator common names or SAS addresses are used in place of <initiator-name>. Dissociation of initiators and disks in combination with ports and disks is not possible within a single command. Both variants of -D must be executed separately.
|
|
Caution - Before executing the above command, stop all I/O operations to any disks within the specified SAS domain. |
-D,--dissociate (in conjunction with -p,--port and -d,--disk)
Dissociates specified ports and disks in a SAS domain. Disk common names (e.g., CAM_Demo_Rocky:disk:Disk.01) and SAS addresses (e.g., 5000c50001b9c83d) are used in place of <disk-name>. Dissociation of ports and disks in combination with initiators and disks is not possible within a single command. Both variants of -D must be executed separately.
|
|
Caution - Before executing the above 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 (\"\").
-z,--prepare-cascade
Clears any previous access configurations on the specified SAS domain in preparation for storage cascading. Refer to the procedures in the Sun Storage Common Array Manager Software Installation and Setup Guide for information about configuring cascaded arrays.
-p,--port <sas-port-name[,sas-port-name...]>
Specifies the SAS port names to be used when associating or dissociating ports and disks.
-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. Refer to the procedures in the Sun Storage Common Array Manager Software Installation and Setup Guide for information about configuring cascaded arrays.
These examples use the following sample data:
|
Current SAS domain name (SAS Address): Current access configuration password: New access configuration password: CAM_Demo_Rocky:port:SIM.00.Host_In |
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 CAM_Demo_Rocky:disk:Disk.01,CAM_Demo_Rocky:disk:Disk.02,5000c50001b9c83d sas-domain SAS_Breckenridge
Multiple initiators to a single disk:
modify -A -i 500605b0008085d4,CAM_Demo_Rocky.mpt:3:0_1_2_3 -d CAM_Demo_Rocky:disk:Disk.01 sas-domain SAS_Breckenridge
Multiple initiators to multiple disks:
modify -A -i 500605b0008085d4,CAM_Demo_Rocky.mpt:3:0_1_2_3 -d CAM_Demo_Rocky:disk:Disk.02,5000c50001b9c83d sas-domain SAS_Breckenridge
Multiple initiators from a single disk:
modify -D -i 500605b0008085d4,CAM_Demo_Rocky.mpt:3:0_1_2_3 -d CAM_Demo_Rocky:disk:Disk.02 sas-domain SAS_Breckenridge
Dissociate multiple initiators from multiple disks:
modify -D -i 500605b0008085d4,CAM_Demo_Rocky.mpt:3:0_1_2_3 -d CAM_Demo_Rocky:disk:Disk.01,CAM_Demo_Rocky:disk:Disk.02,5000c50001b9c83d sas-domain SAS_Breckenridge
modify -z sas-domain SAS_Breckenridge
modify -y sas-domain SAS_Breckenridge
Multiple disks to a single port:
modify -A -p CAM_Demo_Rocky:port:SIM.00.Host_In -d CAM_Demo_Rocky:disk:Disk.01,CAM_Demo_Rocky:disk:Disk.02,CAM_Demo_Rocky:disk:Disk.03 sas-domain 50016360000514ff
Multiple ports to a single disk:
modify -A -p CAM_Demo_Rocky:port:SIM.00.Host_In,CAM_Demo_Rocky:port:SIM.00.Host_Out -d CAM_Demo_Rocky:disk:Disk.02 sas-domain 50016360000514ff
Multiple ports to multiple disks:
modify -A -p CAM_Demo_Rocky:port:SIM.00.Host_In,CAM_Demo_Rocky:port:SIM.00.Host_Out -d CAM_Demo_Rocky:disk:Disk.01,CAM_Demo_Rocky:disk:Disk.02,CAM_Demo_Rocky:disk:Disk.03 sas-domain 50016360000514ff
Multiple ports from a single disk:
modify -D -p CAM_Demo_Rocky:port:SIM.00.Host_In,CAM_Demo_Rocky:port:SIM.00.Host_Out,CAM_Demo_Rocky:port:SIM.00.SIMLink_Out -d CAM_Demo_Rocky:disk:Disk.01 sas-domain 50016360000514ff
Multiple disks from multiple ports:
modify -D -p CAM_Demo_Rocky:port:SIM.00.Host_In,CAM_Demo_Rocky:port:SIM.00.Host_Out,CAM_Demo_Rocky:port:SIM.00.SIMLink_Out -d CAM_Demo_Rocky:disk:Disk.01,CAM_Demo_Rocky:disk:Disk.02,CAM_Demo_Rocky:disk:Disk.03 sas-domain 50016360000514ff
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
| Sun Storage Common Array Manager CLI Guide, Version 6.8.0 | E20726-01 | |
Copyright © 2011, Oracle and/or its affiliates. All rights reserved.