2 Pre-Installation Tasks

Introduction

The instructions in this guide show you how to install Connect’s supporting software, which must be completed before you install Connect.

Pre-installation Software Requirements

Make sure that the appropriate versions of the operating system software and supporting software are installed. The release notes for each Connect version detail the system requirements.

UNIX systems generally do not require additional software to be installed in order to run Connect. Depending on deployment configuration, however, the following additional infrastructure may be required:

  • External mail servers (message transfer agents or MTAs) may be required to serve as outbound mail farms or as inbound mail proxies.

  • A software or hardware-based HTTP load balancing solution may be required to distribute incoming traffic to the Tracker nodes if the Connect Tracker will be installed on more than node.

Unpack the Connect Software Distribution

On UNIX, Connect is distributed as a single gzip-compressed tar file. The Connect distribution contains a bootstrap.sh script that downloads additional software components:

  • The Java Virtual Machine runtime software.

  • JDBC Driver Software

Typically, Connect will be deployed under a dedicated user account. In this document, we will assume the user name of this account is brickst.

On the Connect install node, create a directory for the Connect installation directory (e.g. /opt/connect.install) and ensure that is owned by brickst user.

In the Connect installation directory, uncompress and unpack the platform-independent Connect software. This will create a kc directory. In the remainder of this document, we will refer to this kc directory as the Connect home directory or $KCHOME.

Run Bootstrap Script

Delete java from older versions than 10r57 as bootstrap will install a new java at the proper path for Connect.

In the $KCHOME, run the bootstrap script:

cd $KCHOME
bash install/bootstrap.sh

This will create an install.properties file in $KCHOME, install the Java VM in $KCHOME/../java, and download the JDBC drivers to $KCHOME/import.

If the server does not have access to the internet you can run the bootstrap script offline mode:

cd $KCHOME

bash install/bootstrap.sh --offline