8 Starting and Stopping the Administration Server

This chapter describes how to configure Service Broker using the Administration Servers.

Starting and Stopping the Administration Server

You can access the Administration Server using a standard web browser. The client is the Administration Console.

Starting the Administration Server

To start an Administration 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/ocsb61/admin_server

   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 you will use to authenticate for Administration Console sessions.

Logging In to the Administration Console

To log in to the 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 the discussion on enabling and disabling SSL in Oracle Communications Service Broker Security Guide for details on system security for details.

   • host is the IP-address or host name.

   • port is the port for the Administration Server. The default value for the port is 9000.

3. If it is the first time you are logging in with the 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 Administration Server was started.

Stopping the Administration Server

To stop the Administration 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 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 Administration Server

The Administration Server supports authentication when connecting to the Processing Servers and the Signaling Servers. It also supports authenticates with a login screen when you use a browser to connect to the Administration Server.

See Oracle Communications Service Broker Security Guide for information about setting up security for the Administration Server.