This section describes the environment definition commands for backup management.
NAME
swstsvrset - sets configuration information of a Managed Server
SYNOPSIS
<program-directory>\bin\swstsvrset [-c RecCtrlFile-Directory] [-w Work-Directory]
<program-directory>\bin\swstsvrset [-h Server-Name] [-c RecCtrlFile-Directory] [-w Work-Directory]
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.
For backup and recovery of Symfoware databases, register the storage location of the recovery control file created during backup (target directory for output of the recovery control file) as well as the working directory that is used for the recovery of the databases during restore.
For modifying the target directory for output of the recovery control file or the working directory, specify the directory name to be changed and run the command again.
After modifying the target directory for output of the recovery control file, transfer the recovery control file from the previous directory to the new one. If the transfer fails due to insufficient space, the target directory for output of the recovery control file will not be changed. In that case, the recovery control file will be kept in the directory where it was before the modification.
OPTIONS
Specifies the name of a Managed Server to be subject to the backup operation.
This option can be specified only on a Management Server.
If this option is omitted, the Managed Server on which the command is entered will be subject to the processing.
Specifies the name of the target directory for output of the recovery control file. As the output target, specify an empty directory.
If this option is omitted at the time of first registration, the following directories will be used.
Non-cluster operation: <Environment directory>\etc\SymfoWARE\Recovery
Cluster operation: <Environment directory for logical node>\etc\SymfoWARE\Recovery
If this option is omitted during an update, the previously set values will be carried over.
Do not use this option when Symfoware is not installed.
Specifies the name of the working directory.
If this option is omitted at the time of first registration, the following directories will be used.
Non-cluster operation: <Environment directory>\var\SymfoWARE
Cluster operation: <Environment directory for logical node>\var\SymfoWARE
If this option is omitted during an update, the previously set values will be carried over.
Do not use this option when Symfoware is not installed.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Set the configuration information of a Managed Server:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsvrset swstsvrset completed C:\>
Set the configuration information for the Managed Server on which Symfoware is installed:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsvrset -c C: \Win32app\AdvancedCopyManager\etc\SymfoWARE -w C: \Win32app\AdvancedCopyManager\etc\SymfoWARE swstsvrset completed C:\>
Set the configuration information of a Managed Server named job1 from a Management Server:
C:\>C:\ETERNUS_SF\ACM\bin\swstsvrset -h job1 swstsvrset completed C:\>
NOTES
In cluster operation, as the target directory for output of the recovery control file specified by the -c option, you must specify a directory that is located on a shared disk.
The configuration information for the Managed Server cannot be set if:
The -w or the -c option was specified although Symfoware is not installed.
The directory specified in the -w option does not exist.
The directory specified in the -c option does not exist.
The directory name specified in the -w or -c option contains double-byte characters (as used in Asian languages).
This command can only be executed if none of the following commands are running:
NAME
swstsvrdisp - displays configuration information of a Managed Server
SYNOPSIS
<program-directory>\bin\swstsvrdisp<program-directory>\bin\swstsvrdisp [-h Server-Name]
DESCRIPTION
This command displays configuration information of a Managed Server that has been set using swstsvrset (Managed Server configuration information setting command).
The following information will be displayed:
Title | Description |
|---|---|
Storage-Server | Displays a Managed Server name. |
RecCtrlFile-Dir | Displays the name of the target directory for output of the recovery control file. |
Work-Dir | Displays the name of the working directory. |
OPTIONS
Specifies a Managed Server name.
This option can be specified only on a Management Server.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display configuration information of a Managed Server named Work1:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsvrdisp Storage-Server = Work1 C:\>
Display the configuration information for the Managed Server named Work2 on which Symfoware is installed:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstsvrdisp Storage-Server = Work2 RecCtrlFile-Dir = C:\Win32app\AdvancedCopyManager\etc\SymfoWARE\Recovery\ Work-Dir = C:\Win32app\AdvancedCopyManager\var\SymfoWARE\ C:\>
NOTES
The directory name for outputting recovery control file and the working directory name are displayed only when Symfoware is already installed.
NAME
swstdevinfoset - sets the device information
SYNOPSIS
<program-directory>\bin\swstdevinfoset -t | -b | -o Device-Name
<program-directory>\bin\swstdevinfoset [-h Server-Name] -t | -b | -o Device-Name
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.
The following devices can be registered on Windows as transaction and backup volumes. Logical Units (disks) cannot be registered.
SCSI driver resource (OS standard)
Only regular drives can be registered. No mirror set, stripe set, parity-protected stripe set, or volume set that can be recognized as FT (Fault Tolerant) drives can be registered. Additionally, the file system can be used is NTFS and ReFS.
You may want to change information (partition size, drive letter, and ETERNUS Disk storage system box information) on a device registered as a working or backup volume using an OS management tool such as Disk Management or a function such as ETERNUS Web GUI provided by the ETERNUS Disk storage system. However, if you do, you need to then deselect the target device from the work or backup volume and register it again.
If you add or delete a device (including disk array units and other general devices) on a Managed Server on Windows, use the "getting and reflecting information of all devices" option on the Web Console to update the relationship table between AdvancedCopy Manager device names and OS information.
If you want to perform the backup operation on a regular transaction volume, refer to "3.2.2 Selecting a backup source" for information on a transaction volume, and "3.2.4 Preparing a backup volume" for information on a backup volume.
If you want to perform the backup operation for Symfoware, refer to "4.1.2.3 Selecting a backup source" for information on a transaction volume, and "4.1.2.5 Preparing a backup volume" for information on a backup volume.
OPTIONS
Specifies a Managed Server name.
This option can be specified only on a Management Server.
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.5 Managing a 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:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevinfoset -t g1d1p2 swstdevinfoset completed C:\>
Register a device as a backup volume:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevinfoset -b g1d2p1 swstdevinfoset completed C:\>
Deregister a device that has been registered as a transaction volume:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevinfoset -o g1d1p2 swstdevinfoset completed C:\>
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 device to be set up contains a Symfoware database space in its configuration.
The device is an FT drive.
The device is a dynamic volume.
The device is a Logical Unit (disk).
The file system is FAT or FAT 32.
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 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.
A drive letter has already been allocated to the device to be registered.
The device is an FT drive.
The device is a dynamic volume.
The device is a Logical Unit (disk).
The device is an SDX object.
The file system is FAT or FAT 32.
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
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
<program-directory>\bin\swstdevdisp [-t] [-b [-u]] [-o] [Device-Name]
<program-directory>\bin\swstdevdisp [-h Server-Name] [-t] [-b [-u]] [-o] [Device-Name]
DESCRIPTION
This command displays information about a transaction or backup volume or any other definable device, which has been set using swstdevinfoset (Device information setting command).
The following information will be 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. |
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 -suspend or -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 drive letter of a device. The file system type of the device is displayed inside the parentheses. If the device is a transaction volume used for Symfoware, the names of Symfoware database spaces and log groups as well as the RDB system names are displayed, followed by "SymfoWARE" in parentheses. |
Backup-Engine | Displays the operation type: "AdvancedCopy" : Backup operation using AdvancedCopy Manager |
For transaction volumes used for Symfoware, the display in the "Mount-Point (Method)" column has the following format:
DB-Name DBS-Name / LogGroup / RDB-Name (SymfoWARE) (1) (2) (3) (4) (5) (1) Displays the database name. (2) Displays the database space name. (3) Displays the log group name. (4) Displays the RDB system name. If there is no RDB system name, the display shows "-". (5) Displays that the volume is a Symfoware volume.
OPTIONS
Specifies a Managed Server name.
This option can be specified only on a Management Server.
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 will be displayed if all of the -t, -b and -o options are omitted.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.5 Managing a 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:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstdevdisp -tb Server Device Size Device-Mode Mount-Point (Method) Backup-Engine Work2 g1d1p2 1.0 Gbyte Transaction D: (NTFS) AdvancedCopy Work2 g1d1p1 1.0 Gbyte Transaction E: (NTFS) AdvancedCopy Work2 g1d1p3 1.0 Gbyte Transaction DB1.DBS6/LOG01/RDB01 (SymfoWARE) AdvancedCopy Work2 g1d1p4 1.0 Gbyte Transaction DB1.DBS2/LOG02/RDB01 (SymfoWARE) AdvancedCopy Work2 g1d2p1 1.0 Gbyte Backup (used) ---- (----) AdvancedCopy Work2 g1d2p2 1.0 Gbyte Backup (free) ---- (----) AdvancedCopy Work2 g1d2p3 2.0 Gbyte Backup (used) ---- (----) AdvancedCopy Work2 g1d2p4 2.0 Gbyte Backup (free) ---- (----) AdvancedCopy : C:\>
NAME
swstbkpolset - sets a backup policy
SYNOPSIS
<program-directory>\bin\swstbkpolset [-i Interval-Days] [-s Save-Number] [Device-Name]
<program-directory>\bin\swstbkpolset [-h Server-Name] [-i Interval-Days] [-s Save-Number] [Device-Name]
<program-directory>\bin\swstbkpolset -n [-i Interval-Days] [-s Save-Number] Log-Group-Name[/RDB-Name]
<program-directory>\bin\swstbkpolset -n [-h Server-Name][-i Interval-Days][-s Save-Number] Log-Group-Name[/RDB-Name]
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
Specifies a Managed Server name.
This option can be specified only on a Management Server.
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.
Specifies that the setting is being made for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.5 Managing a Device on AdvancedCopy Manager" for the devices to be specified.
If the device name is omitted, the backup policy will be set for all the transaction volumes.
Specify the name of the log group.
Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Set a backup policy assuming 10 days as the number of interval days and three generations as the number of preservation generations for the transaction volume (called g1d1p2):
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpolset -i 10 -s 3 g1d1p2 g1d1p2 swstbkpolset completed C:\>
To set a backup policy with 3 backup generations for log group (LOG01/RDB1):
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpolset -n -s 3 LOG01/RDB1 g1d1p2 swstbkpolset completed g1d1p1 swstbkpolset completed : LOG01/RDB1 swstbkpolset completed C:\>
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 a 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.
You have specified individual transaction volumes that are included in a log group.
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
<program-directory>\bin\swstbkpoldisp [Device-Name]
<program-directory>\bin\swstbkpoldisp [-h Server-Name] [Device-Name]
<program-directory>\bin\swstbkpoldisp -n Log-Group-Name[/RDB-Name]
<program-directory>\bin\swstbkpoldisp -n [-h Server-Name] Log-Group-Name[/RDB-Name]
DESCRIPTION
This command displays a backup policy that has been set for a transaction volume.
The following information will be 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 drive letter of a device. The file system type of the device is displayed inside the parentheses. If the device is a transaction volume used for Symfoware, the names of Symfoware database spaces and log groups as well as the RDB system names are displayed, followed by "SymfoWARE" in parentheses. |
For transaction volumes used for Symfoware, the display in the "Mount-Point (Method)" column has the following format:
DB-Name DBS-Name / LogGroup / RDB-Name (SymfoWARE) (1) (2) (3) (4) (5) (1) Displays the database name. (2) Displays the database space name. (3) Displays the log group name. (4) Displays the RDB system name. If there is no RDB system name, the display shows "-". (5) Displays that the volume is a Symfoware volume.
OPTIONS
Specifies a Managed Server name.
This option can be specified only on a Management Server.
Specifies that the item being displayed is a log group.
In the operand, specify the log group name and the RDB system name.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.5 Managing a 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 will be displayed.
Specify the name of the log group.
Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
Display a backup policy of a transaction volume:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpoldisp g1d1p2 Server Device Interval-Days Save-Number Mount-Point (Method) Work2 g1d1p2 30 2 D: (NTFS) C:\>
Display the backup policy for log group (LOG01/RDB1):
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpoldisp -n LOG01/RDB1 Server Device Interval-Days Save-Number Mount-Point (Method) Svr02 g1d1p2 30 2 DB1.DBS6/L0G01/RDB1 (SymfoWARE) Svr02 g1d1p1 30 2 DB2.DBS2/L0G01/RDB1 (SymfoWARE) : C:\>
NAME
swstbkpoldel - deletes the backup policy
SYNOPSIS
<program-directory>\bin\swstbkpoldel Device-Name
<program-directory>\bin\swstbkpoldel [-h Server-Name] Device-Name
<program-directory>\bin\swstbkpoldel -n Log-Group-Name[/RDB-Name]
<program-directory>\bin\swstbkpoldel -n [-h Server-Name] Log-Group-Name[/RDB-Name]
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
Specifies a Managed Server name.
This option can be specified only on a Management Server.
Specifies that deletion is going to be made for a log group.
In the operand, specify the log group name and the RDB system name. If there is no RDB system name, you can omit it.
OPERANDS
Specify an AdvancedCopy Manager device name.
Refer to "1.5 Managing a Device on AdvancedCopy Manager" for the devices to be specified.
Specify the name of the log group.
Specify the RDB system name after the log group name, delimited by a slash ("/").
If there is no RDB system name, you can omit it.
EXIT STATUS
=0: Completed successfully
>0: Terminated abnormally
EXAMPLES
To delete the backup policies of a transaction volume:
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpoldel g1d1p2 g1d1p2 swstbkpoldel completed C:\>
To delete the backup policy for log group (LOG01/RDB1):
C:\>C:\Win32app\AdvancedCopyManager\bin\swstbkpoldel -n LOG01/RDB1
g1d1p2 swstbkpoldel completed
g1d1p1 swstbkpoldel completed
:
LOG01/RDB1 swstbkpoldel completed
C:\>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: