PeerLink Help > Getting Started > Installation and Configuration

PeerLink can be installed in numerous ways based on your needs and environment. The PeerLink installation consist of two separate installers, both of which are available for download from our website:

1.	PeerLink installer, containing the PeerLink Hub and PeerLink Broker

2.	PeerLink Agent installer

PeerLink Hub & PeerLink Broker Installation

Both the PeerLink Hub and PeerLink Broker are packaged with the main PeerLink installer and by default, will be installed on the same server.

Basic Requirements

The PeerLink Hub must be installed on a highly available Windows 2003 Server or later with at least 2GB or RAM and must have 512MB of RAM dedicated each to the PeerLink Hub and PeerLink Broker applications. This is the default minimum recommended configuration, but the amount of RAM can be reduced or increased via custom configuration.

2.	All installed PeerLink Agents must have network access to the server that the PeerLink Broker is installed on, and any firewalls must be configured to allow access for ports 61617 and 8181.

3.	See the Requirements section for more detailed requirements.

Software Installation & Launching

1.	Run the PL-Hub_Installer.exe installer and follow all instructions.

After the installation finishes, both the PeerLink Hub and PeerLink Broker will be installed. The PeerLink Broker will automatically be installed as a running Windows service and set to auto-start. The PeerLink Hub is installed in two parts: a Windows service that is set to auto-start, and a client for interacting with the Windows service. The client is started as a normal Windows application.

Start the PeerLink Hub Client by launching the PL-Hub.exe executable located in the base installation directory. If the both the PeerLink Broker and PeerLink Hub Service are up and running as background services, then the PeerLink Hub should successfully start. If not, please make sure that both the PeerLink Broker and PeerLink Hub Service are running as Windows services via the Windows Service Panel (services.msc).

Secure Encrypted SSL Connections

By default, the PeerLink Hub and PeerLink Broker will be installed on the same host machine which does not require secure SSL communication between each other. To enable a secure SSL connection between the PeerLink Hub and PeerLink Broker, first stop the PeerLink Hub Service via the Windows Service Panel (services.msc). Once stopped, navigate to the directory, 'Hub\workspace\prefs', relative to the installation directory. Within this directory, open the com.ci.pl.hub.runtime.prefs file in a text editor. If the file does not contain a line starting with "hub.jms.providerURL", then add the following line in it's entirety:

hub.jms.providerURL=failover\:(ssl\://localhost\:61617)?jms.alwaysSyncSend\=true

Otherwise, making the following changes to the line starting with "hub.jms.providerURL" (changes are bold and underlined):

From: hub.jms.providerURL=failover\:(tcp\://localhost\:61616)?jms.alwaysSyncSend\=true

To: hub.jms.providerURL=failover\:(ssl\://localhost\:61617)?jms.alwaysSyncSend\=true

Once these changes are complete, save the file, then restart the PeerLink Hub Service.

Uninstalling

PeerLink ships with an uninstaller for the environment it is running in. Please use the standard platform specific method for removing programs/applications to uninstall PeerLink.

PeerLink Agent Installation

You will need to install a PeerLink Agent on each server you plan to include in any of your file collaboration sessions.

Basic Requirements

Must be installed on a system running Windows 2003 Server or later with the latest service packs acting as a file server where the Root Folder is located on a locally attached storage device. The system must have a minimum of 1GB of RAM, 512MB of which should be dedicated to the PeerLink Agent. Depending on the level of activity on the system and the number of running applications, required system RAM will likely be higher.

2.	The server that the PeerLink Agent is installed on must have direct network access to the server that the PeerLink Broker is installed on, and any firewalls must be configured to allow access for ports 61617 and 8181 to the PeerLink Broker server.

3.	The PeerLink Agent is installed as a Windows service under the default SYSTEM user account. The user that the service is running under should have read+write access to the Root Folder.

4.	See the Requirements section for more detailed requirements.

Software Installation & Launching

1.	Run the PL-Agent_windows.exe installer on the target server and follow all instructions.

2.	During installation you will need to specify the PeerLink Broker Host Name (computer name, fully qualified domain name, or IP Address) of the server where the PeerLink Broker is running, as well as the configured TCP/IP port number (the default port for SSL communication is 61617).

After the installation finishes, the PeerLink Agent will be installed as a Windows service. You will need to verify that the PeerLink Agent is running, and that it was able to successfully connect to the PeerLink Broker. You can do this by opening Windows Service Panel (services.msc) and making sure that the "PeerLink Agent Service" is started.

4.	Make sure that the PeerLink Agent was able to successfully connect to the PeerLink Broker by going to the PeerLink Agent installation folder, opening the output.log text file, and making sure that "Ready" is displayed on the first line.

Secure Encrypted SSL Connections

By default, the PeerLink Agent is installed with SSL encryption enabled, where the PeerLink Agent connects to the PeerLink Broker through a secure, encrypted connection. If you are running PeerLink on a secure LAN or via a corporate VPN, you might want to disable SSL to boost performance. For more details on disabling or enabling encryption for the PeerLink Agent, please see the Central Agent Configuration page.

Uninstalling

PeerLink Agent ships with an uninstaller for the environment it is running in. Please use the standard platform specific method for removing programs/applications to uninstall the PeerLink Agent.