User Admin Tool Installation - Revision history

Paul at 11:46, 16 June 2013

2013-06-16T11:46:09Z

Paul at 14:45, 1 February 2013

2013-02-01T14:45:05Z

Paul: /* Additional Information */

2013-01-21T20:50:16Z

‎Additional Information

Paul: Created page with "'''User Administration Tool Installation''' == Planing the Installation == User Administration Tool for IBM-Rational ClearQuest is a ClearQuest database. The installe..."

2013-01-18T18:48:35Z

Created page with "<big>'''User Administration Tool Installation'''</big> == Planing the Installation == User Administration Tool for IBM-Rational ClearQuest is a ClearQuest database. The installe..."

New page

<big>'''User Administration Tool Installation'''</big>

== Planing the Installation ==
User Administration Tool for IBM-Rational ClearQuest is a ClearQuest database. The installer will add a custom schema to your schema repository, create user database associated with the schema, and load all data. Before you proceed, you need to collect:
* Physical Database information of empty database (DB vendor, server, database name, database user account, and connect options). The database needs to be created in advance (unless you are going to use Microsoft Access).
* Email notification settings - SMTP server name and email user credentials (if password authentication is required with SMTP relay). You can check [[Package_configuration | Email Notification Package Configuration]] page for additional information.
* Obtain local administrative rights on the machine where you are going to perform the installation.
* Create (or use an existing) ClearQuest account with Super User right that will be used for user account management. It is recommended to use ClearQuest authentication for the account to avoid problems related to password expiration.

== Backup Schema Repository Database ==
It is always a good idea to create a backup before you making any change to the schema repository to roll back the change if necessary, and I strongly recommend to install the tool in your testing environment first: you would be able to validate that it is compatible with your environment and database vendor. It would minimize risks associated with deployment of the tool in your production environment later.

== Installing User Admin Tool ==
You can install the tool using any machine that has IBM-Rational ClearQuest installed and ClearQuest connection configured.
First, unpack User Administration Tool distribution to local or network drive (you cannot start installation from network location referenced via UNC path), and launch '''install.bat''' located in the root of the distribution.
[[File:user_admin_install.png|none]]

 On Windows 7 and Windows 2008 machines you need to select "Run as Administrator" option explicitly, and allow making changes
[[File:user_admin_install_2.png|none]]

 Login to the ClearQuest using connection (dbset) that you would like to enable for user administration using Super User account you created on the "planning..." step.
[[File:user_admin_install_login.png|none]]

 Provide required information to create ClearQuest User Administration database. Depending on your database vendor and environment, you might need to provide additional connection options. Please check ClearQuest administration manual for details. If you aborted the installation for any reason after user database was created, you would be allowed to select user database created earlier instead of creating a new one.
[[File:user_admin_db_settings.png|none]]

 Verify that you entered all information and click on "Create DB" button. The installer will start creating user database and importing all user data. There is no progress indicator, please be patient. Depending on database server load and number of user accounts the initial load might take significant time. For example, in my local environment it takes about 15 minutes to load 3000 users and groups.

When user database is created and data import is completed, the installer will offer you to configure email notification setting. Please provide required information and save settings. The installer will validate SMTP server connectivity.
[[File:user_admin_en_config.png|none]]

 It is the last step in the installation procedure, and no error occurred, you should receive the following confirmation.
[[File:user_admin_install_completed.png|none]]

 Congratulations! You have completed your installation. Log in to the ClearQuest database you created and you can start using it immediately.

== Additional Information==
The following links could be useful
* [[User_Admin_Tool_Configuration | Configuring User Administration Tool]]
* [[Managing_ClearQuest_User_Accounts | Managing ClearQuest User Accounts]].
* [http://forum.cqadmin.org/ Support forum]

[[Category:User_Admin_Tool]]

@@ Line 13: / Line 13: @@
 == Installing User Admin Tool ==
-You can install the tool using any machine that has IBM-Rational ClearQuest installed and ClearQuest connection configured.
+You can run installation of the User Administration tool on any machine that has IBM-Rational ClearQuest installed and ClearQuest connection configured.
-First, unpack User Administration Tool distribution to local or network drive (you cannot start installation from network location referenced via UNC path), and launch '''install.bat''' located in the root of the distribution.
+<br />Download and run "setup.exe", accept license agreement. If "Run User Administration DB Setup Wizard" task is selected, user administration tool setup will be launched automatically. You can setup user administration database later by using "DB Setup" wizard located in the programs menu (Programs -> CQAdmin -> DB Setup).
 <br />Login to the ClearQuest using connection (dbset) that you would like to enable for user administration using Super User account you created on the "planning..." step.

← Older revision		Revision as of 14:45, 1 February 2013
Line 42:		Line 42:
	* [http://forum.cqadmin.org/ Support forum]		* [http://forum.cqadmin.org/ Support forum]

−	[[Category:User_Admin_Tool]]	+
		+	[[Category:Rational]] [[Category:User_Admin_Tool]]

@@ Line 39: / Line 39: @@
 The following links could be useful
 * [[User_Admin_Tool_Configuration | Configuring User Administration Tool]]
-* [[Managing_ClearQuest_User_Accounts | Managing ClearQuest User Accounts]].
+* [[Managing_ClearQuest_Users | Managing ClearQuest Users]].
 * [http://forum.cqadmin.org/ Support forum]
 [[Category:User_Admin_Tool]]