CLI Guide

ds dd create
Creates a new distributed-device.
Contexts
All contexts.
Syntax
ds dd create
[-n|name] name
[-d|--devices] context-path [,contextpath,...]
[-l|--logging-volumes] context-path [,context-path,...]
[-r| rule-set] rule-set
[-s|--source-leg] context-path
[-f|--force]
Arguments
Required arguments
[-n|--name] name * The name of the new distributed device. Must be unique across the metro node.
[-d|--devices]
context-path [, context-
path,...]
* List of one or more local devices that will be legs in the new distributed device.
[-l|--logging-
volume] context-path
[, context-path,...]
List of one or more logging volumes to use with this device. If no logging volume is specified, a
logging volume is automatically selected from any available logging volume that has sufficient space
for the required entries. If no available logging volume exists, an error message is returned.
Optional arguments
[-r|--rule-set]
rule-set
The rule-set to apply to the new distributed device. If the --rule-set argument is omitted, the
cluster that is local to the management server is assumed to be the winner in the event of an
inter-cluster link failure.
[-s|--source-leg]
context-path
Specifies one of the local devices to use as the source data image for the new device. The
command copies data from the source-leg to the other legs of the new device.
[-f|--force]
Forces a rule-set with a potential conflict to be applied to the new distributed device.
* - argument is positional.
Description
The new distributed device consists of two legs; local devices on each cluster.
WARNING:
Without --source-leg, a device created by this command does not initialize its legs, or
synchronize the contents of the legs. Because of this, consecutive reads of the same block may return different
results for blocks that have never been written. Host reads at different clusters are almost certain to return
different results for the same unwritten block, unless the legs already contain the same data. Do not use this
command without --source-leg unless you plan to initialize the new device using host tools
150 Commands