FolderMaestro File Collaboration can be installed in numerous ways based on your needs and your environment. FolderMaestro File Collaboration installation consist of two separate installers:
| 1. | FolderMaestro File Collaboration Hub & Broker installer: (Downloaded from our website). |
| 2. | FolderMaestro Agent installer. (Available via http download after Hub installation). |
Hub & Broker Installation
Both the Hub and Broker are packaged with the main FolderMaestro File Collaboration installer, and by default, will be installed on the same server.
Basic Requirements
| 1. | The Hub must be installed on a highly available Windows 2000 or Windows 2003 server with at least 2GB or RAM and must have1GB of RAM dedicated to the Hub and Broker applications. This is the default and recommended configuration, but the amount of RAM can be reduced or increased via custom configuration. |
| 2. | All installed FolderMaestro Agents must have network access to the server the Broker is installed on, and any firewalls must be configured to allow access for ports 61616 and 8181 |
| 3. | See the Requirements section for more detailed requirements. |
Software Installation & Launching
| 1. | Run the FM-Hub_Installer.exe and follow all instructions. |
| 2. | After installation finishes, both the Hub and Broker will be installed. The Broker will automatically be installed as a running Windows service and set to auto-start, and the Hub will need to be started as a normal Windows application. |
| 3. | Start the Hub by launching the PLHub.exe executable located in the base installation directory. If the Broker is up and running as a background service then the Hub should successfully start. If not, please make sure the Broker is running as a Windows service via Windows Service Panel (services.msc). |
Secure Encrypted SSL Connections
By default, the Hub and Broker will be installed on the same host machine which does not require secure SSL connection between each other. To enable a secure SSL connection between the Hub and Broker, open the Hub.properties file located in the Hub\plugins\com.compositeideas.peerlink.ori_2.0.2 directory relative to the installation directory in a text editor, and change the providerURL line below from tcp to ssl and 61616 to 61617, save the changes, then restart the Hub.
From: providerURL=failover:tcp://localhost:61616
To: providerURL=failover:ssl://localhost:61617
Running a Hub from a private NATed IP Address
If you are running the Hub on a machine with a private IP Address behind a router or firewall using NAT, then you will need to edit the Hub.properties file and specify the public IP Address of the machine. Open the Hub.properties file located in the Hub\plugins\com.compositeideas.peerlink.ori_2.0.2 directory relative to the installation directory in a text editor, and add the machines IP Address to the classServer.hostname= line, e.g. classServer.hostname=192.168.1.1
Uninstalling
FolderMaestro File Collaboration ships with an uninstaller for the environment it is running in. Please use the standard platform specific method for removing programs/applications to uninstall FolderMaestro File Collaboration.
FolderMaestro Agent Installation
You will need to install a FolderMaestro Agent on each server you plan to include in any of your file collaboration sessions.
Basic Requirements
| 1. | Must be installed running Windows 2000 or Windows 2003 Server with the latest service packs, and acting as a file server where the Root Folder is located on a locally attached storage device. |
| 2. | The server that the FolderMaestro Agent is installed on must have direct network access to the server that the Broker is installed on, and any firewalls must be configured to allow access for ports 61616 and 8181 to the Broker server. |
| 3. | The FolderMaestro 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. | You will need to download the FolderMaestro Agent installer directly from the running Hub via Http using a web browser. Make sure that the Hub is running and type the following URL in from the Hub server http://localhost:8081/ or http://HubIPAddress:8081/ from the server where you are installing the FolderMaestro Agent on (substitute IP Address or computer name of Hub server for HubIPAddress). After the Hub home page is displayed, click on the "Download the FolderMaestro Agent Installer" link. If HubIPAddress:8081/ does not work from the server where you are installing the FolderMaestro Agent, then a firewall may be blocking port 8081. If this is the case then you should download the FolderMaestro Agent installer directly from the Hub server via /localhost:8081/ and then transfer the executable to the remote server. |
| 2. | Run the FM-Agent_windows.exe installer and follow all instructions. |
| 3. | During installation you will need to specify the Broker Host Name (computer name, domain name or IP Address) of the server where the Broker is running, as well as the configured TCP/IP port number. The host name and port number of the Broker is indicated on the Hub home page where you downloaded the FolderMaestro Agent from (see below). |
| 4. | After installation finishes the FolderMaestro Agent will be installed as a Windows service. You will need to verify that the FolderMaestro Agent is running, and that it was able to successfully connect to the Broker. You can do this by opening Windows Service Panel (services.msc) and making sure that the "FolderMaestro Agent Service" is started. |
| 5. | Make sure that the FolderMaestro Agent was able to successfully connect to the Broker by going to the FolderMaestro Agent installation folder and opening the output.log text file and make sure that "Ready." is displayed on the first line. |
Secure Encrypted SSL Connections
By default, the FolderMaestro Agent is installed with SSL encryption enabled, where the FolderMaestro Agent connects to the Broker through a secure, encrypted connection. If you are running FolderMaestro File Collaboration on a secure LAN or via a corporate VPN, you might want to disable SSL to bolster performance. To disable SSL connection, open the agent.properties file located in the FolderMaestro Agent installation directory in a text editor, and change the providerURL line below from ssl to tcp and 61617 to 61616, save the changes, then restart the FolderMaestro Agent Windows service.
From: providerURL=failover://(ssl://BROKER_HOSTNAME:61617)?jms.prefetchPolicy.all=1
To: providerURL=failover:tcp://BROKER_HOSTNAME:61616?jms.prefetchPolicy.all=1
Where BROKER_HOSTNAME is the IP address or host name of the machine that the Broker is running on.
Uninstalling
FolderMaestro 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 FolderMaestro Agent.