Skip to main content

Installation

What is it?​

The XP2 Connector is a set of Perl scripts installed on the AIX platform where XP2 runs. Installing these scripts enables OpCon to submit, start, and monitor XP2 jobs.

  • Install the connector when setting up OpCon integration with FiServ XP2 for the first time
  • Reinstall from this procedure after a full system rebuild or migration to a new AIX host

It is recommended that the XP2 interface tools be installed in /ops/bin. The distribution file is named XP2Applications-<version>.tar — for example, XP2Applications-20.03.00.tar. The version in the file name changes with each release.

Installation steps​

To install the XP2 Connector, complete the following steps:

  1. FTP the tar file to the AIX platform in binary. Place the tar file in the /tmp directory.
  2. Create the installation directory by entering:
mkdir /ops
mkdir /ops/bin
  1. Change to the installation directory by entering:
cd /ops/bin
  1. Untar the distribution file:
tar xvf /tmp/XP2Applications-<version>.tar

:::caution Confirm the scripts extracted into /ops/bin itself List /ops/bin and confirm you see the scripts, such as CreateXPEnvForPerl.ksh, run_xp_job.pl and run_xp_job.ini. If you instead see a single directory named after the release, the archive carried a top-level directory — move its contents into /ops/bin before continuing. Every step that follows, along with the SMAXPSetup property and the run_xp_job.ini defaults, expects the scripts directly in the installation directory. :::

  1. Under the installation directory, create a locks directory:
mkdir /ops/bin/locks
  1. Verify the values in the following configuration files:
info

If the installation is done in a non-standard directory, edit the file named CreateXPEnvForPerl.ksh and change the following line to reflect the correct directory name:

INSTALL_DIR=/ops/bin

OpCon property​

Defining a global property that points to the environment initialization script simplifies job definitions across all XP2 jobs.

:::tip Example

During installation, create a global property with the following name and value:

Name: SMAXPSetup

Value: /ops/bin/CreateXPEnvForPerl.ksh :::