2 Installing the Cartridge Pack

This chapter contains information on installing and setting up the Oracle Communications Offline Mediation Controller Elastic Charging Engine cartridge pack.

Complete the following pre-installation tasks before installing the cartridge pack:

  • Ensure Offline Mediation Controller 6.0 is installed.

  • Stop the Node Manager, Administration Server, and Administration Client.

  • Install the latest Oracle Communications Billing and Revenue Management Elastic Charging Engine (ECE) software. The ECE software contains the ECE-specific client libraries and configuration files required to connect to the ECE grid. Offline Mediation Controller does not provide any configurations to update ECE connection details. It uses the ECE-specific client libraries to connect to ECE.

Installing the ECE Cartridge Pack

Note:

In a Solaris or Linux environment, you must install the cartridge pack on every UNIX server running Node Manager or Administration Server.

To install the ECE cartridge pack:

  1. Go to the OMC_home/cartridges directory, where OMC_home is the directory in which Offline Mediation Controller is installed.

  2. If the ocece_rExistingPatchVersion.jar file exists, where ExistingPatchVersion is the version of the Offline Mediation Controller patch set that is installed, remove it.

  3. Create a temporary directory (temp_dir).

  4. Go to the My Oracle Support Web site:

    http://support.oracle.com">>http://support.oracle.com

  5. Sign in with your user name and password.

  6. Click the Patches & Updates tab.

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

  8. In the text field, enter 24486856 and click Search.

    The Patch Search Results page appears.

  9. Click the patch name.

    The patch details appear.

  10. Click Download.

    The File Download dialog box appears.

  11. Download the p24486856_60_Generic.zip software pack to temp_dir.

  12. Unzip the p24486856_60_Generic.zip file.

  13. Move the ocece_r6_0_0_4_0.jar file to the OMC_home/cartridges directory,

  14. Restart Node Manager, Administration Server, and Administration Client.

    See the discussion about starting and stopping Offline Mediation Controller in Offline Mediation Controller System Administrator's Guide.

Note:

ocece_r6_0_0_4_0.jar is compatible with the ECE 11.3 release.

Verifying the Cartridge Pack Installation

You can verify that the ECE cartridge pack is installed by ensuring that the ECE Distribution Cartridge (DC) node is available in Administration Client.

To verify that the ECE cartridge pack is installed:

  1. Log on to Offline Mediation Controller Administration Client.

  2. From the Administrative Function list, select Nodes (Logical view).

  3. In the Available Node Types pane, expand the Wireless node type, and then expand the Distribution Cartridge (DC) node type.

    The ECE cartridge pack appears as the OCECE node type.

Post-Installation Tasks

This section provides instructions for the post-installation tasks.

Configuring Offline Mediation Controller to Support ECE when Offline Mediation Controller and ECE Are Installed on the Same System

To configure Offline Mediation Controller to support ECE:

  1. Open the OMC_home/bin/UDCEnvironment file in a text editor.

  2. Search for the following entry:

    IS_OCECE_REQUIRED=false
    
  3. Change the value to true, which enables Offline Mediation Controller to interface with ECE.

    IS_OCECE_REQUIRED=true
    
  4. Search for the following entry:

    OCECE_HOME_PATH=/home/opt/charging
    
  5. Change the value to the directory in which ECE is installed.

    For example:

    OCECE_HOME_PATH=/home/opt/OracleCommunications/ECE
    
  6. Save and close the file.

  7. Start Offline Mediation Controller. See the discussion about starting Offline Mediation Controller in Offline Mediation Controller Installation Guide.

Configuring ECE and Offline Mediation Controller when ECE and Offline Mediation Controller Are Installed on Different Systems

To configure ECE and Offline Mediation Controller when ECE and Offline Mediation Controller are installed on different systems:

Important:

Ensure that ECE is installed on a system within the same sub-network as the system on which Offline Mediation Controller is installed.
  1. On the system where ECE is installed, open the ECE_home/oceceserver/config/charging-coherence-override-dev.xml file in a text editor.

  2. Uncomment the following element:

    <well-known-addresses> 
        <socket-address id="1"> 
       <address system-property="tangosol.coherence.wka">localhost</address> 
       <port system-property="tangosol.coherence.wka.port">18088</port> 
        </socket-address> 
    </well-known-addresses>
    
  3. In the address element, replace localhost with the IP address of the system on which ECE is installed:

    <address system-property="tangosol.coherence.wka">ip_address</address>
    
  4. In the time-to-live element, set the value to 1:

    <time-to-live system-property="tangosol.coherence.ttl">1</time-to-live>
    
  5. In the cluster-name element, set the value to the ECE cluster name.

    For example:

    <cluster-name system-property="tangosol.coherence.cluster">BRM</cluster-name>
    
  6. Save and close the file.

  7. Copy the ECE_home directory to the system where Offline Mediation Controller is installed.

  8. On the system where Offline Mediation Controller is installed, open the OMC_home/bin/UDCEnvironment file in a text editor.

  9. Search for the following entry:

    IS_OCECE_REQUIRED=false
    
  10. Change the value to true, which enables Offline Mediation Controller to interface with ECE.

    IS_OCECE_REQUIRED=true
    
  11. Search for the following entry:

    OCECE_HOME_PATH=/home/opt/charging
    
  12. Change the value to the ECE_home directory that you have copied in step 7.

    For example:

    OCECE_HOME_PATH=/home/opt/OracleCommunications/ECE
    
  13. Save and close the file.

  14. Start ECE in the system where ECE is installed.

  15. Start Offline Mediation Controller. See the discussion about starting Offline Mediation Controller in Offline Mediation Controller Installation Guide.

Uninstalling the Cartridge Pack from a Solaris or Linux Workstation

To uninstall the ECE cartridge pack from a Solaris or Linux workstation:

  1. Go to the OMC_home/cartridges directory.

  2. Run the following command:

    rm ocece_r6_0_0_4_0.jar