Installing Converged Application Server Patches

To install a Converged Application Server patch:

  1. Determine whether you need to stop all servers in your Converged Application Server system by checking the patch README file.

    The README file explicitly states whether the patch requires you to stop your servers before installing the patch.

  2. Log in to the target system.

  3. Download the patch from the My Oracle Support website to a temporary directory:

    https://support.oracle.com/

    The patch archive (PatchName.zip) is downloaded to your temporary directory.

  4. Create a directory for storing the unpacked patch contents. This document and the patch README file refer to this directory as the Patch_top directory.

    Note:

    Ensure that the PatchName.zip file is not located inside the Patch_top directory.

  5. Go to your temporary directory and unpack the patch archive (PatchName.zip) into the Patch_top directory.

    The PatchName subdirectory is created.

  6. Go to the Patch_top/PatchName directory.

  7. Run the OPatch utility by entering the following at a command prompt:

    opatch apply

    OPatch validates the patch and makes sure that there are no conflicts with the software already installed in Oracle_Home before applying the patch to your Converged Application Server system.

    For more information, see "OPatch Utility Reference" and "Dealing with Conflicts When You Run the Apply Command".

  8. Verify that the patch installed successfully by running the following command:

    opatch lsinventory

    For more information, see "OPatch Utility Reference".

  9. Determine whether you need to restart all servers in your Converged Application Server system or perform other tasks by checking the patch README file.

    The patch README file explicitly states whether the patch requires you to restart your servers or to perform other tasks after installing the patch.

If you encounter any issues in any of these steps, see "Troubleshooting".

Installing the Priority Call Handling Patch

Installing the Priority Call Handling patch on Converged Application Server requires post-installation steps not covered by the usual patch process.

  1. Add the OPatch directory to your PATH variable.
    export PATH="$PATH:$ORACLE_HOME/OPatch"
  2. Verify the current patch inventory:
    Run opatch lsinv and record the output for reference.
  3. Unzip the patch file and navigate to the newly created directory.
    unzip 36869676.zip
    cd 36869676/
  4. Apply the patch:
    opatch apply
  5. Verify patch application:
    Run opatch lsinv again to confirm the patch appears in the inventory.
  6. Copy the configuration file priority-call-config.xml to the directory <domain_name>/config/custom/
    cp custom/pch_config/priority-call-config.xml ~/Domain_Home/config/custom/
  7. Edit your domain's config.xml to include the custom resource definition for prioritycallconfig:
    <custom-resource>
        <name>prioritycallconfig</name>
        <target>BEA_ENGINE_TIER_CLUST</target>
        <descriptor-file-name>custom/priority-call-config.xml</descriptor-file-name>
        <resource-class>com.bea.wcp.sip.management.descriptor.resource.PriorityCallConfigResource</resource-class>
        <descriptor-bean-class>com.bea.wcp.sip.management.descriptor.beans.PriorityCallConfigBean</descriptor-bean-class>
    </custom-resource>

    Note:

    If you are using the base domain, set the <target> value to AdminServer.
  8. Restart servers in the domain, one by one, to activate the patch and configuration changes.