Creating an Administration User
Pre-requisites:
To create an administration user through the CentraSite Command Line Interface, you must have the CentraSite Administrator role.
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, like the ones mentioned below there may be not be any administrator available in the user repository:
the CentraSite is freshly installed and the initial administrator must be configured.
the user repository is currently not available (for example, LDAP Server currently unavailable).
all 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.
CentraSite provides a command tool named add Admin for this purpose. The tool automatically grants the new external user the same permissions that were granted for the old external user.
To create an administration user
Run the command add Admin. The syntax is of the format: 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 |
CENTRASITE-URL | (Optional). The URL of the CentraSite registry. For example, http://localhost:53307/CentraSite/CentraSite. |
USER-ID | The user ID of a registered CentraSite user who has the CentraSite Administrator role. For example, Administrator. |
PASSWORD | The password for the registered CentraSite user identified by the parameter USER-ID. |
DOMAIN | The domain name of the user repository associated with the configuration. |
DOMAIN-USER-ID | The user name for a new user to be created in the user repository. A user with this name is created in CentraSite and have the role CentraSite Administrator. |
DOMAIN-PASSWORD | The user repository password for the user specified in DOMAIN-USER-ID. |
ORGANIZATION | The organization to which the newly created CentraSite user will belong. |
Example (all in one line):
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