ServerLink Installation and Configuration
The main steps for ServerLink Configuration are as follows:
Configuring ServerLink on Primary Server
Step 1: Enabling ServerLink on a Primary Server
To enable ServerLink options in the Admin Portal, add the following key to cloudconfig.php
Windows Location : C:\xampp\htdocs\config\cloudconfig.php
Linux Location : /var/www/html/config/cloudconfig.php
If ServerLink is disabled, any local data that changes later will never be replicated to other servers later even if ServerLink is later enabled.
- Open the Admin Portal for the site and go to Settings->ServerLink tab, then click the Settings tab.
- Enable ServerLink by checking Enable ServerLink.
- Enter a ServerLink nickname for this server. Once set, this name can not be changed. Make sure this name is unique among all the servers doing ServerLink. replication. For example: you can set a name like austinhq for the headquarters and names like parisbranch, singaporebranch for the branch offices.
- Enter a strong ServerLink security key. This key is used for all ServerLink communications.
Configuring ServerLink on Secondary Server
If you are setting up a secondary server for an existing primary server, it is important that you copy the primary site completely to the secondary site first.
Enabling ServerLink on a site without an original copy of primary data may result in data missing on the secondary site if the primary data is not fully replicated.
For every secondary FileCloud ServerLink server, the following steps must be done:
- Copy all data from primary ServerLink server (primary should have ServerLink enabled when copy is done)
- Install a license with ServerLink component enabled
- Enable ServerLink
- Set the primary URL and the primary Password
- Run the ServerLink client app
Step 1: Copy data from Primary ServerLink server
To start a secondary server, make sure first to enable ServerLink on the primary and then copy the file data as well as the MongoDB databases to the secondary server. In many cases, it might be simple just to clone the primary (if it is a virtual machine).
It is important to ensure that the copy is done only after ServerLink is enabled. Making a copy without enabling ServerLink will mean changes made after the copy might not get replicated to the secondary servers.
Step 2: Install ServerLink enabled License
To enable serverlink on a secondary server, you need a special license file, as ServerLink is licensed separately from the main product.
Step 3: Enabling ServerLink
To enable ServerLink options:
Add the following key to cloudconfig.php
Open the Admin Portal for the site and go to Settings->ServerLink tab.
Enable ServerLink by enabling the "Enable ServerLink" checkbox.
Add a ServerLink nickname for this server. Once set, this name can not be changed. Make sure this name is unique among all the servers doing ServerLink replication. For example: you can set a name like austinhq for the headquarters and names like parisbranch, singaporebranch for the branch offices.
Add a strong ServerLink security key. This key is used for all ServerLink communications.
Note: In FileCloud Version 19.3, the Disable SL AutoLink checkbox was removed from the Local Server settings.
Step 4: Set Primary URL and Password
- Open the Admin Portal for the site and go to Settings->ServerLink tab.
- Set the Enable Replication with Primary option
- Enter the primary Server URL in Primary Server URL. This should be publicly available and accessible from the secondary site. For example: https://mainhq.codelathe.com
- Enter the primary Server's security key; this should match what was entered as the security key on the primary site. ServerLink will not work if the security key doesn't match.
Step 5: Running ServerLink Client
- Open an Administrator command prompt
Navigate to the XAMPP folder
Register the ServerLink Client service
slclient.exe /registerService /displayName="FileCloud ServerLink Client Service"
Start the ServerLink Client service. The server link client is now running and server to server replication should start.
net start slclient
To stop the ServerLink Client Service
net stop slclient
To completely remove the ServerLink Client Service
For Ubuntu versions of Linux, run the following commands:
curl --location https://patch.codelathe.com/tonidocloud/live/3rdparty/slclient/deb/slclient.service -o /etc/systemd/system/slclient.service systemctl daemon-reload systemctl enable slclient.service service slclient start
For RHEL/Centos versions of Linux, run the following commands:
curl --location https://patch.codelathe.com/tonidocloud/live/3rdparty/slclient/rpm/slclient.service -o /etc/systemd/system/slclient.service systemctl daemon-reload systemctl enable slclient.service service slclient start