convertuserdb

Copies existing user databases and connects them to Rational® ClearQuest®.

Applicability

Platform: Windows®

Command type: installutil subcommand

Synopsis

installutil convertuserdb

[ -dbset dbset_name] cq_login cq_password user_dbname to_user_db_vendor to_user_server to_user_database to_user_dbo_login to_user_dbo_password connect_options[tcpip,ipx,netbios, namedpipes] [host1,host2,...]

Description

The installutil convertuserdb subcommand copies a user database to create a sample database for testing the upgrade process. This command performs the following actions:
  • Locks the production database before copying it.
  • Copies the original database to a new database.
  • Connects Rational ClearQuest to the database copy.

Use the installutil unlocksuserdb command to unlock the production database and allow users to continue using the database while you test the copy.

Options and arguments

dbset_name
The name of the existing connection.
cq_login
The user login name to ClearQuest databases that you want to copy. The user must have Super User privileges.
cq_password
The login password for the ClearQuest Super User.
user_dbname
The name of the user database that you want to convert.
to_user_db_vendor
The new upgrade vendor database name.
to_user_server
The new upgrade user database server name.
to_user_database
The new upgrade user database name.
to_user_dbo_login
The login name of the empty database owner.
to_user_dbo_password
The login password of the empty database owner.
connect_options
Optional parameters, which vary by database vendor.

See Vendor database properties.

[tcpip,ipx,netbios, namedpipes]
These are optional parameters to specify networks.
[host1,host2,...]
These are optional parameters to identify multiple host machines.

Examples

See also

unlockuserdb , convertschemarepo


Feedback