Upgrade using Update Tool (Windows Only)

Pre-upgrade:

Please read the appropriate upgrade notes for the version you are upgrading from before proceeding with the following steps.

STEP 1: Backup existing installation

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)

   • FileCloud Windows Preupgrade Package from https://patch.codelathe.com/tonidocloud/live/installer/filecloudpreupgrade.zip

   • FileCloud Windows Preupgrade XML - Right-click and save the file https://patch.codelathe.com/tonidocloud/live/installer/filecloudpreupgrade.xml

   • FileCloud Windows Update Package from https://patch.codelathe.com/tonidocloud/live/installer/filecloudupdate.zip

   • FileCloud Windows Update XML -  Right-click and save the file https://patch.codelathe.com/tonidocloud/live/installer/filecloudupdate.xml

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 confirm that each service you are using is running, and that your storage is in the READY state.
   

   

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.