Usage
Before you run the command line tool, create a database backup.
The tool consists of an executable jar file in the bin folder of the CentraSite installation. It requires a Java 6 runtime and needs to be called in the following way:
or
For example:
java -jar ReassociateUsers.jar http://localhost:53307/CentraSite/CentraSite
DOMAIN\admin pAsSw0rD OLDDOMAIN\oldUser NEWDOMAIN\newUser
The first form (5 arguments) is for reassociating a single user, whereas the second form (4 arguments) is for reassociating multiple users in one execution of the tool.
When using the second form, the fourth argument specifies a text file that contains the user IDs. Each line of the mapping file contains one comma-separated pair of old and new user ID. A user ID must not occur more than once in these mappings.
The tool first checks for the following preconditions, which must all be met, otherwise the tool stops and no users will be reassociated:
there is a unique registry object for the old user ID
the old user ID can be uniquely identified in the security configuration
there is no registry object for the new user ID
there is no security configuration for the new user ID
the reassociated user is a login user
the reassociated user is not the
CentraSite administrator user who is running the utility
the domain of the new user ID must exist in the security configuration
a GUI configuration does not exist for the new user ID
If all preconditions are met, the tool performs the reassociation. This process may take some time. The tool progress is reported to standard output.
