Theme

Upgrading from v6 or v7 to v8 on Linux ​

System requirements ​

Before starting, make sure your Linux system meets the requirements for Syncplify Server! v8, and that you have administrative privileges (root or sudo).

DANGER

The procedure below applies only to standalone servers. If you run a Syncplify Server! v6 or v7 HA cluster, follow Upgrading a v6 or v7 HA cluster to v8 instead.

Prerequisites checklist ​

  • Take a full system backup or a VM snapshot, to go back in time quickly should anything bad happen.
  • Have a working Syncplify Server! v6 or v7 installation.
  • Have a valid license with an active maintenance and support plan (as a general rule, an active plan is required for all upgrades).
  • Have root or sudo privileges on the target system.
  • Take a backup of the current configuration from the SuperAdmin UI (recommended).

Perform the upgrade ​

  1. Download the most recent version of the software for your architecture from syncplify.com/download.
  2. Extract the archive in a temporary location.
  3. Open a terminal in the directory where you extracted the installation files.
  4. Type sudo ./ss-setup install and follow the on screen prompts.

The one line bootstrap commands on the Linux setup page do the same download, extraction and installation in one go.

Post upgrade steps ​

After the upgrade completes successfully:

  1. Clear your browser cache if the interface appears outdated.
  2. Test every configured virtual site.
  3. Verify that user accounts and permissions are intact.
  4. Review the v8 manual for the new features.

In the rare case where the v6 or v7 database cannot be exported, the upgrade stops with an error; Upgrading from v6 or v7 to v8 when everything else fails covers that case.