Use the following information to install the PCA software to your physical server or virtual machine. If you are deploying your CX Passive Capture Application to a cloud-based environment, refer to the installation procedures for those environments.

1. Log in to the server by using the root account.

   Note: The installation must be run as root.

2. Open a command prompt.
3. Enter rpm -ivh tealeaf-pca-<nnnn>-<rrr>.<distro>.i386.rpm to install the PCA software.

   Where:

   • <nnnn> is the build version number; for example, 3650.
   • <rrr> is the RPM revision number. The revision numbers is usually a single digit number.
   • <distro> is an identifier for the Linux™ distribution, such as "RHEL n" for Red Hat Enterprise Linux release n.

   Note: Red Hat Enterprise Linux (RHEL) 7 uses the same PCA installation package and process as Red Hat Enterprise Linux (RHEL) 6.x. In this scenario, use tealeaf-pca-<nnnn>-<rrr>.RHEL6.i386.rpm for the installation package.

   You can also use the Yum Package Manager to install the tealeaf-pca package by running the following command:

   yum install tealeaf-pca-<nnnn>-<rrr>.<distro>.i386.rpm

   By default, the PCA software is installed in /usr/local/ctccap. You specify the alternate directory by using the rpm command's --prefix option along with the installation and upgrade commands.

   The following are some sample rpm invocations.

   rpm -i --prefix=/opt/tealeaf tealeaf-pca-<nnnn>-<rrr>.<distro>.i386.rpm
   rpm -U --prefix=/home/tealeaf tealeaf-pca-<nnnn>-<rrr>.<distro>.i386.rpm

   When you do not use the --prefix option during an install or upgrade, RPM uses the default installation directory that is specified in the PCA package file, which is /usr/local/ctccap. Once you relocate a package, you must specify the alternate directory when you apply upgrades so that the package correctly checks for and updates previous installations.

When the files are extracted from the rpm package, follow the post-installation checklist to validate the installation and begin the configuration process.

SUSE Linux errors

If you install the PCA on a non-default path, you will see this error:

httpd: Syntax error on line 8 of /opt/tealeaf/etc/httpd.conf: Cannot load libexec/libphp5.so into server: /usr/lib/libxml2.so.2: version `LIBXML2_2.9.0' not found (required by /opt/tealeaf/libexec/libphp5.so) tealeaf: error: Failed to start httpd

As a temporary fix, you can run the following command in the console or the putty session to start the PCA processes (for example by using tealeaf start).

export LD_LIBRARY_PATH=/opt/tealeaf/lib

For a permanent fix, add the same command to your bash profile.