Upgrade Notes for FileCloud 23.1 or Later

Backwards Compatibility Notes

You cannot upgrade Windows and Linux using the Admin Portal.

Beginning with Version 21.1, the files to download when upgrading with the Windows Update Tool have changed. The new files are listed below under Upgrade for Windows and with the full upgrade procedure in the documentation page Upgrade using Update Tool (Windows Only)

Upgrading

As always, make a full backup of your existing installation before upgrading.

If your installation of FileCloud uses admin portal user access restrictions, please see Restricting Access To Admin UI Based On IP Addresses for updated instructions.

Upgrade instructions for Windows

For all upgrades, once upgrade is complete, refresh the browser using CTRL-F5 to clear any prior setup information from the cache.

You can use the Windows Upgrade tool to do a full upgrade.

Windows Update Tool

Beginning with FileCloud 21.1, there are new files to download which are listed in the updated steps 1-3 of the upgrade procedure, below.

  1. Download the FileCloud Windows Update Tool from https://patch.codelathe.com/tonidocloud/live/installer/cloudupdatetool.zip

  2. Extract all files from cloudupdatetool.zip into a folder. 

  3. Download the following files and copy them to the extracted folder (the cloudupdatetool folder)

       Now, go to Upgrade using Update Tool (Windows Only) and proceed from Step 4.

To upgrade systems running ServerLink, the following steps should be taken:

  1. Before upgrade, ensure all ServerLink nodes are fully synced and are at the same state.
  2. Make backups of all nodes as needed
  3. Upgrade the primary node first.
  4. Upgrade each secondary node after upgrading the primary node.
  5. Start up all nodes

FC Push Service Configuration

In FileCloud version 23.1, a Push service has been added to allow clients (in particular, FileCloud Desktop) to receive server-initiated notifications (for example, file upload, share). Upgrading to FileCloud 23.1 or higher on systems running with MongoDB replica set or standalone MongoDB requires the push service env file to be updated based on the MongoDB configuration.

To configure the Push service in Linux:

  1. Open and edit the .env file from path: /opt/fcpushservice/

    vi /opt/fcpushservice/.env
  2. Update the MongoDB connection string:

    FCPS_DB_DSN=mongodb://dbuser:passw0rd1@dbserver01,dbserver02,dbserver03:27017
  3. Restart the fcpushservice.

    systemctl restart fcpushservice
To configure the Push service in Windows:

  1. Open the file xampp\pushservice\.env for edit.
  2. Update the MongoDB connection string to:

    FCPS_DB_DSN=mongodb://dbuser:passw0rd1@dbserver01,dbserver02,dbserver03:27017
  3. Restart the Push service in the FileCloud control panel.


If you use special characters in any of the passwords, above, you must URI encode them. For example, if the password is password@2090 specify it as:

mongodb://dbuser:password%402090@localhost:27017