Skip Headers
Oracle® Communications Billing and Revenue Management Installation Guide
Release 7.5

E16706-13
Go to Documentation Home
Home
Go to Table of Contents
Contents
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
PDF · Mobi · ePub

11 Installing Tax Calculation Managers

This chapter explains how to install the following Oracle Communications Billing and Revenue Management (BRM) tax calculation managers:

Before you read this document, you should be familiar with BRM concepts and architecture. See the following documents:

Important:

  • These tax calculation managers are optional features that require a separate license.

  • The third-party tax packages are not included with the BRM software; you must purchase and install those you want.

System Requirements

BRM tax calculation managers are available for the Linux, Solaris, and AIX operating systems. Vertex is also available for the HP-UX IA64 operating system.

Important:

BRM tax calculation managers only run in 32-bit mode. Hence you should only use these with the 32-bit versions of the supported third-party tax packages.

Taxware Manager is not supported on the HP-UX IA64 operating system.

For information on the Sales Tax Q Series (STQ) and Communications Tax Q Series (CTQ) versions supported by Vertex Data Manager (DM), see "Other Compatible Software".

For information on disk space requirements for the HP-UX IA64, Linux, Solaris, and AIX operating systems, see "Disk Space Requirements".

Software Requirements

Before installing a tax calculation manager:

Installing Tax Calculation Managers

Note:

If you have already installed the product, features that are already installed cannot be reinstalled without uninstalling them first. To reinstall a feature, uninstall it and then install it again.

To install a tax calculation manager:

  1. Download the software to a temporary directory (temp_dir).

    Important:

    • If you download to a Windows workstation, use FTP to copy the .bin file 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".

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

    Caution:

    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
      
    
  3. Go to the temp_dir directory, and run the .bin file.

    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.
  4. Follow the instructions displayed during installation. The default installation directory for the tax calculation manager is opt/portal/7.5.

    Note:

    The installation program does not prompt you for the installation directory if BRM or a tax calculation manager is already installed on the machine and automatically installs the package at the BRM_Home location.
  5. Go to the directory where you installed the tax calculation manager package and source the source.me file:

    Bash shell:

    source source.me.sh
      
    

    C shell:

    source source.me.csh
      
    
  6. Go to the BRM_Home/setup directory and run the pin_setup script.

    Note:

    The pin_setup script starts all required BRM processes.
  7. If your event tables are partitioned, run the partition_utils utility with the -o update parameter from the BRM_Home/apps/partition_utils directory:

    perl partition_utils.pl -o update
      
    

    For more information, see "Updating Partitions" and "partition_utils" in BRM System Administrator's Guide.

Your BRM tax calculation manager installation is now complete.

Installing Tax Calculation Managers in a Multischema Environment

To install the tax calculation managers in a multischema environment:

  1. Install the tax calculation manager on the primary installation machine.

    See "Installing Tax Calculation Managers".

  2. Configure the tax calculation manager on the primary installation machine.

    See "Setting Up Tax Calculation for Taxware" or "Setting Up Tax Calculation for Vertex" in BRM Calculating Taxes.

  3. Configure the secondary installation machine to link to the tax calculation software on the primary installation machine by adding the following lines to the secondary Connection Manager (CM) pin.conf file (BRM_Home/sys/cm/pin.conf):

    - fm_rate taxware_db taxware_db_number /_tax_db 0- cm dm_pointer taxware_db_number ip hostname taxware_port_number
      
    
  4. Configure the secondary installation machine to link to the taxcodes_map file on the primary installation machine by adding the following lines to the secondary CM pin.conf file (BRM_Home/sys/cm/pin.conf):

    - fm_rate taxcodes_map path_to_taxcodes_map
    

What's Next?