On-Prem Upgrade Guide (V5.x to V5.x/V2021.x Only)
Overview
This guide covers the process of upgrading your ResourceXpress system to the latest version in order to benefit from the most recent features and enhancements. Whilst this guide is designed to be fully comprehensive, should you have any queries or run into any problems during the upgrade, please contact helpdesk@qedas.com for assistance.
To obtain the latest upgrade files and an updated licence please contact helpdesk@qedas.com. Please note licence requests can take up to 24 hours to process (Monday to Friday) so please request as soon as possible prior to installation of software.
Upgrade steps:
Â
Upgrade Procedure
Important Consideration - Create Backups
Before proceeding with the upgrade steps below it is important to backup both the applications SQL database (via SQL Server Management Studio) and the application install directory (typically C:\inetpub\wwwroot). Failure to take the appropriate backups could result in loss of data, customization or application configuration.
After the backups are created, extract the software kit provided by our helpdesk onto the ResourceXpress server.
Important note regarding .NET Framework
.NET Framework 4.8 is required for ResourceXpress 2021.5 and above.
Database Upgrade
Step 1: Open SQL Server Management Studio (SSMS) and login to the local or remote SQL server that hosts the application database.
Step 2: In the left pane expand Databases and right-click on rxpress or the name of the database that ResourceXpress is using and select New Query.
Step 3: Identify your current RX version from the list of upgrade options (e.g. RxOnPrem V5.x to V5.x/V2021.x).
Copy the entire contents of the SQL file into the query window and execute the script. Alternatively, you can select File - Open - File in SSMS - select the required script - Execute.
Application Upgrade
Step 1: Uninstall your current ResourceXpress Version.
Go to Control Panel - Programs and Features and uninstall your current version of ResourceXpress.
Â
Step 2: Install the new version of ResourceXpress.
From the extracted software kit, open the app folder and run setup.exe to install the new version of ResourceXpress.
File Configuration
Licence
Step 1: Navigate to the application installation directory, typically C:\inetpub\wwwroot and locate the ResourceFiles folder.
Step 2: Rename your current licence file mm.lic to mm.lic.OLD.
Step 3: Copy your new licence file to the ResourceFiles folder and be certain that the new file is named mm.lic.
Web.config
Step 1: Navigate to the application installation directory again and locate the Web.config file.
Step 2: Open this same Web.config file in the backup that was created at the beginning of this process. Locate the connectionStrings tags at the bottom of the file and copy & paste into the new Web.config file.
Other Files
The below lists other application files that are overridden during an upgrade. If you have made any changes or replaced any of these files for your deployment please copy the old files from the backup into the new relevant location.
Filename | Location |
---|---|
NLog.config | C:\inetpub\wwwroot |
any template (.html) files | C:\inetpub\wwwroot\Templates |
any image files replacing default images | C:\inetpub\wwwroot\meetingmonitor\images C:\inetpub\wwwroot\meetingmonitor\images\<second_language> C:\inetpub\wwwroot\meetingmonitor\gen\images C:\inetpub\wwwroot\meetingmonitor\images\gen\<second_language> |
IIS Restart
Once all the steps above have been completed and a new licence has been installed, it is recommended that you restart the Internet Information Services (IIS) Manager.
Step 1: Type IIS in the search bar and open Internet Information Services (IIS) Manager
Step 2: Select the Server Name in the left pane under Connections.
Step 3: In the right pane under Actions - Manage Server click on Refresh.
Verify Upgrade
The upgrade is now complete. You can now log in to ResourceXpress and verify that it is running the new version on the top-right corner of your application.
If you have any issues during your upgrade please contact helpdesk@qedas.com.
Server Add-Ons Upgrade
If you have any of our server add-ons installed and running (i.e. Scheduler Task or Push Service), you may need to uninstall your current version and install the latest versions of these as well. Below is a table to show which version of the server add-on you will need depending on the version of ResourceXpress you are running.
If a new version is required it will be supplied with your upgrade kit.
ResourceXpress Version | Scheduler Task Version |
---|---|
ResourceXpress V5 | Scheduler Task v0.3 |
ResourceXpress V5.1 | Scheduler Task v0.3 |
ResourceXpress V5.3 | Scheduler Task v0.4 |
ResourceXpress V5.4 to V2021.5 | Scheduler Task v0.5 |
ResourceXpress V2021.6 to V2022.3 | Scheduler Task v0.6 |
ResourceXpress V2022.4 to V2022.5 | Scheduler Task v0.8* *requires .NET Framework 4.8 |
ResourceXpress V2023.1 or above | Scheduler Task v0.9 |
ResourceXpress Version | Push Service Version |
---|---|
ResourceXpress V2021.2 or earlier | Push Service v0.6 |
ResourceXpress V2021.4 or above | Push Service v0.8* *requires .NET Framework 4.8 |
If a version upgrade is required, please uninstall your current version and install the latest using the guides below.
- style