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
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
authenticate --join --domain <domain name> [--ou <org-unit name>] --user <user name>
Managing QoreStor > Authenticate Commands > Authenticate Command Usage > authenticate --join --domain <domain name> [--ou <org-unit name>] --user <user name>
Description
Joins the QoreStor to an Active Directory Services (ADS) domain when you specify the ADS domain name and a valid user (administrator) for that domain.
|
|
NOTE: When attempting to join the ADS domain, the administrator password is required for that domain to ensure that the join operation is successful. Supported domain names are limited to 64 characters in length and can only consist of a combination of A-Z, a-z, 0-9, and two special characters: a dash (-) and a period (.). |
|
|
NOTE: If you had previously joined the QoreStor to an ADS domain before running Restore Manager (RM), after it completes you must manually rejoin the desired ADS domain using the authenticate --join command. |
Syntax
authenticate --join --domain <domain name> [--ou <org-unit name>] --user <user name> [--domain-join-cli]
Where
--domain Name of ADS domain to join. --ou Name of the organizational unit to join. --user Name of ADS user with permissions to join the domain. --domain-join-cli Alternate join method to join domain
Result
Enter password for administrator@ads.storage.local: Successfully joined domain ads.storage.local Disabling NTP service... done. Updated Windows Access Server Configuration. Updated Kerberos configuration. Updated machine password. Updated DNS. Restarting Windows Access Server... done.
|
|
NOTE: The --ou command is optional and allows for defining a specific organizational group in the ADS that requires its own administrative access rights (such as an executive management or finance group). In case of multiple organizational groups, use the following format: "<topLevelOU/middleLevelOU/LowerLevelOU/TargetOU>” |
authenticate --leave [--user <user name>] [--force]
Managing QoreStor > Authenticate Commands > Authenticate Command Usage > authenticate --leave [--user <user name>] [--force]
Description
Enables a QoreStor to leave a Microsoft Active Directory Services (ADS) domain when you provide a valid administrator password.
Syntax
authenticate --leave [--user <user name>] [--force]
Where
--user Name of ADS user with permissions to leave the domain. --force Leave the domain without informing ADS.
Result
Enter password for administrator@ads.storage.local: Successfully left domain ads.storage.local. Updated Windows Access Server configuration. Updated Kerberos configuration Restarting Windows Access Server... done. Enabling NTP service... done.
|
|
NOTE: The --force command is optional and allows the QoreStor to leave the ADS domain when communication between the system and the ADS domain is lost and the --leave operation is pending or in progress. |
authenticate --update --kerberos
Managing QoreStor > Authenticate Commands > Authenticate Command Usage > authenticate --update --kerberos
Description
Updates a Microsoft Active Directory Service (ADS) Kerberos configuration (Kerberos is a computer network authentication protocol).
Syntax
authenticate --update --kerberos
Where
--kerberos Updates kerberos configuration.
Result
Updated kerberos configuration.
authenticate --add [--user <user name>]
Managing QoreStor > Authenticate Commands > Authenticate Command Usage > authenticate --add [--user <user name>]
Description
Adds a new local CIFS workgroup user for CIFS authentication (and administrative tasks) after you provide and confirm the CIFS user password.
Syntax
authenticate --add [--user <user name>][--login_group <DOMAIN\LOGIN GROUP>]
Where
--user Name of local CIFS user to add. --login_group Name of login group to add (<domain>\<login group>)
Result
Enter password for new CIFS user administrator2: Re-enter password for new CIFS user administrator2: Added CIFS user administrator2.