In this article, you'll find instructions to upgrade to Version 14.5 Elevate Experience, as well as prerequisites required prior to performing the upgrade. Learn more about Version 14.5 features.
This version is compatible with supported browsers Chrome, Firefox, IE11 and Edge. Note: versions of Microsoft IE (10 and below) will encounter layout problems.
- Confirm the version of your software is 14.0.1+ and your organization is currently active on maintenance (if you're not and would like to become active, email email@example.com)
- You must have Super Admin rights on the Intranet
- Web Server access:
- Web Server local admin access - upgrade requires the ability to create a folder on the C drive
- Disable User Access Control
- Disable Anti-Virus software
- Apply pending updates and restart the Web Server
- Check the supported web server requirements for the destination server (note that 2008 R2 will likely also work but is not officially supported).
- ASP.NET 4.5.2 or higher
- DefaultAppPool (Intranet's AppPool within IIS) requires .NET CLR Version set to v4.0
- IIS configuration
- Disable 'Basic Authentication' on the intranet website (e.g. default website)
- SQL Server
- The System Administrator account name and password will be required during the upgrade
- Lucee / Railo Administrator Password
- Example of the path: http://<servername>/lucee/admin/web.cfm
- Default browser
- For new servers, open the default web browser (e.g. Edge) and complete browser configuration.
- Follow the processes outlined for backing up the Intranet Database and application files
Download the 14.5.0 Upgrade zip file(e.g. ICUPG1450.zip)
- Save the file to C:\Temp
- Right-click on the file > click Properties > check the box beside 'Unblock' > click OK
- The Username is the email address of the primary contact we have on file
- The Password is your product serial number (located on your Intranet Admin > Setup tab)
Historical Intranet Statistics
During this upgrade, the time limit for your intranet statistics will automatically be set to 365 days to optimize performance, and all previous historical statistical information will be purged. If you want to compare year-over-year statistics, or retain all of your historical statistical data, and are willing to accept a reduction in performance (extent will depend on your number of users and length of time retained), contact firstname.lastname@example.org prior to upgrading and our Support Team can assist in adjusting your settings.
- Log onto your web server as a local administrator (Domain Administrator logins do not have enough rights)
- Right-click the zipped ICUPG1450.zip folder and select 'Properties', at the bottom of the properties window check if there is an option for 'Unblock' if there is click the unblock option
- Right-click the zipped ICUPG1450.zip folder and select ‘Extract All…’, follow on-screen prompts to complete file extraction on the server
- In the ICUPG1450 folder Open InstallDetails.txt
Copy the content of InstallDetails.txt to your clipboard
- Refer to the image located below the instructions to update the password for the Lucee Web Administrator if this password has been changed
- Navigate to your Intranet
- Go to “Admin” > In “Settings” section > under “Extensions” header > Execute Custom Code (You must be logged in as a Super Admin to see this option)
- Paste into the message box area of the execute custom code box and click “execute”
- Your browser will download an XML file containing configuration details of your intranet
- Save this file and place it on your web server in the ICUPG1450\config folder
- Right-click the start.bat file located in the ICUPG1450 folder > click “Run as administrator”
- Once the upgrade process is complete, the command prompt window will ask you to press any key to exit the upgrader
- Navigate to your intranet Admin page and verify you're on version 14.5 and Lucee version 4.5.5.006
- On the web server, you can now set the User Account Control setting back to its previous level
- You can delete the temporary folder " ICUPG1450" on the web server
- Adjust the memory settings for Lucee and ElasticSearch
- Ensure your scheduled tasks are running (Admin -> Scheduled Tasks) System Tasks should be enabled, Web Services should be enabled unless this is a development environment, and Active Directory Sync should only be enabled if you are using AD Sync
- Ensure that the Stats link in the top right menu brings you to the stats page
- The following day ensure that data is shown on the stats page
Replace 'connections' with your Railo Web Administrator or Lucee Web Administrator password as shown in the image below
Server Error in '/statistics' Application
Depending on the SQL environmental configurations, you may encounter an error regarding the statistics similar to below.
Server Error in '/statistics' Application. Login failed for user 'intranetconnections'. Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about the error and where it originated in the code. Exception Details: System.Data.SqlClient.SqlException: Login failed for user 'intranetconnections'.
This error can be caused by the credentials having been changed for the 'intranetconnections' SQL login. To resolve this, you'll need to update the password found in the connectionstrings.config file to match what the password for the 'intranetconnections' SQL login has been changed to. The default location for the connectionstrings.config file is C:\inetpub\wwwroot\statistics\connectionStrings.config.
Errors During the Upgrade
Depending on environmental configurations, you may encounter an error during the upgrade process. If a problem occurs, the upgrade process will stop and an error message will be displayed in the command prompt window, something similar to below.
You can review the log of what occurred by navigating to the timestamped log file located in IntranetConnectionsUpgrade14.5.0\logs.
The path in the image below is referencing the previous upgrade version, please use IntranetConnectionsUpgrade14.5.0\logs
Please send the contents of the log file to email@example.com to open up a ticket and we'll work with you to resolve any issues encountered.