The ccmdb prepare_admin_user_change command prepares a database to accept a new Rational® Synergy administrator name.
Synopsis
ccmdb pauc|prepare|prepare_admin_user_change /d domain
/u user_name database_path
Uses
When the command is started, the preparations include the following:
- Databases are shut down.
- Permission of all database objects is modified to allow the new Rational Synergy administrator user name to have access.
This step might take some time, depending on the size of the database.
Run the ccmdb prepare_admin_user_change command for each database that will run under the new Rational Synergy administrator user name.
You must be logged in as the current Rational Synergy administrator to run this command.
Options and arguments
- /d domain
- Specifies the name of the domain of the Rational Synergy administrator.
- database_path
- Specifies the path to the database that you want to prepare.
- /u username
- Specifies the new name of the Rational Synergy administrator.
Example
Prepare the database \\cmserv\ccmdb\db for a new Rational Synergy administrator name with a domain of MYDOMAIN and a user name of my_cmadmin.
> ccmdb prepare /d MYDOMAIN /u my_cmadmin \\cmserv\ccmdb\db
Attention
If the Rational Synergy administrator name was changed without first preparing a database for that change, fix the permissions of the database files. Then, the new Rational Synergy administrator can take ownership of the files. Also, fix the permissions of the Informix® database so that the new Rational Synergy administrator can access the database.
The following sets of steps show you how.
To fix the permissions of the database files:
- Log on as local administrator.
- In Windows Explorer, open the properties of the database path folder.
- Select the Security tab.
You might see the following message:
You only have permission to view the current security information on dbname.
- Click OK to proceed.
- Press the Advanced button, and then select the Owner tab.
- Change the owner to Administrators. Include subcontainers.
- Click OK in the Access Control Settings dialog box, and again in the Properties dialog box.
- Open the Properties dialog box of the database path folder again.
- Select the Security tab again.
- Type the new Rational Synergy administrator name, and then grant the administrator full control.
- Click OK.
To fix the permissions of the Informix database
- Log on as user informix.
- Change directories to the informix subdirectory under the Rational Synergy installation
(cd /d %CCM_HOME%\informix).
- Run the setenv.cmd command.
- Run the dbaccess command.
- Type Q to select Query-language.
- Use the up and down arrow keys to select the database to fix, and then click Enter.
- Press N to select New.
- Type grant dba to name, where name is the Rational Synergy administrator name. (Do not include the domain.)
- Press Esc when you have finished typing.
- Press R to select Run.
The message Permission granted displays at the bottom of the screen.
- Exit dbaccess by pressing E twice.