activate


Prepares a database set to be replicated

Applicability

Product
Command type
MultiSite
multiutil subcommand

Platform
UNIX
Windows

Synopsis

activate [ –dbset dbset-name ] –u·ser user-name [ –p·assword ] password
–cl·an clan-name –site site-name –host hostname

Description

The activate command prepares a database set (a schema repository and its user databases) to be replicated. Before you can activate a database set, you must upgrade all user databases in the set to the same version of ClearQuest.

When you activate a database set, you give it a clan name and site name. The logical name of the database set is changed to CQMS.clan-name.site-name. After you activate a database set, it can be accessed by additional multiutil commands, and you can use the mkreplica command to replicate one or more user databases in that database set.

Note: You need to activate a database set only once, before creating the first replica.

Restrictions

You must have Super User privileges.

Options and Arguments

–dbset dbset-name
The name of the database set you want to activate. You can omit this argument if your ClearQuest installation has only one database set. The database set names are listed in the Maintenance Tool under Existing Connections.

Specifying a User Name and Password

Default
You must specify a user name and password.

–u·ser user
Name of a user with Super User privileges.

–p·assword password
Password associated with the specified user.

Specifying the Clan and Site

Default
None.

–cl·an clan-name
Name of the replica’s clan.

–site site-name
Name of the replica’s site.

Specifying the Host

Default
None.

–host hostname
Name of the synchronization server, which is the host where the storage and return bays for the replica are located. The Rational Shipping Server must be installed on the synchronization server.

Examples

In this example, the lines are broken for readability. You must enter the command on a single physical line.

See Also

mkreplica