11 Starting and Stopping the Administration Console

This chapter describes how to configure Service Broker using the Standalone and Web Administration Consoles.

Starting and Stopping the Standalone Administration Console

The Standalone Administration Console is a desktop software application provided with Service Broker.

Starting the Standalone Administration Console

To start the Standalone Administration Console:

1. Log in to the physical system where the Standalone Administration Console is installed.

   Note:

   You must be logged in as a user that has read and write privileges on the shared file system where the domain configuration for the installation you are going to use is stored.

2. Change the directory to:

   Oracle_home/ocsb60/admin_console

   Oracle_home is the Oracle Home directory you defined when you installed the product.

3. Enter:

   ./start.sh Domain_configuration_directory

   Domain_configuration_directory is the path to the domain configuration directory.

Stopping the Standalone Administration Console

To stop the Standalone Administration Console, use the Administration Console itself. See Oracle Communications Service Broker Configuration Guide.

Starting and Stopping the Web Administration Console

You can access the Web Administration Console using a standard web browser.

Starting the Web Administration Console Server

To start a Web Administration Console server:

1. Log in to the physical server where your software is installed.

   Note:

   You must be logged in as a user that has read and write privileges on the shared file system where the domain configuration for the installation you are going to use is stored.

2. Change the directory to:

   Oracle_home/ocsb60/admin_console

   Oracle_home is the Oracle Home directory you defined when you installed the product.

3. Enter:

   ./web.sh Domain_configuration_directory

   Domain_configuration_directory is the path to the domain configuration directory.

   Example:

   ./web.sh ../mydomain

4. When prompted for Username and Password, enter the authentication information to use during the Web Administration Console login procedure.

Logging In to the Web Administration Console

To log in to the Web Administration Console:

1. Open your Web browser.

2. Enter the URL:

   [https|http]://host:port/console

   • https or http depends on your security configuration. See "Enabling and Disabling SSL" in "Configuring Security Between Service Broker Components" for details.

   • host is the IP-address or host name.

   • port is the port for the Web Administration Console server. The default value for the port is 9000.

3. If it is the first time you are logging in to the Web Administration Console, you are prompted to accept the certificate provided in the keystore. This is done differently depending on which Web browser you use. It also depends on whether a self-signed certificate is used or the certificate was provided by a certificate authority.

4. When prompted, enter the user name and password.

   The authentication information must be identical to the information provided when the Web Administration Console server was started.

Stopping the Web Administration Console Server

To stop the Web Administration Console server, you can terminate the console in which it is running using the terminal interrupt command. On most systems, this command is mapped to the Control+c key sequence.

You can also stop the server by using the operating system kill command on the parent Java process for the server.

To use the kill command, you first identify the process ID of the Java container process for the Administration Console server. You then pass the ID number to the kill command.

For example, on Linux:

$ ps -A | grep java
 3276 pts/2    00:00:50 java
$ kill -9 3276

About Setting Up Security for the Web Administration Console Server Security

The Web Administration Console server authenticates with the Processing Servers and the Signaling Servers. It also authenticates with the browser that displays the Web Administration Console.

For information about setting up security for the Web Administration Console Server, see "Configuring Security Between Service Broker Components"