This chapter explains how to install the following Oracle Communications Billing and Revenue Management (BRM) tax calculation managers:
Vertex Quantum Manager
Note:Vertex Quantum Manager does not support Vertex Communications Tax Q Series.
Note:Vertex Manager supports Vertex Communications Tax Q Series and Vertex Sales Tax Q Series.
Before you read this document, you should be familiar with BRM concepts and architecture. See the following documents:
"Introducing BRM" in BRM Concepts.
"BRM System Architecture" in BRM Concepts.
"About Calculating Taxes" in BRM Calculating Taxes.
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.
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.
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".
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:
Download the software to a temporary directory (temp_dir).
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".
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.
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.
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.
Go to the directory where you installed the tax calculation manager package and source the source.me file:
Go to the BRM_Home/setup directory and run the pin_setup script.
Note:The pin_setup script starts all required BRM processes.
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
Your BRM tax calculation manager installation is now complete.
To install the tax calculation managers in a multischema environment:
Install the tax calculation manager on the primary installation machine.
Configure the tax calculation manager on the primary installation machine.
See "Setting Up Tax Calculation for Vertex" in BRM Calculating Taxes.
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 vertex_db vertex_db_number /_tax_db 0- cm dm_pointer vertex_db_number ip hostname vertex_port_number
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
If you installed Vertex Quantum Manager or Vertex Manager, see "Setting Up Tax Calculation for Vertex" in BRM Calculating Taxes.