How do I upgrade/downgrade entire Sinefa software images?

Sinefa probes use incremental updates, which minimizes the time and disruption of performing software upgrades. Much like package based operating systems, such as Redhat or Ubuntu Linux, only software packages that have changed are updated.

Sinefa probes can also perform a complete image-based install in order to upgrade or downgrade the entire software image. This is useful for software rollbacks or when wanting to quickly upgrade from older versions.

The process below can be followed to completely install a new Sinefa software image that is either newer (upgrade) or older (downgrade) than what is currently installed.

Currently, this process can only be performed by logging into the probe's CLI (using SSH or serial console).

Step 1: Prepare for the upgrade/downgrade

Method One: Download the Sinefa software image from the Internet

1. Update the index of available versions.

system.recovery image update index

2. List the versions available for download.

system.recovery image list

3. Download the image of the desired version (from the above list).

system.recovery image fetch version <version>

4. Install the image of the desired version into the recovery partition.

system.recovery partition install version <version>

Method Two: Install the Sinefa software image from local storage

This method can be used to install the software image from local storage, for example when no network or internet connection is available. This can be done from version 29.2.0, onwards.

1. Make the Sinefa software image available locally on the Sinefa probe. You can either:

1. Copy the image using scp to the probe, e.g.
   scp <image_file> admin@<probe_ip>:./
2. Login to the probe's shell (from the probe's menu, go to System -> Shell) and download the image using wget, e.g.
   wget <image_url>
3. Put the image into the root folder of a USB stick and plug this into the probe.
4. Put the image file into the root folder of an ISO image and mount this image as a CDROM drive (this option is useful for virtual probes).

2. If you inserted a USB drive or attached an CDROM drive, you will need to mount these devices, if you copied the image file using scp or wget you can skip this step.

system.mount mount all

3. Install the image into the recovery partition.

system.recovery partition install version <version>

E.g. system.recovery partition install version 29.2.0

Step 2: Perform the upgrade/downgrade

Install the version in the recovery partition, restoring config and rebooting into the new image.

system.recovery reimage restore reboot

Note: If you rolled back to a previous version and want to stay on that version, you should disable auto-updates (from the UI, under Settings -> Probes) to prevent the probe from automatically updating to the latest version.