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 (for example, 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 CentraSite. The tool is located in the directory <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.
If you omit the passwords from the command, you will be prompted to provide them.
The syntax of the command is as follows:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd add Admin [-url <CENTRASITE-URL>] -user <USER-ID> -password <PASSWORD> -domain <DOMAIN> -domainUser <DOMAIN-USER-ID> -domainPassword <DOMAIN-PASSWORD> -organization <ORGANIZATION>
The input parameters are:
Parameter | Description |
-url | (Optional) The URL of the CentraSite registry. Default value is http://localhost:53307. |
-user | The user ID of a registered CentraSite user. For example, a user who has the CentraSite Administrator role. |
-password | The password for the registered CentraSite 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:
C:\SoftwareAG\CentraSite\utilities>CentraSiteCommand.cmd add Admin -url http://localhost:53307/CentraSite/CentraSite -user Administrator -password manage -domain LDAPDomain -domainUser AdminUser -domainPassword AdminPass -organization MyOrganization
The response to this command could be:
Executing the command : add Admin
Successfully executed the command : add Admin
