1. Business Operations Center Installation Guide
  2. Upgrading Business Operations Center

8 Upgrading Business Operations Center

Learn how to upgrade your Oracle Communications Business Operations Center system.

See the following topics for more information about upgrading Business Operations Center:

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

Upgrading Business Operations Center

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 BRM Compatibility Matrix.

To upgrade to the latest Business Operations Center 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 (JDK) is installed correctly. Also, set your JAVA_HOME environment variable and add 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 "Additional Billing Care, Business Operations Center, and Pipeline Configuration Center Software Requirement" 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 BRM Compatibility Matrix.

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

  6. In the Welcome window, click Next.

  7. In the Installation Location window, enter or browse to the location of your existing Oracle Home directory for Business Operations Center and then click Next.

    Caution:

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

  8. In the Features Set Selection window, select Business Operation Center Components and then click Next.

  9. In the Prerequisite Libraries Location window, enter the full path or browse to the directory in which the ojdbc8.jar file is stored and then click Next. See "Downloading the ojdbc8.jar File" for information about acquiring this file.

  10. In the WebLogic Server Details window, enter the details listed in Table 8-1 for the WebLogic Server domain in which Business Operations Center is deployed and then click Next.

    Table 8-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).

    KeyStore Type

    The type of TrustStore and KeyStore file that is used for the SSL connection: JKS or PKCS12.

    Keystore Location

    The directory in which your KeyStore file is located. This file is used for authentication through SSL.

    Keystore Password

    The password required to access the certificates from the KeyStore.

    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.

  11. In the Database User Details window, enter the details listed in Table 8-2 and then click Next.

    Table 8-2 Database User 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. For example: 1521.

    Service Name

    The database service name. For example: orcl.

    User Name

    The name of the Business Operations Center database user. For example: boc.

    Password

    The Business Operations Center user's password.

    SSL Enabled

    Select the type of connection required to connect to the database:

    • Yes-One Way: One-way SSL authentication is required.
    • Yes-Two Way: Two-way SSL authentication is required.
    • No: SSL authentication is not required.

    Store Type

    Select the type of TrustStore and KeyStore file that is used for the SSL connection: SSO or PKCS12.

    Truststore Location

    Enter or browse to the directory in which your TrustStore file is located. This file is used for authentication through SSL.

    Truststore Password

    Enter the password required to access the certificates from the TrustStore.

    Keystore Location

    Enter or browse to the directory in which your KeyStore file is located. This file is used for authentication through SSL.

    Keystore Password

    Enter the password required to access the certificates from the KeyStore.

  12. In the BOC Schema Upgrade window, do one of the following and then click Next.

    • Deselect the Skip Schema Upgrade check box: The Business Operations Center installer upgrades the database schema for you. This is the default.

    • Select the Skip Schema Upgrade check box: The Business Operations Center installer copies the database schema upgrade scripts to the Oracle_home/scripts/upgrade directory so you can upgrade the schema later. See "Upgrading Your Business Operations Center Database Schema Manually".

  13. In the Installation Summary window, confirm your installation selections and then click Install.

  14. The Installation Progress window appears. When installation completes, click Next.

    Note:

    After the installation begins, if you click Stop installation, the installation process stops, but the files that are already copied are not removed.

  15. In the Installation Complete window, 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 to 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 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.