Dell EqualLogic PS6210XS EqualLogic Host Integration Tools for Linux Version 1 - Page 73

Examples: Deleting Smart Copies, Example 1: Deleting the Latest Smart Copy

Get Dell EqualLogic PS6210XS PDF manuals and user guides View all Dell EqualLogic PS6210XS manuals
Add to My Manuals
Save this manual to your list of manuals

Page 73 highlights

Search option parameters also apply to this command. For information, see ASMCLI Search Options. The following table describes the optional command parameters. Table 23. Delete Smart Copy Optional Command Parameters Parameter Abbr. Argument Description --broken -B none Deletes broken Smart Copies and attempts to access the group access file for a PS Series group. A broken Smart Copy contains a snapshot or replica snapshot that is missing while the source volume is still accessible. Broken Smart Copies can occur when snapshots are deleted on the PS Series group without using ASM. For information about group access files, see About Group Access Files. --force -F none Deletes the Smart Copy, bypassing a failure if a Smart Copy is broken or unreachable. If a Smart Copy is the last replica and no snapshot exists to ensure consistency of the replicated data on both replication sites, deletes the Smart Copy and as much copied data as possible. --group-access-file -g file-location Specifies the location of the group access file that contains the user names and encrypted passwords. --limit -L number Specifies the maximum number of Smart Copies to delete at one time. The default is 1. Increase this value cautiously. If you specify a large value without sufficiently restrictive search criteria, you might irrevocably delete all of your Smart Copies. Use the list smart-copy command before deleting Smart Copies. --output none always | error Specifies when to display output. Specify always (default) to display all output. Specify error to suppress output unless an operation fails, which is useful for scheduled operations. --unreachable -U none Locates Smart Copies that are unreachable because they fail to connect to the PS Series group or contain a target on the PS Series group that cannot be reached. CAUTION: Use extreme caution when using this option. Any resulting changes in access credentials can affect your ability to connect to a group or to see target volumes on a group. If this situation occurs, the Smart Copies might appear unreachable even though the source volume and its copies are on the PS Series group. If you delete the Smart Copies, ASM cannot locate the source volumes or the copies. This option attempts to access the PS Series group. See About Group Access Files for information about group access files. --user-name -u user-name Specifies a user identity when multiple user names are stored in the group access file. Examples: Deleting Smart Copies This section provides examples of deleting the latest Smart Copy and deleting a Smart Copy by Object ID. Example 1: Deleting the Latest Smart Copy This example deletes the most recently created Smart Copy in the specified source. The Object ID of the Smart Copy is displayed in the results. # asmcli delete smart-copy --source /source/VolC --latest Deleted Smart Copy: a-900d01-d34602f55-6290da94e24343ae Successfully removed the Smart Copy. Auto-Snapshot Manager Command Line Interface 73

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
Search option parameters also apply to this command. For information, see
ASMCLI Search Options
.
The following table describes the optional command parameters.
Table 23. Delete Smart Copy Optional Command Parameters
Parameter
Abbr.
Argument
Description
--broken
-B
none
Deletes broken Smart Copies and attempts to access the group access file for a
PS Series group. A broken Smart Copy contains a snapshot or replica snapshot
that is missing while the source volume is still accessible. Broken Smart Copies can
occur when snapshots are deleted on the PS Series group without using ASM. For
information about group access files, see
About Group Access Files
.
--force
-F
none
Deletes the Smart Copy, bypassing a failure if a Smart Copy is broken or
unreachable. If a Smart Copy is the last replica and no snapshot exists to ensure
consistency of the replicated data on both replication sites, deletes the Smart
Copy and as much copied data as possible.
--group-access-file
-g
file-location
Specifies the location of the group access file that contains the user names and
encrypted passwords.
--limit
-L
number
Specifies the maximum number of Smart Copies to delete at one time. The default
is 1. Increase this value cautiously. If you specify a large value without sufficiently
restrictive search criteria, you might irrevocably delete all of your Smart Copies.
Use the
list smart-copy
command before deleting Smart Copies.
--output
none
always | error
Specifies when to display output. Specify
always
(default) to display all output.
Specify
error
to suppress output unless an operation fails, which is useful for
scheduled operations.
--unreachable
-U
none
Locates Smart Copies that are unreachable because they fail to connect to the PS
Series group or contain a target on the PS Series group that cannot be reached.
CAUTION:
Use extreme caution when using this option. Any resulting changes in
access credentials can affect your ability to connect to a group or to see
target volumes on a group. If this situation occurs, the Smart Copies
might appear unreachable even though the source volume and its copies
are on the PS Series group. If you delete the Smart Copies, ASM cannot
locate the source volumes or the copies. This option attempts to access
the PS Series group.
See
About Group Access Files
for information about group access files.
--user-name
-u
user-name
Specifies a user identity when multiple user names are stored in the group access
file.
Examples: Deleting Smart Copies
This section provides examples of deleting the latest Smart Copy and deleting a Smart Copy by Object ID.
Example 1: Deleting the Latest Smart Copy
This example deletes the most recently created Smart Copy in the specified source. The Object ID of the Smart Copy is displayed in the
results.
# asmcli delete smart-copy --source /source/VolC --latest
Deleted Smart Copy: a-900d01-d34602f55-6290da94e24343ae
Successfully removed the Smart Copy.
Auto-Snapshot Manager Command Line Interface
73