In-place upgrade

This method, upgrades your BaruwaOS 6 system in place to BaruwaOS 9. The upgrade process is automated using a script that is interactive and will prompt you for confirmation and input at various points.

The system will reboot several times, you need to login after each reboot and the upgrade process will continue automatically as soon as you are logged in.

Upgrading

Review the release notes for BaruwaOS 9.8 and read the updated documentation before you proceed with the upgrade.

Change Management

Ensure you follow your organization change management policy and schedule downtime as well as plan how to revert.

The upgrade will take between several minutes to several hours per server. We recommend you schedule a migration window of 12 hours.

Backup your system

Take a disk level backup of your system. If using physical hardware make sure to take a disk level backup of your system using a live CD. For virtual systems shutdown the system and make a copy of the disk image or take a snapshot using your virtual systems snapshot method.

Before you proceed, ensure that you have tested reverting the image that you have taken and that the restoration works correctly.

Download the restoration creation script

Login to your system as root. Download the restoration creation script to your system as follows:

cd /root; curl -LO https://www.baruwa.com/files/create-restore.sh

Create the restoration script

Make the backup creation script executable by running the following command:

cd /root; chmod +x create-restore.sh

Now run the backup creation script which will create a restoration script which you will use on a newly installed BaruwaOS9 system to restore your data.:

cd /root; ./create-restore.sh

Copy the restoration script generated by the above command to your/another computer.

SSH keys

Ensure that you have set SSH keys for the root user prior to commencing the upgrade. Password SSH access for the root user will be disabled by the upgrade.

Console access

The upgrade cannot be performed over SSH, ensure that you have console access to the system before proceeding.

Download the upgrade script

Login to your system as root using the console. Download the upgrade script to your system as follows:

cd /root; curl -LO https://www.baruwa.com/files/upgrade-os.sh

Start the upgrade

Once the script has been downloaded, you are ready to start the upgrade. The script will upgrade your system from BaruwaOS6 to BaruwaOS 9, via BaruwaOS 7 and BaruwaOS 8. The upgrade is not complete until the script indicates that the process has been completed successfully.

The system will reboot several times during the upgrade, on each occassion you will be prompted to confirm the action.

You need to log back into the system after each upgrade, for the process to continue.

During the final stage of the upgrade you will be required to enter your baruwa-setup password to enable baruwa-setup for configure your system.

The upgrade is an interactive process so please watch the process to ensure you do not miss any prompts.

Make the upgrade script executable by running the following command:

chmod +x upgrade-os.sh

Start the upgrade by running the following command:

./upgrade-os.sh

Monitor the console

Monitor the console for prompts and issues.

If you run into any issues please contact Support

Failed upgrades

If the upgrade fails and the issue cannot be resolved at the moment, revert your system back to the previous state using your disk image backup.