Upgrade using Update Tool (Windows Only)

If you have folder-level security (granular folder permissions) enabled in Settings > Misc > General, changes in functionality will significantly impact the way existing share behavior works when you upgrade from versions below 23.1 to FileCloud 23.x and higher. If you have granular folder permissions set, please contact FileCloud Support before upgrading to FileCloud 23.x and higher to avoid share and file access issues.

If your system uses MongoDB authentication or custom IP binding, follow the steps at Disable MongoDB Authentication and IP Binding before performing the steps on this page.

For FileCloud upgrade on cluster, see:
FileCloud Update for HA on Windows

FileCloud support is ending for Windows Server 2012 R2 with 22.1 release.
If you are using Cloud Enterprise Server and Windows 2012, please migrate your FileCloud site to Windows 2016, Windows 2019, or Windows 2022.

STEP 1: Backup existing installation

FileCloud installation environment
Backup steps
Windows OS and installation without backup toolWindows manual backup

STEP 2: Preparing for update

  1. Download the latest FileCloud Windows Update Tool from https://patch.codelathe.com/tonidocloud/live/installer/cloudupdatetool.zip
    Note: It is essential that you download the latest version of the update tool; If you run an old version of the tool, you will re-install an old version of FileCloud.

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

  3. If your system allows downloading of files from internet, go to step 5. Otherwise, complete step 4 first.
  4. Download the following files and copy them to the extracted folder (the cloudupdatetool folder)
  5. Now, navigate to the cloudupdatetool folder and double click on (cloudupdate.exe). The following window opens:

STEP 3: Update                     

  1. Open the FileCloud Control Panel and click Stop for each running service. ( If you are upgrading an HA system, stop all the nodes (All DB servers of the replica set as well as the Apache web servers on each of the nodes).) If running Memcache, make sure it is stopped too.

  2. Ensure that Install Folder shows the location of your XAMPP folder. This location is auto-detected, but it may not be able to determine it correctly if there are multiple XAMPP folders. If it is not correct, select the correct XAMPP install folder.

  3. Click Start on the Update Tool dialog box to begin the upgrade. (Repeat steps 1-3 for each of the nodes for HA system).
    The tool must be able to connect to the internet in order to download the update package. Please contact support@codelathe.com if you see any errors in this step.

    If you receive an error message, see Troubleshooting the Upgrade Tool.

  4. If you are running multi-tenant FileCloud, make sure the database post upgrade script is run correctly.

    cd c:\xampp\htdocs\resources\backup
    c:\xampp\php\php.exe fcpostupgrade.php
  5. Once the nodes are updated, start each of the nodes using the cloud control panel.

  6. Message Queue is an important service and must be started after the upgrade.

    Message Queue must be installed. If you cannot click the Start button for Message Queue, it is not installed. Click Install, and once installation is complete, click Start.

  7. Open the install URL http://<your domain>/install/index.php
  8. Make sure basic checks are all OK.
  9. Click on Extended Checks.
    In section 3 of Extended Checks, your new updates are shown with status and available actions.
  10. If Apache is running as the Windows Logon account, then give the logon account write permission on the XAMPP folder.
  11. When you initially log in to the admin portal after upgrade, refresh the browser using CTRL-F5 to clear any prior setup information from the cache.
  12. Beginning in FileCloud 20.1, to sign into the admin portal for multi-tenancy, you must sign in as the superadmin user and enter your password in encrypted format in the multi.php file. See Password encryption and logging in to a multi-tenant admin portal for instructions on encrypting your password.

Upgrade environments using Solr and Solr+OCR


  1. Upgrade FileCloud
  2. Upgrade OpenJDK to version 11.
    1.  Download Open JDK 11.02+9 from https://jdk.java.net/archive/.
    2. Create a new folder in the C: drive.
      (In the example screenshot, jdk-11.0.2 is the name of the new folder.)
    3. Extract the Open JDK file you downloaded into the new folder.
  3. Set JAVA_HOME to the new version's path.

    Setting the path and environment variables will differ depending on the version of Windows you have on your computer. These instructions were designed for Windows 11.

    (warning)  Administrator privileges are required to modify the path and environment variables.

    To set the JAVA_Home path:

    1. Open the Windows Control Panel.
    2. Enter environment variables in the search bar.
    3. Click Edit the system environment variables.

    4. In the System Properties dialog box, click Environment Variables.

      The Environment Variables dialog box opens.
    5. In the System variables box, Click JAVA_HOME, and then click Edit.
      The Edit System Variable dialog box opens.
    6. Change Variable value to the address of the folder you created for jdk, and click OK.
    7. In the Environment Variables dialog box, click OK.
  4. Log in to the FileCloud admin portal.
  5. In the FileCloud Control Panel, and stop and restart Content Search.

Custom settings in configuration files that are replaced during upgrade are not reset in the new configuration files.

Check If the following files are replaced with newer versions during upgrade, and in the case that they are replaced, reconfigure any custom settings after upgrade: