ccmdb unpack

This topic contains information about the ccmdb unpack command.

Synopsis

ccmdb unpack    -| archive_device|- [-o|-overwrite]
               [-p|-space dbspace]| packfile| [-s|-server servername]
                -t|-to database_path| [-url server_url]

Description and uses

Use the ccmdb unpack command to restore a database from a pack (.cpk) file created using ccmdb pack or ccmdb backup.

After unpacking a database that was created on UNIX®, you must run ccmdb upgrade -w before using it on Windows®.

Note: After unpacking a database (particularly from a packed production database), you might need to change some of the database properties. For example, the paths to project work areas. See Rational® Synergy CLI Help for the ccm wa command for important information about changing database properties.

You must run this command on the database server, as user ccm_root. Also, the destination directory must be writable by ccm_root.

For more information, see Unpacking pack files to create databases.

Options and arguments

-

Unpacks from standard input.

archive_device

Unpacks from an archive device.

-o|-overwrite

Causes the unpacked database to write the specified database to database_path.

Use this option to disperse a large database over many drives under multiple file systems using symbolic links for the subdirectories of the database. You cannot overwrite a database if a database with the same name exists in Informix®. You can use the ccmdb drop command, and then use the -overwrite option to write out the database.

-p|-space dbspace

Specifies the name of the dbspace. By default, the ccm dbspace is used.

packfile

Unpacks from a pack file.

-s|-server servername

Specifies the database server. If you do not specify the server, the database is unpacked to the current machine if the machine is a database server. Otherwise, it is unpacked to the main server.

-t|-to database_path

Specifies the path to the database to which you are unpacking.

-url server_url

When this option is specified, the new database is assigned to the specified server. Otherwise, it is assigned to the default CCM server running on the database server machine.

Example

Unpack the training database to a new database named train71.

$ ccmdb unpack packfiles/training.cpk -t /vol/orbit1/ccmdb/train71

Unpacking database /vol/orbit1/ccmdb/train71.
Creating Rational Synergy database 
/vol/orbit1/ccmdb/train71.
Database create succeeded.
Extracting pack file 
/vol/pulsar2/ccmred/ccmred.sol/ccmred_odd/packfiles/train
ing.cpk.
Loading database.
loading Rational Synergy dump file version 7.1 platform 
UNIX ...
loading table attrib...
.................................3380 records.
loading table bind...
...343 records.
loading table bsite...
..223 records.
loading table compver...
...368 records.
loading table control...
0 records.
loading table relate...
..224 records.
loading table release...
10 records.
loading table acckeys...
22 records.
Database unpacked successfully.

Feedback