Checkpoint service using the vxsfadm utility.
vxsfadm -s checkpoint -a <application-name> -o <operation>
[ -c config-file ]
[ -r Respository-host ]
[--<checkpoint_name> <value>]
[--<Application_Key> <Value>]
The checkpoint service is used to create a point in time copy the application mounts using VxFS checkpoints.
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.
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.
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) |