DR Series Software 4.0 - Command Line Reference Guide

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 --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

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 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

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

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

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

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 --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 --support_agent --register system --support_agent --unregister system --support_agent --stats system --support_agent --status system --help

User

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

Maintenance

Managing DR Series System Storage Operations

System Storage Operation Commands Connection

Container

VTL

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

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

iSCSI

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

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

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 --create --op <import> [--enc_type <aes128 | aes256>] seed --remove_device seed --show seed --start seed --help

Schedule

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

grep more

network --setbonding --bondif <bondN> [--mode <ALB | 802.3ad>] [--mtu <supported MTU range 512 - 9000>]

Syntax

network --bondif bond1 --setbonding --mode ALB --mtu 1750

Result

Bond device operation successful. Please run 'network --restart' for the changes to take effect.

Note: ALB load balancing does not balance the load properly when the backup servers are on a remote subnet. This is because ALB uses the address resolution protocol (ARP) and ARP updates are subnet-specific. Because of this, ARP broadcasts and updates are not sent across the router. Instead, all traffic is sent to the first interface in the bond. To resolve this ARP-specific issue, make sure that the data source systems reside on the same subnet as the DR Series system.

Note: When setting or changing the MTU value, make sure to verify that the Ethernet network switch is capable of supporting an MTU size that is equal to or larger than the value being set. Any mismatch in MTU values between the clients, the Ethernet network switch, and the DR Series system will make it inoperable. The relationship of jumbo frames to MTU is discussed in this topic.

Note: When using the DR Series system CLI --setbonding and --mtu commands, a warning dialog displays with the following message:

Incorrectly setting the MTU size will cause the DR4000 to not respond. You will 
need to log in to the system console and use the network --setbonding --bondif bond0 --mtu 1500 command 
to resolve the issue. Please verify that the switch is enabled and capable of supporting an MTU size 
that is equal to or larger than the value being set. Do you want to continue (yes/no) ?

CAUTION:

If the existing bonding setting is changed, the connection to the DR Series system may be lost unless you are sure that the DR Series system can accept this bonding type.

In computer networking, jumbo frames are Ethernet frames with more than 1500 bytes of payload (but in some cases, jumbo frames can carry up to 9000 bytes of payload).

Many Gigabit Ethernet switches and Gigabit Ethernet network interface cards support jumbo frames. Some Fast Ethernet switches and Fast Ethernet network interface cards (NICs) also support jumbo frames.

Some computer manufacturers use 9000 bytes as the conventional limit for jumbo frame sizes. Internet Protocol (IP) subnetworks require that all hosts in a subnet have an identical MTU.

Consequently, interfaces that use a standard frame size and those that use a jumbo frame size should not be in the same subnet. To reduce the chance of interoperability issues, NICs capable of jumbo frames require special configurations to use jumbo frames. For more information, contact your Technical Support representative for assistance.

To verify that the destination system can support a specific frame size you want to attempt, use the following DR Series system CLI commands and specify the frame size in bytes using the following command as an example:

network --ping --destination <ip address> --size <number of bytes>

network --update

Syntax

 network --update [--bondif <bondN>]
                 [--nwif <ethN>]
                 [--mode < ALB | 802.3ad>]
                 [--name < DNS name >]
                 [--mtu  <Supported MTU range 512 - 9000>]


        --bondif   Bond interface to update.
        --nwif     Eth interface to update.
        --mode     Bonding mode to use.
        --name     DNS name for the interface.
        --mtu      Ethernet MTU to use (valid range is 512 - 9000).

For example, to update bond1 to use a different MTU parameter, run the command: network --update --bondif bond1 --mtu 5000

Result

WARNING: Incorrectly setting the MTU size will cause the DR appliance to not respond.

Please verify that the switch is enabled and capable of supporting an MTU size that is equal to or larger than the value being set.

Do you want to continue (yes/no) [n]? y

Interface update successful.

network --factory_reset

Syntax

network --factory_reset [--auto_bonding_speed <1G|10G>]

          --auto_bonding_speed    The speed of the device (1G or 10G) 
                                  to bond on restart.

Result

WARNING: This will reset network configuration to factory settings and
will require a system reboot. Existing configuration will be lost.

Do you want to continue (yes/no) [n]?yes
Reboot the system using the command 'system --reboot' to complete the network factory reset.

Please select your product:

To serve you better, please complete the Purpose of your Chat:

Recommended Solutions for Your Problem

DR Series Software 4.0 - Command Line Reference Guide

network --setbonding --bondif <bondN> [--mode <ALB | 802.3ad>] [--mtu <supported MTU range 512 - 9000>]

Syntax

Result

network --update

Syntax

Result

network --factory_reset

Syntax

Result

network --host

Syntax