5 Managing the Domain Web Server

This chapter describes how to manage the domain web server.

About the Domain Web Server

After you installed Service Broker, when you ran the domain creation script you selected how to enable the managed servers to access the domain configuration directory. You selected to use either a 1) Web server in which case the domain is called a hosted domain, or to use a 2) shared file system which creates a nonhosted domain:

A hosted domain contains a Web server that provides the managed servers in the domain either HTTP or HTTPS access to the domain configuration directory and the OSGi bundles.

In a production environment be sure either enable HTTPS, or provide backup and redundancy for the Web server and domain configuration directory.

Note:
The Administration Server requires local file system access to the domain directory because it needs write access to configuration, bundles, credential store and domain lock files.
Nonhosted domains connect to the domain configuration directory and the OSGi bundles using a shared file system not by using a Web server.

See Oracle Communications Service Broker Release Security Guide for more information about securing a domain.

If you created a hosted domain, you need to start the domain Web server.

Starting the Domain Web Server

The Domain web server must be started by a user who has read privileges to the Domain Configuration directory. See the discussion about configuring security between Service Broker components for more information about setting up user privileges.

To start the domain web server:

Open a command line shell.

Note:
You must be logged in as a user who has read privileges on the file system where the domain configuration resides.
Change the directory to:

Oracle_home/ocsb61/admin_server

Oracle_home is the Oracle home directory you defined when you installed the product.
Enter:

./host.sh directory

Replace directory with the path to the domain configuration directory.
If HTTPS is enabled, enter the keystore password.

When the domain web server is started, servers can access the domain configuration.

The port is defined in the property org.eclipse.equinox.http.jetty.http.port. The default value is 9000. See "System Administrator's Reference" for more information.

Stopping the Domain Web Server

The recommended way to stop the domain Web server of the hosted domain is to kill the process in which it is running. Refer to the documentation of your operating system for more information.