Installation of prerequisite packages
RHEL/CentOS
yum install httpd gcc perl kernel-devel sg3_utils iotop sysstat tar On RHEL/CentOS 8, the following additional packages yum install compat-openssl10 elfutils-libelf-devel policycoreutils policycoreutils-python-utils Ensure that the kernel-devel package version matches the installed kernel version To get the kernel-devel package version rpm -qa | grep kernel-devel To get the running kernel version uname -r If the kernel-devel version is ahead of the installed kernel then do the following additional steps yum upgrade kernel reboot yum upgrade kernel-devel
Secure Boot
Secure boot systems are not supported yet. The VTL service will fail to start since the compiled modules are not signed. To check if secure boot is enabled,
grep "Secure boot enabled" /var/log/messages
Secure boot needs to be disabled in the BIOS for the VTL service to start.
QLogic Firmware
The recent 8.07 firmware is recommended for QLA/QLE 24xx/25xx which can be got from https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.... .
Firmware can also be updated using the following links
http://www.quadstor.com/vtlnext/firmware.tgz
http://www.quadstor.com/vtlnext/firmware2400.tgz
Firmware upgrade
On the VTL system as root user
1. tar xvzf firmware.tgz (For the qla/qle24xx cards use tar xvzf firmware2400.tgz)
2. sh firmware/copyfirmware.sh
3. Reboot
4. grep "fw=" /var/log/dmesg This should be fw=8.07.00 or greater
NetApp Host Access
LUN 0 when accessed over Fiber Channel is a SCSI processor device. The sole purpose of this device is to enumerate the VTL LUNs in response to a REPORT LUNS SCSI command. However LUN 0 as a SCSI processor devices does not work for NetApp hosts. LUN 0 can emulate a basic medium changer device which works well for NetApp hosts. The procedure to do this is a follows
/sbin/modprobe qla2xxx touch /etc/modprobe.d/qla2xxx.conf echo "options qla2xxx emulate_changer=1" > /etc/modprobe.d/qla2xxx.conf
The above steps need to be done only once before installing the VTL software for the first time. Verify that option is set correctly after installing the VTL software and rebooting the system
sh# cat /sys/module/qla2xxx/parameters/emulate_changer 1
SLES 12/15
zypper install apache2 gcc perl kernel-default-devel sg3_utils sysvinit-tools On SLES 15 systems
Debian 7/8/9, Ubuntu 20.04
apt-get install uuid-runtime build-essential sg3-utils apache2 psmisc linux-headers-`uname -r` apt-get install firmware-qlogic (for FC access) On Debian8/9 and Ubuntu 16.04: a2enmod cgi
NOTE 1: firmware-qlogic package maybe unavailable from the apt-get install command unless you add ‘non-free’ to the /etc/apt/sources list.
Enable httpd startup
Run the following chkconfig commands to start httpd/apache2 on system startup
CentOS 6, Debian 7 /sbin/chkconfig --add httpd (RHEL/CentOS) /sbin/chkconfig --add apache2 (SLES 11) CentOS 7, Debian 8/9, SLES 12/15 systemctl enable httpd
Change firewall rules to accept TCP connections to port 80 for accessing the GUI. For example to allow any host to access the GUI
On CentOS 6 sudo iptables -I INPUT -p tcp --dport 80 -j ACCEPT sudo service iptables save On CentOS 7 sudo firewall-cmd --permanent --add-port=80/tcp sudo firewall-cmd --reload
Installation or Upgrading the VTL software
- Login to the target system as root
- Uninstall any previous version of the software by (in the same order listed)
On RHEL/CentOS/SLES 12/15 sh# rpm -e quadstor-xxxx - where the version can be got by sh# rpm -qa | grep quadstor On Debian systems Extended Edition: sh# dpkg -r quadstor-vtl-ext
- Install the packages by running the following commands (in the same order listed)
On RHEL/CentOS/SLES 12/15: sh# rpm -ivh quadstor-vtl-xxx.rpm On Debian Systems dpkg -i quadstor-vtl-xxx.deb
By default quadstorvtl services are automatically started during system startup.If you wish to start the service manually then run the following command
sh# /sbin/chkconfig --del quadstorvtl
To start the service manually
sh# service quadstorvtl start
To stop the service
sh# service quadstorvtl stop
SELinux Considerations
While the package installation and quadstorvtl 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
Fibre Channel driver installation
On SLES 15 "allow_unsupported_modules" needs to be changed from "0" to "1" in /etc/modprobe.d/10-unsupported-modules.conf