Reduce storage expenditure with QUADStor Storage Virtualization and Data Deduplication. Its Free. Start here

Get Latest Updates Facebook Facebook   Twitter Twitter   Linkedin LinkedIn

Installation/Upgrading on RHEL/CentOS 5.x, 6.x, SLES 11and Debian 6.0x

A complete installation requires that you install both the quadstor-core-xxxx.rpm and quadstor-itf-xxxx.rpm (.deb for debian systems), the steps for the same are described as below.

Installation of prerequisite packages

RHEL/CentOS

yum install httpd
yum install gcc
yum install perl
yum install kernel-devel
yum install sg3_utils

SLES 11 SP1/SP2

zypper install apache2
zypper install gcc
zypper install perl
zypper install kernel-default-devel
zypper install sg3_utils

Debian Squeeze (6.x)

apt-get install uuid-runtime
apt-get install build-essential
apt-get install sg3-utils
apt-get install apache2
apt-get install firmware-qlogic (for FC access)
apt-get install linux-headers-{uname}
where {uname} can be got from the command 'uname -r'

Run the following chkconfig commands to start httpd/apache2 on system startup

/sbin/chkconfig --add httpd (RHEL/CentOS)
/sbin/chkconfig --add apache2 (SLES 11)

Installation/Upgrading of QUADStor on RHEL/CentOS 5.6/5.7, SLES 11 SP1 and Debian squeeze 6.04

  • Login to the target system as root
  • Uninstall any previous version of the software by (in the same order listed)
sh# rpm -e quadstor.xxxx  - where the version can be got by
sh# rpm -qa | grep quadstor
Ensure that the quadstor-itf package is removed first
On Debian systems
sh# dpkg -r quadstor-itf
sh# dpkg -r quadstor-core
/quadstor/pgdata contains the configuration database of the software. This data is maintained even after an uninstall of the software and is required during upgrades. If this data were to manually removed all previous configuration such as configured storage, VDisk information etc is lost. Refer to http://www.quadstor.com/support/131-recovering-from-a-lost-or-damaged-database.html to recover from a lost or damage database
  • Install the packages by running the following commands (in the same order listed)
sh# rpm -ivh quadstor-core-xxx.rpm
sh# rpm -ivh quadstor-itf-xxx.rpm
On Debian
sh# dpkg -i quadstor-core-xxx.deb
sh# dpkg -i quadstor-itf-xxx.deb
  • Build the interface package by running the following command
sh# /quadstor/bin/builditf
NOTE: Since version 3.0.18 /quadstor/bin/builditf is automatically run during the install of quadstor-itf package and it is no longer required to run it manually. However if you upgrade the kernel or boot into a different kernel then run /quadstor/bin/builditf for that kernel.

quadstor-itf package installation might fail if the required /lib/modules/<kernel version>/build symlink is missing or is invalid. Usually a kernel upgrade might not create the symlink until a reboot. For example you might get the following error when installing the quadstor-itf package

make -C /lib/modules/2.6.32-279.el6.x86_64/build SUBDIRS=/quadstor/src/export modules
make: *** /lib/modules/2.6.32-279.el6.x86_64/build: No such file or directory.  Stop.
make: *** [default] Error 2
ERROR: Building kernel modules failed!

In such a case reboot the system and try installing the quadstor-itf package again.

cd /lib/modules/2.6.32-279.el6.x86_64/
ln -s ../../../usr/src/kernels/2.6.32-279.el6.x86_64/ build
ls -l build (to ensure that you have correctly linked)

In the above example the kernel version is 2.6.32-279.el6.x86_64 which can be got by `uname -r`

Some RHEL/CentOS installs (CentOS 6.3) might not create the build symlink correctly. In such a cases do the following steps

yum ugrade
reboot
Install quadstor-core if not installed
Install quadstor-itf

By default quadstor services are automatically started during system startup.If you wish to start the service manually then run the following command

sh# /sbin/chkconfig --del quadstor

To start the service manually

sh# /etc/rc.d/init.d/quadstor start (On RHEL/CentOS)
sh# /etc/init.d/quadstor start (On SLES, Debian)

To stop the service

sh# /etc/rc.d/init.d/quadstor stop (On RHEL/CentOS)
sh# /etc/init.d/quadstor stop (On SLES, Debian)
If the system already has other iscsi target software services running, ensure that they are not started on system startup and while starting the quadstor service
NOTE: After an install and if a reboot was not initiated you will need to manually start the quadstor service. However if after the install the system was rebooted quadstor service would have started automatically

SELinux Considerations

While the package installation and quadstor start script takes care of on SELinux enabled environment the following need to be done if you have SELinux enabled

/usr/sbin/setsebool -P httpd_enable_cgi 1
/usr/sbin/semanage permissive -a httpd_t
On RHEL/CentOS 6.x you need to install policycoreutils-python package (yum install policycoreutils-python) to install semanage utility

Fibre Channel driver installation

Since version 2.0.39 of the software, the necessary steps required for fibre channel driver installation are taken care of when you build the interface package (builditf) . If you are using a older version of the software, kindly upgrade to atleast 2.0.39

NOTE:  A reboot is required to load the new FC driver if LUNs are to be accessed via the FC interface
Copyright © 2013 QUADStor Systems - Primary Storage SAN and NAS deduplication. All Rights Reserved. Designed by JoomlArt.com.