1. PDC Installation Guide
  2. Pricing Design Center Patch Set Installation
  3. Installing the Patch Set on an Existing Pricing Design Center Installation

10 Installing the Patch Set on an Existing Pricing Design Center Installation

Learn how to install patch sets on top of your existing Oracle Communications Pricing Design Center (PDC) installation.

Note:

Make a backup of your PDC_home and PDC_BRM_home directories before proceeding with the patch set installation.

Topics in this document:

Upgrading both PDC and the BRM Integration Pack Patch Set

Note:

If you have an existing installation of PDC integrated with Oracle Communications Billing and Revenue Management (BRM), you must upgrade BRM before upgrading the PDC installation.

To install PDC and the BRM Integration Pack patch set on an existing PDC 12.0 installation:

  1. Download and install a full version of the PDC 12.0 Patch Set software from the Oracle software delivery website (https://edelivery.oracle.com).

    Search for and download the Oracle Communications Pricing Design Center 12.0.0.x.0 software, where x is 1 is for Patch Set 1, 2 is for Patch Set 2, and so on. The Zip archive includes the pdcserver-12.0.0.x.0_generic_full.jar file for performing a full installation of a PDC 12.0 Patch Set.

  2. Start the Oracle WebLogic Server domain administration server or the WebLogic Server domain managed server on which PDC 12.0 was deployed, if it is not already started.

  3. Ensure that the PDC database is running.

    Note:

    Ensure that the Oracle Database server is in Running state. The Installer connects to the Oracle Database server to verify the information you entered is valid.

    Take a backup of PDC database before proceeding with the patch set installation.

  4. Go to the temp_dir directory, and run one of the following commands:

    • To start the GUI installer:

      Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar

      where:

      • Java_home is the directory in which you installed the latest supported Java version.

      • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    • To start the GUI installer and create a silent installer response file during the installation:

      Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar -record -destinationFile path

      where:

      • path is the response file location and name.

      • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    The Welcome screen appears.

  5. Click Next.

    The Installation Location screen appears.

  6. Enter the full path to the directory in which you installed PDC 12.0.

  7. Click Next.

    The PDC Wallet Details screen appears.

  8. Enter the following information required for accessing the PDC wallet:

    1. In the Wallet Location field, enter the path or browse to the directory in which the PDC wallet is located.

    2. In the Wallet Password field, enter the PDC wallet password.

  9. Click Next.

    The PDC WebLogic Server screen appears.

  10. Enter the following details for the WebLogic Server domain in which you want to deploy PDC:

    1. In the Host Name field, enter the IP address or the host name of the machine on which the WebLogic Server domain is configured.

    2. In the Port Number field, enter the port number assigned to the WebLogic Server domain administration server.

    3. In the User Name field, enter the WebLogic Server domain administrator user name.

    4. In the Password field, enter the WebLogic Server domain administrator user password.

    5. In the WebLogic Home field, enter the path to the directory in which the WebLogic Server software is installed. For example, Middleware_home/wlserver.

    6. To enable secure communication for PDC, select the Enable SSL? (Recommended) check box, and in the KeyStore Location field, enter the path of the client-side KeyStore file generated from the exported public certificate using the keytool utility.

      For more information, see "Configuring SSL for the WebLogic Server Domain".

    7. To allow the import and export of large XML files into PDC, select Apply WebLogic tuning parameters. For information about the WebLogic tuning parameters, see the installer Help.

      Note:

      If you select this check box, you must restart the WebLogic Server domain after PDC installs successfully.

  11. Click Next.

    • If you are installing PDC 12.0 or 12.0 Patch Set 1, the BRM Integration Pack Wallet Details screen appears. Proceed to step 14.

    • If you are installing PDC 12.0 Patch Set 2, the BRM Integration Pack Pre-requisite Libraries Location screen appears.

  12. In the OJDBC Location field, enter the full path or browse to the directory in which the OJDBC jar is located.

  13. Click Next.

    The BRM Integration Pack Wallet Details screen appears.

  14. Enter the following details for the BRM Integration Pack wallet:

    1. In the Wallet Location field, enter the path to the directory in which the BRM Integration Pack wallet is located.

    2. In the Wallet Password field, enter the BRM Integration Pack wallet password.

  15. Click Next.

    The Installation Summary screen appears.

  16. Review the selections you have made in the preceding screens, and click Install.

    The Installation Progress screen appears.

    Note:

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

  17. When the installation is done, click Next. The Installation Complete screen appears.

    Note down the provided URL. You use this URL to access PDC.

  18. Click Finish to complete and exit.

  19. If you selected Apply WebLogic tuning parameters, you must restart the WebLogic Server domain.

See "Verifying the Pricing Design Center Installation" for information on verifying the successful installation of PDC.

See "About Installation Logs" for information on PDC Installer logs.

Upgrading Only the PDC Patch Set

To install the PDC patch set on an existing PDC 12.0 installation:

  1. On the server on which PDC 12.0 is installed, create a temporary directory (temp_dir).

  2. Go to the My Oracle Support website (http://support.oracle.com).

  3. Sign in with your user name and password.

  4. Click the Patches & Updates tab.

  5. From the list, select Patch Name or Number.

  6. In the text field, enter the patch number.

  7. Click Search.

    The Patch Search page appears.

  8. Click the Patch Name or Number.

    The patch details appear.

  9. From the Platform list, select the platform and click Download, where platform is linux or solaris.

    The File Download dialog box appears.

  10. Download the appropriate pPatchNumber_PatchVersion_Generic.zip file to temp_dir.

  11. Unzip the pPatchNumber_PatchVersion_Generic.zip file.

    The Zip file includes the pdcserver-12.0.0.x.0_generic.jar file. For example, pdcserver-12.0.0.1.0_generic.jar for PDC 12.0 Patch Set 1 and pdcserver-12.0.0.2.0_generic.jar for PDC 12.0 Patch Set 2.

  12. Start the Oracle WebLogic Server domain administration server or the WebLogic Server domain managed server on which PDC 12.0 was deployed, if it is not already started.

  13. Ensure that the PDC database is running.

    Note:

    Ensure that the Oracle Database server is in Running state. The Installer connects to the Oracle Database server to verify the information you entered is valid.

  14. Go to the temp_dir directory, and run one of the following commands:

    • To start the GUI installer:

      Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar

      where:

      • Java_home is the directory in which you installed the latest supported Java version.

      • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    • To start the GUI installer and create a silent installer response file during the installation:

      Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar -record -destinationFile path

      where:

      • path is the response file location and name.

      • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    The Welcome screen appears.

  15. Click Next.

    The Installation Location screen appears.

  16. Enter the full path to the directory in which you installed PDC 12.0.

  17. Click Next.

    The PDC Wallet Details screen appears.

  18. Enter the following details for the PDC wallet:

    1. In the Wallet Location field, enter the path or browse to the directory in which the PDC wallet is located.

    2. In the Wallet Password field, enter the PDC wallet password.

  19. Click Next.

    The PDC WebLogic Server screen appears.

  20. Enter the following details for the WebLogic Server domain in which you want to deploy PDC:

    1. In the Host Name field, enter the IP address or the host name of the machine on which the WebLogic Server domain is configured.

    2. In the Port Number field, enter the port number assigned to the WebLogic Server domain administration server.

    3. In the User Name field, enter the WebLogic Server domain administrator user name.

    4. In the Password field, enter the WebLogic Server domain administrator user password.

    5. In the WebLogic Home field, enter the path to the directory in which the WebLogic Server software is installed. For example, Middleware_home/wlserver.

    6. To enable secure communication for PDC, select the Enable SSL? (Recommended) check box, and in the KeyStore Location field, enter the path of the client-side KeyStore file generated from the exported public certificate using the keytool utility.

      For more information, see "Configuring SSL for the WebLogic Server Domain".

    7. To allow the import and export of large XML files into PDC, select Apply WebLogic tuning parameters. For information about the WebLogic tuning parameters, see the installer Help.

      Note:

      If you select this check box, you must restart the WebLogic Server domain after PDC installs successfully.

  21. Click Next.

    The Installation Summary screen appears.

  22. Review the selections you have made in the preceding screens, and click Install.

    The Installation Progress screen appears.

    Note:

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

  23. When the installation is done, click Next. The Installation Complete screen appears.

    Note down the provided URL, because you will use it to access PDC.

  24. Click Finish to complete and exit.

  25. If you selected Apply WebLogic tuning parameters, you must restart the WebLogic Server domain.

See "Verifying the Pricing Design Center Installation" for information on verifying the successful installation of PDC.

See "About Installation Logs" for information on PDC Installer logs.

Upgrading Only the BRM Integration Pack Patch Set

Note:

The BRM Integration Pack patch installation must be performed as the UNIX user who installed BRM; for example, pin_user.

To upgrade the BRM Integration Pack patch set:

  1. On the machine on which BRM Integration Pack is installed, create a temporary directory (temp_dir).

  2. Go to the My Oracle Support website:

    http://support.oracle.com

  3. Sign in with your user name and password.

  4. Click the Patches & Updates tab.

  5. From the list, select Patch Name or Number.

  6. In the text field, enter the patch number.

  7. Click Search.

    The Patch Search page appears.

  8. Click the Patch Name or Number.

    The patch details appear.

  9. From the Platform list, select the platform and click Download, where platform is linux or solaris.

    The File Download dialog box appears.

  10. Download the appropriate pPatchNumber_PatchVersion_Generic.zip file to temp_dir.

  11. Unzip the pPatchNumber_PatchVersion_Generic.zip file.

    The zip file includes the pdcserver-12.0.0.x.0_generic.jar file. For example, pdcserver-12.0.0.1.0_generic.jar for PDC 12.0 Patch Set 1 and pdcserver-12.0.0.2.0_generic.jar for PDC 12.0 Patch Set 2.

  12. Start the WebLogic Server domain administration server or the WebLogic Server domain managed server on which PDC 12.0 was deployed, if it is not already started.

  13. (Optional) Ensure that the PDC database is running.

    Note:

    Ensure that the Oracle Database server is in Running state. The Installer connects to the Oracle Database server to verify the information you entered is valid.

  14. Ensure that the BRM database is running.

  15. Go to the temp_dir directory, and run one of the following commands:

    • To start the GUI installer:

      Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar

      where:

      • Java_home is the directory in which you installed the latest supported Java version.

      • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    • To start the GUI installer and create a silent installer response file during the installation:

      Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar -record -destinationFile path

      where:

      • path is the response file location and name.

      • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    The Welcome screen appears.

  16. Click Next.

    The Installation Location screen appears.

  17. Enter the full path to the directory in which you installed BRM Integration Pack.

  18. Click Next.

    • If you are installing PDC 12.0 or 12.0 Patch Set 1, the BRM Integration Pack Wallet Details screen appears. Proceed to step 21.

    • If you are installing PDC 12.0 Patch Set 2, the BRM Integration Pack Pre-requisite Libraries Location screen appears.

  19. In the OJDBC Location field, enter the full path or browse to the directory in which the OJDBC jar is located.

  20. Click Next.

    The BRM Integration Pack Wallet Details screen appears.

  21. Enter the following details for the BRM Integration Pack wallet:

    1. In the Wallet Location field, enter the path to the directory in which the BRM Integration Pack wallet is located.

    2. In the Wallet Password field, enter the BRM Integration Pack wallet password.

  22. Click Next.

    The Installation Summary screen appears.

  23. Review the selections you have made in the preceding screens, and click Install.

    The Installation Progress screen appears.

    Note:

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

  24. When the installation is done, click Next. The Installation Complete screen appears.

    Note down the provided URL, because you will need it to access PDC.

  25. Click Finish to complete and exit.

See "Verifying the Pricing Design Center Installation" for information on verifying the successful installation of BRM Integration Pack.

See "About Installation Logs" for information on PDC Installer logs.

Upgrading the Patch Set on an Existing PDC Installation in Silent Mode

Use silent install mode when you are installing PDC using the same configuration repeatedly. Silent install mode does not use the GUI and it runs in the background.

In this mode, you use a response file template that contains a predefined set of values to install PDC and BRM Integration Pack. You can generate a response file that contains the parameters and values during the PDC GUI installation.

Creating a Response File

To create a response file:

  1. Create the response file by doing one of the following:

    • Create a copy of the response file that was generated during the GUI upgrade. See "Upgrading Only the BRM Integration Pack Patch Set" for more information.

      Note:

      The GUI Installer does not store passwords provided during installation in the response file. You must manually add the passwords after creating a copy of the response file.

    • Create a response file using the template by running the following command:

      Java_home/bin/java -jar pdcserver_12.0.0.x.0_generic.jar -getResponseFileTemplates

      where:

      • Java_home is the directory in which you installed the latest supported Java version.

      • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

      A response file named oracle.communications.pdc.PricingDesignCenter.rsp is created with the default values.

    You can create as many response files as needed.

  2. Open the file in a text editor.

  3. Modify the response file you copied by specifying the key-value information for the parameters you want in your installation.

    Note:

    • The response file template contains guidelines and examples on how to enter the values in the parameters.

    • The Installer treats incorrect context, format, and type values in a response file as if no value were specified.

  4. Save and close the response file.

Upgrading the PDC and BRM Integration Pack Patch Set in Silent Mode

To install PDC and BRM Integration Pack Patch Set in silent mode:

  1. Create the response file. See "Creating a Response File".

  2. Copy the response file to the machine on which you run the silent installation.

  3. On the machine on which you run the silent installation, go to the temp_dir directory to which you have downloaded the PDC server software pack, and run the following command: 

    Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar -debug -invPtrLoc Inventory_home/oraInventory/oraInst.loc [parameter=value] -responseFile path -silent

    where:

    • path is the absolute path to the response file.

    • parameter is the name of an installation parameter.

    • value is the value of the installation parameter.

    • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    For example: 

    Java_home/bin/java -jar pdcserver-12.0.0.2.0_generic.jar -debug -invPtrLoc Inventory_home/oraInventory/oraInst.loc INSTALL_TYPE=Complete -responseFile /tmp/oracle.communications.pdc.PricingDesignCenter.rsp -silent

    The installation runs silently in the background.

To install BRM Integration Pack in silent mode:

  1. Create the response file. See "Creating a Response File".

  2. Copy the response file to the machine on which you run the silent installation.

  3. On the machine on which you run the silent installation, go to the temp_dir directory to which you have downloaded the BRM Integration Pack, and run the following command: 

    Java_home/bin/java -jar pdcserver-12.0.0.x.0_generic.jar -debug -invPtrLoc Inventory_home/oraInventory/oraInst.loc [parameter=value] -responseFile path -silent

    where:

    • path is the absolute path to the response file.

    • parameter is the name of an installation parameter.

    • value is the value of the installation parameter.

    • x is the PDC patch set version. For example, 1 is the version for PDC 12.0 Patch Set 1 and 2 is the version for PDC 12.0 Patch Set 2.

    For example: 

    Java_home/bin/java -jar pdcserver-12.0.0.2.0_generic.jar -debug -invPtrLoc Inventory_home/oraInventory/oraInst.loc INSTALL_TYPE=Complete -responseFile /tmp/oracle.communications.pdc.PricingDesignCenter.rsp -silent

    The installation runs silently in the background.

See "Verifying the Pricing Design Center Installation" for information on verifying the successful installation of PDC and BRM Integration Pack.

See "About Installation Logs" for information on the PDC Installer logs.

Restoring the Previous Installation

If your patch installation is not successful, you must restore your system to the previous installation.

Note:

As a workaround, restore the previous installation by replacing the PDC 12.0 directories with the directories that you backed up.

To restore the previous PDC 12.0 installation:

  1. Restore the WebLogic server domains directory. Use the domains directory that you backed up before the patch installation to replace the following directory:

    Middleware_home/user_projects/domains

  2. Restore the PDC installation directory. Use the PDC_home directory that you backed up before you installed PDC 12.0 installation to replace the PDC_home directory.

  3. Restore the oraInventory directory. Use the oraInventory directory that you backed up before you installed PDC 12.0 to replace the oraInventory directory.

  4. Restore the PDC database schema.

  5. Restore the transformation cross-reference database schema.

  6. Restore the migration cross-reference database schema.

Rolling Back the Patch Set Installation

After installing a patch set, you can roll back the patch set to the previous version if required; for example, you can roll back PDC 12.0 Patch Set 1 to PDC 12.0. You must run the ./deinstall.sh and ./rollback.sh scripts to uninstall the current patch set and remove the patch set files.

To roll back the PDC patch set installation:

  1. Ensure that you make an offline backup of the database with the data added after the patch set installation.

    Note:

    If you are rolling back to Patch Set 3 or earlier, back up PDC_home/client/Plan.xml from the release that is being rolled back. After rollback is completed, copy the backed-up version back to PDC_home/client/Plan.xml.

  2. Go to the PDC_home/oui/bin directory.

  3. Run the following command:

    ./deinstall.sh

    The Distribution to Uninstall screen appears.

  4. Select the patch set and the components that you want to uninstall.

    Note:

    Do not use the Select All option to select the patch set or components. If you use this option, the initial release and the patch sets are selected for uninstallation.

  5. Click Uninstall.

    The Welcome screen appears.

  6. Click Next.

    The Uninstallation Summary screen appears.

  7. Click Uninstall.

    The Uninstallation Progress screen appears.

  8. Click Next.

    The Uninstallation Complete screen appears.

  9. Click Finish.

  10. Go to the PDC_home/oui/bin directory.

  11. Run the following command:

    ./rollback.sh

    Note:

    The PDC application is rolled back to the previous version. When you roll back from the current patch set version to the earlier version, database entries that are created during the current patch set version are not rolled back.

  12. Redeploy pricingui.ear from the Oracle WebLogic Server console.

  13. Log in to the PDC application and check if the components that you added after the patch set installation are removed.