Installation and Initial Configuration

<< Click to Display Table of Contents >>

Navigation:  Peer Management Center Help > Getting Started >

Installation and Initial Configuration

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

Peer Management Center installer, containing the Peer Management Center and the Peer Management Broker.

Peer Agent installer.

Peer Management Center and Peer Management Broker Installation

Both the Peer Management Center and Peer Management Broker are packaged with the main Peer Management Center installer and by default, will be installed on the same server.

Basic Requirements

See the Requirements section for more detailed requirements.

Software Installation and Launching

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

2.After the installation finishes, both the Peer Management Center and Peer Management Broker will be installed. The Peer Management Broker will automatically be installed as a running Windows service and set to auto-start. The Peer Management Center is installed in three parts: a Windows service that is set to auto-start, a web service for granting access to the Windows service via web browsers, and a rich client for interacting with the Windows service. The rich client is started as a normal Windows application.

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

Secure Encrypted TLS Connections

By default, the Peer Management Center and Peer Management Broker will be installed on the same host machine that does not require secure TLS communication between each other. To enable a secure TLS connection between the Peer Management Center and Peer Management Broker, first stop the Peer Management Center 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 its 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):

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 Peer Management Center Service.

Uninstalling

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

Peer Agent Installation

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

Basic Requirements

See the Requirements section for more detailed requirements.

Software Installation and 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 Peer Management Broker Host Name (computer name, fully qualified domain name, or IP Address) of the server where the Peer Management Broker is running, as well as the configured TCP/IP port number (the default port for TLS communication is 61617).

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

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

Secure Encrypted TLS Connections

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

If AES-256 support is required, please contact support@peersoftware.com to obtain the necessary installers.

Uninstalling

Peer 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 Peer Agent.