Skip to end of metadata
Go to start of metadata

Introduction

The main steps for ServerLink Configuration are as follows:

Configuring ServerLink on Master

Step 1: Enabling ServerLink on a Master 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

define("TONIDOCLOUD_SERVERLINK_SHOW", 1);

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.

  1. Enable ServerLink by enabling the "Enable ServerLink" checkbox.
  2. Choose 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.
  3. Choose a ServerLink security key. Choose a really secure and hard to guess security key. This key is used for all ServerLink communications.

Configuring ServerLink on Slave

If the slave server is being setup for an existing master server, then it is important that the master server is completely copied to the slave site first.
Enabling ServerLink on a site without an original copy might lead to missing data in the slave site as all the master server data might not be fully replicated to the slave.

For every slave FileCloud ServerLink server, the following steps must be done:

  1. Copy all data from Master ServerLink server (Master should have ServerLink enabled when copy is done)
  2. Install a license with ServerLink component enabled
  3. Enable ServerLink
  4. Set Master URL and the Master Password
  5. Run the ServerLink client app

Step 1: Copy data from Master ServerLink server

To start a slave, make sure first to enable ServerLink on master and then copy the file data as well as the MongoDB databases to the slave server. In many cases, it might be simple just to clone the master (if it is a virtual machine).
It is important to ensure that the copy is done only after ServerLink is enabled. Doing a copy without enabling ServerLink will mean changes that happen after the copy might not get replicated to the slaves.

Step 2: Install ServerLink enabled License

To enable serverlink on a slave server, you need a special license file as ServerLink is licensed separately from the main product.

To use ServerLink for a slave FileCloud Server, you need a license with ServerLink functionality enabled. Once installed, you can check if the functionality is enabled by opening your Settings->License Tab and verifying the component shown.
 

To enable ServerLink options in the Admin Portal, add the following key to cloudconfig.php

define("TONIDOCLOUD_SERVERLINK_SHOW", 1);

Open the Admin Portal for the site and go to Settings->ServerLink tab.

  1. Enable ServerLink by enabling the "Enable ServerLink" checkbox.
  2. Choose 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.
  3. Choose a ServerLink security key. Choose a really secure and hard to guess security key. This key is used for all ServerLink communications.

Step 4: Set Master URL and Password

Open the Admin Portal for the site and go to Settings->ServerLink tab.


  1. Set the "Enable Replication with Master" option
  2. Enter the Master Server URL for the Master Server. This should be publicly available and accessible from the slave site. For example: https://mainhq.codelathe.com
  3. Enter the Master Server's security key, this should match what was entered as the security key on the Master site. ServerLink will not work if the security key doesn't match.

Step 5: Running ServerLink Client

Windows

  1. Open an Administrator command prompt 
  2. Navigate to the XAMPP folder

    cd c:\xampp
  3. Register the ServerLink Client service

    slclient.exe /registerService /displayName="FileCloud ServerLink Client Service"
  4. Start the ServerLink Client service. The server link client is now running and server to server replication should start.

    net start slclient
  5. To stop the ServerLink Client Service

    net stop slclient
  6. To completely remove the ServerLink Client Service

    slclient.exe /unregisterService

Ubuntu

For Ubuntu versions of Linux, run the following commands:

curl -o /etc/systemd/system/slclient.service http://patch.codelathe.com/tonidocloud/live/3rdparty/slclient/deb/slclient.service
systemctl daemon-reload
systemctl enable slclient.service
service slclient start

RHEL/Centos

For RHEL/Centos versions of Linux, run the following commands:

curl -o /etc/systemd/system/slclient.service http://patch.codelathe.com/tonidocloud/live/3rdparty/slclient/rpm/slclient.service
systemctl daemon-reload
systemctl enable slclient.service
service slclient start
  • No labels