Installation and Upgrade Guides › Directory Configuration Guide › Critical Path inJoin Directory Server v4.2 › Prepare for the Administrative UI Registration

Prepare for the Administrative UI Registration

You use the default SiteMinder super user account (siteminder) to log into the Administrative UI for the first–time. The initial login requires that you to register the Administrative UI with a Policy Server, which creates a trusted relationship between both components. You prepare for the registration by using the XPSRegClient utility to supply the super user account name and password. The Policy Server uses these credentials to verify that the registration request is valid and that the trusted relationship can be established.

Note: The time from which you supply the credentials to when the initial Administrative UI login occurs is limited to 24 hours. If you do not plan on installing the Administrative UI within one day, complete the following before installing the Administrative UI.

To prepare for the Administrative UI registration

1. Log into the Policy Server host system.
2. Run the following command:

   XPSRegClient siteminder[:passphrase] -adminui-setup -t timeout -r retries -c comment -cp -l log_path -e error_path -vT -vI -vW -vE -vF
   

   • passphrase

     Specifies the password for the default SiteMinder super user account (siteminder).

     Note: If you do not specify the passphrase, XPSRegClient prompts you to enter and confirm one.

   • -adminui–setup

     Specifies that the Administrative UI is being registered with a Policy Server for the first–time.

   • -t timeout

     (Optional) Specifies the allotted time from when you to install the Administrative UI to the time you log in and create a trusted relationship with a Policy Server. The Policy Server denies the registration request when the timeout value is exceeded.

     Unit of measurement: minutes

     Default: 1440 (24 hours)

     Minimum Limit: 1

     Maximum Limit: 1440 (24 hours)

   • -r retries

     (Optional) Specifies how many failed attempts are allowed when you are registering the Administrative UI. A failed attempt can result from submitting incorrect SiteMinder administrator credentials when logging into the Administrative UI for the first–time

     Default: 1

     Maximum Limit: 5

   • -c comment

     (Optional) Inserts the specified comments into the registration log file for informational purposes.

     Note: Surround comments with quotes.

   • -cp

     (Optional) Specifies that registration log file can contain multiple lines of comments. The utility prompts for multiple lines of comments and inserts the specified comments into the registration log file for informational purposes.

     Note: Surround comments with quotes.

   • -l log path

     (Optional) Specifies where the registration log file must be exported.

     Default: siteminder_home\log

     siteminder_home

     Specifies the Policy Server installation path.

   • -e error_path

     (Optional) Sends exceptions to the specified path.

     Default: stderr

   • -vT

     (Optional) Sets the verbosity level to TRACE.

   • -vI

     (Optional) Sets the verbosity level to INFO.

   • -vW

     (Optional) Sets the verbosity level to WARNING.

   • -vE

     (Optional) Sets the verbosity level to ERROR.

   • -vF

     (Optional) Sets the verbosity level to FATAL.

3. Press Enter.

   XPSRegClient supplies the Policy Server with the administrator credentials. The Policy Server uses these credentials to verify the registration request when you log into the Administrative UI for the first–time.