11 Installing UIM Patches

This chapter describes how to install patches on Oracle Communications Unified Inventory Management (UIM).

See the patch ReadMe file, included in the patch download, for information about the contents of a patch.

About Patching UIM

UIM patches are posted on the My Oracle Support website:

https://support.oracle.com

Most UIM patches are installed using the Oracle Universal Installer. If the installer fails to install the patch, you must restore your database schema and domain, and your WebLogic Server domain.

The patch ReadMe file specifies whether to use the installer to install a patch or whether to follow other installation instructions.

Important:

Always read the patch ReadMe file in its entirety before installing a patch.

UIM patches are released as cumulative patches. This means that if there is more than one patch, the last patch will contain the changes for the other patches. For example, patch #3 will contain the changes for patch #1 and patch #2.

Some patches contain fixes and functionality that may not be of any interest to you or may apply to features that you have not installed or purchased. Read the patch ReadMe file to determine if you must install the patch.

Some patches are password protected. To request the password to download a protected patch, open a Service Request on the My Oracle Support website.

Note:

If you have multiple UIM installations on the same machine, you need to specify the appropriate UIM home details for the current installation. Perform the following:
  1. Open the installer log from the last successful installation of UIM 7.3.3.

  2. Look for the ORACLE_HOME and ORACLE_HOME_NAME entries in the installer log.

  3. Select the value for ORACLE_HOME_NAME from the drop down menu as the name in the Specify Home Details installer screen.

  4. Browse to the directory referred by ORACLE_HOME in the Specify Home Details installer screen.

Planning Your Patch Installation

Before installing a patch, verify your version of UIM and ensure the patch is not already installed.

Oracle recommends scheduling your patch installation during non-peak hours to minimize the disruption to your operations.

Ensure that UIM is not running any operations.

As a precaution against a failed patch installation, Oracle recommends that you back up your database schema for UIM, database domain for UIM, WebLogic Server domain for UIM, the UIM_Home directory, and the installer inventory directory. See UIM System Administrator's Guide for more information about backing up and restoring the database. See your WebLogic Server documentation for more information about backing up your WebLogic Server domain.

Oracle recommends installing a patch on a test system with a copy of your production data before installing the patch on your production system. Test the patch by logging into UIM and verifying the version number of installed components

Installing a Patch

To install a patch on UIM:

  1. Create a temporary directory (temp_dir).

  2. Download the patch from the My Oracle Support website:

    https://support.oracle.com

    and save it to temp_dir.

  3. Unzip the patch package and select a patch installer package based on your specific platform.

    Note:

    The package contains patch installer packages for the Linux, Solaris, and AIX platforms.
  4. Extract the contents of the installer package to temp_dir.

    The extracted software pack has the following structure:

    PatchSet-UnifiedInventoryManagement-7.3.3.0.0-version/uim/Disk1/install/

  5. Run the following command:

    /dir/PatchSet-UnifiedInventoryManagement-7.3.3.0.0-version/Disk1/install/runInstaller
    

    The JRE Location command prompt appears.

  6. Enter the path to the JRE location.

    The Oracle Universal Installer Welcome screen appears.

  7. Click Next.

    The Specify Home Details screen appears.

  8. Do the following:

    1. In the Name field, confirm the name of the folder that contains the installation files for UIM.

    2. In the Path field, confirm the directory where the folder specified in the Name field is located.

    3. Click Next.

    The installer scans the specified directory and folder and retrieves information about your UIM installation, such as connection details and user names.

    The WebLogic Administration Server Connection Information screen appears, displaying the current connection information.

  9. Do the following:

    1. In the Host Name field, confirm the IP address or host name for the server that UIM was installed on.

    2. In the Port Number field, confirm the port used by UIM.

    3. If SSL is not being used, uncheck the Use SSL? box.

    4. In the Password field, enter the WebLogic Administration server password.

    5. Click Next.

    The WebLogic Server/Cluster Selection screen appears.

    Note:

    The installer does not proceed from the WebLogic Administration Server Connection Information screen if any field contains errors.
  10. Select the same target WebLogic server or cluster of servers belonging to the WebLogic Server domain and click Next.

    If you are installing a patch on a cluster of servers, the Cluster Member Server Selection screen appears, where you can select a cluster member for UIM to patch.

    The Database Type Selection screen appears.

  11. Select the same database type that is used by your old UIM installation:

    • If your old installation is connected to a standalone database, select Standard Oracle 12c Enterprise Database and click Next.

      The Database Connection Information screen appears.

      Do the following:

      1. Verify that the retrieved field values are correct and click Next.

      2. In the Password field, enter the database server password for the user specified in the User Name field.

      3. Click Next.

      The UIM Schema User Information screen appears.

    • If your old installation is connected to an Oracle Real Application Clusters (Oracle RAC) database, select Oracle 12c Real Application Cluster Database and click Next.

      The Oracle RAC DB Nodes Connection Information screen appears.

      Do the following:

      1. Verify that the retrieved field values are correct and click Next.

      2. In the Password field, enter the database server password for the user specified in the User Name field.

      3. Click Next.

      The UIM Schema User Information screen appears.

      Note:

      The installer does not proceed from either the Database Connection Information screen or the Oracle RAC DB Nodes Connection Information screen if any field on these screens contains errors.
  12. Do the following:

    1. Verify that the retrieved value in the Schema User Name field is correct.

    2. In the Schema User Password field, enter the schema user password for the user specified in the Schema User Name field.

    3. Click Next.

    The Summary screen appears.

  13. Review the Summary screen and click Install.

    The Install screen appears, showing the status of the installation.

    When the installer completes the installation, the End of Installation screen appears. This screen provides the URLs for accessing the new release of UIM. Make a note of the URLs.

  14. Click Installed Products and verify that the patch is listed.

  15. Click Exit.

  16. It is recommended to restart the WebLogic Administration server by using the following command from within the Domain_Home/bin directory:

    ./startUIM.sh