12 Installing Paymentech Manager

This chapter explains how to install the Oracle Communications Billing and Revenue Management (BRM) Paymentech Manager software.

Before you read this chapter, 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 BRM-Initiated Payments" in BRM Configuring and Collecting Payments.

Important:

Paymentech Manager is an optional feature that requires a separate license.

System Requirements

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

Software Requirements

Before installing Paymentech Manager, you must install the following:

Third-Party software, which includes the PERL libraries and JRE required for installing BRM components.

See "Installing the Third-Party Software".
BRM.

See "BRM Installation Overview".

Installing Paymentech Manager

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 Paymentech Manager:

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".
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
  
```
Go to the temp_dir directory and enter this command:
```
7.5.0_PaymentechMgr_platform_opt.bin
  
```
where platform is the operating system name.

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 Paymentech Manager is BRM_Home/opt/portal/7.5.

Note:
The installation program does not prompt you for the installation directory if BRM or Paymentech 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 Paymentech Manager package and source the source.me file:

Bash shell:
```
source source.me.sh
  
```
C shell:
```
source source.me.csh
  
```
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
  
```
For more information, see "Updating Partitions" and "partition_utils" in BRM System Administrator's Guide.

Your Paymentech Manager installation is now complete.

What's Next?

Read the instructions in "Configuring BRM-Initiated Payment Processing" in BRM Configuring and Collecting Payments.

Uninstalling Paymentech Manager

To uninstall Paymentech Manager, run the BRM_Home/uninstaller/PaymentechMgr/uninstaller.bin.