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

Table 29. Update Schedule Command Options, Parameter, Abbr., Argument, Description, Required Parameter

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 85 highlights

The following table describes the required and optional command syntax. Table 29. Update Schedule Command Options Parameter Abbr. Required Parameter Argument Description --name -n schedule-name Specifies the name of the schedule. Optional Parameters --collection -c collection-name Specifies the name of a Smart Copy collection. All Smart Copies, even a single one, are stored in a collection. Do not use with --source. --comment -C comment-string Provides a comment string to describe the Smart Copy that you are updating. The comment is set for the PS Series group and is stored in the backup document. --delete --force -x option Specifies any options to be removed from the schedule. For example, if a comment string is no longer needed, enter --delete comment. -F none Updates the Smart Copy even if one or more mount points cannot be frozen. When updating a Smart Copy, ASM/LE attempts to freeze all mount points. If the freeze operation fails, such as if a file system type does not allow freezing and thawing mount points, this option updates the Smart Copy and updates the Smart Copies, but they might be inconsistent. --freeze-time none n Sets the maximum number of seconds to freeze the file systems when updating a Smart Copy. If this value is exceeded, the operation times out and a consistent Smart Copy is not updated. For most configurations, the default time is sufficient. If you are updating Smart Copies with a significant number of mount points or a heavy I/O load, ASM/LE might not be able to freeze all of the mount points and build the Smart Copy in the default time. Use this option to increase the time limit. --group-access-file -g file-location Specifies the location of the group access file that stores the user names and encrypted passwords. --keep -k n Specifies the maximum number of Smart Copies to keep for the scheduled task. By default, this value is 12. Use this option to prevent too many Smart Copies from accumulating. If more than this number are created, the oldest are deleted until the keep count is reached. If snapshots or replicas were created by ASMCLI, the deleted Smart Copies cause a broken Smart Copy because the backup document refers to snapshots or replicas no longer in the group. --new-name -N new-schedule-name New name for the schedule. --output none error | always Specifies when to display output on the console. Use error to display output only when an operation fails, such as with a scheduled operation. Use always (default) to display all output from the operation. --retry-count -r n Specifies the number of times to retry a failed operation. --retry-wait -w n Specifies the number of seconds to wait before retrying a failed operation. --source -s mount-point Lists one or more mount points to be copied. Do not use with -- collection. --type -t volume type clone| Indicates the type of Smart Copy to create. If omitted, defaults to replica|snapshot| snapshot. ASMCLI displays an error when applying an incorrect thinclone type, such as specifying thinclone for a volume other than a template volume. Auto-Snapshot Manager Command Line Interface 85

  • 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
The following table describes the required and optional command syntax.
Table 29. Update Schedule Command Options
Parameter
Abbr.
Argument
Description
Required Parameter
--name
-n
schedule-name
Specifies the name of the schedule.
Optional Parameters
--collection
-c
collection-name
Specifies the name of a Smart Copy collection. All Smart Copies, even
a single one, are stored in a collection. Do not use with
--source
.
--comment
-C
comment-string
Provides a comment string to describe the Smart Copy that you are
updating. The comment is set for the PS Series group and is stored in
the backup document.
--delete
-x
option
Specifies any options to be removed from the schedule. For example,
if a comment string is no longer needed, enter
--delete comment
.
--force
-F
none
Updates the Smart Copy even if one or more mount points cannot be
frozen. When updating a Smart Copy, ASM/LE attempts to freeze all
mount points. If the freeze operation fails, such as if a file system type
does not allow freezing and thawing mount points, this option updates
the Smart Copy and updates the Smart Copies, but they might be
inconsistent.
--freeze-time
none
n
Sets the maximum number of seconds to freeze the file systems when
updating a Smart Copy. If this value is exceeded, the operation times
out and a consistent Smart Copy is not updated. For most
configurations, the default time is sufficient. If you are updating Smart
Copies with a significant number of mount points or a heavy I/O load,
ASM/LE might not be able to freeze all of the mount points and build
the Smart Copy in the default time. Use this option to increase the
time limit.
--group-access-file
-g
file-location
Specifies the location of the group access file that stores the user
names and encrypted passwords.
--keep
-k
n
Specifies the maximum number of Smart Copies to keep for the
scheduled task. By default, this value is 12. Use this option to prevent
too many Smart Copies from accumulating. If more than this number
are created, the oldest are deleted until the keep count is reached. If
snapshots or replicas were created by ASMCLI, the deleted Smart
Copies cause a broken Smart Copy because the backup document
refers to snapshots or replicas no longer in the group.
--new-name
-N
new-schedule-name
New name for the schedule.
--output
none
error | always
Specifies when to display output on the console. Use
error
to display
output only when an operation fails, such as with a scheduled
operation. Use
always
(default) to display all output from the
operation.
--retry-count
-r
n
Specifies the number of times to retry a failed operation.
--retry-wait
-w
n
Specifies the number of seconds to wait before retrying a failed
operation.
--source
-s
mount-point
Lists one or more mount points to be copied. Do not use with
--
collection
.
--type
-t
volume type
clone|
replica|snapshot|
thinclone
Indicates the type of Smart Copy to create. If omitted, defaults to
snapshot
. ASMCLI displays an error when applying an incorrect
type, such as specifying
thinclone
for a volume other than a
template volume.
Auto-Snapshot Manager Command Line Interface
85