ccmdb backup

This topic contains information about the ccmdb backup command.

Synopsis

ccmdb backup database_path [-no_check]
             [-z compress_level] -t|-to destination_dir|archive_device|-

Description and uses

Use the ccmdb backup command to verify the integrity of a Rational® Synergy database, then create a compressed backup (.cpk) file of the database file systems and metadata. Use the -no_check option to suppress database integrity verification.

Note: This command performs the same actions as the ccmdb check command, followed by a ccmdb pack command. If the check fails, the database still is packed.

Run the ccmdb backup command daily to ensure reliable backups of Rational Synergy databases.

The database is locked during backups, which prevents users from changing data in the Rational Synergy database while a backup is being performed. Users receive a message that the database is locked when they attempt to start a new session while a backup is in progress. Any attempt to update the database hangs the session until the backup is completed.

The maximum size of a pack file produced by ccmdb backup is limited by the destination file system.

For more information, see Database backup and Database packing.

You must run this command on the database server, as user ccm_root, and the destination directory must be writable by ccm_root.

Options and arguments

database_path

Specifies the full path to the database you are backing up.

-no_check

Suppresses the database integrity verification.

-t|-to destination_dir|archive_device|-

Specifies the destination of the database backup. You can dump to a pack (.cpk) file, to a directory, to an archive device, or to standard output ("-"). If you dump to a directory, the pack file is named database_name.cpk.

Create the backup file in a directory that is backed up regularly through normal file system backup procedures. Or at least in a directory on an independent file system.

-z compress_level

Specifies the level of compression of the packed file. Values range from 1 (the least, but fastest compression) to 9 (the most, but slowest compression). The default setting is 6.

Example

Back up a database named tstbill to an existing directory called backups where you perform regular backups.

$ ccmdb backup /data/cw_databases/tstbill -to 
/vol/hydra1/backups

Feedback