raidcom modify ldev

Storage Advisor Embedded User Guide

Version
93-07-2x
88-08-12
Audience
anonymous
Part Number
MK-97HM85022-25

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).
  • ESE-VOL setting

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.

Note: If a failure occurs in a processor on an MP blade or a controller, this command cannot be run even on an MP blade or a controller on which no failure occurs.

There is a limit to the number of asynchronous commands that can be accepted simultaneously. For details, see Maximum number of acceptable asynchronous commands.

Syntax for specifying LDEV ID

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} 
	 

Syntax for specifying pool ID

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

Options and parameters

-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

Note: This option is for enterprise storage systems. You do not need to specify SSID for VSP G130, G/F350, G/F370, G/F700, G/F900, or VSP G200, G400, G600, G800 and VSP F400, F600, F800, but this option is enabled.
-command_device {y | n} [Security value]
Configures command device attribute.

y or yes: Command device attribute enabled.

n or no: 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
-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 or yes: The ALUA mode is enabled.
  • disable or no: The ALUA mode is disabled.

For this command, you can specify "y" as an alias of "yes" or "n" as an alias of "no".

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

Note: Disabling 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 in megabytes (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

Examples

Restoring the LDEV: 200.

# raidcom modify ldev -status nml -ldev_id 200

Blocking the LDEV: 200.

# raidcom modify ldev -status blk -ldev_id 200

Assigning an LDEV nickname: my_volume to LDEV: 200

# raidcom modify ldev -ldev_id 200 -ldev_name my_volume

Setting the LDEV owner MP blade ID of LDEV: 200 to 2

# raidcom modify ldev -ldev_id 200 -mp_blade_id 2

Enabling relocation of LDEV (Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe V-VOL): 200

# raidcom modify ldev -ldev_id 200 -status enable_reallocation

Disabling relocation of LDEV (Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe V-VOL): 200

# raidcom modify ldev -ldev_id 200 -status disable_reallocation

Discarding the zero page of LDEV (Dynamic Provisioning, Dynamic Provisioning for Mainframe, Dynamic Tiering, active flash, Dynamic Tiering for Mainframe, or active flash for mainframe V-VOL): 200

# raidcom modify ldev -ldev_id 200 -status discard_zero_page

Specifying 0x1234 to LDEV SSID of LDEV: 200.

Note:

Specify undefined LDEV number: 200 in the area that is not allocated SSID, and assign new SSID: 0x1234. If you specify an LDEV number that is already defined or an SSID that is already registered, an error occurs.

# raidcom modify ldev -ssid 0x1234 -ldev_id 200

Enabling LDEV command device attribute of LDEV: 200. Specifies 2 to the value of command device security.

# raidcom modify ldev -command_device y 2 -ldev_id 200

Disabling LDEV command device attribute of LDEV: 200.

# raidcom modify ldev -command_device n -ldev_id 200

Setting the relocation of LDEV for LDEV:200 by the customized policy 6.

# raidcom modify ldev -ldev_id 200 -status enable_relocation_policy 6

Setting the tier from which the new mapped page of LDEV: 200 is allocated to High.

# raidcom modify ldev -ldev_id 200 -status new_page_allocation high

Setting LDEV: 200 as the quorum disk whose quorum ID is 10.

# raidcom modify ldev -ldev_id 200 -quorum_enable 65384 R800 -quorum_id 10

Enabling the ALUA mode for LDEV: 200.

# raidcom modify ldev -ldev_id 200 -alua enable

Setting the capacity saving setting to compression for LDEV: 200.

# raidcom modify ldev -ldev_id 200 -capacity_saving compression

Enabling the compression accelerator setting for LDEV: 200.

# raidcom modify ldev -ldev_id 200 -compression_acceleration enable -request_id auto

Enabling all compression accelerator settings associated with pool ID: 1.

# raidcom modify ldev -pool 1 -compression_acceleration enable -request_id auto

Enabling the compression accelerator settings for all LDEVs associated with from pool ID: 0 to maximum 128 pools.

# raidcom get dp_pool | rmawk @L-gt:1 exe="raidcom modify ldev -pool @1 
-compression_acceleration enable -request_id auto"

Changing the capacity saving processing mode for LDEV: 0 to the inline mode.

# raidcom modify ldev -ldev_id 0 -capacity_saving_mode inline

Changing the capacity saving processing mode for LDEV: 0 to the post-process mode.

# raidcom modify ldev -ldev_id 0 -capacity_saving_mode post_process

(For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Setting the lower limit of the throughput per second to 1500 IOPS for LDEV ID: 200.

# raidcom modify ldev -ldev_id 200 -lower_throughput_io 1500 -request_id auto

(For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Setting the I/O processing priority to 1 for LDEV ID: 200.

# raidcom modify ldev -ldev_id 200 -response_priority 1 -request_id auto

(For VSP 5000 series, VSP G130, G/F350, G/F370, G/F700, G/F900) Setting the alert notification time when the lower limit is not reached to 10 seconds for LDEV ID: 200.

# raidcom modify ldev -ldev_id 200 -lower_alert_time 10 -request_id auto
(For VSP 5000 series) Enabling ESE for LDEV: 200.
# raidcom modify ldev -ldev_id 200 -ese enable -request_id auto