QuantaStor Configuration Files

QuantaStor has a series of configuration files that support the platform and make it customizable by our engineering and support team (usually to support new hardware) without requiring code level changes. Configuration files are stored in /opt/osnexus/quantastor/conf and most can be overridden using a customized version of the file stored in /var/opt/osnexus/quantastor/conf.

qs_ceph_defaults.conf

This file contains a series of defaults to be written to the global section of the ceph.conf file when a new cluster is being created.

qs_cloud_providers.conf

QuantaStor supports integration of object storage with a number of public cloud service providers including Amazon S3, Azure Blob, Dropbox, Wasabi and others. This feature is accessible via the Cloud Integration section of the QuantaStor web management interface. This configuration file enables one to add new service providers and locations to the Cloud Integration system.

qs_device_link.conf

This is an internal configuration file that controls how QuantaStor prioritizes device paths generated by udev. The Linux udev system generates links to block devices and stores them in /dev/disk/by-id and other areas under /dev/disk. These links generally contain unique identifiers or serial numbers for the device within the link name so that devices can be referred to via a strong name that will not change between reboots. Some of these links are better than others and this configuration file applies weights to the different paths according to what works best for unique device identification. It should only be edited by OSNexus support and engineering but can be used to hide invalid devices and add support for media with unique udev rules.

qs_io_profiles.conf

When creating or modifying a Storage Pool there's an option to apply a performance tuning profile to the pool so that it operates optimally for specific use cases like Server Virtualization. New profiles can be added to the system via this configuration file.

qs_nvme_initiator.conf

Some NVMeoF system vendors require special options to be applied at the time of NVMeoF connection in order for the device to work optimally with QuantaStor. One common example is customizing the number of IO queues:

--nr-io-queues=8

qs_target_blocklist.conf

This file is used to hide iSCSI and NVMeoF targets from showing up in the discovered targets list of a Software Adapter. This is used to hide control device LUNs shared by 3rd party systems.

qs_cloudcontainers.conf

Custom settings to adjust how we use rclone for mounting object storage as local NAS storage. These settings should generally not be modified but can be helpful for performance tuning.