convertuserdb

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

Applicability

Platform: Windows®

Command type: importutil 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 command copies a user database to create a sample database for testing the upgrade process. The convertuserdb subcommand locks the production database before copying it. The installutil convertsuserdb command does the following:
  • Copies the original database to a new database.
  • Connects Rational ClearQuest to the database copy.
  • Locks the original database.

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

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
[tcpip,ipx,netbios, namedpipes]
These are optional parameters to specify networks.
[host1,host2,...]
These are optional parameters to identify multiple host machines.

For vendor-specific values, see ../../com.ibm.rational.clearquest.admin.doc/topics/c_vend_db_props.htm.

Examples

See also

unlockuserdb , convertschemarepo


Feedback