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 <CentraSiteInstallDir>/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".
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>
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. |