Before upgrading to a newer version, it is important to check the current version to receive the correct upgrade file.

To check the current version from the front-end of the solution, click Help then About. From the Administration screens, click Info then About. This will display the current Username, Language, CXAIR Version and Browser Details.

When upgrading to a new version, there are two methods available. Depending on the version being upgraded from, it can be installed using a .jar or .war file. When performing a major upgrade, a .jar file will be required.

Before starting either upgrade procedure, the CXAIR service/Daemon must be stopped, the cache must be cleared from the internet browser and all instances of the Mozilla Firefox internet browser must be closed. This includes using the Windows Task Manager to end any processes.

Java Paths

If the version of Java has changed, the relevant CXAIR configuration files must be changed to point to the new Java version. These files are found in the following locations:

<install path>\CXAIR\controller\conf\wrapper.conf  

<install path>\CXAIR\wrapper\conf\wrapper.conf

<install path>\CXAIR\wrapperindexer\conf\wrapper.conf

<install path>\CXAIR_Database\conf\wrapper.conf

Open each file in a text editor and amend the Java path. For example:

wrapper.java.command=C:/Program Files/Java/jdk-13.0.1/bin/java.exe

On Windows installations, the CXAIR service will need to be reinstalled once this change has been made.

Run the uninstaller using the following file:

<install path>\CXAIR\wrapper\bat\uninstallService.bat

Then reinstall using the following file:

<install path>\CXAIR\wrapper\bat\installService.bat  

Using a .jar File

Running an upgrade using a .jar file requires the same process as the initial installation. When the installer is executed, the Command Prompt or Terminal window will indicate:

IS_UPGRADE=true

Following the upgrade, the service will need to be restarted.

Using a .war File

Running an upgrade using a .war file does not require an installer, only the relevant upgrade file. A .war file can be installed automatically or manually.

Automated Installation

Navigate to the Upgrade CXAIR screen by clicking Setup, System then Upgrade CXAIR.

Either click Choose File and select the relevant .war file, or drag and drop it to the box below to begin the installation.

Once the file has been uploaded and verified, a pop-up will appear. Click OK to commence the upgrade process, or Cancel to return to the previous screen. If cancelled, the file will remain available to start the upgrade process at a later time.

After confirming the upgrade in the subsequent pop-up, the installation will be started and the CXAIR service will be restarted. This will log out all users.

After logging back in, the upgrade needs to be verified. This enables users to make the relevant tests and roll-back to a previous version if any issues arise. To verify a successful upgrade, navigate back to the Upgrade CXAIR screen by clicking Setup, System then Upgrade CXAIR. Click Verify to confirm the successful upgrade to complete the process. If not verified before logging out, the system will revert to the previous version automatically.

All uploaded .war files will remain available to allow the system to be reverted to a previous version manually. Click the Install button next to the relevant version to change to a specific build, or click the X icon to delete it from the server. The options for the currently installed version will not be available.

Please note that when a .jar upgrade is completed, all previously uploaded .war files will be deleted.

Manual Installation

Navigate to the CXAIR folder and locate the CXAIR.war file. Rename this to CXAIROLD.war to maintain the original file.

Next, rename the upgrade file to CXAIR.war and move it into the CXAIR folder.

Following the upgrade, the service needs to be restarted.

Accessing CXAIR

Following a successful install and with all services running, enter the following URL into the address bar a supported internet browser:

http://<server name or IP address>:<port number>/cxair

The <server name> is the name of the server where CXAIR is installed and <port number> us the port number Tomcat is configured to use. By default, this will be set to 6453, but can be configured changing the tomcat.properties file located in:

CXAIR\wrapper\com\connexica\cxair\tomcat

Please refer to the Accessing CXAIR chapter for more information.

System Optimisation

Following a successful installation, it is recommended that the performance tuning settings are optimised to match the server specification. Please refer to the System Settings chapter for more information regarding the necessary parameters.