ETERNUS SF AdvancedCopy Manager Operator's Guide 13.0 -Solaris-
Contents Index PreviousNext

Chapter 10 Commands

This chapter describes using commands.

10.1 Backup Management Commands 

This chapter describes operations using backup management commands.

Only a root user can execute all the commands of backup management. When command execution is carried out by other users, a message " swst0601 This Command cannot be run. This is because the user is not a root user." is outputted and then, an error end.

Operating environment for command execution

The table below lists the requirements for the operating environment in which to execute the respective commands.

Command

Operating environment of AdvancedCopy Manager

swstbackstat

To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:

  • -h option specified, or

  • No device name specified

swstbackup

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is in EC operation, the daemons and services of the storage server must be operating.

swstbkpoldel

To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swstbkpoldisp

To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:

  • -h option specified, or

  • No device name specified

swstbkpolset

To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swstcancelrest

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swstcancelsync

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is in EC operation, the daemons and services of the storage server must be operating.

swstcanceltrk

When this command is executed with the -h option specified on the storage management server, the daemons/services of the storage management server and target storage server must be active.

swstdevdisp

To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:

  • -h option specified, or

  • No device name specified

swstdevinfoset

To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swstexecstat

To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:

  • -h option specified, or

  • No device name specified

swsthistdel

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swsthistdisp

To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:

  • -h option specified, or

  • No device name specified

swstresback

-

swstresrst

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
To execute this command with the -x option specified, the daemons and services of the storage management server must be operating.

swstrestore

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swstreststat

To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:

  • -h option specified, or

  • No device name specified

swstsrsemtch

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
To execute this command with the -x option specified, the daemons and services of the storage management server must be operating.

swststartsync

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.

swstsvrdisp

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swstsvrset

To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swstsyncstat

To execute this command on a storage management server with either of the following parameter designations, the daemons and services of the storage management server and target storage server must be operating:

  • -h option specified, or

  • No device name specified

swsttrkstat

When this command is executed in the following format on the storage management server, the daemons/services of the storage management server and target storage server must be active:

  • -h option is specified, or

  • No device name is specified.

In cluster operation

In cluster operation, execute a command by taking the following steps:

  1. If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. For bsh, specify the environment variable as follows:

    # SWSTGNODE=logical-node-name<Enter>
# export SWSTGNODE

  2. Execute the command.

    The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.

    Command

    Environment variable

    Command execution node

    Remarks

    swstsvrset

    Required

    Transaction operation node

    swstsvrdisp

    Required

    Transaction operation node

    swstdevinfoset

    Required

    Transaction operation node

    swstdevdisp

    Required

    Transaction operation node

    swstbkpolset

    Required

    Transaction operation node

    swstbkpoldisp

    Required

    Transaction operation node

    swstbkpoldel

    Required

    Transaction operation node

    swstbackup

    Required

    Transaction operation node

    swstbackstat

    Required

    Transaction operation node

    swstrestore

    Required

    Transaction operation node

    swstcancelrest

    Required

    Transaction operation node

    swstreststat

    Required

    Transaction operation node

    swsthistdisp

    Required

    Transaction operation node

    swsthistdel

    Required

    Transaction operation node

    swststartsync

    Required

    Transaction operation node

    swstcancelsync

    Required

    Transaction operation node

    swstsyncstat

    Required

    Transaction operation node

    swstexecstat

    Required

    Transaction operation node

    swstcanceltrk

    Required

    Transaction operation node

    swsttrkstat

    Required

    Transaction operation node

    swstsrsemtch

    Required

    Transaction operation node

    swstresback

    Required

    Transaction operation node

    swstresrst

    Required

    Transaction operation node

10.1.1 Environment definition commands

This chapter describes environment definition commands for backup management.

To define a backup management environment, use the following commands:

Function

Command name

Description

Storage server configuration information setting command

swstsvrset

Sets the configuration information of a storage server.

Storage server configuration information display command

swstsvrdisp

Displays the configuration information of a storage server.

Device information setting command

swstdevinfoset

Sets the use of a device.

Device usage status display command

swstdevdisp

Displays the information of a device.

Backup policy setting command

swstbkpolset

Sets a backup policy.

Backup policy display command

swstbkpoldisp

Displays a backup policy that has been set.

Backup policy deletion command

swstbkpoldel

Deletes a backup policy that has been set

10.1.1.1 Storage server configuration information setting command (swstsvrset)

This command sets configuration information of a storage server. Execute this command to declare that this storage server is subject to the backup operation.

  1. Specification

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstsvrset

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstsvrset [-h Server]

  2. Description of options

    Option

    Description

    -h

    Specifies the name of a storage server to be subject to the backup operation. This option is valid only on a storage management server.

    If this option is omitted, the storage server on which the command is entered will be subject to the processing.

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    Set configuration information of a storage server.

    # /opt/FJSVswsts/bin/swstsvrset
swstsvrset completed
#

    Set configuration information of a storage server (job1) from a storage management server.

    # /opt/FJSVswsts/bin/swstsvrset -h job1
swstsvrset completed
#

This command can be executed only while none of the following commands are running.

10.1.1.2 Storage server configuration information display command (swstsvrdisp)

This command displays configuration information of a storage server, which has been set using the storage server configuration information setting command.

  1. Specification

    [To be executed on a storage server]

# /opt/FJSVswsts/bin/swstsvrdisp

[To be executed on a storage management server]

# /opt/FJSVswsts/bin/swstsvrdisp [-h Server]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option is valid only on a storage management server.

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    Display configuration information of a storage server (Work1).

    # /opt/FJSVswsts/bin/swstsvrdisp
    Storage-Server = Work1
    #

    The following information will be displayed.

    Title

    Description

    Storage-Server

    Displays a storage server name.

10.1.1.3 Device information setting command (swstdevinfoset)

Set a volume that has been allocated to the disk array unit ETERNUS storage system, as a transaction 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. When using transaction volumes to back up data, see "Deciding a backup target" in "Backup Oprations (Normal Transaction Volumes)" for information about the transaction volume. See "Preparing a backup volume" in "Backup Oprations (Normal Transaction Volumes)" for information about the backup volume.

GDS logical volumes can also be registered.

  1. Specification method

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstdevinfoset -t | -b | -o Device-Name

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstdevinfoset [-h Server] -t | -b | -o Device-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option is valid only on a storage management server.

    -t

    Register the specified device as a transaction volume.

    Cannot be specified at the same time as the -b and -o options.

    -b

    Register the specified device as a backup volume.

    Cannot be specified at the same time as the -t and -o options.

    -o

    Deregister the specified device if it has been registered as a work or backup volume.

    Cannot be specified at the same time as the -t and -b options.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specify a device name.

    Specify the name of a block device.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Register a device (/dev/dsk/c1t0d0s6) as a transaction volume.

    # /opt/FJSVswsts/bin/swstdevinfoset -t /dev/dsk/c1t0d0s6
swstdevinfoset completed
#

    Register a device (/dev/dsk/c1t0d2s6) as a backup volume.

    # /opt/FJSVswsts/bin/swstdevinfoset -b /dev/dsk/c1t0d2s6
swstdevinfoset completed
#

    Deregister a device (/dev/dsk/c1t0d0s6) that has been registered as a transaction volume.

    # /opt/FJSVswsts/bin/swstdevinfoset -o /dev/dsk/c1t0d0s6
swstdevinfoset completed
#

No device can be registered as a transaction volume if:

No device can be registered as a backup volume if:

You must delete related backup history information before:

You must delete a backup policy specified on a transaction volume before:

The following changes are not possible unless the related synchronous processing (EC session) is cancelled:

To perform the following changes, the related tracking processing (OPC session) must be canceled in advance.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (backup management)".

This command can be executed only while none of the following commands are running.

10.1.1.4 Device usage status display command (swstdevdisp)

This command displays information of a transaction or backup volume or any other definable device, which has been set using the device information setting command (swstdevinfoset).

  1. Specification method

    [To be executed on a storage server]

# /opt/FJSVswsts/bin/swstdevdisp [-t] [-b [-u]] [-o] [Device-Name]

[To be executed on a storage management server]

# /opt/FJSVswsts/bin/swstdevdisp [-h Server] [-t] [-b [-u]] [-o] [Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -t

    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.

    -b

    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.

    -u

    Changes the display format of the Device-Mode field.

    -o

    Displays all the devices other than those set as a work 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.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specify a device name.

    Specify the name of a block device.

    Displays device information on all the transaction volumes if this operand as well as the options are omitted.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Display the usage statuses of the registered devices.

    # /opt/FJSVswsts/bin/swstdevdisp -tb
Server Device            Size         Device-Mode   Mount-Point (Method) Backup-Engine
Work2  /dev/dsk/c1t0d0s6    1.0 Gbyte Transaction   /mnt/tran1 (ufs)     AdvancedCopy 
Work2  /dev/dsk/c1t1d0s6    1.0 Gbyte Transaction   ---- (----)          AdvancedCopy 
Work2  /dev/dsk/c1t0d2s6    1.0 Gbyte Backup (used) ---- (----)          AdvancedCopy 
Work2  /dev/dsk/c1t0d2s3    1.0 Gbyte Backup (free) ---- (----)          AdvancedCopy 
Work2  /dev/dsk/c1t0d7s6    2.0 Gbyte Backup (free) ---- (----)          AdvancedCopy 
Work2  /dev/dsk/c1t0d7s3    2.0 Gbyte Backup (free) ---- (----)          AdvancedCopy 
:
    #

    The following information will be displayed.

    Title

    Description

    Server

    Displays a storage server name.

    Device

    Displays a 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.

    • "Backup": Represents a backup volume.

    • "Other": Represents a device that can be registered as a work or backup 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 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.

    Backup-Engine

    Displays the operation type.

    • "AdvancedCopy": Backup operation using AdvancedCopy Manager

10.1.1.5 Backup policy setting command (swstbkpolset)

This command sets a backup policy (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 execution of backup in which the next backup should be performed.

Even if the number of interval days is specified, AdvancedCopy Manager does not automatically collect backup.

When you specify a backup policy, there must be as many backup volumes required operating 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, see "Preparing a backup volume", and for details with regard to the backup operation of GDS, refer to "Operation in units of logical volumes".

  1. Specification method

    - Setting backup policies by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstbkpolset [-i Interval-Days] [-s Save-Number][Device-Name]

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstbkpolset [-h Server][-i Interval-Days] [-s Save-Number][Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -i

    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. If this option is omitted during update, the existing value will be inherited.

    -s

    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. If this option is omitted during update, the existing value will be inherited.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specify a AdvancedCopy Manager device name.

    If the device name is omitted, the backup policy will be set for all the transaction volumes.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    To set 3 as the save number of a transaction volume(/dev/dsk/c1t0d5s3) as a backup policy:

    # /opt/FJSVswsts/bin/swstbkpolset -s 3 /dev/dsk/c1t0d5s3
    /dev/dsk/c1t0d5s3 swstbkpolset completed
    #

Change of the number of preservation generations can be performed if there "there is little history information in the time" than "the number of preservation generations to set up."

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.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects," and "Notes on SDX object operations (backup management)".

No backup policy can be set if:

This command can be executed only while none of the following commands is executed.

10.1.1.6 Backup policy display command (swstbkpoldisp)

This command displays a backup policy that has been set for a transaction volume.

  1. Specification method

    -  Displaying backup policies by specifying a transaction volume

[To be executed on a storage server]

# /opt/FJSVswsts/bin/swstbkpoldisp [Device-Name]

[To be executed on a storage management server]

# /opt/FJSVswsts/bin/swstbkpoldisp [-h Server] [Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specify a AdvancedCopy Manager device name.

    Specify the name of a block device.

    If the device name is omitted, a backup policy for a transaction volume with a registered backup policy will be displayed.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    To display the backup policies of a transaction volume(/dev/dsk/c1t0d5s3):

    # /opt/FJSVswsts/bin/swstbkpoldisp /dev/dsk/c1t0d5s3
Server Device            Interval-Days Save-Number Mount-Point (Method)
Work2  /dev/dsk/c1t0d5s3 30            2           /stg(ufs)
#

    The following information will be displayed.

    Title

    Description

    Server

    Displays a storage server name.

    Device

    Displays a 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 will be displayed inside the parentheses.

10.1.1.7 Backup policy deletion command (swstbkpoldel)

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 and then execute this command.

  1. Specification method

    - Deleting backup policies by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstbkpoldel Device-Name

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstbkpoldel [-h Server] Device-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specify a AdvancedCopy Manager device name.

    Specify the name of a block device.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    To delete the backup policies of a transaction volume (/dev/dsk/c1t0d5s3):

    # /opt/FJSVswsts/bin/swstbkpoldel /dev/dsk/c1t0d5s3
    /dev/dsk/c1t0d5s3 swstbkpoldel completed
    #

No backup policy can be deleted if:

This command can be executed only while none of the following commands are running.

10.1.2 Operation commands 

This chapter describes operation commands for backup management.

To operate backup management, use the following commands:

Function

Command name

Description

Backup execution command

swstbackup

Performs the synchronous high-speed backup or snapshot-type high-speed backup operation.

Backup execution status display command

swstbackstat

Displays the backup progress status.

Restore execution command

swstrestore

Performs restoration.

Restore cancellation command

swstcancelrest

Cancels the execution of restoration.

Restore execution status display command

swstreststat

Displays the execution status of restoration.

History information display command

swsthistdisp

Displays the history information that has been backed up.

History information deletion command

swsthistdel

Deletes the history information that has been backed up.

Backup synchronous processing start command

swststartsync

Starts backup synchronous processing.

Backup synchronous processing cancel command

swstcancelsync

Aborts backup synchronous processing.

Backup synchronous processing progress display command

swstsyncstat

Displays the progress of the backup synchronous processing.

Execution status display command

swstexecstat

Displays the execution status of a command executed on a transaction volume.

Tracking cancel command

swstcanceltrk

Stops tracking processing.

Tracking status display command

swsttrkstat

Displays the status of tracking processing.

10.1.2.1 Backup execution command (swstbackup)

As for this command, operation changes with states of the advanced copy under execution.

To use the Suspend/Resume function for synchronous high-speed backup, execute the backup command with -suspend specified, and suspend backup synchronous processing.In both cases, it is established as backup and access of backup volume is attained from immediately after this command execution.

AdvancedCopy Manager executes a backup preprocessing Shell script(OpcBackup.pre) before executing backup and then a backup post processing Shell script (OpcBackup.post) after executing backup. You can customize these Shell script. For more information, see "Preprocessing and Postprocessing of Backup and Restoration".

  1. Specification method

    - Creating backup copies by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstbackup [-suspend|-T] Device-Name [-Xdevmap Device-Map-File]

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstbackup [-h Server] [-suspend|-T] Device-Name [-Xdevmap Device-Map-File]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -Xdevmap

    Specifies a target backup volume to perform the snapshot fast backup. In the operand, specify a device map file in which a combination of a transaction volume and a target backup volume is described. If this option is not specified, the target backup volume will be automatically selected. To execute this command on a remote basis using the -h option, specify a device map file (of a storage server) using an absolute pathname. A file name specified in Device-Map-File must not include any national character.

    -suspend

    This results in synchronous high-speed backup using the Suspend/Resume function.

    -T

    Specifies that the differential snapshot high-speed backup be executed.

    This option cannot be specified during synchronous processing.

    This option is valid only for copying within a cabinet when the disk array supports the QuickOPC function.

    For the snapshot high-speed backup without specifying this option, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must be always specified to perform a backup operation using differential snapshots.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify the name of a block device.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Back up a business volume

    # /opt/FJSVswsts/bin/swstbackup /dev/dsk/c1t1d0s6
/dev/dsk/c1t1d0s6 swstbackup completed
#

To guarantee data, this command performs backup after inhibiting access to transaction and backup volumes from other processes. Thus, the drive letters of devices are not assigned. This command terminates with an error if a drive letter of a transaction volume is assigned or if:

To mount a transaction volume from a server other than the server on which this command is entered, unmount the transaction volume, using the authority of the backup administrator. If the transaction volume must not be unmounted, create backup copies with the following procedure:

  1. Execute the sync command to synchronize the transaction volume and file system.

  2. Execute this command.

  3. Execute the fsck command for the backup volume, and check the file system.

You cannot perform backup in the following cases. In these cases, do as described in [System Administrator's Response] in a message that will be output.

At this time, if existing backup history information satisfies the condition of number of saved generations specified by the backup policy setting command, then information on the oldest generation is automatically deleted from the backup history information during the backup process, and the backup volume is cleared. However, if -suspend or -T is specified for the backup history information, then the backup volume with the Suspend or tracking state is not cleared and the backup volume remains in use.

The transaction volume on which the backup command is executed, one other transaction volume, and the suspended or tracking backup volume cannot be specified as backup destinations in the device map file.

When as follows, output place backup volume cannot be specified and backup cannot be performed.

The processing script is not executed before and behind in the following cases.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (backup management)".

See "General notes", for notes on executing backup.

In the case of a SynfinityFILE file system whose transaction volume consists of more than one device (multipartition), backup cannot be performed by using preprocessing and postprocessing scripts to execute unmount/mount.
In the case of a SynfinityFILE file system that consists of more than one device (multipartition), unmount the file system before backup is performed and mount it after that backup is completed.

When the SynfinityFILE and AdvancedCopy Manager configurations are as follows:

# sfxinfo /dev/dsk/c1t3d10s1
ID    special                          size    mount   Type
0     /dev/dsk/c1t3d10s1(800019)       25986   /mnt    META
0     /dev/dsk/c1t3d10s1(800019)       105751  /mnt    DATA
1     /dev/dsk/c1t3d15s3(800028)       5120    /mnt    LOG
2     /dev/dsk/c1t3d16s3(800030)       131736  /mnt    DATA

# /opt/FJSVswsts/bin/swstdevdisp -t
Server Device             Size         Device-Mode Mount-Point (Method) Backup-Engine
SV1    /dev/dsk/c1t3d10s1  128.0 Mbyte Transaction /mnt (ufs)           AdvancedCopy 
SV1    /dev/dsk/c1t3d15s3    5.0 Mbyte Transaction /mnt (ufs)           AdvancedCopy
SV1    /dev/dsk/c1t3d16s3  128.0 Mbyte Transaction /mnt (ufs)           AdvancedCopy

Backup procedure

# umount /mnt
# /opt/FJSVswsts/bin/swstbackup /dev/dsk/c1t3d10s1
/dev/dsk/c1t3d10s1 swstbackup completed
# /opt/FJSVswsts/bin/swstbackup /dev/dsk/c1t3d15s3
/dev/dsk/c1t3d15s3 swstbackup completed
# /opt/FJSVswsts/bin/swstbackup /dev/dsk/c1t3d16s3
/dev/dsk/c1t3d16s3 swstbackup completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

This command can be executed only while none of the following commands are running.

10.1.2.2 Backup execution status display command (swstbackstat)

This command displays the completion status of backup that is being performed using the backup execution command.

Please do not use the OPC stop function of GRmgr/ETERNUSmgr while executing the snap shot type high speed backup. When the OPC stop function of GRmgr/ETERNUSmgr is used, it is displayed in this command regardless of the success or failure of an actual backup as succeeded.

  1. Specification method

    - Displaying the backup processing status by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstbackstat [Device-Name]

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstbackstat [-h Server] [Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name corresponding to a transaction volume.

    Specify the name of a block device.

    If this operand is omitted, the backup execution statuses of all the transaction volumes will be displayed.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Display the actual copying execution status.

    # /opt/FJSVswsts/bin/swstbackstat
Server Transaction-Disk  Backup-Disk       Status    Execute
Work1  /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d2s3 succeeded ---- 
Work1  /dev/dsk/c1t0d0s4 /dev/dsk/c1t0d2s4 executing 70%
Work1  /dev/dsk/c1t0d0s5 /dev/dsk/c1t0d2s5 executing 30%
:
    #

    The following information will be displayed.

    Keyword

    Description

    Server

    Displays a storage server name.

    Transaction-Disk

    Displays the device name of a transaction volume.

    Backup-Disk

    Displays a backup volume name.

    If no backup has been collected, "----" will be displayed.

    Status

    Displays a backup completion status using one of the following character strings.

    • "----": No backup has been collected (no history exists).

    • "succeeded": Backup has been completed.

    • "executing": Copying using OPC is in progress.

    • "failed": Copying using OPC has been interrupted due to an error.

    • "halt": Copying using OPC has been halt status.

    • "gds-error": Copying with GDS ended abnormally.

    Execute

    Displays how much has been copied in percentage if "executing" is displayed in the Status field. Displays "----" unless "executing" is displayed.

If "failed" or "halt" is displayed in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".

In the following cases, backup execution status display processing cannot be executed:

If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed. Correct the cause of the GDS problem, and take action as follows:

10.1.2.3 Restore execution command (swstrestore)

The data which exists in backup history information is restored by using OPC.

Restoration of each individual file cannot be performed because copying between devices will be performed.
When the restore execution command is executed, AdvancedCopy Manager performs the restore preprocessing Shell script(OpcRestore.pre) before copying data using OPC and then the restore postprocessing Shell script(OpcRestore.post) after copying data using OPC. You can customize these Shell script. For more information, see "Preprocessing and Postprocessing for Backup and Restoration".

Restoration to another device than that of the transaction volume can be performed. For this type of restoration, the destination device must be a device that is not registered with the transaction volume and the size of its area must be the same as the specified transaction volume. Restoration GDS logical volume to a device other than that of the original transaction volume cannot be performed.

You can restore data to any device other than a transaction volume. When you do so, the device must not be registered as a transaction volume and the device must have the same space size as the specified transaction volume.

  1. Specification method

    - Restoring a normal transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstrestore [-g Generation-No | -v Version-No] [-r Restore-Device-Name] [-Xgds-softcopy] Device-Name

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstrestore [-h Server] [-g Generation-No | -v Version-No] [-r Restore-Device-Name] [-Xgds-softcopy] Device-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -g

    Specifies the relative generation number of data to be restored.

    Check the relative generation number using the history information display command (swsthistdisp).

    -v

    Specifies the absolute generation number of data to be restored.

    Check the absolute generation number using the history information display command (swsthistdisp).

    -r

    Specifies a restore destination device name to restore data to any other device than a transaction volume.

    Cannot be specified for a GDS logical volume.

    -Xgds-softcopy

    Performs restoration by software-copy for restoration in linkage with GDS Snapshot. If this option is not specified, restoration is performed with OPC.

    Note: If neither the -g or -v option is specified, the latest information out of information under history management will be restored.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name corresponding to a transaction volume.

    Specify the name of a block device.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Restore data with relative generation number 2 (For information on the relative generation number, see data displayed using the history information display command).

    # /opt/FJSVswsts/bin/swstrestore -g 2 /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swstrestore completed
#

    If the Suspend/Resume function is used for the backup operation on the transaction volume, the suspended synchronous processing is deleted and the restore command is executed. For information on the suspended synchronous processing, see the data displayed by the backup synchronous processing execution status display command. Execute the backup synchronous processing cancel command to cancel the synchronous processing.

    # /opt/FJSVswsts/bin/swstsyncstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk       Status    Execute
Work2  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend   ----
Work2  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75%
# /opt/FJSVswsts/bin/swstcancelsync -all /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swstcancelsync completed
# /opt/FJSVswsts/bin/swstsyncstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk Status Execute
Work2  /dev/dsk/c1t0d0s6 ----        ----   ----
# /opt/FJSVswsts/bin/swstrestore /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swstrestore completed
#

On a transaction volume on which a file system has been constructed, restore a specific file as follows:

  1. Mount a backup volume. Check the backup volume by executing the Backup History List view/History information display command.

  2. Copy the file to be restored by executing, for example, the cp command.

  3. Unmount the backup volume.

For the SynfinityFILE file system, follow the procedure below:

  1. Execute the following commands for a backup volume:

    # sfxadm RAW-device-name-of-the-backup-volume

    # fsck -F sfxfs -o f RAW-device-name-of-the-backup-volume

  2. Mount the backup volume:

    # mount -F sfxsfs backup-volume-name mount-point-name

  3. Copy the file to be restored by executing, for example, the cp command:

  4. Unmount the backup volume:

    # unmount backup-volume-name or mount-point-name

If a transaction volume is mounted from a server other than the server on which this command is entered, execute this command after unmounting the transaction volume, using the authority of the backup administrator.

You cannot perform restoration or recovery in the following cases. In these cases, do as described in [System Administrator's Response] in a message that will be output.

The suspended or tracking backup volume cannot be used as the restore destination volume.

The restore command cannot be executed on a transaction volume during the synchronous processing (during copying by EC, under the equivalency maintain status, in the Suspend state).
If the following error occurs during restore processing, then execute the backup synchronous processing cancel command (with the -all option specified) to cancel all of the synchronous processing of the transaction volume, and execute the restore command.
swst0639 This Command cannot be run. This is because a copy is running.
or
swst0634 OPC cannot be run. (SCSI command busy)

See "General notes", for notes on executing restore.

In the following cases, restore/recovery cannot be performed. In these cases, take appropriate action according to [System administrator's action] in the output message.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (backup management)".

If the transaction volume is an SDX object and a non-single volume, you cannot perform restoration using this command. If so, perform recovery as follows:

  1. The backup volume is confirmed by backup history list view/History information display command.

  2. copies onto the volume which is restore in the dd command

In the case of a SynfinityFILE file system that consists of more than one device (multipartition), backup cannot be performed by using preprocessing and postprocessing scripts to execute unmount/mount.
In the case of a SynfinityFILE file system that consists of more than one device (multipartition), unmount the file system before restoration is performed and mount it after that restoration is completed.

When the SynfinityFILE and AdvancedCopy Manager configurations are as follows:

# sfxinfo /dev/dsk/c1t3d10s1
ID    special                          size    mount   Type
0     /dev/dsk/c1t3d10s1(800019)       25986   /mnt    META
0     /dev/dsk/c1t3d10s1(800019)       105751  /mnt    DATA
1     /dev/dsk/c1t3d15s3(800028)       5120    /mnt    LOG
2     /dev/dsk/c1t3d16s3(800030)       131736  /mnt    DATA

# /opt/FJSVswsts/bin/swstdevdisp -t
Server Device             Size         Device-Mode Mount-Point (Method) Backup-Engine
SV1    /dev/dsk/c1t3d10s1  128.0 Mbyte Transaction /mnt (ufs)           AdvancedCopy 
SV1    /dev/dsk/c1t3d15s3    5.0 Mbyte Transaction /mnt (ufs)           AdvancedCopy
SV1    /dev/dsk/c1t3d16s3  128.0 Mbyte Transaction /mnt (ufs)           AdvancedCopy

Restore procedure

# umount /mnt
# /opt/FJSVswsts/bin/swstrestore /dev/dsk/c1t3d10s1
/dev/dsk/c1t3d10s1 swstrestore completed
# /opt/FJSVswsts/bin/swstrestore /dev/dsk/c1t3d15s3
/dev/dsk/c1t3d15s3 swstrestore completed
# /opt/FJSVswsts/bin/swstrestore /dev/dsk/c1t3d16s2
/dev/dsk/c1t3d16s3 swstrestore completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

When the SynfinityFILE file system is restored, the restore destination device may not be able to be mounted. In this event, use the following procedure to mount the restore destination device:

  1. Execute the following on the restore destination device:

    # sfxadm raw-device-name-of-restore-destination-device

  2. Mount the restore destination device as follows:

    # mount -F sfxfs restore-destination-device-name mount-point-name

This command can be executed only while none of the following commands are running.

10.1.2.4 Restore cancellation command (swstcancelrest)

This command cancels OPC-based restoration. If you have executed the restore execution command and while data is copied using OPC, an abnormality due to a hardware error is detected. Then, remove the cause of the hardware error and perform restoration again using the restore execution command (swstrestore).

Check whether an abnormality has occurred using the restore execution status display command (swstreststat).

If you cancel OPC-based restoration using this command, the transaction volume will be in an incomplete status and can no longer be used because part of the data has already been copied. Perform restoration again using the restore execution command (swstrestore).
If the transaction volume is a GDS logical volume and restoration is cancelled, the state of the transaction volume becomes INVALID. In such cases, refer to the "PRIMECLUSTER(TM) Global Disk Services User's Guide (Solaris(TM) Operating System)," and restore the logical volume.

  1. Specification method

    - Canceling restore processing for the specified transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstcancelrest [-g Generation-No | -v Version-No] [-r Restore-Device-Name] [-emergency] Device-Name

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstcancelrest [-h Server] [-g Generation-No | -v Version-No] [-r Restore-Device-Name] [-emergency] Device-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -g

    Specifies the relative generation number of data being restored.

    This option cannot be specified at the same time as the -v option.

    Check the relative generation number using the restore execution status display command (swstreststat).

    -v

    Specifies the absolute generation number of data being restored.

    This option cannot be specified at the same time as the -g option.

    Check the absolute generation number using the restore execution status display command (swstreststat).

    -r

    Specifies the device name if data is restored to any other device than a transaction volume.

    Check the device name using the restore execution status display command (swstreststat).

    -emergency

    Emergency operation mode is available for operations.

    In such cases, OPC sessions are neither confirmed nor cancelled.

    Note: The restoration of the latest history information will be canceled if neither the -g or -v option is specified.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify the name of a block device.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Cancel restore processing of a transaction volume (/dev/dsk/c1t0d0s6).

    # /opt/FJSVswsts/bin/swstcancelrest  -g  1  /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swstcancelrest completed.
#

    Restoration of the latest history information on the transaction volume (/dev/dsk/c1t0d0s6) is cancelled in emergency operation mode.

    # /opt/FJSVswsts/bin/swstcancelrest -emergency /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swstcancelrest completed.
#

You cannot cancel restoration if:

However, OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.

If a logical volume of VxVM is deleted or its structure is changed to a structure not supported by AdvancedCopy Manager, restoration cannot be cancelled. In such cases, take action according to either item a) or b).

  1. Make sure that advanced copy is not in progress for the replication volume to be deleted, and execute this command with the -emergency option specified. (If advanced copy is in progress, stop advanced copy processing by using the disk array unit or take action according to item b).)

  2. Re-create the logical volume or return the logical volume structure to its original state, and then execute this command.

This command can be executed only while none of the following commands are running.

10.1.2.5 Restore execution status display command (swstreststat)

This command displays the execution status of restoration.

Do not use the OPC stop function of GRmgr while the snapshot fast backup is in progress. If you use the OPC stop function of GRmgr, this command displays "succeeded" whether or not the restoration has actually been successful.

  1. Specification method

    -  Displaying the restore processing status by specifying a transaction volume

[To be executed on a storage server]

# /opt/FJSVswsts/bin/swstreststat [-g Generation-No | -v Version-No] [-Xgds-softcopy]  [Device-Name]

[To be executed on a storage management server]

# /opt/FJSVswsts/bin/swstreststat [-h Server ] [-g Generation-No | -v Version-No]  [-Xgds-softcopy] [Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -g

    Specifies the relative generation number of data whose restore execution status should be displayed.

    -v

    Specifies the absolute generation number of data whose restore execution status should be displayed.

    -Xgds-softcopy

    Displays the restore execution status of a GDS logical volume.

    Use this option to check the copy status when restoration using the software-copy function of GDS is in progress.

    When the option is specified, the Status field display when copying is completed is "----", which is the same as before copying started.

    Note: The restore execution statuses of all the history will be displayed if both the -g and -v options are omitted.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify the name of a block device.

    If this operand is omitted, the restore execution statuses of all the transaction volumes will be displayed.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Display the restore processing status of transaction volumes.

    # /opt/FJSVswsts/bin/swstreststat 
Server Transaction-Disk  Generation Version Backup-Disk       Restore-Device    Status    Execute
Work2  /dev/dsk/c1t0d0s3 1          10      /dev/dsk/c1t0d2s3 /dev/dsk/c1t0d1s3 executing 75%
Work2  /dev/dsk/c1t0d0s4 ----       ----    ----              ----              ----      ----
Work2  /dev/dsk/c1t0d0s5 2          12      /dev/dsk/c1t0d2s5 ----              succeeded ---
Work2  /dev/dsk/c1t0d0s6 3          13      /dev/dsk/c1t0d2s6 /dev/dsk/c1t0d1s6 executing 75%
:
    #

    The following information will be displayed.

    Title

    Description

    Server

    Displays a storage server name.

    Transaction-Disk

    Displays the device name of a transaction volume.

    Generation

    Displays the relative generation number of restored backup data.

    "----" will be displayed if no generation number is specified in the -g or -v option and no history being restored exists.

    Version

    Displays the absolute generation number of restored backup data.

    "----" will be displayed if no generation number is specified in the -g or -v option and no history being restored exists.

    Backup-Disk

    Displays the name of a backup volume from which data should be copied and restored.

    "----" will be displayed if restoration is not in progress.

    Restore-Device

    Displays a restore target device name unless data is copied and restored to a transaction volume.

    "----" will be displayed if restoration is not in progress or data is restored to a transaction volume.

    Status

    Displays an execution status.

    • "----": No copying using OPC or software-copy by GDS is in progress.

    • "executing": Copying using OPC or software-copy by GDS is in progress.

    • "succeeded": Copying using OPC or software-copy by GDS has been completed.

    • "failed": Copying using OPC has been interrupted due to an error.

    • "halt": Copying using OPC has been halt status.

    • "gds-error": Copying with GDS ended abnormally.

    Execute

    Displays how much has been copied in percentage if "executing" is displayed in the Status field. Displays "----" unless "executing" is displayed.

If "failed" is displayed in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".

If no generation number has been specified in the -v or -g option, the restore execution statuses of all the history will be displayed. If, at this time, restoration is not in progress from any of the history, "----" will be displayed in all the information fields other than "Server" and "Transaction-Disk".

In the following cases, restore execution status display processing cannot be executed:

If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed. Correct the cause of the GDS problem, and take action as follows:

10.1.2.6 History information display command (swsthistdisp)

This command displays history information that has been backed up.

  1. Specification method

    - Displaying the backup history information by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swsthistdisp [Device-Name]

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swsthistdisp [-h Server] [Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name corresponding to a transaction volume.

    Specify the name of a block device.

    If this operand is omitted, the backup history information of all the transaction volumes will be displayed.

  4. End status
    = 0: Normal end
    > 0: Abnormal end

  5. Execution example

    Display the backup history information of all the transaction volumes.

    # /opt/FJSVswsts/bin/swsthistdisp
Server=StrgSV01 Device=/dev/sdb6 Mount-Point=/mnt/Tran1 (ext2)
Generation Version Backup-Date      Backup-Device Status    Execute 
1          10      2000/11/12 22:00 /dev/sdd6     succeeded ----
2          9       2000/11/11 22:00 /dev/sdf6     succeeded ----
  :
#

    The following information will be displayed.

    Keyword

    Description

    Server

    Displays a storage server name.

    Device

    Displays a device name.

    Mount-Point

    Displays the mount point name of the device and the file system type in parentheses.

    Generation

    Displays a relative generation number.

    This item will not be displayed if no backup history information exists.

    Version

    Displays an absolute generation number.

    This item will not be displayed if no backup history information exists.

    Backup-Date

    Displays a date at which backup has been completed.

    This item will not be displayed if no backup history information exists.

    Backup-Device

    Displays the name of a backup volume to which data has been backed up.

    This item will not be displayed if no backup history information exists.

    Status

    Displays an actual copying execution status using one of the following character strings.

    • "succeeded": Copying using OPC has been completed.

    • "executing": Copying using OPC is in progress.

    • "failed": Copying using OPC has been interrupted due to an error.

    • "halt": Copying using OPC has been halt status.

    • "gds-error": Copying with GDS ended abnormally.

    This item will not be displayed if no backup history information exists.

    Execute

    Displays how much has been copied in percentage if "executing" is displayed in the Status field. Displays "----" unless "executing" is displayed.

    This item will not be displayed if no backup history information exists.

    ArcSerial

    The archive log serial number is displayed

    "Reference" is displayed for history information backed up by the reference dump.

    When backup history information does not exist, the archive log serial number is not displayed.

If "failed" or "halt" is displayed in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".

In the following cases, history information display processing cannot be executed:

If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed. Correct the cause of the GDS problem, and take action as follows:

10.1.2.7 History information deletion command (swsthistdel)

This command deletes backup history information.

The backup volume of the deleted history is released and turns into empty backup volume.

If the history information display command displays "failed" in the "Status" field, a hardware error may have occurred. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".

  1. Specification method

    - Deleting backup history information by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swsthistdel -g Generation-No| -v Version-No | -z [-emergency] Device-Name

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swsthistdel [-h Server] -g Generation-No| -v Version-No | -z [-emergency] Device-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -g

    Specifies the relative generation number of backup history information to be deleted.

    This option cannot be specified at the same time as the -v or -z.

    Check the relative generation number using the history information display command (swsthistdisp).

    -v

    Specifies the absolute generation number of backup history information to be deleted.

    This option cannot be specified at the same time as the -g or -z.

    Check the absolute generation number using the history information display command (swsthistdisp).

    -z

    Specifies to delete all the backup history information.

    This option cannot be specified at the same time as the -g or -v.

    -emergency

    Emergency operation mode is available for operations.

    In such cases, OPC sessions are neither confirmed nor cancelled.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name corresponding to a transaction volume.

    Specify the name of a block device.

  4. End status
    = 0: Normal end
    > 0: Abnormal end

  5. Execution example

    Delete the backup history of absolute generation number 10 in a transaction volume (/dev/dsk/c1t0d0s6).

    # /opt/FJSVswsts/bin/swsthistdel -v 10 /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swsthistdel completed
#

    The history information of relative generation number 1 of the transaction volume (/dev/dsk/c1t0d0s6) is deleted in emergency operation mode.

    # /opt/FJSVswsts/bin/swsthistdel -g 1 -emergency /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swsthistdel completed
#

You cannot delete backup history information if:

However, OPC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an OPC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.

Deleting the suspended history information does not cancel the synchronous processing (EC session).
Deleteing the tracking history information does not cancel the tracking processing (OPC session).

In synchronous high-speed backup with -suspend specified, the backup volume remains in use even after the history information is deleted.
In differential snapshot high-speed backup with -T specified, the backup volume remains in use even after the the history information is deleted.

If a logical volume of VxVM is deleted or its structure is changed to a structure not supported by AdvancedCopy Manager, restoration cannot be cancelled. In such cases, take action according to either item a) or b).

  1. Make sure that advanced copy is not in progress for the replication volume to be deleted, and execute this command with the -emergency option specified. (If advanced copy is in progress, stop advanced copy processing by using the disk array unit or take action according to item b).)

  2. Re-create the logical volume or return the logical volume structure to its original state, and then execute this command.

If the history information is deleted while the OPC physical copy has not been completed in a backup operation mode other than the differential snapshot high-speed backup, physical copying of the deleted history is interrupted. In this case, the data in the backup volume is incomplete (copy stopped halfway). The backup volume is put in the unused state upon deletion of the history information and becomes ready to use at the subsequent backup.
In the differential snapshot high-speed backup mode, the physical copying of the deleted history is continued even after the history information on the incomplete OPC physical copy is deleted. Even after deletion of the history information, the backup volume is in the busy state and becomes ready to use at the subsequent backup of the relevant transaction volume.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (backup management)".

This command can be executed only while none of the following commands are running.

10.1.2.8 Backup synchronous processing start command (swststartsync)

This command starts backup synchronous processing (starts disk-to-disk copy using EC).

For a GDS transaction volume, synchronous processing by software-copy is also possible.

  1. Specification method

    -  Starting synchronous backup processing by specifying a transaction volume

[To be executed on a storage server]

# /opt/FJSVswsts/bin/swststartsync [-Xgds-softcopy | -Xgds-selectcopy] Device-Name [-Xdevmap Device-Map-File]

[To be executed on a storage management server]

# /opt/FJSVswsts/bin/swststartsync [-h Server] [-Xgds-softcopy | -Xgds-selectcopy] Device-Name [-Xdevmap Device-Map-File]

  2. Description of options

    Option

    Description

    -h

    Specify the name of a Storage server.

    This option can be specified only on the Storage management server.

    -Xdevmap

    Specifies a target backup volume to perform the backup synchronous processing. In the operand, specify a device map file in which a combination of a transaction volume and a target backup volume is described. If this option is not specified, the target backup volume will be automatically selected. To execute this command on a remote basis using the -h option, specify a device map file (of a storage server) using an absolute pathname. A file name specified in Device-Map-File must not include any national character.

    -Xgds-softcopy

    Specifies the start of backup synchronous processing of an SDX object and use of the software-copy function instead of the advanced copy function.

    If you specify this option to start differential copying when the advanced copy function is being used, advanced copy processing stops and software-copy processing starts.

    You can specify the option when the function in linkage with GDS Snapshot is being used.

    -Xgds-selectcopy

    Specifies that GDS select the copy processing method of an SDX object.

    You can specify the option when the function in linkage with GDS Snapshot is being used.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify the name of a block device.

  4. End status

    = 0: Normally end

    > 0: Abnormally end

  5. Execution example

    Start synchronous backup processing of a transaction volume (/dev/dsk/c1t0d0s6).

    # /opt/FJSVswsts/bin/swststartsync /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swststartsync completed.
#

    Backup synchronous processing of a logical volume (/dev/sfdsk/CLS01/dsk/VOL01) of an SDX object is started. The copy processing method is software-copy.

    # /opt/FJSVswsts/bin/swststartsync -Xgds-softcopy /dev/sfdsk/CLS01/dsk/VOL01
/dev/sfdsk/CLS01/dsk/VOL01 swststartsync completed.
#

When you execute the backup synchronous processing start command for a transaction volume to which the backup synchronous processing is being executed, the message, "swst0301 Backup synchronous processing is being executed" is output and then the command is terminated normally.

You cannot start backup synchronous processing in the following cases. In any of the cases below, take an action according to the "System administrator response" message.

If a suspended backup volume is the transaction volume at the start of the synchronous processing, then the suspended backup volume is selected as the backup destination with the highest priority, and the synchronous processing restarts (differential copy starts). Otherwise, the synchronous processing (full copy) starts.

Even if already in use, the transaction volume where the synchronous processing started and the suspended backup volume can be used as backup destinations.

Except for the transaction volume where the synchronous processing started and the suspended backup volume, transaction volumes cannot be specified as backup destinations in the device map file.

In the following cases, backup synchronous processing with the output destination backup volume specified cannot be started:

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (backup management)".

When any of the following commands is running, this command cannot be executed:

10.1.2.9 Backup synchronous processing cancel command (swstcancelsync)

The backup synchronous processing during copying by EC or under the equivalency maintain status may be canceled.

The synchronous processing can be canceled with the backup volume during copying by EC, under the equivalency maintain status, or while the Suspend state is set. Specifying cancellation of all of the synchronous processing cancels all of the backup synchronous processing including those in the Suspended state.

If the system detects an error while backup synchronous processing is being executed, the copying being performed at that time terminates abnormally. In such a case, use this command to cancel the backup synchronous processing. Use the backup synchronous processing progress display command (swstsyncstat) to check for the error.

  1. Specification method

    - Canceling synchronous backup processing by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstcancelsync [-emergency] [-bd Backup-Device-Name | -all] Device-Name

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstcancelsync [-h Server] [-emergency] [-bd Backup-Device-Name | -all] Device-Name

  2. Description of options

    Option

    Description

    -h

    Specify the name of a Storage server.

    This option can be specified only with a Storage management server.

    -emergency

    Emergency operation mode is available for operations.

    In such cases, EC sessions are neither confirmed nor cancelled.

    -bd

    The synchronous processing on a specific backup volume can be cancelled. To do so, specify the backup volume name in an operand. The backup volume name and -all option cannot be specified together.

    -all

    All of the synchronous processing of the transaction volume can be specified to be cancelled. This specification and the -bd option cannot be specified together.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify the name of a block device.

    The partition name is specified for the SDX object.

    Backup-Device-Name

    Specify the copy destination backup volume name.

    Specify the block device name for the specified device.

  4. End status

    = 0: Normally end

    > 0: Abnormally end

  5. Execution example

    Cancel synchronous backup processing of a transaction volume (/dev/dsk/c1t0d0s6).

    # /opt/FJSVswsts/bin/swstcancelsync  /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swstcancelsync completed.
#

    Backup synchronous processing of transaction volume (/dev/dsk/c1t0d0s6) is cancelled in emergency operation mode.

    # /opt/FJSVswsts/bin/swstcancelsync -emergency /dev/dsk/c1t0d0s6
/dev/dsk/c1t0d0s6 swstcancelsync completed.
#

    The backup synchronous processing of the backup volume (/dev/dsk/c1t0d2s6) can be specified to be canceled from the transaction volume (/dev/dsk/c1t0d0s6).

    # /opt/FJSVswsts/bin/swstsyncstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk       Status    Execute
Work2  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend   ----
Work2  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75%
# /opt/FJSVswsts/bin/swstcancelsync /dev/dsk/c1t0d0s6 -bd /dev/dsk/c1t0d2s6
/dev/dsk/c1t0d0s6 swstcancelsync completed.
# /opt/FJSVswsts/bin/swstsyncstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk       Status  Execute
Work2  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend ----
#

    All of the backup synchronous processing of the transaction volume (/dev/dsk/c1t0d0s6) can be specified to be cancelled.

    # /opt/FJSVswsts/bin/swstsyncstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk       Status    Execute
Work2  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend   ----
Work2  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75%
# /opt/FJSVswsts/bin/swstcancelsync /dev/dsk/c1t0d0s6 -all
/dev/dsk/c1t0d0s6 swstcancelsync completed.
# /opt/FJSVswsts/bin/swstsyncstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk Status Execute
Work2  /dev/dsk/c1t0d0s6 ----        ----   ----
#

However, EC sessions are neither confirmed nor cancelled by execution in emergency operation mode. If an EC session is in the error suspended state or halt state, then unmanaged sessions remain. In this event, GRmgr or ETERNUSmgr must be used to cancel these sessions.

You cannot cancel synchronous processing if:

If a logical volume of VxVM is deleted or its structure is changed to a structure not supported by AdvancedCopy Manager, restoration cannot be cancelled. In such cases, take action according to either item a) or b).

  1. Make sure that advanced copy is not in progress for the replication volume to be deleted, and execute this command with the -emergency option specified. (If advanced copy is in progress, stop advanced copy processing by using the disk array unit or take action according to item b).)

  2. Re-create the logical volume or return the logical volume structure to its original state, and then execute this command.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (backup management)".

You cannot perform cancel processing of synchronous backup processing in the following cases

This command cannot be executed when any of the following commands is running:

10.1.2.10 Backup synchronous processing progress display command (swstsyncstat)

The execution status of the backup synchronous processing is displayed (during copying, under the equivalency maintain status, in the suspended status).

If one transaction volume has multiple EC sessions, then the statuses of all of these EC sessions are displayed.

  1. Specification method

    - Displaying the synchronous backup processing status of a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstsyncstat [Device-Name]

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstsyncstat [-h Server] [Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specify the name of a Storage server.

    This option can be specified only with the Storage management server.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify the name of a block device.

    When you omit the device name, the system displays the status of backup synchronous processing for all of the transaction volumes.

  4. End status

    = 0: Normally end

    > 0: Abnormally end

  5. Execution example

    Display the synchronous backup processing status of a transaction volume (/dev/dsk/c1t0d0s6).

    # /opt/FJSVswsts/bin/swstsyncstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk       Status    Execute
Work1  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s5 suspend   ----
Work1  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 executing 75% 
#

    Display the synchronous backup processing status of all business volumes.

    # /opt/FJSVswsts/bin/swstsyncstat
Server Transaction-Disk  Backup-Disk       Status     Execute
Work1  /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d2s1 suspend    ----
Work1  /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d2s3 executing  75%
Work1  /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d3s3 suspend    ----
Work1  /dev/dsk/c1t0d1s3 /dev/dsk/c1t0d3s5 equivalent 100%
Work1  /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 failed     ----
Work1  /dev/dsk/c1t0d1s4 ----              ----       ----
#

    The table below lists the meaning of each title.

    Title

    Description

    Server

    Indicates the name of the Storage server.

    Transaction-Disk

    Indicates the name of the transaction volume.

    Backup-Disk

    Indicates the name of the backup volume.

    When backup synchronous processing is not being executed, the system displays "----".

    Status

    Indicates the status of backup synchronous processing:

    • "----": Backup synchronous processing is not being executed.

    • "executing": Backup synchronous processing is being executed but equivalency maintain status has not been established.

    • "equivalent": Equivalency maintain status is established.

    • "suspend": Suspend status is established.

    • "failed": Backup synchronous processing was abnormally terminated.

    • "nosession": No session exists (inconsistent resource information).

    • "halt": Backup synchronous processing is being halt status.

    • "gds-error": Copying with GDS ended abnormally.

    Execute

    Indicates the progress of the backup synchronous processing by EC or softwear-copy as a percentage (0 to 100%).

    "----" is displayed when the status is Suspend and at times not during the backup synchronous processing.

If "failed" or "halt" is indicated as the status of the backup synchronous processing (in the Status field), a hardware failure is considered. Refer to "Troubleshooting for a hardware error, etc. occurring during backup".

If "nosession" is indicated as the status of the backup synchronous processing (in the Status field)," resource information having inconsistency is considered. Use the resource match command (swstsrsemtch) to remove the inconsistency from the resource information.

In the following cases, backup synchronous processing progress display command cannot be executed:

If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed. Correct the cause of the GDS problem, and take action as follows:

10.1.2.11 Execution status display command (swstexecstat)

This command displays the execution status of other commands executed on a transaction volume. The execution status of OPC/EC will be displayed if OPC/EC is being executed.

  1. Specification method

    - Displaying the execution status by specifying a transaction volume

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstexecstat [-j] [Device-Name]

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstexecstat [-h Server] [-j] [Device-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -j

    Specifies to display information in another format.

  3. Description of operand

    Operand

    Description

    Device-Name

    Specifies a device name corresponding to a transaction volume.

    Specify the name of a block device.

    If this operand is omitted, the execution statuses of all the transaction volumes will be displayed.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Display the execution statuses of transaction volumes.

    # /opt/FJSVswsts/bin/swstexecstat 
Server Device            Last-Backup-Date Interval Status Mount-Point (Method) Execute
Work1  /dev/dsk/c1t0d0s3 2000/12/11 12:20 OK       IDLE   /usr1 (ufs)          ----
Work1  /dev/dsk/c1t0d0s4 2000/12/10 12:20 DELAY=1  IDLE   /usr2 (ufs)          sync(22%)
Work1  /dev/dsk/c1t0d0s5 2000/12/09 12:20 DELAY=2  IDLE   /usr3 (ufs)          snapshot(45%)
:
    #

    The following information will be displayed.

    Keyword

    Description

    Server

    Displays a storage server name.

    Device

    Displays a AdvancedCopy Manager device name.

    Last-Backup-Date

    Displays the last backup date.

    * Displays the time when the backup execution command was accepted.

    Interval

    Displays how many days have passed after the specified number of interval days since the last backup date has been exceeded. This item will be displayed as "DELAY=number-of-days-passing". "OK" will be displayed if the number of interval days has not been exceeded.

    Status

    Displays whether any of the following commands is being executed on a transaction volume. If so, "EXEC" will be displayed. Otherwise, "IDLE" will be displayed.

    • Backup policy setting command (swstbkpolset)

    • Backup policy deletion command (swstbkpoldel)

    • Backup execution command (swstbackup)

    • Restore execution command (swstrestore)

    • History information deletion command (swsthistdel)

    • Backup synchronous processing start command (swststartsync)

    • Backup synchronous processing cancel command (swstcancelsync)

    • Restore cancellation command (swstcancelrest)

    Mount-Point(Method)

    Displays the mount point name of a transaction volume and FStype in parentheses.

    Execute

    Displays the name of a command being executed or the copying progress ratio.

    • "----": Neither a command or OPC/EC is being executed.

    • "swststartsync": Backup synchronous processing start command is being executed.

    • "swstcancelsync": Backup synchronous processing cancel command is being executed.

    • "swstbackup": The backup execution command is being processed.

    • "swstrestore": The restore execution command is being processed.

    • "swstcancelrest": The restore cancellation command is being processed.

    • "swstbkpolset": The backup policy setting command is being processed.

    • "swstbkpoldel": The backup policy deletion command is being processed.

    • "swsthistdel": The history information deletion command is being processed.

    • "swstcanceltrk": The tracking cancel command is being processed.

    • "sync(xxx%)": How far the EC operation has progressed.

    • "sync(failed)": Backup synchronous processing has been abnormally terminated.

    • "sync(halt)": EC has been halt status.

    • "snapshot(xxx%)": Progress ratio of backup using OPC

    • "snapshot(failed)": Backup using OPC has abnormally terminated.

    • "snapshot(halt)": Backup using OPC has been halt status.

    • "restore(xxx%)": Progress ratio of restoration using OPC

    • "restore(failed)": Restoration using OPC has abnormally terminated.

    • "restore(halt)": Restoration using OPC has been halt status.

    • "gds-error": Copying with GDS ended abnormally.

    If multiple processes are performed on transaction volumes (for example, when the backup synchronous processing start command is issued while a real copy of the snap shot backup is being handled), the display in the Execute field conforms to the following rule:

    The execution example of using the "-j" option is as follows:

    # /opt/FJSVswsts/bin/swstexecstat -j
Server Device            Execute-Date     Status Mount-Point (Method) Execute
Work1  /dev/dsk/c1t0d0s3 2000/12/11 12:20 IDLE   /usr1 (ufs)          ----
Work1  /dev/dsk/c1t0d0s4 2000/12/10 12:20 IDLE   /usr2 (ufs)          sync(22%)
Work1  /dev/dsk/c1t0d0s5 2000/12/09 12:20 IDLE   /usr3 (ufs)          snapshot(45%)
:
    #

    The following information will be displayed.

    Keyword

    Description

    Server

    Displays a storage server name.

    Device

    Specifies a AdvancedCopy Manager device name.

    Execute-Date

    Displays the command execution time.

    Status

    		 Displays whether any of the following commands is being executed on a transaction volume. If so, "EXEC" will be displayed. Otherwise, "IDLE" will be displayed.

    • Backup policy setting command (swstbkpolset)

    • Backup policy deletion command (swstbkpoldel)

    • Backup execution command (swstbackup)

    • Restore execution command (swstrestore)

    • History information deletion command (swsthistdel)

    • Backup synchronous processing start command (swststartsync)

    • Backup synchronous processing cancel command (swstcancelsync)

    • Restore cancellation command (swstcancelrest)

    Mount-Point(Method)

    		 Displays the mount point name of a transaction volume and FStype in parentheses.
    Execute

    Displays the name of a command being executed or the copying progress ratio.

    • "----": Neither a command or OPC/EC is being executed.

    • "swststartsync": Backup synchronous processing start command is being executed.

    • "swstcancelsync": Backup synchronous processing cancel command is being executed.

    • "swstbackup": The backup execution command is being processed.

    • "swstrestore": The restore execution command is being processed.

    • "swstcancelrest"": The restore cancellation command is being processed.

    • "swstbkpolset": The backup policy setting command is being processed.

    • "swstbkpoldel": The backup policy deletion command is being processed.

    • "swsthistdel": The history information deletion command is being processed.

    • "swstcanceltrk": The tracking cancel command is being processed.

    • "sync(xxx%)": How far the EC operation has progressed.

    • "sync(failed)": Backup synchronous processing has been abnormally terminated.

    • "sync(halt)": EC has been halt status.

    • "snapshot(xxx%)": Progress ratio of backup using OPC

    • "snapshot(failed)": Backup using OPC has abnormally terminated.

    • "snapshot(halt)": Backup using OPC has been halt status.

    • "restore(xxx%)": Progress ratio of restoration using OPC

    • "restore(failed)": Restoration using OPC has abnormally terminated.

    • "restore(halt)": Restoration using OPC has been halt status.

    • "gds-error": Copying with GDS ended abnormally.

During synchronous high-speed backup with -suspend specified, no operation ("----") is indicated in the Execute field.

If "sync (failed),", "snapshot(failed)", or "restore(failed)", "sync (halt)", "snapshot(halt)" or "restore(halt)" is displayed in the "Execute" field, a hardware error may have occurred. After removing the cause of the hardware error, do as follows:

In the following cases, execution status display command cannot be executed:

If "gds-error" is the status displayed in the Status field, a problem with GDS is assumed. Correct the cause of the GDS problem, and take action as follows:

10.1.2.12 Tracking cancel command (swstcanceltrk)

This command stops tracking processing.

  1. Specification method

    [To execute on the storage server]
    # /opt/FJSVswsts/bin/swstcanceltrk [-copy | -emergency] Device-Name (-bd Backup-Device-Name | -all)

    [To execute on the storage management server]
    # /opt/FJSVswsts/bin/swstcanceltrk -h Server-Name [-copy | -emgergency] Device-Name (-bd Backup-Device-Name | -all)

  2. Options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on the storage management server.

    -copy

    Specifies that physical copying, if active, should also be stopped (the OPC session should be canceled).

    This option cannot be specified for a backup volume that has already been a backup history. For a volume whose copy destination volume has been a backup history, delete the history information in advance using the history deletion command (swsthistdel).

    -emergency

    Specifies that the command should operate in emergency operation mode.

    The command does not check tracking processing and does not stop tracking processing and the OPC session.

    -bd

    Stops tracking processing for the specified backup volume. Specify the target backup volume name as an operand. This option cannot be specified together with the -all option.

    -all

    Stops the entire tracking processing specified for the transaction volumes. This option cannot be specified together with the -bd option.

  3. Operand

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify a block device name.

  4. End status

    = 0: Normal end
    > 0: Abnormal end

  5. Example

    The following example stops the tracking processing that was specified for the backup volume (/dev/dsk/c1t0d2s6) from the transaction volume (/dev/dsk/c1t0d0s6) 

    # /opt/FJSVswsts/bin/swstcanceltrk /dev/dsk/c1t0d0s6 -bd /dev/dsk/c1t0d2s6
/dev/dsk/c1t0d0s6 swstcanceltrk completed.
#

    The following example stops tracking processing and physical copying that were specified for the transaction volume (/dev/dsk/c1t0d0s6). 

    # /opt/FJSVswsts/bin/swsttrkstat /dev/dsk/c1t0d1s6
Server Transaction-Disk  Backup-Disk       Status    Execute Update
job2   /dev/dsk/c1t0d1s6 /dev/dsk/c1t0d2s6 executing 33%     -----
# /opt/FJSVswsts/bin/swstcanceltrk -copy /dev/dsk/c1t0d1s6 -bd /dev/dsk/c1t0d2s6
/dev/dsk/c1t0d0s6 swstcanceltrk completed.
#

If the command is executed in emergency operation mode, no OPC session is canceled. A session that is not managed remains if the command is entered during tracking. The session must be canceled using GRmgr, ETERNUSmgr, or GDS.

Tracking processing cannot be stopped under the following conditions. In this case, take action according to "System administrator response" provided for the message output.

This command cannot be executed while the following command is executed:

10.1.2.13 Tracking status display command (swsttrkstat)

This command displays the status of tracking processing.

When multiple types of synchronous processing exist for one transaction volume, the command displays the statuses of all types of tracking processing.

  1. Specification method

    [To execute on the storage server]
    # /opt/FJSVswsts/bin/swsttrkstat [Device-Name]

    [To execute on the storage management server]
    # /opt/FJSVswsts/bin/swsttrkstat [-h Server] [Device-Name]

  2. Options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on the storage management server.

  3. Operands

    Operand

    Description

    Device-Name

    Specifies a device name.

    Specify a block device name.

    If this operand is omitted, the command displays the statuses of tracking processing for all transaction volumes.

  4. End status

    = 0: Normal end
    > 0: Abnormal end

  5. Example

    The following example displays the status of tracking processing of a transaction volume (/dev/dsk/c1t0d0s6): 

    # /opt/FJSVswsts/bin/swsttrkstat /dev/dsk/c1t0d0s6
Server Transaction-Disk  Backup-Disk       Status    Execute Update
job1   /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 tracking  ----    12%
#

    The following example displays the status of tracking processing of all transaction volumes:

    # /opt/FJSVswsts/bin/swsttrkstat
Server Transaction-Disk  Backup-Disk       Status    Execute Update
job1   /dev/dsk/c1t0d0s3 /dev/dsk/c1t0d2s3 nosession ----    ----
job1   /dev/dsk/c1t0d0s4 /dev/dsk/c1t0d2s4 executing 75%     ----
job1   /dev/dsk/c1t0d0s5 /dev/dsk/c1t0d2s5 failed    ----    ----
job1   /dev/dsk/c1t0d0s6 /dev/dsk/c1t0d2s6 tracking  ----    12%
job1   /dev/dsk/c1t0d1s4 ----              ----      ----    ----
  :
#

    The displayed data is explained below.

    Title

    Description

    Server

    Displays a storage server name.

    Transaction-Disk

    Displays a transaction volume name.

    Backup-Disk

    Displays a backup volume name.

    Displays "----" when the volume is not in the tracking status.

    Status

    Displays the execution status.

    "----": Not in progress of tracking

    "executing": In progress of physical copying and tracking

    "tracking": In progress of tracking

    "failed": Physical copying or tracking terminated abnormally.

    "nosession": No session exists. (Resource information is inconsistent.)

    Execute

    Displays the progress of copying as a percentage when "executing" is displayed in the Status column. "----" is displayed when "tracking" is displayed in the Status column.

    Update

    Displays the amount of updated data after logical copying as a percentage when "tracking" is displayed in the Status column. "----" is displayed when "executing" is displayed in the Status column.

When the execution status (status displayed in the "Status" column) is "failed," a hardware problem is assumed. Remove the problem cause and then reexecute the differential snapshot backup.

When the execution status (status displayed in the "Status" column) is "nosession," the resource information is probably inconsistent. Use the resource matching command (swstsrsemtch) to remove any inconsistencies from the resource information.

The execution status of tracking processing cannot be displayed under the following conditions:

10.1.3 Maintenance commands 

This chapter describes maintenance commands for backup management.

To operate backup management, use the following maintenance commands:

Function

Command name

Description

Resource match command

swstsrsemtch

Recovers the consistency of information in a backup management files.

Resource backup command

swstresback

Backs up a backup management files.

Resource restore command

swstresrst

Restores a backup management files.

10.1.3.1 Resource match command (swstsrsemtch)

This command makes recovery to make resource information consistent if a system failure, etc. has made the resource information inconsistent.

  1. Specification method

    [To be executed on a storage server]

    # /opt/FJSVswsts/bin/swstsrsemtch [-x]

    [To be executed on a storage management server]

    # /opt/FJSVswsts/bin/swstsrsemtch [-x] [-h Server]

  2. Description of operands

    Operand

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -x

    Gets consistency with a repository. Specify this option if the consistency between a backup management files and a repository comes to be inconsistent.

  3. Execution example

    # /opt/FJSVswsts/bin/swstsrsemtch
    swstsrsemtch completed
    #

In the following cases, resource match processing cannot be executed:

This command can be executed only while none of the following commands are running.

10.1.3.2 Resource backup command (swstresback)

This command backs up a backup management files to a specified directory.

  1. Specification method

    # /opt/FJSVswsts/bin/swstresback Backup-Directory

  2. Description of operand

    Operand

    Description

    Backup-Directory

    Specifies the name of a directory to which resource control information should be saved.

  3. Execution example

    Create backup copy of the backup management files in /home/backup.

    # /opt/FJSVswsts/bin/swstresback /home/backup
    swstresback completed
    #

You cannot perform backup if:

This command can be executed only while none of the following commands are running.

10.1.3.3 Resource restore command (swstresrst)

A backup management files is restored from the specified directory.

  1. Specification method

    # /opt/FJSVswsts/bin/swstresrst Backup-Directory

  2. Description of operand

    Operand

    Description

    Backup-Directory

    Specify the name of the directory to which to save the backup management files.

  3. Execution example

    Create backup copy of the backup management files in /home/backup.

    # /opt/FJSVswsts/bin/swstresrst /home/backup
    swstresrst completed
    #

Before the backup management files can be restored by this command, the storage server configuration information setting command (swstsvrset) must be executed.
Specify the directory specified in the resource backup command as the output destination directory name of the backup management files.

You cannot perform restoration if:

This command can be executed only while none of the following commands are running.

10.2 Configuration Management Commands 

This chapter is explaining operation by the command of the configuration management, which manages the information of the servers and their devices for backup management or replication management.

Operating environment for command execution

The table below lists the requirements for the operating environment in which to execute the respective commands.

Command

Operating environment of AdvancedCopy Manager

stgcmmodnode

To execute this command on a storage management server (storage management server transaction), the storage management server (storage management server transaction) must be operating.

stguserset

In cluster operation, the storage management server transaction must be operating.

stgguiipset

In cluster operation, the storage management server transaction must be operating.

stgxfwcmaddsrv

The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.

stgxfwcmmodsrv

The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.

stgxfwcmdelsrv

The storage management server (storage management server transaction) must be operating.

stgxfwcmsetdev

The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.

stgxfwcmdeldev

The storage management server (storage management server transaction) and target storage server (storage server transaction) must be operating.

stgxfwcmdispsrv

The storage management server (storage management server transaction) must be operating.

stgxfwcmdispdev

The storage management server (storage management server transaction) must be operating.

stgxfwcmdisppat

The storage management server (storage management server transaction) must be operating.

stgenvdisp

This command is executable when both storage management server (storage management server transaction) and storage server (storage server transaction) are not operating.
Note that when the cluster service (named differently in respective cluster systems) is not operating in cluster operation, this command cannot display certain information.

stgmgrinfoset

The package-backup-of-the-management-information execution server must be operating.

stgmgrinfobkup

The storage management server (storage management server transaction), package-backup-of-the-management-information execution server, and package-backup-of-the-management-information target servers must be operating.

stgmgrinfodisp

The package-backup-of-the-management-information execution server must be operating.

In cluster operation

In cluster operation, execute a command by taking the following steps:

  1. If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. For bsh, specify the environment variable as follows:

    # SWSTGNODE=logical-node-name<Enter>
# export SWSTGNODE

  2. Execute the command.

    The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.

    Command

    Environment variable

    Command execution node

    Remarks

    stgcmmodnode

    Required

    Transaction operating node

    stgguiipset

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stguserset

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmaddsrv

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmmodsrv

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmdelsrv

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmsetdev

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmdeldev

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmdispsrv

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmdispdev

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgxfwcmdisppat

    Not required

    Transaction operating node

    Executable only on storage management server transaction

    stgenvdisp

    Not required

    Transaction operating node

    stgmgrinfobkup

    Required

    Transaction operating node

    stgmgrinfodisp

    Required

    Transaction operating node

    stgmgrinfoset

    Required

    Transaction operating node

10.2.1 Management server information change command (stgcmmodnode)

This command changes the server change information of the Storage management server. Concretely, execute this command for the following purposes:

This command has the following two functions:

Refer to the following for the change procedure which uses this command.

  1. Specification method

    # /opt/FJSVswstf/bin/stgcmmodnode [-i IP-address] [-p PORT number] [-n server name]

  2. Description of options

    Option

    Description

    None

    Displays the server information currently managed.

    -i

    Specifies the IP address of a storage management server to change the IP address of the storage management server.

    -p

    Specifies the port number of a storage management server to change the port number of the storage management server.

    -n

    Specifies the server name of a storage management server to change the server name of the storage management server. This option cannot be specified if this command is executed on a storage management server.

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    Display server information.

    # /opt/FJSVswstf/bin/stgcmmodnode
swstf2413 IP Address = 10.10.10.10
swstf2413 PORT Number = 1226
swstf2413 Storage Management Server's Name = fujitsu-storage-management-server
#

    Change the IP address of a storage management server to 10.12.13.14.

    # /opt/FJSVswstf/bin/stgcmmodnode -i 10.12.13.14
swstf2401 AdvancedCopy Manager registry updated.

The following lists notes on this command.

10.2.2 Repository access user change command (stguserset)

This command changes a user name and/or password used to access a repository. This command must be executed on the Storage management server.

We recommend you to use not a high root user but the general user of frequency of password change by the viewpoint of security.

The change in the user-name and the password is executed according to the following procedures.

  1. Close Web browser of AdvancedCopy Manager.

  2. Execute Repository access user change command (stguserset).

  3. Stop RMI daemons.

  4. Start RMI daemons.

  1. Specification method

    # /opt/swstorage/bin/stguserset user-name password

  2. Description of options

    Option

    Description

    User name

    Specifies a user name to be used for repository access.

    Password

    Specifies a user password to be used for repository access.

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    Change the user name and the password to be used for repository access to a1234 and Yfd1fz3, respectively.

    # /opt/swstorage/bin/stguserset a1234 Yfd1fz3

    Password for accessing the repository has been registered.

The following lists notes on this command.

10.2.3 GUI connection information setting command (stgguiipset)

The Storage management server is equipped with two or more network cards, and it is used when dividing and employing the IP address specified in case the IP address (IP address specified when it was the database creation at the time of Storage management server introduction) and Web screen with a Storage server which communicate are used. It is necessary to execute this command by the Storage management server.

This command has the following 2 functions.

The change in IP address for GUI connection of a Storage management server is executed according to the following procedures.

  1. Close Web browser of AdvancedCopy Manager.

  2. Execute GUI connection information setting command (stgguiipset).

  3. Stop RMI daemons.

  4. Start RMI daemons.

  1. Specification method

    # /opt/FJSVswstf/bin/stgguiipset [-i IP address]

  2. Description of options

    Option

    Description

    None

    Displays the IP address for GUI connection currently managed.

    -i

    The IP address for GUI connection to change is specified.

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    The IP address for the present GUI connection is displayed.

    # /opt/FJSVswstf/bin/stgguiipset
IP Address = 10.10.10.10

    The IP address for GUI connection of a Storage management server is changed into 10.12.13.14.

    # /opt/FJSVswstf/bin/stgguiipset -i 10.12.13.14
swstf2401 Renewal of the server information on a Storage management server was completed normally.

The following lists notes on this command.

10.2.4 Server information addition command(stgxfwcmaddsrv)

This command adds Storage server information to be managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmaddsrv [-n Server-Name] -i IP-Address -p PORT-Number

  2. Description of options

    Option

    Description

    -n

    Specifies the name of the storage server to be added. The name must be less than 255 bytes(*2) and a unique server name for AdvancedCopy Manager in order for it to manage the server.

    • Non-cluster operation: Host name recognized by the operating system

    • Cluster operation: AdvancedCopy Manager logical node name specified during cluster setup

    -i

    Specify the IP address of the Storage server to be added by IPv4 format.

    Specify a physical IP address if the Storage server is managed as a physical server. Specify a logical IP address if the IP address is made redundant and managed (as a logical server), like under the cluster environment.

    -p

    Specify the port number that is set on the Storage server side to communicate with the Storage server to be added. (Value from 1,024 to 65,535)

    Under the cluster environment, specify the port number that is allocated to the service name stgxfws_? (*1).

    (*1) Logical node name of AdvancedCopy Manager specified during cluster setup
    (*2) The usable characters are: 1-byte alphanumeric characters, minus sign (-), underscore (_), number sign (#), and period (.), with the first character being a 1-byte alphanumeric character. (A 2-byte character causes an error.)

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    Add a server by using host name.

    # /opt/FJSVswstf/bin/stgxfwcmaddsrv -i 10.10.10.10 -p 1226
stgxfwcmaddsrv completed
#

    Add a logical server that cluster setup is performed by specifying a server name.

    (Logical IP address: 10.10.10.20; port number allocated to stgxfws_logical-node-name: 1227)

    # /opt/FJSVswstf/bin/ stgxfwcmaddsrv -n Server1 -i 10.10.10.20 -p 1227
stgxfwcmaddsrv completed
#

The following provides notes on this command:

This command cannot be executed when the following commands are being executed:

This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:

10.2.5 Server information change command (stgxfwcmmodsrv)

This command changes the following server information managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.
Also, use this when installing the tape server function on the target server later.

This command cannot change the following server information, because it is changed by using the management server information change command (stgcmmodnode)

When the server information is changed by using this command, the machine definition information must be changed in advance. Refer to the procedure given in Chapter 9.5, "Changing the operating Environment," to execute the processing.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmmodsrv -n Server-Name [-s New-Server-Name] [-i New-IP-Address] [-p New-Port-Number]

  2. Description of options

    Options

    Description

    -n

    Specify a server name that is currently being managed.

    -s

    Specify a new server name within 255 bytes. The usable characters are: 1-byte alphanumeric characters, minus sign (-), underscore (_), number sign (#), and period (.), with the first character being a 1-byte alphanumeric character. (A 2-byte character causes an error.)

    -i

    Specify the IP address of the Storage server to be added by IPv4 format.

    Specify a physical IP address if the Storage server is managed as a physical server. Specify a logical IP address if the IP address is made redundant and managed (as a logical server), like under the cluster environment.

    -p

    Specify a port number required for postchange communication. (Value from 1024 to 65535)

    Under the cluster environment, specify the port number that is allocated to service name stgxfws_? (*1).

    (*1) Logical node name of AdvancedCopy Manager specified during cluster setup

  3. End status

    = 0: Normal end
    > 0: Abnormal end

  4. Execution example

    The IP address of a Storage server (server name: Server1) is changed to 10.20.30.40.

    # /opt/FJSVswstf/bin/stgxfwcmmodsrv -n Server1 -i 10.20.30.40
stgxfwcmmodsrv completed
#

    The server name of a Storage server (server name: Server1) is changed to Agent5.

    # /opt/FJSVswstf/bin/stgxfwcmmodsrv -n Server1 -s Agent5
stgxfwcmmodsrv completed
#

The following provides notes on this command:

This command cannot be executed when the following commands are being executed:

This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:

10.2.6 Server information deletion command (stgxfwcmdelsrv)

This command deletes the Storage server information that AdvancedCopy Manager is currently managing. It is necessary to execute this command on the Storage management server.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmdelsrv -n Server-Name

  2. Description of options

    Options

    Description

    -n

    Specify the Storage server name to be deleted.

  3. End status

    = 0: Normal end
    > 0: Abnormal end

  4. Execution example

    A Storage server's (server name: Server1) information is deleted.

    # /opt/FJSVswstf/bin/stgxfwcmdelsrv -n Server1
    stgxfwcmdelsrv completed
    #

The following provides notes on this command:

This command cannot be executed when the following commands are being executed:

This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:

10.2.7 Device information collection/reflection command (stgxfwcmsetdev)

This command collects the latest device information detected by the server and displays the difference with the information managed by AdvancedCopy Manager. Later, it reflects the specified device difference information in the management information for AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.

The device information currently being managed and the device information detected are compared, stored, deleted, and updated, and used in the following cases:

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmsetdev -n Server-name [-d Device-Name] [-f File-Name | -y ]

  2. Description of options

    Options

    Description

    -n

    Specify the server name whose device information is to be collected or reflected.

    -d

    Specify the device name whose information is to be collected or reflected.

    If this specification is omitted, all devices of the specified server are assumed to be specified.

    -f

    Use the absolute path to specify the file name to which the difference between the device information managed currently and the device information collected is output. The device difference information is only output to the file, and the reflection processing for the subsequent management information is not executed.

    This option cannot be specified with the -y option.

    -y

    The difference between the device information managed by AdvancedCopy Manager and the latest device information detected is reflected unconditionally in the management information without an inquiry made about that difference.

    This option cannot be specified with the -f option.

  3. End status

    = 0: Normal end
    > 0: Abnormal end

  4. Execution example

    The information for each device of a server (server name: Server1) is collected or reflected.

    # /opt/FJSVswstf/bin/stgxfwcmsetdev -n Server1
>Device detected 
  1:/dev/rdsk/c4t0d54s0
  2:/dev/rdsk/c4t0d54s1
  3:/dev/rdsk/c4t0d54s2
  4:/dev/rdsk/c4t0d54s6 (/storage-2)
>Device not detected 
  1:/dev/rdsk/c4t0d11s0 (/aaa)
  2:/dev/rdsk/c4t0d11s1
>Specify a device requested to be added. [* or ?-? or ?,? or q]
2,4
>Specify a device requested to be deleted. [* or ?-? or ?,? or q]
*
>Do you want to continue the processing? [y or n] y
stgxfwcmsetdev completed
#

    The information for a specific device (device name: /dev/rdsk/c4t0d10s0) managed by the server (server name: Server1) is collected or reflected.

    # /opt/FJSVswstf/bin/stgxfwcmsetdev -n Server1 -d /dev/rdsk/c4t0d10s0
> The following device information has been changed.  This information is updated.
  1:/dev/rdsk/c4t0d10s0 (/zzz)
> Do you want to continue the processing? [y or n] y
stgxfwcmsetdev completed
#

Use the following methods to request addition or deletion:

The following provides notes on this command:

The following message may be displayed when a device requested to be added is specified. It is an indication of an attempt to register a device that is in the GR cabinet and may have invalid settings. Make sure that no problem would occur in operation before continuing the processing.(This message is also displayed when the -y option is specified.) 
>The setting of license or the table size is not done, or the table size is insufficient, to the cabinet where the partition that makes up the following deviceexists.
>Continue? [y or n]

The following message may be displayed when a device requested to be added is specified. In this case, check the following before continuing the processing: whether the device is to be subjected to duplicated registration when two or more logical servers running on the same physical server are managed. (This message is also displayed when the -y option is specified.) 
> The partitions that comprise the following device are already managed. 
> Do you want to continue the processing? [y or n]

The amount of time required to process this command is proportional to the total number of devices defined on the specified server when the device information is collected. When the number of devices is large, execute the command with low CPU and I/O loads.
Note that it takes about 0.5 second for one device (partition) in no load state.

This command cannot be executed when the following commands are being executed:

This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:

10.2.8 Device information deletion command (stgxfwcmdeldev)

This command deletes the device information currently being managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.

The device information collection/reflection command(stxfwcmsetdev) compares the device information currently being managed and the device information detected before it executes the processing. However, this command deletes the device information irrespective of whether the device information currently being managed is detected.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmdeldev -n Server-Name -d Device-Name

  2. Description of options

    Options

    Description

    -n

    Specify the server name that is managing the device to be deleted.

    -d

    Specify the device name to be deleted.

  3. End status

    = 0: Normal end
    > 0: Abnormal end

  4. Execution example

    The device (/dev/rdsk/c4t0d12s7) information for a Storage server (server name: Server1) is deleted.

    # /opt/FJSVswstf/bin/stgxfwcmdeldev -n Server1 -d /dev/rdsk/c4t0d12s7
stgxfwcmdeldev completed
#

The following provides notes on this command:

This command cannot be executed when the following commands are being executed:

This command cannot be exectued when the following operations are being performed in the initial window by using the Web screen:

10.2.9 Server information display command (stgxfwcmdispsrv)

This command displays the server information managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmdispsrv [-n Server-Name ]

  2. Description of options

    Options

    Description

    -n

    Specify the server name whose information is to be displayed.

    If this specification is omitted, the information for all servers managed by AdvancedCopy Manager is displayed.

  3. End status

    = 0: Normal end
    > 0: Abnormal end

  4. Execution example

    The information for all servers is displayed.

    # /opt/FJSVswstf/bin/stgxfwcmdispsrv
Server  Server-Type       Tape OS-Type OS-Version Version IP-Address  Port-Number
Manager Management-Server --   Solaris 9          V10.2   10.10.10.10 1226
Server1 Server            --   Solaris 7          V10.2   10.10.10.20 1226
#

    The information for a Storage server (server name: Server1) is displayed.

    # /opt/FJSVswstf/bin/stgxfwcmdispsrv -n Server1
Server  Server-Type Tape OS-Type OS-Version Version IP-Address  Port-Number
Server1 Server      --   Solaris 7          V10.2   10.10.10.20 1226
#

    The contents to be displayed are as follows:

    Title

    Description

    Server

    A server name is displayed.

    Server-Type

    A server type is displayed.
    "Management-server": Storage management server
    "Server": Storage server

    Tape

    "Y" indicated for a tape server.

    OS-Type

    An operating system type is displayed.

    OS-Version

    An operating system version is displayed.

    Version

    The version of this product is displayed.

    IP-Address

    The IP address for communication with the server is displayed.

    Port-Number

    The port number for communication with the server is displayed.

The following provides notes on this command:

10.2.10 Device information display command (stgxfwcmdispdev)

This command displays the device managed by AdvancedCopy Manager. Moreover, the list of the device which uses the specified same to device copy area, the specified device, and the device which exists in the same, logical group can be displayed.

It is necessary to execute this command on the Storage management server.

It displays it based on information registered in AdvancedCopy Manager. Therefore, when the composition has been changed there is a device not registered in a logical group, and after it registers, correct information is not displayed. For this case, please execute acquisition of device information on the registration of the device not registered and the device which does the "Acquisition/reflection of information on all devices" processing again.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server-Name [-d Device-Name [-sm|-grp]]

  2. Description of options

    Options

    Description

    -n

    Specify the server name that manages the device whose information is to be displayed.

    -d

    Specify the device name whose information is to be displayed.

    If this specification is omitted, the information for all devices managed by the specified server is displayed.

    -sm

    With the -d option also specified, this option specifies that a list of the devices using the same copy area as the specified device be displayed.

    -grp

    The list of the device which exists in the same logical group as a specified device is displayed by specifying it simultaneously with -d option. this option - The device type of the specified device can be specified for d option only for LVM/VxVM.

  3. End status

    = 0: Normal end
    > 0: Abnormal end

  4. Execution example

    The information for a device (/dev/rdsk/c4t0d10s0) of a server (Server1) is displayed.

    # /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1 -d /dev/rdsk/c4t0d10s0
S Device              Block-Device       Mount-Point File-System Device-Type Size(MB)
  /dev/rdsk/c4t0d10s0 /dev/dsk/c4t0d10s0 /zzz        ufs         Normal      1028    
#

    The information for each device of a server (Server1) is displayed.

    # /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1
S Device                     Block-Device              Mount-Point  File-System Device-Type Size(MB)
  /dev/sfdsk/class/rdsk/vol1 /dev/sfdsk/class/dsk/vol1 ---          ---         SDX(Volume)    25000
* /dev/sfdsk/class/rdsk/vol2 /dev/sfdsk/class/dsk/vol2 /work        ufs         SDX(Volume)     1250
U /dev/rdsk/c1t0d0s0         /dev/dsk/c1t0d0s0         /storagedata ufs         Normal          5200
D /dev/rdsk/c1t0d0s1         /dev/dsk/c1t0d0s1         ---          ---         Normal         15400
#

    Device (/dev/vx/rdsk/dg1/vol1) of server (Server1) is displayed and device information which uses the same copy area is displayed.

    # /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1 -d /dev/vx/rdsk/dg1/vol1 -sm
Device                 Mount-Point
/dev/vx/rdsk/dg1/vol1  /storagedata
/dev/vx/rdsk/dg1/vol2  ---
/dev/vx/rdsk/dg1/vol3  /zzz
#

    Device information which exists in the same logical group as device (/dev/vx/rdsk/dg1/vol1) of server (Server1) is displayed.

    # /opt/FJSVswstf/bin/stgxfwcmdispdev -n Server1 -d /dev/vx/rdsk/dg1/vol1 -grp
Device                 Mount-Point
/dev/vx/rdmp/c1t0d0s2  ---
/dev/vx/rdmp/c1t0d1s2  ---
/dev/vx/rdsk/dg1/vol1  /storagedata
/dev/vx/rdsk/dg1/vol2  ---
/dev/vx/rdsk/dg1/vol3  /zzz
/dev/vx/rdsk/dg1/vol4  ---
#

    The following contents are displayed. Note that "SDX" or "SDX object" in the table are SynfinityDISK or PRIMECLUSTER Global Disk Services (GDS) terms.

    Title

    Description

    S

    The status of each device is indicated. The following is displayed according to the device status:
    *: Device not set up (The AdvancedCopy license setting may be undefined, cache table size may be unspecified, or cache table may be too small in the cabinet containing this device.)
    D: Device deletion error
    U: Device update error

    Device

    (For Solaris server)
    A RAW device name is displayed.

    (Windows server)

    A device name managed internally by AdvancedCopy Manager is displayed.
    The name is displayed in the g?d?p? format.
    g?: Disk array number (0 if the device is not installed in the ETERNUS storage system)
    d?: Disk number (*1)
    p?: Logical disk number (*2)
    In the case of the SDX object, the name is displayed in the disk class name or mirror volume name g?d?p? format.
    Disk class name: Disk class name of SDX object
    Mirror volume name: Mirror volume name of SDX object

    (HP-UX server)
    A RAW device name or a volume group name under LVM is displayed.

    (Linux server)
    When a RAW device has been created, its name is displayed; otherwise, a block device name is displayed.

    (AIX server)
    A RAW device name or a volume group name under LVM is displayed.

    Block-Device

    (Solaris server)
    A block device name is displayed.

    (Windows server)
    The name is displayed in the disk?p? format.

    disk?: Disk number displayed by disk administrator

    p?: Logical disk number (*2)

    (HP-UX server)
    A block device name or a volume group name under LVM is displayed.

    (Linux server)
    A block device name is displayed.

    (AIX server)
    A block device name or a volume group name under LVM is displayed.

    Mount-Point

    (Solaris server, HP-UX server, AIX server and Linux server)
    A mount point name is displayed.

    (Windows server)
    A drive character is displayed.

    File-System

    A file system name is displayed.

    Device-Type

    A device type is displayed.
    Normal/SDX(slice)/LVM/VxVM/SDX(volume)

    Size(MB)

    The capacity (in megabytes) allocated to a device is displayed.

    (*1) A number given uniquely on the disk array. This number differs from the disk number on the disk administrator.

    (*2) The sequential number of a logical disk on the disk. The logical disk indicates the following contents of the disk administrator. The number is given by counting up from the left to the right on the disk administrator.

The following provides notes on this command:

10.2.11 Partition information display command (stgxfwcmdisppat)

This command displays the information for the partitions that comprise a device managed by AdvancedCopy Manager. It is necessary to execute this command on the Storage management server.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmdisppat -n Server-Name -d Device-Name

  2. Description of options

    Options

    Description

    -n

    Specify the server name that manages a device whose information is to be displayed.

    -d

    Specify a device name whose information is to be displayed.

  3. End status

    = 0: Normal end
    > 0: Abnormal end

  4. Execution example

    The partition information for a device (/dev/rdsk/c4t0d10s0) of a server (Server1) is displayed.

    # /opt/FJSVswstf/bin/stgxfwcmdisppat -n Server1 -d /dev/rdsk/c4t0d10s0
Partition           Identifier         Physical-Disk Disk-Type LU-Number
/dev/rdsk/c4t0d10s0 /dev/dsk/c4t0d10s0 ---           GR        10
#

    The following contents are displayed. Note that "SDX" or "SDX object" in the table are SynfinityDISK or PRIMECLUSTER Global Disk Services (GDS) terms.

    Title

    Description

    Partition

    (Solaris server)
    A RAW device name is displayed.
    In the case of an SDX(slice) object, the name is displayed in the RAW device name c?t?d? format.

    (Windows server)
    When the device is installed in the ETERNUS storage system, the same contents as Device of the device information display command
    (stgxfwcmdispdev) are displayed.
    When the device is not installed in the ETERNUS storage system, the name is displayed in the S?p? format.
    S?: Signature (8-digit hexadecimal number)
    p?: Logical disk number (*1)

    (HP-UX server)
    A RAW device name or a volume group name under LVM is displayed.

    (Linux server)
    When a RAW device has been created, its name is displayed; otherwise, a block device name is displayed.

    In the case of a SDX(slice) object, it displays in the form of RAW device name:sd?.

    (AIX server)
    A RAW device name or a volume group name under LVM is displayed.

    Identifier

    (Solaris server)
    A block device name is displayed.
    In the case of an SDX(slice) object, the name is displayed in the block device name c?t?d? format.

    (Windows server)
    A device name managed internally by AdvancedCopy Manager is displayed.

    The same contents as Device of the device information display command
    (stgxfwcmdispdev) are displayed.

    (HP-UX server)
    A block device name or a volume group name under LVM is displayed.

    (Linux server)
    A block device name is displayed.

    In the case of a SDX(slice) object, it displays in the form of block device name:sd?.

    (AIX server)
    A block device name or a volume group name under LVM is displayed.

    Physical-Disk

    (Solaris server, HP-UX server, Linux server, and AIX server)
    "---" is always displayed.

    (Windows server)
    A physical device name is displayed.

    The same contents as Block-Device of the device information display command (stgxfwcmdispdev) are displayed.

    Disk-Type

    When the device is installed in the ETERNUS storage system, "GR" is displayed.

    When the device is not installed in the ETERNUS storage system, "---" is displayed.

    LU-Number

    When the device is installed in the ETERNUS storage system, a logical unit number is displayed.

    When the device is not installed in the ETERNUS storage system, "---" is displayed.

    (*1) The sequential number of a logical disk on the disk. The logical disk indicates the following contents of the disk administrator. The number is given by counting up from the left to the right on the disk administrator.

The following provides notes on this command:

10.2.12 Environment information display command(stgenvdisp)

This command displays values of environment settings in AdvancedCopy Manager.

  1. Specification method

    # /opt/FJSVswstf/bin/stgenvdisp [-n transaction-logical-node-name]

  2. Description of options

    Option

    Description

    -n

    Specifies the logical node name (logical node name specified in the cluster setup command) of the transaction.

    • In a cluster environment

    If this option is specified, information on only the specified transactions is output.

    Otherwise, information on all transactions is output.

    • In a non-cluster environment

    This option cannot be specified. If the option is specified, then message swstf6001 is output and processing ends.

    Otherwise, information is output.

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    Information in a non-cluster environment is displayed.

    [For the storage management server]

    # /opt/FJSVswstf/bin/stgenvdisp
  Server type            : Management server
  Manager IP address     : 10.10.10.10
  Repository user        : acm
  DB file                : /dev/dsk/c0t0d0s4
  RDB dictionary         : /dev/rdsk/c0t0d0s5
  RDB log file           : /dev/rdsk/c0t0d0s6
  Database space         : /dev/rdsk/c0t0d0s7
  IP address for GUI     : 10.10.10.10
  Communication          : 1226
  Remote access          : 9851
  Exclusive control      : 9852
  Authentication feature : 4660
  Repository             : 2004
#

    [For the storage server]

    # /opt/FJSVswstf/bin/stgenvdisp
  Server type            : Server
  Manager IP address     : 10.10.10.10
  Communication          : 1226
#

    Information on all transactions in a cluster environment (SynfinityCluster or PRIMECLUSTER) is displayed.

    [For the storage management server]

    # /opt/FJSVswstf/bin/stgenvdisp
  Server type            : Management server
  Cluster system         : SynfinityCluster or PRIMECLUSTER
  Node type              : Primary
  Node name              : nodemgr
  Service name           : manager_service
  Mount point            : /acmmgrdisk
  IP by cluster setup    : 10.10.10.10
  Manager IP address     : 10.10.10.10
  Repository user        : acm
  DB file                : /dev/sfdsk/Service1Cls1/dsk/Service1Vol2
  RDB dictionary         : /dev/sfdsk/Service1Cls1/rdsk/Service1Vol3
  RDB log file           : /dev/sfdsk/Service1Cls1/rdsk/Service1Vol4
  Database space         : /dev/sfdsk/Service1Cls1/rdsk/Service1Vol5
  IP address for GUI     : 10.10.10.10
  Communication          : 11000
  Remote access          : 9851
  Exclusive control      : 9852
  Authentication feature : 4660
  Repository             : 2004
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
#

    [For the storage server]

    # /opt/FJSVswstf/bin/stgenvdisp
  Server type            : Server
  Cluster system         : SynfinityCluster or PRIMECLUSTER
  Node type              : Primary
  Node name              : nodeagt1
  Service name           : agent_service1
  Mount point            : /acmagt1disk
  Manager IP address     : 10.10.10.10
  Communication          : 11000
-------------------------------------------------------------------------
  Server type            : Server
  Cluster system         : SynfinityCluster or PRIMECLUSTER
  Node type              : Secondary
  Node name              : nodeagt2
  Service name           : agent_service2
  Mount point            : /acmagt2disk
  Manager IP address     : 10.10.10.10
  Communication          : 12000
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
#

    Information on all transactions in a cluster environment (VERITAS Cluster Server) is displayed.

    [For the storage management server]

    # /opt/FJSVswstf/bin/stgenvdisp
  Server type            : Management server
  Cluster system         : VERITAS Cluster Server
  Node type              : Primary
  Node name              : nodemgr
  Service name           : manager_service
  Mount point            : /acmmgrdisk
  IP by cluster setup    : 10.10.10.10
  Manager IP address     : 10.10.10.10
  Repository user        : acm
  DB file                : /dev/dsk/c2t0d0s4
  RDB dictionary         : /dev/rdsk/c2t0d0s5
  RDB log file           : /dev/rdsk/c2t0d0s6
  Database space         : /dev/rdsk/c2t0d0s7
  IP address for GUI     : 10.10.10.10
  Communication          : 11000
  Remote access          : 9851
  Exclusive control      : 9852
  Authentication feature : 4660
  Repository             : 2004
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
#

    [For the storage server]

    # /opt/FJSVswstf/bin/stgenvdisp
  Server type            : Server
  Cluster system         : VERITAS Cluster Server
  Node type              : Primary
  Node name              : nodeagt1
  Service name           : agent_service1
  Mount point            : /acmagt1disk
  Manager IP address     : 10.10.10.10
  Communication          : 11000
-------------------------------------------------------------------------
  Server type            : Server
  Cluster system         : VERITAS Cluster Server
  Node type              : Secondary
  Node name              : nodeagt2
  Service name           : agent_service2
  Mount point            : /acmagt2disk
  Manager IP address     : 10.10.10.10
  Communication          : 12000
-------------------------------------------------------------------------
  Server type            : Server
  Node name              : Local-Service
  Manager IP address     : 10.10.10.10
  Communication          : 1226
#

    The contents of displayed information are described below.

    Title

    Description

    Server type

    The server type is displayed as follows:
    Management server: Storage management server or storage management server transaction
    Server: Storage server of storage server transaction

    Cluster system

    The type of cluster system is displayed as follows:
    SynfinityCluster or PRIMECLUSTER: SynfinityCluster or PRIMECLUSTER
    VERITAS Cluster Server: VERITAS Cluster Server
    SynfinityCluster: SynfinityCluster
    PRIMECLUSTER: PRIMECLUSTER
    MC/ServiceGuard: MC/ServiceGuard
    MSCS: MSCS

    HACMP: High Availability Cluster Multi-Processing

    Node type

    The node type is displayed as follows:
    Primary: Primary node
    Secondary: Secondary node

    Node name

    The logical node name is displayed.
    Local-Service indicates a local transaction.

    Service name

    The transaction name is displayed.

    Cluster name

    The cluster name is displayed.

    Mount point

    The mount point for AdvancedCopy Manager shared data is displayed.

    Disk resource

    The name of the shared disk resource used for AdvancedCopy Manager shared data is displayed.

    Drive

    The drive letter used for AdvancedCopy Manager shared data is displayed.

    Volume group

    The volume group name is displayed.

    Network name

    The name of the network for AdvancedCopy Manager is displayed.

    External connection

    The external connection network name is displayed.

    Subnet mask

    The subnet mask is displayed.

    IP address resource

    IP address resource information is displayed.

    IP by cluster setup

    The logical IP address specified in the cluster setting command is displayed.
    However, note that the displayed IP is not the active logical IP address if the IP address of either the storage management server transaction or storage server transaction is changed during operation.

    Manager IP address

    The IP address of the storage management server is displayed.
    However, if no server is added, then "????" is displayed.

    Repository user

    The name of the user accessing the repository is displayed.

    DB log file

    [Windows Edition only]
    The name of the DB log file storage destination folder is displayed.

    DB dictionary file

    [Windows Edition only]
    The name of the DB dictionary file storage destination folder is displayed.

    Repository database

    [Windows Edition only]
    The name of the repository DB storage destination folder is displayed.

    DB file

    [Solaris Edition]
    The name of the DB file system device or directory is displayed.

    [Linux Edition]
    The DB file directory name is displayed.

    RDB dictionary

    [Solaris Edition]
    The RDB dictionary raw device name is displayed.

    [Linux Edition]
    The RDB dictionary directory name is displayed.

    RDB log file

    [Solaris Edition]
    The name of the RDB log file raw device or directory is displayed.

    [Linux OE Edition]
    The RDB log file directory name is displayed.

    Database space

    [Solaris Edition]
    The name of the raw device containing the repository data storage DB is displayed.

    [Linux Edition]
    The name of the directory containing the repository data storage DB is displayed.

    Database size

    [Windows Edition and Linux Edition only]
    The database size is displayed.

    IP address for GUI

    The GUI connection IP address is displayed.

    Communication

    The communication service/daemon port number (service name in the services file: stgxfws) is displayed.
    In a cluster environment, the transaction communication service/daemon port number (service name in the services file: stgxfws_logical-node-name) is displayed.

    Remote access

    The remote access service/daemon port number (service name in the services file: rmiswstf) is displayed.

    Exclusive control

    The exclusive control service/daemon port number (service name in the services file: semswstf) is displayed.

    Authentication feature

    The authentication feature service/daemon port number (service name in the services file: smaclmgr) is displayed.

    Repository

    The repository service/daemon port number (service name in the services file: rdaswstf) is displayed.

10.2.13 Management information package backup server registration/deletion command (stgmgrinfoset)

The command registers the management information package backup execution server (the server on which the management information package backup command is executed).

The command deletes the management information package backup execution server.

The command displays information about the management information package backup execution server.

  1. Specification method

    program-directory\bin\stgmgrinfoset [-del | -d directory-name -c storage-management-server-encoding]

  2. Description of options

    Option

    Description

    None

    Displays information about the management information package backup execution server.

    -del

    Deletes the management information package backup execution server.

    -d

    Specify the full path to the directory where the backup data is to be stored.

    Only alphanumeric characters and underscores can be used in the directory name.

    -c

    Specify the encoding designated when the storage management server was installed. Specify either of the following:

    ASCII : ASCII

  3. End status

    =0: Normal end

    >0: Abnormal end

  4. Execution example

    Register the management information package backup execution server (the path to the directory where backup data is to be stored is D:\stgbkupdata, and the encoding used on the storage management server is ASCII):

    # /opt/FJSVswstf/bin/stgmgrinfoset -d /stgbkupdata -c ASCII
swstf3000 The server which performs package backup of the management information on AdvancedCopy Manager was registered.
#

    Delete the management information package backup execution server:

    # /opt/FJSVswstf/bin/stgmgrinfoset -del
swstf3001 The server which performs package backup of the management information on AdvancedCopy Manager was deleted. delete a directory. Directory=/stgbkupdata
#

    Display information about the management information package backup execution server:

    # /opt/FJSVswstf/bin/stgmgrinfoset
Directory    : /stgbkupdata
Manager code : ASCII
#

The following notes apply to this command:

10.2.14 Management information package backup command (stgmgrinfobkup)

This command makes backups of the management information stored on the storage servers and storage management server.

  1. Specification method

    program-directory\bin\stgmgrinfobkup [-n server-name] [-t backup-type]

  2. Description of options

    Option

    Description

    -n

    Makes backups of the management information stored on the specified server.

    If this option is not specified, the management information on all storage servers (including the storage management server) is backed up.

    -t

    Specifies the types of data that is to be backed up. Specify one of the values listed below. Do not specify more than one value in the -t option:

    DBData : Database

    RegiData : Registry

    MgrInfoData : Policy file for management information package backup

    AuthData : Authentication management list

    BkupData : Backup management

    ReplData : Replication management

    TapeData : Tape backup management backup

    If this option is not specified, backups are made as defined in the policy file.

    For details on the policy file, refer to the section "Preliminaries" in this manual.

  3. End status

    =0: Normal end

    >0: Abnormal end

  4. Execution example

    Make backups of the management information on all the storage servers as defined in the policy file:

    # /opt/FJSVswstf/bin/stgmgrinfobkup
swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01
swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01
swstf3014 Backup of management information is started. Start time=04/07/02 11:02:00, Server name=acm02
swstf3020 Backup of management information was ended normally. End time=04/07/02 11:05:00, Server name=acm02
swstf3021 The normal end of the backup of management information was carried out by all servers.
#

    Make backups of the management information on storage server acm01 as defined in the policy file:

    # /opt/FJSVswstf/bin/stgmgrinfobkup -n acm01
swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01
swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01
swstf3021 The normal end of the backup of management information was carried out by all servers.
#

    Makes backups of the registries on all of the storage servers.

    # /opt/FJSVswstf/bin/stgmgrinfobkup -t RegiData
swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01
swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01
swstf3014 Backup of management information is started. Start time=04/07/02 11:02:00, Server name=acm02
swstf3020 Backup of management information was ended normally. End time=04/07/02 11:05:00, Server name=acm02
swstf3021 The normal end of the backup of management information was carried out by all servers.
#

    Make a backup of backup management located on storage server acm01:

    # /opt/FJSVswstf/bin/stgmgrinfobkup -n acm01 -t BkupData
swstf3014 Backup of management information is started. Start time=04/07/02 11:00:00, Server name=acm01
swstf3020 Backup of management information was ended normally. End time=04/07/02 11:02:00, Server name=acm01
swstf3021 The normal end of the backup of management information was carried out by all servers.
#

The following notes apply to this command:

10.2.15 Management information package backup status display command (stgmgrinfodisp)

This command displays the status of execution of the management information package backup command.

  1. Specification method

    program-directory\bin\stgmgrinfodisp [-n server-name]

  2. Description of options

    Option

    Description

    -n

    Specifies the name of the server where the backup status is to be output.

    If this option is not specified, the status of backups on the storage server for which the management information package backup command was executed is displayed.

  3. End status

    =0: Normal end

    >0: Abnormal end

  4. Output information

    The types of information listed below are output. If no backups are made when the management information package backup command is executed or if the management information package backup command ends in error, no data is output.

    Item

    Description

    Server

    Server name

    RegiData

    Date and time at which the management information package backup command created a backup of a registry (date and time that the management information package backup command was executed)

    yy/mm/dd hh:mm:ss

    DBData

    Date and time at which the management information package backup command created a backup of the database (date and time that the management information package backup command was executed)

    yy/mm/dd hh:mm:ss

    AuthData

    Date and time at which the management information package backup command created a backup of the authentication management list (date and time that the management information package backup command was executed)

    yy/mm/dd hh:mm:ss

    BkupData

    Date and time at which the management information package backup command created a backup of the backup management (date and time that the management information package backup command was executed)

    yy/mm/dd hh:mm:ss

    ReplData

    Date and time at which the management information package backup command created a backup of replication management (date and time that the management information package backup command was executed)

    yy/mm/dd hh:mm:ss

    MgrInfoData

    Date and time at which the management information package backup command created a backup of the policy file for management information package backup (date and time that the management information package backup command was executed)

    yy/mm/dd hh:mm:ss

    TapeData

    Date when a backup of tape backup management was made by package backup using the management information command (with package backup of the management information command executed)

    yy/mm/dd hh:mm:ss

  5. Execution example

    Output information about all storage servers:

    # /opt/FJSVswstf/bin/stgmgrinfodisp
Server:         acm01
   DBData:      04/08/02 16:11:26
   AuthData:    04/08/02 16:32:00
   RegiData:    04/08/01 09:00:00
   ReplData:    04/08/02 16:32:22
Server:         acm02
   RegiData:    04/08/01 09:00:00
   BkupData:    04/08/03 16:00:00 
Server:         tape
   RegiData:    05/08/01 09:00:00
   TapeData:    05/08/03 16:00:00
#

    Output information about storage server acm01:

    # /opt/FJSVswstf/bin/stgmgrinfodisp -n acm01
Server:         acm01
   DBData:      04/08/02 16:11:26
   AuthData:    04/08/02 16:32:00
   RegiData:    04/08/01 09:00:00
   ReplData:    04/08/02 16:32:22
#

The following notes apply to this command:

10.2.16 SDX object management unit setting command(stgxfwcmsetsdx)

The unit of operation of the SDX object treated with AdvancedCopy Manager (Refer to the "Units of SDX object operations") is set. Moreover, the unit of operation of a present SDX object is displayed.

  1. Specification method

    # /opt/FJSVswstf/bin/stgxfwcmsetsdx [-slice | -volume ]

  2. Description of options

    Option

    Description

    none

    The unit of present of the SDX object management is displayed.

    -slice

    The unit of management of the SDX object treated with AdvancedCopy Manager is set to the unit of the slice.

    -volume

    The unit of management of each logical volume of the SDX object treated with AdvancedCopy Manager is set.

  3. End status

    =0: Normal end

    >0: Abnormal end

  4. Execution example

    The unit of present of the SDX object management in non-cluster environment is

    displayed.

    # /opt/FJSVswstf/bin/stgxfwcmsetsdx
    Volume (SWSTGNODE=null)

    The display form is 'Unit of management (SWSTGNODE = setting value).'

    Unit of management - Slice in case of each slice. Volume in case of each logical volume.

    The set value when set value-environment variable SWSTGNODE is set. Null when environment

    variable SWSTGNODE is not set.

    The unit of the SDX object of the Storage management server service (The logical node name: aserv) is set to the unit of the slice.

    # SWSTGNODE=aserv; export SWSTGNODE
# /opt/FJSVswstf/bin/stgxfwcmsetsdx -slice
stgxfwcmsetsdx completed (SWSTGNODE=aserv)

The following lists notes on this command.

10.3 Replication Management Command 

This chapter describes operations using Replication Management Commands. It is necessary to execute the command of Replication management by the root user.

Only a root user can execute all the commands of replication management. When command execution is carried out by other users, a message " swsrp0601 This Command cannot be run. This is because the user is not a root user." is outputted and then, an error end.

Operating environment for command execution

The table below lists the requirements for the operating environment in which to execute the respective commands.

Command

Operating environment of AdvancedCopy Manager

swsrpcancel

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is in EC operation, the daemons and services of the copy destination storage server must be operating (except when the -m option or -t option is specified).
For inter-server replication in EC equivalency status, the associated server must be operating (except when the -m option is specified).

swsrpchsync

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swsrpdelvol

To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
For inter-server replication, the daemons and services of the storage server in communication must be operating (except when the -d option is specified).

swsrprecbuffstat

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swsrprecbuffset

To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating

swsrpmake

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows and is engaged in intra-server replication and EC operation, the daemons and services of the storage server must be operating.
For inter-server replication, the daemons and services of the storage server in communication must be operating (except when the -m option or -t option is specified).

swsrprecoverres

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
To specify the -r option, the daemons and services of the storage management server must be operating.

swsrprevsync

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swsrpsetvol

To execute this command on a storage server, the daemons and services of the storage management server must be operating.
To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
For inter-server replication, the daemons and services of the storage server in communication must be operating.

swsrpstartsync

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.
When the storage server runs on Windows, the daemons and services of the storage server must be operating.
For inter-server replication, the associated server must be operating (except a case where the -m option is specified).

swsrpstat

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

swsrpvolinfo

To execute this command on a storage management server with the -h option specified, the daemons and services of the storage management server and target storage server must be operating.

In cluster operation

In cluster operation, execute a command by taking the following steps:

  1. If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. For bsh, specify the environment variable as follows:

    # SWSTGNODE=logical-node-name<Enter>
# export SWSTGNODE

  2. Execute the command.

    The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.

    Command

    Environment variable

    Command execution node

    Remarks

    swsrpsetvol

    Required

    Transaction operation node

    swsrpvolinfo

    Required

    Transaction operation node

    swsrpdelvol

    Required

    Transaction operation node

    swsrprecbuffstat

    Required

    Transaction operation node

    swsrprecbuffset

    Required

    Transaction operation node

    swsrpstartsync

    Required

    Transaction operation node

    swsrpmake

    Required

    Transaction operation node

    swsrpstat

    Required

    Transaction operation node

    swsrpcancel

    Required

    Transaction operation node

    swsrpchsync

    Required

    Transaction operation node

    swsrprevsync

    Required

    Transaction operation node

    swsrprecoverres

    Required

    Transaction operation node

10.3.1 Environment definition commands 

This chapter describes environment definition commands for replication management. To define a replication management environment, use the following commands:

Function

Command name

Description

Replication volume information setting command

swsrpsetvol

Sets the information about a replication volume.

Replication volume information display command

swsrpvolinfo

Displays the information about a replication volume.

Replication volume information deletion command

swsrpdelvol

Deletes replication volume information that has been set.

REC transfer buffer information display command

swsrprecbuffstat

Displays information for the REC transfer buffer.

REC transfer buffer settings change command

swsrprecbuffset

Changes the settings for the REC transfer buffer.

10.3.1.1 Replication volume information setting command (swsrpsetvol)

This command sets the replication source and replication destination volumes that will be used in a replication operation. Execute this command to declare that the replication operation will performed using the specified replication volumes.

  1. Specification method

    [To be executed on a storage server]

    For replication on a server

    /opt/FJSVswsrp/bin/swsrpsetvol [-n] [-u] [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name

    For replication between servers

    /opt/FJSVswsrp/bin/swsrpsetvol [-n] [-u] -o (ORG|REP|BOTH) [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name

    [To be executed on a storage management server]

    For replication on a server

    /opt/FJSVswsrp/bin/swsrpsetvol -h Server-Name [-n] [-u] [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name

    For replication between servers

    /opt/FJSVswsrp/bin/swsrpsetvol -h Server-Name [-n] [-u] -o (ORG|REP|BOTH) [-Xgroup Group-Name] Original-Volume-Name Replica-Volume-Name

  2. Description of options

    Option

    Description

    -h

    Specifies the name of a storage server subject to the replication operation. This option is valid only on a storage management server.

    If this option is omitted, the storage server on which the command is entered will be the target to the processing.

    -u

    Specifies the direction of copying.

    If this option is specified, copying from a replication source volume to a replication destination volume is performed only in this direction. Copying from a replication destination volume to a replication source volume is prohibited.

    If this option is omitted, copying between the replication source and replication destination volumes interactively is bidirectional.

    -o

    Specifies the operation server.

    Specify one of the following for this operand:

    ORG: Sets the replication source server as the operation server.

    REP: Sets the replication destination server as the operation server.

    BOTH: Sets both the copy-source server and copy-destination server as operation servers.

    On the server that is not specified as the operation server, only the following commands can be executed for a replication volume:

    • Replication volume information display command

    • Operation status display command

    • Replication cancellation command (The forcible stop option is required.)

    Specifying BOTH in the operand enables the execution of all commands on both the copy-source server and copy-destination server. Note that the BOTH option is usable when the versions of both servers are 11.0/V11.0L10 or later.

    This option is valid only for replication between servers.

    -n

    If this option is omitted, replication volume information cannot be set when the sizes of the replication source volume and replication destination volume are different.

    When this option is specified, the sizes of the replication source volume and replication destination volume are not checked. Use this option when volume sizes are different (for example, for replication between different OSs).

    When the volume sizes of the replication source volume and replication destination volume are different, copying is performed as follows:

    The address at which copying starts is the first sector of the replication destination volume.

    The copy data size is the size of the smaller volume.

    -Xgroup

    Specifies that the copy source and copy destination volumes be registered in a group.

    If the specified group does not exist, a new group is created. Otherwise, the specified copy source and copy destination volumes are added to an existing group.

    The characters that can be used for the group name are single-byte alphanumeric characters, the minus sign (-), underscore (_), number sign (#) and period (.). The first character must be a single-byte alphanumeric character. Up to 64 characters can be used.

  3. Description of operands

    Operand

    Description

    Original-Volume-Name

    Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name."

    Replica-Volume-Name

    Specifies a replication destination volume name. For the volume names of other servers, use the format "volume-name@storage-server-name."

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Set replication volume information by specifying volume/dev/dsk/c1t2d0s3 of storage server SRC-SV as the replication source volume and volume /dev/dsk/c1t2d0s3 of storage server TARG-SV as the replication destination volume. In addition, specify one-way copying for the copy direction and specify the replication source server (SRC-SV) as the operation server. The example below shows the command executed on SRC-SV.

    # /opt/FJSVswsrp/bin/swsrpsetvol -u -o ORG /dev/dsk/c1t2d0s3 /dev/dsk/c1t2d0s3@TARG-SV
    swsrpsetvol completed
    #

    When the same settings are made from TARG-SV, the example is as follows (be careful with the volume name):

    # /opt/FJSVswsrp/bin/swsrpsetvol -u -o ORG /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d0s3
    swsrpsetvol completed
    #

Replication volume information cannot be set if:

Note the following points about creating copy source volumes and copy destination volumes:

When you change physical information on volumes (partition size, drive letter, and cabinet information on a disk array device) using such functions as an OS management tool (for example, Disk Administrator) or GRmgr provided by the disk array device, you need to reset the registered replication volume information associated with the changed volumes, according to the following procedures:

  1. Delete the replication volume information by the replication volume information deletion command (swsrpdelvol).

  2. In an initial screen, "information acquisition / reflection" of all devices are performed. Or device information acquisition / reflection command (stgxfwcmsetdev) is executed in a Storage management server.

  3. Reset the replication volume information by the replication volume informatin setting command (swsrpsetvol).

When you use a replication destination volume by mounting or by allocating a drive letter after creating a replication, the size of the replication destination volume must exactly match the size of the replication destination volume to the byte. If you do not use a replication destination volume (for example, when you need copy data, you restore it to the replication source volume and then use it), the size of the replication destination volume can be larger than the size of the replication source volume.

Group settings cannot be made in the following cases:

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (replication management)".

This command cannot be executed while any of the following commands is running:

10.3.1.2 Replication volume information display command (swsrpvolinfo)

This command displays the replication volume information registered by the replication volume setting command.

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrpvolinfo [-L] [Original-Volumue-Name]

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrpvolinfo -h Server-Name [-L] [Original-Volume-Name]

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option is valid only on a storage management server.

    -L

    Specifies that information be displayed using the extended format.

    Refer to the table in the execution example for information about the items that are displayed when this option is specified.

    The items that are displayed when this option is specified may be expanded to support new functions provided by future versions.

  3. Description of operands

    Operand

    Description

    Original-Volume-Name

    Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name."

    Displays all the replication volume information for the specified replication source volume. If this operand is omitted, all the replication volume information existing on the storage server on which this command is executed is displayed.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Direct that all the replication volume information on a storage management server be displayed on storage server SRC-SV.

    # /opt/FJSVswsrp/bin/swsrpvolinfo -h SRC-SV
Server Original-Volume           Size        Replica-Volume            Size        Copy          Op-Server
SRC-SV /dev/dsk/c1t2d0s3@SRC-SV     4.0Gbyte /dev/dsk/c1t2d0s3@TARG-SV    4.0Gbyte uni-direction original
SRC-SV /dev/dsk/c1t2d1s3@SRC-SV     4.0Gbyte /dev/dsk/c1t2d1s3@TARG-SV    5.0Gbyte bi-direction  original
SRC-SV /dev/dsk/c1t2d2s3@SRC-SV     9.1Gbyte /dev/dsk/c1t2d2s3@TARG-SV    9.1Gbyte bi-direction  replica
SRC-SV /dev/dsk/c1t2d2s4@SRC-SV     7.5Gbyte /dev/dsk/c1t2d2s4@TARG-SV    7.5Gbyte bi-direction  both
#

    The following information will be displayed.

    Title

    Description

    Server

    Displays a storage server name.

    Original-Volume

    Displays a replication source volume name.

    Size

    Displays the volume size.

    For a logical volume of VxVM, the size of the public area (slice) that makes up the volume is displayed instead of the volume size.

    Replica-Volume

    Displays a replication destination volume name.

    Copy

    Displays the copying direction.

    uni-direction: One-way copying from a replication source volume to a replication destination volume is allowed.

    bi-direction: Bidirectional copying is allowed.

    Op-Server

    Displays the operation server of a pair of replication volumes.

    original: The replication source server is the operation server.

    replica: The replication destination server is the operation server.

    both: Sets both the copy-source server and copy-destination server as operation servers.

    Group

    [only if the -L option has been specified]

    Displays the group name.

    "----"is displayed if the copy source and destination volumes are not registered in a group.

Replication volume information cannot be displayed if:

This command cannot be executed while the following command is running:

10.3.1.3 Replication volume information deletion command (swsrpdelvol)

Delete the replication volume information that has been set.

If copy processing is being performed on a replication volume that is to be deleted, execute the command after the copy processing has stopped.

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrpdelvol [-e] [-d] Original-Volume-Name Replica-Volume-Name

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrpdelvol -h Server-Name [-e] [-d] Original-Volume-Name Replica-Volume-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option is valid only on a storage management server.

    -e

    Emergency operation mode is available for operations.

    Specifies deleting replica volume information, without checking the execution state of an advanced copy. Use this option, only when it is clear that the advanced copy is not executed.

    Deletes replication volume information without confirming the release of the master-proxy relationship of an SDX object when the function in linkage with GDS Snapshot is used.

    -d

    Specifies that no communication take place between the linked servers in replication between servers. When this option is specified, replication volume information is deleted without communication taking place between the linked servers.

    Use the option only when recovery of one of the linked servers cannot be expected.
    The option is valid only for replication between servers.
    The option can be used on the server not specified as the operation server.

  3. Description of Operand

    Operand

    Description

    Original-Volume-Name

    Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name."

    Replica-Volume-Name

    Specifies a replication destination volume name. For the volume names of other servers, use the format "volume-name@storage-server-name."

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Delete replication volume information on storage server SRC-SV.

    # /opt/FJSVswsrp/bin/swsrpdelvol /dev/dsk/c1t2d0s3 /dev/dsk/c1t2d0s3@TARG-SV
swsrpdelvol completed
#

Replication volume information cannot be deleted if:

If a logical volume of VxVM is deleted or its structure is changed to a structure not supported by AdvancedCopy Manager, replication volume information cannot be deleted. In such cases, take action according to either item a) or b).

  1. Make sure that advanced copy is not in progress for the replication volume to be deleted, and execute this command with the -emergency option specified. (If advanced copy is in progress, stop advanced copy processing by using the disk array unit or take action according to item b).)

  2. Re-create the logical volume or return the logical volume structure to its original state, and then execute this command.

For details on how to use SDX objects of GDS, refer to Section 4.8.2, "Configuration and conditions of unsupported SDX objects", and Section 11.1.6, "Notes on SDX object operations (replication management)."

This command cannot be executed while any of the following commands is running:

10.3.1.4 REC transfer buffer information display command(swsrprecbuffstat)

Displays information for the transfer buffer used by ETERNUS when REC is performed in Consistency mode.

  1. Specification method

    [To be executed on a storage server]

    swsrprecbuffstat [-Xaltpath] Volume-Name

    [To be executed on a storage management server]

    swsrprecbuffstat -h Server [-Xaltpath] Volume-Name

  2. Description of options

    Option

    Description

    -h

    Specifies the name of a storage server.
    You can use this option only for a storage management server.

    -Xaltpath

    When replication volume is applying per logic volume by the SDX object, an
    alternative path is specified as an operand in the form of the following.

    /dev/sfdsk/(class name)/dsk/(volume name):( DEVNAM value for sdxinfo)

  3. Description of operands

    Operand

    Description

    Volume-Name

    Specifies the name of a volume that has been registered as a replication volume.

    You can only specify volumes that are connected to the Storage server where the command is executed.

    Specify the AdvancedCopy Manager device name as the volume name.

  4. End status

    =0:Normal end
    >0:Abnormal end

  5. Execution example

    Display information for the transfer buffer used by the REC, where the copy source volume is /dev/FJSVmplb/dsk/mplb2048s3@Server1 and the copy destination volume is /dev/FJSVmplb/dsk/mplb3048s3@Server1, and replication is performed within the storage server "Server1": 

    # /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb2048s3@Server1
    BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 12%  BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb3048s3@Server1
    BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ID Use  Rate RemoteBoxID
1  RECV 0%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
#

    Display information for the transfer buffer used by the REC in an environment where replication is being performed between storage server "Server1" and storage server "Server2". Additionally, the copy source volume is /dev/FJSVmplb/dsk/mplb2048s3@Server1 and the copy destination volume is /dev/FJSVmplb/dsk/mplb2148s3@Server2: 

    [Command executed on storage server "Server1"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb2048s3@Server1
 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 12%  BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
2  RECV 0%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
#
[Command executed on storage server "Server2"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb2148s3@Server2
BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ID Use  Rate RemoteBoxID
1  RECV 0%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
2  SEND 5%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
#

    Display information for the transfer buffer used by the REC if a cabinet where the copy source volume /dev/FJSVmplb/dsk/mplb2048s3@Server1 resides has been set up to make remote copies to multiple cabinets, and replication is being performed between storage server "Server1" and storage server "Server2": 

    [Command executed on storage server "Server1"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb2048s3@Server1
 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 12%  BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
2  RECV 0%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
3  SEND 4%   CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
4  RECV 0%   CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
5  SEND 10%  DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
6  RECV 0%   EEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEEE
7  SEND 3%   FFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF
8  SEND 5%   GGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGGG
#

    Display information for the transfer buffer used by the REC, where the copy source volume is /dev/sfdsk/class1/dsk/volume1@Server1 and the copy destination volume is /dev/sfdsk/class2/dsk/volume1@Server2, and replication is being performed between storage server "Server1" and storage server "Server2":
    (The SDX object is in a two-cabinet mirror configuration.) 

    [Command executed on storage server "Server1"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb2048
 BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 12%  BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
2  RECV 0%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb3048
BoxID = CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
ID Use  Rate RemoteBoxID
1  SEND 11%  DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
2  RECV 0%   DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
#

[Command executed on storage server "Server2"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb2148
BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ID Use  Rate RemoteBoxID
1  RECV 0%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
2  SEND 4%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb3148
BoxID = DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
ID Use  Rate RemoteBoxID
1  RECV 0%   CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
2  SEND 5%   CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
#

    The following information will be displayed.

    Title

    Description

    BoxID

    The box identifier for the cabinet connected to the server where the command was executed.

    ID

    The ID for the transfer buffer.

    Use

    The attribute (usage) for the transfer buffer.

    SEND : Transfer buffer for sending data

    RECV : Transfer buffer for receiving data

    Rate

    The usage rate of the transfer buffer as a percentage.

    If the usage is SEND: Displays the usage rate of the transfer buffer as a percentage.This will never be 0%, even if REC is not being performed in asynchronous Consistency mode.
    If the usage is RECV : "0%" will always be displayed.

    "----" will be displayed if the transfer buffer cannot be used.

    RemoteBoxID

    The box identifier for the cabinet performing a remote copy.

The device name on a cabinet to display information can be specified as -Xaltpath.

Information is displayed only for cabinets that contain replication volumes for the server where the command was executed.
If intercabinet replication is being performed between servers, then the command must be executed on both servers involved in the replication in order to check information for the transfer buffers in both cabinets.

It will take a short period for changes to REC transfer buffer settings to take effect, during which time the buffer may become unusable (the "Rate" field will be displayed as "----"). In this case, wait about one minute and then execute the command again.

This command cannot be executed while the following command is running:

Resource adjustment command (swsrprecoverres)

10.3.1.5 REC transfer buffer settings change command(swsrprecbuffset)

Changes the settings for the transfer buffer used by ETERNUS when REC is performed in Consistency mode.

Refer to "ETERNUSmgr User's Guide Setup / Maintenance" about the setting method of REC transfer buffer.

  1. Specification method

    [To be executed on a storage server]

    swsrprecbuffset -Xbuffid buffer-id -Xbuffuse {SEND|RECV} [-Xaltpath] Volume-Name

    [To be executed on a storage management server]

    swsrprecbuffset -h Server -Xbuffid buffer-id -Xbuffuse {SEND|RECV} [-Xaltpath] Volume-Name

  2. Description of options

    Option

    Description

    -h

    Specifies the name of a storage server.
    You can use this option only for a storage management server.

    -Xbuffid

    Specifies the ID for the transfer buffer.

    -Xbuffuse

    Specifies the usage for the transfer buffer.

    SEND : Transfer buffer for sending data
    RECV : Transfer buffer for receiving data

    -Xaltpath

    When replication volume is applying per logic volume by the SDX object, an
    alternative path is specified as an operand in the form of the following.

    /dev/sfdsk/(class name)/dsk/(volume name):(DEVNAM value for sdxinfo)

  3. Description of operands

    Operand

    Description

    Volume-Name

    Specifies the name of a volume that has been registered as a replication volume.

    You can only specify volumes that are connected to the Storage server where the command is executed.

    When replication volume is applying per logic volume by the SDX object, it is necessary to use the -Xaltpath option and to specify an alternative path.

  4. End status

    =0:Normal end
    >0:Abnormal end

  5. Execution example

    Change the attributes for the transfer buffer used by the REC where the copy source volume is /dev/FJSVmplb/dsk/mplb2048s3@Server1 and the copy destination volume is /dev/FJSVmplb/dsk/mplb3048s3@Server1, and replication is being performed within the storage server "Server1":

    # /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb2048s3@Server1
BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 12%  BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 1 -Xbuffuse RECV /dev/FJSVmplb/dsk/mplb2048s3@Server1
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb2048s3@Server1
BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  RECV 0%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb3048s3@Server1
BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ID Use  Rate RemoteBoxID
1  RECV 0%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 1 -Xbuffuse SEND /dev/FJSVmplb/dsk/mplb3048s3@Server1
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb3048s3@Server1
BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ID Use  Rate RemoteBoxID
1  SEND 3%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
#

    Change the attribute for the transfer buffer where the copy source volume is /dev/FJSVmplb/dsk/mplb2048s3@Server1, and replication is being performed between storage server "Server1" and storage server "Server2".

    [Command executed on storage server "Server1"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb2048s3@Server1
BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 12%  BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
2  RECV 0%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 1 -Xbuffuse SEND /dev/FJSVmplb/dsk/mplb3048s3@Server1
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 2 -Xbuffuse RECV /dev/FJSVmplb/dsk/mplb3048s3@Server1
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrprecbuffstat /dev/FJSVmplb/dsk/mplb3048s3@Server1
BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 4%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
2  RECV 0%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
#

    Change the attributes for the transfer buffer used by the REC where the copy source volume is /dev/sfdsk/class1/dsk/volume1@Server1 and the copy destination volume is /dev/sfdsk/class2/dsk/volume1@Server2, and replication is being performed between storage server "Server1" and storage server "Server2":

    (The SDX object is in a two-cabinet mirror configuration.)

    [Command executed on storage server "Server1"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb2048
BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  SEND 12%  BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb3048
BoxID = CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
ID Use  Rate RemoteBoxID
1  SEND 11%  DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 1 -Xbuffuse RECV -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb2048
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 1 -Xbuffuse RECV -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb3048
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb2048 /dev/sfdsk/class1/dsk/volume1@Server1
BoxID = AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
ID Use  Rate RemoteBoxID
1  RECV 0%   BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class1/dsk/volume1:mplb3048 /dev/sfdsk/class1/dsk/volume1@Server1
BoxID = CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
ID Use  Rate RemoteBoxID
1  RECV 0%   DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD

    [Command executed on storage server "Server2"]
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb2148 /dev/sfdsk/class2/dsk/volume1@Server2
BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ID Use  Rate RemoteBoxID
1  RECV 0%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb3148 /dev/sfdsk/class2/dsk/volume1@Server2
BoxID = DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
ID Use  Rate RemoteBoxID
1  RECV 0%   CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 1 -Xbuffuse SEND -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb2148 /dev/sfdsk/class2/dsk/volume1@Server2
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrpbuffset -Xbuffid 1 -Xbuffuse SEND -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb3148 /dev/sfdsk/class2/dsk/volume1@Server2
swsrpbuffset completed
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb2148 /dev/sfdsk/class2/dsk/volume1@Server2
BoxID = BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB
ID Use  Rate RemoteBoxID
1  SEND 1%   AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA
# /opt/FJSVswsrp/bin/swsrprecbuffstat -Xaltpath /dev/sfdsk/class2/dsk/volume1:mplb3148 /dev/sfdsk/class2/dsk/volume1@Server2
BoxID = DDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDDD
ID Use  Rate RemoteBoxID
1  SEND 1%   CCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCCC
#

The device name on a cabinet to display information can be specified as -Xaltpath.

Settings for dedicated REC buffers must be made in advance.
Change settings while there are no asynchronous Consistency mode sessions in either the ACTIVE or ERROR SUSPEND state.
It will take a short period for changes to buffer settings to take effect, during which time the transfer buffer will become unusable. Do not perform REC operations during this time.

This command cannot be executed while any of the following commands are running:

10.3.2 Operation commands 

This chapter describes operation commands for replication management.

To operate replication management, use the following commands:

Function

Command name

Description

Synchronous processing start command

swsrpstartsync

Starts replication while the synchronous type replication function is performed.

Replication creation command

swsrpmake

Creates replication while the snapshot type and the synchronous type replication functions are performed.

Operation status display command

swsrpstat

Displays the status of replication operation

Replication cancellation command

swsrpcancel

Cancels the replication processing while the snapshot type and the synchronous type replication functions are performed.

10.3.2.1 Synchronous processing start command (swsrpstartsync)

Start the synchronous type replication processing (copying between disks by EC and REC).

Copy all the specified replication destination and replication source volumes (start of the synchronization processing), or copy (restart of the synchronization processing) updated data (difference). Use this command at the start of operation or when you want to reflect updated data (difference) from the equivalency holding state.

For a GDS transaction volume, synchronous processing by software-copy is also possible.

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrpstartsync [ [ -y [ -a | -v ] | -k | -i ] [-g] [-m] [ -Xskip | -Xremain ] [-Xgds-slice-skipchk] | -Xgds-softcopy | -Xgds-selectcopy ] [-t] From-Volume-Name To-Volume-Name

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrpstartsync -h Server-Name [ [ -y [ -a | -v ] | -k | -i ] [-g] [-m] [ -Xskip | -Xremain ] [-Xgds-slice-skipchk] | -Xgds-softcopy | -Xgds-selectcopy ] [-t] From-Volume-Name To-Volume-Name

    [if executed on a storage server: group specification]

    /opt/FJSVswsrp/bin/swsrpstartsync [[-y [-a | -v]]| [-k] | [-i]] [-g]|-Xgds-softcopy | -Xgds-selectcopy] [-t][-m] [-Xskip | -Xremain] [-Xreverse] -Xgroup Group-Name

    [if executed on a storage management server: group specification]

    /opt/FJSVswsrp/bin/swsrpstartsync -h Server-Name [[-y [-a | -v]]| [-k] | [-i]] [-g]|-Xgds-softcopy | -Xgds-selectcopy] [-t][-m] [-Xskip | -Xremain] [-Xreverse] -Xgroup Group-Name

  2. Description of options

    Option

    Description

    -h

    This option is valid only on a storage management server.

    This option can be specified only on a storage management server.

    -y

    Specifies synchronization in synchronous write mode. This option is valid only when total copy is started for inter-box replication.

    Not specifying the -y, -k, and -i option sets asynchronous write mode.

    Synchronization in intra-box replication is always handled in synchronous write mode.

    -a

    Specifies the start of split mode for inter-box synchronization in Automatic Split mode. This option is valid only when total copy is started for inter-box replication.

    Specify this option together with the -y option. Specifying the -y option without the -a option or -v option sets Automatic Split mode.

    -v

    Specifies the start of split mode for inter-box synchronization in Manual Split mode. This option is valid only when total copy is started for inter-box replication.

    Specify this option together with the -y option. Specifying the -y option without the -a option or -v option sets Automatic Split mode.

    You must specify this option when specifying synchronization mode (-y option) on a box that does not support Automatic Split mode.

    -k

    Specifies the setting of transfer mode for inter-box synchronization in Stack mode. This option is valid only when total copy is started for inter-box replication.

    Not specifying the -y, -k, or -i option sets asynchronous write mode.

    You cannot use this option when operating SDX objects in units of logical volumes.

    -i

    Specifies the setting of transfer mode for inter-box synchronization in Consistency mode. This option is valid only when total copy is started for inter-box replication.

    Not specifying the -y, -k, or -i option sets asynchronous write mode.

    -g

    Specifies the setting of recovery mode for inter-box synchronization in Manual Recovery mode. This option is valid only when total copy is started for inter-box replication.

    Not specifying this option sets Automatic Recovery mode.

    -m

    For server-to-server replication, specifies that communication processing with non-operation servers is not performed. When this option is specified, volume status check processing and the preprocessing for the replication destination volume of a non-operation server are not performed.

    This option is valid only during server-to-server replication.

    -t

    Specifies that preprocessing for the replication destination volume is not performed.

    Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy destination volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device).

    -Xgds-softcopy

    Specifies the start of synchronous processing of an SDX object and use of the software-copy function instead of the advanced copy function.

    If you specify this option to start differential copying when the advanced copy function is being used, the advanced copy processing stops and software-copy processing starts.

    You can specify the option when the function in linkage with GDS Snapshot is being used.

    The option is applicable only to SDX objects.

    The option cannot be specified together with -y or -Xgds-selectcopy.

    -Xgds-selectcopy

    Specifies the start of synchronous processing without a specified copy type, such as copying with the disk array unit (OPC/EC) or software-copy. GDS selects the type of copying to be started.

    You can specify the option when the function in linkage with GDS Snapshot is being used.

    The option is applicable only to SDX objects.

    The option cannot be specified together with -Xgds-softcopy.

    -Xgroup

    Specifies that synchronous processing be started for each group.

    -Xreverse

    Specifies that synchronous processing be started for each group in the reverse direction (from replica volumes to original volumes).

    -Xskip

    Specifies that synchronous processing be suspended using the initial copy skip function. This option is valid only when total copy is started for inter-box replication.

    This option is not supported when GDS Snapshot linkage is being used.

    -Xremain

    Enables data that has been updated to the copy destination during replication established status when synchronous processing is restarted.

    This option is valid only when inter-box replication is restarted.

    This option is used to reflect to the copy destination volume only those parts of the copy source volume that have been updated, after synchronous processing has been started by specifying the -Xskip option and backup data has been copied from the tape medium to the copy destination volume.

    This option is not supported when GDS Snapshot linkage is being used.

    -Xgds-slice-skipchk

    Skips the SDX object status check processing that is usually performed as part of the copy destination preprocessing if SDX objects are operated in slice units.

    If this option is specified for a stopped volume, the -t option must also be specified.

  3. Description of operands

    Operand

    Description

    From-Volume-Name

    Specifies a replication source volume name. Specifies the replication source volume or the replication destination volume set with the replication volume information setting command.

    To-Volume-Name

    Specifies a replication destination volume name. Specifies the replication source volume or the replication destination volume set with the copy volume information setting command.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Start replication from /dev/dsk/c1t2d0s3 of a storage management server to /dev/dsk/c1t2d0s3@TARG-SV of storage server SRC-SV.

    # /opt/FJSVswsrp/bin/swsrpstartsync -h SRC-SV /dev/dsk/c1t2d0s3 /dev/dsk/c1t2d0s3@TARG-SV
    FROM=/dev/dsk/c1t2d0s3@SRC-SV,TO=/dev/dsk/c1t2d0s3@TARG-SV swsrpstartsync completed
    #

    Start replication for group "GRP1".

    # swsrpstartsync -Xgroup GRP1
    GROUP=GRP1 swsrpstartsync completed
    #

Replication cannot be started if:

If the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.

When the replication to perform corresponds to either of the following conditions, please perform drive character release or unmount of copy place volume before executing a command.
When performing neither drive character release nor unmount in the above-mentioned case, post-processing of the copy place volume at the time of duplicate creation serves as an error.

You cannot change synchronization mode when synchronization is resumed.
When synchronization is resumed, you must specify the -y, -a, -v, -k, -i, and -g options as follows:

The processing of this command varies according to the status of the synchronization processing of the specified replication source and replication destination volumes.

Status of synchronization processing

Processing

Unmount status

Start of total copy

Total or incremental copy status

Informational message (swsrp2401) is output and normally end

Equivalency maintain status

Informational message (swsrp2401) is output and normally end

Replication established status (halt status)

Start of incremental copy

Before starting the replication, run the replication preprocessing script for the replication destination volume. The contents of this script can be customized. For more information, see "Preprocessing and Postprocessing of Replication". If you do not want to implement the preprocessing script, use the -t option.

To protect processing that accesses a replication destination volume, set the copied material volume before starting replication so that other processes cannot access it. To do so, cancel the drive letter of the replication destination volume or execute unmount. If you cannot cancel the drive letter of the replication destination volume or execute unmount because of the situations described below, this command fails and terminates.

See "General notes", for notes on starting replication.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (replication management)".

This command cannot be executed while any of the following commands is running:

In the case of a SynfinityFILE file system whose replica volume consists of more than one device (multipartition), replication cannot be performed by using preprocessing and postprocessing scripts to execute unmount/mount.
In the case of a SynfinityFILE file system whose replica volume consists of more than one device (multipartition), unmount the file system before replication is started and mount it after that replication is completed.

When the SynfinityFILE and AdvancedCopy Manager configurations are as follows:

# sfxinfo /dev/dsk/c1t3d10s1
ID    special                          size    mount   Type
0     /dev/dsk/c1t3d10s1(800019)       25986   /mnt    META
0     /dev/dsk/c1t3d10s1(800019)       105751  /mnt    DATA
1     /dev/dsk/c1t3d15s3(800028)       5120    /mnt    LOG
2     /dev/dsk/c1t3d16s3(800030)       131736  /mnt    DATA

Setting AdvancedCopy Manager

# /opt/FJSVswsrp/bin/swsrpvolinfo
Server Original-Volume        Size         Replica-Volume         Size         Copy         Op-Server
SV1    /dev/dsk/c1t3d10s1@SV1  128.0 Mbyte /dev/dsk/c1t3d20s1@SV1  128.0 Mbyte bi-direction original
SV1    /dev/dsk/c1t3d15s3@SV1    5.0 Mbyte /dev/dsk/c1t3d25s3@SV1    5.0 Mbyte bi-direction original
SV1    /dev/dsk/c1t3d16s3@SV1  128.0 Mbyte /dev/dsk/c1t3d26s3@SV1  128.0 Mbyte bi-direction original

Replica creation procedure (original volume: SynfinityFILE)

# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d10s1 /dev/dsk/c1t3d20s1
FROM=/dev/dsk/c1t3d10s1@SV1,TO=/dev/dsk/c1t3d20s1 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d15s3 /dev/dsk/c1t3d25s3
FROM=/dev/dsk/c1t3d15s3@SV1,TO=/dev/dsk/c1t3d25s3 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d16s3 /dev/dsk/c1t3d26s3
FROM=/dev/dsk/c1t3d16s3@SV1,TO=/dev/dsk/c1t3d26s3 swsrpstartsync completed
:
:(Checking equivalence-held state)
:
# umount /mnt
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d10s1 /dev/dsk/c1t3d20s1
FROM=/dev/dsk/c1t3d10s1@SV1,TO=/dev/dsk/c1t3d20s1 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d15s3 /dev/dsk/c1t3d25s3
FROM=/dev/dsk/c1t3d15s3@SV1,TO=/dev/dsk/c1t3d25s3 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d16s3 /dev/dsk/c1t3d26s3
FROM=/dev/dsk/c1t3d16s3@SV1,TO=/dev/dsk/c1t3d26s3 swsrpmake completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

Replica creation procedure (replica volume: SynfinityFILE)

# umount /mnt
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d20s1 /dev/dsk/c1t3d10s1
FROM=/dev/dsk/c1t3d20s1@SV1,TO=/dev/dsk/c1t3d10s1 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d25s3 /dev/dsk/c1t3d15s3
FROM=/dev/dsk/c1t3d25s3@SV1,TO=/dev/dsk/c1t3d15s3 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d26s3 /dev/dsk/c1t3d16s3
FROM=/dev/dsk/c1t3d26s3@SV1,TO=/dev/dsk/c1t3d16s3 swsrpstartsync completed
:
:(Checking equivalence-held state)
:
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d20s1 /dev/dsk/c1t3d10s1
FROM=/dev/dsk/c1t3d20s1@SV1,TO=/dev/dsk/c1t3d10s1 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d25s3 /dev/dsk/c1t3d15s3
FROM=/dev/dsk/c1t3d25s3@SV1,TO=/dev/dsk/c1t3d15s3 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d26s3 /dev/dsk/c1t3d16s3
FROM=/dev/dsk/c1t3d26s3@SV1,TO=/dev/dsk/c1t3d16s3 swsrpmake completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

10.3.2.2 Replication creation command (swsrpmake)

When synchronization processing (EC) is not performed, start snapshot processing (OPC) to create a replication volume.

When synchronization processing is performed, check whether the status of the processing is equivalency holding state. If the status is equivalency holding state, suspend the synchronization processing and create a replication volume. The status in which synchronization processing is suspended is referred to as the replication established status. After this command is executed, the replication volume (replication destination volume) can be accessed.

The operation of this command is different depending on the status of advanced copy that is in progress:

In either case, the copy destination volume is made accessible after this command is executed.

This command executes the replication preprocessing and postprocessing scripts before a replication is created. For details of these scripts, see "Preprocessing and Postprocessing of Replication".

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrpmake [-f] [-t] [-m] ([-j|-T|-Xconcur|-C]) [-Xgds-slice-skipchk] From-Volume-Name To-Volume-Name

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrpmake -h Server-Name [-f] [-t] [-m] ([-j|-T|-Xconcur|-C]) [-Xgds-slice-skipchk] From-Volume-Name To-Volume-Name

    [if executed on a storage server: group specification]

    /opt/FJSVswsrp/bin/swsrpmake [-m] [-f] [-t] ([-j|-T|-Xconcur|-C]) [-Xreverse] -Xgroup Group-Name

    [if executed on a storage management server: group specification]

    /opt/FJSVswsrp/bin/swsrpmake -h Server-Name [-m] [-f] [-t] ([-j|-T|-Xconcur|-C]) [-Xreverse] -Xgroup Group-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -m

    For server-to-server replication, specifies that communication processing with the non-operation server is not performed. When this option is specified, volume status check processing and preprocessing and post processing are not performed for the non-operation server volume.

    This option is valid only during server-to-server replication.

    -f

    Specifies that the preprocessing and post processing for a replication source volume are not performed.

    Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy source volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device).

    -t

    Specifies that the preprocessing and post processing for a replication destination volume are not performed.

    Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy destination volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device).

    -j

    Specifies that copy processing be forcibly suspended even if the execution status of copying is "sync: Total copy or incremental copy is being performed" or "halt: Hard suspend status" in synchronization processing of intercabinet replication. This option can be used only for intercabinet replication. If used for intracabinet replication, an error occurs.

    When this option is specified, the data in the destination volume is not guaranteed.

    Also, when this option is specified, preprocessing and postprocessing for the source and destination volumes are not performed.

    -T

    Specifies that differential snapshot processing be executed.

    This option cannot be specified while synchronous processing is performed.

    This option is valid only for a replication within a cabinet and when the disk array supports the QuickOPC function.

    For a snapshot replication without specifying this option, ordinary snapshot processing (OPC without using the QuickOPC function) is started. This option must be specified to perform the replication operation using differential snapshots.

    -Xgroup

    Specifies that operation statuses are displayed by the group.

    -Xreverse

    Specifies that a replication be created for each group in the reverse direction (from replica volumes to original volumes).

    -Xconcur

    Specifies that a replication be created using the concurrent suspension function.

    This option is not supported when GDS Snapshot linkage is being used.

    -C

    Specifies that a SnapOPC start.

    This option is only valid with intra-cabinet replications and for disk array devices that support the SnapOPC function.

    In order to execute a SnapOPC, the copy destination volume must be a Snap Data Volume.

    -Xgds-slice-skipchk

    Skips the SDX object status check processing that is usually performed as part of the copy source and copy destination preprocessing if SDX objects are operated in slice units.

    If this option is specified for a stopped volume, the -f option and the -t option must also be specified.

  3. Description of operands

    Operand

    Description

    From-Volume-Name

    Specifies a replication source volume. Specifies the replication source volume or the replication destination volume that was set with the replication volume information setting command.

    To-Volume-Name

    Specifies a replication destination volume. Specifies the replication source volume or the replication destination volume that was set with the replication volume information setting command.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    The Storage management server instructs Storage server: SRC-SV to create a copy of /dev/dsk/c1t2d0s3 in /dev/dsk/c1t2d0s3@TARG-SV.

    # /opt/FJSVswsrp/bin/swsrpmake -h SRC-SV /dev/dsk/c1t0d2s3 /dev/dsk/c1t2d0s3@TARG-SV
    FROM=/dev/dsk/c1t2d0s3@SRC-SV,TO=/dev/dsk/c1t2d0s3@TARG-SV swsrpmake completed
    #

    Creates a copy for the group "GRP1".

    # swsrpmake -Xgroup GRP1
    GROUP=GRP1 swsrpmake completed
    #

Replication cannot be created if:

If the -Xgroup option is specified, processing will be terminated without creating a copy if the operation statuses of the replication volumes being processed include both snapshot-type replication and synchronous-type replication.
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.

When the replication to perform corresponds to either of the following conditions, please perform drive character release or unmount of copy place volume before executing a command.
When performing neither drive character release nor unmount in the above-mentioned case, post-processing of the copy place volume at the time of duplicate creation serves as an error.

Before a replication is created, the replication preprocessing and postprocessing scripts for the replication source volume are executed (for synchronized replication, only preprocessing script is executed). After the replication has been created, the replication postprocessing script for the replication source volume and replication destination volume is executed. The contents of the script can be customized. For more information, see "Preprocessing and Postprocessing of Replication" If you do not want to implement the preprocessing and postprocessing scripts, use the -f option and the -t option.

If this command is executed during execution of snapshot processing, stop the copy processing in progress and start the snapshot processing again.

To protect the data, set the replication source volume before creating a replication so that other processes cannot access the volume. To do so, cancel the drive letter of the replication source volume or execute unmount. If you cannot cancel the drive letter of the replication source volume or execute unmount because of the situations described below, this command fails and terminates.

Copied material volume When you are the volume by which the SynfinityFILE file system was built, please perform mount of copy place volume in the following procedures.
# sfxadm The list of RAW device names which constitute SynfinityFILE
# fsck -F sfxfs [-y] The representation RAW device name of SynfinityFILE
# mount -F sfxfs The representation RAW device name of SynfinityFILE

For Snap Data Volumes, only SnapOPCs can be executed and OPCs and QuickOPCs cannot be executed.
Additionally, when data is restored from a Snap Data Volume, there must be a SnapOPC session between the copy source volume and the copy destination volume (the Snap Data Volume).

See "General notes", for notes on starting replication.

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (replication management)".

This command cannot be executed while any of the following commands is running:

In the case of a SynfinityFILE file system whose original or replica volume consists of more than one device (multipartition), replication cannot be performed by using preprocessing and postprocessing scripts to execute unmount/mount.
In the case of a SynfinityFILE file system whose original or replica volume consists of more than one device (multipartition), unmount the file system before replication is performed and mount it after that replication is completed.

When the SynfinityFILE and AdvancedCopy Manager configurations are as follows:

# sfxinfo /dev/dsk/c1t3d10s1
ID    special                          size    mount   Type
0     /dev/dsk/c1t3d10s1(800019)       25986   /mnt    META
0     /dev/dsk/c1t3d10s1(800019)       105751  /mnt    DATA
1     /dev/dsk/c1t3d15s3(800028)       5120    /mnt    LOG
2     /dev/dsk/c1t3d16s3(800030)       131736  /mnt    DATA

Setting AdvancedCopy Manager 
# /opt/FJSVswsrp/bin/swsrpvolinfo
Server Original-Volume        Size         Replica-Volume         Size         Copy         Op-Server
SV1    /dev/dsk/c1t3d10s1@SV1  128.0 Mbyte /dev/dsk/c1t3d20s1@SV1  128.0 Mbyte bi-direction original
SV1    /dev/dsk/c1t3d15s3@SV1    5.0 Mbyte /dev/dsk/c1t3d25s3@SV1    5.0 Mbyte bi-direction original
SV1    /dev/dsk/c1t3d16s3@SV1  128.0 Mbyte /dev/dsk/c1t3d26s3@SV1  128.0 Mbyte bi-direction original

Replica creation procedure (original volume: SynfinityFILE (snapshot))

# umount /mnt
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d10s1 /dev/dsk/c1t3d20s1
FROM=/dev/dsk/c1t3d10s1@SV1,TO=/dev/dsk/c1t3d20s1 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d15s3 /dev/dsk/c1t3d25s3
FROM=/dev/dsk/c1t3d15s3@SV1,TO=/dev/dsk/c1t3d25s3 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d16s3 /dev/dsk/c1t3d26s3
FROM=/dev/dsk/c1t3d16s3@SV1,TO=/dev/dsk/c1t3d26s3 swsrpmake completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

Replica creation procedure (original volume: SynfinityFILE (synchronous))

# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d10s1 /dev/dsk/c1t3d20s1
FROM=/dev/dsk/c1t3d10s1@SV1,TO=/dev/dsk/c1t3d20s1 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d15s3 /dev/dsk/c1t3d25s3
FROM=/dev/dsk/c1t3d15s3@SV1,TO=/dev/dsk/c1t3d25s3 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d16s3 /dev/dsk/c1t3d26s3
FROM=/dev/dsk/c1t3d16s3@SV1,TO=/dev/dsk/c1t3d26s3 swsrpstartsync completed
:
:(Checking equivalence-held state)
:
# umount /mnt
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d10s1 /dev/dsk/c1t3d20s1
FROM=/dev/dsk/c1t3d10s1@SV1,TO=/dev/dsk/c1t3d20s1 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d15s3 /dev/dsk/c1t3d25s3
FROM=/dev/dsk/c1t3d15s3@SV1,TO=/dev/dsk/c1t3d25s3 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d16s3 /dev/dsk/c1t3d26s3
FROM=/dev/dsk/c1t3d16s3@SV1,TO=/dev/dsk/c1t3d26s3 swsrpmake completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

Replica creation procedure (original volume: SynfinityFILE (snapshot))

# umount /mnt
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d20s1 /dev/dsk/c1t3d10s1
FROM=/dev/dsk/c1t3d20s1@SV1,TO=/dev/dsk/c1t3d10s1 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d25s3 /dev/dsk/c1t3d15s3
FROM=/dev/dsk/c1t3d25s3@SV1,TO=/dev/dsk/c1t3d15s3 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d26s3 /dev/dsk/c1t3d16s3
FROM=/dev/dsk/c1t3d26s3@SV1,TO=/dev/dsk/c1t3d16s3 swsrpmake completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

Replica creation procedure (original volume: SynfinityFILE (synchronous))

# umount /mnt
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d20s1 /dev/dsk/c1t3d10s1
FROM=/dev/dsk/c1t3d20s1@SV1,TO=/dev/dsk/c1t3d10s1 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d25s3 /dev/dsk/c1t3d15s3
FROM=/dev/dsk/c1t3d25s3@SV1,TO=/dev/dsk/c1t3d15s3 swsrpstartsync completed
# /opt/FJSVswsrp/bin/swsrpstartsync /dev/dsk/c1t3d26s3 /dev/dsk/c1t3d16s3
FROM=/dev/dsk/c1t3d26s3@SV1,TO=/dev/dsk/c1t3d16s3 swsrpstartsync completed
:
:(Checking equivalence-held state) 
:
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d20s1 /dev/dsk/c1t3d10s1
FROM=/dev/dsk/c1t3d20s1@SV1,TO=/dev/dsk/c1t3d10s1 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d25s3 /dev/dsk/c1t3d15s3
FROM=/dev/dsk/c1t3d25s3@SV1,TO=/dev/dsk/c1t3d15s3 swsrpmake completed
# /opt/FJSVswsrp/bin/swsrpmake /dev/dsk/c1t3d26s3 /dev/dsk/c1t3d16s3
FROM=/dev/dsk/c1t3d26s3@SV1,TO=/dev/dsk/c1t3d16s3 swsrpmake completed
# mount -F sfxfs /dev/dsk/c1t3d10s1 /mnt
#

If this command is executed during snapshot processing, snapshot processing is newly started. See the following table for details of copy operation:

Operation status
(Display by swsrpstat -L)

-T option specification

Copy operation

Copy is not executed.
(Status is "----" and Trk also is "----".)

No

Ordinary snapshot processing is started.

Copy is not executed.
(Status is "----" and Trk also is "----".)

Yes

Differential snapshot processing is started.

Snapshot processing is in progress
and
tracking is not executed.
(Status is "snap" and Trk is "off".)

No

Copying in progress is terminated and ordinary snapshot processing is newly started.

Snapshot processing is in progress
and
tracking is not executed.
(Status is "snap" and Trk is "off".)

Yes

Copying in progress is terminated and differential snapshot processing is newly started.

Snapshot processing is in progress
and
tracking is in progress.
(Status is "snap" and Trk is "on".)

No

Copying in progress is terminated and ordinary snapshot processing is newly started.

Snapshot processing is in progress
and
tracking is in progress.
(Status is "snap" and Trk is "on".)

Yes

Differential snapshot processing is restarted.

Tracking is in progress.
(Status is "----" and Trk is "on".)

No

Tracking processing is terminated and ordinary snapshot processing is newly started.

Tracking is in progress.
(Status is "----" and Trk is "on".)

Yes

Differential snapshot processing is restarted.

10.3.2.3 Operation status display command (swsrpstat)

This command displays the operation status of the specified volume. If a volume is not specified, the operation status of each replication volumes is displayed.

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrpstat [-L] [-E] [-H][Original-Volume-Name]

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrpstat -h Server-Name [-L] [-E] [-H] [Original-Volume-Name]

    [if executed on a storage server: group specification]

    /opt/FJSVswsrp/bin/swsrpstat [-L] [-E] -Xgroup Group-Name

    [if executed on a storage management server: group specification]

    /opt/FJSVswsrp/bin/swsrpstat -h Server-Name [-L] [-E] -Xgroup Group-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -L

    Specifies display in extension format.

    For the items displayed by this option, see the table of the execution example.

    Note that the items displayed by this option may be subject to change in a future release.

    -E

    An option which when set will display the operational status in the opposite direction only(from the copy destination to the copy source). In case this option is not set, the operation status in the normal direction (from the copy source to the copy destination) will always be displayed when a bi-directional OPC physical copy is taking place. In case this option is set, the operational status in the normal direction will not be displayed. Only the operational status in the opposite direction will be displayed.

    This option can be used to check the operational status of an OPC session performed in an opposite direction in case a QuickOPC session in the normal direction exists.

    -Xgroup

    Specifies a group name.In case this option is set, all the operational statuses about the specified group will be displayed.

    -H

    Changes the Status field display method used when a REC enters a hard suspend (HALT) status.

    If this option is specified, then "halt(sync)" will be displayed when hard-suspend status occurs during a total copy or a differential copy. "halt(equivalent)" will be displayed when hard-suspend status occurs during an equivalency maintenance state.

    Note that hard-suspend status will still be displayed as "halt" even if this option is specified for ROPC or GDS Snapshot linkage.

  3. Description of operands

    Operand

    Description

    Original-Volume-Name

    Specifies a replication source volume name. For the volume names of other servers, use the format "volume-name@storage-server-name."

    Displays all operation statuses for the specified replication source volume. If this operand is omitted, all the operation statuses of the storage server on which this command is executed are displayed.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    Direct that all the replication operation statuses for storage server SRC-SV be displayed on the storage management server.

    # /opt/FJSVswsrp/bin/swsrpstat -h SRC-SV
Server Original-Volume          Replica-Volume            Direction  Status     Execute
SRC-SV /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d0s3@TARG-SV regular    replicated ----
SRC-SV /dev/dsk/c1t2d1s3@SRC-SV /dev/dsk/c1t2d1s3@TARG-SV ----       ----       ----
SRC-SV /dev/dsk/c1t2d2s3@SRC-SV /dev/dsk/c1t2d2s3@TARG-SV reverse    snap       45%
#

    From storage management server to storage server: Instruct SRC-SV to display the status of all replication operations (with the -L option specified).

    #swsrpstat -h SRC-SV -L
Server Original-Volume          Replica-Volume            Direction Status     Execute Trk  Update Rcv  Split Xfer
SRC-SV /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d0s3@TARG-SV regular   replicated ----    ---- ----   auto ----  async
SRC-SV /dev/dsk/c1t2d1s3@SRC-SV /dev/dsk/c1t2d1s3@TARG-SV ----      ----       ----    on   6%     ---- ----  ----
SRC-SV /dev/dsk/c1t2d2s3@SRC-SV /dev/dsk/c1t2d2s3@TARG-SV reverse   snap       45%     off  ----   ---- ----  ----
#

    The following information will be displayed.

    Title

    Description

    Server

    Displays a storage server name.

    Original-Volume

    Displays a replication source volume name.

    Replica-Volume

    Displays a replication destination volume name.

    Direction

    Displays the copy direction.

    • regular: Copying from the replication source to the replication destination is being performed.

    • reverse: Copying from the replication destination to the replication source is being performed.

    • ----: Copying is not performed.

    Status

    Displays the progress.

    • ---- : Copying is not being performed.

    • sync : Total copy or incremental copy is being performed.

    • equivalent : Equivalency maintain status

    • replicated : Replication established status

    • copy-on-write: SnapOPC processing is being performed.

    • failed : Error suspend status

    • halt : Hard suspend status

    • halt(sync): Hard suspend status (hard suspend status has been entered during a REC total copy or differential copy)

    • halt(equivalent): Hard suspend status (hard suspend status has been entered during an REC equivalency maintenance state)

    • snap : Snapshot processing is being performed.

    • ????? : Copy situation cannot be acquired.

    • "gds-error": Copying with GDS ended abnormally.

    Execute

    Displays the copy progress rate as a percentage. "----" is displayed during SnapOPC or when no copying is being performed.

    Trk

    Displays whether tracking processing is in progress.

    on : Tracking processing is in progress.

    off : Tracking processing is in progress.

    ----: Snapshot processing is not performed.

    Always displays "----" when the GDS Snapshot linkage function is enabled.

    Update

    Displays the percentage of data that has been updated since the last copy was created, in the following cases:

    • When the Status column is "----" and the Trk column is "on" (that is, tracking is in progress and the physical copy is not executed).

    • When the Status column is "copy-on-write" (that is, when a SnapOPC is being performed)

    In all other cases, "----" is displayed.

    Always displays "----" when the GDS Snapshot linkage function is enabled.

    Rcv

    Indicates recovery mode for inter-box synchronization.

    auto: Automatic Recovery mode.

    manual: Manual Recovery mode.

    ----: Synchronous duplication (REC) is not performed between boxes.

    Split

    Indicates split mode for inter-box synchronization.

    auto: Automatic Split mode.

    manual: Manual Split mode.

    ----: Synchronous duplication (REC) is not performed between boxes.

    Xfer

    Indicates transfer mode in inter-box synchronization.

    sync: Synchronous mode.

    async: Asynchronous mode.

    stack: Stack mode.

    consist: Consistency mode.

    ----: Synchronous duplication (REC) is not performed between boxes.

When the execution status (status displayed in the Status field) is one of the following, take appropriate action.

Status display

Corrective action

Failed

A hardware error may have occurred. Correct the hardware error, and then use the replication cancellation command to stop operation.

Halt

A hardware error during replication operation between cabinets may occur. Correct the hardware error, and then use the replication cancellation command to stop the copy operation.

?????

Copy situation cannot be acquired. A hardware error may have occurred if the result is the same after reexecution. Correct the hardware error, and then reexecute the command.

gds-error

A problem with GDS is assumed. Correct the cause of the GDS problem, and execute the replication cancellation command to stop the replication operation.

The operation status cannot be displayed if:

This command cannot be executed while the following command is running:

10.3.2.4 Replication cancellation command (swsrpcancel)

This command stops snapshot processing (OPC) and synchronization processing (EC) of the specified replication volume. Use this command when an error is detected during the replication operation and when you want to stop replication processing.

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrpcancel [-c] ([-f] [-t] [-m] [-b] | [-T] ) [-Xgds-slice-skipchk] From-Volume-Name To-Volume-Name

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrpcancel -h Server-Name [-c] ([-f] [-t] [-m] [-b] | [-T]) [-Xgds-slice-skipchk] From-Volume-Name To-Volume-Name

    [if executed on a storage management server: group specification]

    /opt/FJSVswsrp/bin/swsrpcancel -h Server-Name [-c] ([-f] [-t] [-m] [-b] | [-T]) [-Xreverse] -Xgroup Group-Name

    [if executed on a storage management server: group specification]

    /opt/FJSVswsrp/bin/swsrpcancel -h Server-Name [-c] ([-f] [-t] [-m] [-b] | [-T]) [-Xreverse] -Xgroup Group-Name

  2. Description of options

    Option

    Description

    -h

    Specifies a storage server name.

    This option can be specified only on a storage management server.

    -c

    Specifies that copy processing be canceled from servers other than the operation server if the operation server becomes unavailable (due to system failure, etc). If this option is used, copy processing is stopped without executing preprocessing and postprocessing.

    This option cannot be specified on the operation server.

    -m

    For server-to-server replication, specifies that communication processing with non-operation servers is not performed. When this option is specified, volume status check processing and preprocessing and postprocessing for the replication destination volume of a non-operation server are not performed.

    This option is valid only during server-to-server replication.

    -f

    When stopping the synchronous processing under the equivalency maintain status, specify that preprocessing and postprocessing for the copy source volume not be executed.

    Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy source volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device).

    -t

    When stopping the synchronous processing under the equivalency maintain status, specify that postprocessing for the copy destination volume not be executed.

    Use this option only when AdvancedCopy Manager does not execute preprocessing and postprocessing of the copy destination volume and unique preprocessing and postprocessing scripts are inserted before and after, respectively, the AdvancedCopy Manager command, or when you judge that copy preprocessing and postprocessing are unnecessary (e.g., for a database constructed on a raw device).

    -b

    Specifies that the intercabinet copy operation in the HALT status be stopped.

    For replication on a server, the copying is cancelled for both cabinets.

    For replication between servers, the copying is cancelled only for the cabinet connected to the server on which this command was executed.

    Use the option only for a copy operation in the HALT status and whose recovery cannot be expected.

    The option is valid only for a copy operation in the HALT status.

    The option can be used on the server not specified as the operation server.

    If this option is specified together with the -Xgroup option, copy processing is only stopped for sessions in the group whose status is HALT.

    -T

    Specifies that differential snapshot processing be terminated.

    This option terminates only tracking processing but does not terminate snapshot processing (OPC physical copying) in progress. This option releases the OPC session if snapshot processing (OPC physical copying) is complete.

    This option can be used only while physical copying or tracking is in progress.

    This option cannot be used for the logical volume of an SDX object.

    If this option is specified together with the -Xgroup option, only tracking processing within the group is stopped.

    -Xgroup

    Specifies that copy processing be stopped for each group.

    -Xreverse

    Specifies that copy processing that is being executed in the reverse direction (from replica volumes to original volumes) be stopped.

    -Xgds-slice-skipchk

    Skips the SDX object status check processing that is usually performed as part of the copy source and copy destination preprocessing. This takes place if SDX objects are operated in slice units and the synchronization processing for equivalency maintenance state is stopped.

    If this option is specified for a stopped volume, the -f option and the -t option must also be specified.

  3. Description of operands

    Operand

    Description

    From-Volume-Name

    Specifies a copysource volume name. Specifies the replication source volume or the replication destination volume set with the replication volume information setting command.

    To-Volume-Name

    Specifies a copydestination volume name. Specifies the replication source volume or the replication destination volume set with the copy volume information set command.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    On the storage management server, direct that copying from /dev/dsk/c1t2d0s3 to /dev/dsk/c1t2d0s3@TARG-SV be stopped for storage server SRC-SV.

    #/opt/FJSVswsrp/bin/swsrpcancel -h SRC-SV /dev/dsk/c1t2d0s3 /dev/dsk/c1t2d0s3@TARG-SV
FROM=/dev/dsk/c1t2d0s3@SRC-SV,TO=/dev/dsk/c1t2d0s3@TARG-SV swsrpcancel completed
#

    Stops copy processing for group "GRP1".

    # swsrpcancel -Xgroup GRP1
GROUP=GRP1 swsrpcancel completed
#

Following execution with the -b option specified in replication on a server, the command stops normally when cancellation of the copying succeeds in either of the cabinets.

Copy processing cannot be performed if:

If the -Xgroup option is specified, processing will be performed for each active replication volume, but processing will be terminated without canceling replication in the following case:
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.

The volume information for the specified volume is not checked (check for matching of the volume information in the management list and the actual physical information). Operation is canceled unconditionally using the volume information in the management list.

The following processing is performed depending on the operation status of the specified replication source volume and replication destination volume.

Operation status

Processing

Reverse copy direction

Suspends the processing.

Not operating yet

Suspends the processing.

Total or incremental copy is performed

Suspends synchronization processing.
The replication destination volume cannot be used.

Equivalency maintain status

Suspends synchronization processing.
The replication destination volume can be used as a copy

Replication established status

Suspends synchronization processing.
The replication destination volume can be used as a copy

Snapshot processing is being performed

Stops the snapshot processing.
The replication destination volume cannot be used.

Preprocessing and postprocessing for a replication source and replication destination volumes are performed only when the status of synchronization processing is equivalency maintain.

Synchronization processing cannot be stopped in equivalency maintain status if:

For details on how to use SDX objects of GDS, refer to "Configuration and conditions of unsupported SDX objects", and "Notes on SDX object operations (replication management)".

This command cannot be executed while any of the following commands is running:

When the -T option is not specified, command processing varies depending on the operation status of the source and destination volumes.

Operation status
(Display by swsrpstat -L)

Processing

Reverse copy

Processing is interrupted.

Not in operation
(Status is "----" and Trk also is "----".)

Processing is interrupted.

Total or difference copying is in progress.
(Status is "sync".)

Synchronous processing is terminated. The destination volume cannot be used.

Equivalency maintain status
(Status is "equivalent".)

Synchronous processing is terminated. The destination volume can be used as a replica.

Replica created status
(Status is "replicated".)

Synchronous processing is terminated. The destination volume can be used as a replica.

Snapshot processing is in progress.
(Status is "snap")

Synchronous processing is terminated. The destination volume cannot be used.

Tracking processing, if in progress, is also terminated.

Snapshot processing complete status
and tracking processing in progress
(Status is "----" and Trk also is "on".)

Tracking processing is terminated. The destination volume can be used as a replica.

When the -T option is specified, command processing varies depending on the operation status of the source and destination volumes.

Operation status
(Display by swsrpstat -L)

Processing

Reverse copy

Processing is interrupted.

Not in operation
(Status is "----" and Trk also is "----".)

Processing is interrupted.

Total or difference copying is in progress.
(Status is "sync".)

Processing is interrupted.

Equivalency maintain status
(Status is "equivalent".)

Processing is interrupted.

Replica created status
(Status is "replicated".)

Processing is interrupted.

Snapshot processing is in progress
and tracking processing is not in progress.
(Status is "snap" and Trk is "off")

Processing is interrupted.

Snapshot processing is in progress
and tracking processing is progress.
(Status is "snap" and Trk is "on".)

Only tracking processing is terminated. Snapshot processing (physical copying) is continued.

The destination volume can be used as a replica.

Snapshot processing complete status
and tracking processing in progress.
(Status is "----" and Trk also is "on".)

Tracking processing is terminated. The destination volume can be used as a replica.

10.3.2.5 Synchronization mode change command (swsrpchsync)

This command changes the operation mode of inter-box synchronization (transfer mode, recovery mode, or split mode).

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrpchsync [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] From-Volume-Name To-Volume-Name

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrpchsync -h Server-Name [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] From-Volume-Name To-Volume-Name

    [if executed on a storage server: group specification]

    /opt/FJSVswsrp/bin/swsrpchsync [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] [-Xreverse] -Xgroup Group-Name

    [if executed on a storage management server: group specification]

    /opt/FJSVswsrp/bin/swsrpchsync -h Server-Name [-F (Sync|Async|Stack|Consist)] [-R (Auto|Manual)] [-S (Auto|Manual)] [-Xreverse] -Xgroup Group-Name

  2. Description of options

    Option

    Description

    -h

    Specifies the name of a storage server.

    You can use this option only for a storage management server.

    -F

    Changes the transfer mode.

    You can specify one of the following parameters in the operand:

    Sync: Changes to Synchronous mode.

    Async: Changes to Asynchronous (sequential transfer) mode.

    Stack: Changes to Stack mode.

    Consist: Changes to Consistency mode.

    Changing the transfer mode requires this option.

    You can only specify the -S option together with the -F Sync option.

    Specifying the -F Sync option to change the transfer mode from a non-synchronous mode to the synchronous mode without specifying the -S option sets the automatic split mode.

    -R

    Changes the recovery mode.

    You can specify either of the following parameters in the operand:

    Auto: Changes to Automatic Recovery mode.

    Manual: Changes to Manual Recovery mode.

    Changing the recovery mode requires this option.

    -S

    Changes the split mode.

    You can specify either of the following parameters in the operand:

    Auto: Changes to Automatic Split mode.

    Manual: Changes to Manual Split mode.

    Changing the split mode requires this option.

    To specify this option, you must also specify -F Sync or the transfer mode of the current synchronization must be synchronous mode.

    -Xgroup

    Changes the operation mode of inter-box synchronous processing for each group (transfer mode, recovery mode, or split mode).

    -Xreverse

    Specifies that the operation mode of synchronous processing that is being executed in reverse direction (from replica volumes to original volumes) be changed.

  3. Description of operands

    Operand

    Description

    From-Volume-Name

    Specifies the name of a source volume. Specify the original volume or replica volume configured by the replication volume information set command.

    To-Volume-Name

    Specifies the name of a destination volume. Specify the original volume or replica volume configured by the replication volume information set command.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    From storage management server to storage server: Instruct SRC-SV to change the transfer mode for inter-box synchronization between /dev/dsk/c1t2d0s3@SRC-SV and /dev/dsk/c1t2d10s3@TARG-SV from Consistency mode to Asynchronous mode.

    #/opt/FJSVswsrp/bin/swsrpstat -h SRC-SV -L /dev/dsk/c1t2d0s3@SRC-SV
Server Original-Volume          Replica-Volume             Direction Status Execute Trk  Rcv  Split Xfer
SRC-SV /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d10s3@TARG-SV regular   sync   99%     ---- auto ----  consist
:
#/opt/FJSVswsrp/bin/swsrpchsync -h SRC-SV -F Async /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d10s3@TARG-SV
FROM=/dev/dsk/c1t2d0s3@SRC-SV, TO=/dev/dsk/c1t2d10s3@TARG-SV swsrpchsync completed
:
#/opt/FJSVswsrp/bin/swsrpstat -h SRC-SV -L /dev/dsk/c1t2d0s3@SRC-SV
Server Original-Volume          Replica-Volume             Direction Status     Execute Trk  Rcv  Split Xfer
SRC-SV /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d10s3@TARG-SV regular   equivalent 100%    ---- auto ----  async
#

    Specify that the transfer mode of inter-box synchronous processing for group "GRP1" be changed from consistency mode to asynchronous mode.

    # swsrpchsync -F Async -Xgroup GRP1
GROUP=GRP1 swsrpchsync completed
#

In any of the following cases, you cannot change the operation mode of inter-box synchronization:

If the -Xgroup option is specified, the synchronous processing for all replication volumes being processed is changed to the same operation mode. However, the operation mode cannot be changed if there is even one replication volume that meets the conditions above.
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.

This command cannot be executed while any of the following commands is running:

10.3.2.6 Synchronization reverse command (swsrprevsync)

This command reverses the copying direction of inter-box synchronization (REC) in suspended status.

This command is unusable to handle an intra-box synchronization or a logical volume of an SDX object.

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrprevsync From-Volume-Name To-Volume-Name

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrprevsync -h Server-Name From-Volume-Name To-Volume-Name

    [if executed on a storage server: group specification]

    /opt/FJSVswsrp/bin/swsrprevsync [-Xreverse] -Xgroup Group-Name

    [if executed on a storage management server: group specification]

    /opt/FJSVswsrp/bin/swsrprevsync -h Server-Name [-Xreverse] -Xgroup Group-Name

  2. Description of options

    Option

    Description

    -h

    Specifies the name of a storage server.

    You can only use this option for a storage management server.

    -Xgroup

    Changes the direction of inter-box synchronous processing for each group.

    -Xreverse

    Specifies that the direction of synchronous processing that is being executed in reverse direction (from replica volumes to original volumes) be inverted.

  3. Description of operands

    Option

    Description

    From-Volume-Name

    Specifies the name of a source volume (as the destination in the reverse direction). Specify the original volume or replica volume configured by the replication volume information set command.

    To-Volume-Name

    Specifies the name of a destination volume (as the source in the reverse direction). Specify the original volume or replica volume configured by the replication volume information set command.

  4. End status

    = 0: Normal end

    > 0: Abnormal end

  5. Execution example

    From storage management server to storage server: Instruct SRC-SV to reverse the copying direction of inter-box synchronization between /dev/dsk/c1t2d0s3@SRC-SV and /dev/dsk/c1t2d10s3@TARG-SV.

    #/opt/FJSVswsrp/bin/swsrpstat -h SRC-SV /dev/dsk/c1t2d0s3@SRC-SV
Server Original-Volume          Replica-Volume             Direction  Status     Execute
SRC-SV /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d10s3@TARG-SV reverse    replicated ----
#/opt/FJSVswsrp/bin/swsrprevsync /dev/dsk/c1t2d10s3@TARG-SV /dev/dsk/c1t2d0s3@SRC-SV 
FROM=/dev/dsk/c1t2d0s3@SRC-SV,TO=/dev/dsk/c1t2d10s3@TARG-SV swsrprevsync completed
#/opt/FJSVswsrp/bin/swsrpstat /dev/dsk/c1t2d0s3@SRC-SV
Server Original-Volume          Replica-Volume             Direction  Status     Execute
SRC-SV /dev/dsk/c1t2d0s3@SRC-SV /dev/dsk/c1t2d10s3@TARG-SV regular    replicated ----
#

    Change the direction of inter-box synchronous processing for group "GRP1".

    # swsrprevsync -Xgroup GRP1
GROUP=GRP1 swsrprevsync completed
#

In any of the following cases, you cannot reverse the direction of synchronization:

If the -Xgroup option is specified, the direction of synchronous processing for all replication volumes being processed is changed. However, the direction of synchronous processing cannot be changed if there is even one replication volume that meets the conditions above.
Additionally, if the -Xgroup option is specified, replication volumes are processed in order, but processing will be terminated immediately if an error occurs.

If the -Xgroup option is specified, processing is not performed for those sessions in the group where the direction has already been changed.

This command cannot be executed while any of the following commands is running:

10.3.3 Maintenance commands 

This chapter describes the maintenance commands for replication management.

Use the following maintenance commands for replication management.

Function

Command name

Description

Resource adjustment command

swsrprecoverres

Restores the consistency of information in a replication management files.

10.3.3.1 Resource adjustment command (swsrprecoverres)

This command executes recovery to make replication management information consistent if a system failure or other problem has made the replication management information inconsistent.

  1. Specification method

    [To be executed on a storage server]

    /opt/FJSVswsrp/bin/swsrprecoverres [-r] [-p]

    [To be executed on a storage management server]

    /opt/FJSVswsrp/bin/swsrprecoverres -h Server-Name [-r] [-p]

  2. Description of operands

    Operand

    Description

    -h

    Specifies a storage server name.

    This option can be used only on a storage management server.

    -r

    Specify this option when an incorrect status exists in the replication management files (for example, the replication volume information setting command or the replication volume information deletion command that update the replication management files terminate suddenly because of a forced stop or a system failure, or the replication management files has been deleted by mistake).

    When this option is specified, the following processing to re-create the replication management files is performed.

    Replication management information in the storage management server repository is downloaded to the storage server, and the replication volume information is restored.

    The disk array device is queried, and the execution information for the synchronization processing is restored.

    -p

    Specifies not to perform any postprocessing that has not been performed. This option can be used when the replication creation command processing terminates suddenly because of a forced stop or system failure.

  3. End status

    = 0: Normal end

    > 0: Abnormal end

  4. Execution example

    Perform resource adjustment.

    #/opt/FJSVswsrp/bin/swsrprecoverres
    swsrprecoverres completed
    #

The resource adjustment processing cannot be performed if:

The consistency of resource information is restored only for the storage server on which this command is executed. When a resource inconsistency occurs during processing related to replication between servers, this command must be executed both on the storage server on which the processing was performed and on the storage server with which communication is being made.

This command cannot be executed while any of the following commands is running:

10.4 Start/Stop Daemon Commands

AdvancedCopy Manager daemons can be started in the ways explained in this chapter.

A note on this command is as follows:

10.4.1 Starting and stopping the communication daemon

When the stop of the communication demon is executed while the communication demon is operating, it might take ten seconds or less until the command ends.

10.4.2 Starting and stopping the RMI daemon

10.4.3 Starting and stopping the RDB daemon

10.4.4 Starting and stopping the authentication daemon

10.4.5 Starting and stopping AdvancedCopy Manager daemons

The daemons listed below are started and stopped together:

Server type

Storage server

Storage management server

Daemon name

Communication daemon

Communication daemon

RMI daemon

RDB daemon

Authentication daemon

10.5 SnapOPC Support Commands 

This section explains the commands that execute SnapOPC.

Operating environment for command execution

The table below lists the requirements for the operating environment in which to execute the respective commands.

Command

Operating environment of AdvancedCopy Manager

swstestupdate

-

In cluster operation

In cluster operation, execute a command by taking the following steps:

  1. If necessary, specify the logical node name to the transaction in environment variable SWSTGNODE. For bsh, specify the environment variable as follows:

    # SWSTGNODE= logical-node-name<Enter>
# export SWSTGNODE

  2. Execute the command.

    The table below lists the commands available in cluster operation, whether environment variables must be configured, and the nodes on which commands are executable. For notes and cautions on command execution, see the Remarks column.

    Command

    Environment variable

    Command execution node

    Remarks

    swstestupdate

    Required

    Transaction operation node

    -

10.5.1 Update volume measurement command (swstestupdate) 

This command measures the physical capacity of Snap Data Disks using the pseudo SnapOPC session setup function.

  1. Specification method

    [When starting update volume measurements (setting up a pseudo SnapOPC session)]

    /opt/FJSVswsrp/bin/swstestupdate start Volume-Name

    [When looking up the update volume (displaying the status of the pseudo SnapOPC session)]

    /opt/FJSVswsrp/bin/swstestupdate status Volume-Name

    [When finishing update volume measurements (canceling the pseudo SnapOPC session)]

    /opt/FJSVswsrp/bin/swstestupdate stop Volume-Name

  2. Description of operands

    Operand

    Description

    Volume-Name

    Specifies the volume name.

    Specify a copy source volume that is used with SnapOPC operations.

    GDS logical volumes cannot be specified.

  3. End status

    = 0 : Normal end
    > 0 : Abnormal end

  4. Execution example

    Measure the update volume for /dev/dsk/c1t0d0s1: 

    (Start taking measurements by starting a pseudo SnapOPC)
#/opt/FJSVswsts/bin/swstestupdate start /dev/dsk/c1t0d0s1
/dev/dsk/c1t0d0s1 swstestupdate completed

(First measurement)
#/opt/FJSVswsts/bin/swstestupdate status /dev/dsk/c1t0d0s1
Volume-Name      Update
/dev/dsk/c1t0d0s1 644333

(Second measurement)
#/opt/FJSVswsts/bin/swstestupdate status /dev/dsk/c1t0d0s1
Volume-Name       Update
/dev/dsk/c1t0d0s1 1045000

(Stop taking measurements by canceling the pseudo SnapOPC)
# /opt/FJSVswsts/bin/swstestupdate stop /dev/dsk/c1t0d0s1
/dev/dsk/c1t0d0s1 swstestupdate completed

#

    The following information will be displayed:

    Title

    Description

    Volume-Name

    Displays the volume name.

    Update

    Displays the amount of data (the number of blocks) that has been updated since measurements started (1 block = 512 bytes).

    Displays "----" if there is no pseudo SnapOPC session.

    Displays "failed" if the pseudo SnapOPC session is error-suspended.

The amount of data updated cannot be measured in the following cases:
Contents Index PreviousNext
All Rights Reserved, Copyright(C) FUJITSU LIMITED 2002-2006