Filecloud Server Version 20.2 Upgrading Filecloud Filecloud Server Version 20.2 Upgrading Filecloud
Total Page:16
File Type:pdf, Size:1020Kb
FileCloud Server Version 20.2 Upgrading FileCloud FileCloud Server Version 20.2 Upgrading FileCloud Copyright Notice © 2020 CodeLathe Technologies, Inc. All rights reserved. No reproduction without written permission. While all reasonable care has been taken in the preparation of this document, no liability is accepted by the authors, CodeLathe Technologies, Inc., for any errors, omissions or misstatements it may contain, or for any loss or damage, howsoever occasioned, to any person relying on any statement or omission in this document. Any questions regarding this document should be forwarded to: CodeLathe Technologies, Inc. 13785 Research Blvd, Suite 125 Austin TX 78750, USA Phone: U.S: +1 (888) 571-6480 Fax: +1 (866) 824-9584 Email: [email protected] 1. Upgrade FileCloud . 4 1.1 Upgrade using Admin Portal . 6 1.2 Upgrade using Update Tool (Windows Only) . 9 1.3 Release Notifications . 13 1.4 Backup FileCloud Before Upgrading . 14 1.5 Manually Updating Windows . 15 1.6 Run the LINUX Upgrade Script . 19 Upgrade FileCloud The ability for an administrator to be notified by email if a new update or upgrade can be installed is available in FileCloud Server version 18.2 and later. Administrators must keep FileCloud Server up-to-date with the latest version to take advantage of the new features, enhancements, and fixes for issues found in previous versions. How do I know if an upgrade is available? CodeLathe will always inform customers when a new upgrade is available. When you log on to the Admin Portal, the Admin Dashboard will also alert you to the fact that you can install an update. The Version section is right next to the License section on the Dashboard. To check for updates on a weekly basis: 1. Open a browser and log in to the Admin Portal. 2. From the left navigation panel, click Settings. 3. On the Manage Settings screen, select the Admin tab. 4. Scroll down to the Check For Updates checkbox. 5. Select the checkbox and then click Save. To stop receiving the weekly email, just clear this checkbox. 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: C:\xampp\apache\conf\httpd.conf C:\xampp\apache\conf\extra\httpd-filecloud.conf Release Upgrade Scenarios Upgrade Notes Release Notes 4 20.1 Upgrading from ANY VERSION to 20.1 20.1 Upgrade Notes 20.1 Release Notes New Message Queue System is a REQUIRED service that needs to be running for FileCloud to be functional from 19.1 onwards Please ensure the Message Queue Service is running after upgrade before opening up for live access You CANNOT upgrade Windows and Linux using the Admin Portal. 19.3 Upgrading from ANY VERSION to 19.3 19.3 Upgrade Notes 19.3 Release Notes New Message Queue System is a REQUIRED service that needs to be running for FileCloud to be functional from 19.1 onwards Please ensure the Message Queue Service is running after upgrade before opening up for live access You CANNOT upgrade Windows and Linux using the Admin Portal. 19.1 Upgrading from ANY VERSION to 19.1 19.1 Upgrade Notes 19.1 Release Notes New Message Queue System is a REQUIRED service that needs to be running for FileCloud to be functional from 19.1 onwards Please ensure the Message Queue Service is running after upgrade before opening up for live access You CANNOT upgrade Windows and Linux using the Admin Portal. 18.2 Upgrading from 18.1 to 18.2 18.2 Upgrade Notes 18.2 Release Notes There are no operating system or software update requirements You can upgrade Windows and Linux FileCloud instances using the Admin Portal Upgrading from 17.3 or older to 18.2 A full system upgrade is required for all existing installations 18.1 For all versions before 18.1: 18.1 Upgrade Notes 18.1 Release Notes A full system upgrade is required for all existing installations Backup FileCloud Before Upgrading There are various ways you can complete an update: For releases that DO NOT require a full system upgrade: Upgrade using Admin Portal For releases that DO require a full system upgrade: WINDOWS: Update Tool LINUX: Upgrade Script 5 Upgrade using Admin Portal Upgrade Steps Updating Systems That Cannot Connect Outside Updating CentOS Systems If you are using Linux or if you are upgrading just the FileCloud application, you can upgrade your installation using the steps below. Upgrade Steps 1. Login into the admin UI. Click Upgrade at the bottom of the navigation panel. If there are no new updates available, the Manage Upgrade window appears as: If there is an upgrade available, the Manage Upgrade window appears as: 6 1. 2. If there is an upgrade available, click Start Upgrade. The following window opens: 3. Click OK. The upgrade process begins. When it is complete, messages similar to the following appear on the Manage Upgrade page. 7 3. 4. In the navigation bar, click Installation Checks directly above the Upgrade link and make sure that the installation is free of errors. 5. Refresh the browser UI (Ctrl + F5) to get the latest updated User Interface. Updating Systems That Cannot Connect Outside If your FileCloud server cannot connect to our update server to download the packages directly, you can download the file_cloud.zip to a local folder and update your installation using the local path. Open the WWWROOT\config\cloudconfig.php file and edit the following entry for example, if the zip folder is located in c:\users\administrator\Downloads folder, then simply do the following: define("TONIDOCLOUD_UPDATE_URL_OVERRIDE","file://C:\\Users\\Administrator\\Downloads\\file_cloud.zip"); Updating CentOS Systems In CentOS, live admin UI upgrade is not possible due to OS security restrictions. However, the update zip can be downloaded and then upgraded. Before the upgrade, make sure to disable SELinux. Download the upgrade zip file and assign rwx permissions to the file_cloud.zip file and its parent folder. For example, if your zip path is /opt/fcupgrade/file_cloud.zip, then do the following: CentOS Permissions cd /opt chmod 777 fcupgrade chmod 777 file_cloud.zip Then open the WWWROOT\config\cloudconfig.php file and update the value of the following entry with your zip file location. define("TONIDOCLOUD_UPDATE_URL_OVERRIDE","/opt/fcupgrade/file_cloud.zip"); 8 Upgrade using Update Tool (Windows Only) STEP 1: Backup existing installation FileCloud installation environment Backup steps Windows OS and installation without backup tool Windows manual backup STEP 2: Preparing for update 1. Download the FileCloud Windows Update Tool from http://patch.codelathe.com/tonidocloud/live/installer/cloudupdatetool.zip 2. Unzip the downloaded package. a. Extract all files from Zip into a folder. 3. Download the FileCloud Windows Update Package . 4. Copy filecloudupdate.zip file into "cloudupdatetool" folder. 5. Now, navigate to "cloudupdatetool" folder and double click on "cloudupdate.exe" binary to launch. The following window opens: 9 STEP 3: Update 1. Open the "FileCloud Control Panel" and click on "Stop" against these running services. ( If you are upgrading a 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 the "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 on "Start" on the CloudUpdate application 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 our suport ([email protected]) if you see any errors in this step. 10 3. 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. 11 5. 6. Message Queue is an important service and must be started after the upgrade. 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. 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. " For Filecloud upgrade on Cluster, Please contact [email protected] 12 Release Notifications You can learn about new FileCloud Server releases in the following ways: By subscribing to the FileCloud Mailing List By seeing the version update in the FileCloud Admin Portal Mailing List When you register with CodeLathe, you will automatically be added to the FileCloud Mailing List. If you are not receiving FileCloud emails, you can Subscribe to the FileCloud Mailing List. Admin Portal When you log in to the Admin Portal, the default view on the dashboard includes update information, as shown in Figure 1. Figure 1. Sample Admin Dashboard 13 Backup FileCloud Before Upgrading Before any updating current FileCloud installation, it is important to backup your data! Based on your installation environment, choose one of the following links to perform backup: Linux tool backup Linux manual backup Windows manual backup 14 Manually Updating Windows New versions of FileCloud might be released from time to time and it might be important to keep your FileCloud installation up to date so that you get all the latest bug fixes, security patches and new features.