Bare-metal Install - Revision history

Qadmin: Remove 1 video link(s) that do not reference QuantaStor 6 or newer -- a recording of an older interface teaches the wrong screen (wiki-docs rule 13)

2026-09-03T03:18:10Z

Remove 1 video link(s) that do not reference QuantaStor 6 or newer -- a recording of an older interface teaches the wrong screen (wiki-docs rule 13)

← Older revision		Revision as of 03:18, 3 September 2026
Line 58:		Line 58:

	Irrespective of the base OS, once the installation is done simply login via the QuantaStor web interface to manage the system. Storage Grids may be comprised of a hybrid mix of servers using Ubuntu and/or RHEL as the base OS.		Irrespective of the base OS, once the installation is done simply login via the QuantaStor web interface to manage the system. Storage Grids may be comprised of a hybrid mix of servers using Ubuntu and/or RHEL as the base OS.

	~~''' OSNEXUS Videos '''~~
	* [[Image:youtube_icon.png\|50px\|link=https://www.youtube.com/watch?v=AzBHOxnNatQ]] [https://www.youtube.com/watch?v=AzBHOxnNatQ Covers How To Install QuantaStor 5 on RHEL/CentOS 7.8 [7:20]]

	== Starting the Installation from RHEL Media ==		== Starting the Installation from RHEL Media ==

Joshua.blake: /* Software RAID1 for Boot/System Disk Configuration */

2025-10-20T12:03:08Z

Software RAID1 for Boot/System Disk Configuration

← Older revision		Revision as of 12:03, 20 October 2025
Line 42:		Line 42:
	==== [[QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS Mode)\|QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS Mode)]] ====		==== [[QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS Mode)\|QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS Mode)]] ====

	==== [[~~Ubuntu~~ Software RAID1 (~~UEFI~~)]] ====		==== [[QuantaStor 6 - Software RAID1 Install Procedure (EFI Boot BIOS Mode)\|QuantaStor 6 - Software RAID1 Install Procedure (EFI Boot BIOS Mode)]] ====

	QuantaStor will identify the boot media setup in a software RAID1 mirror as a special [system/boot] pool. These are automatically excluded from the web management interface (WUI) but they can be viewed using the command line utility using 'qs pool-list'. If the RAID1 mirror becomes degraded then it will appear in the WUI to make it easier to identify the bad media so it may be replaced.		QuantaStor will identify the boot media setup in a software RAID1 mirror as a special [system/boot] pool. These are automatically excluded from the web management interface (WUI) but they can be viewed using the command line utility using 'qs pool-list'. If the RAID1 mirror becomes degraded then it will appear in the WUI to make it easier to identify the bad media so it may be replaced.

Joshua.blake: /* Software RAID1 for Boot/System Disk Configuration */

2025-10-20T12:01:27Z

Software RAID1 for Boot/System Disk Configuration

← Older revision		Revision as of 12:01, 20 October 2025
Line 1:		Line 1:
	[[Category:~~install_guide~~]]		[[index.php?title=Category:Install guide]]
	This section covers the bare-metal install process for putting QuantaStor on a physical server (rather than on a virtual machine). QuantaStor is delivered as an operating system, and thus no additional software is required on a given system. QuantaStor is Linux based, and has an extensive HCL (see [[Recommended Hardware\|HCL]] in order to support server models from all major manufacturers.		This section covers the bare-metal install process for putting QuantaStor on a physical server (rather than on a virtual machine). QuantaStor is delivered as an operating system, and thus no additional software is required on a given system. QuantaStor is Linux based, and has an extensive HCL (see [[Recommended Hardware\|HCL]] in order to support server models from all major manufacturers.

Line 40:		Line 40:
	Software RAID1 for the boot media is supported but is a bit more complex to setup. The following links have instructions on how to setup the software RAID1 mirrors.		Software RAID1 for the boot media is supported but is a bit more complex to setup. The following links have instructions on how to setup the software RAID1 mirrors.

	==== [[QuantaStor 6 - Software RAID1 Install Procedure\|QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS ~~mode~~)]] ====		==== [[QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS Mode)\|QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS Mode)]] ====

	==== [[Ubuntu Software RAID1 (UEFI)]] ====		==== [[Ubuntu Software RAID1 (UEFI)]] ====
Line 143:		Line 143:
	[[File:Rufus_screen_shot.png\|thumb\|300px\|Preparing USB ISO media for QuantaStor install\|link=QuantaStor_Installation_via_USB_Thumb_Drive]]		[[File:Rufus_screen_shot.png\|thumb\|300px\|Preparing USB ISO media for QuantaStor install\|link=QuantaStor_Installation_via_USB_Thumb_Drive]]
	==== Step 1: Preparing the ISO/USB media ====		==== Step 1: Preparing the ISO/USB media ====
	For bare-metal installation we recommend using a 8GB or larger USB stick. Once you've downloaded the ISO file from the OSNEXUS web site you can put it onto your USB device using software like [https://sourceforge.net/projects/usbwriter/ usbwriter]. Another option is to burn a DVD and use a portable USB DVD device to install from. Detailed instructions on [[~~QuantaStor_Installation_via_USB_Thumb_Drive~~\|how to put QuantaStor on to USB media]] is provided [[~~QuantaStor_Installation_via_USB_Thumb_Drive~~\|here]] for both Windows and Linux.		For bare-metal installation we recommend using a 8GB or larger USB stick. Once you've downloaded the ISO file from the OSNEXUS web site you can put it onto your USB device using software like [https://sourceforge.net/projects/usbwriter/ usbwriter]. Another option is to burn a DVD and use a portable USB DVD device to install from. Detailed instructions on [[QuantaStor Installation via USB Thumb Drive\|how to put QuantaStor on to USB media]] is provided [[QuantaStor Installation via USB Thumb Drive\|here]] for both Windows and Linux.

	==== Step 2: Insert and Boot from the QuantaStor USB Install Media ====		==== Step 2: Insert and Boot from the QuantaStor USB Install Media ====

Qadmin: /* QuantaStor 6 - Software RAID1 Install Procedure */

2022-11-08T18:01:03Z

QuantaStor 6 - Software RAID1 Install Procedure

← Older revision		Revision as of 18:01, 8 November 2022
Line 40:		Line 40:
	Software RAID1 for the boot media is supported but is a bit more complex to setup. The following links have instructions on how to setup the software RAID1 mirrors.		Software RAID1 for the boot media is supported but is a bit more complex to setup. The following links have instructions on how to setup the software RAID1 mirrors.

	==== [[QuantaStor 6 - Software RAID1 Install Procedure]] ====		==== [[QuantaStor 6 - Software RAID1 Install Procedure\|QuantaStor 6 - Software RAID1 Install Procedure (Legacy Boot BIOS mode)]] ====

	==== [[Ubuntu Software RAID1 (UEFI)]] ====		==== [[Ubuntu Software RAID1 (UEFI)]] ====

Qadmin: /* Ubuntu Software RAID1 (Legacy) */

2022-11-08T17:55:58Z

Ubuntu Software RAID1 (Legacy)

← Older revision		Revision as of 17:55, 8 November 2022
Line 40:		Line 40:
	Software RAID1 for the boot media is supported but is a bit more complex to setup. The following links have instructions on how to setup the software RAID1 mirrors.		Software RAID1 for the boot media is supported but is a bit more complex to setup. The following links have instructions on how to setup the software RAID1 mirrors.

	==== [[~~Ubuntu~~ Software RAID1 ~~(Legacy)~~]] ====		==== [[QuantaStor 6 - Software RAID1 Install Procedure]] ====

	==== [[Ubuntu Software RAID1 (UEFI)]] ====		==== [[Ubuntu Software RAID1 (UEFI)]] ====

Qadmin: /* Step 2: Select Boot/System Device */

2022-08-10T20:00:12Z

Step 2: Select Boot/System Device

← Older revision		Revision as of 20:00, 10 August 2022
Line 72:		Line 72:
	==== Step 2: Select Boot/System Device ====		==== Step 2: Select Boot/System Device ====

	In the RHEL installation screen choose the drive onto which you'll be installing QuantaStor. We ~~recommend~~ installing onto SSD media (100GB or larger) in a hardware RAID1 layout. If that is not available in your server you may install to a single SSD device or use software RAID1		In the RHEL installation screen choose the drive onto which you'll be installing QuantaStor. We require installing onto SSD media (100GB or larger) in a hardware RAID1 layout. If that is not available in your server you may install to a single SSD device or use software RAID1.

	* NOTE: The Linux based software RAID1 option will require some additional configuration steps later on so it's not recommended without assistance from OSNEXUS Customer Support		* NOTE: The Linux based software RAID1 option will require some additional configuration steps later on so it's not recommended without assistance from OSNEXUS Customer Support

Qadmin: /* Software RAID1 for Boot/System Disk Configuration */

2022-08-10T19:58:57Z

Software RAID1 for Boot/System Disk Configuration

← Older revision		Revision as of 19:58, 10 August 2022
Line 38:		Line 38:
	=== Software RAID1 for Boot/System Disk Configuration ===		=== Software RAID1 for Boot/System Disk Configuration ===

	Software RAID1 for the boot ~~device doesn't provide the same level of monitoring and ease of management that comes with~~ a ~~hardware RAID1 the for boot/system~~. ~~That said, for systems that do not~~ have ~~a hardware RAID controller or lack space for one, it is possible to install QuantaStor with mirrored boot disks using the standard Linux mdraid software RAID driver. Links below~~ on how to ~~set up a~~ software RAID1.		Software RAID1 for the boot media is supported but is a bit more complex to setup. The following links have instructions on how to setup the software RAID1 mirrors.

	==== [[Ubuntu Software RAID1 (Legacy)]] ====		==== [[Ubuntu Software RAID1 (Legacy)]] ====

	==== [[Ubuntu Software RAID1 (UEFI)]] ====		==== [[Ubuntu Software RAID1 (UEFI)]] ====

	~~Using software RAID1~~ QuantaStor, will ~~see~~ the ~~mdraid swap and~~ boot ~~devices~~ as ~~storage pools '0' and '1', and these must be blocked, so that they do not show up as Storage Pools via~~ a ~~file called~~ /~~etc/qs_poolblacklist~~.~~conf.~~		QuantaStor will identify the boot media setup in a software RAID1 mirror as a special [system/boot] pool. These are automatically excluded from the web management interface (WUI) but they can be viewed using the command line utility using 'qs pool-list'. If the RAID1 mirror becomes degraded then it will appear in the WUI to make it easier to identify the bad media so it may be replaced.

	~~<code>/etc/qs_poolblacklist.conf</code>~~

	~~The contents of~~ the ~~file should look something like this when you're done editing it:~~
	~~<pre>~~
	~~UUID=28d9d8b6-9fcc-4a66-9993-efc90c88f121~~
	~~UUID=c2eec0d4-24da-4366-93e4-919f02c92198~~
	~~</pre>~~

	~~To get the UUID of the storage pools you~~ can ~~get the information from~~ the command 'qs pool-list' ~~or you can get~~ the ~~information from 'qs-showlog' and look for~~ the ~~warning messages around the storage pools that~~ it ~~could not start. After you've edit the file you'll need~~ to ~~restart~~ the ~~QuantaStor management service like~~ so:

	~~<code>service quantastor restart</code>~~

	== Installation Options ==		== Installation Options ==

Qadmin: /* Hardware RAID1 */

2022-08-10T19:55:10Z

Hardware RAID1

← Older revision		Revision as of 19:55, 10 August 2022
Line 26:		Line 26:
	=== Hardware RAID1 ===		=== Hardware RAID1 ===

	It is highly recommended that QuantaStor is installed to a mirrored (RAID1) pair of ~~disks~~, so that service is not interrupted in the event of a drive failure. The underlying Linux operating system for QuantaStor has support for software RAID, which could be used, but is more complex. ~~OSNEXUS recommends using separate RAID controller than to the one being used by storage pools~~. Currently you must set aside two unpartitioned disks for QuantaStor in order to create a RAID1 device to install to. QuantaStor has a small footprint, and two small capacity 250GB drives will be adequate for the boot/system drive (any type will work HDD/SSD and SATA/SAS/NVMe). For deployment as a virtual appliance, OSNEXUS recommends 30GB for the boot device, plus the amount of GB in RAM of disk space. 50-100GB or more is recommended for larger configurations.		It is highly recommended that QuantaStor is installed to a mirrored (RAID1) pair of SSDs, so that service is not interrupted in the event of a drive failure. The underlying Linux operating system for QuantaStor has support for software RAID, which could be used, but is more complex. Both hardware RAID1 and software RAID1 for boot is supported. Currently you must set aside two unpartitioned disks for QuantaStor in order to create a RAID1 device to install to. QuantaStor has a small footprint, and two small capacity 250GB SSD or NVMe drives will be adequate for the boot/system drive (any type will work HDD/SSD and SATA/SAS/NVMe). For deployment as a virtual appliance, OSNEXUS recommends 30GB for the boot device, plus the amount of GB in RAM of disk space. 50-100GB or more is recommended for larger configurations.

	==== ~~Creating the RAID1 Mirrored System Disk~~ ====		==== SSD Boot Media Required ====

	~~The first step will~~ be to ~~use~~ the BIOS based configuration on the RAID controller, to create a RAID1 mirror using a pair of ~~disks. For 3ware controllers, you can enter the BIOS by pressing Alt-3 during boot, and with MegaRAID you can enter the WebBIOS by pressing Ctrl-H during boot~~. Please refer to the ~~vendors~~ documentation for complete details on how to create a RAID1 mirror using a pair of ~~disks~~. For ~~MegaRAID~~ this ~~will involve~~ creating a Disk Group 0 with both disks, a single span, and a single virtual drive.		For production deployments the boot media must be mirrored SSD or mirrored NVMe media. QuantaStor uses the boot media to run the operating system, databases for metrics, the grid configuration database, and more. HDDs have very low IOPS which under load can easily be at or below 100 IOPS. If individual I/O operations are small like 4K that equates to 400K/sec which is insufficient. For SSDs we recommend any good quality SSD mediathat is datacenter or enterprise grade SATA SSDs, SAS SSDs, or NVMe SSDs. For bare-metal installs we recommend 480GB SSDs but 240GB SSDs will do.

			==== Creating Hardware RAID1 Mirrored System Disk ====

			Use the BIOS based configuration on the RAID controller to create a RAID1 mirror using a pair of SSDs. Please refer to the HBA/RAID controller vendor's documentation for complete details on how to create a RAID1 mirror using a pair of SSDs. For LSI/Broadcom controllers and OEM variants this involves creating a Disk Group 0 with both disks, a single span, and a single virtual drive.

	=== Software RAID1 for Boot/System Disk Configuration ===		=== Software RAID1 for Boot/System Disk Configuration ===

Qadmin: /* Boot Order */

2022-08-10T19:44:53Z

Boot Order

← Older revision		Revision as of 19:44, 10 August 2022
Line 10:		Line 10:
	=== Boot Order ===		=== Boot Order ===

	Before installing QuantaStor from the ISO, two changes must be made to the BIOS. First the USB or CD/DVD device with the QuantaStor ISO media must be selected as the primary boot device so that the install media loads at the initial install time. Second, the system disk, (the ~~disk~~ the system will boot to after installation has completed) should be the selected ~~hard disk~~ to boot from and assigned to the second position in the BIOS boot order. After the installation, you should disconnect the ISO installation media.		Before installing QuantaStor from the ISO, two changes must be made to the BIOS. First the USB or CD/DVD device with the QuantaStor ISO media must be selected as the primary boot device so that the install media loads at the initial install time. Second, the system disk, (the SSD the system will boot to after installation has completed) should be the selected device to boot from and assigned to the second position in the BIOS boot order. After the installation, you should disconnect the ISO installation media.

	=== Power Save Settings ===		=== Power Save Settings ===

Qadmin: /* Starting the Installation from RHEL Media */

2022-03-04T23:33:50Z

Starting the Installation from RHEL Media

← Older revision		Revision as of 23:33, 4 March 2022
Line 71:		Line 71:
	== Starting the Installation from RHEL Media ==		== Starting the Installation from RHEL Media ==

	QuantaStor 5.x releases can be installed on RHEL 8.4 and higher versions of Linux.		QuantaStor 5.x releases can be installed on RHEL 8.5 and higher versions of Linux.

	==== Step 1: ISO "Minimal Install" ====		==== Step 1: ISO "Minimal Install" ====
Line 121:		Line 121:

	<pre>		<pre>
	curl -o ./~~qs_upgrade_rhel8~~.sh http://packages.osnexus.com/packages-redhat/~~qs_upgrade_rhel8~~.sh		curl -o ./qs_upgrade_redhat8.sh http://packages.osnexus.com/packages-redhat/qs_upgrade_redhat8.sh
	chmod 755 ~~qs_upgrade_rhel8~~.sh		chmod 755 qs_upgrade_redhat8.sh
	./~~qs_upgrade_rhel8~~.sh installall		./qs_upgrade_redhat8.sh installall
	</pre>		</pre>