1. PDC Installation Guide
  2. Upgrading Pricing Design Center 15.0 to a Later Release of 15.0
  3. Installing a Later Release on an Existing Pricing Design Center 15.0 Installation

10 Installing a Later Release on an Existing Pricing Design Center 15.0 Installation

Learn how to upgrade from an earlier release of Oracle Communications Pricing Design Center (PDC) 15.0 to a later release of PDC 15.0.

Note:

Make a backup of your PDC_home and PDC_BRM_home directories before proceeding with the installation of the new release.

Topics in this document:

Upgrading PDC in GUI Mode

The steps for upgrading PDC to a new release using the GUI depend on the PDC components you choose to upgrade:

Upgrading Both the PDC and BRM Integration Pack Release

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 the new release of the PDC and BRM Integration Pack on an existing PDC 15.0 installation:

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

  2. Download the PDC software. See "Downloading the PDC Software" for instructions.

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

  4. 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 release installation.

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

    • To start the GUI installer:

      Java_home/bin/java -jar jarfile

      where:

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

      • jarfile is the PDC installer file, for example pdcserver-15.0.1.0.0_generic_full.jar.

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

      Java_home/bin/java -jar jarfile -record -destinationFile path

      where path is the response file location and name.

    The Welcome window appears.

  6. Click Next.

    The Installation Location window appears.

  7. Enter the full path to the directory in which you installed PDC 15.0.

  8. Click Next.

    The PDC Wallet Details window appears.

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

  10. Click Next.

    The PDC WebLogic Server window appears.

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

  12. Click Next.

    The BRM Integration Pack Pre-requisite Libraries Location window appears.

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

  14. Click Next.

    The BRM Integration Pack Wallet Details window appears.

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

  16. Click Next.

    The Installation Summary window appears.

  17. Review the selections you have made in the preceding windows, and click Install.

    The Installation Progress window appears.

    Note:

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

  18. When the installation is done, click Next. The Installation Complete window appears.

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

  19. Click Finish to complete and exit.

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

Installing the PDC Release

To install the PDC release on an existing PDC 15.0 installation:

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

  2. Download the PDC software. See "Downloading the PDC Software" for instructions.

  3. Start the Oracle WebLogic Server domain administration server or the WebLogic Server domain managed server on which the original release of PDC 15.0 was deployed, if it is not already started.

  4. 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 release installation.

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

    • To start the GUI installer:

      Java_home/bin/java -jar jarfile

      where:

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

      • jarfile is the PDC installer file, for example pdcserver-15.0.1.0.0_generic_full.jar.

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

      Java_home/bin/java -jar jarfile -record -destinationFile path

      where:

      • path is the response file location and name.

    The Welcome window appears.

  6. Click Next.

    The Installation Location window appears.

  7. Enter the full path to the directory in which you installed the original release of PDC 15.0.

  8. Click Next.

    The PDC Wallet Details window appears.

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

  10. Click Next.

    The PDC WebLogic Server window appears.

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

  12. Click Next.

    The Installation Summary window appears.

  13. Review the selections you have made in the preceding windows, and click Install.

    The Installation Progress window appears.

    Note:

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

  14. When the installation is done, click Next. The Installation Complete window appears.

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

  15. Click Finish to complete and exit.

  16. 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 Release

Note:

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

To upgrade the BRM Integration Pack release:

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

  2. Download the PDC software. See "Downloading the PDC Software" for instructions.

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

  4. (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.

  5. Ensure that the BRM database is running.

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

    • To start the GUI installer:

      Java_home/bin/java -jar jarfile

      where:

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

      • jarfile is the PDC installer file, for example pdcserver-15.0.1.0.0_generic_full.jar.

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

      Java_home/bin/java -jar jarfile -record -destinationFile path

      where:

      • path is the response file location and name.

    The Welcome window appears.

  7. Click Next.

    The Installation Location window appears.

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

  9. Click Next.

    The BRM Integration Pack Pre-requisite Libraries Location window appears.

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

  11. Click Next.

    The BRM Integration Pack Wallet Details window appears.

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

  13. Click Next.

    The Installation Summary window appears.

  14. Review the selections you have made in the preceding windows, and click Install.

    The Installation Progress window appears.

    Note:

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

  15. When the installation is done, click Next. The Installation Complete window appears.

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

  16. 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 PDC to a New Release 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 Release" 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 jarfile -getResponseFileTemplates

      where:

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

      • jarfile is the PDC installer file, for example pdcserver-15.0.1.0.0_generic_full.jar.

      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 Release in Silent Mode

To upgrade PDC and BRM Integration Pack release 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 jarfile -debug -invPtrLoc Inventory_home/oraInventory/oraInst.loc [parameter=value] -responseFile path -silent

    where:

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

    • jarfile is the PDC installer file, for example pdcserver-15.0.1.0.0_generic_full.jar.

    • Inventory_home is the location of the Oracle inventory.

    • parameter is the name of an installation parameter.

    • value is the value of the installation parameter.

    • path is the absolute path to the response file.

    For example: 

    Java_home/bin/java -jar pdcserver-15.0.1.0.0_generic_full.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 jarfile -debug -invPtrLoc Inventory_home/oraInventory/oraInst.loc [parameter=value] -responseFile path -silent

    where:

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

    • jarfile is the PDC installer file, for example pdcserver-15.0.1.0.0_generic_full.jar.

    • Inventory_home is the location of the Oracle inventory.

    • parameter is the name of an installation parameter.

    • value is the value of the installation parameter.

    • path is the absolute path to the response file.

    For example: 

    Java_home/bin/java -jar pdcserver-15.0.1.0.0_generic_full.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 the installation of your new release is not successful, you must restore your system to the previous installation.

Note:

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

To restore the previous PDC 15.0 installation:

  1. Restore the WebLogic server domains directory. Use the domains directory that you backed up before the upgrade 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 the upgrade to replace the PDC_home directory.

  3. Restore the oraInventory directory. Use the oraInventory directory that you backed up before the upgrade 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 New Release Installation

After installing a later release, you can roll back the release to the previous version if required; for example, you can roll back PDC 15.0.1 to PDC 15.0.0. You must run the ./deinstall.sh and ./rollback.sh scripts to uninstall the current release and remove the files for the later release.

To roll back the PDC release installation:

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

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

  3. Run the following command:

    ./deinstall.sh

    The Distribution to Uninstall window appears.

  4. Select the release and the components that you want to uninstall.

    Note:

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

  5. Click Uninstall.

    The Welcome window appears.

  6. Click Next.

    The Uninstallation Summary window appears.

  7. Click Uninstall.

    The Uninstallation Progress window appears.

  8. Click Next.

    The Uninstallation Complete window 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 release to the earlier version, database entries that are created during the current release 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 new release installation are removed.