Dell PowerFlex v3.6.x CLI Reference Guide

add_sds

Add an SDS to a Protection Domain.

This command creates an SDS component and can be used to apply many configuration options at the time of creation. It informs the SDS about which devices to use, and for what purpose to use them (storage or acceleration). By default, the command also performs tests on the devices it adds, and saves the results, except for RFcache SSD acceleration devices, which are not tested.

NOTE:During execution of the command, PowerFlex checks that the devices are clear before adding them. If a device is not clear, an error message is returned, and the command fails for that device. If you would like to overwrite existing data on the devices by forcing the command, use the force_device_takeover flag. Note that this flag destroys all existing data on the device!

Syntax

scli --add_sds --sds_ip <IP> [--sds_ip_role <ROLE> {sdc_only | sds_only | all}] (--protection_domain_id <ID> | --protection_domain_name <NAME>) [(--storage_pool_name <NAME> | --storage_pool_id <ID>) --device_path <PATHS> [--device_name <NAMES>] [--media_type <TYPES> {HDD | SSD}]] [(--acceleration_pool_name <NAME> | --acceleration_pool_id <ID>) --acceleration_device_path <PATHS> [--acceleration_device_name <NAMES>]] [--sds_name <NAME>] [--fault_set_id <ID> | --fault_set_name <NAME>] 
   [--rmcache_size_mb <SIZE>]
   [{--enable_rmcache | --disable_rmcache}]
   [--sds_port <PORT>] 
   [--force_clean]
   [--force_device_takeover]
   [--test_time <TIME>]
   [{--test_only | --no_test | <BLANK>}]
   [--profile <PROFILE>] 
   [--i_am_sure]

Parameters

--sds_ip <IP>: Comma-separated list of one or more IP addresses associated with the SDS over which the data will be transferred. See "SDS IP addresses and roles" below. Omit the space after each comma.
--sds_ip_role {sdc_only | sds_only | all}: Comma-separated list of IP roles associated with the SDS IP addresses. Omit the space after each comma. See "SDS IP addresses and roles" below.
--protection_domain_id <ID>: Protection Domain ID
--protection_domain_name <NAME>: Protection Domain name
--storage_pool_name <NAME>: Comma-separated list of Storage Pool names to be associated with the storage devices, respectively. Omit the space after each comma. If only one Storage Pool is specified in the list, all devices are associated with it. Otherwise, each device is associated with the Storage Pool situated in the same position in the list.
--storage_pool_id <ID>: Comma-separated list of Storage Pool IDs to be associated with the storage devices, respectively. Omit the space after each comma. If only one Storage Pool is specified in the list, all devices are associated with it. Otherwise, each device is associated with the Storage Pool situated in the same position in the list.
--device_path <PATHS>: Comma-separated list of the full path to each devices to be added. Omit the space after each comma. A device can be a disk, an unmounted partition, or a file that represents free space on a mounted device. To force device take-over, use this command with the force_device_takeover flag, proceeding with caution.
--device_name <NAMES>: Comma-separated list of device names. Omit the space after each comma. When using this flag to assign names to the SDS devices. The number of names must equal the number of devices, and the names will be appropriated to the devices in the same order as they appear in the device_path list.
--media_type {HDD | SSD}: If one media type is specified in the list, all devices are assigned with this type. Otherwise, each device is assigned the media type located in the same position as the list.
--acceleration_pool_name <NAME>: Comma-separated list of Acceleration Pool names to be associated with the acceleration devices. Omit the space after each comma. If one Acceleration Pool is specified, all acceleration devices are assigned to it. Otherwise, each device is assigned to the Acceleration Pool located in the same position in the list.
--acceleration_pool_id <ID>: Comma-separated list of Acceleration Pool IDs to be associated with the acceleration devices. Omit the space after each comma. If one Acceleration Pool is specified, all acceleration devices are assigned to it. Otherwise, each device is assigned to the Acceleration Pool located in the same position in the list.
--acceleration_device_path <PATHS>: Comma-separated list of SDS acceleration device paths. Omit the space after each comma. A device can be a disk, an unmounted partition, or a file that represents free space on a mounted device. To force device take-over, use the command with the force_device_takeover flag, proceeding with caution.
--acceleration_device_name <NAMES>: Comma-separated list of acceleration device names. Omit the space after each comma.
--sds_name <NAME>: Name assigned to the SDS
--fault_set_id <ID>: Fault Set ID
--fault_set_name <NAME>: Fault Set name
--rmcache_size_mb <SIZE>: Size of the SDS RAM cache in MB. Range: 128 MB to 300GB
--enable_rmcache | --disable_rmcache: Enable/disable RAM cache on the SDS
--sds_port <PORT>: Port associated with the SDS. Default: 7072
--force_clean: Clean a previous SDS configuration. Use this if the SDS was previously part of a PowerFlex system.
--force_device_takeover: Force adding the devices, ignoring data from other SDSs that are stored on the devices.
WARNING:Use this flag with caution. All data saved on the devices will be destroyed.
--test_time <TIME>: The maximum test run-time in seconds. Default: 10. The test will stop when it reaches either this limit, or the time it takes to complete 128 MB of data read/write, whichever is first.
Test options (choose one):: By default, PowerFlex tests the performance of each device being added before before its capacity can be used. Two tests are performed on the given devices: random writes and random reads. When the tests are complete, the device capacity is added automatically to the Protection Domain storage used by the MDM. To modify this behavior, specify one of the test options:

--test_only

Devices will be tested, but not used. To start using their capacity, run the --activate_sds_device command.

--no_test

The device capacity will be used without any device testing.

<BLANK>

Read and write test will be run on devices before their capacity is used.
--profile {compact | high_performance}: Set the performance profile. The default is high_performance.
--i_am_sure: Skip the safety questions for command execution. (For example: “This could damage the stored data. Are you sure?”)

NOTE:If you use the storage_pool_id parameter in the command, you do not need to also specify the Protection Domain ID or name, and the Storage Pool name.

Example

scli --mdm_ip 192.168.1.200 --add_sds --sds_ip 192.168.1.9,192.168.1.29 -sds_ip_role sds_only,sdc_only --protection_domain_name rack_1.1 --device_path /dev/cciss/c0d1p3,/dev/cciss/c0d1p4 --device_name sds01,sds02 --sds_name sds_1

SDS names

Assign each SDS and SDS device a meaningful name in order to facilitate future object identification. This can be particularly helpful for SDS devices, because the defined name remains constant even if the path changes. When a name has not been defined, the system may display default system-defined names that use the SDS’s first IP address.

Each name should conform to the following rules:

Contains fewer than 32 characters
Contains only alphanumeric and punctuation characters
Is unique within the object type

NOTE:PowerFlex objects are assigned a unique ID that can be used to identify the object in CLI commands. You can retrieve the ID via a query or through the object’s property sheet in the PowerFlex GUI.

SDS IP addresses and roles

Configure up to eight IP addresses per SDS. Define each one with one of the following roles:

sdc_only: Communications are enabled only between this SDS and SDCs. The MDM will not be aware of this IP; therefore, internal error-checking will not be performed. If an incorrect IP address is supplied, throughput may be affected.
sds_only: Communications are enabled only between this SDS and other SDS and MDM components.
all (default): Communications are enabled with all components:

You can define a role for every IP address, or use the default for all of them. A situation where all IP addresses are either sdc_only or sds_only is not valid. Each SDS must have one of the following:

At least one IP address with the role all
or
Two IP addresses with the roles sdc_only and sds_only

IP roles can be configured when adding an SDS, by adding a new IP address to an SDS, or by editing a current IP role.

Welcome

Welcome to Dell