Installation Guides › Policy Server Installation Guide › Installing the Administrative UI to an Existing Application Server › How to Register the Administrative UI › Reset the Administrative UI Registration Window

Reset the Administrative UI Registration Window

If you used the XPSRegClient utility more than 24 hours ago to submit the SOA Security Manager super user credentials to the Policy Server, this step is required. The time from which you submit the credentials and attempt to create a trusted relationship with a Policy Server cannot exceed 24 hours.

Note: (UNIX) Be sure that the SOA Security Manager environment variables are set before you use XPSRegClient. If the environment variables are not set, set them manually.

To reset the registration window

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

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

   siteminder_administrator

   Specifies a SOA Security Manager administrator. If you are installing the Administrative UI as part of:

   • A new r12.1 SP3 environment, specify the default SOA Security Manager administrator account (siteminder).
   • An upgrade, specify any SOA Security Manager administrator account with super user permissions in the policy store.

   Note: If you are upgrading from r12.0 SP1 and do not have a super user account in the policy store, use the smreg utility to create the default SOA Security Manager account.

   passphrase

   Specifies the password for the SOA Security Manager administrator account.

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

   -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 SOA Security Manager 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.