Troubleshooting common problems

Checklist

If using the Fiber Channel interface after every install/upgrade reboot the system. This ensure that the new qla2xxx driver is loaded.

Check that quadstor-vtl-core and quadstor-vtl-itf packages installed are the same version. Mismatch in version can lead to configuration issues, system crashes etc.

On a kernel upgrade, reboot the system and then run /quadstorvtl/bin/builditf again

If the system is running other iSCSI target software ensure that those services are stopped first.

On Linux if the system had IET's iscsi-target service running, stopping the service may not remove the iscsi_trgt kernel module. In such a case remove the iscsi_trgt manually by /sbin/rmmod iscsi_trgt

Common Problems

1. When accessing the HTML UI any of the following messages are displayed
"ERROR: Getting configured storage list failed"
"ERROR: Getting pool list failed"

The above errors indicate that the mdaemon server isn't running. This indicates that the quadstorvtl service did not start or failed to start. Try starting the quadstorvtl service manually.

2. Starting the quadstorvtl service fails with the error message "Cannot start database"

The above error can occur to due a failed upgrade or due to a previous system crash. If due to a previous system crash then restarting the quadstorvtl service will fix this problem. If due to a failed upgrade, reboot the system and then retry the upgrade

3. On Linux starting the quadstorvtl service fails with the error message "Failed to insert core module"

The above error can occur if /quadstorvtl/bin/builditf was not run or failed to complete successfully. Running /quadstorvtl/bin/builditf might fix this problem. Recent versions of the software automatically run this command during install. Note that upgrading the kernel might not have created the necessary links for building external modules. Reboot the system first before running builditf

4. On Linux starting the quadstorvtl service fails with the error message "iscsi_trgt kernel module conflicts with QUADStor. Exiting..."
Stop the IET iscsi-target service and manually remove iscsi_trgt kernel module

What to do next

If the problem persists then contact support at vtlsupport@quadstor.com