Managing volumes

Displays the information of the specified LDEV or the device file. A device group can also be specified instead of an LDEV.

raidcom get ldev {-ldev_id <ldev#> … [-cnt <count>] |
   -grp_opt <group option> -device_grp_name <device group 
   name> [<device name>] | -ldev_list <ldev list option>}
   [-key <keyword>][{-check_status | -check_status_not}
   <string>... [-time <time>]] [-time_zone <time zone>]

• -ldev_id <ldev#> …

  Specifies the LDEV number (0-65279). For example:

  • -ldev_id 200
  • -ldev_id 100-110
  • -ldev_id 100 -cnt 10

• [-cnt <count> ]

  Specifies the count (2-65280).

  If this option is omitted, the count is set to one.

• -grp_opt <group option>

  Specifies the device information extracted from the LDEV belonging to the device group. Specify "ldev" (fixed). The information of LDEV belonging to the device group is used.

• -device_grp_name <device group name> [<device name>]

  Specifies the name of device group (maximum 32 characters) to be operated.

  To operate an LDEV in the device group, specify the device name of LDEV (maximum 32 characters) within the device group.

  If the device name is omitted, all the LDEVs belonging in the device group are operated.

• -ldev_list <ldev list option>

  Specifies the type of LDEVs to display. Specify one of the following LDEV list options. If the LDEV that meets the specified condition does not exist, [EX_ENODEV] No such device is displayed.

  • defined: Displays all implemented LDEVs.
  • dp_volume: Displays LDEVs that have Dynamic Provisioning attributes.

    Combining this with -pool_id <pool id> specification displays LDEVs that have Dynamic Provisioning attributes related to the specified POOL.

  • external_volume: Displays external volumes.
  • undefined: Displays all LDEV numbers that are not implemented.
  • mapped: Displays all LDEVs to which LU paths are defined.

    Combining this with -pool_id <pool id> specification displays LDEVs (defined the LU path) relate to the specified POOL.

  • mapped_nvme: Displays all LDEVs that are assigned to namespaces.
  • unmapped: Displays all LDEVs to which LU paths are defined. However, LDEVs, mainframe volumes, and namespaces that are not implemented are not displayed because they cannot specify the LU path.

    Combining this with -pool_id <pool id> specification displays LDEVs (not defined the LU path) relate to the specified POOL.

  • journal -journal_id <journal id>: Displays LDEVs that belong to the specified journal.
  • pool -pool_id <pool id>: Displays LDEVs that belong to the specified pool.

    If a -pool_id option is non-numeric, the specified value is recognized as a pool name to identify the pool ID.

  • parity_grp -parity_grp_id <parity group id>: Displays LDEVs that belong to the specified parity group.
  • mp_blade -mp_blade_id <mp#>: Displays LDEVs that are set to the specified MP blades.
  • quorum: Displays LDEVs set for the quorum disks.
  • clpr -clpr_id <clpr#> : Displays LDEVs belonging to the specified CLPR.

    Supported storage systems:

    • VSP 5000 series
    • VSP G1x00 and VSP F1500
    • VSP G/F350, G/F370, G/F700, G/F900

• [-key <keyword> ]

  Specifies a display keyword.

  If this option is omitted, basic LDEV information is displayed. If this option is specified, the following information is displayed. The following display keywords can be specified:

  • front_end: Front-end information
  • front_end_nvme: Front-end NVMe (NVMe-oF) information
  • parity_grp: Parity group information
  • external: External volume information
  • tier: Tier information for the Dynamic Tiering or active flash V-VOL.
  • powersave: Information on the capacity saved by the capacity saving feature for volumes with the capacity saving feature enabled.
  • naa: The NAA identifier of the LU (LUN WWN)
  • nguid: Namespace identifier (NGUID: Namespace Global Unique Identifier)
  • qos: Specifies the qos when displaying the QoS setting information. This display keyword can be specified only for VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900.
  • qos_monitor: Specifies the qos_monitor when displaying the performance monitor information related to the QoS of the target LDEV. This display keyword can be specified only for VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900.

• [-check_status <string>... [-time <time>]]

  Check if the LDEV is in the same state as the specified in <string>. If the option contains multiple states, the OR condition check is performed and verifies that the LDEV is in one of the states contained in the option.

  The following strings are specified in the <string>.

  • STS
    • NML: Normal
    • BLK: Blocked
    • BSY: Status is changing
  • OPE_TYPE
    • FMT: Formatting
    • QFMT: Quick formatting
    • CCOPY: Data copying (Correction copy / Copy back / Drive copy / Dynamic sparing)
    • CACCS: Accessing to collections
    • NONE: Not in operation
    • SHRD: Shredding
    • ZPD: Page discarding
    • SHRPL: Deleting from the pool
    • RLC: Pool relocating
    • RBL: Pool rebalancing
  • VOL_TYPE
    • NOT DEFINED: An LDEV is not installed
    • DEFINING: An LDEV is being created
    • REMOVING: An LDEV is being deleted

  If "-time" is specified, the status of the LDEV is checked every three seconds until the end of the specified <time> (seconds).

  When this option is specified, the returned values are as follows.

  • The LDEV is in one of the specified states: 0
  • The LDEV is in none of the specified states (without -time option): 1
  • The LDEV is in none of the specified states (when the specified <time> passed): EX_EWSTOT

• [-check_status_not <string>... [-time <time>]]

  Check that the LDEV is not in the same state as the specified in <string>. If the option contains multiple states, the NOR condition check is performed and verifies that the LDEV is not in any of the states contained in the option.

  The following strings are specified in the <string>.

  • STS
    • NML: Normal
    • BLK: Blocked
    • BSY: Status is changing
  • OPE_TYPE
    • FMT: Formatting
    • QFMT: Quick formatting
    • CCOPY: Data copying (Correction copy / Copy back / Drive copy / Dynamic sparing)
    • CACCS: Accessing to collections
    • NONE: Not in operation
    • SHRD: Shredding
    • ZPD: Page discarding
    • SHRPL: Deleting from the pool
    • RLC: Pool relocating
    • RBL: Pool rebalancing
  • VOL_TYPE
    • NOT DEFINED: An LDEV is not installed
    • DEFINING: An LDEV is being created
    • REMOVING: An LDEV is being deleted

  If "-time" is specified, the status of the LDEV is checked every three seconds until the end of the specified <time> (seconds).

  When this option is specified, the returned values are as follows.

  • The LDEV is not in any of the specified states: 0
  • The LDEV is in one of the specified states (without -time option): 1
  • The LDEV is in one of the specified states (when the specified <time> passed): EX_EWSTOT

• [-time_zone <time zone>]

  Supported storage systems:

  • VSP 5000 series
  • VSP G130, G/F350, G/F370, G/F700, G/F900

  Specifies the time zone displayed in storage systems. If this option is omitted, the time in the time zone set for the storage system is displayed. This option is valid only when it is specified with the -key qos option or -key qos_monitor option.

  • utc: Displays the time in Coordinated Universal Time (UTC).

  A hyphen (-) is displayed if the DKCMAIN microcode version is not supported.

Some keywords might not be displayed depending on the LDEV attribute as shown below.

Changes the following LDEV attributes:

• Blocking LDEV and restoring LDEV.
• Setting LDEV nickname.
• Setting MP blade ID of LDEV.
• Setting the Tiering policy, the new page assignment tier, or enabling or disabling of the tier relocation for the Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe V-VOL.
• Instructing the page discarding of V-VOL for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe.
• Setting the SSID.
• Setting the command device attribute.
• Setting the quorum disk and releasing setting of the quorum disk.
• Setting capacity saving.
• Setting the capacity saving processing mode (post process or inline).
• Setting compression accelerator (enable or disable) (only for VSP 5000 series).

When blocking LDEV, restoring LDEV, setting the quorum disk, releasing setting of the quorum disk, setting capacity saving, setting compression accelerator, or setting QoS, this command is executed asynchronously with the command input. Check the completion of this process using the raidcom get command_status command.

raidcom modify ldev -ldev_id <ldev#> {-status <status> [<level>]
   [-forcible -password <One Time Password>]  
   | -ldev_name <ldev naming> | -mp_blade_id <mp#> | -ssid <value> |
   -command_device {y | n} [Security value] | -quorum_enable <serial#> 
   <id> -quorum_id <quorum id> | -quorum_disable | 
   -alua {enable|disable} | -capacity_saving <capacity saving>
   | -capacity_saving_mode <saving mode>| -compression_acceleration {enable | disable} -request_id auto | -upper_throughput_io<upper throughput io> -request_id auto | -upper_data_trans_mb <upperdata trans mb> -request_id auto | -upper_alert_time <upper alert time> -request_id auto | -lower_throughput_io <lower throughput io> -request_id 
auto | -lower_data_trans_mb <lower data trans mb> -request_id auto | -
lower_alert_time <lower alert time> -request_id auto | -
response_priority <priority> -request_id auto | -response_alert_time
<response alert time> -request_id auto  | -ese {enable | disable} -request_id auto} 
	 

raidcom modify ldev -pool {<pool ID#> | <pool naming>} -compression_acceleration 
{enable | disable} -request_id auto

• -ldev_id <ldev#>

  Specifies the LDEV number (0-65279). For example:

  • -ldev_id 200

• -status <status> [<level>]

  Specifies the LDEV status. The following LDEV statuses can be specified.

  • nml: Changes the LDEV status to Normal
  • blk: Changes the LDEV status to Blockade
  • {enable_reallocation [<level>]|enable_relocation [<level>]}: Relocation of LDEV (V-VOL for Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe) enabled. Defines the tier that is used for reallocation depending on the value of the level.
    • all: Uses all tiers in the pool.
    • 1-5: Specifies the level of the tier for use. For details, see the Provisioning Guide for your storage system.
  • disable_reallocation | disable_relocation: Relocation of LDEV (V-VOL for Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe) disabled
  • discard_zero_page: Discarding 0 page of LDEV(V-VOL) for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe.
  • stop_discard_zero_page (only for VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900): Stops the discard of LDEV (virtual volume) pages for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe.
  • enable_relocation_policy <policy_id>: Enables the LDEV relocation for Dynamic Tiering or active flash, and sets the level or customized policy of the Tier to be used for the relocation by Policy ID.

    <policy_id>:

    • all: Uses all tiers in the pool.
    • 1-5: Specifies the level of the tier for use.
    • 6-31: Specifies the customized policy of the tier for use.
  • new_page_allocation: Sets the Tier when new page is allocated to the LDEV for Dynamic Tiering or active flash (V-VOL). The value is one of high/middle/low.
  • enable_fullallocation: Enables Full Allocation. If all areas equivalent to the sum of the pool capacities the specified volume requires can be reserved, it is guaranteed that all areas of DP-VOL are writable.
  • disable_fullallocation: Disables Full Allocation.

  For example:

  • -status nml

• [-forcible -password <One Time Password>]

  Supported storage systems:

  • VSP 5000 series
  • VSP G130, G/F350, G/F370, G/F700, G/F900
  Specify this option with a one-time password to restore an LDEV status forcibly without considering data consistency. For details about the password, contact customer support. This option is valid only if the -status nml option is specified.

• -ldev_name <ldev naming>

  Specifies the LDEV nickname (maximum 32 characters).

• -mp_blade_id <mp#>

  Specifies the MP blade ID (0-15).

  Do not change the MP blade ID during initial copying or I/O processing of TrueCopy, ShadowImage, Universal Replicator, or global-active device.

  To change the MP blade ID again for the same LDEV, wait for more than 30 minutes after changing the MP blade ID. For example:

  -mp_blade_id 2

  When you change the MP blade ID where the LDEV is allocated, both before and after the changing should be executed during as off-peak hours for the rate of write pending data of the MP blade as possible. It is recommended to execute when the rate of write pending data of all CLPRs is less than 50%.

  Do not change the MP blade ID in regard to a lot of LDEVs at the same time. The number of LDEVs and I/O workload for which you can change the MP blade ID at the same time is lower than 10% of the total number of LDEVs where the same MP blade ID is allocated as a guideline.

• -ssid <value>

  Specifies SSID (hexadecimal number).

  When specifying SSID, specify not only unallocated SSID but also LDEV ID. In this case, LDEV ID must be ID for the undefined LDEV in the area where SSID is not allocated. For example:

  -ssid 0x1234 -ldev_id 200

  NoteThis option is for enterprise storage systems. You do not need to specify SSID for VSP Gx00 models, and VSP Fx00 models, HUS VM, but this option is enabled.

• -command_device {y | n} [Security value]

  Configures command device attribute.

  y: Command device attribute enabled.

  n: Command device attribute disabled.

  Specifies the value of command device security (0-7).

  You can specify 0-7 to Security value as the command device security setting:

  • 0: Security: OFF, User authentication: OFF, Group information acquisition: OFF
  • 1: Security: OFF, User authentication: OFF, Group information acquisition: ON
  • 2: Security: OFF, User authentication: ON, Group information acquisition: OFF
  • 3: Security: OFF, User authentication: ON, Group information acquisition: ON
  • 4: Security: ON, User authentication: OFF, Group information acquisition: OFF
  • 5: Security: ON, User authentication: OFF, Group information acquisition: ON
  • 6: Security: ON, User authentication: ON, Group information acquisition: OFF
  • 7: Security: ON, User authentication: ON, Group information acquisition: ON

• -quorum_enable <serial#> <id>

  Sets quorum disk for global-active device configuration. You must also set the -quorum_id parameter.

  serial#: Serial number (of the migration source storage system)

  • When specifying the serial number for VSP 5000 series, add a “5” at the beginning of the serial number. For example, for serial number 12345, enter 512345.
  • When specifying the serial number for VSP G1x00 and VSP F1500, add a “3” at the beginning of the serial number. For example, for serial number 12345, enter 312345.

  id: The identifier of the source storage system

  • R900: VSP 5000 series
  • R800: VSP G1x00, VSP F1500
  • R700: VSP
  • M700: HUS VM

• -quorum_id <quorum id>

  Specifies the quorum ID for setting the quorum disk.

• -quorum_disable

  Releases setting of the quorum disk.

• -alua {enable|disable}

  Specifies the ALUA mode. You must enable ALUA mode only when you use ALUA by global-active device.

  • enable: The ALUA mode is enabled.
  • disable: The ALUA mode is disabled.

• [-capacity_saving <capacity saving>]

  Specifies the capacity saving setting:

  • disable: Capacity saving is disabled.
  • compression: Compression is enabled.
  • deduplication_compression: Deduplication and compression are enabled.

  (VSP 5000 series) When there are no pool-associated LDEVs for which the capacity saving setting is deduplication_compression, the deduplication system data volumes are automatically deleted asynchronously with the deletion of the LDEVs. To verify that a deduplication system data volume is deleted, use the raidcom get pool -key saving command to check the LDEV number, and use the raidcom get ldev command to verify that VOL_TYPE of the LDEV is changed from REMOVING to NOT DEFINED.

  NoteDisabling the capacity saving setting for a deduplication volume might take a while to complete due to its data extension operation. Also, more pool/physical capacity might be used. You cannot stop the operation of disabling the capacity saving setting while it is in process.

  For VSP 5000 series, compressed volumes for accelerated compression, or volumes for deduplication and compression can be created only for pools whose subscription limit is set to 65535 (unlimited). An error occurs if compression or deduplication_compression is specified for a pool whose subscription limit is other than 65535 (unlimited).

• [-capacity_saving_mode <saving mode>]

  Specifies post-process mode or inline mode as the capacity saving processing mode for DP-VOLs. For details about the capacity saving processing modes, see the Provisioning Guide for the storage system.

• post_process: Sets the post-process mode for capacity saving processing.
• inline: Sets the inline mode for capacity saving processing.

For VSP G1x00, VSP F1500, VSP G200, G400, G600, G800, and VSP F400, F600, F800 post_process is the default. For VSP 5000 series, and VSP G/F350, G/F370, G/F700, G/F900, inline is the default.

• -lower_throughput_io <lowerthroughput io> -request_id auto

  (For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Specifies the lower limit of the throughput per second. To disable it, specify 0. For more information on the lower limit of the throughput per second, see the Performance Guide.

  The request ID is output in the following format when the raidcom modify ldev command ends.

  • REQID : <request#>
  Where <request#> is a request ID assigned each time the command is executed.

  For details, see Request ID function.

• - lower_data_trans_mb <lower data trans mb> -request_id auto

  (For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Specifies the lower limit of the data transfer volume (MB) per second. To disable it, specify 0. For more information on the lower limit of the data transfer volume (MB) per second, see the Performance Guide.

  The request ID is output in the following format when the raidcom modify ldev command ends.

  • REQID : <request#>
  Where <request#> is a request ID assigned each time the command is executed.

  For details, see Request ID function.

• - lower_alert_time <lower alert time> -request_id auto

  (For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Specifies the following alert notification time (second). To disable it, specify 0.

  • The alert notification time (second) when the number of received commands has not continuously reached the lower limit of the throughput per second.
  • The alert notification time (second) when the transfer volume of received commands has not continuously reached the lower limit of the data transfer volume per second.

  For more information on the lower limit of the alert notification time per second, see the Performance Guide.

  The request ID is output in the following format when the execution of the raidcom modify ldev command ends.

  • REQID : <request#>
  Where <request#> is a request ID assigned each time the command is executed.

  For details, see Request ID function.

• -response_priority <priority> -request_id auto

  (For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Specifies the I/O processing priority. The valid ranges are 1-3. To disable it, specify 0. For more information on the I/O processing priority, see the Performance Guide.

  The request ID is output in the following format when the execution of the raidcom modify ldev command ends.

  • REQID : <request#>
  Where <request#> is a request ID assigned each time the command is executed.

  For details, see Request ID function.

• -response_alert_time <responsealert time> -request_id auto

  (For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Specifies the alert notification time (second) when the target response time is not reached . To disable it, specify 0. If the target response time has not been continuously reached for more than the alert notification time, an alert is issued. For more information on the alert notification time (second) when the target response time is not reached , see the Performance Guide.

  The request ID is output in the following format when the execution of the raidcom modify ldev command ends.

  • REQID : <request#>
  Where <request#> is a request ID assigned each time the command is executed.

  For details, see Request ID function.

• -compression_acceleration {enable | disable} -request_id auto

  Supported storage systems:

  • VSP 5000 series

  Specifies whether compression accelerator is enabled or disabled.

  If you change -capacity_saving from disable to compression or deduplication_compression, and omit this this option, it will be enabled when COMPRESSION_ACCELERATION of raidcom get system -key dedupe_compression is AVAILABLE. It will be disabled when COMPRESSION_ACCELERATION of raidcom get system -key dedupe_compression is UNAVAILABLE.

  • enable: Compression accelerator is enabled.
  • disable: Compression accelerator is disabled.

  <request #> is the Request ID assigned for each command execution. For details, see Request ID function.

• -ese {enable | disable} -request_id auto

  Supported storage systems:

  • VSP 5000 series

  Specifies whether to set or cancel the ESE attribute for the LDEV.

  • enable: Set the ESE attribute
  • disable: Cancel the ESE attribute

  <request#> is the request ID assigned each time the command is run. For details, see Request ID function

Deletes the specified LDEVs or V-VOLs. A device group can also be specified instead of an LDEV.

This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.

raidcom delete ldev {-ldev_id <ldev#> | -grp_opt <group option> 
     -device_grp_name <device group name>  [<device name>] }
     [-operation initialize_capacity_saving]

• -ldev_id <ldev#> (0-65279)

  Specifies the LDEV number (0-65279). For example:

  • -ldev_id 200

• -grp_opt <group option>

  Specifies the device information extracted from the LDEV belonging to the device group. Specify "ldev" (fixed). The information of LDEV belonging to the device group is used.

• -device_grp_name <device group name> [<device name>]

  Specifies the name of device group (maximum 32 characters) to be operated.

  To operate an LDEV in the device group, specify the device name of LDEV (maximum 32 characters) within the device group.

  If the device name is omitted, all the LDEVs belonging in the device group are operated.

• [-operation initialize_capacity_saving]

  Deletes an LDEV for which the capacity saving setting is enabled. When you specify this option, use the raidcom get command_status command to check if the LDEV deletion started, and then use the raidcom get ldev command to check if VOL_TYPE of the LDEV is changed from REMOVING to NOT DEFINED. If you perform another operation during or immediately after deletion of the LDEV, the operation might fail. In this case, wait a while and then retry the operation.

  (VSP 5000 series) When there are no pool-associated LDEVs for which the capacity saving setting is deduplication_compression, the deduplication system data volumes are automatically deleted asynchronously with the deletion of the LDEVs. To verify that a deduplication system data volume is deleted, use the raidcom get pool -key saving command to check the LDEV number, and use the raidcom get ldev command to verify that VOL_TYPE of the LDEV is changed from REMOVING to NOT DEFINED.

  Note

  • Deleting a deduplication volume using this command might take a while. Also, more pool/physical capacity might be used. You cannot stop the deletion operation while it is in process.
  • If you want to delete all of the pool-associated volumes for which capacity saving is enabled, first execute the raidcom modify ldev command to block both the pool-associated volumes and the deduplication system data volumes, and then execute the raidcom initialize pool command. By executing the raidcom initialize pool command before deleting the volumes, you can shorten the time for the volume deletion process and prevent the increase of pool capacity to be used.

Adds an LDEV to the specified parity group or the external volume group. Or this adds V-VOL for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, active flash for mainframe, Thin Image, or Copy-on-Write Snapshot to the specified pool.

Alternatively, this command creates V-VOL for Dynamic Provisioning associated with a pool volume having the data direct mapping attribute.

This command is executed asynchronously with the command input. Check the completion of this process on the raidcom get command_status command.

When creating an LDEV or V-VOL in the specified parity group, external volume group, or pool.

raidcom add ldev {-parity_grp_id <gno-sgno>| 
   -external_grp_id <gno-sgno> | -pool {<pool ID#> |
    <pool naming> | snap}} {-ldev_id <ldev#> | 
   -tse_ldev_id <ldev#> | -ese_ldev_id <ldev#> | -ldev_id auto -request_id auto 
   [-resource_id <resource group id>] [-ldev_range <range>]} 
   {-capacity <size> | -offset_capacity <size> | -cylinder <size>} 
   [-emulation <emulation type>][-location <lba>]
   [-mp_blade_id <mp#>][-clpr <clpr#>]
   [-t10pi_enable]
   [-status {enable_fullallocation | disable_fullallocation} | -capacity_saving {compression | deduplication_compression} 
   [-capacity_saving_mode <saving_mode>] [-compression_acceleration {enable | disable} -request_id auto] | 
   -capacity_saving disable]

When creating a V-VOL for Dynamic Provisioning associated with a pool volume having the data direct mapping attribute.

raidcom add ldev -ldev_id <ldev#> -mapping_ldev_id <ldev id>

• -parity_grp_id <gno-sgno>

  Specifies the parity group number (gno:1-52, sgno:1-32) (for example, 3-1).

• -external_grp_id <gno-sgno>

  Specifies the external volume group number (gno:1-16384, sgno:1-4096) (for example, 52-11 ("E" is not required)).

• -pool {<pool ID#> | <pool naming> | snap}

  Specifies a Pool ID or Pool name for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe when V-VOL is created to Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe pool.

  When only a number is specified, it is recognized as a pool ID. Therefore, when you specify a pool that the pool name is only a number, specify the pool ID instead of the pool name.

  When creating V-VOL for a Thin Image or Copy-on-Write Snapshot pool, specify "snap".

• -ldev_id <ldev#> | -tse_ldev_id <ldev#> | -ese_ldev_id <ldev#>

  Specifies the LDEV number (0-65279).

  If you specify the -tse_ldev_id option, the TSE-VOL that is used by FlashCopy SE is created. For example:

  • -ldev_id 200
  • -tse_ldev_id 400

  If you use the -tse_ldev_id or -ese_ldev_id option in a command other than the raidcom add ldev command, that option functions as the -ldev_id option.

• -ldev_id auto -request_id auto [-resource_id <resource group id>] [-ldev_range <range>]

  This option can be specified only when a V-VOL of which emulation type is OPEN-V is created in a Dynamic Provisioning or Dynamic Tiering pool.

  Specify this option to automatically assign an LDEV number to the LDEV you created. From the unused numbers of the LDEVs for which the user has operation permission, the smallest LDEV number is assigned. To limit the range of the LDEV numbers to be assigned, use any of the following options:

  • -request_id auto: Effective only when "auto" is specified as the -request_id option. If other option than "auto" is specified, EX_INVARG or EX_REQARG is replied.
  • -resource_id <resource grp id>: Assigns the smallest LDEV number from the numbers of the unused LDEVs with the specified resource group ID.
  • -ldev_range <range>: Assigns the smallest LDEV number from the numbers of the unused LDEVs with the LDEV number specified by <range>. If the -resource_id <resource grp id> is specified with this option, the smallest LDEV number from the numbers of the unused LDEVs that have the LDEV number in <range> and the specified resource group number is assigned.

  Specify <range> in the format of <starting-LDEV-number-ending-LDEV-number>. LDEV numbers must be specified in decimal or hexadecimal. To specify in hexadecimal, add 0x at the beginning of the LDEV number.

  For example, to specify LDEV numbers from 300 to 305:

  • -ldev_range 300-305
  • -ldev_range 0x12c-0x131
  • -ldev_range 0x12c-305

    (You can combine decimal and hexadecimal numbers.)

  You can check the selected LDEV numbers using the raidcom get command_status command.

  The request ID is output in the following format after completion of the raidcom add ldev command:

  • REQID : <request#>

    Where <request#> is a request ID assigned each time the command is executed. For details, see Request ID function.

  Unused LDEV numbers in the resource group where you create an LDEV and in the LDEV number range must satisfy the following requirements:

  • The unused LDEV numbers are not in the same range (grouped by every 32 LDEV numbers) as the installed LDEV in an emulation group other than OPEN-V. If this requirement is not satisfied, the command might fail with EX_CMDRJE (SSB1=2E30, SSB2=0026).
  • The unused LDEV numbers are not used as an alias of PAV. If this requirement is not satisfied, the command might fail with EX_CMDRJE (SSB1=2E30, SSB2=0025).
  • The unused LDEV numbers can be used in the shared memory installed in the storage system. If this requirement is not satisfied, the command might fail with EX_CMDRJE (SSB1=2E23, SSB2=0001).
  • When using a mainframe volume in the same storage system, SSID that is not used by the mainframe volume is assigned to the unused LDEV numbers.

  The storage system might execute multiple raidcom add ldev commands at the same time. In such a batch operation, if one command fails, the others also fail. You can display command error information by executing raidcom get command_status -request_id <request#>, where you must specify the Request ID output when the command is executed. For errors caused due to batch operation, 'O' is displayed in column R, while for errors caused for other reason, 'T' is displayed in the same column. For example, if a user issues two raidcom add ldev -ldev_id auto commands at the same time to a storage system having only one free LDEV number, the system attempts to execute the commands in a batch, causing both of them to fail. Check command status by executing raidcom get command_status -request_id <request#> with the Request ID. If 'O' is displayed under column R, retry the command.

• -capacity <size>

  Specifies the capacity. The size can be specified in bytes or blocks. When specifying in bytes, the unit is t/T (terabyte), g/G (gigabyte), m/M (megabyte), or k/K (kilobyte). If this unit is omitted, block (512 bytes) is used.

  When specifying in bytes, note the following:

  • There is no size correction.
  • If the capacity of LDEVs that are created by GUI and by CLI are the same, a copy pair might not be created. To create a pair with an LDEV that was created by GUI, create the LDEV by specifying blocks.

  Example of specification:

  1GB (gigabyte) is:

  -capacity 1G, -capacity 1g, -capacity 1024M, -capacity 1024m, -capacity 1048576K, -capacity 1048576k, -capacity 2097152

  In the case of volumes other than OPEN-V, more free space than the capacity that was actually specified is required. For details, see the Provisioning Guide for the storage system.

  When you specify "all" instead of digits to create an OPEN-V LDEV and no LDEV has been created in the specified parity group* or the external volume group, the system allocates all empty space for the LDEV. If the empty space is larger than the maximum capacity of an LDEV, the system creates the LDEV with the maximum capacity and leaves the rest of the space as an empty space.

  *: "all" cannot be specified depending on the combination of the drive type and drive level because of the LDEV control area allocation, and so on. In this case specify bytes or blocks.

• -offset_capacity <size>

  Specifies capacity. Corrects the size as well as GUI for the specified capacity. The capacity can be specified in bytes or blocks. When specifying byte, the unit is t/T (terabyte), g/G (gigabyte), m/M (megabyte), or k/K (kilobyte).

• -cylinder <size>

  Specifies the size in cylinder unit. When specifying, the unit is t/T (teracylinder), g/G (gigacylinder), m/M (megacylinder), or k/K (kilocylinder). Cylinder is applied if you do not specify the unit.

  When an open-systems emulation type is specified, this option cannot be specified.

• [-location <lba>]

  Specifies the Location (the starting point of the LDEV to be created in the parity group/external volume group). If this specification is omitted, create a LDEV and close up in the free space.

• [-emulation <emulation type> ]

  Specifies the emulation type (for example, OPEN-V).

  If this specification is omitted, OPEN-V is specified.

  If this specification is omitted when the virtual volume is crated, the following emulation type is specified.

  • OPEN-V: Dynamic Provisioning, Dynamic Tiering, or active flash
  • 3390-A: Dynamic Provisioning for Mainframe, Dynamic Tiering for Mainframe, or active flash for mainframe

  The values that can be specified for <emulation type> are:

  • OPEN-3, OPEN-8, OPEN-9, OPEN-E, OPEN-L, OPEN-V
  • 3390-1, 3390-2, 3390-3, 3390-A, 3390-3A, 3390-3B, 3390-3C, 3390-3R, 3390-9, 3390-9A, 3390-9B, 3390-9C, 3390-L, 3390-LA, 3390-LB, 3390-LC, 3390-M, 3390-MA, 3390-MB, 3390-MC, 3390-V
  • 3380-3, 3380-3A, 3380-3B, 3380-3C

  Some emulation types cannot be specified depending on the emulation type.

  Caution

  You can specify 3390-3 or 3390-3R as the emulation type, but these are unable to be mixed. You can specify the 3380 series or the 3390 series as the emulation type for each parity group, but they are unable to be mixed for each 32 address boundary because of the OS restriction.

• [-mp_blade_id <mp#> ]

  Specifies the MP blade ID (0-15). If this specification is omitted, it is allocated automatically.

• [-clpr <clpr#> ]

  When you create virtual volumes by specifying the -pool <pool#> option, specify the CLPR ID. If you omit this option, the ID number of CLPR to which the pool is allocated is used.

• [-status {enable_fullallocation | disable_fullallocation}]

  Specifies an availability of Full Allocation when the virtual volume is used for Dynamic Provisioning, Dynamic Tiering, or active flash. If this specification is omitted, Full Allocation is disabled.

  • enable_fullallocation: Enables Full Allocation. If all areas equivalent to the sum of the pool capacities the specified volume requires can be reserved, it is guaranteed that all areas of DP-VOL are writable.
  • disable_fullallocation: Disables Full Allocation.

• [-t10pi_enable]

  Enables the T10 PI attribute.

• -mapping_ldev_id <ldev id>

  Supported storage systems:

  • VSP 5000 series
  • VSP G1x00 and VSP F1500
  • VSP G130, G/F350, G/F370, G/F700, G/F900

  Creates the V-VOL for Dynamic Provisioning associated with the pool volume having the data direct mapping attribute. When you specify this option, the data direct mapping attribute is automatically set to the V-VOL to be created.

• [-compression_acceleration {enable | disable} -request_id auto]

  Supported storage systems:

  • VSP 5000 series

  Specifies whether compression accelerator is enabled or disabled. If you omit this option, it will be enabled when COMPRESSION_ACCELERATION of raidcom get system -key dedupe_compression is AVAILABLE. It will be disabled when COMPRESSION_ACCELERATION of raidcom get system -key dedupe_compression is UNAVAILABLE.

  • enable: Compression accelerator is enabled.
  • disable: Compression accelerator is disabled.

  <request #> is the Request ID assigned for each command execution. For details, see Request ID function.

• [-capacity_saving <capacity saving>]

  Specifies the capacity saving setting. If you omit this option, a volume is created with the capacity saving function disabled.

  • compression: Enables compression.
  • deduplication_compression: Enables deduplication and compression.
  • disable: Disables capacity saving.

  For VSP 5000 series, compressed volumes for accelerated compression, or volumes for deduplication and compression can be created only for pools whose subscription limit is set to 65535 (unlimited). An error occurs if compression or deduplication_compression is specified for a pool whose subscription limit is other than 65535 (unlimited).

• [-capacity_saving_mode <saving mode>]

  When you enable capacity saving, specifies the post-process mode or inline mode as the capacity saving processing mode for DP-VOLs. For details about the capacity saving processing modes, see the Provisioning Guide for the storage system.

  • post_process: Sets the post-process mode for capacity saving processing.
  • inline: Sets the inline mode for capacity saving processing.

  For VSP G1x00, VSP F1500, VSP G200, G400, G600, G800, and VSP F400, F600, F800 post_process is the default. For VSP G/F350, G/F370, G/F700, G/F900 inline is the default.

Extends the capacity of a V-VOL for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe.

If the specified LDEV is not a V-VOL of Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe, the command is rejected with EX_ENOOBJ.

A device group can also be specified instead of an LDEV.

raidcom extend ldev {-ldev_id <ldev#> | -grp_opt <group option> 
     -device_grp_name <device group name> [<device name>]} 
     -capacity <size> | -offset_capacity <size> | -cylinder <size> [-request_id auto]

• -ldev_id <ldev#> (0-65279)

  Specifies the LDEV number (0-65279). Specify LDEVs for Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, Dynamic Tiering for Mainframe, active flash, or active flash for mainframe. For example:

  • -ldev_id 200

• -grp_opt <group option>

  Specifies the device information extracted from the LDEV belonging to the device group. Specify "ldev" (fixed). The information of LDEV belonging to the device group is used.

• -device_grp_name <device group name> [<device name>]

  Specifies the name of device group (maximum 32 characters) to be operated.

  To operate an LDEV in the device group, specify the device name of LDEV (maximum 32 characters) within the device group.

  If the device name is omitted, all the LDEVs belonging in the device group are operated.

• -capacity <size>

  The increment size of capacity can be specified in bytes or blocks. When specifying in bytes, the unit is t/T (terabyte), g/G (gigabyte), m/M (megabyte), or k/K (kilobyte). If this unit is omitted, block (512 bytes) is used.

  Example of specification:

  1GB (gigabyte) is:

  -capacity 1G, -capacity 1g, -capacity 1024M, -capacity 1024m, -capacity 1048576K, -capacity 1048576k, -capacity 2097152

• -offset_capacity <size>

  Specifies capacity. Corrects the size as well as GUI for the specified capacity. The capacity can be specified in bytes or blocks.

• -cylinder <size>

  Specifies the size in cylinder unit. When specifying, the unit is g/G (gigabyte), m/M (megabyte), or k/K (kilobyte). Cylinder is applied if you do not specify the unit.

  When the emulation type for the Open System is specified, this option cannot be specified.

• -request_id auto

  (VSP 5000 series, VSP G1x00, VSP F1500and VSP G130, G/F350, G/F370, G/F700, G/F900 only) Specifying this option is recommended when running the command. <request#> is a Request ID assigned each time the command is run. For more information, see Request ID function.

By using the CCI, you can completely erase all data from volumes. After the erase, the volumes can be reused securely.

You can prevent data leakage by shredding volumes in the following cases:

• When you want to reuse a volume.
• When you want to dispose of a drive.

Shredding erases the volume data by overwriting it repeatedly with dummy data.

Block the target volume, and then delete the data.

• Block the volume.

  To stop access to the target volume, block the volume. To prevent operation mistakes, data can be erased only when the volume is blocked.

• Erase the data from the volume.

  Delete data from the volume by repeatedly overwriting the unnecessary dummy data. You can specify any data pattern for the second time. By default, the dummy data is overwritten in the following order:

  • First time: 0x00000000

  • Second time: 0xFFFFFFFF

  • Third time: 0x00000000

The following figure shows an example system environment.

• • Server

    CCI is installed on the server.

  • Storage volumes for shredding

    Volume ID: 100

    Volume ID: 200

  • User name and password of storage system

    User name: user00

    Password: password00