Upgrade Commands - Revision history

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-23T20:59:56Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 20:59, 23 August 2019
Line 6:		Line 6:
	--repoUrl		--repoUrl
	</pre>		</pre>
	'''--includeKernel''' ~~This command is set to True/true when~~ ‘Full Upgrade’ ~~is selected from the Upgrade Manager dialog in the web UI. It can be set to True/true or False/false (capitalization does not matter). When specified as True/true,~~ the kernel and ~~driver upgrades are included~~.		'''--includeKernel''' Performs a ‘Full Upgrade’ of the kernel and drivers.
	If the kernel or any drivers are upgraded during this process ~~(if there are upgrades available and the system is not on the latest versions)~~ then a reboot is required for the upgrades to take effect.		If the kernel or any drivers are upgraded during this process then a reboot is required for the upgrades to take effect.
	<pre>		<pre>
	--includeKernel		--includeKernel

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-23T20:58:30Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 20:58, 23 August 2019
Line 11:		Line 11:
	--includeKernel		--includeKernel
	</pre>		</pre>
	'''--distroUpgrade''' ~~when specified as True/true, the~~ distribution ~~upgrade is included. 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.		'''--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’ ~~flag~~ 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.		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.
	<pre>		<pre>
	--distroUpgrade		--distroUpgrade
	</pre>		</pre>
	'''--install''' should be used when performing a fresh install on a Xenial (16.04) Ubuntu. It can also be used to fix broken installations.		'''--install''' should be used when performing a fresh install on Xenial (16.04) Ubuntu. It can also be used to fix broken installations.
	<pre>		<pre>
	--install		--install
	</pre>		</pre>
	~~Can be set to True/true or False/false (capitalization does not matter). Can~~ be used with an upgrade when QuantaStor is present but not all ~~xenial~~ QuantaStor packages are installed ~~(for example, on a trusty box, not all the same packages are installed that are on a xenial box)~~.		'''--skipInstall''' can be used with an upgrade when QuantaStor is present but not all Xenial QuantaStor packages are installed.
	<pre>		<pre>
	--skipInstall		--skipInstall
	</pre>		</pre>
	~~Can be set to True/true or False/false (capitalization does not matter). Used~~ to perform an offline upgrade. ~~User~~ must copy the desired ISO image into the /mnt/qs-isos directory.		'''--offline''' is used to perform an offline upgrade. Users must copy the desired ISO image into the /mnt/qs-isos directory.
	~~Offline distribution upgrades are not yet supported~~.
	<pre>		<pre>
	--offline		--offline
	</pre>		</pre>
	~~Edit apt preference file configuration to point to the ISO.~~		'''--allowReboot''' automatically reboots the system when one is required (after the kernel, driver, and/or distribution upgrades).
	~~<pre>~~
	--~~dryrun~~
	~~</pre>~~
	~~Can be set to True/true or False/false~~ (~~capitalization does not matter).~~
	~~For internal/support use only. Performs~~ the ~~preparation~~ and ~~cleanup steps involved during an offline upgrade but does not perform any~~ upgrades.
	<pre>		<pre>
	--allowReboot		--allowReboot
	</pre>		</pre>
	~~Can be set to True/true or False/false (capitalization does not matter).~~		'''--coreOnly''' upgrades only the core QuantaStor packages.
	~~Defaults to False/false~~
	~~When specified as True/true,~~ the ~~upgrade manager automatically reboots the system when one is required (after kernel, driver, and/or distribution upgrades)~~.
	<pre>		<pre>
	--coreOnly		--coreOnly
	~~</pre>~~
	~~Can be set to True/true or False/false (capitalization does not matter).~~
	~~When specified to True/true, only the core qstor packages will be upgraded.~~
	~~qstormanager~~
	~~qstorservice~~
	~~qstortomcat~~
	~~Qstorrest~~
	~~No security patches will be applied (apt-get upgrade)~~
	~~<pre>~~
	~~--getConfigValues~~
	</pre>		</pre>

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-23T19:55:09Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 19:55, 23 August 2019
Line 1:		Line 1:
	== QuantaStor CLI Upgrade Commands ==		== QuantaStor CLI Upgrade Commands ==

	~~'''--id''' is an optional command that can be used to indicate the task ID for the upgrade if the upgrade was initiated via the web UI.~~
	~~<pre>~~
	~~-id~~
	~~</pre>~~
	'''--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.		'''--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.		During an offline upgrade, this flag need not be used and is auto set to the location of the ISO image.
	<pre>		<pre>
	--repoUrl		--repoUrl
	~~</pre>~~
	'''--targetDist''' is used to help locate which upgrade scripts to use. On a trusty box trying to get to xenial, this should be set to quantastor-xenial. On a xenial box trying to get to the latest xenial build, this should be set to quantastor-xenial.
	~~If not specified, the target dist will be autodetected from either the system’s /etc/apt/sources.list.d/osnexus.list file, or the preferredDist config file on the repo.~~
	~~During an offline upgrade, this flag need not be used and is auto set to ‘pool’ of the ISO image.~~
	~~<pre>~~
	~~--targetDist~~
	</pre>		</pre>
	'''--includeKernel''' This command is set to True/true when ‘Full Upgrade’ is selected from the Upgrade Manager dialog in the web UI. It can be set to True/true or False/false (capitalization does not matter). When specified as True/true, the kernel and driver upgrades are included.		'''--includeKernel''' This command is set to True/true when ‘Full Upgrade’ is selected from the Upgrade Manager dialog in the web UI. It can be set to True/true or False/false (capitalization does not matter). When specified as True/true, the kernel and driver upgrades are included.
Line 20:		Line 10:
	<pre>		<pre>
	--includeKernel		--includeKernel
	~~</pre>~~
	~~'''--force''' when specified as True/true, purges the package metadata from the system. This forces all packages and package info to be re-downloaded from the package repository.~~
	~~<pre>~~
	~~--force~~
	</pre>		</pre>
	'''--distroUpgrade''' when specified as True/true, the distribution upgrade is included. 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.		'''--distroUpgrade''' when specified as True/true, the distribution upgrade is included. 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.
Line 42:		Line 28:
	<pre>		<pre>
	--offline		--offline
	~~</pre>~~
	~~Can be set to True/true or False/false (capitalization does not matter).~~
	~~For internal/support use only.~~
	~~Performs are the preparation steps involved with setting up an offline upgrade. Does not perform any upgrades.~~
	~~Locate the ISO at /mnt/qs-isos.~~
	~~Mount the ISO at /mnt/cd-test.~~
	~~Verify the mount point.~~
	~~<pre>~~
	~~--offlinePrep~~
	</pre>		</pre>
	Edit apt preference file configuration to point to the ISO.		Edit apt preference file configuration to point to the ISO.
	~~<pre>~~
	~~--offlineCleanup~~
	~~</pre>~~
	~~Can be set to True/true or False/false (capitalization does not matter). For internal/support use only. Performs are the cleanup steps involved after an offline upgrade. Does not perform any upgrades.~~
	~~Unmount the ISO image. Restore apt preference file configuration.~~
	<pre>		<pre>
	--dryrun		--dryrun

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-23T18:58:24Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 18:58, 23 August 2019
Line 34:		Line 34:
	--install		--install
	</pre>		</pre>
	Can be set to True/true or False/false (capitalization does not matter). Can be used with an upgrade when QuantaStor is present but not all xenial ~~qstor~~ packages are installed (for example, on a trusty box not all the same packages are installed that are on a xenial box).		Can be set to True/true or False/false (capitalization does not matter). Can be used with an upgrade when QuantaStor is present but not all xenial QuantaStor packages are installed (for example, on a trusty box, not all the same packages are installed that are on a xenial box).
	<pre>		<pre>
	--skipInstall		--skipInstall
Line 48:		Line 48:
	Locate the ISO at /mnt/qs-isos.		Locate the ISO at /mnt/qs-isos.
	Mount the ISO at /mnt/cd-test.		Mount the ISO at /mnt/cd-test.
	Verify the ~~mountpoint~~.		Verify the mount point.
	<pre>		<pre>
	--offlinePrep		--offlinePrep
	</pre>		</pre>

	Edit apt preference file configuration to point to the ISO.		Edit apt preference file configuration to point to the ISO.
	<pre>		<pre>

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-23T18:57:09Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 18:57, 23 August 2019
Line 30:		Line 30:
	--distroUpgrade		--distroUpgrade
	</pre>		</pre>
	~~Can be set to True/true or False/false (capitalization does not matter).~~		'''--install''' should be used when performing a fresh install on a Xenial (16.04) Ubuntu. It can also be used to fix broken installations.
	~~Should~~ be ~~supplied~~ when performing a fresh install on a ~~plain xenial~~ (16.04) ~~ubuntu box~~.
	~~Can~~ also be ~~supplied~~ to fix broken installations.
	<pre>		<pre>
	--install		--install

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-23T18:34:56Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 18:34, 23 August 2019
Line 25:		Line 25:
	--force		--force
	</pre>		</pre>
	~~Can be set to True/true or False/false (capitalization does not matter). When~~ specified as True/true, the distribution upgrade is included.		'''--distroUpgrade''' when specified as True/true, the distribution upgrade is included. 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.
	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’ flag 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.		The ‘includeKernel’ flag 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.
	<pre>		<pre>

Qadmin at 18:28, 23 August 2019

2019-08-23T18:28:27Z

← Older revision		Revision as of 18:28, 23 August 2019
Line 21:		Line 21:
	--includeKernel		--includeKernel
	</pre>		</pre>
	~~For internal use only, need not be specified. This flag is used when the script calls itself again.~~		'''--force''' when specified as True/true, purges the package metadata from the system. This forces all packages and package info to be re-downloaded from the package repository.
	~~<pre>~~
	--~~runOnce~~
	~~</pre>~~
	~~Optional. Can be set to True/true or False/false (capitalization does not matter).~~
	~~When~~ specified as True/true, purges the package metadata from the system. This forces all packages and package info to be ~~redownloaded~~ from the package repository.
	<pre>		<pre>
	--force		--force
	</pre>		</pre>
	~~Optional.~~ Can be set to True/true or False/false (capitalization does not matter). When specified as True/true, the distribution upgrade is included.		Can be set to True/true or False/false (capitalization does not matter). When specified as True/true, the distribution upgrade is included.
	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.		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’ flag need not be supplied in ~~additional~~ to this flag, as the kernel and drivers will all be upgraded as a part of the distribution upgrade.		The ‘includeKernel’ flag 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.
	<pre>		<pre>
	--distroUpgrade		--distroUpgrade
	</pre>		</pre>
	~~Optional.~~ Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	Should be supplied when performing a fresh install on a plain xenial (16.04) ubuntu box.		Should be supplied when performing a fresh install on a plain xenial (16.04) ubuntu box.
	Can also be supplied to fix broken installations.		Can also be supplied to fix broken installations.
Line 42:		Line 37:
	--install		--install
	</pre>		</pre>
	~~Optional.~~ Can be set to True/true or False/false (capitalization does not matter). Can be used with an upgrade when QuantaStor is present but not all xenial qstor packages are installed (for example, on a trusty box not all the same packages are installed that are on a xenial box).		Can be set to True/true or False/false (capitalization does not matter). Can be used with an upgrade when QuantaStor is present but not all xenial qstor packages are installed (for example, on a trusty box not all the same packages are installed that are on a xenial box).
	<pre>		<pre>
	--skipInstall		--skipInstall
	</pre>		</pre>
	~~Optional.~~ Can be set to True/true or False/false (capitalization does not matter). Used to perform an offline upgrade. User must copy the desired ISO image into the /mnt/qs-isos directory.		Can be set to True/true or False/false (capitalization does not matter). Used to perform an offline upgrade. User must copy the desired ISO image into the /mnt/qs-isos directory.
	Offline distribution upgrades are not yet supported.		Offline distribution upgrades are not yet supported.
	<pre>		<pre>
	--offline		--offline
	</pre>		</pre>
	~~Optional.~~
	Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	For internal/support use only.		For internal/support use only.
Line 63:		Line 57:

	Edit apt preference file configuration to point to the ISO.		Edit apt preference file configuration to point to the ISO.
			<pre>
	--offlineCleanup		--offlineCleanup
	~~Optional.~~ Can be set to True/true or False/false (capitalization does not matter). For internal/support use only. Performs are the cleanup steps involved after an offline upgrade. Does not perform any upgrades.		</pre>
			Can be set to True/true or False/false (capitalization does not matter). For internal/support use only. Performs are the cleanup steps involved after an offline upgrade. Does not perform any upgrades.
	Unmount the ISO image. Restore apt preference file configuration.		Unmount the ISO image. Restore apt preference file configuration.
			<pre>
	--dryrun		--dryrun
	~~Optional~~		</pre>
	Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	For internal/support use only. Performs the preparation and cleanup steps involved during an offline upgrade but does not perform any upgrades.		For internal/support use only. Performs the preparation and cleanup steps involved during an offline upgrade but does not perform any upgrades.
Line 73:		Line 70:
	--allowReboot		--allowReboot
	</pre>		</pre>
	~~Optional.~~
	Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	Defaults to False/false		Defaults to False/false
Line 80:		Line 76:
	--coreOnly		--coreOnly
	</pre>		</pre>
	~~Optional.~~ Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	When specified to True/true, only the core qstor packages will be upgraded.		When specified to True/true, only the core qstor packages will be upgraded.
	qstormanager		qstormanager

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-23T17:46:33Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 17:46, 23 August 2019
Line 10:		Line 10:
	--repoUrl		--repoUrl
	</pre>		</pre>
	'''--targetDist''' is ~~Used~~ to help locate which upgrade scripts to use. On a trusty box trying to get to xenial, this should be set to quantastor-xenial. On a xenial box trying to get to the latest xenial build, this should be set to quantastor-xenial.		'''--targetDist''' is used to help locate which upgrade scripts to use. On a trusty box trying to get to xenial, this should be set to quantastor-xenial. On a xenial box trying to get to the latest xenial build, this should be set to quantastor-xenial.
	If not specified, the target dist will be autodetected from either the system’s /etc/apt/sources.list.d/osnexus.list file, or the preferredDist config file on the repo.		If not specified, the target dist will be autodetected from either the system’s /etc/apt/sources.list.d/osnexus.list file, or the preferredDist config file on the repo.
	During an offline upgrade, this flag need not be used and is auto set to ‘pool’ of the ISO image.		During an offline upgrade, this flag need not be used and is auto set to ‘pool’ of the ISO image.
Line 16:		Line 16:
	--targetDist		--targetDist
	</pre>		</pre>
	~~Can~~ be set to True/true or False/false (capitalization does not matter).		'''--includeKernel''' This command is set to True/true when ‘Full Upgrade’ is selected from the Upgrade Manager dialog in the web UI. It can be set to True/true or False/false (capitalization does not matter). When specified as True/true, the kernel and driver upgrades are included.
	When specified as True/true, the kernel and driver upgrades are included.
	If the kernel or any drivers are upgraded during this process (if there are upgrades available and the system is not on the latest versions) then a reboot is required for the upgrades to take effect.		If the kernel or any drivers are upgraded during this process (if there are upgrades available and the system is not on the latest versions) then a reboot is required for the upgrades to take effect.
	~~This flag is set to True/true when ‘Full Upgrade’ is selected from the Upgrade Manager dialog in the web UI.~~
	<pre>		<pre>
	--includeKernel		--includeKernel

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-22T20:30:26Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 20:30, 22 August 2019
Line 10:		Line 10:
	--repoUrl		--repoUrl
	</pre>		</pre>
	~~Optional.~~		'''--targetDist''' is Used to help locate which upgrade scripts to use. On a trusty box trying to get to xenial, this should be set to quantastor-xenial. On a xenial box trying to get to the latest xenial build, this should be set to quantastor-xenial.
	Used to help locate which upgrade scripts to use. On a trusty box trying to get to xenial, this should be set to quantastor-xenial. On a xenial box trying to get to the latest xenial build, this should be set to quantastor-xenial.
	If not specified, the target dist will be autodetected from either the system’s /etc/apt/sources.list.d/osnexus.list file, or the preferredDist config file on the repo.		If not specified, the target dist will be autodetected from either the system’s /etc/apt/sources.list.d/osnexus.list file, or the preferredDist config file on the repo.
	During an offline upgrade, this flag need not be used and is auto set to ‘pool’ of the ISO image.		During an offline upgrade, this flag need not be used and is auto set to ‘pool’ of the ISO image.
Line 17:		Line 16:
	--targetDist		--targetDist
	</pre>		</pre>
	~~Optional.~~ Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	When specified as True/true, the kernel and driver upgrades are included.		When specified as True/true, the kernel and driver upgrades are included.
	If the kernel or any drivers are upgraded during this process (if there are upgrades available and the system is not on the latest versions) then a reboot is required for the upgrades to take effect.		If the kernel or any drivers are upgraded during this process (if there are upgrades available and the system is not on the latest versions) then a reboot is required for the upgrades to take effect.

Qadmin: /* QuantaStor CLI Upgrade Commands */

2019-08-22T18:25:14Z

QuantaStor CLI Upgrade Commands

← Older revision		Revision as of 18:25, 22 August 2019
Line 58:		Line 58:
	For internal/support use only.		For internal/support use only.
	Performs are the preparation steps involved with setting up an offline upgrade. Does not perform any upgrades.		Performs are the preparation steps involved with setting up an offline upgrade. Does not perform any upgrades.
			Locate the ISO at /mnt/qs-isos.
			Mount the ISO at /mnt/cd-test.
			Verify the mountpoint.
	<pre>		<pre>
	--offlinePrep		--offlinePrep
	</pre>		</pre>
	~~Locate the ISO at /mnt/qs-isos.~~
	~~Mount the ISO at /mnt/cd-test.~~
	~~Verify the mountpoint.~~
	Edit apt preference file configuration to point to the ISO.		Edit apt preference file configuration to point to the ISO.
	--offlineCleanup		--offlineCleanup
	Optional.		Optional. Can be set to True/true or False/false (capitalization does not matter). For internal/support use only. Performs are the cleanup steps involved after an offline upgrade. Does not perform any upgrades.
	Can be set to True/true or False/false (capitalization does not matter).		Unmount the ISO image. Restore apt preference file configuration.
	For internal/support use only.
	Performs are the cleanup steps involved after an offline upgrade. Does not perform any upgrades.
	Unmount the ISO image.
	Restore apt preference file configuration.
	--dryrun		--dryrun
	Optional		Optional
	Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	For internal/support use only.		For internal/support use only. Performs the preparation and cleanup steps involved during an offline upgrade but does not perform any upgrades.
	Performs the preparation and cleanup steps involved during an offline upgrade but does not perform any upgrades.		<pre>
	--allowReboot		--allowReboot
			</pre>
	Optional.		Optional.
	Can be set to True/true or False/false (capitalization does not matter).		Can be set to True/true or False/false (capitalization does not matter).
	Defaults to False/false		Defaults to False/false
	When specified as True/true, the upgrade manager automatically reboots the system when one is required (after kernel, driver, and/or distribution upgrades).		When specified as True/true, the upgrade manager automatically reboots the system when one is required (after kernel, driver, and/or distribution upgrades).
			<pre>
	--coreOnly		--coreOnly
	Optional.		</pre>
	Can be set to True/true or False/false (capitalization does not matter).		Optional. Can be set to True/true or False/false (capitalization does not matter).
	When specified to True/true, only the core qstor packages will be upgraded.		When specified to True/true, only the core qstor packages will be upgraded.
	qstormanager		qstormanager
Line 91:		Line 90:
	Qstorrest		Qstorrest
	No security patches will be applied (apt-get upgrade)		No security patches will be applied (apt-get upgrade)
			<pre>
	--getConfigValues		--getConfigValues
			</pre>

	== Upgrade Manager Use Cases ==		== Upgrade Manager Use Cases ==