Difference between revisions of "QuantaStor Shell Utilities"

From OSNEXUS Online Documentation Site
Jump to: navigation, search
m (qs-distupgrade)
m (qs-iostat)
Line 11: Line 11:
  
 
==qs-iostat==
 
==qs-iostat==
 +
This is a helper script which is an overlay over other Linux utilities for looking at device IO stats, ARC stats, and CPU stats.  It can be used as part of a hardware triage effort to see what's happening with the hardware performance wise.
 +
 
==qs-sendlogs==
 
==qs-sendlogs==
 
==qs-sslcert==
 
==qs-sslcert==

Revision as of 16:40, 11 November 2021

Internal to every QuantaStor system is the QuantaStor CLI utility 'qs' which has all the same command functionality as the QuantaStor web management interface (WUI) but there are also other helper utilities for support and triage activities like log collection. This section will go over the basic description of each of these utilities.

qs

This is the main QuantaStor management CLI which is available for download for Linux and Windows from the downloads page. Full documentation for the qs CLI is available on here here. The qs CLI can be used to automate applying licenses to systems, creating snapshots, provisioning file, block and object storage and even automating complete configuration of new clusters. It's especially useful for MSPs/CSPs where frequent configuration and setup of new QuantaStor systems needs to be automated.

qs-ceph

This internal utility helps with gathering stats on mons, pools, osds, and general cluster health. It's a low level utility that in turn calls ceph CLIs. The 'qs-ceph cleanup' command can be used to completely wipe a Ceph Cluster configuration from a system but this should only be used with great caution and only by OSNexus support.

qs-distupgrade

Regular upgrades of QuantaStor systems do not do an upgrade of the underlying distro. This is because a ditro upgrade will upgrade various drivers and other packages that could lead to a longer maintenance window for the upgrade. As such upgrades of the underlying Linux distro should only be done when an adequate maintenance window has been reserved and one should coordinate with OSNexus support before doing a distro upgrade so that your system logs can be reviewed before and after. This script runs the distro upgrade itself and is customized to handle the various platforms QuantaStor is available on.

qs-iostat

This is a helper script which is an overlay over other Linux utilities for looking at device IO stats, ARC stats, and CPU stats. It can be used as part of a hardware triage effort to see what's happening with the hardware performance wise.

qs-sendlogs

qs-sslcert

qs-statsdb

qs-upgrade

qs-version

qs-zpoolscrub

qs-avidlog

qs-crm

qs-iofence

qs-kernelupgrade

qs-showlog

qs-sslcertgen

qs-status

qs-util

qs-zconvert

qs-zvolutil