Skip Headers
Oracle® Communications Service Broker Netra 6000 High Availability Manager Administrator's Guide
Release 6.0

Part Number E26770-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

11 Upgrading Service Broker Netra 6000 High Availability Manager

This chapter describes how to upgrade Oracle Communications Service Broker Netra 6000 High Availability Manager (HA Manager) software components.

About Upgrading Service Broker Netra 600 High Availability Manager Software

You can upgrade software components using the Administration Console. You can update the following components:

This chapter explains how to upgrade deployment packages only. For information about upgrading individual bundles, see the discussion on managing bundles in the Administration Console in Oracle Communications Service Broker System Administrator's Guide.

Note:

Instructions on whether to upgrade bundles individually or to upload a new Deployment Package are provided together with an upgrade patch.

About Deployment Packages

To upgrade HA Manager components, the HA Manager implements Open Services Gateway initiative (OSGi) architecture. According to this architecture, the HA Manager software is modular, grouped into replaceable deployment packages.

Each deployment package contains one or more bundles that implement a certain functionality. You manage these bundles as a unit. For example, bundles that implement the Diameter SSU are grouped into a deployment package. This enables you to install Diameter SSU bundles together as a single unit.

Deploying a particular functionality might require you to install multiple deployment packages.

You can install and uninstall deployment packages using the Administration Console. See "Upgrading the HA Manager Software" for more information.

About Installing New Deployment Packages

To add functionality, you upload the Oracle deployment package named Full Package. Full Package contains a complete set of bundles required for the new functionality.

Figure 11-1 shows how installing a Full Package with three new bundles is added to the existing deployment package of four bundles. Following the upgrade, HA Manager supports seven bundles, numbered from 1 to 7.

Figure 11-1 Adding a New Full Package

Adding a New Deployment Package
Description of "Figure 11-1 Adding a New Full Package"

About Upgrading Existing Deployment Packages

You can upgrade deployment packages in the following ways:

About Upgrading Entire Deployment Packages

To upgrade all bundles in an existing deployment package, you upload the Full Package that contains new versions of all bundles that the existing deployment package contains.

Figure 11-2 shows how installing a Full Package with three new bundle versions replaces the existing deployment package with earlier-version bundles of the same name. Following the upgrade, HA Manager supports upgraded versions of existing bundles.

Figure 11-2 Upgrading an Entire Deployment Package

Upgrading an Entire Bundle Set

About Upgrading Specific Bundles in a Deployment Package

To upgrade specific bundles in an existing deployment package, you upload the deployment package named Fix Package. Fix Package contains only the upgraded bundles. When you upload Fix Package, bundles not included in the Fix Package remain intact in the original deployment package.

Figure 11-3 shows how installing a Fix Package with new bundle versions replaces existing deployment package with earlier-version bundles of the same name. If the Fix Package does not contain a bundle with the same name as an existing bundle, the bundle remains intact in the deployment package. Following the upgrade, HA Manager supports upgraded versions of specific bundles.

Figure 11-3 Upgrading Specific Bundles in an Existing Deployment Package

Upgrading Specific Bundles

About Adding New Bundles to a Deployment Package

To add new bundles to an existing deployment package, upload the Fix Package that contains only new bundles to be added to an existing deployment package.

Figure 11-4 shows how installing a Fix Package adds two new bundles to the three bundles in the existing deployment package. Following the upgrade, HA Manager supports five bundles in the deployment package compared to three before the upgrade.

Figure 11-4 Adding New Bundles to an Existing Deployment Package

Adding New Bundles

About the Upgrade Process

The deployment package upgrade process works as follows, regardless of the upgrade type:

  1. You upload a deployment package to HA Manager using the Administration Console.

  2. HA Manager installs the deployment package on Signaling Servers or Processing Servers in the domain.

  3. You restart each Signaling Server and Processing Server in the domain for the new deployment package to take effect.

About the Managed Upgrade Window

Figure 11-5 shows the Managed Upgrade window, which you use to upgrade deployment packages.

Figure 11-5 Managed Upgrade Window

Shows the Managed Upgrade screen
Description of "Figure 11-5 Managed Upgrade Window"

The Managed Upgrade window consists of the following areas:

  • Packages List pane: Displays the Packages navigation tree which lists the installed packages.

  • Package Management pane: Displays the name and version of the bundle or package selected in the Packages List pane.

  • Uploading Packages area: Use this field to locate a package on a local drive and install the package on HA Manager.

Upgrading the HA Manager Software

You can manage HA Manager software upgrades by performing the following actions:

Installing a Deployment Package

You can install new deployment packages and upgrade existing deployment packages by uploading packages to HA Manager using the System Administration Console. The procedure for installing Full Packages and Fix Packages is the same. After a package is installed, you restart the servers for the installation to take effect.

To install a deployment package:

  1. On the System Administration Console toolbar, click Lock & Edit.

    You can now make changes in HA Manager configuration settings.

  2. On the toolbar, click Switch to Offline Mode and then click OK in the confirmation window.

    Note:

    You can install deployment packages in offline mode only.
  3. Click the Managed Upgrade tab.

  4. Click Browse.

    The Upload File dialog box appears.

  5. Click Browse.

    The File Upload dialog box appears.

  6. Navigate to the directory that contains the deployment package you want to install and click Open.

  7. Click Upload.

    A message confirming that the package was successfully uploaded appears.

  8. Click OK.

  9. In the Managed Upgrade window, click Install / Update to install the package that you uploaded.

    HA Manager installs the deployment package on the servers.

  10. Restart the Signaling Servers and Processing Servers for the uploaded deployment package to take effect.

    See "Managing and Monitoring Hardware and Processes" for information about restarting servers.

Upgrading adds or updates packages based on the type of package you uploaded:

  • If you installed a Full Package, and a Deployment Package with the same name does not exist, the Deployment Package is installed as a new package.

  • If you installed a Full Package, and a Deployment Package with the same name already exists, all bundles of the existing package are replaced with the bundles from the uploaded Full Package.

  • If you installed a Fix Package, existing bundles are updated or new bundles are added to an existing package.

See "About Installing New Deployment Packages" and "About Upgrading Existing Deployment Packages" for more information about types of Deployment Package updates.

Uninstalling a Deployment Package

You can uninstall existing deployment packages using the Administration Console. After a package is uninstalled, you must restart servers for the new configuration to take effect.

To uninstall a deployment package:

  1. On the Administration Console toolbar, click Lock & Edit.

    You can now make changes to HA Manager configuration settings.

  2. On the toolbar, click to Switch to Offline Mode and then click OK in the confirmation window.

    Note:

    You can uninstall Deployment Packages in offline mode only.
  3. In the Packages navigation tree, select a package to uninstall.

    Note:

    You can use the Managed Upgrade window to uninstall packages only. You cannot uninstall individual bundles. For instructions on uninstalling individual bundles, see the discussion on managing domain bundles in Oracle Communications Service Broker System Administrator's Guide.
  4. In the Package Management pane, click Uninstall.

    The Uninstall Package progress bar appears. After HA Manager uninstalls the package from the Signaling Servers and Processing Servers the Packages tree is refreshed to display the updated list of packages.

  5. Restart the Signaling Servers and Processing Servers for the new configuration to take effect.

    See "Managing and Monitoring Hardware and Processes" for information about restarting servers.

Handling Errors During Installation or Uninstallation

If installation or uninstallation fails (for example, when a server on which HA Manager tries to install a deployment package is unavailable), HA Manager displays an error message in the Administration Console and restores the previous version of the deployment package.

Upgrading the Operating System

You can upgrade the operating system on the Bootstrap Blades and the Worker Blades. To automate the upgrade process, Oracle provides upgrade patches that contain all files required for the upgrade:

Note:

During the upgrade process, the upgrade script merges existing RPM files with newer versions of these files. If you made any changes in the RPM files, the upgrade script might be unable to merge these files with their new versions. In this case, the script does the following:
  • For the new version of the RPM file, the script creates the file with the rpmnew extension

  • For the file modified by you, the script creates the file with the rpmsave extension

Although the upgrade script can automatically detect these cases, you need to manually resolve the conflicts. For more information, see the installation notes provided with the upgrade patch.

Upgrading the Operating System on the Bootstrap Blades

You can upgrade the operating system only on secondary Bootstrap Blades. (See "Primary and Secondary Bootstrap Blades" for more information about primary and secondary Bootstrap Blades. After you complete the upgrade, you can switch the Bootstrap Blade from secondary to primary.

To upgrade the operating system on the Bootstrap Blades:

  1. In a Linux command-line interface, log in to the server on which the Bootstrap Blades are installed.

  2. Check the current status of the Bootstrap Blades by entering the following command in the shell:

    clustat

    The following information is returned:

    • IP addresses of the Bootstrap Blades that the cluster contains

    • ID and status of each Bootstrap Blade

    • Services on the Bootstrap Blades and the state of these services. The Bootstrap Blade that contains a service with a state of Started is the primary Bootstrap Blade.

    For example:

    [root@bootstrap1 ~]# clustat
    Cluster Status for ocsba @ Tue Dec 28 07:56:28 2010
    Member Status: Quorate
    Member Name                             ID   Status
    ------ ----                             ---- ------
    192.168.1.1                               1 Online, Local, rgmanager
    192.168.1.2                               2 Offline
    
    Service Name                   Owner (Last)                   State
    ------- ----                   ----- ------                   -----
    service:ip                     192.168.1.1                    started
    
  3. Make the primary Bootstrap Blade the secondary blade by entering the following command:

    service rgmanager restart

    The service parameter specifies the name of the service that runs on the primary Bootstrap Blade. For example:

    ip rgmanager restart

    The primary Bootstrap Blade is now in the secondary state.

  4. Unpack and run the upgrade patch that you received from Oracle, as described in the upgrade patch documentation.

Upgrading the Operating System on the Worker Blades

You can upgrade the operating system using the upgrade script that you received with the upgrade patch.

To upgrade the operating system on the Worker Blades:

  1. Copy the RPM files that the upgrade package contains to the RPM repository at /var/ocsb/ramdisk/rpm.

  2. Run the RAM disk upgrade script as described in the upgrade patch documentation.

    The script rebuilds the RAM disk image based on the RPM files that you copied to /var/ocsb/ramdisk/rpm.

  3. Enter your root and ocsb password when prompted.

    The resulting RAM disk image is copied to the TFTP directory.

  4. Reboot all Worker Blades as specified in the patch documentation.

    The Worker Blades load the new RAM disk image from the TFTP directory.