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

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 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 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.

https://resourcexpress.atlassian.net/wiki/spaces/RSG/pages/478969963

https://resourcexpress.atlassian.net/wiki/spaces/RSG/pages/479002704

The following macros are not currently supported in the footer:
  • style