Upgrade Commands

QuantaStor CLI Upgrade Commands

--repoUrl is an optional command that is Used to specify the package repository URL to use for the upgrade. If not specified, the package repository URL will be autodetected from the system’s /etc/apt/sources.list.d/osnexus.list file. During an offline upgrade, this flag need not be used and is auto set to the location of the ISO image.

--repoUrl

--includeKernel Performs a ‘Full Upgrade’ of the kernel and drivers. If the kernel or any drivers are upgraded during this process then a reboot is required for the upgrades to take effect.

--includeKernel

--distroUpgrade distribution upgrades from Trusty to Xenial are the only distro upgrades currently supported. If the distribution is upgraded during this process, then a reboot is required for all the upgrades to take effect. The ‘includeKernel’ command need not be supplied in addition to this flag, as the kernel and drivers will all be upgraded as a part of the distribution upgrade.

--distroUpgrade

--install should be used when performing a fresh install on Xenial (16.04) Ubuntu. It can also be used to fix broken installations.

--install

--skipInstall can be used with an upgrade when QuantaStor is present but not all Xenial QuantaStor packages are installed.

--skipInstall

--offline is used to perform an offline upgrade. Users must copy the desired ISO image into the /mnt/qs-isos directory.

--offline

--allowReboot automatically reboots the system when one is required (after the kernel, driver, and/or distribution upgrades).

--allowReboot

--coreOnly upgrades only the core QuantaStor packages.

--coreOnly

Upgrade Manager Use Cases

Upgrade from Trusty 4.x to Xenial 5.x

Prepare for your upgrade by downloading the latest upgrade manager script:

curl -o /opt/osnexus/quantastor/bin/qs_upgrade.py

Run the upgrade script:

/opt/osnexus/quantastor/bin/qs_upgrade.py --distroUpgrade=True --targetDist=trusty --includeKernel=True --allowReboot=True

Offline Upgrade from Xenial 5.x

First, prepare for your offline upgrade by making directories with the following command:

/mnt/qs-isos and /mnt/qs-isomount

Put the latest QuantaStor ISO into the folowing directory:

/mnt/qs-isos

Next, find and mount the ISO image:

mount -o loop 'find /mnt/qs-isos -name "*.iso"' /mnt/qs-isomount

Copy the upgrade script to a known location with:

cp /mnt/qs-isomount/pool/scripts/qs_upgrade.py /opt/osnexus/quantastor/bin/qs_upgrade.py

Perform a dry run test using:

/opt/osnexus/quantastor/bin/qs_upgrade.py --offline=True --dryrun=True

If the test works, run the upgrade script:

/opt/osnexus/quantastor/bin/qs_upgrade.py --offline=True

This will take the QuantaStor ISO that is in /mnt/qs-isos and mount it to /mnt/cd-test, then configure the apt preference file to use the ISO files for the upgrades. The script then calls itself, specifying repoUrl as the location of the mounted ISO.

Kernel Upgrade on Xenial 5.x

Run the upgrade script:

/opt/osnexus/quantastor/bin/qs_upgrade.py --includeKernel=True

This command will upgrade all QuantaStor core packages as well as the kernel. After the kernel upgrade is finished, the script stops and prints the message stdout advising the user to reboot the system. After the system reboot, the script will run again and verify the latest QuantaStor version.

If --allowReboot is supplied as true, then the script will reboot automatically instead of stopping and printing a message to stdout.

Service Upgrade from 5.x

Run the upgrade script:

/opt/osnexus/quantastor/bin/qs_upgrade.py --coreOnly=True

Core Service Upgrade only on 5.x

Run the upgrade script:

/opt/osnexus/quantastor/bin/qs_upgrade.py

This will upgrade the QuantaStor core packages and perform an apt-get upgrade.