Dell EMC Solutions Enabler 9.2 SRDF Family CLI User Guide

PDF

symrdf command options

The following table summarizes the options for the symrdf command. Refer to the symrdf man page for more detailed descriptions of the command's options.

Table 1. symrdf command options
Option	Description
-all	Targets the SRDF action at all devices in the device group, which includes standard SRDF devices and any BCV SRDF devices that are locally associated with the device. When used with list , the -all option shows all SRDF mirrors of the selected devices. The -all flag is not supported for SRDF control operations on device groups or composite groups with type ANY.
-autostart	Specifies whether SRDF/A DSE is automatically activated when an SRDF/A session is on (Enabled) or off (Disabled) for the SRDF group. Valid values are on (Enabled) or off (Disabled). NOTE:AutoStart for DSE is enabled by default in HYPERMAX OS.
-bcv	Targets the specified BCV devices associated with a device or composite group and are configured as SRDF BCV devices. By default, only the SRDF standard devices are affected by the SRDF control operations.
-bias	Sets the bias to the R1 or R2 device. The device that has the bias set, will be exported as the R1. When the RDF link becomes Not Ready (NR), the bias device will be made accessible to the host and the non-bias device will be made not accessible to the host. This action can only be executed if the SRDF devices in the group are in the ActiveBias RDF pair state.
-brbcv	Targets the SRDF action at the specified remotely associated SRDF (Hop 2) BCV devices that can be paired with the remote mirrors of the local BCV devices.
-both_sides	Targets the SRDF control operation at both sides of an SRDF link.
-bypass	Causes the SRDF control operation to bypass existing exclusive locks. Use this option ONLY if no other SRDF operation is in progress at either the local and/or remote arrays.
-c	Counts the number of times to display or to attempt acquiring exclusive locks on the host database, the local array, and the remote arrays. If the -c option is not specified and an interval -i is specified, the program loops continuously to produce infinite redisplays, or until the SRDF control or set operation starts.
-cg	Specifies the composite group for SRDF operations.
-exempt	Allows devices to be added, removed, or suspended without affecting the state of the SRDF/A or SRDF/Metro session or requiring that other devices in the session be suspended. Used for an SRDF group supporting an active SRDF/A session or an active SRDF/Metro session. When used with list operations, lists devices that are consistency exempt or that are paired with devices that are consistency exempt, and lists devices that are exempt within an SRDF/Metro session.
-fibre	Uses the Fibre Channel communication protocol.
-file `Filename`	Specifies the device file for SRDF operations.
-force	Performs the control operations on SRDF devices that are not in the expected state for a control operation. By using this option, the control operation is attempted, regardless of the pair state of the SRDF devices, and according to the rules in Chapter SRDF operations and pair states in the Solutions Enabler SRDF Family State Tables Guide.
-format	Used with createpair to clear all tracks on the R1 and R2 sides, ensuring no data exists on either side. In configurations other than SRDF/Metro the option also makes the R1 read write to the host. In SRDF/Metro configurations, the option enables the addition of device pairs to an active group, and makes both sides of the pair read write to the host.
-full	Requests a full establish or restore operation.
-g `GroupName`	Specifies the device group for SRDF operations.
-h	Provides brief, online help.
-hop2	For cascaded configurations, specifies a group's second-hop devices.
-hop2_rdfg	Used with the createpair command that specifies a storage group. Specifies the SRDF group number at the second hop. Used only with createpair -hop2 when creating pairs using storage groups.
-hwcomp	Enables or disables hardware compression, which minimizes the amount of data to transmit over an SRDF link.
-i	Executes a command at repeat intervals to display information or to attempt to acquire an exclusive lock on the host database, the local array, and the remote arrays. The default interval is 10 seconds. The minimum interval is 5 seconds.
-immediate	Applies only to SRDF/A-backed devices. Causes failover, split, and suspend actions to drop the SRDF/A session immediately.
-keep	Sets the winner side of the SRDF/Metro group to the R1 or the R2 side, as specified. When the RDF link becomes Not Ready (NR), devices on the winner side will be made accessible to the host and devices on the loser (non-winner) side will be made inaccessible to the host. This option can only be used when the SRDF devices in the group are in the Active RDF mode. When used with movepair, this option can be used when moving devices out of the SRDF/Metro group but not when moving devices into the group.
-label	Specifies a label for a dynamic SRDF group.
-noecho	Suppresses the display of progress status information.
-noprompt	Suppresses the message asking you to confirm an SRDF control operation.
-nowd	Bypasses the check to ensure the target of the operation is not writable by the host.
-offline	Obtains the data strictly from the configuration database. No connections are made to any arrays. The symrdf command uses information previously gathered from the array and held in the host database as opposed to interrogating the array directly. The offline option can alternatively be set by assigning the environment variable SYMCLI_OFFLINE to 1.
-rdfa_devpace	Indicates the operation affects the SRDF/A device-level write pacing feature.
-rdfa_dse	Indicates the operation affects the SRDF/A Delta Set Extension (DSE) feature.
-metro	When used with the createpair action, indicates the SRDF pairs will be created in an SRDF/Metro configuration.
-rdfa_pace	Indicates the operation affects both the group-level and the device-level components of the SRDF/A write pacing feature.
-rdfa_wpace	Indicates the operation affects the SRDF/A group-level write pacing feature.
-rdfa_wpace_exempt	Excludes the specified devices from SRDF/A group-level write pacing.
-rdfg	Targets a specific SRDF group number. When used -sg createpair -hop2, identifies the SRDF group associated with the specified storage group. NOTE: -hop2_rdfg specifies the SRDF group used to create the hop2 pair.
-rdf_mode	Used in createpair to set the SRDF mode of device pairs to one of the following: synchronous (sync), semi-synchronous (semi), asynchronous (async), adaptive copy disk mode (acp_disk), or adaptive copy write pending mode (acp_wp). NOTE:Adaptive copy write pending mode (acp_wp) is not supported when the R1 side of the RDF pair is on an array running HYPERMAX OS.
-refresh	Marks the source (R1) devices or the target (R2) devices to refresh from the remote mirror.
-remote	Requests a remote data copy with the failback , restore , resume, createpair and update actions. When the concurrent links are ready, data is also copied to the concurrent SRDF mirror. For these actions to execute, use this option or suspend the concurrent links.
-remote_rdfg	Specifies the SRDF group number for the remote array.
-remote_sg	Specifies the remote storage group name. Used with createpair to specify the storage group. Used with createpair -hop2 to specify the storage group at the second hop.
-remote_sid	Specifies the remote array ID.
-restore	Used with failover to swap the R1 and R2 and restore the invalid tracks on the new R2 side (formerly R1) to the new R1 side (formerly R2). For more information, refer to Dynamic failover restore
-rp	Used with -establish\|-restore, createpair, failback, merge, restore, resume, update, and refresh to allow the operation even when one or more devices are tagged for RecoverPoint. When used with refresh, only allowed for refresh R1.
-rrbcv	Targets the SRDF action at the specified remotely associated SRDF (Hop 2) BCV devices, which can be paired with the remote mirrors of the local standard devices.
-sg	Specifies a storage group for SRDF operations. NOTE:To manage RDF using SGs, the SG being managed cannot have a mixture of R1 and R2 devices and the RDF group specified must exist on all of the devices in the SG.
-sid	Specifies the local array ID.
-swcomp	Enables or disables software compression, which minimizes the amount of data to transmit over an SRDF link.
-symforce	Requests that the array force an operation by overriding all instances causing the array to reject an operation. The SYMAPI_ALLOW_RDF_SYMFORCE setting in the options file must be set to TRUE to use -symforce. With -symforce, a split command executes on an SRDF pair, even during a sync in progress state. NOTE:Use caution when applying this option as data can become lost or corrupted.
-until	Checks the number of invalid tracks that are allowed to build up from the active R2 local I/O before another update (R2 to R1) copy is retriggered. The update sequence loops until the invalid track count is less than the number specified for the -until value. Refer to Write disable R1 for more information.
-use_bias	When used with createpair -establish, createpair -restore, establish or restore actions, indicates that SRDF/Metro configuration will use bias instead of Witness protection.
-v	Provides more detailed, verbose command output.
-witness	When used with addgrp, identifies the RDF group as a Witness SRDF group. When used with removegrp or modifygrp, specifies the action is targeted for an RDF group which is a Witness SRDF group.