. de IX . ds #H ((1u-(\\n(.fu%2u))*.13m) . ds ’ \k:' test veritas logo


vxsfadm-checkpoint(1M)

NAME

Checkpoint service using the vxsfadm utility.

SYNOPSIS

vxsfadm -s checkpoint -a <application-name> -o <operation>
[ -c config-file ]
[ -r Respository-host ]
[--<checkpoint_name> <value>]
[--<Application_Key> <Value>]

DESCRIPTION

The checkpoint service is used to create a point in time copy the application mounts using VxFS checkpoints.

Configuration Options

Below is an explanation of the configuration parameters supported by the checkpoint service, which can be specified in the configuration file or the environment. Also the command line options are specified for the same.
CHECKPOINT_NAME The values is the name of the checkpoint to be created. A checkpoint with the name specified is created on all application mounts.
commandline --checkpoint_name

This is not a mandatory parameter. If not specifed a checkpoint name is auto generated.

CLONE_PATH The value is the path at which the checkpoint would be mounted.
commandline --clone_path/--mount_path

This is a mandatory option.

SNAPSHOT_REMOVABLE This parameter specifies if the checkpoint created would be removable or non-removable. The value of Y would specify the checkpoint created would be of the removable type and a value of N would specify the checkpoint created would be of the non-removable type. The default value is non-removable.
commandline boolean --snapshot_removable/--removable
commandline boolean --no_snapshot_removable/--no_removable

This is not a mandatory option. The default value is non-removable.

Operations

create This operation would create a checkpoint for the specified application. If a checkpoint_name is specifed then the checkpoint would be created by the specifed name else a name would be autogenerated.

Operation alias : ckpt, checkpoint, fsckpt

Example:

vxsfadm -s checkpoint -a oracle -o create --checkpoint_name=ckpt1

mount This operation mounts the specified checkpoint to the specified clone_path. The checkpoint is mounted as read_only.

Operation alias : ckptmount

Example:

vxsfadm -s checkpoint -a oracle -o mount --checkpoint_name=ckpt1 --clone_path=/tmp/path1

mountrw This operation creates a checkpoint of the checkpoint specified and mounts the newly_created checkpoint to the specifed clone_path as read_write.

Operation alias : ckptmountrw

Example:

vxsfadm -s checkpoint -a oracle -o mountrw --checkpoint_name=ckpt1 --clone_path=/tmp/path2

This would create a new checkpoint with a name simillar to : ckpt1_rw_12345678

umount This operation unmounts the specified checkpoint. If the checkpoint is cloned and if a clone_name is specifed with this operation then that specific clone is unmounted. If no clone_name is specified then the checkpoint specified by checkpoint_name is unmounted.

Operation alias : unmount, ckptumount

Example:

vxsfadm -s checkpoint -a oracle -o umount --checkpoint_name=ckpt1

This would unmount the checkpoint ckpt1

vxsfadm -s checkpoint -a oracle -o umount --checkpoint_name=ckpt1 --clone_name-clone1

This would unmount the checkpoint ckpt1_rw_xxx using which the clone clone1 was created

destroy This operation deletes the specified checkpoint. If the checkpoint is cloned and if a clone_name is specifed with this operation then that specific clone is destroyed. If no clone_name is specified then the checkpoint specified by checkpoint_name is destroyed.

Operation alias : delete, remove, ckptremove

Example:

vxsfadm -s checkpoint -a oracle -o destroy --checkpoint_name=ckpt1

This would destroy the checkpoint ckpt1

vxsfadm -s checkpoint -a oracle -o destroy --checkpoint_name=ckpt1 --clone_name=clone1

This would destroy the checkpoint ckpt1_rw_xxx using which the clone clone1 was created

clone This operation clones the application. If a read_write checkpoint name is specified then the application specific clone routines are executed and the clone is brought up. If a read_only checkpont is specified then a read_write checkpoint is created and mounted simillar to the mountrw operation and then the applicationis cloned.

Operation alias : ckptclone

Example:

vxsfadm -s checkpoint -a oracle -o clone --checkpoint_name=ckpt1_rw_123456 --clone_name=clnone1

This would clone the checkpoint ckpt1_rw_123456 using the name specified by clone_name

vxsfadm -s checkpoint -a oracle -o clone --checkpoint_name=ckpt1 --clone_name=clone1

This would create a new checkpoint by a name simillar to ckpt1_rw_123456 and mount the same to the specified clone_path and clone the same using the name specified by clone_name.

restore The operation would restore the applicaiton files to a point in time checkpoint specified by the checkpoint_name. The files to be rolled-back are decided by the applicaiton using options defined by the application.
Note: Read write checkpoints cannot be rolled back

Example:

vxsfadm -s checkpoint -a oracle -o restore --checkpoint_name=ckpt1

This would restore the application files to the point in time specified by the checkpoint ckpt1.

SEE ALSO

vxsfadm(1M), vxsfadm-oracle(1M), vxsfadm-oracle-checkpoint(1M)

vxsfadm-flashsnap(1M), vxsfadm-sos(1M), vxsfadm-filesnap(1M) vxsfadm-oracle-flashsnap(1M), vxsfadm-oracle-sos(1M), vxsfadm-oracle-filesnap(1M)


Storage Foundation vxsfadm-checkpoint(1M)