PRIMECLUSTER Global Disk Services Configuration and Administration Guide 4.1 (Solaris(TM) Operating System)

D.14 sdxproxy - Proxy object operations

SYNOPSIS

sdxproxy Break -c class -p proxy [-e force,restore]

sdxproxy Cancel -c class -p proxy

sdxproxy Join -c class -m master -p proxy
[-a mvol=pvol:jrm[:pslice][,mvol=pvol:jrm [:pslice],...]]
[-e delay=msec,softcopy,syncmode,waitsync]

sdxproxy Part -c class -p proxy,... [-a attribute=value] [-e instant,mode=val,unlock]

sdxproxy Rejoin -c class -p proxy,...[-e delay=msec,softcopy,waitsync]

sdxproxy RejoinRestore -c class -p proxy,...
[-e delay=msec,instant,nowaitsync,softcopy]

sdxproxy Relate -c class -m master -p proxy

sdxproxy Restore -c class -p proxy,... [-e instant,nowaitsync]

sdxproxy Root -c class -m master,... [-e boot]

sdxproxy Root -c class -p proxy,... [-e boot]

sdxproxy Root -c class -m master,... -p proxy,... [-e boot]

sdxproxy Swap -c class -p proxy

sdxproxy Update -c class -p proxy,... [-e instant,nowaitsync]

 

DESCRIPTION

Use sdxproxy to perform operations on proxy objects.
The sdxproxy command can be executed with superuser access privileges only.

Exception to Proxy Configuration
Number of Proxy Volumes
Proxy Volume Size
Proxy Group Size
Using the Advanced Copy Function in a Proxy Configuration
Instant Snapshot by OPC
Using EMC TimeFinder or EMC SRDF in a Proxy Configuration

 

PRIMARY OPTIONS

You have a choice of the following options.

Break

Cancels master-proxy relationship between a pair of volumes or groups. You can cancel the relationship when the objects are either joined or parted.

proxy indicates a proxy volume or a proxy group to be cancelled. A proxy volume within a proxy group cannot be specified for cancellation.

Even after the relationship is cancelled, the proxy volume or proxy volumes within the proxy group can be used as normal volumes that retain original volume data and attributes.

You can also cancel the relationship when master volume and proxy volume are in use. However, if the joined master volume is in use, the data integrity of the proxy volume should be ensured in the file system layer or database layer that is managing data, after the relationship is cancelled. For instance, if you are using the master volume as a file system, use the lockfs(1M) command to write-lock the file system, before canceling the relationship.

The command will result in an error when:

• Copying is in process from the master volume to the proxy volume (except for when using -e force)

• Copying is in process from the proxy volume to the master volume (except for when using -e restore)

   

Cancel

Cancels (releases) sessions of the copy functions of disk units existing between parted proxies and masters.

Specify a parted proxy group or a parted proxy volume into proxy. When proxy is a proxy group, all parted proxies within the proxy group become targets. A parted proxy volume within a proxy group can also be specified.
However, if there is a BCV pair or an SRDF pair between a master group and a proxy group, a parted proxy volume in the proxy group cannot be selected for canceling the session.

However, when a BCV pair or an SRDF pair exists between the master group and the proxy group, sessions cannot be cancelled specifying a parted proxy volume within the proxy group.

Sessions can be canceled even if master volumes and proxy volumes are in use. Even after canceling the sessions, the masters and the proxies are left parted. The volume statuses of the masters and the proxies also remain unchanged. However, if sessions are canceled when copying from masters to proxies and vice versa are in process, data becomes INVALID. If that happens, perform copying again, and the volume statuses will be restored when the copying is complete.

 

Join

A pair of volumes or a pair of groups are related and joined as master and proxy.

When joining a pair of volumes, synchronization copying of the master volume to the proxy volume is performed after returning from the command (when using -e waitsync, before returning from the command).

When joining a pair of volumes, the following conditions must be satisfied.

• The master volume size and the proxy volume size match.

• The master volumes and the proxy volumes belong to different mirror groups or single disks.

When joining a pair of groups, proxy volumes with the same offset and size as master volumes within the master group will be created in the proxy group, and synchronization copying from the master volumes to the proxy volumes is performed after returning from the command (when using -e waitsync, before returning from the command). The access mode of the proxy volumes created in the proxy group is set to "ro" (read-only).

If a keep disk is connected to the master group or the proxy group and geometry such as the cylinder size does not match between the master group and the proxy group, geometry of the proxy group is changed conforming to that of the master group.

When joining a pair of groups, there are the following conditions and restrictions.

• For the root class, the smallest physical disk size directly connected to the proxy group must be larger than the last block number of a volume within the master group.

• For a local class or a shared class, the proxy group size must be larger than the last block number of a volume within the master group.

• If the master group has no volume and the proxy group already has volumes, joining them results in an error.

• The master group and the proxy group must be mirror groups.

When the copy functions of disk units are available, synchronization copying from masters to proxies is performed with those copy functions (except for when using -e softcopy).

A proxy volume that is joined cannot be accessed or activated. In order to access the proxy volume, part the volume from master using the Part option, or break the relationship with master using the Break option.

You can create multiple snapshots by joining another proxy to a master, which is already joined with a proxy. However, the total number of slices which belong to the master volume and slices which belong to the proxy volumes that are related to the master volume must not exceed 32.

Master volumes that are already related to a proxy cannot be joined to another master as a proxy. Also, a proxy that is already related to a master cannot be joined with another proxy.

The command will result in an error when:

• The proxy volume is activated.

• There is a slice that is temporarily detached or in copying process among any of the slices comprising the proxy volume or the master volume.

• Copying is in process between the master volume and the other proxy volume.

• The master volume is in INVALID status.

   

Part

Separates a proxy or proxies in joined status from the master. The master-proxy relationship will be maintained after parted. The parted proxy volume will be the snapshot containing the copy of the master volume data at the time of parting. By using the parted proxy volume, you can for instance, create a backup of the master volume at the time it was parted, or use it for other purposes.

proxy indicates a proxy volume or a proxy group in joined status. When proxy group is indicated, all proxy volumes in the group will be parted. You can also indicate a proxy volume in joined status in a proxy group.

After the parting is complete, the proxy volume will be activated as an independent volume and become accessible using the following special file.

    /dev/sfdsk/class/[r]dsk/volume_name

When the proxy volume belongs to a "shared" type class, it will be activated on all nodes defined in the class scope.

You can part master and proxy volumes even if the master volume is active, but the data integrity of the parted proxy volume must be ensured in the file system layer or database layer that is managing data. For instance, if you are using the master volume as a file system, use the lockfs(1M) command to write-lock the file system, before parting.

The command will result in an error when:

• Copying is in process from the master volume to the proxy volume (except for when using -e instant)

• Copying is in process from the proxy volume to the master volume

   

Rejoin

Rejoins one or more parted proxy with the master.

proxy indicates a parted proxy volume, or proxy group. When a proxy group is indicated, all proxy volumes in the group will be rejoined. A parted proxy volume in a proxy group can also be specified.

Synchronization copying of master volumes to proxy volumes is performed after returning from the command (when using -e waitsync, before returning from the command). When the copy functions of disk units are available, synchronization copying is performed with those copy functions (except for when using -e softcopy).

When more than one proxy volume related to the same master volume is specified simultaneously, this command will result in an error.

The command will result in an error when:

• The proxy volume is active.

• There is a slice that is in copying process among any of the slices comprising the proxy volume or the master volume.

• Copying is in process between the master volume and the other proxy volume.

• The master volume is in INVALID status.

When proxy volumes are running as system volumes, they cannot be stopped and thus rejoining fails. To rejoin such proxy volumes, firstly switch the boot environment using the sdxproxy Root command to free up the proxy volumes.

 

RejoinRestore

Rejoins a proxy or proxies in parted status with the master and restores the master volume data using the proxy volume data. Master volume data are restored by synchronization copying from the proxy volume to the master volume. When executing the command using this option, the master volume data are overwritten with the proxy volume data.

proxy indicates a proxy volume or a proxy group in parted status. When a proxy group is indicated, all proxy volumes in the group will be rejoined and data of the related master volumes will be restored. You can also indicate a proxy volume in parted status in a proxy group.

Synchronization copying of master to proxy volume is performed before returning from the command (when using -e waitsync, after returning from the command). When the copy functions of disk units are available, synchronization copying from masters to proxies is performed with those copy functions (except for when using -e softcopy).

When more than one proxy volume related to the same master volume is specified simultaneously, this command will result in an error.

The command will result in an error when:

• The master volume or the proxy volume is activated.

• There is a slice that is in copying process among any of the slices comprising the proxy volume or the master volume.

• Copying is in process between the master volume and the other proxy volume.

• The master volume is in INVALID status.

   

Relate

Relates and parts a pair of volumes or a pair of groups as a master and a proxy. This operation does not change data, statuses and attributes of the master and the proxy. To the related master and proxy, sessions by the copy functions of disk units are not set.

To relate a pair of volumes, the master volume and the proxy volume must be equivalent in size. Those volumes also need to be volumes that belong to different mirror groups or different single disks.

To relate a pair of groups, the volume layout (offsets and sizes) of the master group and the proxy group must be same. Those groups also need to be mirror groups.

For masters to whom proxies are already related, other additional proxies can be related. However, the number of slices comprising a master volume and all proxy volumes related to the master volume is limited to 32 in total.

Masters to whom proxies are already related cannot be related as proxies to other masters, or for proxies already related to masters, other proxies cannot be related.

This command will result in an error when:

• A slice being copied or temporarily detached exists in the master volume or the proxy volume.

• Copying is in process between the master volume and another proxy volume.

   

Restore

Copies data from a parted proxy to a master and restores contents of the master. With the OPC function, data of the proxy at the moment is copied (overwritten) to the master. The command returns control after the copying is complete (right after the copying starts when using the -e instant option and the -e nowaitsync option). If the OPC function is unavailable, the command fails.

Specify one or more proxy groups or parted proxy volumes for proxy. When proxy is a proxy group, all parted volumes within the proxy group become targets. A parted proxy volume within a proxy group can also be specified. Do not specify multiple proxy volumes related to the same master volume simultaneously.

The Restore operations can be performed even if proxy volumes are active, but it is necessary to secure consistency of data copied to master volumes in the file system layer or database layer that is managing data. For example, if the proxy volume is used as a file system, write-lock the file system with the lockfs(1M) command and then perform restoration.

This command will result in an error when:

• The master volume is active.

• A slice being copied exists in the master volume or the proxy volume.

• Copying is in process between the master volume and another proxy volume.

• A proxy volume joined to the master volume exists.

• The proxy volume is in INVALID status.

 

Root

Configures master volumes and proxy volumes specified by master,... and proxy,... for using them as file systems or swap areas in an alternative boot environment. When a master group or a proxy group is specified, all volumes that belong to the specified group will be configured.

Volumes to be used in an alternative boot environment must conform to the following conditions.

• The volumes are related directly or indirectly as the master and the proxy (alternative volumes) to volumes declared as file systems or swap areas in the /etc/vfstab file (current volumes).

• The volumes are parted.

• The access mode is "rw" (read and write).

• The volumes are in status other than INVALID (invalid data).

• The volumes are not copy destinations.

• The volumes are not running as file systems or swap areas.

It is not required to specify alternative volumes for all current volumes, but a volume to be used as the root file system in the alternative boot environment (alternative root volume) must always be specified.

Before returning from the command, the device names and the special file names contained in the /etc/system file and the /etc/vfstab file on the specified alternative root volume are changed to those for the specified alternative volume. Current volumes of which alternative boot volumes were not specified are included in /etc/vfstab on the alternative root volume without change. After parting the current root volume and the alternative root volume using the Part option, to edit /etc/vfstab on the current root volume, to edit /etc/vfstab on the alternative root volume, or to perform configuration change such as volume creation or deletion, firstly configure the alternative boot environment using this command. When executing the sdxproxy command with this option after these configurations are changed, after returning from the command, check whether contents of /etc/vfstab on the alternative root volume are correct. If an alternative volume that is a swap area used as a dump device is specified, configuration of the alternative volume for using it as a dump device takes place when starting the alternative boot environment.

For modifying the elilo.conf and fstab files on the alternative root volume, the alternative root volume is temporarily mounted on the /.GDSPROXY directory. This temporal mount point can be changed by specifying the mount point path in the environment variable PROXY_ROOT.

When alternative boot environment configuration is completed, the boot device names for the current boot environment and the alternative boot environment are output to standard output (excepting when using -e boot). Be sure to take a note of the output boot device names. By specifying the boot device name with the boot command in OpenBoot, the environment can be switched to the alternative boot environment. Similarly, by selecting the boot device name for the current boot environment, the environment can be switch back to the current boot environment. With successful boot environment switchover, the boot environment will be the default boot environment.

 

Swap

Swaps the master's slices with the proxy's slices.

proxy indicates a proxy volume or a proxy group in the joined status. A proxy volume within a proxy group cannot be specified for swapping.

You can swap the slices when master is in use.

The command will result in an error when:

• There is a slice that is in copying process among any of the slices comprising the proxy volume or the master volume.

• Copying is in process between the master volume and the other proxy volume.

• The proxy volume is in INVALID status.

• Between a master and a proxy, EC session, a BCV pair, or a SRDF pair exists.

   

Update

Copies data from a master to a parted proxy and updates contents of the proxy. With the OPC function, data of the master at the moment is copied (overwritten) to the proxy. The command returns control after the copying is complete (right after the copying starts when using the -e instant option and the -e nowaitsync option).

Updated proxy volumes become snapshots that have copies (replicas) of data of master volumes at the moment. By use of the updated proxy volumes, creating backups of master volumes at the moment and running other services become possible.

Specify one or more proxy groups or parted proxy volumes into proxy. When a proxy group is specified, all the parted proxy volumes within the proxy group become targets. A parted proxy volume within a proxy group can also be specified. Do not specify multiple proxy volumes related to the same master volume simultaneously.

The Update operations can be performed even if master volumes are active, but it is necessary to secure consistency of data copied to proxy volumes in the file system layer or database layer that is managing data. For example, if the master volume is used as a file system, write-lock the file system with the lockfs(1M) command and then perform update.

This command will result in an error when:

• The proxy volume is active.

• A slice being copied exists in the master volume or the proxy volume.

• Copying is in process between the master volume and another proxy volume.

• The master volume is in an INVALID status.

   

SUB OPTIONS

Sub options are as follows.

-a attribute=value (when using Part)

Sets attribute that is the attribute of the parted proxy volume to value. This attribute value becomes invalid when the proxy volume is rejoined to the master volume with the Rejoin or RejoinRestore option.

attribute indicates the attribute name, and value indicates the attribute value. It is necessary to separate attribute and value with an equal sign (=).

You can specify one of the following combinations to attribute and value.

pjrm=on or pjrm=off (default is on)

Sets the just resynchronization mechanism mode for proxies.

on

Turns "on" the just resynchronization mechanism mode for proxies.

off

Turns "off" the just resynchronization mechanism mode for proxies.

 

-a mvol=pvol:jrm [:pslice] [,mvol=pvol:jrm [:pslice] ,...]] (when using Join)

Indicates the proxy volume attributes.

mvol must always be followed by an equal (=) sign, and pvol, jrm and pslice are delimited by a colon (:). When indicating attributes for more than one proxy volume, combine specifiers with a comma (,) as the delimiter.

When joining a pair of groups, mvol indicates the volume name of the master volume within the master group. pvol indicates the volume name of the proxy volume that will be created in the proxy group corresponding to the master volume specified by mvol, jrm indicates the just resynchronization mechanism mode for the volume (on or off), and pslice indicates the physical slice attribute (on or off). You must specify attributes for all proxy volumes created for respective master volumes within the master group. If :pslice is omitted, the physical slice attribute of the proxy volume will be equivalent to that of the corresponding master volume.

When joining a pair of volumes, mvol indicates the volume name of the master volume, pvol indicates the volume name of the proxy volume, jrm indicates the just resynchronization mechanism mode for the volume (on or off), and pslice indicates the physical slice attribute (on or off). mvol and pvol should match with master and proxy respectively. When not using this option, the proxy volume attributes will be the same as before it was joined.

If class is the root type, "off" cannot be set to pslice.

 

-c class

class indicates the class name to which the master object or proxy object that will be the target of operation belongs

 

-e boot (when using Root)

Sets an alternative boot environment as the default boot environment. After returning from the sdxproxy command, reboot the system immediately, and the environment will be switched to the alternative boot environment.

Once the boot-device parameter is changed, the boot-device parameter values before and after changed are output to standard output. Be sure to take a note of the output values. By re-specifying the original boot-device parameter value with the eeprom(1M) command or the setenv command in OpenBoot, it is possible to restore the default boot environment from the current boot environment. Additionally, by specifying the original boot-device parameter value with the boot command in OpenBoot, it is possible to set the original current boot environment as the default boot environment again.

If the root volume's slice status is changed under synchronization copy completion or due to an I/O error, or if a GDS daemon ends abnormally and it is restarted, the boot device for the current boot environment is set as the default boot device again. Therefore, when this option is used, after returning from the sdxproxy command it is necessary to reboot the system immediately.

 

-e delay=msec (when using Join, Rejoin, RejoinRestore)

Delays the issuing of the input/output request to the disk at the time of synchronization copying between master volume and proxy volume by milliseconds, specified by msec.

This option allows users to adjust the influence on the application accessing the master volume.

When copying is performed with a disk unit's copy function, this option setting is ignored.

When this option is omitted, the delay will be set to 0.

Values from 0 to 1000 may be specified for msec.

 

-e force (when using Break)

Forcibly breaks master-proxy relationship even when copying is in process between master and proxy.

When using this option, copying process will be cancelled and the status of the proxy volume will become INVALID.

 

-e instant (when using Part)

Parts proxy volumes and creates virtual snapshots of master volumes with the OPC function even if copying from the master to the proxy is in process. After returning from the command, the parted proxy volume will become accessible before the copying is complete, and will serve as a snapshot containing data of the master volume at the time of parted. When copying is in process from proxy to master, or if a hard copy function is not available, the command will result in an error.

 

-e instant (when using RejoinRestore)

Restoration will be completed instantly, and the command will be returned. After returning from the command, synchronization copying from proxy volume to master volume will automatically begin. Although the copying is still in process, restoration will appear to be complete. After returning from the command, the master volume can be activated and accessed, before the copying is complete. Master volume data will appear to have been overwritten by the proxy volume data at the time of executing the command.

 

-e instant (when using Restore, Update)

Instantly completes restore or update and returns from the command. After returning from the command, background copying with the OPC function is performed. Before the background copying is complete, you may start the copy destination volumes for access to valid data.

 

-e mode=val (when using Part)

Indicates the access mode of the proxy volume which will be activated. val indicates either of the following options.

rw

Sets access mode for read and write.

ro

Sets access mode for read only.
Opening a read-only volume in write mode will result in an error.

Although proxy volume will be activated in the access mode specified by val, the proxy volume's access mode attribute will remain unchanged. Access mode specified by val is valid only while the proxy volume is activated ("Current Access Mode"), and will become invalid once the proxy volume is stopped. When the proxy volume is restarted, it will start in the mode set by access mode attribute ("Default Access Mode"), except for when the access mode is specified at the time of restart.

When this option is omitted, proxy volume will be activated in the access mode according to the access mode attribute set on each node.

 

-e nowaitsync (when using RejoinRestore, Restore, Update)

Returns control from the command right after copying starts. After returning from the command, wait until the copying is complete to start the copy destination volumes. To start copy destination volumes without waiting until copying is complete, use the -e instant option. When the -e instant option is specified simultaneously, this option is ignored.

 

-e restore (when using Break)

Cancels copying from a proxy to a master when such copying is in process and forces the command to break the relationship between the master and the proxy.

If copying is canceled and relationships are broken with this option, the master volumes after this operation becomes INVALID.

 

-e softcopy (when using Join, Rejoin or RejoinRestore)

The copy function of a disk unit will not be used for synchronization copying between master volume and proxy volume.

 

-e syncmode (when using Join)

When the REC function is used for synchronization copying from the master volume to the proxy volume, the transmission mode of REC is set to the synchronous transfer mode. The default is the asynchronous transfer mode. When the REC function is not used, this option setting is ignored.

 

-e unlock (when using Part)

The proxy volume will be activated regardless to whether it is locked. Lock mode will not be changed unless you change it with the sdxattr -V command.

 

-e waitsync (when using Join or Rejoin)

When performing synchronization copying, returns from the command after the copying is complete.

 

-m master (when using Join, Relate)

Specifies the master volume or the master group that is joined or related.

master indicates the volume name of the master volume, or the group name of the master group.

 

-m master,... (when using Root)

Specifies one or more master volumes or master groups as the object of the operation. When multiple volumes or groups are specified, they must be in the same class.

master indicates the name of the master volume, or the name of the master group.

To specify multiple volumes and groups, separate each name with a comma (,).

 

-p proxy (when using Break, Cancel, Join, Swap or Relate)

proxy indicates a proxy volume or a proxy group that is the target of the operation.

proxy indicates the volume name of the proxy volume, or the group name of the proxy group.

 

-p proxy,... (when using Part, Rejoin, RejoinRestore, Restore, Root or Update)

proxy indicates one or more proxy volumes or proxy groups that will be the target of the operation. When indicating more than one volume or group, they must belong in the same class.
proxy indicates the volume name of the proxy volume or the group name of the proxy group that will be the target of the operation

When indicating more than one volume name or group name, combine them with a comma (,) as the delimiter.

 

RETURNED VALUE

Upon successful completion, a value of 0 is returned.
Otherwise, a non-zero value is returned.