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

Example: Creating Schedules, Listing Schedules, asmcli list schedule Command Syntax

Page 80 highlights

Option Abbr. --group-access-file -g --keep -K --output none --retry-count -r --retry-wait -w --type -t --user-name -u Argument Description the operation times out and a consistent Smart Copy is not created. For most configurations, the default time is sufficient. When creating Smart Copies with a large number of mount points or a heavy I/O load, ASM/LE might not have enough time to freeze all of the mount points and build the Smart Copy. Use this option to increase the time limit. file-location Specifies the location of the group access file that stores the user names and encrypted passwords. n Specifies the maximum number of Smart Copies to keep for the scheduled task. By default, this value is 12. This option prevents too many Smart Copies from accumulating. If more than this number are created, the oldest is deleted until the keep count is reached. If ASMCLI created snapshots or replicas, the deleted Smart Copies result in a broken Smart Copy because the backup document refers to snapshots or replicas no longer in the group. always|error Specifies when to display output to 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. n Specifies the number of times to retry a failed operation. n Specifies the number of seconds to wait before retrying a failed operation. volume type replica|snapshot Specifies the Smart Copy type to create. If omitted, creates snapshot. ASMCLI reports an error if an incorrect type is applied, such as thinclone for a volume that is not a template volume. user-name Specifies a particular user identity when multiple user names have been stored in the group access file. Example: Creating Schedules The following example creates a schedule named user-hourly to capture user activity over a 24-hour period. After creating a schedule, enable it using the asmcli do schedule command. For an example, see Running a Schedule. # asmcli create schedule --source /source/VolB --comment "Hourly snapshot of user space" --keep 24 --name user-hourly Successfully created schedule "user-hourly". Listing Schedules Use the asmcli list schedule command to list Smart Copies created by a given schedule. The command option lets you specify all schedules or a specific schedule with the name that you supplied when creating the schedule (see Creating a Schedule). asmcli list schedule Command Syntax The command syntax is as follows: # asmcli list schedule [--name=schedule-name | -n] The following table describes the optional command parameter. 80 Auto-Snapshot Manager Command Line Interface

  • 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

Option
Abbr.
Argument
Description
the operation times out and a consistent Smart Copy is not
created. For most configurations, the default time is sufficient.
When creating Smart Copies with a large number of mount
points or a heavy I/O load, ASM/LE might not have enough time
to freeze all of the mount points and build the Smart Copy. 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. This option prevents
too many Smart Copies from accumulating. If more than this
number are created, the oldest is deleted until the keep count is
reached. If ASMCLI created snapshots or replicas, the deleted
Smart Copies result in a broken Smart Copy because the backup
document refers to snapshots or replicas no longer in the group.
--output
none
always|error
Specifies when to display output to 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.
--type
-t
volume type
replica|snapshot
Specifies the Smart Copy type to create. If omitted, creates
snapshot
. ASMCLI reports an error if an incorrect type is
applied, such as
thinclone
for a volume that is not a template
volume.
--user-name
-u
user-name
Specifies a particular user identity when multiple user names
have been stored in the group access file.
Example: Creating Schedules
The following example creates a schedule named
user-hourly
to capture user activity over a 24-hour period. After creating a schedule,
enable it using the
asmcli do schedule
command. For an example, see
Running a Schedule
.
# asmcli create schedule --source /source/VolB --comment
"Hourly snapshot of user space" --keep 24 --name user-hourly
Successfully created schedule "user-hourly".
Listing Schedules
Use the
asmcli list schedule
command to list Smart Copies created by a given schedule. The command option lets you specify all
schedules or a specific schedule with the name that you supplied when creating the schedule (see
Creating a Schedule
).
asmcli list schedule Command Syntax
The command syntax is as follows:
# asmcli list schedule
[--name=
schedule-name
| -n]
The following table describes the optional command parameter.
80
Auto-Snapshot Manager Command Line Interface