2 Installing JCA Resource Adapter

This chapter explains how to install JCA Resource Adapter on your Oracle Communications Billing and Revenue Management (BRM) system.

System Requirements

JCA Resource Adapter is available for the HP-UX IA64, Oracle Linux, Oracle Solaris, and AIX operating systems.

Software Requirements

Before installing JCA Resource Adapter, you must install the following:

  • Third-Party software, which includes the Perl libraries and Java Runtime Environment (JRE) required for installing BRM components. See "Installing the Third-Party Software" in BRM Installation Guide.

  • BRM Release 7.5.

The adapter must be deployed on a J2EE 1.4-compliant application server that has implemented the JCA 1.5 Specification. The adapter runs only in a managed environment.

Information Requirements

You need the following information about your existing system during the JCA Resource Adapter installation:

  • The location of your BRM_Home directory (the directory in which BRM components are installed) and log directories.

  • The Connection Manager (CM) port number.

Installing JCA Resource Adapter

JCA Resource Adapter is in the Web Services Manager downloadable package.

To install JCA Resource Adapter:

  1. Download the Web Services Manager package (7.5.0_WebServicesMgr_platform_opt.tar.Z), where platform is linux, aix, hpux_ia64, or solaris. For information about downloading the software to a temporary directory (temp_dir), see "Downloading the BRM Applications Software" in BRM Web Services Manager.

    Important:

    • If you download to a Windows workstation, use FTP to copy the package to a temporary directory on your UNIX server.

    • You must increase the heap size used by the Java Virtual Machine (JVM) before running the installation program to avoid ”Out of Memory” error messages in the log file. For information, see "Increasing Heap Size to Avoid ”Out of Memory” Error Messages" in BRM Installation Guide.

  2. Go to temp_dir and uncompress and extract the .tar.Z file. The following files are extracted:

    • 7.5.0_BRM_JCA_Adapter_platform_opt.bin: JCA Resource Adapter

    • 7.5.0_DM_AQ_platform_opt.bin: Synchronization Queue Data Manager

    • 7.5.0_WebServicesMgr_platform_opt.bin: Web Services Manager

    where platform is the operating system name.

  3. Go to the directory where you installed the Third-Party package, and source the source.me file.

    Note:

    You must source the source.me file to proceed with installation; otherwise, ”suitable JVM not found” and other error messages appear.

    Bash shell:

    source source.me.sh

    C shell:

    source source.me.csh

    For more information, see "Installing the Third-Party Software" in BRM Installation Guide.

  4. Go to temp_dir and enter the appropriate command for your operating system.

    7.5.0_BRM_JCA_Adapter_platform_opt.bin

    where platform is linux, aix, hpux_ia64, or solaris.

    Note:

    You can use the -console parameter to run the installation in command-line mode. To enable a graphical user interface (GUI) installation, install a GUI application such as X Windows and set the DISPLAY environment variable before you install the software.

  5. Follow the instructions displayed during installation. The default installation directory for JCA Resource Adapter is BRM_Home/apps/brm_integrations.

  6. Go to the BRM_Home/setup directory and run the following command:

    pin_setup

    Note:

    The pin_setup script starts all required BRM processes.

  7. Grant read privileges to the pending extended architecture (XA) transaction database views for each BRM database user:

    1. Using SQL*Plus, log in to your database as the SYSDBA user:

      sqlplus sys@databaseAlias as sysdba

      where databaseAlias is the database alias of your BRM database.

    2. Grant read privileges to the pending XA transaction views:

      SQL>GRANT SELECT ON DBA_2PC_PENDING TO user;
SQL>GRANT SELECT ON DBA_PENDING_TRANSACTIONS TO user;

      where user is the name of a BRM database user.

    3. Exit SQL*Plus.

    4. Stop and restart the BRM database to initialize the database instance with your changes.

Your JCA Resource Adapter installation is now complete.

What's Next?

Deploy and configure JCA Resource Adapter on your application server, and generate the schema for any custom BRM opcodes and storable classes in your system. See "Deploying and Configuring JCA Resource Adapter".