C H A P T E R  4

Feedback Configuration Commands for Arrays with RAID Controllers

This chapter describes the sscs commands and their options for arrays with RAID controllers, including:

For monitoring and administration commands for all Oracle arrays, see Chapter 3.


add hostgroup

Synopsis

Adds hosts to a host group.

add -a <array-name> -h <host-name[,host-name...]> hostgroup <host-group-name>

Description

Adds hosts to a host group.

Options

-a,--array <array-name>

Specifies the array associated with this host.

-h,--host <host-name[,host-name...]>

Specifies the host or hosts that you want to add to the host group.

hostgroup <host-group-name>

Specifies a host group name of up to 16 alphanumeric characters, underscores, dashes, and spaces.

Examples

sscs add -a array00 -h host01,host02 hostgroup hg01


add license

Adds a license to the specified array.

Synopsis

add -a <array-name> -l <license-file> license

Description

Adds a license to the specified array.

Options

-a,--array <array-name>

Specifies the array to associate with this license.

-l,--license <license-file>

Specifies the license to associate with this array. The location specified must be a regular file path supported by the management host OS (URL paths are not supported). The license file can be in either the .xml or .key formats.



Note - The file extension does not need to be specified.


Examples

sscs add -a array_test -l C:\temp\licenses\snapshot-license license

Adds a license to the array_test array from the specified location.


create host

Creates a storage host.

Synopsis

create -a <array-name> [ -g <host-group-name> ] host <host-name>
create -a <array-name> [-g <hostgroup-name>] [-w <string[,string...]>] [-d <description-text>]  host <host-name>

Description

Creates a storage host where data is initiated.

Options

-a,--array <array-name>

Specifies the name of the array on which you want to create a host. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-w,--wwn <string>

Specifies the initiator World Wide Name (WWN).

-d,--description <description-text>

Specifies the host description.

-g,--hostgroup <host-group-name>

Specifies a host group with which you associate this new host.

host

Specifies the name of the host that you want to create, using up to 16 alphanumeric characters, underscores, dashes, and spaces.

Examples

sscs create -a array00 host host1


create hostgroup

Creates a storage host group.

Synopsis

create -a <array-name> hostgroup <host-group-name> 

Description

Creates a group of hosts to share storage.

Options

-a,--array <array-name>

Specifies the array on which you want to create a host group.

hostgroup <host-group-name>

Specifies the name of the host group that you want to create, using up to 16 alphanumeric characters, underscores, dashes, and spaces.

Examples

sscs create -a array00 hostgroup hg1


create initiator

Creates an initiator.

Synopsis

create -a <array-name> -h <host-name> [-o <string>] [-i <iqn-string>] [ -u <none|CHAP>] initiator <initiator-name>

Creates an iSCSI initiator.

create -a <array-name> -w <initiator-WWN> [-h <host-name>] [-o <string>] initiator <initiator-name>

Creates a FC initiator.

Description

Creates a FC or iSCSI initiator.

Options

-a,--array <array-name>

Specifies the array. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-h,--host <host-name>

Specifies the data storage host name.

-i,--iqn <iqn-string>

Specifies the iSCSI qualified name (IQN) for the initiator.

-o,--os-type <string>

Specifies the operating system (OS) type. Use the command sscs list -a <array-name> os-type to view all of the operating systems that are supported by the array. Then, use an applicable OS type value for <string>.

-u,--authentication <none|CHAP>

Specifies to use the Challenge Handshake Authentication Protocol (CHAP) authentication method for accessing the target. Values are CHAP or none.

-w,--wwn <initiator-WWN>

Specifies the initiator World Wide Name (WWN). For example: 210000e08b047212.

initiator <initiator-name>

Specifies an initiator name of up to 16 alphanumeric characters, underscores, dashes, and spaces.

Examples

Create iSCSI initiator:

sscs create -a IEC_iSCSI_LCA -h Myhost_19852 -o SOLARIS_MPXIO -i iqn.2001-06.com.sun:fvt3init21.sys1 -u CHAP initiator initiSCSI

Create FC initiator:

sscs create -a array00 -w 210000e08b047212 -h host01 -o AIX initiator myInitiator-01


create pool

Creates an empty storage pool on the array.

Synopsis

create -a <array-name> -p <profile-name> [ -d <description> ] pool <pool-name>

Description

Creates an empty storage pool on the array and assigns a profile to it.

Options

-a,--array <array-name>

Specifies the array. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-d,--description <description>

Specifies a description of the pool. The description can be up to 256 alphanumeric characters, which can include underscores, dashes, colons, commas, parentheses, curly brackets, square brackets, ticks, tildes, bars, periods, or spaces.

-p,--profile <profile-name>

Specifies a profile to associate with the pool.

pool <pool-name>

Specifies a pool name of up to 32 characters including A-Z, a-z, 0-9, - (dash), and _ (underscore). Spaces are not allowed.

Examples

sscs create -a array00 -p Database pool SP048763


create profile

Creates a storage profile on the array.

Synopsis

create -a <array-name> -r <<0|1>|<3|5|6>> -s <16K|32K|64K|128K|256K|512K> -h <on|off> -n <variable|<1..224>|<1..30>> [-k <ANY|FC|SAS|SATA|SSD>] [-H <yes|no>] [-d <profile-description>] profile <profile-name>

Description

Profiles for the most common configurations come with the software. This command creates a custom storage profile and assigns it to an array.

Options

-a,--array <array-name>

Specifies the array name.

-d,--description <profile-description>

Specifies a profile description of up to 256 alphanumeric characters, which can include underscores, dashes, colons, commas, parentheses, curly brackets, square brackets, ticks, tildes, bars, periods, or spaces.

-k,--disk-type <ANY|FC|SAS|SATA|SSD>

Specifies the disk type:

ANY - Any type of disk

FC - Fibre Channel

SAS - Serial Attached SCSI

SATA - Serial Advanced Technology Attachment

SSD - Solid State Device

-h,--readahead <on|off> 

Specifies whether the read ahead option is on or off.

-H,--dedicated-hot-spare <yes|no> 

Specifies whether you want this disk to be a dedicated hot spare.

-n,--number-of-disks <variable|<1..224>|<1..30>> 

Specifies the number of disks. variable indicates that the number of disks is not fixed and can change. <1..224> is used in combination with RAID levels 0 and 1. <1..30> is used in combination with RAID levels 3, 5, and 6.

-r,--raid-level <<0|1>|<3|5|6>>

Specifies the RAID level. <0|1> is used in combination with number-of-disks 1 to 224. <3|5|6> is used in combination with number-of-disks 1 to 30.

-s,--segsize <16K|32K|64K|128K|256K|512K>

Specifies the segment size.

profile <profile-name>

Specifies a profile name of up to 32 characters including A-Z, a-z, 0-9, - (dash), and _ (underscore). Spaces are not allowed.

Examples

sscs create -a array00 -r 1 -s 64K -h on -n variable -D FC -d Custom-Database-Profile profile DatabaseProfile


create repset

Creates a storage replication set using a peer World Wide Name or remote array name.

Synopsis

Create a storage replication set linking the local volume with the remote volume via a peer World Wide Name:

create -a <array-name> -l <volume-name> -w <peer-WWN> -o <volume-name> -m <sync|async> [-G <yes|no>] [-R <lowest|low|medium|high|highest>] [-s <enable|disable>] repset

Create a replication set linking the local volume with the remote volume via a remote array name:

create -a <array-name> -l <volume-name> -A <remote-array-name> -o <volume-name> -m <sync|async> [-G <yes|no> ] [-R <lowest|low|medium|high|highest>] [-s <enable|disable>] repset

Description

Creates a storage replication set using a peer World Wide Name or remote array name.

Options

-a,--array <array-name>

Specifies the array. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-A,--remote-array <remote-array-name>

Specifies the remote array. Options -A and -w are mutually exclusive.

-G,--consistency-group <yes|no> 

Specifies whether or not you want to add this replication set to the array consistency group. Note that the default value (no) is only allowed with the asynchronous mode option.

-l,--local-volume <volume-name>

Specifies the local volume name.

-m,--mode <sync|async> 

Specifies whether the mode is synchronous or asynchronous.

-o,--remote-volume <remote-volume-name>

Specifies the remote volume name.

-R,--replication-priority <lowest|low|medium|high|highest>

Specifies the priority of this replication set. If no priority is specified, the default is medium.

-s,--auto-sync <enable|disable> 

Specifies whether the auto synchronization policy is enabled. If it is not specified, the default is disabled.

-w,--peer-wwn <peer-WWN>

Specifies the peer World Wide Name.

Examples

sscs create -a europe -l euro_sales -w 17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61 -o euro_sales -m async -G no -R medium -s enable repset

Creates a replication set of the euro_sales volume that exists on the array named europe. In the process, it uses the euro_sales volume on the array whose WWN is 17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61 and sets it to synchronize asynchronously with a medium priority with the write order not preserved and resynchronization performed automatically. This repset is called euro_sales/1.

sscs create -a corp_west -l crm-sales -w 17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61 -o crm-sales -m async -G no -R medium -s enable repset

Creates a replication set of the crm-sales volume that exists on the array named corp_west. In so doing, it uses the crm-sales volume on the array whose WWN is 17:76:18:12:18:49:18:62:19:14:19:39:19:47:19:61 and sets it to synchronize asynchronously with the highest priority with the write order preserved and resynchronization performed automatically. This repset is called crm-sales/1.

sscs create -a europe -l euro_sales -A corporate -o euro_sales -m async -G no -R medium -s enable repset

Creates a replication set of the euro_sales volume that exists on the array named europe. In the process, it uses the euro_sales volume on the corporate array and sets it to synchronize asynchronously with a medium priority with the write order not preserved and resynchronization performed automatically. This repset is called euro_sales/1.

sscs create -a corp_west -l crm-sales -A corporate -o crm-sales -m async -G yes -R highest -s enable repset

Creates a replication set of the crm-sales volume that exists on the array named corp_west. In so doing, it uses the crm-sales volume on the corporate array and sets it to synchronize asynchronously with the highest priority with the write order preserved and resynchronization performed automatically. This repset is called
crm-sales/1.


create snapshot

Creates a snapshot for the specified volume.

Synopsis

create -a <array-name> -V <source-volume-name> [-f <failbasewrite|failsnapshot>] [-v <virtual-disk-name>] [-m <volume-name>] [-w <0..100>] [-n <<1..224>|<1..30>>] [-d <disk-name[,disk-name...]>] [-r <<0|1>|<3|5|6>>] [-k <ANY|FC|SAS|SATA|SSD>] [-Z <number<TB|GB|MB|KB|Bytes|BLK>>] [-C <integer>] [-L <low|verylittle|little|average|high|full>] [-l <0..100>] [-P <pool-name>] [-D <description-text>] snapshot <snapshot-name>

Description

Creates a snapshot for the specified volume. Once the snapshot volume is created, it can be treated as any other volume, with the exception that it cannot be used to create another snapshot.

Options

-a,--array <array-name>

Specifies the array associated with this snapshot. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-C,--snapshot-count <integer>

Specifies the number of intended snapshots for the volume.

-D,--description <description-text>

Specifies a description of the snapshot.

-d,--disk <disk-name[,disk-name...]>

Specifies the name of the disk or disks that will be used to create the snapshot volume. Options -d and -n cannot be used at the same time, and specification of either one results in a new virtual disk being created.

-f,--fail-policy <failbasewrite|failsnapshot>

The fail policy specifies what to do if and when the snapshot fills up:

failbasewrite - Stop allowing writes to the base volume.

failsnapshot - Stop allowing writes to the snapshot. This is the default.

-k,--disk-type <ANY|FC|SAS|SATA|SSD>

Specifies the disk type:

ANY - Any type of disk

FC - Fibre Channel

SAS - Serial Attached SCSI

SATA - Serial Advanced Technology Attachment

SSD - Solid State Device

-L,--snapshot-level <low|verylittle|little|average|high|full>

The snapshot level should be set to the percentage of the base volume that is expected to be overwritten during the snapshot's lifetime. This determines the amount of storage allocated to the snapshot (that is, the size of its reserve volume). To maintain the snapshot of the base volume's state, data in the base volume that is about to be overwritten is copied into the snapshot reserve space.

The snapshot levels equate to the following percentages:

10% - low

25% - verylittle

40% - little

50% - average

75% - high

100% - full

-l,--snapshot-percentage <0..100>

Specifies what percentage of the volume is to be used for snapshot creation.

-m,--reserve-name <volume-name>

Specifies the name of the reserve volume. If no name is specified, a name is created and assigned automatically.

-n,--number-of-disks <<1..224>|<1..30>>

Specifies the number of disks in the snapshot volume. <1..224> is used in combination with RAID levels 0 and 1. <1..30> is used in combination with RAID levels 3, 5, and 6.

-P,--snapshot-pool <pool-name>

Specifies the name of the snapshot.

-r,--raid-level <<0|1>|<3|5|6>>

Specifies the RAID level. <0|1> is used in combination with number-of-disks 1 to 224. <3|5|6> is used in combination with number-of-disks 1 to 30.

-v,--reserve-vdisk <virtual-disk-name>

This option is mutually exclusive from the -d, -k, -n, and -r options.

If a reserve virtual disk is not specified:

If a reserve virtual disk is specified:

-V,--volume <source-volume-name>

Specifies the source volume from which to take a snapshot.

-w,--warning-threshold <0..100>

Specifies when to inform you that the snapshot reserve volume is near capacity. If a warning threshold is not specified, 50% is used.

-Z,--snapshot-reserve-size <number<TB|GB|MB|KB|Bytes|BLK>>

Specifies the amount of space you want to reserve for capacity of the snapshot reserve volume.

snapshot <snapshot-name>

Specifies the snapshot name of up to 16 alphanumeric using characters, underscores, dashes, and spaces.

Examples

sscs create -a array00 -V vol0 snapshot vol01_snap


create vdisk

Creates a virtual disk.

Synopsis

create -a <array-name> -p <pool-name> -d <disk-name[,disk-name...]> [-S] vdisk <virtual-disk-name>
create -a <array-name> -p <pool-name> -n <integer> [-S] vdisk <virtual-disk-name>

Description

Creates a virtual disk.



Note - For the 6140 array, this command is only supported with firmware version 07.xx.xx.xx.


Options

-a,--array <array-name>

Specifies the array associated with this virtual disk.

-d,--disks <disk-name[,disk-name...]>

Specifies particular disks to be added to the virtual disk.

-n,--number-of-disks <integer>

Specifies the number of disks to be added to the virtual disk.

-p,--pool <pool-name>

Specifies the storage pool associated with this virtual disk.

-S,--secure

Specifies to create a secure virtual disk.

vdisk <virtual-disk-name>

Specifies the virtual disk that you want to modify.

Examples

sscs create -a array00 vdisk vdisk1


create volume

Creates a volume within a specified pool.

Synopsis

create -a <array-name> -p <pool-name> -F [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> [-n <1..30>] [-d <disk-name[,disk-name...]>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> -C <integer> [-n <1..224>] [-d <disk-name[,disk-name...]>] [-f <volume|snapshot>] [-w <0..100>] [-V <virtual-disk-name>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> -C <integer> [-n <1..30>] [-d <disk-name[,disk-name...]>] [-f <volume|snapshot>] [-w <0..100>] [-V <virtual-disk-name>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> [-v <virtual-disk-name>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>|max> [-v <virtual-disk-name>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> [-n <1..224>] [-d <disk-name[,disk-name...]>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -F [-v <virtual-disk-name>] [-d <disk-name[,disk-name...]>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>|max> [-v <virtual-disk-name>] [-d <disk-name[,disk-name...]>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -C <integer> -Z <number<TB|GB|MB|KB|Bytes|BLK>> [-v <virtual-disk-name>] [-d <disk-name[,disk-name...]>] [-f <volume|snapshot>] [-w <0..100>] [-V <virtual-disk-name>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> -C <integer> -F [-d <disk-name[,disk-name...]>] [-f <volume|snapshot>] [-w <0..100>] [-V <virtual-disk-name>] [-c <A|B>] volume <volume-name>
create -a <array-name> -p <pool-name> -F [-c <A|B>] [-S] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> [-n <1..224>] [-d <disk-name[,disk-name...]>] [-c <A|B>] [-S] volume <volume-name>
create -a <array-name> -p <pool-name> -s <number<TB|GB|MB|KB|Bytes|BLK>> -C <integer> [-n <1..224>] [-d <disk-name[,disk-name...]>] [-f <volume|snapshot>] [-w <0..100>] [-V <virtual-disk-name>] [-c <A|B>] [-S] volume <volume-name>

Description

Creates a volume within a specified pool. You can have up to 2048 volumes per array.

Options

-a,--array <array-name>

Specifies the array. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-C,--snapshot-count <integer>

Specifies the number of intended snapshots for the volume.

-c,--controller <A|B>

Specifies the controller.

-d,--disk <disk-name[,disk-name...]>

Specifies the name of the disk. You can use this option with either the -n option or the -v option, but not with both -n and -v at the same time.

-F,--fill-vdisk

Specifies to use all available space on a virtual disk when creating a new volume and virtual disk simultaneously. This creates the largest possible virtual disk that matches the attributes of the specified pool. NOTE: See the -s,--size option (with max value) to use all available space on an existing virtual disk.

-f,--favor <volume|snapshot>

Favors the volume or snapshot.

-L,--snapshot-level <low|verylittle|little|average|high|full>

Specifies the level of snapshot activity. The snapshot levels equate to the following percentages:

low - 10%

verylittle - 25%

little - 40%

average - 50%

high - 75%

full - 100%

-l,--snapshot-percentage <0..100>

Specifies what percentage of the volume is to be used for snapshot creation.

-n,--number-of-disks <1..30> or <1..224>

Specifies the number of disks in the volume. You can use this option with either the -d option or the -v option, but not with both -d and -v at the same time. Number-of-disks <1..30> is used in combination with a RAID level set at 3, 5, and 6. Number-of-disks <1..224> is used in combination with a RAID level set at 0 or 1.

-P,--snapshot-pool <pool-name>

Specifies the name of the snapshot.

-p,--pool <pool-name>

Specifies the name of the snapshot pool.

-S,--secure

Specifies to create a secure volume.

-s,--size <number<TB|GB|MB|KB|Bytes|BLK>> or <number<TB|GB|MB|KB|Bytes|BLK>|max>

Specifies the volume size. Sizes can be in terabytes, gigabytes, megabytes, kilobytes, bytes, or blocks. However, some command variants allow use of the max value to specify using all available space on an existing virtual disk. NOTE: See the -F,--fill-vdisk option to use all available space on a virtual disk when creating a new volume and vdisk simultaneously.

-V,--reserve-vdisk <virtual-disk-name>

Specifies a reserve virtual disk.

-v,--vdisk <virtual-disk-name>

Specifies the name of the virtual disk. You can use this option with either the -d option or the -n option, but not with both -d and -n at the same time.

-w,--warning-threshold <0..100>

Specifies when to inform you that the snapshot reserve volume is near capacity. If a warning-threshold is not specified, 50% is the default.

-Z,--snapshot-reserve-size <number<TB|GB|MB|KB|Bytes|BLK>>

Specifies the amount of space you want to reserve for capacity of the snapshot reserve volume.

volume <volume-name>

Specifies the volume name of up to 16 alphanumeric characters.

Examples

sscs create -a array01 -p pool1 -s 20GB volume ORACLE-1


create volume-copy

Creates a copy of the volume.

Synopsis

create -a <array-name> -s <source-volume-name> -t <target-volume-name> [ -p lowest | low | medium | high | highest ] volume-copy

Description

Creates a copy of the volume.

-a,--array <array-name>

Specifies the array associated with this volume.

-p,--priority lowest | low | medium | high | highest

Specifies the priority of this volume copy. If no priority is specified, the default is medium.

-s,--source-volume <volume-name>

Specifies the source volume name associated with this volume copy.

-t,--target-volume <volume-name>

Specifies the target volume name associated with this volume copy.

Examples

sscs create -a array00 -s vol01 -t vol02 volume-copy


delete host

Deletes one or more hosts.

Synopsis

delete -a <array-name> host <host-name,...>

Description

Deletes one or more hosts.

Options

-a,--array <array-name>

Specifies the array associated with this host. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

host <host-name,...>

Specifies the host or hosts to delete.

Examples

sscs delete -a array00 host host01


delete hostgroup

Deletes one or more host groups.

Synopsis

delete -a <array-name> hostgroup <host-group-name,...>

Description

Deletes one or more host groups.

Options

-a,--array <array-name> 

Specifies the array associated with this host group.

hostgroup <host-group-name,...>

Specifies the host group or host groups to delete.

Examples

sscs delete -a array00 hostgroup hg01


delete initiator

Deletes one or more initiators.

Synopsis

delete -a <array-name> [-T <iqn|initiator_name>] initiator <initiator-id[,initiator-id...]>

Deletes an iSCSI initiator.

delete -a <array-name> [-T <wwn|initiator_name>] initiator <initiator-id[,initiator-id...]>

Deletes a FC initiator.

Description

Deletes one or more initiators. The initiator or initiators must be unmapped or the command will fail.

Options

-a,--array <array-name>

Specifies the array associated with this initiator or initiators. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-T,--name-type <<iqn|initiator_name>|<wwn|initiator_name>>

Specifies the initiator identifier type. For the iSCSI variant, specify iqn for an iSCSI qualified name (IQN) or initiator_name for a named initiator. For the FC variant, specify wwn for a World Wide Name or initiator_name for a named initiator. You can modify the WWN if the initiator is offline only.

initiator <initiator-id[,initiator-id...]>

Specifies the initiator identifier.

Examples

sscs delete -a array00 initiator myInitiator-01,myInitiator-02


delete iscsi-session

Deletes an iscsi-session.

Synopsis

delete -a <array-name> iscsi-session <session-identifier[,session-identifier...]>

Description

Deletes iSCSI sessions associated with a specified array.

Options

-a,--array <array-name>

Specifies the name of the array.

iscsi-session <session-identifier[,session-identifier...]>

Specifies one or more iSCSI sessions to delete.

Examples

sscs delete --array iSCSILCA2 iscsi-session 40:00:01:37:00:05:8

Deletes iSCSI session 40:00:01:37:00:05:8 for array iSCSILCA2.


delete pool

Deletes one or more pools.

Synopsis

delete -a <array-name> pool <pool-name[,pool-name...]>

Description

Deletes one or more storage pools. This operation removes all associated virtual disks and volumes during the deletion of the storage pool. You can perform this action only when all volumes in the pool are unmapped.

Options

-a,--array <array-name>

Specifies the array associated with this pool. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

pool <pool-name[,pool-name...]>

Specifies the storage pool or list of pools to delete.

Examples

sscs delete -a array00 pool SP048763


delete profile

Deletes one or more profiles.

Synopsis

delete -a <array-name> profile <profile-name[,profile-name...]>

Description

Deletes one or more storage profiles. You can only perform this function on a storage profile that has no storage pools associated with it.

Options

-a,--array <array-name>

Specifies the array associated with this profile.

profile <profile-name[,profile-name...]>

Specifies the profile or profiles to delete.

Examples

sscs delete -a array00 profile MyProfile


delete repset

Deletes one or more replication sets.

Synopsis

delete -a <array-name> repset <repset-name[,repset-name...]>

Description

Deletes one or more replication sets.

Options

-a,--array <array-name>

Specifies the array from which you want to delete the replication set. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

repset <repset-name[,repset-name...]> 

Specifies the replication set or sets to delete.

Examples

sscs delete -a corporate repset finance/1

Deletes the replication of the finance volume on the array named corporate.

sscs delete -a corp_west repset crm-sales/1

Deletes the replication of the crm-sales volume on the array named corp_west.


delete snapshot

Deletes one or more snapshots.

Synopsis

delete -a <array-name> snapshot <snapshot-name[,snapshot-name...]>

Description

Deletes the specified snapshot.

Options

-a,--array <array-name>

Specifies the array associated with this snapshot. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

snapshot <snapshot-name[,snapshot-name...]>

Specifies the snapshot or snapshots to delete.

Examples

sscs delete -a array00 snapshot snap1


delete vdisk

Deletes one or more named virtual disks.

Synopsis

delete -a <array-name> vdisk <virtual-disk-name[,virtual-disk-name...]>

Description

Deletes one or more specified virtual disks.

Options

-a,--array <array-name>

Specifies the array associated with this virtual disk. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

vdisk <virtual-disk-name[,virtual-disk-name...]>

Specifies the vdisk or vdisks to delete.

Examples

sscs delete -a array00 vdisk vdisk1


delete volume

Deletes one or more named volumes.

Synopsis

delete -a <array-name> [-k] volume <volume-name[,volume-name...]>

Description

Deletes one or more named volumes. The volume must be unmapped or the deletion fails.

Options

-a,--array <array-name>

Specifies the array associated with this volumes. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-k,--keep-vdisk

Specifies to keep the associated virtual disk intact. By default, if the volume targeted for deletion is the last volume on the associated virtual disk, the virtual disk is deleted.



Note - The -k option is only supported by 2500 series arrays running firmware version 07.35.nn.nn and above, and 6000 series arrays running firmware version 07.10.nn.nn and above.


volume <volume-name[,volume-name...]>

Specifies the volume or volumes to delete.

Examples

sscs delete -a array00 volume ORACLE-1


delete volume-copy

Deletes a volume-copy.

Synopsis

delete -a <array-name> -s <source-volume-name> -t <target-volume-name> volume-copy

Description

Deletes a volume copy. This operation breaks the copy relationship between the two volumes, but it does not delete the volumes themselves. It also removes the read-only permission on the target volume.

Options

-a,--array <array-name> 

Specifies the array associated with this volume copy.

-s,--source-volume <volume-name>

Specifies the source volume associated with this volume copy.

-t,--target-volume <volume-name>

Specifies the target volume associated with this volume copy.

Examples

sscs delete -a array00 -s vol01 -t vol02 volume-copy

 


disable snapshot

Disables one or more snapshots.

Synopsis

disable -a <array-name> snapshot <snapshot-name[,snapshot-name...]>

Description

Disables one or more snapshots. Disabling a volume snapshot does not remove either the volume snapshot or its associated reserve volume.

When you disable a volume snapshot, only the specified snapshots are disabled. All other snapshots remain functional.

Options

-a,--array <array-name>

Specifies the array associated with this snapshot.

snapshot <snapshot-name,...>

Specifies the names of the snapshots that you want to resnap.

Examples

sscs disable -a array00 snapshot snapshot1, snapshot2

Disables snapshot1 and snapshot2 on array00.

 


export array

Prints the array configuration to standard output.

Synopsis

export [-L] array <array-name>

Description

Prints the array configuration to standard output (XML format). To save the output to a file, the output must be redirected to a specified file name. That file can then be used for the import array command. See example usage below for proper redirect syntax.

Options

-L,--lock-key

Specifies to retrieve the current encryption key from the specified array. The command will prompt you for the encryption key pass phrase. To ensure accuracy, you will be prompted to enter the pass phrase twice. For security, the supplied pass phrase will not be echoed back to you. If the -L option is not supplied, the array configuration is exported.

array <array-name> 

Specifies the array that you want to export.

Examples

Export array information to the screen:

sscs export array array01

Export array information to an XML file saved to the sscs working directory:

sscs export array array01 > array01-config.xml

Export array information to an XML file saved to a specified location:

sscs export array array02 > D:\temp\array02-config.xml
sscs export array array02 > /var/tmp/array02-config.xml


export profile

Exports one or more profiles into an XML representation.

Synopsis

export -a <array-name> profile [profile-name[,profile-name...]]

Description

Exports one or more profiles into an XML representation. This outputs to standard output, and then you redirect it to a file or another mechanism.

Options

-a,--array <array-name> 

Specifies the array from which you want to export the profile.

profile [profile-name[,profile-name...]] 

Specifies the profile or profiles to export. If no profiles are specified, all profiles are exported.

Examples

sscs export - a array00 profile > /tmp/all_profiles.xml

 


fail disk

Sets a disk to the failed state.

Synopsis

fail -a <array-name> [ -t <tray-name> ] disk <disk-name>

Description

Sets a disk to the failed state. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.

Options

-a,--array <array-name>

Specifies the array on which you want to fail the disk.

-t,--tray <tray-name>

Identifies the tray where the disk resides.

disk

Specifies the name of the disk.

Examples

sscs fail -a Array01 -t Tray20 disk t20d16
sscs fail -a Array01 disk t20d16

 


import array

Applies an array configuration file to the specified array.

Synopsis

import -x <XML-location> [-L] [-n] array <array-name>

Description

Applies an array configuration file to the specified array. This enables you to import the configuration file from one array to overwrite the configuration for this array.

Options

-x,--xml <XML-location> 

Specifies the location of the XML file to be imported. The XML location can be in the form of a url (http://... or file:///...) or a file name.

-L,--list

Specifies that no import take place. Instead, the array is checked against the XML file to ensure that it is compatible.

-n,--noclear

Specifies that the current array configuration will not be cleared. This preserves the current array configuration, including the mapping between the access LUN (LUN 31) and the management host. This mapping is required for in-band management of the array.

array <array-name> 

Specifies the array to which the configuration file is applied.

Examples

sscs import -x array01-config.xml array array01
sscs import -x file:///tmp/array00_configuration.xml array array00
sscs import -x /tmp/array00_configuration.xml array array00


import profile

Imports one or more profiles from a specified XML file.

Synopsis

import -a <array-name> -x <XML-location> [-f] profile [profile-name[,profile-name...]]
import -a <array-name> -x <XML-location> -L profile [profile-name[,profile-name...]]

Description

Imports one or more profiles from a specified XML file. This allows you to import the configuration profile from one array to overwrite the configuration profile for this array.

Options

array <array-name> 

Specifies the array to which you want to import the profile.

-x,--xml <XML-location>

Specifies the location of an XML file containing the profiles to be imported. The XML location can be in the form of a URL (http://... or file:///...) or a file name.

-f,--force

Specifies the following actions when conflicts occur with the profiles:

Exists - Profiles are not imported.

Duplicate Settings - Profiles are imported, creating a new profile.

Conflicting - Profiles are imported, replacing the current profile of the same name.

In Use - Profiles are not imported.

New - Profiles are imported.

If the force option is not specified, the following occurs:

Exists - Profiles are not imported.

Duplicate Settings - Profiles are not imported.

Conflicting - Profiles are not imported.

In Use - Profiles are not imported.

New - Profiles are imported.

In all cases, both successful and failed imports are reported.

-L,--list

Lists all profiles. If the list option is specified, no import takes place. All profiles in the XML file (or all those specified by way of the <profile-name>) are listed, and each is identified as follows:

Exists - The profile already exists with all of the same parameter values.

Duplicate Settings - A profile with exactly the same parameters (the description and version can be different), but a different name exists, and no profile with the given name is in use by the system.

Conflicting - A profile with the same name exists, has different parameters, and is not currently in use by the system.

In Use - A profile with the same name exists, has different parameters, and is currently in use by the system.

New - None of the above labels apply.

profile [profile-name[,profile-name...]] 

Specifies the profile or profiles to import. If no profile names are specified, all profiles in the given XML location are used.

Examples

sscs import -a array00 -f -x file:///tmp/all_profiles.xml profile
Response Format

(when --list option is used)

profile_name: Exists
profile_name: Duplicate Settings
profile_name: New
profile_name: Conflicting

 


initialize disk

Initializes a disk.

Synopsis

initialize -a <array-name> [-t <tray-name>] disk <disk-name>

Description

Initializes a disk. If a disk from another array is inserted, and you want to use it in a different array, you might need to initialize it to remove any latent virtual disk information. All data on the disk will be lost. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.

Options

-a,--array <array-name>

Specifies the array on which you want to initialize the disk.

-t,--tray <tray-name>

Identifies the tray where the disk resides.

disk <disk-name>

Specifies the name of the disk.

Examples

sscs initialize -a Array01 -t Tray2 disk Disk6

 


list controller

Lists configuration information for the specified controller.

Synopsis

list -a <array-name> controller [ A | B ]

Description

Lists configuration information for the specified controller.

Options

-a,--array <array-name> 

Specifies the array for which you want to view controller information.

controller A | B 

Specifies the controller for which you want to view information. If no controller is specified, summary information for both controllers is displayed.

Examples

sscs list -a array01 controller
Response Format
Controller: A | B 
Mode: Active | Inactive 
Quiesced: True | False 
Status: Removed | Optimal | RPA Par Error | Failed | Service Mode 
Drive Interface: FC | SATA | SAS | SSD
Cache Memory Size: n MB 
Manufacturer: manufacturer 
Serial Number: serial-number 
Ethernet Port: 1     
    Use DHCP/BOOTP:   On | Off
    IP Address: IP-address
    Gateway: IP-address
    Net Mask: net-mask


list fcport

Lists Fibre Channel port information for the controller of the specified array.

Synopsis

list -a <array-name> [-c <A|B>] fcport [fcport-id[,fcport-id...]]

Description

Lists Fibre Channel (FC) port information for the controller of the specified array.

Options

-a,--array <array-name>

Specifies the name of the array where the controller resides.

-c,--controller <A|B>

Specifies the controller for which you want Fibre Channel port information.

fcport [fcport-id[,fcport-id...]]

Specifies the Fibre Channel port or ports for which you want information. Ports are specified as A/1 to A/4 and B/1 to B/4. If no FC port is specified, details for all ports are displayed.

Examples

sscs list -a array00 fcport A/1

Response Format

Array: array-name

Controller: A | B

FCPort: fcport-ID

Port WWN: port-WWN

Node WWN: node-WWN

Topology: ARB Loop | Fabric | PTP | FAB Loop | Unknown

Speed: current-speed Gb/s (Gigabits per second)

Maximum Speed: maximum-speed Gb/s

Loop ID: 0..127 | N/A | Any

Preferred Loop ID: 0..127 | N/A | Any

Channel Number: channel-number

Channel Joined With Another: True | False

Link Status: Up | Down


list host

Lists the host names and details for an individual host.

Synopsis

list -a <array-name> host [host-name[,host-name...]]

Description

Lists the host names and details for an individual host.

Options

-a,--array <array-name>

Specifies the array associated with this host. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

host [host-name[,host-name...]]

Specifies the host or hosts that you want to view in detail. When no host is specified, the names of all the hosts in the array are listed.

Examples

sscs list -a array00 host 

Response Format (when no <host-name> value is specified)

Host: host-name

...

Host: host-name

Response Format (host detail when <host-name> value is specified)

Host: host-name

Host Group: hostgroup-name

Initiator: initiator-name

...

Initiator: initiator-name

Volume: volume-name LUN:LUN-ID

...

Volume: volume-name LUN:LUN-ID


list hostgroup

Lists host group name and hosts for an individual host group.

Synopsis

list -a <array-name> hostgroup [hostgroup-name[,hostgroup-name...]]

Description

Lists host group name and hosts for an individual host group.

Options

-a,--array <array-name>

Specifies the array associated with this host group.

hostgroup [hostgroup-name[,hostgroup-name...]]

Specifies the host group that you want to view. When no host group is specified, the names of all the host groups in the array are listed.

Examples

sscs list -a array00 hostgroup

Response Format (when no <host-group-name> value is specified)

Host Group: host-group-name

...

Host Group: host-group-name

Response Format (host detail when the <host-group-name> value is specified)

Host Group: host-group-name

Host: host-name

...

Host: host-name

Volume: volume-name LUN:LUN-ID

...

Volume: volume-name LUN:LUN-ID


list initiator

Lists the initiators and provides a description of each.

Synopsis

list -a <array-name> [-T <iqn|initiator_name>] initiator [initiator-id[,initiator-id...]]

Lists iSCSI initiators.

list -a <array-name> [-T <wwn|initiator_name>] initiator [initiator-id[,initiator-id...]]

Lists FC initiators.

Description

Lists the initiators and provides a description of each.

Options

-a,--array <array-name>

Specifies the array associated with this initiator. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-T,--name-type <<iqn|initiator_name>|<wwn|initiator_name>>

Specifies the initiator identifier type. For the iSCSI variant, specify iqn for an iSCSI qualified name (IQN) or initiator_name for a named initiator. For the FC variant, specify wwn for a World Wide Name or initiator_name for a named initiator.

initiator [initiator-id[,initiator-id...]]

Specifies the initiator identifier.

Examples

sscs list -a array01 -T initiator_name initiator myInitiator-01
sscs list -a array01 initiator myInitiator-01
sscs list -a iSCSILCA_2 -T iqn initiator
Response Format

(list of initiators when no <initiator-ID> value is specified)

Initiator: initiator-ID
...
Initiator: initiator-ID
Response Format

(detail about the initiator when an <initiator-ID> value is specified)

Initiator: initiator-ID
WWN: initiator-WWN
Host: host-name
OS Type: host-type


list iperformance

Displays iSCSI performance statistics for the StorageTek 2510 array and enables you to define the type of iSCSI performance statistics to monitor.

Synopsis

To display the performance statistics:

list -a <array-name[,array-name...]> -T [-b <true|false>] iperformance

To define the type of iSCSI performance statistics to monitor and the sort order of the output:

list -a <array-name[,array-name...]> -t <array_stats|controller_stats|volume_stats> [-c <A|B>] [-h <host-name[,host-name...]>] [-g <hostgroup-name[,hostgroup-name...]>] [-v <volume-name[,volume-name...]>] [-s <name|total_iops|read_percent|write_percent|total_data|avg_read_size|avg_read_rate|peak_read_rate|avg_write_size|avg_write_rate|peak_write_rate|cache_hit_percent>] [-b <true|false>] iperformance

Description

Displays iSCSI performance statistics for the 2510 array and enables you to define the type of iSCSI performance statistics to monitor and the sort order of the output.



Note - Only valid for 2510 arrays running firmware version 07.35.nn.nn or higher.


Options

-a,--array <array-name>

Specifies the name of the array associated with this iSCSI performance request.

-b,--baseline <true|false>

Sets the baseline time for the iSCSI array. If true, the current array time is used as the baseline time.

-t,--type <array_stats|controller_stats|volume_stats>

Specifies the type of statistics to list: array, controller, or volume.

-c,--controller <A|B>

Specifies controller A or controller B.

-h,--host <host-name[,host-name...]>

Specifies the host name of one or more hosts.

-g,--hostgroup <hostgroup-name[,hostgroup-name...]>

Specifies the name of one or more host groups.

-v,--volume <volume-name[,volume-name...]>

Specifies one or more volumes.

-s,--sort <name|total_iops|read_percent|write_percent|total_data|avg_read_size|avg_read_rate|peak_read_rate|avg_write_size|avg_write_rate|peak_write_rate|cache_hit_percent> 

Specifies the value for sorting the performance output.

Examples

Display Statistics:

sscs list -a iSCSILCA_2 -T iperformance
Response Format
Array: iSCSILCA_2
State: Off
Polling Interval: 1 minute
Data Retention Period: 1 hour
BASELINE STATISTICS
Controller A Baseline Time: date at time
Controller B Baseline Time: date at time
MAC Transmit Statistics
MAC Receive Statistics
TCP Statistics
IPv4 Statistics
IPv6 Statistics
Target (Protocol) Statistics

 

Define statistics to display:

sscs list --array iSCSILCA_2 --type array_stats --sort total_iops iperformance 

List array statistics for iSCSILCA_2 and sort by total I/O operations per second.


list iscsi-port

Lists iSCSI ports.

Synopsis

list -a <array-name> [-c <A|B>] iscsi-port [display.name.iscsiport-id[,display.name.iscsiport-id...]]

Description

Lists information for one or more iSCSI ports configured for a specified array.

Options

-a,--array <array-name>

Specifies the name of the array.

-c,--controller <A|B>

Specifies controller A or B for which you want information.

iscsi-port [display.name.iscsiport-id[,display.name.iscsiport-id...]]

Specifies one or more iSCSI port IDs. For a detailed listing, specify controller/port.

Examples

sscs list --array iSCSILCA_2 iscsi-port B/1

Lists detail for iSCSI port 1 on controller B for array iSCSILCA_2.

Response Format
    Array: iSCSILCA_2
    Controller: A
    iSCSI Port: B/1
    Port MAC: 00:A0:B8:20:34:69
    Speed: 100 Mbps
    Maximum Speed: 1 Gbps
    Link Status: Up
    Listening Port: 3260
    MTU: 1500
    ICMP Ping Responses: Enabled
    IPv4: Enabled
    DHCP: Off
    IP Address: 10.8.88.167
    Gateway: 10.8.88.1
    Netmask: 255.255.255.0
    VLAN: Disabled
    VLAN ID: 0
    Ethernet Priority: Disabled
    Priority: 3


list iscsi-session

Lists iSCSI sessions.

Synopsis

list -a <array-name> iscsi-session [session-identifier[,session-identifier...]]

Description

Lists iSCSI sessions associated with a specified array. To list details of a specific iSCSI session, include the iSCSI session ID.

Options

-a,--array <array-name>

Specifies the name of the array.

iscsi-session 	[session-identifier[,session-identifier...]]

Specifies the iSCSI session ID.

Examples

sscs list -a iSCSILCA_2 iscsi-session 40:00:01:37:00:00:8003
Response Format
iSCSI Session
iSCSI Target: iqn.1992-01.com.lsi:1535.600a0b80003487c10000000046cc4a1d
iSCSI Session Identifier (SSID): 40:00:01:37:00:00:8003
Initiator Session Identifier (ISID):  40:00:01:37:00:00
Target Portal Group Tag: 2
Initiator iSCSI Name: iqn.1991-05.com.microsoft:funk.sun.com
Initiator iSCSI Label: i1193868006
Initiator iSCSI Alias: fi1193868006
Host: fh1193262432
iSCSI Session Connection ID(s)          
Connection ID (CID): 0x1
Ethernet Port: Controller B, Port 2
Initiator IP Address: 10.8.88.103
Negotiated Login Parameters             
Authentication Method: None
Header Digest Method: None
Data Digest Method: None
Maximum Connections: 4
Target Alias: iSCSI_LCA2
Initiator Alias: fi1193868006
Target IP Address: 10.8.88.175
Target Portal Group Tag: 2
Initial R2T: Yes
Maximum Burst Length: 262144 Bytes
First Burst Length: 8192 Bytes
Default Time to Wait: 0 Seconds
Default Time to Retain: 60 Seconds
Maximum Outstanding R2T: 16
Error Recovery Level: 0
Maximum Receive Data Segment Length: 65536 Bytes


list iscsi-target

Lists iSCSI targets.

Synopsis

list -a <array-name> iscsi-target [target-name]

Description

Lists iSCSI target name configured for the specified array. To list details, specify the iSCSI target name. Target name is the iSCSI qualified name (IQN), for example: iqn.199201.com.sun:1535.600a0b80002f9da000000000461255f9.

Options

-a,--array <array-name>

Specifies the name of the array.

iscsi-target [target-name]

Specifies the iSCSI qualified name of the iSCSI target.

Examples

sscs list --array iSCSILCA_2 iscsi-target 
Response Format
iSCSI Target Name:  iqn.1992-01.com.sun:1535.600a0b80003487c10000000046cc4a1d
sscs list --array iSCSILCA_2 iscsi-target iqn.1992-01.com.sun:1535.600a0b80003487c10000000046cc4a1d
Response Format
iSCSI Target Name:   iqn.1992-01.com.lsi:1535.600a0b80003487c10000000046cc4a1d
 Alias: iSCSI_LCA2
 Authentication: NONE
 CHAP Secret: *****
 Unnamed Discovery:  Enabled
 Sessions: 1
 iSNS: Enabled
  IPv4: 10.8.88.56
  DHCP: Off
  Port: 3205
 Initiators
  server1: iqn.1991-05.com.microsoft:sun-pojdhrbx7tt
  server2: iqn.1991-05.com.sun.microsoft.jcz
  server3: iqn.1991-05.com.microsoft:sun-pojdhrbx7rr
  server4: iqn.1986-03.com.sun:01:0003ba3145ed.47032ecf
  server5: iqn.1986-03.com.sun:01:00144f010116.46fa5d9a
  server6: iqn.1986-03.com.sun:01:0003ba0442dd.47062a0f
  server7: iqn.1991-05.com.microsoft:sun-pojdhrbx7qq
  server8: iqn.2001-04.com.example.storage.tape:sys1.xyz
  server9: iqn.1991-05.com.microsoft:funk.sun.com
  server10: iqn.1991-05.com.microsoft:jim.bur.sun.com
  server11: iqn.1991-05.com.microsoft:parash.india.sun.com
  server12: iqn.1991-05.com.microsoft:pookawinxp
  server13: iqn.1991-05.com.microsoft:nms-lab8


list license

Shows all licenses that are associated with the array, and related licensing details.

Synopsis

list -a <array-name> license [license-name[,license-name...]]

Description

Shows all licenses that are associated with the array, along with related licensing details (serial number, controller serial number, and further details).

-a,--array <array-name>

Specifies the array associated with this license.

license [license-name[,license-name...]]

Specifies the name of a license or licenses. If you list specific licenses, then only the details of those licenses are shown.

Examples

sscs list -a corporate license

Lists all of the licenses on the corporate array.

sscs list -a corp_west license ReplicationSet

Lists the details of the replication set license on the corp_west array.

Response Format

(when no <license-name> values are specified)

Array: array-name
WWN: World-Wide-name
Serial Number: serial-number
Featured Enable Identifier: identifier
License: license-name
Description: description
Status: Enabled | Disabled
Quantity Licensed: quantity
Quantity Used: quantity
Response Format

(when <license-name> values are specified)

Array: array-name
WWN: World-Wide-name
Serial Number: serial-number
Featured Enable Identifier: identifier
License: license-name
Description: description
Status: enabled | disabled
Quantity Licensed: quantity
Quantity Used: quantity
Replication License Status: Activated | Deactivated 
Repository Volume: replication-repository-name Size: number-of-megabytes Vdisk: virtual-disk-identifier
Licensed Items Sample Formats:
Snapshot:
  Licensed Items:
      Base Volume:vol_b13 Snapshot Volume:new-snap
      Base Volume:dk_rep3 Snapshot Volume:dk_snap1
StorageDomain:
  Licensed Items:
      Host Group: t_hostgroup_2
      Host: MIG-1
VolumeCopy
  Licensed Items:
      Source Volume:dk_rep1 Target Volume:dk_rep2
      Source Volume:dk_vol3 Target Volume:dk_rep4


list mapping

Lists mappings for the array.

Synopsis

list -a <array-name> mapping [DefaultStorageDomain|host-name|hostgroup-name[,DefaultStorageDomain|host-name|hostgroup-name...]]

Description

Lists mappings for the array. You can filter the output by specifying DefaultStorageDomain, a host name, or a host group name.

Options

-a,--array <array-name>

Specifies the array for which to list mappings.

mapping [DefaultStorageDomain|host-name|hostgroup-name[,DefaultStorageDomain|host-name|hostgroup-name...]]

Lists all mappings for the specified array. Optionally, filters the output based on DefaultStorageDomain, a host name, or host group name.

Examples

List all mappings for a specified array:

sscs list -a array1 mapping
Volume:PIVol1  LUN: 0  Mapped To: cam-oel  Target Type: Host  Permission: Read/Write
Volume:PIVol2  LUN: 0  Mapped To: qlhosts  Target Type: Host Group  Permission: Read/Write
Volume:PIVol3  LUN: 0  Mapped To: Default Storage Domain  Target Type: Default Storage Domain  Permission: Read/Write

List mappings filtered by host or hostgroup name:

sscs list -a array1 mapping cam-oel
Volume:PIVol1  LUN: 0  Mapped To: cam-oel  Target Type: Host  Permission: Read/Write

List mapping to the default domain:

sscs list -a array1 mapping DefaultStorageDomain
Volume:PIVol3  LUN: 0  Mapped To: Default Storage Domain  Target Type: Default Storage Domain  Permission: Read/Write


list os-type

Shows the operating system types on this array.

Synopsis

list -a <array-name> os-type

Description

Shows all of the operating systems that are supported by the array. The values returned can be used in subsequent requests to create or modify initiators, or to modify the default host type of the array.

Options

-a,--array <array-name>

Shows the array name.

os-type

Shows all of the operating systems that are supported by the array.

Examples

sscs list -a testarray os-type
 
SOLARIS_MPXIO - Solaris (with Traffic Manager)
SOLAVT - Solaris (with Veritas DMP or other)
SOLTPGS - Solaris Target Port Group Support
W2KNETNCL - Windows 2000/Server 2003 non-clustered
W2KNETCL - Windows 2000/Server 2003 clustered
W2KNETNCLDMP - Windows 2000/Server 2003 non-clustered (with Veritas DMP)
W2KNETCLDMP - Windows 2000/Server 2003 clustered (with Veritas DMP)
AIX - AIX
AIXAVT - AIX (with Veritas DMP)
AIX_FO - AIX failover (6xxx)
IBM_TS_SAN_VCE
HPX - HPUX
IRX - Irix
LNX - Linux
LNXAVT - Linux (with Veritas DMP)
NWRFO - Netware failover
VMWARE - VMware
HPXTPGS - HPUX Target Port Group Support


list performance

Shows detailed performance statistics.

Synopsis

list -a <array-name[,array-name...]> -T performance
list -a <array-name[,array-name...]> -t <array_stats|controller_stats|volume_stats> [-c <A|B>] [-h <host-name[,host-name...]>] [-g <hostgroup-name[,hostgroup-name...]>] [-v <volume-name[,volume-name...]>] [-s <name|total_iops|read_percent|write_percent|total_data|avg_read_size|avg_read_rate|peak_read_rate|avg_write_size|avg_write_rate|peak_write_rate|cache_hit_percent>] performance

Description

Shows detailed performance statistics. You can use the following options only if a single array is specified:

--controller, --volume, --host, and --hostgroup


Note - When using the local CLI sscs command, performance monitoring must be enabled before executing the list performance subcommand. Performance monitoring is turned on via the modify performance subcommand. See modify performance for further information.


Options

-a,--array <array-name>

Specifies the array or arrays associated with this performance request.

-T,--settings

Shows the current settings for the array, including state, polling interval, and data retention period. If this option is specified, all other options (except array) are ignored.

-t,--type <array_stats|controller_stats|volume_stats>

Specifies the type of statistics to list: array, controller, or volume.

-c,--controller <A|B>

Specifies the controller name.

-v,--volume <volume-name[,volume-name...]>

Specifies the volume name or volume names associated with this performance request.

-h,--host <host-name[,host-name...]>

Specifies the host name or host names associated with this volume.

-g,--hostgroup <hostgroup-name[,hostgroup-name...]>

Specifies the host group or host groups associated with this volume.

-s,--sort <name|total_iops|read_percent|write_percent|total_data|avg_read_size|avg_read_rate|peak_read_rate|avg_write_size|avg_write_rate|peak_write_rate|cache_hit_percent>

Specifies the sorting mechanism.

performance

Specifies the performance subcommand.

Examples

Response Format

(if settings are specified)

Array: array-name
State: on | off
Polling Interval: 1 minute | 5 minutes | 15 minutes
Data Retention Period: forever | 1 hour | 2 hours | 4 hours | 1 day
Response Format
NAME TOT IOPS READ % WRITE% TOT DATA AVG R SIZE AVG R /s PEAK R /s ....
==== ======== ====== ====== ======== ========== ======== ========= 
vol1      0.0   0.00   0.00      0.0        0.0      0.0       0.0 
...
vol2      3.6   7.32  34.77   1030.3       32.7      4.5      10.4


list pool

Lists storage pool information.

Synopsis

list -a <array-name> pool [pool-name[,pool-name...]]

Description

Lists storage pool information.

Options

-a,--array <array-name>

Specifies the array associated with this pool. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

pool [pool-name[,pool-name...]]

Specifies the pool or pools for which you want detailed information. If no pools are specified, this subcommand lists summary information for all pools.

Examples

sscs list -a array01 pool SP048763
Response Format

(summary of all pools when no <pool-name> value is specified)

Pool: pool-name Profile: profile-name Configured Capacity: capacity
....
Pool: pool-name Profile: profile-name Configured Capacity: capacity
Response Format

(detail of a pool when a <pool-name> value is specified)

Pool: pool-name
Description: description
Profile: profile-name
Total Capacity: capacity MB | GB | TB
Configured Capacity: capacity MB | GB | TB
Available Capacity: capacity MB | GB | TB
  Volume: volume-name1
  Volume: volume-name2


list profile

Lists the named storage profiles.

Synopsis

list -a <array-name> profile [profile-name[,profile-name...]]

Description

Lists the named storage profiles.

Options

-a,--array <array-name>

Specifies the array associated with this profile.

profile [profile-name[,profile-name...]]

Specifies the profile or profiles for which you want detailed information. If no profiles are specified, this subcommand lists summary information for all profiles.

Examples

sscs list -a array00 profile MyProfile
Response Format

(summary of all profiles when no <profile-name> value is specified)

Profile: profile-name
...
Profile: profile-name
Response Format

(detail of a profile when a <profile-name> value is specified)

Profile: profile-name
Profile in Use: yes | no
Factory Profile: yes | no
Description: profile-description
RAID Level: 0 | 1 | 3 | 5 | 6
Segment Size: 8 KB | 16 KB | 32 KB | 64KB | 256KB
Read Ahead: on | off
Optimal Number of Drives: variable | 2..30
Disk Type: ANY | FC | SATA | SAS | SSD
Pool: pool-name 
....
Pool: pool-name


list repset

Lists replication set information.

Synopsis

list -a <array-name> repset [repset-name[,repset-name...]]

Description

Lists replication set information.

Options

-a,--array <array-name>

Specifies the array from which you want to obtain replication set information. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

repset [repset-name[,repset-name...]]

Specifies the replication set or sets. If you do not specify a replication set, then a summary of all the replication sets on the array is listed.

Examples

sscs list -a corporate repset

Lists all of the repsets on the array named corporate.

sscs list -a corporate repset mail/1

Lists the details of the replication set mail/1 on the array named corporate.

Response Format

(summary of all replication sets when no replication set name is specified)

Replication set: local-volume-name/1 Consistency Group: yes | no Remote volume: remote-vol Replication Peer: replication-peer-name 
...
Replication set: local-volume-name/1 Consistency Group: yes | no Remote volume: remote-vol Replication Peer: replication-peer-name
Response Format

(details when a replication set name is specified)

Replication set: repset-name
Local volume: volume-name 
Synchronization progress: Replicating | Unsynchronized | Synchronization in progress | Suspended | Failed | Not Ready | Failed Suspended 
Role: Primary | Secondary 
Size: size-in-megabytes
Replication Peer: remote-array-name
Replication Peer WWN: remote-array-WWN
Remote Volume: remote-volume-name
Remote Volume WWN: remote-volume-WWN
Mode: Synchronous | Asynchronous
Consistency group: yes | no 
Replication priority: lowest | low | medium | high | highest 
Auto synchronize: Enabled | Disabled


list sasport

Lists SAS port information.

Synopsis

list -a <array-name> [-c <A|B>] sasport [sasport-id[,sasport-id...]]

Description

 

Lists pertinent SAS port information.

Options

-a,--array <array-name>

Specifies the array for which you want to obtain SAS port information.

-c,--controller <A|B> 

Specifies the controller for which you want to view SAS port information. If no controller is specified, summary information for both controllers is displayed.

sasport [sasport-id[,sasport-id...]]

Specifies the SAS port or ports for which you want information. Ports are specified as A/1 to A/4 and B/1 to B/4. If no SAS port is specified, details for all ports are displayed.

Examples

sscs list -a Quartz sasport
Array: Quartz
 Controller:      B
 SAS Port:        B/1
 Port WWN:        50:0A:0B:81:D2:BA:60:04
 Speed:           1 Gb/s
 Maximum Speed:   7 Gb/s
 Channel Number:  1
 Link Status:     Up
 
Array: Quartz
 Controller:      B
 SAS Port:        B/2
 Port WWN:        50:0A:0B:81:D2:BA:60:0C
 Speed:           1 Gb/s
 Maximum Speed:   7 Gb/s
 Channel Number:  2
 Link Status:     Up
 
Array: Quartz
 Controller:      B
 SAS Port:        B/3
 Port WWN:        50:0A:0B:81:D2:BA:60:08
 Speed:           1 Gb/s
 Maximum Speed:   7 Gb/s
 Channel Number:  3
 Link Status:     Up
 
Array: Quartz
 Controller:      A
 SAS Port:        A/1
 Port WWN:        50:0A:0B:81:D2:BB:10:04
 Speed:           1 Gb/s
 Maximum Speed:   7 Gb/s
 Channel Number:  1
 Link Status:     Up
 
Array: Quartz
 Controller:      A
 SAS Port:        A/2
 Port WWN:        50:0A:0B:81:D2:BB:10:0C
 Speed:           1 Gb/s
 Maximum Speed:   7 Gb/s
 Channel Number:  2
 Link Status:     Up
 
Array: Quartz
 Controller:      A
 SAS Port:        A/3
 Port WWN:        50:0A:0B:81:D2:BB:10:08
 Speed:           1 Gb/s
 Maximum Speed:   7 Gb/s
 Channel Number:  3
 Link Status:     Up 


list snapshot

Lists the specified snapshot or snapshots associated with this array.

Synopsis

list -a <array-name> snapshot [snapshot-name[,snapshot-name...]]

Description

Lists the specified snapshot or snapshots associated with this array.

Options

-a,--array <array-name>

Specifies the array associated with this snapshot.

snapshot [snapshot-name[,snapshot-name...]]

Specifies the snapshot or snapshots you want to view. If you do not specify a snapshot, the names of all the snapshots in the array are listed.

Examples

sscs list -a array00 snapshot snap1
Response Format

(when no <snapshot-name> value is specified)

Snapshot: snapshot-name
...
Snapshot: snapshot-name
Response Format

(detailed output if one or more <snapshot-name> values are specified)

Volume: snapshot-volume-name 
Type: snapshot 
WWN: WWN 
Virtual Disk: virtual-disk-name-of-parent-volume
Size: size-of-parent MB
State: state
Status: status
Action: action
Condition: Optimal | Degraded | Failed | Impaired
Controller: A | B
Preferred Controller: A | B 
Modification Priority: lowest | low | medium | high | highest 
Write Cache: Enabled | Disabled
Write Cache With Replication: Enabled | Disabled
Write Cache Without Batteries: Enabled | Disabled
Flush Cache After: time
Disk Scrubbing: Enabled | Disabled
Disk Scrubbing With Redundancy: Enabled | Disabled
Percent Full: 0..100%
Failure Policy: failbasewrite | failsnapshot
Warning Threshold: 0..100
Creation Date: date
Base Volume: base-volume-name
Reserve Volume: reserve-volume-name
Reserve Status: online | offline
Reserve Size: n 
Rollback Status: rollback-status 
Rollback Percent Completion: percent-completion
Rollback Time to Completion: time-to-completion
 

Response Format Notes:

Pools and profiles may be empty, and represented by the symbol '-' (dash).

For a standard volume, this indicates that the current configuration for the volume does not fall into any pool’s defined parameters. For snapshot volumes these values will always be empty.


list tray

Lists information about one or more storage trays in the array.

Synopsis

list -a <array-name> tray [tray-name[,tray-name...]]

Description

Lists information about one or more storage trays in the array.

Options

-a,--array <array-name>

Specifies the array associated with this tray.

tray [tray-name[,tray-name...]]

Specifies the tray ID or tray IDs you want to display. If no tray ID is specified, then the names of all the trays in the array are listed.

Examples

sscs list -a array01 tray 1
Response Format

(summary of all trays when no <tray-ID> value is specified)

Tray: tray-ID
....
Tray: tray-ID
Response Format

(detail of a tray when a <tray-ID> value is specified)

Tray: tray-ID
Array Type: 6140
Role: Drive Module | Controller Module | Unknown 
State: Enabled | Disabled 
Status: OK | ID mismatch | ID conflict | ESM firmware mismatch ESM miswire | minihub speed mismatch | unsupported 
Disk Type: FC | SATA | SAS | SSD
Number of Disks: n


list vdisk

Lists virtual disk (vdisk) or virtual disks information associated with this array.

Synopsis

list -a <array-name> vdisk [virtual-disk-name[,virtual-disk-name...]]

Description

Lists virtual disk (vdisk) or virtual disks information associated with this array.

Options

-a,--array <array-name>

Specifies the array or arrays associated with this virtual disk.

vdisk [virtual-disk-name[,virtual-disk-name...]]

Specifies the virtual disk or disks you want to show. If no virtual disk names are specified, all virtual disk names are listed.

Examples

sscs list -a array01 vdisk 1

Response Format (summary of all vdisks when no <virtual-disk-name> value is specified)

VDisk: virtual-disk-name

....

VDisk: virtual-disk-name

Response Format (detail of a vdisk when a <virtual-disk-name> value is specified)

Virtual Disk: virtual-disk-name

Status: Optimal | Degraded | Failed | Impaired

State: State (Ready, Degraded, etc.)

Number of Disks: number-of-disks

RAID Level: 0 | 1 | 3 | 5 | 6

Hot Spare Coverage: Yes | No

Total Capacity: capacity

Configured Capacity: capacity

Available Capacity: capacity

Array Name: array-name

Array Type: array-type

Disk Type: FC | SATA | SAS | SSD

Security: security-status

Maximum Volume Size: size

Associated Disks:

Disk: disk-name

....

Disk: disk-name

Associated Volumes:

Volume: volume-name

....

Volume: volume-name


list volume

Lists volume information.

Synopsis

list -a <array-name> [-p <pool-name>] [-v <virtual-disk-name>] volume [volume-name[,volume-name...]]

Description

Lists volume information.

Options

-a,--array <array-name> 

Specifies the array associated with this volume. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-p,--pool <pool-name> 

Specifies the pool name associated with this volume. If a pool is specified, all volumes in that pool are listed.

-v,--vdisk <virtual-disk-name>

Specifies the virtual-disk associated with this volume.

volume [volume-name[,volume-name...]] 

Specifies the volume name or names associated with this array. If no volumes are specified, a summary of all volumes is listed. Use pool and virtual-disk to display listed volumes.

Examples

sscs list -a array01 -p pool1 volume ORACLE-1

Response Format (summary of all volumes when no <volume-name> value is specified)

Volume: volume-name Type: type Pool: pool-name Profile profile-name

....

Volume: volume-name Type: type Pool: pool-name Profile profile-name

Response Format (detailed output if specified volume is a standard, source, or target volume)

Volume: volume-name

Type: Standard | Source | Target | Replicated

WWN: WWN

Pool: pool-name

Profile: profile-name

Virtual Disk: virtual-disk-name

Size: size

State: Free | Mapped

Status: Online | Offline

Action: current-action

Condition: Optimal | Degraded | Failed | Impaired

Read Only: Yes | No

Controller: A | B

Preferred Controller: A | B

Modification Priority: Lowest | Low | Medium | High | Highest

Write Cache: Enabled | Disabled

Write Cache With Replication: Enabled | Disabled

Write Cache Without Batteries: Enabled | Disabled

Flush Cache After: time

Disk Scrubbing: Enabled | Disabled

Disk Scrubbing With Redundancy: Enabled | Disabled

Security: security-status

Volume Copy Targets:

Target Volume: volume-name

...

Target Volume: volume-name

Snapshot: snapshot-name Creation Time: time Reserve: reserve

...

Snapshot: snapshot-name Creation Time: time Reserve: reserve

Associations:

Host: host-name LUN: LUN-ID Initiator: initiator WWN: WWN Permission: permission

or

Host Group: hostgroup-name LUN: LUN-ID Initiator: initiator WWN: WWN Permission: permission

Response Format Notes:

Pools and profiles can be empty, in which case they are represented by the symbol '-' (dash).

For a standard volume, this indicates that the current configuration for the volume does not fall into any pool’s defined parameters.


list volume-copy

Lists volume-copy information.

Synopsis

list -a <array-name> [-s <volume-name[,volume-name...]>] [-t <volume-name[,volume-name...]>] volume-copy

Description

Lists volume copy information. If neither the source volume nor the target volume is specified, a summary of all volume copies is listed. If the source volume or the target volume is specified, a detailed listing of each is generated.

Options

-a,--array <array-name>

Specifies the array associated with the volumes that you want to list.

-s,--source-volume <volume-name[,volume-name...]>

Specifies the source volume or volumes that you want to list.

-t,--target-volume <volume-name[,volume-name...]>

Specifies the target volume or volumes that you want to list.

Examples

sscs list -a array00 -s vol1,vol3 volume-copy 
Response Format

(summary of all volume copies when no volume copy name is specified)

Source Volume: source-volume-name Target Volume: target-volume-name
...
 Source Volume: source-volume-name Target Volume: target-volume-name
Response Format

(detailed output if a <volume-copy> value is specified)

Volume Copy:
  Source Volume: source-volume-name
  Target Volume: target-volume-name
  Target Read Only: Enabled | Disabled
  Status: In Progress | Completed | Stopped
  Percent Complete: 0...100
  Priority: lowest | low | medium | high | highest
  Copy Start Timestamp: timestamp
  Copy Completion Timestamp: timestamp


map host

Maps one or more volumes to a host.

Synopsis

map -a <array-name> -s <snapshot-name[,snapshot-name...]> [-l <0..255>] host <host-name>
map -a <array-name> -v <volume-name[,volume-name...]> [-l <0..255>] host <host-name>

Description

Maps one or more volumes and snapshots to a host. Any previous mappings for the given volumes and snapshots are removed.

Options

-a,--array <array-name>

Specifies the array associated with this host. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-l,--lun-id <0..255>

Specifies a logical unit number (LUN). A LUN can be specified only when mapping a single volume. If no LUN is specified, as many successive unused LUNs as needed are used, starting with the first available LUN. You can have up to 256 LUNs per host or hostgroup.

-s,--snapshot <snapshot-name[,snapshot-name...]>

Specifies the snapshot volume name or names associated with this host.

-v,--volume <volume-name[,volume-name...]>

Specifies the volume associated with this host.

host <host-name>

Specifies the host that you want to map to the volume.

Examples

sscs map -a array00 -v vol01,vol02 host host01


map hostgroup

Maps one or more volumes to a host group.

Synopsis

map -a <array-name> [-s <snapshot-name[,snapshot-name...]>] [-v <volume-name[,volume-name...]>] [-l <0..255>] hostgroup <hostgroup-name>

Description

Maps one or more volumes and snapshots to a host group. Any previous mappings for the given volumes or snapshots are removed.

Options

-a,--array <array-name>

Specifies the array associated with this host group.

-v,--volume <volume-name[,volume-name...]>

Specifies the volumes to be mapped to this host group.

-s,--snapshot <snapshot-name[,snapshot-name...]>

Specifies the snapshot volumes to be mapped to this host group.

-l,--lun-id <0..255>

Specifies the LUN ID of the initiator that you want to map to this host group. A LUN can be specified only when mapping a single volume. If no LUN is specified, as many successive unused LUNs as necessary are used, starting with the first available unused LUN. You can have up to 256 LUNs per host or hostgroup.

hostgroup <hostgroup-name>

Specifies the host group name.

Examples

sscs map -a array00 -v vol01,vol02 hostgroup hg01


map initiator

Maps one or more initiators to a volume or snapshot.

Synopsis

map -a <array-name> [-v <volume-name[,volume-name...]>] [-s <snapshot-name[,snapshot-name...]>] [-l <0..255>] initiator <initiator-name>

Description

Maps an initiator to a volume or snapshot. Any previous mappings for the given volumes or snapshots are removed.

Options

-a,--array <array-name>

Specifies the array associated with the initiator. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-l,--lun-id <0..255>

Specifies the logical unit number of this initiator. A LUN can be specified only when mapping a single initiator. If no LUN is specified, the first available LUN is used. You can have up to 256 LUNs per host or hostgroup.

-s,--snapshot <snapshot-name[,snapshot-name...]>

Specifies the snapshot volumes to be mapped to this initiator.

-v,--volume <volume-name[,volume-name...]>

Specifies the volumes to be mapped to this initiator.

initiator <initiator-name> 

Specifies the initiator name to which the array is being mapped. If no volume or snapshot is specified, the initiator is mapped into the default partition.

Examples

sscs map -a array00 -v v01 initiator init01


map snapshot

Maps one or more snapshots to a host or host group.

Synopsis

map -a <array-name> [-i <initiator-name>] [-h <host-name>] [-g <hostgroup-name>] [-l <0..255>] snapshot <snapshot-name[,snapshot-name...]>

Description

Maps one or more snapshots to a host or host group. If no host or host group is specified, the snapshot or snapshots are mapped into the Default partition.

Options

-a,--array <array-name>

Specifies the array associated with this snapshot. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-g,--hostgroup <hostgroup-name>

Specifies the host group that you want to map to the snapshots.

-h,--hostname <host-name>

Specifies the host that you want to map to the snapshot.

-i,--initiator <initiator-name>

Specifies the initiator that you want to map to the snapshot.

-l,--lun-id <0..255>

Specifies the logical unit number of this initiator. A LUN can be specified only when mapping a single volume. If no LUN is specified, the first available LUN is used. You can have up to 256 LUNs per host or hostgroup.

snapshot <snapshot-name[,snapshot-name...]> 

Specifies the name or names of the snapshot you want to map. Any previous mappings for the snapshots will be removed.

Examples

sscs map -a array00 -g hg01 snapshot snap1, snap2


map volume

Maps one or more volumes to a host or host group.

Synopsis

map -a <array-name> [-i <host-name>] [-h <host-name>] [-g <hostgroup-name>] [-l <0..255>] volume <volume-name[,volume-name...]>

Description

Maps one or more volumes to a host or host group. Any previous mappings for the given volume or volumes are removed.

Options

-a,--array <array-name>

Specifies the array associated with this volume. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-g,--hostgroup <hostgroup-name>

Specifies the host group name associated with this volume.

-h,--host <host-name>

Specifies the host that you want to map to the volume.

-i,--initiator <host-name>

Specifies the initiator that you want to map to the volume.

-l,--lun-id <0..255>

Specifies the logical unit number of this initiator. A LUN can be specified only when mapping a single volume. If no LUN is specified, the first available LUN is used. You can have up to 256 LUNs per host or hostgroup.

volume <volume-name[,volume-name...]> 

Specifies the volume name to which the array is being mapped.

If no host or host group is specified, the volume or volumes are mapped into the default partition.

Examples

sscs map -a array00 -g hg01 volume vol01,vol02


modify array

Modifies the configuration of the specified array.

Synopsis

modify -N <array-name> array <array-id>
modify [-o <string>] [-s <0..100>] [-S <0..100>] [-k <disable|1..30>] [-f <0..60>] [-h <0..max-supported>] [-T <wwn|array_name>] [-b <4K|8K|16K|32K>] [-N <array-name>] [-p] array <array-id>
modify -R [-T <wwn|array_name>] array <array-id>
modify -c <HHMM|mmddHHMM|mmddHHMM.SS|mmddHHMMyy|mmddHHMMccyy|mmddHHMMccyy.SS> array <array-id>
modify [-L [prefix]] array <array-id>

Description

Modifies the configuration of the specified array.

Options

-b,--cache-block-size <4K|8K|16K|32K>

Specifies the cache block size.

-c,--learn-cycle <HHMM|mmddHHMM|mmddHHMM.SS|mmddHHMMyy|mmddHHMMccyy|mmddHHMMccyy.SS>

Specifies when the next array battery learn cycle will occur:

mmdd

Specifies the month and day. For example, 0331 is March 31.

HHMM

Specifies the hour and minute. The hour is based on a 24-hour clock. For example, 1:30 p.m. is 1330.

cc

Specifies the century part of the year.

yy

Specifies the two-digit year.

.SS

Specifies the seconds of the hour.

During a learn cycle, the battery is discharged and recharged so the controller can determine the current battery capacity. The default learn cycle interval for StorageTek 2500 series arrays is 13 weeks. The default learn cycle interval for Sun Storage 2500-M2, 6180, 6580, and 6780 arrays is 8 weeks.



Note - A complete learn cycle (discharge and recharge) can take between 8-26 hours, depending on array model. During this time, write caching is disabled for 2500 series arrays. For the 2500-M2 series, 6180, 6580, and 6780 arrays, write caching is not disabled, and the cache remains active during the learn cycle.


-f,--failover-alert <0..60>

Specifies the number of minutes that the management software is to wait after an alert before enacting failover procedures.

-h,--hot-spare <0..max-supported>

Specifies the hot-spare count for the array. When a hot-spare drive count is specified, an algorithm distributes hot-spare drives across the trays of the array. To set a specific drive as a hot spare, use the subcommand modify disk. The hot-spare count limit is dependent on the array:

-k,--disk-scrubbing <disable|1..30>

Specifies the period of days after which the system scrubs the disk. Disk scrubbing is disabled by default.

-L,--lock-key [<prefix>]

Specifies for the array to generate a new array lock key using the specified lock key prefix. If no prefix value is specified, the array name is used as the prefix. The command will prompt you for a new pass phrase. To ensure accuracy, you will be prompted to enter the pass phrase twice. If the new pass phrase is accepted, all existing unlocked secure drives on the array will be rekeyed with the new lock key.



Note - Successful execution of this command produces XML standard output that can be redirected to a file on the local system. A copy of the lock key will be retained by Sun Storage Common Array Manager as a backup, with older lock keys being obsoleted.


-N,--new-name <array-name>

Specifies the new name of the array.

-o,--os-type <string>

Specifies the operating system (OS) type. Use the command sscs list -a <array-name> os-type to view all of the operating systems that are supported by the array. Then, use an applicable OS type value for <string>.



Note - This specified OS type is applicable for volumes on the specified array mapped via the Default Storage Domain (i.e. not currently mapped to a specific initiator via a host/hostgroup). Volumes mapped explicitly to an initiator use the OS type specified by that initiator.


-p,--password <password>

Specifies to update the array password.

-R,--redistribute-volumes

Specifies to redistribute volumes on the specified array naming type.

-s,--cache-start <0..100>

Specifies the percentage of unwritten data in the cache that will trigger a cache flush. The value of --cache-start must be greater than the value for --cache-stop.

-S,--cache-stop <0..100>

Specifies the array cache stop.

-T,--name-type <wwn|array_name>

Specifies the array naming type used for <array-id> when specifying the array to be modified. The default is array_name.

array <array-id>

Specifies the ID of the array to be modified. The ID can be either the array’s name or WWN, as specified for -T,--name-type.

Examples

sscs modify -f 30 -T array_name array ARRAY1


modify controller

Modifies the controller settings.

Synopsis

modify -a <array-name> [-e <1|2>] [-d <on|off>] [-i <ip-address>] [-g <ip-address>] [-m <netMask>] controller <A|B>

Modifies the Ethernet port of a controller using the specified IP parameters.

 

modify -a <array-name> [-e <1|2>] -d <on|off> controller <A|B>

Modifies the IP parameters of a controller’s Ethernet port using the Dynamic Host Control Protocol (DHCP).

 

modify -a <array-name> -E controller <A|B> 

Verifies the network connectivity between the array controller and the management software.

 

modify -a <array-name> -e <1|2> [-d <on|off>] [-v <enable|disable>] [-i <ip-address>] [-g <ip-address>] [-m <netMask>]  controller <A|B>

Modifies controller IP parameters, including option to enable or disable IPv4.



Note - Not supported by all array models.


 

modify -a <array-name> -e <1|2> [-V <enable|disable>] [-I <v6-ip-address>] [-r <v6-ip-address>] [-S <enable|disable>] [-s <PORT_AUTO_NEGOTIATED|PORT_10MBPS_HALF_DUPLEX|PORT_10MBPS_FULL_DUPLEX|PORT_100MBPS_HALF_DUPLEX|PORT_100MBPS_FULL_DUPLEX|PORT_1000MBPS_FULL_DUPLEX>] controller <A|B>

Modifies controller Ethernet port and IP parameters, including IPv6 options and port speed.



Note - IPv6 and port speed are not supported by all array models and firmware versions.


Options

-a,--array <array-name>

Specifies the array associated with this controller.

-d,--dhcp <on|off>

Specifies whether the dynamic host control protocol (DHCP) is active.

-e,--ethernet-port <1|2>

Specifies the Ethernet port number.

-E,--test-communication

Verifies the network connectivity between the array controller and the management software.

-g,--gateway <gateway-address>

Specifies the gateway IP address. IP addresses can be either Domain Name System (DNS) names or dotted decimal addresses.

-i,--ipaddress <IP-address>

Specifies the controller’s IP address. IP addresses can be either Domain Name System (DNS) names or dotted decimal addresses.

-I,--v6-address <v6-ip-address>

Specifies IPv6 IP address.



Note - This option cannot be used in conjunction with the -S,--stateless option.


-m,--netmask <netmask>

Specifies the controller’s network mask.

-r,--router <v6-ip-address>

Specifies router IP address.

-s,--speed <PORT_AUTO_NEGOTIATED|PORT_10MBPS_HALF_DUPLEX|PORT_10MBPS_FULL_DUPLEX|PORT_100MBPS_HALF_DUPLEX|PORT_100MBPS_FULL_DUPLEX|PORT_1000MBPS_FULL_DUPLEX>

Specifies the port speed. The port speed option is not supported by all array models.

-S,--stateless <enable|disable>

Specifies to enable or disable the capability of the device to auto-generate its address using portions of the router's subnet and the device's interface identifier.



Note - This option cannot be used in conjunction with the -I,--v6-address option. The -I option is considered stateful and indicates an exact desired address.


-V,--ip-v6 <enable|disable>

Enables or disables IPv6. IPv6 is not supported by all array models and firmware versions.

-v,--ip-v4 <enable|disable>

Enables or disables IPv4.

controller <A|B> 

Specifies the controller to modify.

Examples

sscs modify -a array00 -g 10.0.5.2 controller A 
sscs modify -a array00 -e 2 -d on controller A 
sscs modify -a array00 -E controller B


modify date

Modifies the date on the array.

Synopsis

modify -a <array-name> [-G <true|false>] [-s]  date <HHMM|mmddHHMM|mmddHHMM.SS|mmddHHMMyy|mmddHHMMccyy|mmddHHMMccyy.SS>

Description

Modifies the date on the array, allowing you to set the time on the array, or to synchronize the time with the management host (that is, setting the array's time to the management host's time.)

Options

-a,--array <array-name>

Specifies the array for which you want to specify date information.

-G,--GMT <true|false>

Specifies whether to set Greenwich Mean Time (GMT) to true or false. If GMT is set to true, the date is GMT time. If GMT is set to false, the local time zone on the host system is assumed.

-s,--synchronize

Specifies whether to synchronize the date with the date on the element manager host. If this option is already set, you will not be able to specify a date.

date

Specifies the date.

mmdd

Specifies the month and day. For example, 0331 is March 31.

HHMM

Specifies the hour and minute. The hour is based on a 24-hour clock. For example, 1:30 p.m. is 1330.

cc

Specifies the century part of the year.

yy

Specifies the two-digit year.

.SS

Specifies the seconds of the hour.

Examples

sscs modify -G false date 010112002003.00


modify disk

Specifies a disk’s role or prepares a secure disk (or disks) for use in non-secure volumes through erasure.

Synopsis

modify -a <array-name> -h <true|false> disk <disk-name[,disk-name...]>
modify -a <array-name> -e [-t <tray-name>] disk <disk-name[,disk-name...]>

Description

This command either specifies a disk’s role or prepares a secure disk (or disks) for use in non-secure volumes through erasure.

Options

-a,--array <array-name>

Specifies the array associated with the specified disk(s).

-e,--erase

Specifies to erase all data from specified security-enabled disk(s) not currently used in any volume group. This will prepare the specified disk(s) for use in non-secure volume groups.



caution icon Caution - This command will destroy all data on the specified disk(s) and is an irreversible operation.


-h,--hot-spare <true|false> 

Specifies whether you want this disk to be a designated hot-spare.

-t,--tray <tray-name>

Specifies the tray name associated with the specified disk(s).

disk <disk-name[,disk-name...]>

Specifies the disk that you want to modify.

Examples

sscs modify -a array00 -h true disk t0d01


modify fcport

Modifies the Fibre Channel port settings on the specified array.

Synopsis

modify -a <array-name> [-c <A|B>] -l <0..125|n/a|any> fcport <fcport-id>

Description

Modifies the Fibre Channel port settings on the specified array.

Options

-a,--array <array-name>

Specifies the array associated with this controller.

-c,--controller <A|B>

Specifies the controller.

-l,--loop-id <0..125|n/a|any>

Specifies the preferred loop ID.

fcport <fcport-id>

Specifies the Fibre Channel port number that you want to modify. Ports are specified as A/1 to A/4 and B/1 to B/4. If no FC port is specified, details for all ports are displayed.

Examples

sscs modify -a array00 -c B -l 125 fcport 1


modify host

Modifies the host name.

Synopsis

modify -a <array-name> [-N <host-name>] [-g <hostgroup-name>] host <host-name>

Description

Modifies the host name.

Options

-a,--array <array-name>

Specifies the array associated with this host. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-N,--new-name <host-name>

Specifies the new name for the host.

-g,--hostgroup <hostgroup-name>

Specifies the host group into which to include this host.

host <host-name>

Specifies the current host name.

Examples

sscs modify -a array00 -N host02 host host01


modify hostgroup

Modifies the host group name.

Synopsis

modify -a <array-name> -N <hostgroup-name> hostgroup <hostgroup-name>

Description

Modifies the host group name.

Options

-a,--array <array-name>

Specifies the array associated with this host group.

-N,--new-name <hostgroup-name>

Specifies the new name for the host group.

hostgroup <hostgroup-name>

Specifies the current name of the host group that you want to rename.

Examples

sscs modify -a array00 -N hg02 hostgroup hg01


modify initiator

Modifies an initiator.

Synopsis

modify -a <array-name> [-h <host-name>] [-N <initiator-name>] [-T <iqn|initiator_name>] [-o <string>] [-u <none|CHAP>] initiator <initiator-id>

Modifies an iSCSI initiator.

modify -a <array-name> [-h <host-name>] [-N <initiator-name>] [-T <wwn|initiator_name>] [-o <string>] initiator <initiator-id>

Modifies a FC initiator.

Description

Modifies the initiator.

Options

-a,--array-name <array-name>

Specifies the array for which you want to modify the initiator. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-h,--host <host-name>

Specifies the new host to be associated with this initiator.

-N,--new-name <initiator-name> 

Specifies the new initiator name.

-T,--name-type <<iqn|initiator_name>|<wwn|initiator_name>>

Specifies the initiator identifier type. For the iSCSI variant, specify iqn for an iSCSI qualified name (IQN) or initiator_name for a named initiator. For the FC variant, specify wwn for a World Wide Name or initiator_name for a named initiator. You can modify the WWN if the initiator is offline only.

-o,--os-type <string>

Specifies the operating system (OS) type. Use the command sscs list -a <array-name> os-type to view all of the operating systems that are supported by the array. Then, use an applicable OS type value for <string>.

-u,--authentication <none|CHAP>

Specifies to use the Challenge Handshake Authentication Protocol (CHAP) authentication method for accessing the target. Values are CHAP or none.

initiator <initiator-id>

Specifies the initiator identifier.

Examples

sscs modify -a array00 -N Lexington_01 initiator myInitiator_01


modify iperformance

Modifies the settings for iSCSI performance data.

Synopsis

modify -a <array-name> [-S <on|off>] [-p <1|5|15>] [-r <forever|1HR|2HR|4HR|1DAY>] [-b <true|false>] iperformance

Description

Modifies the settings for iSCSI performance data.

Options

-a,--array <array-name>

Specifies the name of the array for which you want to modify.

-S,--status <on|off>

Enables or disables iSCSI performance monitoring.

-p,--poll <1|5|15>

Specifies the poll interval frequency as 1, 5, or 15 minutes.

-r,--retention <forever|1HR|2HR|4HR|1DAY>

Specifies the period of time you want to retain the performance data in cache.

-b,--baseline <true|false>

Sets the baseline time for the iSCSI array. If true, the current array time is used as the baseline time.

Examples

sscs modify -a iSCSILCA_2 -S on -p 5 iperformance 


modify iscsi-port

Modifies an iSCSI port.

Synopsis

modify -a <array-name> [-c <A|B>] [-p <3260|49152..65535>] [-m <1500..9000>] [-P <enable|disable>] [-d <on|off>] [-i <ip-address>] [-g <ip-address>] [-n <netMask>] [-v <enable|disable>] [-V <0..4096>] [-e <enable|disable>] [-E <0..7>] iscsi-port <iscsi-port-id>
modify -a <array-name> [-c <A|B>] [-p <3260|49152..65535>] [-m <1500..9000>] [-P <enable|disable>] [-i6 <enable|disable>] [-I <v6-ip-address>] [-r <router ip Address>] [-r1 <routable ip address #1>] [-r2 <routable ip address #2>] [-S <enable|disable>] [-v6 <enable|disable>] [-V6 <0..4096>] [-e6 <enable|disable>] [-E6 <0..7>] iscsi-port <iscsi-port-id>

Description

Modifies an iSCSI port configured for a specified array.

Options

a,--array <array-name>

Specifies the array for which you want to modify the iSCSI port.

-c,--controller <A|B>

Specifies the controller.

-d,--dhcp <on|off>

Turns DHCP on or off.

-E,--ethernet-priority-value <0..7>

Specifies the ethernet priority value.

-e,--ethernet-priority <enable|disable>

Enables or disables the ethernet priority.

-E6,--ipv6-ethernet-priority-value <0..7>

Specifies the IPv6 ethernet priority value.

-e6,--ipv6-ethernet-priority <enable|disable>

Specifies to enable or disable IPv6 ethernet priority.

-g,--gateway <ip-address>

Specifies the IP address gateway.

-i,--ipaddress <ip-address>

Specifies the IP address.

-i6,--ip-v6 <enable|disable>

Specifies to enable or disable IPv6.

-I,--ipv6-address <v6-ip-address>

Specifies the IPv6 address.

-m,--max-trans-unit <1500..9000>

Specifies the max-trans-unit.

-n,-netmask <netMask>

Specifies the netMask.

-P,--icmp-ping <enable|disable>

Enables or disables the ICMP ping feature.

-p,--port <3260|49152..65535>

Specifies the default port number, 3260, or a port number from 49152 to 65535.

-r,--router <router ip Address>

Specifies the router IP address.

-r1,--routable-ipaddress1 <routable ip address #1>

Specifies the routable IP address #1.

-r2,--routable-ipaddress2 <routable ip address #2>

Specifies the routable IP address #2.

-S,--stateless <enable|disable>

Specifies to enable or disable the capability of the device to auto-generate its address using portions of the router's subnet and the device's interface identifier. NOTE: This option cannot be used in conjunction with the -I,--ipv6-address option. The -I option is considered stateful and indicates an exact desired address.

-v,--VLAN <enable|disable>

Enables or disables the VLAN feature.

-V,--VLAN-id <0..4096>

Specifies the VLAN ID.

-v6,--ipv6-VLAN <enable|disable>

Specifies to enable or disable the IPv6 VLAN feature.

-V6,--ipv6-VLAN-id <0..4096>

Specifies the IPv6 VLAN ID.

iscsi-port <iscsi-port-id>

Specifies the iSCSI port ID.


modify iscsi-target

Modifies an iSCSI target.

Synopsis

modify -a <array-name> [-A <alias-name>] iscsi-target <target-name>
modify -a <array-name> -p <3205|49152...65535> iscsi-target <target-name>
modify -a <array-name> -u <none|CHAP|BOTH> iscsi-target <target-name>
modify -a <array-name> -n <enable|disable> iscsi-target <target-name>
modify -a <array-name> -i <enable|disable> -d <on|off> [-q <string>] [-p <3205|49152..65535>]  iscsi-target <target-name>
modify -a <array-name> -i <enable|disable> -s <enable|disable> [-h <string>] [-p <3205|49152..65535>]  iscsi-target <target-name>

Description

Modifies an iSCSI target configured for a specified array.

Options

-a,--array <array-name>

Specifies the array for which you want to modify the iSCSI target.

-A,--alias <alias-name>

An alias defined for the array.

-p,--port <3205|49152..65535>

Specifies the default port number, 3205, or a port number from 49152 to 65535.

-u,--authentication <none|CHAP|BOTH>

Specifies authentication as none, CHAP, or both.

-n,--unnamed-discovery <enable|disable>

Specifies to enable or disable unnamed discovery.

-s,--stateless <enable|disable>

Specifies to enable or disable the capability of the device to auto-generate its address using portions of the router's subnet and the device's interface identifier.



Note - This option cannot be used in conjunction with the -h,--ip-v6-address option. The -h option is considered stateful and indicates an exact desired address.


-h,--ip-v6-address <string>

Specifies the IPv6 address.



Note - This option cannot be used in conjunction with the -s,--stateless option.


-i,--isns <enable|disable>

Specifies to enable or disable iSNS.

-d,--dhcp <on|off>

Specifies to set DHCP to on or off.

-q,--ip-address <string>

Specifies to set the IP address to IPv4.

iscsi-target <target-name>

Specifies the iSCSI qualified target name. For example: iqn.1992-01.com.sun:1535.600a0b80002f9da000000000461255f9

Examples

sscs modify --alias fred iscsi-target 	iqn.199201.com.sun:1535.600a0b80002f9da000000000461255f9


modify jobs

Cancels or prioritizes a running or outstanding job.

Synopsis

modify -a <array-name> [-k] [-p <lowest|low|medium|high|highest>] jobs <job-ID>

Description

Cancels or prioritizes a running or outstanding job using the job identification number.

Options

-a,--array <array-name>

Specifies the array for which you want to modify the job or jobs.

-k,--kill 

Cancels a running or outstanding job or jobs.

-p,--priority <lowest|low|medium|high|highest>

Specifies an order of priority from which to determine the action of the modification.

jobs <job-id>

Specifies the job to be cancelled or prioritized.

Examples

sscs modify -p low jobs VOL:00C1408F84C2


modify license

Activates replication set licenses (not applicable to all firmware versions).

Synopsis

modify -a <array-name> -A [-v <virtual-disk-name>] license ReplicationSet

Activates replication set licenses on the specified array using the designated virtual disk for replication set repository volumes. If the virtual disk is omitted, the manager chooses an appropriate virtual disk to create the repository volumes.

modify -a <array-name> -A -r 1 -n <1..224> [-k <ANY|FC|SAS|SATA|SSD>] license ReplicationSet
modify -a <array-name> -A -r <3|5|6> -n <1..30> [-k <ANY|FC|SAS|SATA|SSD>] license ReplicationSet
modify -a <array-name> -A -r <1|3|5> -n <1..30> [-k <ANY|FC|SAS|SATA|SSD>] license ReplicationSet

Activates replication set licenses on the specified array, creating a new virtual disk with the designated RAID level and disk type for the replication set repository volumes.

modify -a <array-name> -A -r <1|3|5|6> -d <disk-name[,disk-name...]> license ReplicationSet
modify -a <array-name> -A -r <1|3|5> -d <disk-name[,disk-name...]> license ReplicationSet

Activates replication set licenses on the specified array, creating a new virtual disk with the designated RAID level and names of disks to be used for the replication set repository volumes.

modify -a <array-name> -I license ReplicationSet

Deactivates replication set licenses on the specified array and deletes the replication set repository volumes.

Description

Activates replication set licenses (not applicable to all firmware versions).

Options

-a,--array <array-name>

Specifies the array for which you want to activate or deactivate a replication set license. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-A,--activate 

Activates a replication set license.

-I (that is, uppercase letter “i”),--deactivate 

Deactivates a replication set license.

-v,--virtual-disk <virtual-disk-name>

Specifies the virtual disk that you want to select.

-r,--raid-level <1>|<3|5|6>|<1|3|5>

Specifies the RAID level in accordance with number of disks.

-n,--number-of-disks <1..224>|<1..30>

Specifies the number of disks in accordance with the RAID level.

-k,--disk-type <ANY|FC|SAS|SATA|SSD>

Specifies the disk type:

ANY - Any type of disk.

FC - Fibre Channel

SATA - Serial Advanced Technology Attachment

SAS - Serial Attached SCSI

SSD - Solid State Device

-d,--disk <disk-name>

Specifies the named disk.

license

Specifies that you want to modify a license.

ReplicationSet

Specifies the license that you want to modify.

Examples

sscs modify -a europe -A -v 3 license ReplicationSet

Activates replication set licenses on the array named europe using existing virtual disk 3 for the replication set repository volumes.

sscs modify -a corporate -A -r 3 -n 3 -D FC license ReplicationSet

Activates replication set licenses on the array named corporate, creating a new virtual disk of RAID level 3 with 3 Fibre Channel disks for the replication set repository volumes.

sscs modify -a corporate -A -r 1 -d t1d01,t2d02 license ReplicationSet

Activates replication set licenses on the corporate array, creating a new virtual disk of RAID level 1 with 2 specific disks for the replication set repository volumes.

sscs modify -a europe -I license ReplicationSet

Deactivates replication set licenses on the europe array. The replication set repository volumes will be deleted.


modify notification

Modifies notification options.

Synopsis

modify -d notification <local_email|trap>
modify -e notification <local_email|trap>
modify -p <string>] [-i <string>] [-k <true|false>] [-f <string>] [-u <string>] [-q] [-z <2|4|6|8|10|15|20|30|40|50>] [-o <integer>]  notification <local_email>


Note - trap is not a valid option for the above command variant.


modify -m <string> -r <string>  notification <local_email|trap>

Description

Modifies notification options.

Options

-d,--disable

Disables notification.

-e,--enable

Enables notification.

-f,--from <string>

Specifies the origin of the notification message.

-i,--ip <string>

Specifies the IP address of the device.

-k,--secure <true | false>

Specifies whether security is used.

-m,--test-message <string>

Specifies to send test message.

-o,--port <integer>

Specifies the port.

-p,--path <string>

Specifies the path.

-q,--query-for-password

Queries for the current password for the registered array.

-r,--test-address <string>

Specifies address where test message will be sent.

-u,--user <string>

Specifies the user for which notification will be modified.

-z,--max-size <2 | 4 | 6 | 8 | 10 | 15 | 20 | 30 | 40 | 50>

Specifies the maximum size of the notification message.

notification <local_email | trap>
local-email

Specifies your local email address at which you want to modify the notification.

trap

Specifies the SNMP trap notification method to use to receive the notification.


modify performance

Modifies settings for performance monitoring.

Synopsis

modify -a <array-name> [ -S on | off ] [ -p 1 | 5 | 15 ] [ -r forever | 1HR | 2HR | 4HR | 1DAY ] performance

Description

Modifies settings for performance monitoring. To reset performance settings, toggle the status to off and back on again.

Options

-a,--array <array-name>

Specifies the array for which you want to modify the performance.

-S,--status on | off

Enables or disables performance monitoring.

-p,--poll 1 | 5 | 15

Specifies the poll interval frequency in minutes. The default is 15.

-r,--retention forever | 1HR | 2HR | 4HR | 1DAY

Specifies the amount of time to retain data in cache. The default data retention period is 1 hour.

Examples

sscs modify -a array00 -S on -p 5 performance


modify pool

Modifies the name or description of the storage pool or the profile with which this pool is associated.

Synopsis

modify -a <array-name> [ -N <new-pool-name> ] [ -d <description> ] [ -p <new-profile-name> ] pool <pool-name>

Description

Modifies the name or description of the storage pool or the profile with which this pool is associated.

You can change the segment size of a volume by a factor of 2 only. For example, a volume with segment size of 32K can only be changed to a segment size of 64K or 16K. To change the segment size to 256K, the volume would first need to be changed to 64K, then 128K, then 256K. Any changes made to the profile of a pool must maintain this segment size restriction for all affected volumes.

Options

-a,--array <array-name> 

Specifies the name of the array to associate with this pool. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-N,--new-name <new-pool-name> 

Specifies a new name for this pool.

-d,--description <description>

Specifies a description of the pool. The description can be up to 256 alphanumeric characters, which can include underscores, dashes, colons, commas, parentheses, curly brackets, square brackets, ticks, tildes, bars, periods, or spaces.

-p,--profile <profile-name> 

Specifies the name of the profile to associate with this pool.

pool <pool-name>

Specifies the pool that you want to modify.

Examples

sscs modify -a array00 -d Lexington_01 pool SP048763


modify profile

Modifies a storage profile on the array.

Synopsis

modify -a <array-name> [-r <0|1>] [-s <8K|16K|32K|64K|128K|256K|512K>] [-N <new-profile-name>] [-d <profile-description>] [-h <on|off>] [-n <variable|1..224>] [-H <yes|no>] [-k <ANY|FC|SAS|SATA|SSD>] profile <profile-name>
modify -a <array-name> [-r <3|5|6>] [-s <8K|16K|32K|64K|128K|256K|512K>] [-N <new-profile-name>] [-d <profile-description>] [-h <on|off>] [-n <variable|1..30>] [-H <yes|no>] [-k <ANY|FC|SAS|SATA|SSD>] profile <profile-name>
modify -a <array-name> [-r <0|1|3|5>] [-s <8K|16K|32K|64K|128K|256K|512K>] [-N <new-profile-name>] [-d <profile-description>] [-h <on|off>] [-n <variable|1..30>] [-H <yes|no>] [-k <ANY|FC|SAS|SATA|SSD>] profile <profile-name>

Description

Modifies a storage profile on the array. You cannot modify a profile that is in use and is associated with a storage pool.

Options

-a,--array <array-name> 

Specifies the name of the array to associate with this profile.

-r,--raid-level <0|1>|<3|5|6>|<0|1|3|5>

Specifies the RAID level, in accordance with number of disks.

-s,--segsize <8K|16K|32K|64K|128K|256K|512K> 

Specifies the segment size.

-N,--new-name <new-profile-name>

Specifies a new name for the profile.

-d,--description <profile-description>

Specifies a profile description. The description can be up to 256 alphanumeric characters, which can include underscores, dashes, colons, commas, parentheses, curly brackets, square brackets, ticks, tildes, bars, periods, or spaces. Enclosing the description in quotation marks retains it exactly as you want it.

-h,--readahead <on|off> 

Specifies if the readahead setting is on or off.

-n,--number-of-disks <variable|1..30>|<variable|1..224>

Specifies the number of disks, in accordance with the RAID level.

-H,--dedicated-hot-spare <yes|no> 

Specifies whether you want this disk to be a designated hot-spare.

-k,--disk-type <ANY|FC|SAS|SATA|SSD>

Specifies the disk type:

ANY - Any type of disk.

FC - Fibre Channel

SATA - Serial Advanced Technology Attachment

SAS - Serial Attached SCSI

SSD - Solid State Device

profile <profile-name>

Specifies the name of the profile to be modified.

Examples

sscs modify -d “my profile description” profile random_5


modify registeredarray

Change the locally stored password for a registered array.

 

Synopsis

modify -a <array-name> -q registeredarray

Description

Modifies the locally stored password for a registered array.

Options

-a,--array <array-name> 

Specifies the name of the array.

-q,--query-for-password

Specifies to query for the current registered array password to update the management software’s registration database.

Examples

sscs modify -a array00 -q registeredarray
Enter the array password:
Confirm password:


modify repset

Modifies the mode, consistency group, or replication priority of the specified replication set.

Synopsis

modify -a <array-name> [ -m sync | async ] [ -G yes | no ] [ -R lowest | low | medium | high | highest ] [ -s enable | disable ] repset <repset-name>

Modifies the role, mode, consistency group, or replication priority of the specified replication set.

modify -a <array-name> [ -r primary | secondary ] [ -f ] repset <repset-name>

Changes the role of the local volume on the specified array.

modify -a <array-name> -c repset <repset-name>

Suspends replication on the specified array.

modify -a <array-name> -z repset <repset-name>

Resumes replication on the specified array.

modify -a <array-name> -E repset <repset-name>

Tests to determine if the primary volume on the specified array is communicating correctly with its replica (primary or secondary).

Options

-a,--array <array-name>

Specifies the array for which you want to activate or deactivate a replication set license. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-m,--mode sync | async

Specifies whether the mode is synchronous or asynchronous.

-G,--consistency-group yes | no 

Specifies whether or not the replication set is part of a consistency group.

-R,--replication-priority lowest | low | medium | high | highest

Specifies the priority level for this replication set.

-s,--auto-sync enable | disable 

Specifies whether or not the auto synchronization policy is enabled. If it is not specified, the default is disable.

-r,--role primary | secondary

Specifies whether the role is primary or secondary.

-f,--force 

If specified, it works with the -r option to reverse roles. If communication with the replication peer is not functioning, the role change is still forced on the local volume.

-c,--suspend

Suspends temporarily the replication activity. If the replication set is part of a replication consistency group, then all of the replication sets in that group are suspended.

-z,--resume

Resumes replicating a replication set that has been suspended, or starts replicating a replication set. If the replication set is part of a replication consistency group, then it sets all of the replication sets in that group to synchronize.

-E,--test-communication

Tests communications to a replication set.

Examples

sscs modify -a corporate -r secondary repset oracle/1

Changes the role of the local volume on the oracle/1 repset to secondary on the array named corporate.

sscs modify -a corp_west -r primary -f repset mail/1

Forces the role of the local volume on the mail/1 repset to primary on the sample corp_west array, even if communications cannot be established with the current primary.

sscs modify -a corporate -c repset sap_central/1

Suspends replication on the sap_central/1 repset on the corporate array.

sscs modify -a corporate -z repset sap_central/1

Resumes replication on the sap_central/1 repset on the corporate array.

sscs modify -a corporate -E repset finance/1

Tests to determine if the primary volume finance on the corporate array is communicating correctly with its replica (primary or secondary).


modify snapshot

Modifies the specified snapshot.

Synopsis

modify -a <array-name> [-N <snapshot-name>] [-f <failbasewrite|failsnapshot>] [-w <0..100>] snapshot <snapshot-name>

Modifies properties of the snapshot.

modify -a <array-name> -e <number<TB|GB|MB|KB|Bytes|BLK>> snapshot <snapshot-name>

Extends the snapshot reserve volume size by a specified amount. This option is mutually exclusive and cannot be used with any other option.

modify -a <array-name> -S snapshot <snapshot-name>

Disables the snapshot. This option is mutually exclusive and cannot be used with any other option.

modify -a <array-name> -R snapshot <snapshot-name>

Resnaps the snapshot. This option is mutually exclusive and cannot be used with any other option.

modify -a <array-name> [-m <volume-name>] [-c <A|B>] [-W <enable|disable>] [-M <enable|disable>] [-b <enable|disable>] [-F <immediate|250ms|500ms|750ms|1s|1500ms|2s|5s|10s|20s|60s|120s|300s|1200s|3600s|infinite>] [-k <enable|disable>] [-r <enable|disable>] snapshot <snapshot-name>

Modifies the volume properties of the snapshot reserve volume.

modify -a <array-name> --rollback <start|resume|cancel> snapshot <snapshot-name>

Starts, resumes, or cancels a snapshot rollback. Starting a rollback operation will generate a job, viewable using the list jobs command. While rollback is in progress, the snapshot is in a read-only state.

Description

Modifies the specified snapshot. The arguments resnap and extend are mutually exclusive.

Options

-a,--array <array-name>

Specifies the array associated with this snapshot. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-b,--write-cache-without-batteries <enable|disable>

Specifies whether write-cache-without-batteries is enabled.

-c,--controller <A|B>

Specifies the controller.

-e,--extend <number<TB|GB|MB|KB|Bytes|BLK>> 

Extends the snapshot reserve volume size by a specified amount.

-f,--fail-policy <failbasewrite|failsnapshot>

The fail-policy specifies what to do if and when the snapshot fills up:

Failbasewrite - Stop allowing writes to the base volume.

Failsnapshot - Stop allowing writes to the snapshot. This is the default.

-F,--flush-write-cache-after <immediate|250ms|500ms|750ms|1s|1500ms|2s|5s|10s|20s|60s|120s|300s|1200s|3600s|infinite>

Specifies the period of time after which to flush the write cache.

-k,--disk-scrubbing <enable|disable>

Specifies whether disk scrubbing is enabled.

-m,--reserve-name <reserve-volume-name>

Specifies the name of the reserve volume.

-M,--write-cache-with-replication <enable|disable>

Specifies whether write-cache-with-replication is enabled.

-N,--new-name <new-snapshot-name>

Specifies a new name for the snapshot.

-r,--disk-scrubbing-with-redundancy <enable|disable> 

Specifies whether disk scrubbing-with-redundancy is enabled.

--rollback <start|resume|cancel>

Starts, resumes, or cancels a snapshot rollback.

-R,--resnap

Resnaps the snapshot.

-S,--disable

Disables the snapshot.

-w,--warning-threshold <0..100>

Specifies when to inform you that the snapshot reserve volume is near capacity. If a warning-threshold is not specified, 50% is the default.

-W,--write-cache <enable|disable>

Specifies whether the write cache is enabled.

snapshot snapshot-name

Specifies the name of the snapshot to modify.

Examples

sscs modify -a array00 -V vol0 snapshot vol01_snap
sscs modify -a cam-array-1 --rollback start snapshot dbl_snap_1

 


modify tray

Modifies information about one or more storage trays in the array.

Synopsis

modify -a <array-name> -N <0..99> tray <tray-name>

Description

Modifies information about one or more storage trays in the array.

Options

-a,--array <array-name>

Specifies the array associated with this tray.

-N,--new-name <0..99>

Specifies the new tray name.

tray <tray-name>

Specifies the tray ID or tray IDs you want to modify. If no tray ID is specified, then the names of all the trays in the array are listed.

Examples

sscs modify -a array00 -n 99 tray 0


modify vdisk

Specifies modifications to a virtual disk.

Synopsis

modify -a <array-name> [-N <virtual-disk-name>] [-d <disk-name[,diskname...]>] [-f] [-S] vdisk <virtual-disk-name>

Description

Specifies modifications to a virtual disk.

Options

a,--array <array-name>

Specifies the array that is associated with the virtual disk changes.

-d,--disk <disk-name,...>

Specifies particular disks to be added to the virtual disk.

-f,--defragment

Specifies whether to defragment the virtual disk or virtual disks.

-N,--new-name <virtual-disk-name>

Specifies new virtual disk name.

-S,--secure

Specifies to make the virtual disk secure.

vdisk <virtual-disk-name>

Specifies the virtual disk that you want to modify.

Examples

sscs modify -a array00 -d t0d01,t0d02 vdisk vdisk01


modify volume

Modifies any of a volume’s attributes.

Synopsis

modify -a <array-name> [-p <pool-name>] [-e <number<TB|GB|MB|KB|Bytes|BLK>>] [-N <volume-name>] [-c <A|B>] [-m <lowest|low|medium|high|highest>] [-W <enable|disable>] [-M <enable|disable>] [-b <enable|disable>] [-F <immediate|250ms|500ms|750ms|1s|1500ms|2s|5s|10s|20s|60s|120s|300s|1200s|3600s|infinite>] [-k <enable|disable>] [-r <enable|disable>] [-Z <number<TB|GB|MB|KB|Bytes|BLK>>] [-C <integer>] [-L <low|verylittle|little|average|high|full>] [-l <0..100>] [-f <volume|snapshot>] [-w <0..100>] [-P <pool-name>] [-V <virtual-disk-name>] [-D <description-text>] volume <volume-name>
modify -a <array-name> [-p <pool-name>] [-e <number<TB|GB|MB|KB|Bytes|BLK>>] [-N <volume-name>] [-c <A|B>] [-m <lowest|low|medium|high|highest>] [-W <enable|disable>] [-M <enable|disable>] [-b <enable|disable>] [-F <immediate|250ms|500ms|750ms|1s|1500ms|2s|5s|10s|20s|60s|120s|300s|1200s|3600s|infinite>] [-k <enable|disable>] [-r <enable|disable>] [-R <enable|disable>] [-Z <number<TB|GB|MB|KB|Bytes|BLK>>] [-C <integer>] [-L <low|verylittle|little|average|high|full>] [-l <0..100>] [-f <volume|snapshot>] [-w <0..100>] [-P <pool-name>] [-V <virtual-disk-name>] [-D <description-text>] volume <volume-name>

Description

Modifies a volume’s attributes with one or more of the following arguments.

You can change the segment size of a volume by a factor of two only. For example, a volume with segment size of 32K can only be changed to a segment size of 64K or 16K. To change the segment size to 256K, the volume would first need to be changed to 64K, then 128K, then 256K. Any changes made to the profile of a pool must maintain this segment size restriction for all affected volumes.

Options

a,--array <array-name>

Specifies the array whose volume you want to modify. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-b,--write-cache-without-batteries <enable|disable>

Specifies whether write-cache-without-batteries is enabled.

-C,--snapshot-count <integer>

Specifies the number of intended snapshots for the volume.

-c,--controller <A|B>

Changes a volume’s preferred and current controller.

-D,--description <description-text>

Specifies a description of the snapshot.

-e,--extend <number<TB|GB|MB|KB|Bytes|BLK>> 

Extends the volume size by a specified amount.

-F,--flush-write-cache-after <immediate|250ms|500ms|750ms|1s|1500ms|2s|5s|10s|20s|60s|120s|300s|1200s|3600s|infinite>

Specifies the period of time after which to flush the write cache.

-f,--favor <volume|snapshot>

Favors the volume or snapshot.

-k,--disk-scrubbing <enable|disable>

Specifies whether disk scrubbing is enabled.

-L,--snapshot-level <low|verylittle|little|average|high|full>

Specifies the level of snapshot activity as either low, verylittle, little, average, high, or full. The snapshot levels equate to the following percentages:

low - 10%

verylittle - 25%

little - 40%

average - 50%

high - 75%

full - 100%

-l,--snapshot-percentage <0..100>

Specifies what percentage of the volume is to be used for snapshot creation.

-m,--modification-priority <lowest|low|medium|high|highest>

Specifies the priority of this modification.

-M,--write-cache-with-replication <enable|disable>

Specifies whether write-cache-with-replication is enabled.

-N,--new-name <new-volume-name>

Specifies a new name for the volume that is being modified.

-P,--snapshot-pool <pool-name>

Specifies the name of the snapshot.

-p,--pool <pool-name>

Specifies the pool in which the volume resides.

-R,--pre-read-redundancy-check <enable|disable>

Specifies whether the pre-read redundancy check is enabled.

-r,--disk-scrubbing-with-redundancy <enable|disable> 

Specifies whether disk scrubbing-with-redundancy is enabled.

-V,--reserve-vdisk <virtual-disk-name>

Specifies a reserve virtual disk.

volume <volume-name>

Specifies the volume name.

-w,--warning-threshold <0..100>

Specifies when to inform you that the snapshot reserve volume is near capacity. If a warning-threshold is not specified, 50% is the default.

-W,--write-cache <enable|disable>

Specifies whether the write cache is enabled.

-Z,--snapshot-reserve-size <number<TB|GB|MB|KB|Bytes|BLK>>

Specifies the amount of space you want to reserve for capacity of the snapshot reserve volume.

Examples

sscs modify -a array01 -p pool1 -e 10GB volume V1


modify volume-copy

Modifies a volume copy.

Synopsis

modify -a <array-name> -s [ <source-volume-name> ] -t [ <target-volume-name> ] [ -p lowest|low|medium|high|highest ] [ -r enable | disable ] [ -R ] [ -S ] volume-copy
modify -a <array-name> -s <volume-name> -t <volume-name> [-p <lowest|low|medium|high|highest>] [-r <enable|disable>]  volume-copy 
modify -a <array-name> -s <volume-name> -t <volume-name> -R volume-copy 
modify -a <array-name> -s <volume-name> -t <volume-name> -S volume-copy

Description

Modifies a volume copy.

Options

-a,--array <array-name>

Specifies the array associated with this volume copy.

-s,--source-volume <source-volume-name>

Specifies the source volume name associated with this volume copy.

-t,--target-volume <target-volume-name>

Specifies the target volume name associated with this volume copy.

-p,--priority lowest | low | medium | high | highest

Specifies the priority level for this volume copy.

-r,--readonly enable | disable

Specifies whether this volume copy is read only or modifiable.

-R,--recopy

Specifies that you want to recopy this volume copy.

-S,--stop

Specifies that you want to stop this volume copy while in progress.

volume-copy <volume-copy-name>

Specifies the name of the volume copy that you want to modify.

Examples

sscs modify -a array00 -s vol1 -t vol2 -S volume-copy


offline vdisk

Sets a virtual disk offline.

Synopsis

offline -a <array-name> vdisk [ <virtual-disk-name> ]

Description

Sets a virtual disk offline. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.



Note - This command does not apply to all arrays or firmware versions. Use the --help command to check proper syntax for your array. For further information on how to use the --help command, see Getting Help with Commands and Their Syntax.


Options

-a,--array <array-name>

Specifies the array on which you want to set the virtual disk offline.

vdisk

Specifies the name of the virtual disk.

Examples

sscs offline -a Array01 vdisk VirtualDisk33


online vdisk

Sets a virtual disk online.

Synopsis

online -a <array-name> vdisk [ <virtual-disk-name> ]

Description

Sets a virtual disk online. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.

Options

-a,--array <array-name>

Specifies the array on which you want to set the vdisk online.

vdisk

Specifies the name of the virtual disk.

Examples

sscs online -a Array01 vdisk


reconstruct disk

Initiates a disk reconstruction.

Synopsis

reconstruct -a <array-name> [ -t <tray-name>] disk [ <disk-name> ]

Description

Reconstructs a disk. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.

Options

-a,--array <array-name>

Specifies the array on which you want to reconstruct the disk.

-t,--tray <tray-name>

Identifies the tray where the physical disk resides.

disk

Specifies the name of the disk.

Examples

sscs reconstruct -a Array01 -t Tray2

 


remove hostgroup

Removes one or more hosts from a host group.

Synopsis

remove -a <array-name> -h <host-name,...> hostgroup <host-group-name>

Description

Removes one or more hosts from a host group.

Options

-a,--array <array-name>

Specifies the array associated with this host group.

-h,--host <host-name,...>

Specifies the host or hosts that you want to remove from this host group.

hostgroup <host-group-name>

Specifies the host group from which you want to remove hosts.

Examples

sscs remove -a array00 -h host01,host02 hostgroup hg01


remove license

Removes the replication set feature license from the specified array.

Synopsis

remove -a <array-name> license <license-name>

Description

Removes the specified feature license from the array.

Options

-a,--array <array-name>

Specifies the array associated with this license.

license <license-name>

Specifies the license that you want to remove from the array. The license name is one of the well-known license names. Use the command sscs list license to see these names.

Examples

sscs remove -a corp_west license ReplicationSet

Removes a replication set feature license from the array named corp_west.


reset array

Resets the specified array.



caution icon Caution - Resetting the array destroys all user data, including volumes, hosts, initiators, and so forth.


Synopsis

reset -l <array|volume> array <array-name>
reset array <array-name>

Description

Resets the specified array.

Options

-l,--level <array | volume>

Specifies either array or volume to reset. If volume option is used, only volume information is erased, while array configuration is retained.



Note - This option is only supported by firmware version 07.10.nn.nn and higher.



reset controller

Resets the specified controller.

Synopsis

reset -a <array-name> controller A| B
reset -a <array-name> controller <controller-name>

Description

Resets the specified controller.

Options

-a,--array <array-name>

Specifies the array whose controller you want to reset.

controller A | B

Specifies the name of the controller to reset, A or B.

controller

Specifies the name of the controller to reset.

Examples

sscs reset -a array00 controller A


resnap snapshot

Resnaps one or more existing snapshots.

Synopsis

resnap -a <array-name> snapshot <snapshot-name[,snapshot-name...]>

Description

Resnaps one or more existing snapshots. When you resnap a group of snapshots, an array job is created.

When resnapping a group of snapshots, if the resnap operation fails for one snapshot, then the entire resnap operation is cancelled.

Options

-a,--array <array-name>

Specifies the array associated with this snapshot.

snapshot <snapshot-name,...>

Specifies the names of the snapshots that you want to resnap.

Examples

sscs resnap -a array00 snapshot snapshot1, snapshot2

Resnaps snapshot1 and snapshot2 on array00.


revive disk

Attempts to bring a disk to the optimal state.

Synopsis

revive -a <array-name> [ -t <tray-id> ] disk [ <disk-name> ]

Description

Attempts to bring a disk to the optimal state. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.

Options

-a,--array <array-name>

Specifies the array on which you want to revive the disk.

-t,--tray <tray-ID>

Identifies the tray where the disk resides.

disk

Specifies the name of the disk.

Examples

sscs revive -a Array01 -t Tray1 disk Disk7


revive vdisk

Revives a virtual disk.

Synopsis

 

revive -a <array-name> vdisk [ <virtual-disk-name> ]

Description

Revives a virtual disk. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel. A virtual disk must be put offline before attempting revival.



Note - This command does not apply to all arrays or firmware versions. Use the --help command to check proper syntax for your array. For further information on how to use the --help command, see Getting Help with Commands and Their Syntax.


Options

-a,--array <array-name>

Specifies the array on which you want to revive the virtual disk.

vdisk

Specifies the name of the virtual disk.

Examples

sscs revive -a Array01 vdisk VirtualDisk33


service fail

Places a field-replaceable unit of an array into a failed state.

Synopsis

 

service -a <array-name> -t <target-fru-name> fail

Description

Places the specified field-replaceable unit of the array into a failed state.



caution icon Caution - Do not initiate this command without first consulting Sun Customer Service personnel.


Options

-a,--array <array-name>

Specifies the array to be placed into a failed state.

-t,--target <target-fru-name>

Specifies the name of the field-replaceable unit to be placed into a failed state. This parameter needs to be set to either the FRU name or the FRU ID, both of which can be obtained using variations of the list fru command. See list fru for further details.

Examples

service -a myarray -t t0drive12 fail


service redistribute

Redistributes volumes back to their preferred owners.

Synopsis

service -a <array-name> redistribute

Description

Redistributes volumes back to their preferred owners.

Options

-a,--array <array-name>

Specifies the array on which volumes will be redistributed.

Examples

service -a Myarray redistribute


service revive

Attempts to place the array controller or disk drive into the optimal state. This can create complications. Do not initiate this command without first consulting Sun Customer Service personnel.

Synopsis

service -a <array-name> -t <target-fru-name> [ -w ] revive

Description

Attempts to place the controller or disk drive of the specified array into the optimal state.

Options

-a,--array <array-name>

Specifies the array to be placed into the optimal state.

-t,--target <target-fru-name>

Specifies the name of the field-replaceable unit to be placed into the optimal state. This parameter needs to be set to either the FRU name or the FRU ID, both of which can be obtained using variations of the list fru command. See list fru for further details.

-w,--no warn

Skips the warning prompt.

Examples

sscs service -a myarray -t t0drive12 -w revive


snapshoot volume

Creates and manages snapshots. This command provides cross-compatibility with scripts that are written for the StorageTek 6920 System. The preferred snapshot commands are Create Snapshot and Modify Snapshot.

Synopsis

snapshoot -a <array-name> -v <source-volume-name> [-C <integer>] [-L <low|verylittle|little|average|high|full>] [-l <0..100>] [-Z <number<TB|GB|MB|KB|Bytes|BLK>>] [-f <volume|snapshot>] [-w <0..100>] [-P <reserve-volume-name>] [-V <virtual-disk-name>] volume <string>
snapshoot -a <array-name> -R volume <string>
snapshoot -a <array-name> -r volume <string>

Description

Creates and manages snapshots. This command provides cross-compatibility with scripts that are written for the StorageTek 6920 System. The preferred snapshot commands are Create Snapshot and Modify Snapshot.

Options

-a,--array <array-name>

Specifies the array.

-v,--volume <source-volume-name>

Specifies the volume for which to take a snapshot.

-C,--snapshot-count <integer>

Specifies the number of intended snapshots for the volume.

-l,--snapshot-percentage <0..100>

Specifies what percentage of the volume is to be used for snapshot creation.

-L,--snapshot-level <low|verylittle|little|average|high|full>

Specifies the level of snapshot activity as either low, verylittle, little, average, high, or full. The snapshot levels equate to the following percentages:

low - 10%

verylittle - 25%

little - 40%

average - 50%

high - 75%

full - 100%

-Z,--snapshot-reserve-size <number<TB|GB|MB|KB|Bytes|BLK>>

Specifies the amount of space you want to reserve for capacity of the snapshot reserve volume.

-f,--favor <volume|snapshot>

Favors the volume or snapshot.

-w,--warning-threshold <0..100>

Specifies the threshold, as a percentage, at which the management software will generate messages to indicate the level of space left in the reserve volume. By default, the software generates a warning notification when data in the reserve volume reaches 50 percent of the available capacity. Possible values for the warning threshold are 1 to 100 percent.

-P,--snapshot-pool <reserve-volume-name> 

Specifies the name to give to the reserve volume.

-V,--reserve-vdisk <virtual-disk-name>

Specifies the name to give to the reserve virtual disk.

-R,--resnap

Resnaps a volume.

-r,--remove-pool

Removes a snapshot from a storage pool.

volume <<snapshot-volume-name>|<new-snapshot-name>> 

Specifies the volume or volumes for the snapshot argument. Once the snapshot volume is created, you can treat it the same as any other volume, except that it cannot be used to create another snapshot.

Examples

To create a snapshot named vol01 from the source volume vol0, type:

sscs snapshoot -a array01 -v vol0 volume vol01


unmap host

Unmaps one or more snapshots or volumes from a host.

Synopsis

unmap -a <array-name> [-s <snapshot-name,...> ] [ -v <volume-name,...>] host <host-name>

Description

Unmaps one or more snapshots or volumes from a host.

Options

-a,--array <array-name>

Specifies the array on which this volume resides. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-s,--snapshot <snapshot-name,...>

Specifies the snapshot or snapshots to unmap from the host.

-v,--volume <volume-name,...>

Specifies the volume or volumes to unmap from the host.

host <host-name>

Specifies the host that you want to unmap from the snapshot or volume.

Examples

sscs unmap -a array00 -v vol01,vol02 host host01


unmap hostgroup

Unmaps one or more snapshots or volumes from a host group.

Synopsis

unmap -a <array-name> [ -s <snapshot-name,...> ] -v <volume-name,...> hostgroup <host-group-name>

Description

Unmaps one or more snapshots or volumes from a host group.

Options

-a,--array <array-name>

Specifies the array containing the volume that you want to unmap from the host group.

-s,--snapshot <snapshot-name,...>

Specifies the snapshot or snapshots to unmap from the host group.

-v,--volume <volume-name,...>

Specifies the volume or volumes that you want to unmap from the host group.

hostgroup <host-group-name>

Specifies the host group that you want to unmap from the snapshot or volume.

Examples

sscs unmap -a array00 -v vol01,vol02 hostgroup hg01


unmap initiator

Removes the mapping from one or more initiators to a volume or snapshot.

Synopsis

unmap -a <array-name> [ -s <snapshot-volume-name,...> ] [ -v <volume-name,...> ] initiator <initiator-name,...>

Description

Removes the mapping from an initiator to a snapshot or volume.

Options

-a,--array <array-name>

Specifies the array associated with the volume or snapshot to be unmapped. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-s,--snapshot <snapshot-volume-name,...>

Specifies the snapshot volumes to be unmapped from this initiator.

-v,--volume <volume-name,...>

Specifies the volumes to be unmapped from this initiator.

initiator <initiator-name,...> 

Specifies the initiator name to be unmapped.

Examples

sscs unmap -a array00 -v vol01 initiator init1


unmap snapshot

Removes the mapping from one or more snapshots to a host or hostgroup.

Synopsis

unmap -a <array-name> [-i <initiator-name>] [-h <host-name>] [-g <hostgroup-name>]  snapshot <snapshot-name[,snapshot-name...]>

Description

Removes the mapping from one or more snapshots to a host or hostgroup.

Options

-a,--array <array-name>

Specifies the array.

-i,--initiator <initiator-name>

Specifies the initiator that you want to unmap from the snapshot.

-h,--host <host-name>

Specifies the host that you want to unmap from the snapshot.

-g,--hostgroup <hostgroup-name>

Specifies the hostgroup that you want to unmap from the snapshot.

snapshot <snapshot-name[,snapshot-name...]>

Specifies the snapshot or snapshots to be unmapped.


unmap volume

Unmaps one or more volumes from a host or host group.

Synopsis

unmap -a <array-name> [ -h <host-name> | -g <host-group-name> ] volume <volume-name,...>
unmap -a <array-name> [-i <initiator-name>] [-h <host-name>] [-g <hostgroup-name>] volume <volume-name[,volume-name...]>

Description

Unmaps one or more volumes from a host or host group.

Options

-a,--array <array-name>

Specifies the array containing the volume that you want to unmap from the host or host group. For cross-platform compatibility, you can substitute -X,--storage-device in place of the -a,--array option.

-i,--initiator <initiator-name>

Specifies the initiator that you want to unmap from the volume.

-h,--host <host-name>

Specifies the host that you want to unmap from the volume.

-g,--hostgroup <host-group-name>

Specifies the host group that you want to unmap from the volume.

volume <volume-name,...>

Specifies the volume or volumes to unmap from the host.

Examples

sscs unmap -a array00 -g hg01 volume vol01,vol02
Feedback