CLI Guide

[-n|--cancel]
Arguments
Required arguments
[-d|--distributed-
devices] context-path,
context-path...
One or more distributed devices for which segments of the specified logging volume are allocated/
unallocated.
All components of the distributed-device are included.
[-c|--distributed-
device-component]
context-path
The distributed device component for which segments of the specified logging volume are
allocated/unallocated.
[-l|--logging-
volume] context-path,
context-path...
One or more logging-volumes where the logging volume segments are allocated/unallocated. The
target volume must be created as logging-volume.
If not specified, the metro node configuration automatically allocates a logging volume for each
cluster.
Optional arguments
[-n|--cancel]
Cancel/unallocate the log setting for the specified component of a distributed device or all the
components of the specified distributed device.
WARNING: Use the --cancel argument very carefully.
the command issues a warning message if you attempt to cancel logging volumes on a
distributed device.
Removing the logging-volume for a device deletes the existing logging entries for
that device. A FULL rebuild of the device occurs after a link failure and recovery.
Removing the logging volume for all distributed devices removes all entries from the
logging volume. In the event of a link failure and recovery, this results in a FULL
rebuild of all distributed devices.
Description
Logging volumes keep track of 4 k byte blocks written during an inter-cluster link failure. When the link recovers, metro node
uses the information in logging volumes to synchronize the mirrors.
WARNING:
If no logging volume is allocated to a distributed device, a full rebuild of the deviceoccurs when the
inter-cluster link is restored after an outage.
Do not change a device’s logging volume unless the existing logging-volume is corrupted or unreachable, or to
move the logging volume to a new disk.
Use the ds dd set-log command only to repair a corrupted logging volume or to transfer logging to a new disk.
Use the --distributed-devices argument to allocate/unallocate segments on the specified logging volume to the
specified device.
Use the --distributed-devices-component argument to allocate/unallocate segments on the specified logging volume
to the specified device component.
NOTE:
Specify either distributed devices or distributed device components. Do not mix devices and components in the
same command.
If the logging volume specified by the --logging-volume argument does not exist, it is created.
Use the --cancel argument to delete the log setting for a specified device or device component.
This command can fail if there is not a sufficient number of meta volume slots. See the troubleshooting procedures for metro
node in the SolVe Desktop for a resolution to this problem.
Commands
155