Reassociate Users
You can change the association of a CentraSite user from one external user to another. This can be necessary, for example, if the responsibility for certain CentraSite assets moves from one person to another person in the same authentication domain. By reassociating the user, you can keep the name of the CentraSite user unchanged. Another possible use would be to handle user IDs when the default domain name changes; for example, when switching from operating system authentication to LDAP authentication.
CentraSite provides a command line tool named ReassociateUsers for this purpose. The following preconditions must all be met:
There is a unique registry object for the old external user, and the old external user can be uniquely identified in the security configuration
There is no registry object or security configuration for the new external user, the domain of the new external user exists in the security configuration, and a GUI configuration does not exist for the new external user.
The reassociated user is a login user and is not the
CentraSite administrator user who is running the utility.
The tool automatically grants the new external user the same permissions that were granted for the old external user.
The tool requires a Java 6 runtime. You must belong to the CentraSite Administrator role to use the tool. Before you run the tool, create a database backup.
To reassociate one user, go to the <CentraSiteInstallDir>/bin directory and execute any one of the following commands:
C:\SoftwareAG\CentraSite\utilities>CentraSiteToolbox.cmd ReassociateUsers.jar <CentraSite DB URL> <administrator user id> <password> <old user id> <new user id>
C:\SoftwareAG\CentraSite\utilities>CentraSiteToolbox.cmd ReassociateUsers.jar <CentraSite DB URL> <administrator user id> <password> <old domain id> <new domain id>
Example:
C:\SoftwareAG\CentraSite\utilities>CentraSiteToolbox.cmd ReassociateUsers.jar http://localhost:53307/CentraSite/CentraSite DOMAIN\admin pAsSw0rD OLDDOMAIN\oldUser NEWDOMAIN\newUser
If you want to reassociate multiple users, create a text file and type one comma-separated pair of old and new external users per line. Then go to the <CentraSiteInstallDir>/bin directory and run this command:
C:\SoftwareAG\CentraSite\utilities>CentraSiteToolbox.cmd ReassociateUsers.jar <CentraSite DB URL> <administrator user id> <password> file <user mapping file path>
The reassociation may take some time. The tool’s progress is reported to standard output.
