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 to a single, portable file, appropriate for moving to another system. Packed files have the extension .cpk.

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

Note: 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 do so, changes to work areas must be backed up separately.

You can move a database from a UNIX server to a Windows® server by packing the database using the ccmdb pack command, and vice versa. However, you must run ccmdb upgrade -w after moving from Windows to UNIX. See Moving databases between UNIX and Windows.

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 who attempt to start a session while the pack is in progress receive a message that the database is locked.

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

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 database packed, portable file. By default, the dump file is written to the database_name.cpk file in the current directory. The archive_device argument causes the pack file to be written to the specified archive device. Also, 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