QuantaStor 4.0.1 Upgrade Instructions - Revision history

Qadmin at 18:04, 19 September 2017

2017-09-19T18:04:05Z

← Older revision		Revision as of 18:04, 19 September 2017
Line 62:		Line 62:
	<pre>		<pre>
	# sudo apt-get update		# sudo apt-get update
	# sudo apt-get install -y libpython2.7 zfsutils libzpool2 libzfs2 lsscsi pv qstormanager=4.0.1.1128-1 qstorservice=4.0.1.1128-1 qstortomcat=7.4.0.1.1119-1 qstortarget=4.0.1.1128-1 python-softlayer-objstorage		# sudo apt-get install -y libpython2.7 zfsutils libzpool2 libzfs2 lsscsi pv qstormanager=4.0.1.1128-1 qstorservice=4.0.1.1128-1 qstortomcat=7.4.0.0.1119-1 qstortarget=4.0.1.1128-1 python-softlayer-objstorage
	# sudo qs-kernelupgrade		# sudo qs-kernelupgrade
	</pre>		</pre>

Qadmin at 14:37, 22 April 2016

2016-04-22T14:37:49Z

← Older revision		Revision as of 14:37, 22 April 2016
Line 1:		Line 1:
			__TOC__
	There are three separate options for upgrading to the 4.0.1 release. '''This update will require a REBOOT.'''		There are three separate options for upgrading to the 4.0.1 release. '''This update will require a REBOOT.'''

Qadmin at 04:37, 21 April 2016

2016-04-21T04:37:31Z

← Older revision		Revision as of 04:37, 21 April 2016
Line 5:		Line 5:
	'''This is the recommended upgrade path for systems already running a recent 4.0.0 release that do not require OS level security patches.'''		'''This is the recommended upgrade path for systems already running a recent 4.0.0 release that do not require OS level security patches.'''

	This option will result in an upgrade of only the QuantaStor specific packages (as opposed to a complete OS wide package upgrade), and only require the Command Line Interface to perform the kernel upgrade. ~~Chose~~ this option if you have ~~already~~ recently ~~performed~~ the ''qs-upgrade'' command and do not require a full OS level update.		This option will result in an upgrade of only the QuantaStor specific packages (as opposed to a complete OS wide package upgrade), and only require the Command Line Interface to perform the kernel upgrade. We recommend electing for this option if you have recently upgraded using the ''qs-upgrade'' command and do not require a full OS level update.

	'''Login to the WebUI with an admin account and run the Upgrade Manager, click Check for Updates and Install the below QuantaStor update packages via the Upgrade manager.'''		'''Login to the WebUI with an admin account and run the Upgrade Manager, click Check for Updates and Install the below QuantaStor update packages via the Upgrade manager.'''
Line 19:		Line 19:
	'''After performing the upgrade, close and re-open your QuantaStor WebUI Browswer Tabs'''.		'''After performing the upgrade, close and re-open your QuantaStor WebUI Browswer Tabs'''.

	This will ensure you are running the 4.0.1.1128 version of the QuantaStor Web manager. ~~Some Browsers do not clean their cache correctly, if~~ you have trouble displaying the new QuantaStor Web management via, please clear ~~you browser~~ cache ~~or try a different~~ browser.		This will ensure you are running the 4.0.1.1128 version of the QuantaStor Web manager. If you have trouble displaying the new QuantaStor Web management via your browser, please use [Ctrl]+[F5] ([Shift]+F5] on Mac OS X) to reload the QuantaStor Web manager and bypass your cache. If your browser does not support forcing a page reload without cache, please clear the cache in your browser.

	'''Log into the QuantaStor system's CLI to perform the 3.19.0-58-quantastor Linux Kernel update.'''		'''Log into the QuantaStor system's CLI to perform the 3.19.0-58-quantastor Linux Kernel update.'''

	Once the update packages are installed via the Web interface Upgrade Manager , login to the system console as the qadmin user and run the below script from the console to install the new 3.19.0-58-quantastor Linux Kernel package.		Once the update packages are installed via the Web interface Upgrade Manager, login to the system console as the qadmin user and run the below script from the console to install the new 3.19.0-58-quantastor Linux Kernel package.

	<pre>sudo qs-kernelupgrade</pre>		<pre>sudo qs-kernelupgrade</pre>

Qadmin at 16:22, 20 April 2016

2016-04-20T16:22:32Z

← Older revision		Revision as of 16:22, 20 April 2016
Line 1:		Line 1:
	~~=== QuantaStor~~ 4.0.1 ~~Upgrade Instructions for releases running 3.16.0 through 4~~.0.~~0 ===~~		There are three separate options for upgrading to the 4.0.1 release. '''This update will require a REBOOT.'''

	~~There are three separate options for upgrading~~ to ~~the~~ 4.0.1 ~~release.~~		= Upgrading to 4.0.1 via the WebUI Upgrade Manager =

	~~Option #1 is using the Web manager Upgrade Manager dialog to install the updates and then installing the Kernel update via the CLI.~~ This is the recommended ~~option if you were~~ running ~~the most~~ recent 4.0.0 release ~~and you~~ do not ~~need to patch for~~ security.		'''This is the recommended upgrade path for systems already running a recent 4.0.0 release that do not require OS level security patches.'''

	~~Option #2 is to install all updates via the CLI, including the 4.0.1, system security and kernel updates.~~ This is the ~~recommended option if your~~ QuantaStor ~~was running~~ a ~~release that was quite a few releases back~~ and ~~you want to ensure all system and security patches are installed.~~		This option will result in an upgrade of only the QuantaStor specific packages (as opposed to a complete OS wide package upgrade), and only require the Command Line Interface to perform the kernel upgrade. Chose this option if you have already recently performed the ''qs-upgrade'' command and do not require a full OS level update.

	~~Option #3 is~~ to ~~manually install~~ the ~~core update packages and~~ kernel ~~update~~. ~~This~~ option ~~can be used~~ if you ~~wish to install specifically~~ the ~~4.0.1 QuantaStor release version.~~

	~~====Upgrade Option #1: Instructions to update to QuantaStor 4.0.1 using Upgrade Manager ====~~

	~~Login to the WebUI with an admin account~~ and ~~run the Upgrade Manager, click Check for Updates and Install the below QuantaStor~~ update ~~packages via the Upgrade manager~~.

			'''Login to the WebUI with an admin account and run the Upgrade Manager, click Check for Updates and Install the below QuantaStor update packages via the Upgrade manager.'''
	<pre>		<pre>
	Web Management 4.0.1.1128-1		Web Management 4.0.1.1128-1
Line 20:		Line 15:
	</pre>		</pre>

	~~''''' PLEASE NOTE:~~ the upgrade process will log out any ~~Web~~ manager sessions you ~~may~~ have running. Please close and re-open your web browser or tabs to the QuantaStor Web interface, this will ensure you are running the 4.0.1.1128 version of the QuantaStor Web manager. Some Browsers do not clean their cache correctly, if you have trouble displaying the new QuantaStor Web management via, please clear you browser cache or try a different browser.'''''		Please note that the upgrade process will log out any WebUI manager sessions you have running.

	~~=====3.19~~.~~0-58-quantastor Linux Kernel update instructions (REBOOT REQUIRED)=====~~		'''After performing the upgrade, close and re-open your QuantaStor WebUI Browswer Tabs'''.

	~~Once~~ the ~~update packages are installed via~~ the Web ~~interface Upgrade Manager or the `qs-upgrade` CLI script~~, ~~login to the system console as the qadmin user and run the below script from the console to install~~ the new ~~3.19.0-58-quantastor Linux Kernel package~~.		This will ensure you are running the 4.0.1.1128 version of the QuantaStor Web manager. Some Browsers do not clean their cache correctly, if you have trouble displaying the new QuantaStor Web management via, please clear you browser cache or try a different browser.

	~~<pre>~~		'''Log into the QuantaStor system's CLI to perform the 3.19.0-58-quantastor Linux Kernel update.'''
	~~sudo qs~~-~~kernelupgrade~~

	Once the ~~script has finished~~, ~~please reboot~~ the system to ~~boot to~~ the new ~~kernel~~.		Once the update packages are installed via the Web interface Upgrade Manager , login to the system console as the qadmin user and run the below script from the console to install the new 3.19.0-58-quantastor Linux Kernel package.

	sudo ~~reboot~~		<pre>sudo qs-kernelupgrade</pre>
	</pre>

	~~Note~~, ~~to upgrade everything on~~ the system ~~including~~ the kernel~~, QuantaStor management packages and Linux update packages, please use the instructions in the next section~~.		'''Once the script has finished, please reboot the system to boot to the new kernel.'''

	~~==== Upgrade Option #2: QuantaStor 4.0.1 CLI upgrade instructions for 4.0.0 or 3.16.10 or older (Installs security packages and latest kernel REBOOT REQUIRED)====~~		<pre>sudo reboot</pre>

	For customers running releases 4.0.0 or 3.16.10 or older, it is recommended that you schedule a downtime work window as a reboot is required for changes in the 4.0.1 upgrades. You will need to run these commands as a user with sudo access on the QuantaStor appliance, such as the default 'qadmin' account or as root if you have enabled direct root access.

	~~The below upgrade instructions can be run from the CLI~~ to ~~perform a full upgrade to QuantaStor~~ 4.0.1 ~~along with the installation of the 3.19.0-58-quantastor Linux Kernel, the latest ZFS and other driver upgrades and latest Security~~ and OS ~~packages.~~		= Upgrading to 4.0.1 and Latest OS Packages via Command Line Interface =

	~~<pre>~~		'''This is the recommended option for systems running 3.16.x or earlier QuantaStor versions, and systems that may be out of date and require OS level package updates as well.'''
	~~NOTE: Schedule Downtime~~ and ~~disconnect client access before running the below commands:~~

	~~1) Run~~ the ~~qs-upgrade command once~~ to ~~install~~ the ~~newest~~ version of the ~~qs-upgrade script and~~ the ~~base Quantastor packages~~.		This procedure will upgrade the QuantaStor system to the latest software version, and also update all OS level packages to their latest versions as well, ensuring the system software has the latest security patches in place.

	sudo ~~qs-upgrade~~		For customers running releases 4.0.0 or 3.16.10 or older, it is recommended that you schedule a downtime work window as a reboot is required for changes in the 4.0.1 upgrades. You will need to run these commands as a user with sudo access on the QuantaStor appliance, such as the default 'qadmin' account or as root if you have enabled direct root access.

	~~2) Run the qs-upgrade command a second time to install all system level updates~~ and ~~dependencies, this will bring all system level and security packages to the latest versions~~.		:''NOTE: Schedule Downtime and disconnect client access before performing these steps.''

	~~sudo qs~~-~~upgrade~~		'''Login to the CLI to perform a full upgrade to QuantaStor 4.0.1 along with the installation of the 3.19.0-58-quantastor Linux Kernel, the latest ZFS and other driver upgrades and latest Security and OS packages.'''

	3) Run the kernel upgrade command to install the 3.19.0-58-quantastor Linux Kernel		# Run the qs-upgrade command once to install the newest version of the qs-upgrade script and the base Quantastor packages.<br /><pre># sudo qs-upgrade</pre>
			# Run the qs-upgrade command a second time to install all system level updates and dependencies, this will bring all system level and security packages to the latest versions.<br /><pre># sudo qs-upgrade</pre>
			# Run the kernel upgrade command to install the 3.19.0-58-quantastor Linux Kernel.<br /><pre># sudo qs-kernelupgrade</pre>
			# Reboot the Quantastor Appliance to boot to the new kernel:<br /><pre># sudo reboot</pre>

	~~sudo qs-kernelupgrade~~

	4~~) Reboot the Quantastor Appliance to boot to the new kernel:~~		= Upgrading to 4.0.1 via Manual Installation =

	~~sudo reboot~~

	~~</pre>~~

	~~====Upgrade Option #3 QuantaStor~~ 4.0.1 ~~Manual install (REBOOT REQUIRED)====~~		'''This option is not recommended unless there is an explicit need to install the 4.0.1.1128 version of the software.'''

			The above options will result in an upgrade to the latest available software versions and are the recommended upgrade choices for all customers. The follows steps can be used if there is a specific need to install the 4.0.1.1128 version of the software, even if newer software updates are available.

	The below commands can be run from the console of a QuantaStor appliance to explicitly install the 4.0.1 release on any QuantaStor running a v3 or newer release.		The below commands can be run from the console of a QuantaStor appliance to explicitly install the 4.0.1 release on any QuantaStor running a v3 or newer release.

			'''Command Line Instructions to install QuantaStor 4.0.1.1128 explicitly:'''
	<pre>		<pre>
	sudo apt-get update		# sudo apt-get update
	sudo apt-get install -y libpython2.7 zfsutils libzpool2 libzfs2 lsscsi pv qstormanager=4.0.1.1128-1 qstorservice=4.0.1.1128-1 qstortomcat=7.4.0.1.1119-1 qstortarget=4.0.1.1128-1 python-softlayer-objstorage		# sudo apt-get install -y libpython2.7 zfsutils libzpool2 libzfs2 lsscsi pv qstormanager=4.0.1.1128-1 qstorservice=4.0.1.1128-1 qstortomcat=7.4.0.1.1119-1 qstortarget=4.0.1.1128-1 python-softlayer-objstorage
	sudo qs-kernelupgrade		# sudo qs-kernelupgrade
	</pre>		</pre>

Qadmin: /* QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0 */

2016-04-20T15:17:00Z

QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0

← Older revision		Revision as of 15:17, 20 April 2016
Line 3:		Line 3:
	There are three separate options for upgrading to the 4.0.1 release.		There are three separate options for upgrading to the 4.0.1 release.

	Option #1 is using the Web ~~managerto~~ install the updates and then installing the Kernel update via the CLI. This is the recommended option if you were running the most recent 4.0.0 release and you do not need to patch for security.		Option #1 is using the Web manager Upgrade Manager dialog to install the updates and then installing the Kernel update via the CLI. This is the recommended option if you were running the most recent 4.0.0 release and you do not need to patch for security.

	Option #2 is to install all updates via the CLI, including the 4.0.1, system security and kernel updates. This is the recommended option if your QuantaStor was running a release that was quite a few releases back and you want to ensure all system and security patches are installed.		Option #2 is to install all updates via the CLI, including the 4.0.1, system security and kernel updates. This is the recommended option if your QuantaStor was running a release that was quite a few releases back and you want to ensure all system and security patches are installed.

Qadmin: /* QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0 */

2016-04-20T15:16:46Z

QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0

← Older revision		Revision as of 15:16, 20 April 2016
Line 5:		Line 5:
	Option #1 is using the Web managerto install the updates and then installing the Kernel update via the CLI. This is the recommended option if you were running the most recent 4.0.0 release and you do not need to patch for security.		Option #1 is using the Web managerto install the updates and then installing the Kernel update via the CLI. This is the recommended option if you were running the most recent 4.0.0 release and you do not need to patch for security.

	Option#2 is to install all updates via the CLI, including the 4.0.1, system security and kernel updates. This is the recommended option if your QuantaStor was running a release that was quite a few releases back and you want to ensure all system and security patches are installed.		Option #2 is to install all updates via the CLI, including the 4.0.1, system security and kernel updates. This is the recommended option if your QuantaStor was running a release that was quite a few releases back and you want to ensure all system and security patches are installed.

	Option #3 is to manually install the core update packages and kernel update. This option can be used if you wish to install specifically the 4.0.1 QuantaStor release version.		Option #3 is to manually install the core update packages and kernel update. This option can be used if you wish to install specifically the 4.0.1 QuantaStor release version.

Qadmin: /* QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0 */

2016-04-20T15:16:39Z

QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0

← Older revision		Revision as of 15:16, 20 April 2016
Line 1:		Line 1:
	=== QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0 ===		=== QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0 ===

			There are three separate options for upgrading to the 4.0.1 release.

			Option #1 is using the Web managerto install the updates and then installing the Kernel update via the CLI. This is the recommended option if you were running the most recent 4.0.0 release and you do not need to patch for security.

			Option#2 is to install all updates via the CLI, including the 4.0.1, system security and kernel updates. This is the recommended option if your QuantaStor was running a release that was quite a few releases back and you want to ensure all system and security patches are installed.

			Option #3 is to manually install the core update packages and kernel update. This option can be used if you wish to install specifically the 4.0.1 QuantaStor release version.

	====Upgrade Option #1: Instructions to update to QuantaStor 4.0.1 using Upgrade Manager ====		====Upgrade Option #1: Instructions to update to QuantaStor 4.0.1 using Upgrade Manager ====

Qadmin at 15:11, 20 April 2016

2016-04-20T15:11:37Z

← Older revision		Revision as of 15:11, 20 April 2016
Line 14:		Line 14:
	''''' PLEASE NOTE: the upgrade process will log out any Web manager sessions you may have running. Please close and re-open your web browser or tabs to the QuantaStor Web interface, this will ensure you are running the 4.0.1.1128 version of the QuantaStor Web manager. Some Browsers do not clean their cache correctly, if you have trouble displaying the new QuantaStor Web management via, please clear you browser cache or try a different browser.'''''		''''' PLEASE NOTE: the upgrade process will log out any Web manager sessions you may have running. Please close and re-open your web browser or tabs to the QuantaStor Web interface, this will ensure you are running the 4.0.1.1128 version of the QuantaStor Web manager. Some Browsers do not clean their cache correctly, if you have trouble displaying the new QuantaStor Web management via, please clear you browser cache or try a different browser.'''''

	====3.19.0-58-quantastor Linux Kernel update instructions (REBOOT REQUIRED)====		=====3.19.0-58-quantastor Linux Kernel update instructions (REBOOT REQUIRED)=====

	Once the update packages are installed via the Web interface Upgrade Manager or the `qs-upgrade` CLI script, login to the system console as the qadmin user and run the below script from the console to install the new 3.19.0-58-quantastor Linux Kernel package.		Once the update packages are installed via the Web interface Upgrade Manager or the `qs-upgrade` CLI script, login to the system console as the qadmin user and run the below script from the console to install the new 3.19.0-58-quantastor Linux Kernel package.

Qadmin at 15:11, 20 April 2016

2016-04-20T15:11:13Z

← Older revision		Revision as of 15:11, 20 April 2016
Line 1:		Line 1:
	=== QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0 ===		=== QuantaStor 4.0.1 Upgrade Instructions for releases running 3.16.0 through 4.0.0 ===

	====Instructions to update to QuantaStor 4.0.1 using Upgrade Manager ====		====Upgrade Option #1: Instructions to update to QuantaStor 4.0.1 using Upgrade Manager ====

	Login to the WebUI with an admin account and run the Upgrade Manager, click Check for Updates and Install the below QuantaStor update packages via the Upgrade manager.		Login to the WebUI with an admin account and run the Upgrade Manager, click Check for Updates and Install the below QuantaStor update packages via the Upgrade manager.
Line 28:		Line 28:
	Note, to upgrade everything on the system including the kernel, QuantaStor management packages and Linux update packages, please use the instructions in the next section.		Note, to upgrade everything on the system including the kernel, QuantaStor management packages and Linux update packages, please use the instructions in the next section.

	====QuantaStor 4.0.1 CLI upgrade instructions for 4.0.0 or 3.16.10 or older (Installs security packages and latest kernel REBOOT REQUIRED)====		==== Upgrade Option #2: QuantaStor 4.0.1 CLI upgrade instructions for 4.0.0 or 3.16.10 or older (Installs security packages and latest kernel REBOOT REQUIRED)====

	For customers running releases 4.0.0 or 3.16.10 or older, it is recommended that you schedule a downtime work window as a reboot is required for changes in the 4.0.1 upgrades. You will need to run these commands as a user with sudo access on the QuantaStor appliance, such as the default 'qadmin' account or as root if you have enabled direct root access.		For customers running releases 4.0.0 or 3.16.10 or older, it is recommended that you schedule a downtime work window as a reboot is required for changes in the 4.0.1 upgrades. You will need to run these commands as a user with sudo access on the QuantaStor appliance, such as the default 'qadmin' account or as root if you have enabled direct root access.
Line 55:		Line 55:
	</pre>		</pre>

	====QuantaStor 4.0.1 Manual install (REBOOT REQUIRED)====		====Upgrade Option #3 QuantaStor 4.0.1 Manual install (REBOOT REQUIRED)====

Qadmin at 02:53, 8 April 2016

2016-04-08T02:53:49Z

← Older revision		Revision as of 02:53, 8 April 2016
Line 6:		Line 6:

	<pre>		<pre>
	Web Management 4.0.1.~~TBD~~-1		Web Management 4.0.1.1128-1
	Core Services 4.0.1.~~TBD~~-1		Core Services 4.0.1.1128-1
	Web Server 7.4.0.1.1119-1		Web Server 7.4.0.1.1119-1
	iSCSI Target Driver 4.0.1.~~TBD~~-1		iSCSI Target Driver 4.0.1.1128-1
	</pre>		</pre>

	''''' PLEASE NOTE: the upgrade process will log out any Web manager sessions you may have running. Please close and re-open your web browser or tabs to the QuantaStor Web interface, this will ensure you are running the 4.0.1.~~TBD~~ version of the QuantaStor Web manager. Some Browsers do not clean their cache correctly, if you have trouble displaying the new QuantaStor Web management via, please clear you browser cache or try a different browser.'''''		''''' PLEASE NOTE: the upgrade process will log out any Web manager sessions you may have running. Please close and re-open your web browser or tabs to the QuantaStor Web interface, this will ensure you are running the 4.0.1.1128 version of the QuantaStor Web manager. Some Browsers do not clean their cache correctly, if you have trouble displaying the new QuantaStor Web management via, please clear you browser cache or try a different browser.'''''

	====3.19.0-58-quantastor Linux Kernel update instructions (REBOOT REQUIRED)====		====3.19.0-58-quantastor Linux Kernel update instructions (REBOOT REQUIRED)====
Line 62:		Line 62:
	<pre>		<pre>
	sudo apt-get update		sudo apt-get update
	sudo apt-get install -y libpython2.7 zfsutils libzpool2 libzfs2 lsscsi pv qstormanager=4.0.1.~~TBD~~-1 qstorservice=4.0.1.~~TBD~~-1 qstortomcat=7.4.0.1.1119-1 qstortarget=4.0.1.~~TBD~~-1 python-softlayer-objstorage		sudo apt-get install -y libpython2.7 zfsutils libzpool2 libzfs2 lsscsi pv qstormanager=4.0.1.1128-1 qstorservice=4.0.1.1128-1 qstortomcat=7.4.0.1.1119-1 qstortarget=4.0.1.1128-1 python-softlayer-objstorage
	sudo qs-kernelupgrade		sudo qs-kernelupgrade
	</pre>		</pre>