The QoreStor command line interface (CLI) provides the most efficient method for managing the status, data capacity, storage savings, and throughput of data containers. While some QoreStor functions can be managed through the QoreStor GUI, the CLI provides full access to all QoreStor features and functions.
Introduction to the QoreStor Command Line Reference Guide
Introducing QoreStor
Managing QoreStor
Alerts Commands
Authenticate Commands
Managing QoreStor Storage Operations
Authenticate Command Usage
Email_alerts Commands
Email_stats Commands
OST
authenticate --show [--users]
authenticate --join --domain <domain name> [--ou <org-unit name>] --user <user name>
authenticate --leave [--user <user name>] [--force]
authenticate --update --kerberos
authenticate --add [--user <user name>]
authenticate --delete--user <user name>
authenticate --set --user <user name>
authenticate --guestmode [--enable]
authenticate --server_signing --mode <auto | mandatory | disabled>
authenticate --help
OST Command Usage
RDA
ost --show [--config] [--file_history] [--name <name>] [--active_files] [--name <name>] [--clients] [--limits]
ost --update --opdup_encryption <none | aes128 | aes256>
ost --delete_client --name <OST Client Hostname>
ost --update_client --name <OST Client Hostname> --mode <auto | passthrough | dedupe>
ost --limit --speed <<num><KBps | MBps | GBps | default> --target <ip address | hostname>
ost --partial_images --containerid <Container id> [--delete <Partial image path>] [--timeout <> 0>]
ost --help
RDA Command Usage
Sc_manager command
Stats
rda --show [--config] [--file_history] [--name <name>] [--active_files] [--name <name>] [--clients] [--limits]
rda --update --opdup_encryption <none | aes128 | aes256>
rda --delete_client --name <RDA Client Hostname>
rda --update_client --name <RDA Client Hostname> --mode <auto| passthrough| dedupe>
rda --limit --speed <<num><KBps| MBps| GBps> | default> --target <ip address | hostname>
rda --partial_images --containerid <Container id> [--delete <Partial image path>] [--timeout <> 0>]
rda --help
Stats Command Usage
Storage Group commands
stats --system
stats --cpu
stats --memory
stats --nfs
stats --cifs
stats --ost
stats --rds
stats --iscsi [--verbose]
stats --container --name <name>
stats --storage_group --name <name>
stats --replication [--name <name>]
stats --cleaner
stats --clients [--type <NFS|CIFS|OST|RDS|NDMP|ISCSI|FC>]
stats --reset [--nfs] [--cifs] [--ost] [--rds] [--datacheck]
stats --seed
stats --peformance_tier
stats --cloud_tier
stats --object_direct
stats --archive_tier
stats --object_container
stats --help
Storage Group Command Usage
System
User
storage_group --show [--name <name>] [--verbose]
storage_group --add --name <name> [--compression_mode <fast|best>]
storage_group --update --name <name> [--compression_mode <fast|best>]
storage_group --encryption --name <name> [--set <ON | OFF>] [--mode <static|internal> <--interval <7 days to 70 years>]
storage_group --delete --name <name>
storage_group --setpassphrase --name <name>
storage_group --help
User Command Usage
user --show [--users] [--logins] [--verbose][--name <username>] [--roles <cifs|ost|rda|ndmp|iscsi|monitor|administrator|email_recipient>
user --add --name <user name>
user --update --name <user name> [--new_name <user name>] [--add_roles <cifs|ost|rda|ndmp|iscsi|monitor|email_recipient>] [--remove_roles <cifs|ost|rda|ndmp|iscsi|monitor|email_recipient>] [--full_name <full name>] [--phone <phone number>] [--email_addr <
user --delete --name <user name>
user --setpassword --name <user name>
user --help
Cloud_tier
Connection
Maintaining QoreStor
Connection Command Usage
Container
connection --show [--name <name>] [--type <NFS|CIFS|OST|RDS|NDMP|ISCSI|FC>] [--verbose]
connection --add --name <name> --type <NFS|CIFS|OST|RDS|NDMP|ISCSI|FC> [--clients <ip address>][--dma <ip address>][--initiator <IQN, ip address(es), hostname, or WWPN>][--target <WWPN>][--rootmap <nobody|root|administrator>] [--options <NFS|CIFS
connection --update --name <name> --type <NFS|CIFS|OST|RDS|NDMP|ISCSI|FC> [--clients <ip address>][--dma <ip address>][--initiator <IQN, ip address(es), hostname, or WWPN>][--target <WWPN>][--rootmap <nobody|root|administrator>] [--options <NFS|CI
connection --delete --name <name> --type <NFS|CIFS|OST|RDS|NDMP|ISCSI|FC> [--clients <ip address>]
connection --enable --name <name> --type <NFS|CIFS|OST|RDS>
connection --disable --name <name> --type <NFS|CIFS|OST|RDS>
connection --help
Container Command Usage
iSCSI
NDMP
Object_container
Object_direct
Performance_tier
Replication
container --show [--name <name>] [--verbose]
container --add --name <name> [--type <VTL>] [--tape_size <tape_size>][--no_of_drives <1–60>][--is_oem <yes|no>][--oem_vendor <QUEST|DELL>][--group_name <name>]
container --update --name <name> [--no_of_drives <1–60>]
container --delete --name <name> [--delete_files]
container --marker [--enable <Auto | CommVault | Networker | TSM | ARCserve | HP_DataProtector | Unix_Dump | BridgeHead>] [--disable <Auto | CommVault | Networker | TSM | ARCserve | HP_DataProtector | Unix_Dump | BridgeHead>] --name <name>
container --cloud_policy
container --delete_files --name <name>
container --add_uac
container --delete_uac
container --update_uac
container --show_uac
container --help
Replication Command Usage
Seed
replication --show
replication --add --name <name> --role <source | target> --peer <ip address | hostname> [--peer_name <name>] [--peer_group_name <name>] [--replication_traffic <ip address | hostname>] [--encryption <none | aes128 | aes256>][--username <user name>]
replication --update --name <name> --role <source | target> [--peer <ip address | hostname>] [--encryption <none | aes128 | aes256>] [--username <user name>]
replication --delete --name <name> --role <source | target> [--force]
replication --start --name <name> --role <source | target>
replication --stop --name <name> --role <source | target>
replication --limit --speed <<num><KBps | MBps | GBps> | default> --target <ip address | hostname>
replication --resync --name <name> --role <source | target>
replication --troubleshoot --peer <ip address | hostname>
replication --help
Seed Command Usage
Schedule
VTL
seed --create --op <import | export> [--enc_type <aes128 | aes256>] [--storage_group_name <name>]
seed --add_container --name <container name>
seed --add_device --server <server name> --volume <volume> --username <username> --domain <domain name>
seed --cleanup
seed --remove_device
seed --show
seed --start
seed --help
VTL Command Usage
vtl --show [--name <name>]
vtl --update_carts --name <name> --add --no_of_tapes <number>
vtl --activate --name <name> [--force <yes|no>]
vtl --deactivate --name <name>
vtl --rescan --name <name> [--force <yes|no>]
vtl --restore
vtl --set_rw --name <name> [--id <number>]
vtl --show_replstate --name <name>
vtl --help
Maintenance
About us
Maintenance command
maintenance --filesystem [--scan_status]
maintenance --filesystem [--scan_report [verbose]]
maintenance --filesystem [--repair_history [verbose]]
maintenance --filesystem [--scan_restart [verify_data | verify_rda_metadata | verify_metadata]]
maintenance --filesystem [--repair_now]
maintenance --filesystem [--reclaim_space]
maintenance --filesystem [--stop_reclaim_space]
maintenance --filesystem [--clear_quarantine]
maintenance --filesystem [--start_scan [verify_data | verify_rda_metadata | verify_metadata] [--storage_group <name>]
maintenance --filesystem [--stop_scan]
maintenance --diags --collect
maintenance --diags --show
maintenance --diags --delete <name>
maintenance --diags --delete_all
maintenance --disaster_recovery
maintenance --help
Understanding the QoreStor CLI
Accessing the QoreStor CLI commands
This guide assumes that your QoreStor system has been deployed in the proper network location and is accessible to your workstation.
Accessing the CLI commands
Accessing the CLI commands
To access the command line interface for QoreStor:
- Using the terminal emulation application of your choice, connect to your QoreStor server.
- At the system prompt, enter the username for an account with sufficient privileges. By default this is the qsadmin account:
- Type qsadmin
- Press <Enter>
- At the password prompt, enter the password for the qsadmin account (the default is St0r@ge!):
- Type St0r@ge!
- Press <Enter>
- Enter the desired command at the prompt. To view the available QoreStor CLI commands, type help.
Alternatively, you may access the command line interface through the QoreStore web terminal in the QoreStor GUI.
To access the Web Terminal
- On the QoreStor UI, select System to expand the menu. Click Terminal
- In the Username field, enter the desired user name. You will be prompted for the password.
NOTE:QoreStor includes a custom shell implementation that simplifies and secures command line access. During installation, QoreStor creates the qsadmin user account with the permissions and configurations necessary to run QoreStor commands. Unless absolutely necessary, Quest recommends using the qsadmin account for CLI access. The default credentials are:
user: qsadmin
password: St0r@ge!
- Click Connect to authenticate and access the terminal.
- To view the list of available QoreStor commands, enter help at the prompt.
NOTE: Refer to the QoreStorCommand Line Reference Guide for more detailed information on QoreStor CLI commands.
- To log out of the terminal, enter exit at the prompt.
|
|
NOTE: When using Internet Explorer 11 to access the QoreStor UI, the Terminal page is displayed directly after logging in to QoreStor. The QoreStor navigation menu is not displayed and use of other UI functions is not supported. |
QoreStor CLI commands overview
The following command groups are available in the QoreStor CLI.
For more information on each command group, run the following command:
<command name> --help show
| Command Group | Description |
|---|---|
|
alerts |
View system events and alerts. |
|
authenticate |
Configure Active Directory (AD) authentication. |
| cloud_tier | Configure a cloud connection. |
|
connection |
Configure OST or RDS access to a container. |
|
container |
Configure a filesystem to share over RDS or OST. |
|
|
Manage and view iSCSI connection types for VTL containers. |
|
|
Manage and view NDMP connection types for VTL containers. |
|
|
Repair the data and state of the system. Collect diagnostics for the product. |
| object_container | Configure and manage Object Container. |
|
ost |
Configure OST for Veritas (formerly Symantec) backup applications. |
| performance_tier | Configure a performance tier storage group. |
| qs_help | Display the QoreStor help command listing. |
|
rda |
Configure Rapid Data Access (RDA) for the NetVault application. |
|
replication |
Manage replication between systems. |
|
schedule |
Manage replication and cleaner schedules in the system. |
|
seed |
Configure and manage seeding import or export. |
|
stats |
View statistics for system components. |
| storage_group | Manage and view the storage groups on a QoreStor |
|
system |
Manage and view the system configuration. |
|
user |
Enable or disable service and root accounts on the node. |
|
vtl |
Manage and view VTL container types. |