This article shows the steps required to be done to upgrade the base Operating System on the Helpdesk Pilot virtual machine.

We will be following the command line steps to perform the upgrade. 

Considerations:

Before proceeding with the steps, please ensure the following:

• there is at least 500 MB free disk space on the root (/) volume.
• a snapshot of the HDP VM in it's current state is taken and saved successfully. In the event of a failed update we request you to revert to this snapshot to get your app up and running again. 
• Please make sure that you are on version 5.2.10 before proceeding with this upgrade. If not, please upgrade to 5.2.10 first and then start proceeding.

Steps to be done:

1. Login to the Helpdesk Pilot VM as superuser (password: superuser)

2. Type sudo apt-get update

3. Type sudo apt-get dist-upgrade

Press 'Y' on this prompt to continue. 

4. Type sudo apt-get install update-manager-core

Press 'Y' on this prompt to continue.

5. Type sudo nano /etc/update-manager/release-upgrades.d/unauth.cfg to create a new file. Once created type the below lines within the file.

[Distro]
AllowUnauthenticated=yes

Once typed press CTRL+X and Y to save the file.

6. Type sudo do-release-upgrade and press enter.

If you're connected to the HDP VM via SSH (like via Putty or Terminal), you will see a screen like this below. This indicates that the OS upgrade will be performed over SSH on another port - 1022. 

Press 'y' to continue. 

7. The upgrade will now commence and the following screen will show up

Press 'y' to continue and this will start the Ubuntu 12.04 upgrade. 

8. Along the upgrade process you will see screens like these asking for the configuration/reconfiguration of certain packages. Please press the keys mentioned after each of the screenshots below to continue with the upgrade. 

Press 'Yes'(tab) and press Enter to continue. 

Press 'N' to continue.

A new version of PostgreSQL will be installed, version 9.1. However, version 8.4 will also exist and Helpdesk Pilot will continue to use this version. Press Enter to continue.

Press 'Yes'(tab) and Enter to continue. 

Press 'y' to continue.

Once the upgrade has been completed, you should see this screen this message "System upgrade is complete". A restart of the system is required. Press 'y' to continue.