9 Upgrading and Patching

This chapter describes how you upgrade your installation and how to apply patches. It also describes the DeploymentServiceMBean.

About Patches and Patch Sets
Overview of Performing an In-Production Upgrade
Applying Patches for Bundles
Applying Patches for Servers
DeploymentServiceMBean

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 may 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.

Overview of Performing an In-Production Upgrade

An in-production upgrade means that Oracle Communications Service Broker is upgraded while continuing to process requests. Servers are upgraded one at a time, in sequential order, until all servers have been upgraded. Service Broker continues to process requests during the upgrade.

During the upgrade procedure, all servers except the server currently being upgraded continues to process traffic. During the upgrade procedure one set of servers is still on pre-upgrade level, while another set is on post-upgrade level.

To perform an in production upgrade:

Backup your Processing Servers, Signaling Servers, and domain configurations prior to performing an upgrade, see Chapter 10, "Maintaining Oracle Communications Service Broker".
If the patch is for a bundle, apply the patch on the domain configuration. See "Applying Patches for Bundles".
If the patch is for a server, apply the patch on each server. See "Applying Patches for Servers".
On each server:

Perform a controlled shutdown of the server and start it again. See Chapter 2, "Starting and Stopping Processing Servers and Signaling Servers".

Applying Patches for Bundles

To install a patch or a patch set for a bundle:

Login to the computer where the Administration Console is installed.
Unzip the ZIP file for to the directory patch_directory.

where patch_directory can be any directory.
If the patch or patch set is bundled with Oracle Universal Installer:
1. In a command shell, navigate to the installer directory:
  
  patch_directory/Disk1/install
2. Enter the following command to launch the installer:
  
  ./runInstaller.sh
  
  The Oracle Universal Installer is launched in graphical mode.
If the patch or patch set is not bundled with Oracle Universal Installer:
1. Start a local copy of Oracle Universal Installer.
2. In Oracle Universal Installer, open the file
  
  patch_directory/Disk1/install/product.xml
Follow the instructions in the installer. Use the same Oracle_home as when you installed Oracle Communications Service Broker.

When the installer is finished, the patch bundle(s) are installed to the directory:

Oracle_home/patch
Set the domain configuration to offline by setting the attribute OffLine on the DomainServiceMBean to true. See Chapter 6, "Managing Domains".
Uninstall the bundle(s) to update using the operation uninstallBundle in DeploymentServiceMBean method. See "DeploymentServiceMBean".
Install the updated bundle(s) using the operation installBundle in DeploymentServiceMBean. See "DeploymentServiceMBean".

Now the domain configuration is updated and the next step is to apply the updated configuration to the servers in the domain by restarting them one by one.

Applying Patches for Servers

To install a patch or a patch set for a server:

Login to the computer where the server to be patched is installed.
Unzip the ZIP file for to the directory patch_directory.

where patch_directory can be any directory.
If the patch or patch set is bundled with Oracle Universal Installer:
1. In a command shell, navigate to the installer directory:
  
  patch_directory/Disk1/install
2. Enter the following command to launch the installer:
  
  ./runInstaller.sh
  
  The Oracle Universal Installer is launched in graphical mode.
If the patch or patch set is not bundled with Oracle Universal Installer:
1. Start a local copy of Oracle Universal Installer.
2. In Oracle Universal Installer, open the file
  
  patch_directory/Disk1/install/product.xml
Follow the instructions in the installer. Use the same Oracle_home as when you installed Oracle Communications Service Broker.

When the installer is finished, the server is updated with the patch or patch set. The server needs to be restarted.

Deployment Service MBean

The Deployment service MBean exposes operations for installation and deployment of OSGi bundles.

The following sections provide reference information for the Deployment service MBean.

DeploymentServiceMBean

The DeploymentServiceMBean provides operations for OSGi bundle management.

JAR File

oracle.axia.deployment.adminservice.api-version.jar

where version is the version number of the JAR file: for example, 1.0.0.0.

Package

oracle.axia.api.management.deployment

Object Name

oracle:type=oracle.axia.api.management.deployment.DeploymentServiceMBean

Factory Method

Created automatically.

Attributes

None

Operations

String[] deployBundle(String bundleLocation, int startLevel)

Installs and starts an OSGi bundle.

Parameters:

bundleLocation Path to the bundle to deploy.
startLevel OSGi start level of the bundle.

String[] installBundle(String bundleLocation, int startLevel)

Installs an OSGi bundle.

Parameters:

bundleLocation Path to the bundle to deploy.
startLevel OSGi start level of the bundle.

List<Map<String,Serializable>>listDeployedBundles()

List a all deployed OSGi bundles.

void startBundle(String bundleName, String bundleVersion)

Starts an OSGi bundle.

Parameters:

bundleName Symbolic name of the OSGi bundle.
bundleVersion Version of the bundle.

void stopBundle(String bundleName, String bundleVersion)

Stops an OSGi bundle.

Parameters:

bundleName Symbolic name of the OSGi bundle.
bundleVersion Version of the bundle.

void undeployBundle(String bundleName, String bundleVersion)

Undeploys an OSGi bundle.

Parameters:

bundleName Symbolic name of the OSGi bundle.
bundleVersion Version of the bundle.

void uninstallBundle(String bundleName, String bundleVersion)

Uninstalls an OSGi bundle.

Parameters:

bundleName Symbolic name of the OSGi bundle.
bundleVersion Version of the bundle.

void updateBundle(String bundleName, String bundleVersion, String bundleLocation)

Updates an installed OSGi bundle with a bundle stored on the file system.

Parameters:

bundleName Symbolic name of the OSGi bundle.
bundleVersion Version of the bundle.
bundleLocation Path to the update OSGi bundle.