ccmdb pack

This topic contains information about the ccmdb pack command.

Synopsis

ccmdb pack    database_path [-t|-to packfile|archive_device|-]
              [-z compress_level]

Description and uses

Use the ccmdb pack command to dump the contents of a database into a single, portable file, appropriate for moving to another system. Packed files have the extension .cpk.

The database is locked while a pack is in progress, which prevents users from changing data in the Rational® Synergy database during a pack. Users receive a message that the database is locked when they attempt to start a session while the pack is in progress.

The maximum size of a pack file produced by ccmdb pack is limited by the destination file system. On many UNIX® file systems, the maximum file size is 4 TB (Terabyte).

You must be user ccm_root to run this command.

For more information, see Database backup and Database packing.

Options and arguments

database_path

Specifies the path to the database you are packing.

-t|-to packfile|archive_device|-

Specifies the destination of the database pack file. The packfile argument is the name of the packed, portable file of the database. The default pack file path is database_name.cpk in the directory above the database_name leaf under the database_path. The archive_device argument causes the pack file to be written to the specified archive device. The "-" argument causes the pack file to be written to standard output.

-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

Generate a pack file called test_ccm.cpk in the /vol/bulldog/ccmdb directory.

$ ccmdb pack /vol/bulldog/ccmdb/test.ccm -to 
/vol/hydra/ccmdb/test_ccm.cpk

Caveats

Use the ccmdb backup command for scheduled backups.


Feedback