QoreStor 7.0.0 - Command Line Reference Guide

Description

QoreStor installs with a 1 TB trial license. If you have purchased a perpetual license, you can install it using the system --license command, as described below.

When you have downloaded your license file, you will need to copy it to the QoreStor server before installing the license. In the examples below <path> is used to represent the directory that contains the license file.

Syntax

system --license [--show] [--verbose] [--validate] [--file <path>] [--add] [--file <path>]

Where

--show       Shows the installed license.
--verbose    Shows more information.
--validate   Validates the license file.
--add        Installs the license file.
--file       License file path.

Result

License file is valid and can be installed. 

To add a validated license for a QoreStor server, use the following QoreStor CLI command:

system --license --add --file <path>
License file has successfully installed.

Description

Adds the volume at the specified path to the QoreStor server and shows the current storage configuration.

Syntax

system --storage [--add] [--path <path>] [--show]

Where:

--add    Add the data storage.
--show   Show the data storage.
--path   Path to the data storage.

Result

ENCLs 	Path 		Total(GiB) Available(GiB) Used(GiB) Status

ENCL_0 /quest/ocaroot 	599 	   307 		  292 	    On

Other Examples

To add storage to QoreStor, use the command below. In this example, the path to the storage is /qs4.

system --storage --add --path /qs4

Result

Running IOPS tests on /qs4, takes few minutes

Sequential and Random IOPS tests passsed on /qs4
WARNING: IO will be stopped during storage addition.
Do you want to continue (yes/no) [n]? yes
Stopping filesystem... Done.
Configuring data storage volume... Done.
Starting filesystem... Done.

Description

Displays the list of all system-related options that can be used as a reference when using the QoreStor CLI.

Syntax

system --help

Result

Usage:
	system --show 
                 [--storage] 
                 [--license] [--verbose]
                 [--version]
       
	  system --license 
		  [--show] [--verbose]
		  [--validate] [--file <path>]		
		  [--add] [--file <path>]										
		
	  system --storage [--add] [--path <path>]
		  [--show]

         system --help

   system <command> <command-arguments>
   <command> can be one of:
  	--show                  Displays command specific information.  
 	--license               Installs the license on the machine.
    	--storage		Configure / Display storage properties.
				
For command-specific help, please type system --help <command>
        eg:
            system --help show

This topic introduces the QoreStor CLI commands that allow you to manage user accounts by enabling or disabling user accounts, adding and updating users, setting passwords, deleting users, and displaying the list of current active user accounts logged in to a QoreStor.