In this article, you'll find instructions to upgrade to Version 16.0, as well as prerequisites required prior to performing the upgrade. Learn more about the feature enhancements in Version 16.0.
WARNING:
This version is compatible with supported browsers Chrome, Firefox, and new Edge (Chromium).
Due to high interest in the 16.0 upgrade, we are prioritizing new customer installations and professional services. Should you wish to proceed with upgrading to 16.0, please take appropriate backups (both database and webserver files), including a server snapshot. In the event of any issues during the upgrade process, please report any screenshots, upgrade logs, or questions to our support team and if the site is inaccessible, please restore both the database and files from the appropriate backups.
Prep for Upgrade
Preparation is key to a successful upgrade. Ensure all of the following items have been checked off before beginning your upgrade.
Start by reading the Upgrade Process Overview article to understand the entire process.
- Reach out to the technical support team to receive the upgrade file.
- Confirm the web server has the following minimum Server Specifications for 16.0:
- CPU: 1 * Quad Core
- RAM: 16GB
- Apply the latest patch for your version to the intranet (15.5 Patches). The minimum patch version for this upgrade is 15.5.2.
Upgrade Process
Prior to starting your upgrade, back up your intranet database and application files, as outlined in the Upgrade Process Overview article. Do not proceed with your upgrade if you haven't backed up files.
Note: Computers running Windows 10 or Windows Server 2016 apply a 'block' attribute to zip files when downloaded. Right-click > select Properties > look for Security > check the box beside Unblock and click Apply.
- Stop the SQBoxTaskManager service on the webserver before proceeding
- Don't extract the contents of the zip file as the software will do this automatically.
- On your intranet, go to the Admin area and click the Setup tab (previous versions may have a 'Site Settings' or 'Settings' tab)
- Click the link click here next to Manual Upload (In previous versions, the wording may be different but the option is still the same)
- In the file explorer, locate and select the downloaded patch zip
- Click Install
- Type in the Lucee Admin and Lucee Server password (contact Support for the default password, or Reset your Lucee Password)
- Allow the update process to complete
- Start the SQBoxTaskManager service on the webserver.
Install Complete
Once the update has finished installing, the browser will refresh and reveal your new version number. If the page appears to stay on the install screen for longer than 10 minutes, try refreshing the page, as the updater may have timed out.
Troubleshooting
If you encounter an error like this when applying this update:
Please open up your Lucee Server edition (orange background) and select 'Applications' and make sure your Compress tags extension is at 1.0.0.2.
Should you encounter any issues during this process please contact support@intranetconnections.com for assistance.
If the upgrade / patch file disappears from the admin page after uploading
Please delete the updates.xml and announcements.xml files from the Updates folder on the web server. Once they are removed, please put the patch in this file path and refresh the intranet. From there 16.0 should be available for you to install.