The ccmdb backup command verifies the integrity of a Rational® Synergy database. Then, the command creates a compressed backup file (.cpk -formatfile) of a Rational Synergy database.
This command performs the same actions as running a 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 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 protected when they attempt to start a new session while a backup is in progress. 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.
The user for this command is the Rational Synergy administrator, if backing up from the command prompt.
Satisfy the following prerequisites:
database_path
Specifies the full, relative, or UNC path to the database. A full path is required if you are scheduling this command with the Scheduler.
/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.
/o|/outfile filename
Specifies the absolute path to a file, where you want the output of the command to be written. Always use this option if you schedule this command.
By default, output is written to standard output.
/t|/to packfile
Specifies the full path or the directory in which the backup file (the pack file) is created. This path must be to a directory that is regularly backed up through your normal file system backup procedure. The backup must be done to a different file system than the one on which the database resides.
> ccmdb backup \\bulldog\ccmdb\tstbill /to d:\backups
> at \\north 06:00 /every "f:\ccm\bin\ccmdb backup \\north\ccmdb\prod_db /to \\north\backup\prod_db.cpk /o \\north\backup\prod_db.out"
For a description of the AT command switches, see your Microsoft® documentation or see the help file by typing AT /?.
Do not rely on file system backup utilities alone. Use the ccmdb backup command to guarantee reliable data recovery.