Chat now with support

Get Live Help
Complete Registration

Sign In

Request Pricing

Contact Sales

DR Series Software 4.0.4 - Command Line Reference Guide

Table of Contents

Introduction to the DR Series System Command Line Reference Guide

About the DR Series system CLI documentation Other information you may need Locating your system Service Tag

Introducing the DR Series system

Understanding the DR Series system CLI Accessing the DR Series system CLI commands DR Series system CLI commands overview

Managing the DR Series system

Alerts Commands

Alerts Command Usage alerts --show [--email] alerts --show [--snmp] alerts --show [--events] [--index <[-]number> [--count <number>] [--all] alerts --show [--alerts] [--index <[-] number>] [--count <number>] [--all] alerts --show [--summary] alerts --email [--relay_host <server name>] alerts --email [--appliance_alerts <yes | no>] alerts --email [--software_updates <yes | no>] alerts --email [--daily_report <yes | no>] alerts --email [--daily_report_time <0–24 hr>] alerts --email [--sender_email <email address>] alerts --test_email alerts --snmp_add --host <server name> --port <number> --community <name> alerts --snmp_delete --host <server name> alerts --snmp_disable --host <server name> alerts --snmp_enable --host <server name> alerts --snmp_trap_email [--enable] [--disable] alerts --help

Authenticate Commands

Authenticate Command Usage authenticate --show [--users] authenticate --show [--domain <domain name>] authenticate --show [--login_group] 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 --add [--login_group <DOMAIN\LOGIN GROUP>] authenticate --delete--user <user name> authenticate --delete [--login_group <DOMAIN\LOGIN GROUP>] authenticate --set --user <user name> authenticate --guestmode [--enable] [--disable] authenticate --guestmode [--enable] authenticate --guestmode [--disable] authenticate --server_signing --mode <auto | mandatory | disabled> authenticate --help

Network Command Usage network --show network --delete network --restart network --setdhcp network --setstatic_ip [--bondif <bondN>] [--nwif <ethN>] --ip <IPv4/IPv6 address not already in use> --netmask <netmask> [--gateway <IPv4/IPv6 address>] network --create_bond network --create_eth network --add_member network --setdns [--suffix <dns suffix>] [--primary <IPv4/IPv6 address>] [--secondary <IPv4/IPv6 address>] network --setbonding --bondif <bondN> [--mode <ALB | 802.3ad>] [--mtu <supported MTU range 512 - 9000>] network --update network --factory_reset network --host network --route network --nslookup --destination <ip address | hostname> network --traceroute --destination <ip address | hostname> network --ping --destination <ip address | hostname> [--tries <number>] [--size <number>] [--interface <bondN | ethN>] network --blink network --enable network --disable=GUID-925B2D94-D583-4966-ABDE-8E3FE14B59FC=1=en-us= network --troubleshoot [--links] [--gateway] [--ntp] [--dns] [--active_domain] [--nis] [--clients] [--port_mapper] [--network_config] [--show_active <NFS|CIFS|OST|RDS|NDMP|ISCSI|FC>] [--interface <bondN | ethN>] network --troubleshoot --gateway --interface <bondN | ethN> network --troubleshoot [--show_active <NFS| CIFS|OST|NDMP|ISCSI|RDS>] network --tcpdump [--port <nfs | windows | replication | ost | rds>] [--pkt_size <128 - 32768>] [--file_size <0 - 100>] [--stop] [--host <ip address list>] [--interface <bondN | ethN>] network --tcpdump [--pkt_size <128 - 32768>] network --tcpdump [--file_size <0 - 100>] network --tcpdump [--host <ip address list>] network --tcpdump [--port <nfs | windows | replication | ost | rds>] network --iperf_client --server <ip address | hostname> [--port <number>] [--window_size <num bytes [KB/MB]>] [--interval <num seconds>] [--time <num seconds>] network --iperf_server [--port <number>] [--window_size <num bytes [KB/MB>] network --help

OST Command Usage 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 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 stats --system stats --cpu stats --memory stats --network stats --datacheck stats --nfs stats --cifs stats --ost stats --rds stats --ndmp stats --ndmp_completed stats --iscsi [--verbose] stats --fc [--iostat] [--linkstat] 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 --reset --datacheck stats --seed stats --help stats --datacheck stats --datacheck Command Usage stats --help datacheck

Storage Group commands

Storage Group Command Usage 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 --setpassphrase --name <name> storage_group --delete --name <name> storage_group --help

System Command Usage system --show [--config] system --show [--hardware] system --show [--storage] [--type <boot | internal | external>] [--service_tag <service tag>] system --show [--storage] system --show [--license] [--verbose] system --show [--ntp] system --show [--version] system --show [--timezones [Region]] system --show [--upgradefile] system --show [--upgradehistory] system --show [--marker] system --show [--replication_traffic] system --show [--opdup_traffic] system --show [--backup_traffic] system --show [--mgmt_traffic] system --init system --init --secure_erase <1–pass/3-passes/7-passes> system --reboot system --shutdown system --upgrade system --license [--validate] [--add] system --setname --name <node_name> system --setdate [--date <date>] [--timezone <Region/Zone>] system --setntp [--add <server name>] system --setntp [--delete <server name>] system --setntp [--enable] system --setntp [--disable] system --setntp [--adjust_time] system --hybrid_replication [--enable][--disable][--status] system --rdairgap [--enable][--disable][--set_retention_period <0 days to 365 days>][--get_retention_period][--open][--close][--status] system --rdairgap_schedule [--start_time <HH:MM>][--end_time <HH:MM>][--remove] system --setlogin system --telnet [--enable | --disable] system --datacheck --enable system --datacheck --disable system --datacheck --throttle system --marker [--enable] [--disable] system --verify_on_read [--enable] [--disable] system --add_storage --enclosure <service tag> system --storage [--set_usage_alert <70% - 90%>] system --storage [--blink] [--type <internal | external>] [--service_tag <service tag>] [--disk <slot num>] system --storage [--unblink] [--type <internal | external>] [--service_tag <service tag>] [--disk <slot num> system --mgmt_traffic system --backup_traffic system --replication_traffic system --opdup_traffic system --help

User Command Usage user --show [--users] [--logins] [--verbose][--name <username>] [--roles <cifs|ost|rda|ndmp|iscsi|monitor|administrator|email_recipient> user --enable --user <service | root> user --disable --user <service | root> 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

Virtual Machine

Virtual Machine Command Usage virtual_machine -- show [--service_tag <service tag>] virtual_machine --show --summary virtual_machine --update [--host <ip address | hostname>] [--name <administrator name>] [--email <email address>] [--company <company name>] [--comments <comments>] virtual_machine --register [--host <ip address| hostname>] [--name <administrator name>] [--email <email address>] [--company <company name>] [--comments <comments>] virtual_machine --unregister [--force] virtual_machine –delete --service_tag <service tag>

Maintaining the DR Series System

Diagnostics Command Usage diagnostics --start-service diagnostics --show diagnostics --collect diagnostics --collect [--name <name>] diagnostics --collect [--reason <reason>] diagnostics --collect [--force] diagnostics --collect [--dset] diagnostics --collect [--logs] diagnostics --collect [--cores] diagnostics --collect [--tcpdump] diagnostics --collect [--process_dump] diagnostics --collect [--all] diagnostics --delete [--name <name>] diagnostics --delete [--all] diagnostics --copy --name <name> --host <user@host | ip:>:<path>> diagnostics --help

Maintenance Command Usage maintenance --filesystem [--start_scan [verify_data | verify_rda_metadata | verify_metadata] [--storage_group <name>] maintenance --filesystem [--stop_scan] maintenance --filesystem [--scan_status] maintenance --filesystem [--scan_report [verbose]] maintenance --filesystem [--repair_status [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 [--clear_quarantine] maintenance --filesystem [--clear_quarantine] maintenance --filesystem --show_throughput maintenance --configuration [--backup] maintenance --configuration [--restore] maintenance --configuration [--reinit_dictionary] maintenance --configuration [--reset_web_certificate] maintenance --configuration --enable_sha256_web_certificate maintenance --hardware [--reinit_nvram] maintenance --hardware [--restore_hw_db] maintenance --hardware [--motherboard_replaced] maintenance --disk [--make_standby [slot num]] [--type <internal | external-<num> | service tag>] --clear_foreign] maintenance --remote_access [--show] maintenance --remote_access [--enable] maintenance --remote_access [--racreset] maintenance --remote_access [--static_ip] [--ip <IPv4/IPv6 address>] [--netmask <netmask>] [--gateway <IPv4/IPv6 address>] [--device <lom1|lom2|lom3|lom4>] maintenance --remote access [--disable] maintenance --vdisk --check_consistency --type <boot|internal|external> [--service_tag <service tag>] maintenance --help

Managing DR Series System Storage Operations

System Storage Operation Commands Connection

Connection Command Usage connection --show [--name <name>] connection --show [--name <name>] [--type <NFS|CIFS|OST|RDS|NDMP|ISCSI|FC>] [--verbose] connection --show [--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 container --show 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> 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 --delete_files --name <name> container --help

VTL Command Usage vtl --show [--name <name>] vtl --show --verbose [--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 --set_rw --name <name> [--id <number>] vtl --show_replstate --name <name> vtl --help

NDMP Command Usage ndmp --show ndmp --update [--port <port number>] ndmp --help

ISCSI Command Usage iscsi --show [--user] iscsi --setpassword iscsi --sessions iscsi --help

FC Command Usage fc --show [--verbose] [--target] fc --sessions [--topology] [--condensed] fc --help <command>

Replication Command Usage replication --show [--name <name>] [--role <source | target>] [--verbose] [--limits] replication --show replication --show [--limits] 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 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

Schedule Command Usage schedule --show [--cleaner] schedule --show [--replication] [--name <name>] schedule --add --day <day of the week> [--cleaner] [--replication] [--start_time <hh:mm>] [-- stop_time <hh:mm>] [--name <name>] schedule --delete --day <day of the week> [--cleaner] [--name <name>] [--replication] schedule --help

Data Integrity Checking

About Data Check

Priority Write Verify Scans Continuous Data Verification Scans Data Check CLI Commands Data Check Options

Data Check: Namespace Scan Option Data Check: Blockmap Scan Option Data Check: All Data Scan Option

System --Datacheck

System --Datacheck Command Usage system --datacheck system --datacheck --disable system --datacheck --enable system --datacheck --throttle system --help datacheck

stats --datacheck

stats --datacheck Command Usage stats --datacheck

Additional Linux Commands

Maintenance

Maintaining the DR Series System > Maintenance

The DR Series system CLI maintenance commands lets you display the system maintenance repair progress, and manage the data repair and state of a DR Series system. Maintenance tasks let you perform basic repairs and maintain the data and the DR Series system.

NOTE: Whenever the DR Series system enters or exits from the Maintenance mode state, all communication via CIFS, NFS, OST, or RDS is lost.

The set of maintenance commands and options should only be used when the DR Series system is in the Maintenance mode state. You should contact Technical Support before performing any of these DR Series system CLI commands.

The --filesystem commands perform maintenance operations on the DR Series system file system, the --configuration commands perform a backup and restore of the system configuration, the --hardware commands manage the appliance hardware, the --disk commands manage the system disk drives, and the --vdisk commands manage the virtual disk drives.

NOTE: This set of maintenance commands provide some functionality that is not available in the DR Series system GUI. To check the status of the DR Series system, use the DR Series system CLI system --show command to display the current status.

Maintenance Command Usage

Maintaining the DR Series System > Maintenance > Maintenance Command Usage

This topic introduces the maintenance command usage:

NOTE: Using some of the maintenance command options could result in the deletion of data. Carefully observe the warnings (for example, running the scan without running the repair). If you have questions, do not perform these DR Series system CLI command options without first contacting Technical Support.

maintenance --filesystem [options]
maintenance --configuration [options]
maintenance --hardware [options]
maintenance --disk [options] (Option only available on a Physical DR)
maintenance --remote_access [options] (Option only available on a Physical DR)
maintenance --vdisk --check_consistency --type [options] (Option only available on a Physical DR)
maintenance --help

NOTE: If you specify a command without supplying the expected value or option, you are prompted to provide the correct value or option.

maintenance --filesystem [--start_scan [verify_data | verify_rda_metadata | verify_metadata] [--storage_group <name>]

| verify_rda_metadata | verify_metadata] [--storage_group <name>]

Description

Starts filesystem checker to check for consistency issues in storage groups.

NOTE: Argument verify_data validates data with pre-built checksum. Argument verify_rda_metadata scans only OST and RDA containers. Argument verify_metadata scans the namespace for all containers.

NOTE: Using this command places the files system into a read-only mode and pauses all active replications. When the DR Series system enters Maintenance mode, an alert is sent that indicates this operational change.

Syntax

maintenance --filesystem --start_scan verify_data --storage_group SGTest1

Result

This operation will make the filesystem read-only and pause all active replications.
"verify_data" option will check for data consistency issues in the filesystem.  This might take long time to complete.
Do you want to continue (yes/no) [n]? y
Please enter the administrator password:

Filesystem check started successfully.

To see the status, please execute "maintenance --filesystem --scan_status".

If you enter the maintenance --filesystem --scan_restart command when the DR Series system is not in Maintenance mode, the following output is displayed at the system prompt:

maintenance --filesystem --scan_restart

"Operation not supported as system is not in maintenance mode. 
To be able to restart scan, filesystem check must be running or waiting".

maintenance --filesystem [--stop_scan]

Maintaining the DR Series System > Maintenance > maintenance --filesystem [--stop_scan]

Description

Stops the filesystem scan process that verifies the data contained in a DR Series system.

Syntax

maintenance --filesystem --stop_scan

Result

This operation will stop the filesystem checker and put the system back into operational mode.
Do you want to continue (yes/no) [n]? y
Please enter the administrator password:
Filesystem check stopped successfully.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating

© ALL RIGHTS RESERVED. Terms of Use Privacy Cookie Preference Center