12 Maintaining Oracle Communications Service Broker

This chapter describes how you maintain your deployment and perform housekeeping.

Backing Up Your Installation

Backup can be done on a set of different levels:

Processing Server and Signaling Server
Administration client
Domain configuration

Backing Up a Processing Server or a Signaling Server

To back up a Processing Server or a Signaling Server, back up all the files located in the following directory:

Oracle_home/ocsb61/managed_server

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

You should perform a backup immediately after installing, upgrading, or adding a patch to your Processing Server or Signaling Server.

See "Archiving and Cleaning Up Log Files" for information on backing up log files.

Backing Up an Administration Client

Backing up an administration client involves backing up the following:

The Administration Server
The Scripting Engine

To back up an administration client, back up all the files located in the following directory:

Oracle_home/ocsb61/admin_server

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

You should perform a backup immediately after installing, upgrading, or adding a patch to your administration client.

See "Archiving and Cleaning Up Log Files" for information on backing up log files.

Backing Up a Domain Configuration

To back up your domain configuration, back up all the files in your domain configuration directory. This directory was defined when you created the domain.

Perform backups on a regular basis and always immediately after:

Updating or changing any configuration
Adding or removing a Processing Server or Signaling Server from your installation
Upgrading a Processing Server or Signaling Server
Adding a patch to a Processing Server, Signaling Server, or an administration client

Backing Up Oracle Home

To back up your full Oracle home, back up all files and directories under Oracle_home.

Oracle_home is the Oracle home directory you defined when you installed Service Broker.

Processing Servers, Signaling Servers, and administration client installations, including log files, are also backed up when you back up Oracle_home.

Domain configurations are backed up if they are stored in an Oracle_home subdirectory.

Archiving and Cleaning Up Log Files

Log files are stored in the file system of your servers and administration clients.

You should archive and clean up your log files on a regular basis.

Log files for servers are by default stored directly under the directory:

Oracle_home/ocsb61/managed_server

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

Log files for the administration clients are by default stored under the directory:

Oracle_home/ocsb61/admin_server

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

Log files are stored using a roll-over pattern.

The file currently in use, current_log_file is named:

server.log for Processing Servers and Signaling Servers
console.log for administration clients

When current_log_file reaches a given size, the suffix .sequence_number is added to the file name and a new current_log_file is created. The suffix .sequence_number is a sequence number that is increased each time the file is rolled-over.

Log files with the suffix sequence_number can be archived for future reference and deleted. The roll-over occurs when the log file reaches a size of 100 KB.

The default log files are controlled by the configuration file named log4j.xml located in the directory:

Processing Servers and Signaling Servers: managed_server
Administration clients: admin_server

These directories are located under:

Linux and Solaris: Oracle_home/ocsb61

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

log4j.xml is a standard Log4J configuration file that can be changed to suit your needs. For detailed information on Log4J and the configuration file, see Log4J documentation at:

http://logging.apache.org/log4j/

About Patches and Patch Sets

A patch is always associated with a specific OSGi bundle, whereas a patch set is not associated with one specific bundle and might contain a collection of unrelated patches. A patch or patch set can be targeted to a specific bundle or to a server. The delivery format is ZIP files.

The patches and patch sets are either delivered with a bundled copy of Oracle Universal Installer or as a input file to be used with a standard installation of Oracle Universal Installer.

Instructions are shipped with the patch or patchset.

Managing Domain Bundles

The settings of each OSGi Bundle identify the bundle in the domain.

Table 12-1 describes OSGi Bundle properties.

Table 12-1 OSGi Bundle Properties

Property	Description
Name	Symbolic name of the OSGi bundle. Format: Alpha-numeric characters. Case sensitive. No spaces in the name.
Version	Version number of the bundle. Format: Alpha-numeric. IP-address form or DNS name format.
State	The state of the bundle: Installed Prepare Start Start
Start Level	OSGi start level of the bundle Format: Numeric

The following sections describe how you can manage OSGi bundles with the Administration Console and Java MBeans.

Managing Bundles with the Administration Console
Managing Bundles with the DeploymentServiceMBean

Managing Bundles with the Administration Console

To access the Bundles Configuration screen:

In the domain navigation pane, expand OCSB and do one of the following:
- Expand Signaling Tier and then expand Domain Management
- Expand Processing Tier and then expand Domain Management
Select Packages.

The Packages configuration pane displays the properties described in Table 12-1.

Typing a package name into the Filter field displays a filtered list of packages.

Installing a Bundle

Before you install a bundle in the domain, you must extract a copy of the bundle in the Domain Configuration Directory.

To install a bundle:

In the Bundles screen, click Install.

The Install dialog box is displayed.
In the Location column, type the location from where you extracted the bundle.
In the Start Level column, type a digit to indicate the level, then click Apply.

The new OSGi Bundle now appears in the Bundle list.

Uninstalling a Bundle

Before you uninstall a bundle, you must stop the bundle. See "Stopping a Bundle" for instructions.

To uninstall a bundle:

From the Bundle list, select the check box corresponding to the bundle you want to uninstall.
Click Uninstall.

The selected OSGi Bundle is removed from the list. The bundle is not deleted from the Configuration Directory.

Starting a Bundle

To start a bundle:

In the Bundle list, select the check box corresponding to the bundle you want to start.
Click Start.

Stopping a Bundle

To stop a bundle:

In the Bundle list, select the check box corresponding to the bundle you want to stop.
Click Stop.

Managing Bundles with the DeploymentServiceMBean

You can manage OSGi Bundles through JMX using the DeploymentServiceMBean, which exposes operations for installing and deploying these bundles.