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, and then create a compressed backup (.cpk) file of the database file systems and metadata. Use the -no_check option to suppress database integrity verification.

To use this command you must be logged on to the UNIX® machine that hosts the Informix® server.

This command performs the same actions as the ccmdb check command, followed by a ccmdb pack command. If the check fails, the database is still packed. The ccmdb check command also runs ccmdb update_statistics, which improves the speed of database queries.

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

The ccmdb backup and ccmdb pack commands archive information from the metadata and file systems of the database. They do not back up work areas. Users with copy-based work areas must reconcile changes before the administrator runs the backup. If you do not reconcile the changes, the changes to work areas must be backed up separately.

The database is locked during backups, which prevents users from changing data in the Rational Synergy database while a backup is being performed. Users who attempt to start a new session while a backup is in progress receive a message that the database is protected. Users already in a session being backed up cannot perform any operation 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. If you do not specify this option, ccmdb check is called, and an update statistics operation is performed automatically.

-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