In this article, you'll find instructions to upgrade to Version 16.5, as well as prerequisites required prior to performing the upgrade. Learn more about the feature enhancements in Version 16.5.
WARNING:
This version is compatible with supported browsers Chrome, Firefox, and new Edge (Chromium).
Due to high interest in the 16.5 upgrade, we are prioritizing new customer installations and professional services. Should you wish to proceed with upgrading to 16.5, 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.5:
- CPU: 1 * Quad Core
- RAM: 16GB
- Make sure you are on version 16.0 before starting this process.
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
- If you see two password fields like in the below screenshot, then type in the Lucee Admin and Lucee Server password (contact Support for the default password, or Reset your Lucee Password).
If not, see the first Troubleshooting step below. - 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 only see one password field when installing the upgrade. like this:
Download this file
On your web server, put the file under the path /Intranet/Admin/SiteSettings
Refresh the page.
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.