8 Starting and Stopping the Oracle Identity Manager Server

This chapter describes how to start and stop the Oracle Identity Manager server, and how to access the Administrative and User Console. This chapter contains the following topics:

Removing Backup xlconfig.xml Files After Starting or Restarting
Starting the Oracle Identity Manager Server
Stopping the Oracle Identity Manager Server
Accessing the Administrative and User Console
Using Diagnostic Dashboard to Verify Installation

Important:

You must complete all post-installation steps in Chapter 7, "Post-Install Configuration for Oracle Identity Manager Server and JBoss" before starting the Oracle Identity Manager Server.

Removing Backup xlconfig.xml Files After Starting or Restarting

After starting any Oracle Identity Manager component either the first time, or after changing any passwords in xlconfig.xml, passwords are encrypted and saved. However, Oracle Identity Manager also keeps a backup copy of xlconfig.xml (named xlconfig.xml.<x>) before saving. This backup xlconfig.xml.<x> file contains the passwords in plain text.

Important:

Be sure to remove these files after starting any Oracle Identity Manager component either the first time, or after restarting after changing any passwords in xlconfig.xml once you have established that the new password is working properly. The backup file is named xlconfig.xml.<x>, where x is the latest available number, for example xlconfig.xml.0, xlconfig.xml.1, and so on.

Starting the Oracle Identity Manager Server

This section describes how to start the Oracle Identity Manager server on Windows, UNIX, or Linux.

To start the Oracle Identity Manager server:

Verify that your database is up and running.
Start the Oracle Identity Manager server by running one of the following scripts appropriate for your operating system. Running the Oracle Identity Manager server start script also starts the JBoss application server.

On Windows

<XL_HOME>\xellerate\bin\xlStartServer.bat

On UNIX or Linux

<XL_HOME>/xellerate/bin/xlStartServer.sh

Stopping the Oracle Identity Manager Server

This section describes how to stop the Oracle Identity Manager server gracefully on Windows, UNIX, or Linux. To stop the Oracle Identity Manager server gracefully, you stop the JBoss application server by running one of the following scripts appropriate for your operating system.

On Windows

<JBOSS_HOME>\bin\shutdown.bat -S

On UNIX or Linux

<JBOSS_HOME>/bin/shutdown.sh -S

Accessing the Administrative and User Console

After staring the JBoss application server and Oracle Identity Manager you can access the Administrative and User Console.

To access the Administrative and User Console:

Launch your web browser, then point it to the following URL:

http://<hostname>:<port>/xlWebApp

Where <hostname> represents the name of the machine hosting the application server and <port> refers to the port on which the server is listening. The port number for JBoss is 8080.

Note:
The application name, xlWebApp, is case-sensitive.

For example:
```
http://localhost:8080/xlWebApp
```
After the Oracle Identity Manager login screen appears, login with your user name and password.

Using Diagnostic Dashboard to Verify Installation

The Diagnostic Dashboard verifies each component in your post-installation environment by testing for:

A trusted Store
Single Sign-On Configuration
Messaging capability
A task scheduler
A Remote Manager

The Diagnostic Dashboard also checks for all supported versions of components along with their packaging.

Note:

See "Using the Diagnostic Dashboard" for more information.