ccmadm admin_user

This topic contains information about the ccmadm admin_user command.

Synopsis

ccmadm admin_user

Description and uses

The ccmadm admin_user command changes the name of the Rational® Synergy administrator for Windows®.

Before you change the Rational Synergy administrator name, back up the databases (see Performing database integrity checks). Then, prepare the databases (ccmdb prepare_admin_user_change).

After you change the name of the Rational Synergy administrator, you must run the ccmadm config_admin command on each Windows Rational Synergy server installation.

The first time you open a database after changing the Rational Synergy administrator user name, Rational Synergy updates the ownership of the database files. This update slows the startup time. The startup time depends on the size of the database, and might be significant for large databases.

To change the password for the Rational Synergy administrator, see ccmadm password.

Options and arguments

This command has no options or arguments.

Example

The following example shows all the steps necessary to change the name of the Rational Synergy administrative user.

  1. Log on as the current Rational Synergy administrator.
  2. Back up all databases from the database server machine to an existing directory where you perform regular backups.

    > ccmdb backup \\bulldog\ccmdb\database /to d:\backup_directory

  3. Prepare the databases to accept the new Rational Synergy administrator name.
    > ccmdb prepare /d domain /u new_admin_name 
    \\bulldog\ccmdb\database

    Portions of the preparation might take some time, depending on the size of your databases. See ccmdb prepare_admin_user_change for more information.

  4. Log on as local administrator.
  5. Change the name of the Rational Synergy administrator.

    > ccmadm admin_user

    1. You are prompted to continue or exit.
    2. You are prompted to type the new admin user name.
    3. You are prompted to type the new password, and then asked to confirm it.
    4. You are prompted to exit.
  6. Set up the permissions of the local installation area so that the Rational Synergy administrator has the necessary access.
    1. Log on as local administrator.
    2. Issue this command on each relevant Windows database server.

      > ccmadm config_admin

  7. Log on as the new Rational Synergy administrator.
  8. Unprotect each database.

    > ccmdb unprotect \\database_name


Feedback