1. Upgrade Guide
  2. Upgrade Procedures
  3. Upgrading Business Operations Center

9 Upgrading Business Operations Center

Learn how to upgrade Oracle Communications Business Operations Center to the latest patch set release.

For a list of supported upgrade paths, see "Supported Business Operations Center Upgrades" in BRM Compatibility Matrix.

Topics in this document:

About Upgrading Business Operations Center

The Business Operations Center installer allows you to do a full installation of the software or to do an upgrade of the software. The installer determines which one to perform based on the Oracle_home directory specified during the installation process. If you specify an empty Oracle_home directory, the installer automatically performs a full installation. If you specify an existing Oracle_home directory, the installer automatically performs an upgrade.

During the upgrade process, the Business Operations Center installer does the following:

  • Replaces the existing Business Operations Center application WAR file that is deployed in your WebLogic application server with the latest version.

  • Copies your existing Infranet.properties file and Oracle wallet to the Domain_home directory.

  • Adds new entries to your Business Operations Center configuration files, such as bocui-config.properties and bocws-config.properties, retaining any custom values that were in the files.

  • Updates your Business Operations Center wallet, retaining any custom values that were in it.

  • Upgrades your Business Operations Center database schema to the latest patch set release.

    The Business Operations Center installer can automatically upgrade the database schema for you, or you can choose to upgrade the database schema manually at a later time. See "Upgrading Your Business Operations Center Database Schema Manually".

Downloading Business Operations Center

You can download Business Operations Center from the following locations:

Search for and download the Oracle Communications Billing and Revenue Management 12.0.0.x.0 software, where x is 0 for the 12.0 release, 1 for Patch Set 1, 2 for Patch Set 2, and so on. The package includes the BusinessOperationsCenter_generic.jar installer.

Upgrading Business Operations Center to the Latest Patch Set Release

Before you upgrade Business Operations Center, ensure that you have upgraded Oracle WebLogic Server and Oracle Database Server to the latest supported versions. For the list of supported versions, see "Business Operations Center Software Compatibility" in BRM Compatibility Matrix.

To upgrade to the latest Business Operations Center 12.0 Patch Set release:

  1. Make a backup of your existing Business Operations Center installation. If the upgrade process fails, it does not roll back any changes that it made.

  2. Verify that your Java Development Kit is installed correctly, including setting your JAVA_HOME environment variable and adding the $JAVA_HOME/bin directory in your path.

  3. Copy the required third-party libraries to the Domain_home/lib directory, where Domain_home is the WebLogic Server domain home directory of the domain in which Business Operations Center is deployed. See "Business Operations Center Software Compatibility" in BRM Compatibility Matrix for information about the required third-party libraries.

  4. Start the Oracle WebLogic Server basic domain administration server or the managed server on which Business Operations Center is deployed.

  5. Run the following command, which launches the Business Operations Center installer:

    Java_home/bin/java -jar -invPtrLoc OracleInventoryPath BusinessOperationsCenter_generic.jar

    where:

    • Java_home is the directory in which you installed the latest compatible Java version. See "Business Operations Center Software Compatibility" in BRM Compatibility Matrix.

    • OracleInventoryPath is the path to your existing Oracle Inventory location.

    The Welcome screen appears.

  6. Click Next.

    The Installation Location screen appears.

  7. In Oracle Home, enter the full path or browse to your existing Oracle_home directory for Business Operations Center. Click Next.

    Caution:

    If you enter a new Oracle Home directory, the installer does a full installation of Business Operations Center.

    The Features Sets Selection screen appears.

  8. Select Business Operation Center Components and then click Next.

    The Prerequisite Libraries Location screen appears.

  9. In the Prerequisite Libraries field, enter the full path or browse to the directory in which the ojdbc8.jar file is stored. Click Next.

    The WebLogic Server Details screen appears.

  10. Enter the details listed in Table 9-1 for the WebLogic Server domain in which Business Operations Center is deployed:

    Table 9-1 WebLogic Server Details

    Field Description

    Host Name

    The IP address or the host name of the machine on which the WebLogic Server domain is configured.

    Port Number

    The port number assigned to the WebLogic Server domain administration server.

    User Name

    The WebLogic Server domain administrator user name.

    Password

    The password for the WebLogic Server domain administrator user.

    WebLogic Home

    The path of the directory in which the WebLogic Server software is installed.

    Use SSL?

    Whether to use SSL (deselect for test installations).

    Note:

    The Business Operations Center installer will not proceed until it verifies that the information you entered is valid. The domain must be in a RUNNING state.

    The Database Connection Details screen appears.

  11. In Table 9-2, enter the database connection details for your BRM database:

    Table 9-2 Database Connection Details

    Field Description

    Host Name

    The IP address or the host name of the machine on which the BRM database is installed.

    Port Number

    The port number assigned to the BRM database.

    Service Name

    The database service name.

    User Name

    The user name for the Business Operations Center schema.

    The BOC Schema Upgrade screen appears.

  12. In the Skip Schema Upgrade checkbox, specify whether to have the installer upgrade the Business Operations Center database schema for you:

    The Installation Summary screen appears.

  13. Confirm your installation selections and then click Install.

    The installation proceeds.

  14. Click Finish to complete the installation.

Upgrading Your Business Operations Center Database Schema Manually

If you chose to skip the automatic upgrade of your Business Operations Center database schema, the installer copied the upgrade scripts and a README.txt file that explains how to perform the upgrade to your Oracle_home/scripts/upgrade directory.

To upgrade your Business Operations Center database schema manually, go the Oracle_home/scripts/upgrade directory and run this command: 

Java_home/bin/java -cp .:OJDBC_Path/ojdbc8.jar:Oracle_home/lib/BOCActions.jar com.oracle.installer.boc.BOCActions upgrade DatabaseHost DatabasePort ServiceName BOCSchemaUser BOCSchemaPassword Oracle_home

where:

  • Java_home is the directory in which you installed the latest compatible Java version. See "Business Operations Center Software Compatibility" in BRM Compatibility Matrix.

  • OJDBC_Path is the directory in which you installed the Oracle JDBC driver.

  • DatabaseHost is the IP address or the host name of the machine on which the BRM database is installed.

  • DatabasePort is the port number assigned to the BRM database.

  • ServiceName is the database service name.

  • BOCSchemaUser is the Business Operations Center database schema user name.

  • BOCSchemaPassword is the password for the Business Operations Center database schema user.