How to upgrade your N2W server using a patch

Summary

This article explains how to upgrade your N2W server using the patch method.

Please note upgrading using patch does not upgrade Apache/OS

Description

Upgrade Diagram:

General Information

1. It is recommended to deploy the patch when you have no active backup policies, DR or recovery running. as it will restart Apache and require few minutes of downtime.

2. When using patches to upgrade N2W instead of the AMI upgrade, be sure that you check your current version to ensure that the patch you are using is compatible with your current version of N2W. If the patch is not compatible with your current version of N2W, you will get a warning like the example below.

3. We recommend that you read both this KB and watch this short 3 min Video Tutorial - How to upgrade N2WS using the patch method

Permissions

1. Due to the new functionality, you may need to update your permission policies.

Please see the JSON templates attached to the following KB articles:  AWS Minimal Permissions, Azure Minimal Permissions

2. Update the relevant roles with the new permissions files.

Steps to install patch

Before doing any upgrade steps, make sure that you create a snapshot of the CPM data volume and that you know how to recover

1. Read all the steps before starting.

2. Download the N2W upgrade patch from the Release Notes of the latest version of CPM found here - CPM Release Notes

3. Go to General Settings, then choose "Patches".

4. Click "choose file" and browse to the patch file and open it.

5. The file name should now appear in the window, then click on "upload and install".

6. You will get a confirmation window like the one below. Click "Upload and Install" and the patch will begin the installation. The confirmation window will stay up until the patch completes its install. This will usually only take a few minutes. The window will close itself when complete.

7. Once it completes and the install confirmation window closes, you will get a message that install was successful in the top right and the patch should now be listed with an install date.

Note: please wait at least a minimum of 10 minutes even if UI say’s successful. Then refresh the browser with "shift +F5" to clear the browser cache. 

If you used a password protected SSL certificate and the website doesn’t load anymore after applying the patch and waiting 10 minutes, please connect to the N2W Server via SSH and your Key, then restart apache2 with this command: sudo service apache2 restart

You will be prompted to enter the password/passphrase at this step. Once apache2 was restarted, the website should load normally.

Confirmation Steps

1. Click on the help link (?) in the top right and choose "about" to verify the patch was applied and N2W is now on the updated version.

2.  You should see the updated version from the patch that you just applied like my example below.