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 following list provides information about the
required operating system software and supporting software for your platform. Where
applicable, software download information is provided.
Note: Connect is certified to run with only the version numbers provided. Uninstall
other versions before installing certified versions of any of the supporting
software.
If the Connect Tracker will be installed on more than node, a software or
hardware-based HTTP load balancing solution will be required to distribute incoming
traffic to the Tracker nodes.
Operating System Software
Connect is certified to run under all versions of Microsoft Windows Server 2003
and 2008 with latest Service Packs.
Supporting Software
In order to run Connect, Windows systems need the following additional software to be installed:
- The NSSM Service Manager
- The CopSSH SFTP service. Connect can also be used with the Windows
FTP Service, but this is not recommended in production environments
due to security concerns.
- 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.
Windows Network Load Balancing is one option (see http://technet.microsoft.com/en-us/library/cc758834.aspx for
more information).
Note: Previous versions of Connect required the Windows NT Resource Kit
and the Windows Server 2003 Resource Kit to be installed on all
nodes. No Resource Kits are required to install or run Connect 10R5.
Install the NSSM Service Manager
The NSSM Service Manager is used to install and run the CRM Service
that starts and stops the Connect software. It must be installed on
each node in a Connect messaging cluster. The NSSM installer is available
for 32 bit and 64 bit Windows. The installer will copy the NSSM binary
exe file to an install folder and will add the folder to the system path.
NSSM is a public domain product with source code available at
http://nssm.cc.
Note: Prior versions of Connect required the Windows NT 4.0 Resource Kit and the
Windows Server 2003 resource kit. Neither Resource Kits are required in
Connect 10R5 and later.
Unpack the Connect Software Distribution
- Typically, Connect will be deployed under a dedicated user account. In this
document, we will assume the user name of this account is connect.
- On the Connect install node, create a directory for the Connect
installation directory (e.g.
C:\connect).
In the Connect installation directory, uncompress and unpack the Connect software distribution.
This will create two directories, kc and java. The
kc directory is the Connect home directory $KCHOME.