ccmdb backup

The ccmdb backup command checks and then backs up a database.

Synopsis

ccmdb backup   database_path -t|-to backup_file [-no_check]
               [-no_files][-synced_files synced_file_dir]
               [-format platform_dependent|platform_independent]

Uses

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

The output of the ccmdb backup command for Rational Synergy 7.2 is not compatible with previous version of the ccmdb backup command.

In Rational Synergy 7.2, the backup format can be restored only by using the ccmdb restore command. The backup data can only be restored using the same Rational Synergy release unless specified otherwise. The ccmdb restore command fails when the backup data is created from different releases.

If you want to use a remote secondary server for backup, you must run the ccmdb backup command on the remote secondary server machine to reduce the primary server lockout time during backup.

To ensure the reliable backups of Rational Synergy databases, run the ccmdb backup command daily.

Note: The ccmdb backup command archives information from the metadata and file systems of the database. The command does 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, you must separately back up the changes to work areas.

The database is locked during backups to prevent users from changing data in the Rational Synergy database. Users who attempt to start a 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 backup file produced by the ccmdb backup command is limited by the destination file system.

You must run the ccmdb backup command on the database server as user ccm_root. 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.
-t|-to backup_file
Specifies the name of the backup file. The default file extension for the file is .sbk. If the specified path is a directory, then the backup file is created in the specified directory using the database name and the default extension.
-no_check
Suppresses the database integrity verification. If you do not specify this option, the ccmdb check command is called, and an update statistics operation is automatically performed.
-no_file
Do not backup the file system files.
-synced_files synced_file_dir
Specifies a synced file system location. When using this option, all database files are synchronized to the target location and then backed up from that synchronized location. Although this option can require extra disk spaces, it reduces the database downtime during the backup.
-f|-format (platform_dependent | platform_independent)
Specifies the database backup format. When platform_independent is specified, the ccmdb backup command stores the data in a platform independent format so that it can be restored by the ccmdb restore command on other platforms. When the platform_dependent format is specified, the backup runs faster, but the database is only restored to the machines of the same platform with the ccmdb restore command. The default format is platform_independent.
Note: The platform_dependent format is not supported in primary or secondary server environments.

Example


Feedback