This section describes the environment definition commands for backup management.
NAME
swstsvrset - sets configuration information of a Managed Server
SYNOPSIS
/opt/FJSVswsts/bin/swstsvrset
/opt/FJSVswsts/bin/swstsvrset [-h serverName]
DESCRIPTION
This command sets configuration information of a Managed Server. Execution of this command declares that the Managed Server on which the command is executed is a server that performs backup operations.
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Set the configuration information of a Managed Server:
# /opt/FJSVswsts/bin/swstsvrset swstsvrset completed #
Set the configuration information of a Managed Server "job1" from a Management Server:
# /opt/FJSVswsts/bin/swstsvrset -h job1 swstsvrset completed #
NOTES
This command can only be executed if none of the following commands are running:
NAME
swstsvrdisp - displays configuration information of a Managed Server
SYNOPSIS
/opt/FJSVswsts/bin/swstsvrdisp
/opt/FJSVswsts/bin/swstsvrdisp [-h serverName]
DESCRIPTION
This command displays configuration information of a Managed Server that has been set using the swstsvrset command.
The following information is displayed.
Title | Description |
|---|---|
Storage-Server | Displays a Managed Server name. |
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display configuration information of the Managed Server "Work1":
# /opt/FJSVswsts/bin/swstsvrdisp Storage-Server = Work1 #
NAME
swstdevinfoset - sets the device information
SYNOPSIS
/opt/FJSVswsts/bin/swstdevinfoset -t | -b | -o deviceName
/opt/FJSVswsts/bin/swstdevinfoset [-h serverName] -t | -b | -o deviceName
DESCRIPTION
Set a volume that has been allocated to the ETERNUS Disk storage system, as a transaction or backup volume.
A transaction volume refers to a volume that stores transaction data to be backed up. A backup volume refers to a volume used to store a backup of this transaction data.
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
Register the specified device as a transaction volume.
Cannot be specified at the same time as the -b and -o options.
Register the specified device as a backup volume.
Cannot be specified at the same time as the -t and -o options.
Deregister the specified device if it has been registered as a transaction or backup volume.
Cannot be specified at the same time as the -t and -b options.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Register a device as a transaction volume:
# /opt/FJSVswsts/bin/swstdevinfoset -t /dev/vg01 swstdevinfoset completed #
Register a device as a backup volume:
# /opt/FJSVswsts/bin/swstdevinfoset -b /dev/vg02 swstdevinfoset completed #
Deregister a device that has been registered as a transaction volume:
# /opt/FJSVswsts/bin/swstdevinfoset -o /dev/vg04 swstdevinfoset completed #
NOTES
A device cannot be registered as a transaction volume if:
Another device with the same box information (box identifier, OLU number, EXTENT starting 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 working or backup volume.
The license for the ETERNUS Disk storage system that contains the specified transaction volume is one of the following:
The license is not registered in the license management function.
The license is expired.
A device cannot be registered as a backup volume if:
Another device with the same box information (box identifier, OLU number, EXTENT starting position, and EXTENT size) has already been registered as a backup volume.
The space of the device to be registered overlaps the space of an already registered work or backup volume.
The device to be set up is already mounted. However, when configuring a volume group as backup volume, the check of whether the logical volume in a volume group is mounted is not carried out. If you set a volume group as a backup volume, unmount the logical volume beforehand.
The device to be set up is registered as a replication destination volume in replication management.
The device to be set up is registered as a replication source volume of the duplicate volume information in which bidirectional copy is possible in replication management.
You must delete related backup history information before:
Changing a backup volume to a transaction volume
Cancelling the setting of a backup volume
You must delete a backup policy specified on a transaction volume before:
Changing a transaction volume to a backup volume
Cancelling the setting of a transaction volume
If using a volume group as a transaction volume:
Do not register two or more physical disks into one volume group.
Create a logical disk so that it does not consist of two or more physical disks.
Note: that a volume group that is not active cannot be set as a transaction volume.
If using a volume group as a backup volume:
Do not register two or more physical disks into one volume group.
Create a logical disk so that it does not consist of two or more physical disks.
The backup volume must be the same physical size as the transaction volume. In addition, the backup volume's logical disk must be in a different volume group to the transaction volume but it must have the same configuration as the transaction volume.
Note: a volume group that is not active cannot be set as a backup volume.
In order to make a configuration change to a transaction volume or a backup volume, delete the Configuration, and re-register.
The following changes are not possible unless the related synchronous processing (in an EC session) is cancelled:
Changing a setting in a suspended transaction volume
Changing a setting in a suspended backup volume
The related tracking processing (in an OPC session) must be cancelled in advance to perform the following changes:
Changing the settings of a transaction volume in tracking processing
Changing the settings of a backup volume in tracking processing
This command can be executed only while none of the following commands are running:
NAME
swstdevdisp - displays the device information
SYNOPSIS
/opt/FJSVswsts/bin/swstdevdisp [-t] [-b [-u]] [-o] [deviceName]
/opt/FJSVswsts/bin/swstdevdisp [-h serverName] [-t] [-b [-u]] [-o] [deviceName]
DESCRIPTION
This command displays information about a transaction or backup volume or any other definable device, which has been set using the swstdevinfoset command.
The following information is displayed.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Device | Displays the AdvancedCopy Manager device name. |
Size | Displays the size of a partition allocated to a device. In the case of a volume group, the display also shows the size of the physical disk on which the logical disk is defined. |
Device-Mode | Displays a character string by which a device can be identified: "Transaction": Represents a transaction volume. A backup volume is indicated as "Backup (used)" if it is being used or "Backup (free)" if it is not used. During the backup process with the -suspend or the -T option specified, the backup volume remains in use after history information is deleted. When the -u option is specified, "Backup (used-S)" is displayed for a backup volume in the suspend status for which history information was deleted, or "Backup (used-T)" is displayed for a backup volume in the tracking status for which history information was deleted. |
Mount-Point (Method) | Displays the mount point of a device. The file system type of the mount point is displayed inside the parentheses. However, AIX does not display mount points. Therefore, "---- (----)" is always displayed. |
Backup-Engine | Displays the operation type: "AdvancedCopy": Backup operation using AdvancedCopy Manager |
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
Displays information on a device that has been set as a transaction volume.
Displays device information on all the transaction volumes if the device name in an operand is omitted.
Displays a device that has been set as a backup volume.
Displays device information on all the backup volumes if the device name in an operand is omitted.
Changes the display format of the Device-Mode column.
Displays all the devices other than those set as a transaction or backup volume.
Displays all the devices other than those set as a transaction or backup volume if the device name in an operand is omitted.
Information on a device that has been set as a transaction volume is displayed if all of the -t, -b and -o options are omitted.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
Displays device information on all the transaction volumes if this operand and the associated options are omitted.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display the usage statuses of the registered devices:
# /opt/FJSVswsts/bin/swstdevdisp -t -b Server Device Size Device-Mode Mount-Point (Method) Backup-Engine job2 /dev/vg00 1.0 Gbyte Transaction ---- (----) AdvancedCopy job2 /dev/vg01 2.0 Gbyte Transaction ---- (----) AdvancedCopy job2 /dev/vg02 1.0 Gbyte Backup (used) ---- (----) AdvancedCopy job2 /dev/vg03 1.0 Gbyte Backup (free) ---- (----) AdvancedCopy job2 /dev/vg04 2.0 Gbyte Backup (free) ---- (----) AdvancedCopy job2 /dev/vg05 1.0 Gbyte Backup (free) ---- (----) AdvancedCopy : #
NAME
swstbkpolset - sets a backup policy
SYNOPSIS
/opt/FJSVswsts/bin/swstbkpolset [-i intervalDays] [-s saveNumber] [deviceName]
/opt/FJSVswsts/bin/swstbkpolset [-h serverName] [-i intervalDays] [-s saveNumber] [deviceName]
DESCRIPTION
This command sets a backup policy (the number of preservation generations and the number of interval days).
The number of preservation generations is the number of generations of backup data that should be kept at one time. The number of interval days means the number of days from the execution of one backup until the next backup should be performed.
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
Specifies the number of interval days. You can specify a value between 1 and 366. If this option is omitted during initial registration, 30 is set as the default. If this option is omitted during update, the existing value is 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 is set as the default. If this option is omitted during update, the existing value is inherited.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If the device name is omitted, the backup policy is set for all the transaction volumes.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To set 3 as the save number of a transaction volume as a backup policy:
# /opt/FJSVswsts/bin/swstbkpolset -s 3 /dev/vg01 /dev/vg01 swstbkpolset 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 according to the specified backup policy. To view information on the number of backup volumes required to perform the backup operation of a regular transaction volume, refer to "3.2.4 Preparing Backup Volume".
You can change 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".
No backup policy can be set if:
There are not as many backup volumes as the specified number of preservation generations.
An option for more than the maximum number of preservation generations is specified.
An option for more than the maximum interval days is specified.
The replication management function is executing a process for the target transaction volume.
The specified device is an LU (disk unit).
This command can only be executed while none of the following commands are running:
NAME
swstbkpoldisp - displays a backup policy
SYNOPSIS
/opt/FJSVswsts/bin/swstbkpoldisp [deviceName]
/opt/FJSVswsts/bin/swstbkpoldisp [-h serverName] [deviceName]
DESCRIPTION
This command displays a backup policy that has been set for a transaction volume.
The following information is displayed.
Title | Description |
|---|---|
Server | Displays a Managed Server name. |
Device | Displays the AdvancedCopy Manager device name. |
Interval-Days | Displays a number of interval days. |
Save-Number | Displays a number of preservation generations. |
Mount-Point (Method) | Displays the mount point of a device. The file system type of the mount point is displayed inside the parentheses. However, AIX does not display mount points. Therefore, "---- (----)" is always displayed. |
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
If the device name is omitted, a backup policy for a transaction volume with a registered backup policy is displayed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display a backup policy of a transaction volume:
# /opt/FJSVswsts/bin/swstbkpoldisp /dev/vg01 Server Device Interval-Days Save-Number Mount-Point (Method) job2 /dev/vg01 30 3 ---- (----) #
NAME
swstbkpoldel - deletes the backup policy
SYNOPSIS
/opt/FJSVswsts/bin/swstbkpoldel deviceName
/opt/FJSVswsts/bin/swstbkpoldel [-h serverName] deviceName
DESCRIPTION
An existing backup policy can be deleted using this command.
Delete the backup history information of the transaction volume prior to the execution of this command.
OPTIONS
When executing on the Management Server, specify the name of the target Managed Server.
When executing on the target Managed server, it is not necessary to specify this option.
For the server name, accurately specify the same letters, including upper and lower case, as the server name displayed with the stgxfwcmdispsrv command.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.2 Managing Device on AdvancedCopy Manager" for the devices to be specified.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To delete the backup policies of a transaction volume:
# /opt/FJSVswsts/bin/swstbkpoldel /dev/vg01 /dev/vg01 swstbkpoldel 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.
The replication management function is executing a process for the target transaction volume.
This command can only be executed while none of the following commands are running:
