Creating an Administration User from the Command Line
As stated above, the user domain of the default authentication configuration must contain at least one user who is defined in CentraSite with the CentraSite Administrator role. Under certain circumstances, it might happen that such users are no longer available in the user repository, for example:
if the user repository is currently not available (e.g. LDAP Server currently unavailable);
if all of the users who have the
CentraSite Administrator role in
CentraSite have been deleted from the user repository.
In such cases, there are no users any more who can log in to CentraSite as a user with the CentraSite Administrator role, so no CentraSite administration tasks can be performed.
To resolve this problem, a mechanism is available to create a user in the user repository, assigned to the CentraSite Administrator role in CentraSite.
You can create an administration user by executing the following command in the command line interface CentraSiteCommand.cmd (Windows) or CentraSiteCommand.sh (UNIX) of Command Central. The tool is located in <SuiteInstallDir>/CentraSite/utilities.
If you start this command line tool with no parameters, you receive a help text summarizing the required input parameters.
The parameters of the command are case-sensitive, so for example the parameter -url must be specified as shown and not as -URL.
If you omit the passwords from the command, you will be prompted to provide them.
The syntax of the command is as follows:
CentraSiteCommand add Admin [-url <CENTRASITE-URL>] -user <USER-ID>
-password <PASSWORD> -domain <DOMAIN> -domainUser <DOMAIN-USER-ID>
-domainPassword <DOMAIN-PASSWORD> -organization <ORGANIZATION>
Input Parameters
The following table describes the complete set of input parameters that you can use with the add Admin utility:
Parameter | Description |
-url | The fully qualified URL (http://localhost:53307/CentraSite/CentraSite) for the CentraSite registry/repository. |
-user | The user name of a user in the user repository who has the required rights to create a new user in the user repository. |
-password | The password of the user identified by the parameter -user. |
-domain | The domain name of the user repository associated with the configuration. |
-domainUser | The user name for a new user to be created in the user repository. A user with this name will be created in CentraSite and will have the role CentraSite Administrator. |
-domainPassword | The user repository password for the user specified in domainUser. |
-organization | The organization to which the newly created CentraSite user will belong. |
Example 11. Example
CentraSiteCommand add Admin -url http://localhost:53307/CentraSite/CentraSite
-user Administrator -password manage -domain LDAPDomain -domainUser AdminUser
-domainPassword AdminPass -organization MyOrganization
