This section describes environment definition commands for backup management.
Note
All environment definition commands require that a Tape Server and its daemon be started in advance. Otherwise, when one of the commands is executed, it outputs a message and terminates with an error.
NAME
acmsvrset - Setting of Storage server configuration information
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmsvrset [-t Tape-Server][For Windows]
program-directory\bin\acmsvrset [-t Tape-Server]DESCRIPTION
This command sets configuration information of a Storage Server. Execute this command to declare that the Storage Server that executed this command is an associated participant in the backup operation.
This command associates the specified Tape Server with a Storage Server. The Tape Server specified by this command manages backup to tape. The tape backup function cannot be used on a Storage Server not associated with the Tape Server.
If the server name, IP address, or port number of the Tape Server is changed, this command must be executed again to associate the Tape Server with the Storage Server.
OPTIONS
Specifies the name of the Tape Server to be associated with the Storage Server.
This option is required when this command is initially executed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
The command sets configuration information about the Storage Server and associates the server with the Tape Server (tpserver1).
# /opt/FJSVswstc/bin/acmsvrset -t tpserver1 acmsvrset completed #
NOTES
The Storage Server configuration information cannot be set in the following cases:
The -t option is omitted at the time of initial execution.
The -t option is specified, Storage Server configuration information is already set, and a tape backup policy is set for an existing transaction volume.
The specified Tape Server is not registered with the Storage Management Server.
If Tape Server functions are installed later in a Storage Server or Storage Management Server, that server is not recognized as a Tape Server. In order for it to be recognized as a Tape Server, 11.3.5 stgxfwcmmodsrv (Server information change command) must be executed.
This command can be executed only while none of the following commands are running:
swstsvrset (Storage Server configuration command)
swstbkpolset (Backup policy setting command)
swstbkpoldel (Backup policy deletion command)
swstbackup (Backup execution command)
swstrestore (Restore execution command)
swstcancelrest (Restore cancellation command)
swststartsync (Backup synchronous processing start command)
swstcancelsync (Backup synchronous processing cancel command)
swstdevinfoset (Device configuration command)
swsthistdel (History information deletion command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
swstsrsemtch (Resource match command)
NAME
acmsvrdisp - Display of configuration information of a Storage Server
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmsvrdisp
[For Windows]
program-directory\bin\acmsvrdisp
DESCRIPTION
This command displays configuration information of a Storage Server, which has been set using the "11.2.1.1 acmsvrset (Storage Server configuration command)".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
This command displays Storage Server (srv1) configuration information.
# /opt/FJSVswstc/bin/acmsvrdisp Storage-Server = srv1 Tape-Server = tpserver1(10.10.10.10:1226) #
The following information will be displayed.
Title | Description |
|---|---|
Storage-Server | Displays a Storage Server name. |
Tape-Server | Displays a Tape Server name. The IP address and port number used for communication with the Tape Server are delimited by a colon (":") and displayed in parentheses. Tape-Server = "Tape-Server-Name"("IP-Address":"PORT-NUMBER") |
NAME
acmdevinfoset - Setting of device information
SYNOPSIS
[For Solaris/Linux]
/opt/FJSVswstc/bin/acmdevinfoset { -t [-Xlu] | -b | -o } Device-Name[For HP-UX/AIX]
/opt/FJSVswstc/bin/acmdevinfoset -t | -b | -o Device-Name[For Windows]
program-directory\bin\acmdevinfoset { -t [-Xlu] | -b | -o } Device-NameDESCRIPTION
Set a volume that has been allocated to the Fujitsu ETERNUS storage system as a transaction volume or backup volume.
A transaction volume refers to a volume that stores work data to be backed up.
A backup volume refers to a volume used to store a backup of this transaction data.
For details on devices that can be registered on Windows as transaction and backup volumes, refer to "swstdevinfoset (Device information configuration command)" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
OPTIONS
Registers the specified device as a transaction volume.
Cannot be specified at the same time as the -b or -o options.
Registers the specified device as a backup volume.
Cannot be specified at the same time as the -t or -o options.
Deregisters the specified device if it has been registered as a work or backup volume.
Cannot be specified at the same time as the -t or -b options.
Specify when a LU (disk) is set as a transaction volume. If this option is not specified, a LU (disk) cannot be set as a transaction volume.
This option can be specified only for LU (disk) volumes. An error occurs if this option is set for other volumes.
OPERANDS
If the Storage Server is Solaris, Linux, HP-UX or AIX, specifies a block device name of a transaction volume.
If the Storage Server is Windows, specifies the AdvancedCopy Manager device name that corresponds to the transaction volume. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
For partition (slice) units
Register a device (/dev/dsk/c1t0d0s6) as a transaction volume.
# /opt/FJSVswstc/bin/acmdevinfoset -t /dev/dsk/c1t0d0s6 acmdevinfoset completed #
Register a device (/dev/dsk/c1t0d2s6) as a backup volume.
# /opt/FJSVswstc/bin/acmdevinfoset -b /dev/dsk/c1t0d2s6 acmdevinfoset completed #
Deregister a device (/dev/dsk/c1t0d0s6) that has been registered as a transaction volume.
# /opt/FJSVswstc/bin/acmdevinfoset -o /dev/dsk/c1t0d0s6 acmdevinfoset completed #
For a LU (disk)
Register a Solaris LU (disk) device (/dev/dsk/c1t1d0s2) as a transaction volume.
# /opt/FJSVswstc/bin/acmdevinfoset -t -Xlu /dev/dsk/c1t1d0s2
Register a Linux LU (disk) device (/dev/sde) as a transaction volume.
# /opt/FJSVswstc/bin/acmdevinfoset -t -Xlu /dev/sde
Register a Windows LU (disk) device (g1d173) as a transaction volume.
C:\>C:\Win32app\AdvancedCopyManager\bin\acmdevinfoset -t -Xlu g1d173
NOTES
A device cannot be registered as a transaction volume if:
Another device with the same logical volume information (cabinet identifier, OLU number, EXTENT start position, and EXTENT size) has already been registered as a transaction volume.
The space of the device to be registered overlaps the space of an already registered transaction or backup volume.
A device cannot be registered as a backup volume if:
Another device with the same logical volume information (cabinet identifier, OLU number, EXTENT start position, and EXTENT size) has already been registered as a transaction volume.
The space of the device to be registered overlaps the space of an already registered transaction or backup volume.
The device to be set up is already mounted.
The device is an SDX object.
The device to be set up is registered as a replication destination volume of replication management.
When the device to be set up is registered as replication source volume of the duplicate volume information in which the bi-directional copy of replication management is possible.
You must delete related backup history information before:
Changing a backup volume to a transaction volume
Canceling the configuration of a backup volume
You must delete a backup policy specified on a transaction volume before:
Changing a transaction volume to a backup volume
Canceling the setting of a transaction volume
To perform the following changes, the related tracking processing (OPC session) must be canceled in advance:
Changing the settings of a transaction volume in tracking processing
Changing the settings of a backup volume in tracking processing
The following changes are not possible unless the related synchronous processing (ie, the EC session) is cancelled:
Changing a setting of a suspended transaction volume
Changing a setting of a suspended backup volume
For details on how to use SDX objects of GDS, refer to "5.7.2.1 Configuration and conditions of unsupported SDX objects" and "13.1.5 Notes on SDX Object Operations".
This command can be executed only while none of the following commands are running:
swstsvrset (Storage Server configuration command)
swstbkpolset (Backup policy setting command)
swstbkpoldel (Backup policy deletion command)
swstbackup (Backup execution command)
swstrestore (Restore execution command)
swstcancelrest (Restore cancellation command)
swststartsync (Backup synchronous processing start command)
swstcancelsync (Backup synchronous processing cancel command)
swstdevinfoset (Device configuration command)
swsthistdel (History information deletion command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
swstsrsemtch (Resource match command)
NAME
acmdevdisp - Display of device information
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmdevdisp [-t] [-b [-u]] [-o] [Device-Name][For Windows]
program-directory\bin\acmdevdisp [-t] [-b [-u]] [-o] [Device-Name]DESCRIPTION
This command displays information on the transaction volumes, backup volumes, and other applicable devices that have been set up using "11.2.1.3 acmdevinfoset (Device information setting command)".
OPTIONS
Information about a device that has been set as a transaction volume will be displayed if the t, b, and o options are all omitted.
Displays information about a device that has been set as a transaction volume.
Displays device information for all the transaction volumes, if the device name in an operand is omitted.
Displays information about a device that has been set as a backup volume.
Displays device information for all the backup volumes, if the device name in an operand is omitted.
Changes the display format for the Device Mode column (normally "Backup (used)") for backup volumes in the suspend or tracking status for which history information was deleted.
Displays information about all the devices other than those set as a transaction or backup volume.
Displays information about all the devices other than those set as a transaction or backup volume, if the device name in an operand is omitted.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies a block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
If this operand and the options are omitted, device information on all the transaction volumes will be displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the use status of the registered devices.
# /opt/FJSVswstc/bin/acmdevdisp -tb Server Device Size Device-Mode Mount-Point (Method) Backup-Engine srv2 /dev/dsk/c1t0d0s6 1.0 Gbyte Transaction /mnt/tran1 (ufs) AdvancedCopy srv2 /dev/dsk/c1t1d0s6 1.0 Gbyte Transaction ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d2s6 1.0 Gbyte Backup (used) ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d2s3 1.0 Gbyte Backup (free) ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d7s6 2.0 Gbyte Backup (free) ---- (----) AdvancedCopy srv2 /dev/dsk/c1t0d7s3 2.0 Gbyte Backup (free) ---- (----) AdvancedCopy : #
The following information will be displayed.
Title | Description |
|---|---|
Server | Displays a Storage Server name. |
Device | For Solaris, Linux, HP-UX or AIX, displays a device name. For Windows, displays an AdvancedCopy Manager device name. |
Size | Displays the size of a partition allocated to a device. |
Device-Mode | Displays a character string by which a device can be identified.
A backup volume is indicated as "Backup (used)" if it is being used or "Backup (free)" if it is not being used. If a backup process is executed with -suspend specified, or if a differential snapshot backup is executed, the backup volume remains in use after history information is deleted. With the -u option specified, "Backup (used-S)" is displayed for a backup volume in the suspend status for which history information has been deleted. "Backup (used-T)" is displayed for a backup volume in the tracking status for which history information has been deleted. |
Mount-Point (Method) | For Solaris, Linux, HP-UX, this displays the mount point of a device. The file system type of the mount point is displayed in parentheses. For Windows, displays the drive letter of a device. The file system type of the device is displayed in parentheses. For AIX, always displays "---- (----)". |
Backup-Engine | Always displays the following: "AdvancedCopy": Indicates backup operation with AdvancedCopy Manager. |
NAME
acmbkpolset - Setting of policy for disk backup
SYNOPSIS
[For Solaris/Linux]
/opt/FJSVswstc/bin/acmbkpolset [-i Interval-Days] [-s Save-Number] [Device-Name]
[For HP-UX/AIX]
/opt/FJSVswstc/bin/acmbkpolset [-i Interval-Days] [-s Save-Number] [Device-Name]
[For Windows]
program-directory\bin\acmbkpolset [-i Interval-Days] [-s Save-Number] [Device-Name]
DESCRIPTION
This command sets a backup policy (ie, numbers of preservation generations and interval days). The number of preservation generations means how many generations of backup data should be kept. The number of interval days means the number of days after the execution of backup that the next backup should be performed.
Unless a disk is used as backup media, this command is not required.
OPTIONS
Specifies the number of interval days. You can specify a value between 1 and 366. If this option is omitted during initial registration, 30 will be set as the default. If this option is omitted during update, the existing value will be inherited.
Specifies the number of preservation generations. You can specify a value between 1 and 31. If this option is omitted during initial registration, 2 will be set as the default. If this option is omitted during update, the existing value will be inherited.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies a device name. For information about the devices that can be specified, refers to "1.6 Supported Devices of Tape Backup of AdvancedCopy Manager".
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
If the device name is omitted, the backup policy will be set for all the transaction volumes.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To set 3 as the number of preservation generations for a transaction volume (/dev/dsk/c1t0d5s3):
# /opt/FJSVswstc/bin/acmbkpolset -s 3 /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmbkpolset completed #
NOTES
Even if the number of interval days is specified, AdvancedCopy Manager does not automatically create a backup.
When you specify a backup policy, there must be as many backup volumes in operation as specified in the policy.
To view information on the number of backup volumes required for an ordinary backup, refer to "Preparing a backup volume" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide" for the operating system of the target Storage Server.
If this command is executed without a transaction volume name, the same backup policy is set for all transaction volumes.
You can change of the number of preservation generations as long as the history information count at the time is equal to or less than the number of preservation generations to be specified.
Ordinary transaction volumes must be backed up to ordinary backup volumes.
If the transaction volume is a GDS logical volume, the backup destination must be a backup volume of a GDS logical volume.
The backup policy cannot be set if:
There are not as many backup volumes as the specified number of preservation generations.
The specified number of preservation generations is greater than the maximum allowed.
The specified number of interval days is greater than the maximum allowed.
For details on how to use SDX objects of GDS, refer to "5.7.2.1 Configuration and conditions of unsupported SDX objects" and "13.1.5 Notes on SDX Object Operations".
This command can be executed only if none of the following commands is running:
swstsrsemtch (Resource match command)
Device configuration command (swstdevinfoset)
Storage Server configuration command (swstsvrset)
Resource backup command (swstresback)
Resource restore command (swstresrst)
NAME
acmbkpoldisp - Display of policy for disk backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmbkpoldisp [Device-Name][For Windows]
program-directory\bin\acmbkpoldisp [Device-Name]DESCRIPTION
This command displays a backup policy that has been set for a transaction volume.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name of the transaction volume.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
If the device name is omitted, a backup policy for a transaction volume with a registered backup policy will be displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To display the backup policies of a transaction volume (/dev/dsk/c1t0d5s3):
# /opt/FJSVswstc/bin/acmbkpoldisp /dev/dsk/c1t0d5s3 Server Device Interval-Days Save-Number Mount-Point (Method) Transaction2 /dev/dsk/c1t0d5s3 30 2 /stg(ufs) #
The following information will be displayed.
Title | Description |
|---|---|
Server | Displays the Storage Server name. |
Device | For Solaris, Linux, HP-UX or AIX, displays the device name. For Windows, displays the AdvancedCopy Manager device name. |
Interval-Days | Displays the number of interval days. |
Save-Number | Displays the number of preservation generations. |
Mount-Point (Method) | For Solaris, Linux, HP-UX or AIX, displays the mount point of a device. The file system type of the mount point will be displayed in parentheses. For Windows, displays the drive letter of a device. The file system type of the device is displayed in parentheses. |
NAME
acmbkpoldel - Deletion of policy for disk backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmbkpoldel Device-Name[For Windows]
program-directory\bin\acmbkpoldel Device-NameDESCRIPTION
This command deletes a backup policy that has been set.
If the transaction volume to be deleted has backup history information, delete the backup history information before executing this command.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specify the block device name of the transaction volume.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To delete the backup policies of a transaction volume (/dev/dsk/c1t0d5s3):
# /opt/FJSVswstc/bin/acmbkpoldel /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmbkpoldel completed #
NOTES
A backup policy cannot be deleted if:
The transaction volume to be deleted has backup history information.
A transaction volume whose backup policies are to be deleted has already started backup synchronous processing.
This command can only be executed when none of the following commands are running:
swstsrsemtch (Resource match command)
swstdevinfoset (Device configuration command)
swstsvrset (Storage Server configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
NAME
acmtpbkpolset - Setting of policy for tape backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpbkpolset [-i backup-interval-days] [-d archive-interval-days] [-c Management-Class-Name] Device-Name
[For Windows]
program-directory\bin\acmtpbkpolset [-i backup-interval-days] [-d archive-interval-days] [-c Management-Class-Name] Device-Name
DESCRIPTION
This command sets a tape backup policy for a transaction volume and log group.
No backup operation can be performed without a set tape backup policy.
OPTIONS
Specifies the number of interval days for making a generation management backup.
A number ranging from 1 to 366 can be specified. If this option is omitted in initial registration, 30 is used as the default. If the option is omitted in an update, the currently set value is used.
Specifies the number of interval days for making a day management backup.
A number ranging from 1 to 366 can be specified. If this option is omitted in initial registration, 30 is used as the default. If the option is omitted in an update, the currently set value is used.
Specifies the name of a tape backup management class.
A class name that is already set for another transaction volume can also be specified.
This option must be specified in initial registration. If the option is omitted in an update, the tape backup management class that is already set is used.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies a device name.
For information about the devices that can be specified, refer to "1.6 Supported Devices of Tape Backup of AdvancedCopy Manager".
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Set a tape backup policy with the specified transaction volume (/dev/dsk/c1t0d5s3). ACM_CLASS2 is specified as the tape backup management class, and 10 days is specified as the number of interval days (generation management).
# /opt/FJSVswstc/bin/acmtpbkpolset -i 10 -c ACM_CLASS2 /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmtpbkpolset completed #
NOTES
Even if the number of interval days is specified, Tape Backup of AdvancedCopy Manager does not automatically create a backup.
To set a tape backup policy, create a tape backup management class in advance for the Storage Server for which the policy is to be set. Without a tape backup management class, a tape backup policy cannot be set.
For details, refer to "11.2.1.11 acmtpmgmtclassset (Tape backup management class setting command)".
A backup policy cannot be set in the following cases:
The number of interval days specified in an option exceeds the limit.
The -c option is omitted in initial registration.
The specified backup management class has not been created on the Storage Server.
This command cannot be executed if any of the following commands is being executed:
swstsrsemtch (Resource matching command)
swstdevinfoset (Device configuration command)
swstsvrset (Storage Server configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
NAME
acmtpbkpoldisp - Display of policy for tape backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpbkpoldisp [Device-Name][For Windows]
program-directory\bin\acmtpbkpoldisp [Device-Name]DESCRIPTION
This command displays the tape backup policies that are set for transaction volumes.
OPERANDS
For Solaris, Linux, HP-UX or AIX, specifies the block device name.
For Windows, specifies the AdvancedCopy Manager device name. For details on the AdvancedCopy Manager device name, refer to "Managing a Device on AdvancedCopy Manager" in the "ETERNUS SF AdvancedCopy Manager Operator's Guide [For Windows]".
If the Device-Name operand is omitted, this command displays all the registered tape backup policies of transaction volumes.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the backup policy for a transaction volume (/dev/dsk/c1t0d5s3).
# /opt/FJSVswstc/bin/acmtpbkpoldisp /dev/dsk/c1t0d5s3 Server Device Backup-Interval-Days Archive-Interval-Days ManagementClassName Mount-Point (Method) srv2 /dev/dsk/c1t0d5s3 30 2 ACM-CLASS1 /stg(ufs) #
The table below lists displayed information items.
Title | Description |
|---|---|
Server | Displays the Storage Server name. |
Device | Displays the device name. |
Backup-Interval-Days | Displays the number of interval days for generation management. |
Archive-Interval-Days | Displays the number of interval days for day management. |
ManagementClassName | Displays the name of a tape backup management class. |
Mount-Point (Method) | For Solaris, Linux, HP-UX or AIX, displays a device mount point name followed by the type of mount point file system, displayed in parentheses. For Windows, displays the AdvancedCopy Manager device name. |
NAME
acmtpbkpoldel - Deletion of policy for tape backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpbkpoldel Device-Name[For Windows]
program-directory\bin\acmtpbkpoldel Device-NameDESCRIPTION
This command deletes a set tape backup policy.
If there is backup history information for a transaction volume associated with the tape backup policy to be deleted, delete the backup history information before executing the command.
OPERANDS
Specifies the block device name.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Delete the backup policies of a transaction volume (/dev/dsk/c1t0d5s3):
# /opt/FJSVswstc/bin/acmtpbkpoldel /dev/dsk/c1t0d5s3 /dev/dsk/c1t0d5s3 acmtpbkpoldel completed #
NOTES
A tape backup policy cannot be deleted in the following cases:
Tape backup history information remains for a transaction volume associated with the policy to be deleted.
A transaction volume associated with the policy to be deleted is being processed.
This command cannot be executed if any of the following commands is being executed:
swstsrsemtch (Resource matching command)
swstdevinfoset (Device configuration command)
swstsvrset (Storage Server configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
NAME
acmtpmgmtclassset - Setting of management class for tape backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpmgmtclassset [-g gen_pool] [-d day_pool] [-s save-number] [-t limit-day] Management-Class-Name
[For Windows]
program-directory\bin\acmtpmgmtclassset [-g gen_pool] [-d day_pool] [-s save-number] [-t limit-day] Management-Class-Name
DESCRIPTION
This command sets a tape backup management class.
OPTIONS
Sets the "generation management backup destination" specified in gen_pool.
Specify the name of the primary storage pool used as the backup destination for generation management. The primary storage pool must be created with TSM in advance. Set it in a TSM backup copy group.
This option must be specified in initial registration. If the option is omitted in an update, the currently set value is used.
Sets the day management backup destination specified in day pool.
Specify the name of the primary storage pool used as the backup destination for day management. The primary storage pool must be created with TSM in advance. Set it in a TSM backup copy group.
The name of the primary storage pool specified as the backup destination for generation management can also be specified for this purpose.
This option must be specified in initial registration. If the option is omitted in an update, the currently set value is used.
Sets the number of preservation generations specified in save-number.
Specify the number of generations to be backed up in generation management mode.
An integer ranging from 1 to 9,999 or "NoLimit" can be specified in save-number. If this option is omitted in initial registration, 2 is used. If the option is omitted in an update, the currently set value is used.
If "NoLimit" is specified, the "number of preservation generations" is set to "indefinite" (preserved indefinitely). Set the option in a TSM backup copy group.
Sets the number of preservation days specified in limit-day.
An integer ranging from 0 to 30,000 or "NoLimit" can be specified in limit-day. If this option is omitted in initial registration, 365 is used. If the option is omitted in an update, the currently set value is used.
If "NoLimit" is specified, the number of preservation days is set to "indefinite" (preserved indefinitely). Set the option in a TSM backup copy group.
OPERANDS
Specifies a tape backup management class name.
The class name can be up to 30 characters long. Valid characters are uppercase letters, digits, "_", ".", "-", "+", and "&".
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Create tape backup management class ACM_CLASS1 for preserving five generations of each backup in COPYPOOL and preserving day management backups for 30 days in ARCPOOL.
# /opt/FJSVswstc/bin/acmtpmgmtclassset -g COPYPOOL -d ARCPOOL -s 5 -t 30 ACM_CLASS1 ACM_CLASS1 acmtpmgmtclassset completed #
NOTES
The storage pools specified as the backup destinations must be created with TSM in advance.
When creating a storage pool, you can use lowercase letters in the storage pool name specified with a TSM command. Even in this case, TSM manages storage pool names with an assumption that all of the names are in uppercase letters. The storage pool name specified in acmtpmgmtclassset must be a name that is actually managed by TSM. No lowercase letters can be used.
Even if backup is only performed in either generation management mode or day management mode, the backup destination in the unused management mode must also be specified. In this case, specify the same storage pool for both the generation management backup destination and day management backup destination.
To automatically delete generations when a specific number of preservation generations or days is exceeded, the number of generations or days must be specified in the TSM server option file. If either one is specified, the Tape Server is checked at a regular interval to determine whether the specified value has been exceeded. If it has been exceeded, the oldest history is deleted. For details, refer to "Setting of a Server Option File" in the "ETERNUS SF AdvancedCopy Manager Installation Guide".
The TSM command "expire" can delete the number of generations exceeding the limit.
For details, refer to the "ETERNUS SF Backup TSM Edition Administrator's Reference".
tsm> expire inventory wait=<yes/no>
If "yes" is specified for "wait," the command is executed in the foreground. If "no" is specified, it is executed in the background. The default is "no."
A tape backup management class cannot be set in the following cases:
Backup destinations for generation management and day management are not set during initial registration.
A specified backup destination was not created as a TSM storage pool.
The maximum allowable number of preservation generations or days is exceeded by the value specified in the respective option.
The character string specified for the tape backup management class contains an invalid character or more than 30 characters.
This command cannot be executed if any of the following commands is being executed:
swstsrsemtch (Resource matching command)
swstdevinfoset (Device configuration command)
swstsvrset (Storage Server configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)
NAME
acmtpmgmtclassdisp - Display of management class for tape backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpmgmtclassdisp [Management-Class-Name][For Windows]
program-directory\bin\acmtpmgmtclassdisp [Management-Class-Name]DESCRIPTION
This command displays a set backup management class.
OPERANDS
Specifies the name of a tape backup management class.
Only one tape backup management class name can be specified in this operand.
If the operand is omitted, all tape backup management classes registered in the tape backup policy domain are displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display all set tape backup management classes.
# /opt/FJSVswstc/bin/acmtpmgmtclassdisp Server PolicyDomain PolicySet ManagementClass BackupCopyGroup ArchiveCopyGroup BackupPool Save-Number ArchivePool Limit-Day server01 ACM_DOMAIN ACM_111102AA2C6_POLICY ACM_CLASS1 standard standard COPYPOOL1 7 ARCHPOOL1 300 server01 ACM_DOMAIN ACM_111102AA2C6_POLICY ACM_CLASS2 standard standard COPYPOOL2 5 ARCHPOOL2 7 #
The table below lists displayed information items.
Title | Description |
|---|---|
Server | Displays the Storage Server name. |
PolicyDomain | Displays the tape backup policy domain name. ACM_DOMAIN is always displayed. |
PolicySet | Displays the tape backup policy set in which the tape backup management class is set. The tape backup policy set is automatically assigned in such a way that it is unique among Storage Servers, when a tape backup management class is set. |
ManagementClass | Displays the tape backup management class name. |
BackupCopyGroup | Displays the backup copy group name. |
ArchiveCopyGroup | Displays the archive copy group name. |
BackupPool | Displays the name of the TSM primary storage pool of the generation management backup destination. |
Save-Number | Displays the number of preservation generations. The unit is generations. |
ArchivePool | Displays the name of the TSM primary storage pool of the day management backup destination. |
Limit-Day | Displays the number of preservation days. |
NAME
acmtpmgmtclassdel - Deletion of management class for tape backup
SYNOPSIS
[For Solaris/Linux/HP-UX/AIX]
/opt/FJSVswstc/bin/acmtpmgmtclassdel Management-Class-Name[For Windows]
program-directory\bin\acmtpmgmtclassdel Management-Class-NameDESCRIPTION
This command deletes a set tape backup management class.
A tape backup management class that is defined in the tape backup policy for a transaction volume cannot be deleted.
If the last tape backup management class among those registered in the tape backup policy domain is deleted, the tape backup policy domain and set tape backup policies are automatically deleted at the same time.
OPERANDS
Specifies the name of a tape backup management class.
Only one tape backup management class name can be specified in this operand.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Delete tape backup management class ACM_CLASS1.
# /opt/FJSVswstc/bin/acmtpmgmtclassdel ACM_CLASS1 ACM_CLASS1 acmtpmgmtclassdel completed #
NOTES
A tape backup management class cannot be deleted in the following case:
If the tape backup management class is defined in any tape backup policies.
This command cannot be executed if any of the following commands is being executed:
swstsrsemtch (Resource matching command)
swstdevinfoset (Device configuration command)
swstsvrset (Storage Server configuration command)
swstresback (Resource backup command)
swstresrst (Resource restore command)