Dell PowerVault Storage Area Network Reference Manual

Dell dr series system command line reference guide
Hide thumbs Also See for PowerVault Storage Area Network:
Table of Contents

Advertisement

Dell DR Series System
Command Line Reference Guide

Advertisement

Table of Contents
loading

Summary of Contents for Dell PowerVault Storage Area Network

  • Page 1 Dell DR Series System Command Line Reference Guide...
  • Page 2: Notes, Cautions, And Warnings

    CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2013 Dell Inc. Trademarks used in this text: Dell , the Dell logo, Dell Boomi , Dell Precision , OptiPlex...
  • Page 3: Table Of Contents

    Contents Notes, Cautions, and Warnings....................2 1 Introduction to the DR Series System Command Line Reference Guide......11 ....................11 About the DR Series System CLI Documentation ...........................11 Other Information You May Need 2 Introducing the DR Series System..................13 ....................14 DR Series System Drive and System Capacities ....................15 Accessing the DR Series System CLI Commands ..................................16...
  • Page 4 ............................27 Authenticate Commands ........................27 Authenticate Command Usage ..........................27 authenticate --show [--users] ....................28 authenticate --show [--domain <domain name>] ........................28 authenticate --show [--login_group] ......28 authenticate --join --domain <domain name> [--ou <org-unit name>] --user <user name> ..................29 authenticate --leave [--user <user name>] [--force] ........................29 authenticate --update --kerberos ......................30...
  • Page 5 network --iperf_server --client <ip address | hostname> [--port <number>] [--window_size <num ..............................45 bytes [KB/MB>] ..............................45 network --help ..................................47 ............................47 OST Command Usage ..............47 ost --show [--config] [--file_history] [--name <name>] [--clients] ............................48 ost --show [--clients] ............................49 ost --setpassword ..................49 ost --delete_client --name <OST Client Hostname> ......49 ost --update_client --name <OST Client Hostname>...
  • Page 6 .........................70 system --show [--upgradefile] ........................70 system --show [--upgradehistory] ..........................70 system --show [--marker] ..............................71 system --reboot ............................71 system --shutdown .............................71 system --upgrade ........................72 system --license [--validate] [--add] ......................73 system --setname --name <node_name> ......................73 system --setcompression [--fast] [--best] ...............73 system --setdate [--date <date>] [--timezone <Region/Zone>] ......................74 system --setntp [--add <server name>] .......................74...
  • Page 7 ..........................87 diagnostics --collect [--force] ..........................88 diagnostics --collect [--dset] ..........................88 diagnostics --collect [--all] ......................88 diagnostics --delete [--name <name>] ..........................89 diagnostics --delete [--all] ............89 diagnostics --copy --name <name> --host <user@host | ip:>:<path>> ............................89 diagnostics --help ................................90 Maintenance ........................90 Maintenance Command Usage .......................91 maintenance --filesystem [--scan_status] ..................91 maintenance --filesystem [--scan_report [verbose]]...
  • Page 8 ................103 connection --enable --name <name> --type <nfs|cifs|ost> ................103 connection --disable --name <name> --type <nfs|cifs|ost> ............................104 connection --help ................................105 Container ...........................105 Container Command Usage ............................105 container --show ....................105 container --show [--name <name>] [--verbose] ........................106 container --add --name <name> ........................106 container --delete --name <name> ..................107 container --delete --name <name>...
  • Page 9 ..........................121 Priority Write Verify Scans ......................122 Continuous Data Verification Scans ..........................122 Data Check CLI Commands ............................122 Data Check Options ...........................123 Data Check CLI Commands ........................123 system --datacheck Commands ........................123 stats --datacheck Commands .............................123 System --Datacheck ......................124 System --Datacheck Command Usage ............................124 system --datacheck ..............124...
  • Page 11: Introduction To The Dr Series System Command Line Reference Guide

    About the DR Series System CLI Documentation This topic introduces the concept of using the Dell DR Series system command line interface (CLI) method for managing your data backups, performing a variety of data storage operations, and using containers to meet your backup and replication storage needs.
  • Page 13: Introducing The Dr Series System

    Adapts to a wide variety of data backup installations and environments The Dell DR Series system contains data backup and management software preinstalled on a Dell hardware appliance, which provides a robust disk-based data deduplication backup capability installed on a deduplication-enabled...
  • Page 14: Dr Series System Drive And System Capacities

    Data Integrity Checking. This Dell DR Series system CLI documentation assumes that the DR Series system has been deployed in its network location, and it is ready to be accessed using the DR Series system CLI commands. DR Series System Drive and System Capacities Table 1 defines the internal system drive capacity and available physical capacity (in decimal and binary values) in the Release 1.0.1.2 and later releases of DR4000 system.
  • Page 15: Accessing The Dr Series System Cli Commands

    300 GB 2.47 TB 2.2 TiB For more information about the external data storage capacity supported by the addition of expansion shelf enclosures, Dell DR Series System Administrator Guide : see the following sections in the DR Series Expansion Shelf •...
  • Page 16: Help

    This topic introduces the complete set of DR Series system CLI commands that comprise the Help system of command line interface commands for the DR Series system. To display the DR Series system Help, type help at the command line: Dell DR4000 Help alerts View system events and configure email notifications.
  • Page 17: Managing The Dr Series System

    Managing the DR Series System This topic introduces the DR Series system CLI commands for configuring, managing, and viewing the current status of a DR Series system. For example, the DR Series system CLI alerts and system commands both contain options that provide administrators with the capability to configure, manage, and display the status of the a DR Series system.
  • Page 18: Alerts --Show --Email

    NOTE: If you specify a command without supplying the expected value or option, you will be prompted to provide the correct value or option. alerts --show [--email] Description Displays the list of email recipients, mail relay host, and the administrator contact information for the DR Series system. Syntax alerts --show --email Result...
  • Page 19: Alerts --Show [--Alerts] [--Index <[-] Number>] [--Count ] [--All]

    Result Index Severity Time Event Message -------------------------------------------------------------------------------- INFO 2012-06-10 14:07:18 System diagnostic package collected. INFO 2012-06-10 12:21:47 Successfully updated Cleaner schedule. INFO 2012-06-10 12:20:03 User service enabled. alerts --show [--alerts] [--index <[-] number>] [--count <number>] [--all] Description Displays the current list of DR Series system alerts. NOTE: By default, all DR Series system alerts are displayed.
  • Page 20: Alerts --Show --Summary

    alerts --show [--summary] Description Displays a summary list of DR Series system alerts. Syntax alerts --show --summary Result Total alert messages: Total event messages: Last event index: alerts --email [--add <email>] Description Displays the current email recipient address(es) for the DR Series system. Syntax alerts --email Result...
  • Page 21: Alerts --Email [--Recipients ]

    Syntax alerts --email --delete juan_ruiz@acme.com Result Alert email settings updated. Recipients: john_smith@acme.com Relay Host: Admin Name: John_Smith Company Name: Acme.com Admin Email: john_smith@acme.com Phone: 408-555-1212 Comments: Day Shift Administrato alerts --email [--recipients <email>] Description Configures the email addresses for all recipients designated to receive alert email notifications for the DR Series system. Syntax alerts --email --recipients john_smith@acme.com,juan_ruiz@acme.com Result...
  • Page 22: Alerts --Email [--Admin_Name ]

    alerts --email [--admin_name <admin name>] Description Configures an administrator name (admin_name) for the DR Series system. Syntax alerts --email --admin_name John_Smith Result Alert email settings updated. Recipients: Relay Host: relayhost13 Admin Name: John_Smith Company Name: Admin Email: Phone: Comments: NOTE: To enable the use of spaces between the first and last name values when configuring an administrator name (or between multiple words in --company <name>, and in --comments <text>), enclose these values within quotation marks (for example, using the command string, --admin_name "John Smith").
  • Page 23: Alerts --Email [--Phone ]

    Relay Host: relayhost13 Admin Name: John_Smith Company Name: Acme.com Admin Email: john_smith@acme.com Phone: Comment: alerts --email [--phone <phone number>] Description Configures the telephone number for the administrator associated with the DR Series system. Syntax alerts --email --phone 408-999-5555 Result Alert email settings updated. Recipients: Relay Host: relayhost13...
  • Page 24: Alerts --Email [--Software_Updates ]

    Result Alert email settings updated. Recipients : juan_corona@acme.com Relay Host : acme-sys-60.western.local Admin Name : Juan Corona Company Name : Acme Inc. Admin Email : juan_corona@acme.com Phone : 438-999-6699 Comments : Days shift1 administrator Appliance Alerts : Yes Software Updates : Yes alerts --email [--software_updates <yes | no>] Description...
  • Page 25: Alerts --Snmp_Add --Host --Port --Community

    alerts --snmp_add --host <server name> --port <number> --community <name> Description Sets SNMP traps for a host by defining its host name, port number, and listing the corresponding SNMP community. Syntax alerts --snmp_add --host 10.12.14.20 --port 1550 --community snmpPublic1 Result Host "10.12.14.20" added to SNMP alert recipients. alerts --snmp_delete --host <server name>...
  • Page 26: Alerts --Snmp_Trap_Email [--Enable] [--Disable]

    alerts --snmp_trap_email [--enable] [--disable] Description Enables or disables SNMP traps to be sent out as an email message. Syntax alerts --snmp_trap_email --enable Result Successfully enabled SNMP Trap email forwarding. NOTE: To disable SNMP trap mail forwarding, substitute the --disable command, as in the following example: alerts --snmp_trap_email --disable Successfully disabled SNMP Trap email forwarding.
  • Page 27: Authenticate Commands

    alerts --help alerts <command> <command-arguments> <command> can be one of: --show Displays system alerts and events. --test_email Sends a test email using current email settings. --snmp_add Sets SNMP traps to be sent to a host. --snmp_delete Stops sending SNMP traps to a host. --snmp_enable Enables SNMP traps for a host.
  • Page 28: Authenticate --Show [--Domain ]

    Syntax authenticate --show Result Domain: ads.storage.local If you have joined the ADS to a designated domain and you want to see the authorized users, enter the authenticate -- show --users command to display the current status: authenticate --show --users administrator2 administrator authenticate --show [--domain <domain name>] Description...
  • Page 29: Authenticate --Leave [--User ] [--Force]

    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 DR Series system 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.
  • Page 30: Authenticate --Add [--User ]

    Result Updated kerberos configuration. 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 administrator2 Result Enter password for new CIFS user administrator2: Re-enter password for new CIFS user administrator2: Added CIFS user administrator2.
  • Page 31: Authenticate --Delete--User

    authenticate --delete--user <user name> Description Deletes an existing local CIFS workgroup user from CIFS authentication (and administrative tasks). Syntax authenticate --delete --user administrator2 Result Deleted CIFS user administrator2. authenticate --delete [--login_group <DOMAIN\LOGIN GROUP>] Description Deletes an existing authenticated login group in an Active Directory Services (ADS) domain. For more information about DR Series system and ADS login group guidelines, see authenticate --add [--login_group <DOMAIN\LOGIN GROUP>].
  • Page 32: Authenticate --Guestmode [--Enable] [--Disable]

    authenticate --guestmode [--enable] [--disable] Description Configures all CIFS shares for guest-only access by enabling or disabling this capability. For specific examples of enabling or disabling guest-only access, see authenticate --guestmode --enable authenticate --guestmode -- disable. Syntax authenticate --guestmode Result Must include either enable or disable option. --guestmode - Configures all CIFS shares for guest only access.
  • Page 33: Authenticate --Server_Signing [--Auto] [--Mandatory] [--Disabled] [--Show]

    NOTE: If you attempt to enable guestmode for all CIFS shares when the DR Series system is already joined to an ADS domain (using the DR Series system CLI authenticate --guestmode --enable command), the following error This node is already joined to domain <domainname>. Please leave the domain before enabling message displays: the guest-only mode .
  • Page 34: Network

    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>] [--login_group <DOMAIN\LOGIN GROUP>] authenticate --delete [--user <user name>] [--login_group <DOMAIN\LOGIN GROUP>] authenticate --set --user <user name> authenticate --guestmode [--enable] [--disable] authenticate --server_signing [--auto]...
  • Page 35: Network Command Usage

    • Ping a destination host • Perform basic troubleshooting • Configure TCP packet filter operations based on port type, packet size, file size, and host • Test network performance between any designated client and server on the network Network Command Usage This topic introduces the network command usage: •...
  • Page 36: Network --Setstatic_Ip --Ip --Netmask --Gateway

    eth1 Speed : 1000Mb/s eth1 Duplex : Full eth2 MAC : 00:50:56:93:5A:03 eth2 Max Speed : 1000baseT/Full eth2 Speed : 1000Mb/s eth2 Duplex : Full eth3 MAC : 00:50:56:93:5A:04 eth3 Max Speed : 1000baseT/Full eth3 Speed : 1000Mb/s eth3 Duplex : Full DNS Suffix : storage.local...
  • Page 37: Network --Setdns [--Suffix ] [--Primary ] [--Secondary ]

    Syntax network --setstatic_ip --ip 10.20.20.20 --netmask 255.255.222.0 --gateway 10.25.20.10 Result Bond device operation successful. Please run ’network --restart’ for the changes to take effect. network --setdns [--suffix <dns suffix>] [--primary <ip address>] [--secondary <ip address>] Description Configures the domain name system (DNS) for a DR Series system, which includes the corresponding DNS suffix and a primary name server IP address (and optionally, a secondary name server IP address).
  • Page 38: Network --Nslookup --Destination

    To reduce the chance of interoperability issues, NICs capable of jumbo frames require special configurations to use jumbo frames. For more information, contact your Dell 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>...
  • Page 39: Network --Ping --Destination [--Tries ] [--Size ]

    network --ping --destination <ip address | hostname> [--tries <number>] [--size <number>] Description Pings any target DR Series system by sending five ICMP ECHO_REQUEST packets to the specified destination to verify that it can be reached. Syntax network --ping --destination 10.25.19.5 Result PING 10.25.19.5 (10.25.19.5) from 10.20.14.15 bond0: 56(84) bytes of data.
  • Page 40: Network --Troubleshoot [--Links] [--Gateway] [--Ntp] [--Dns] [--Active_Domain] [--Nis] [--Clients]

    network --troubleshoot [--links] [--gateway] [--ntp] [--dns] [--active_domain] [--nis] [-- clients] [--port_mapper] [--network_config] [--show_active <nfs | cifs | ost>] Isolates a variety of networking issues that you might encounter while running a DR Series system. When you can isolate a problem or issue to a specific cause, you can better understand and resolve it. The DR Series system CLI network --troubleshoot command and its options allow you to perform basic troubleshooting checks on the state of a DR Series system.
  • Page 41 Slave Interface: eth3 MII Status: up Link Failure Count: 0 Permanent HW addr: 00:50:56:93:59:7d *** Getting Gateway status Gateway IP address is 10.25.20.1 Route to the gateway is up and uses bond0 interface. Pinging gateway 10.25.20.1 Ping successful. No packet loss. RTT timings min/avg/max/mdev = 0.332/1.612/3.742/1.274 ms *** Checking NTP configuration Network time is enabled.
  • Page 42: Network --Troubleshoot --Gateway

    100000 portmapper 100000 portmapper network --troubleshoot [--gateway] Description Performs a basic troubleshooting on the current state of the gateway connected to the DR Series system. Syntax network --troubleshoot --gateway Result *** Getting Gateway status Gateway IP address is 10.250.240.1 Route to the gateway is up and uses bond0 interface. Pinging gateway 10.250.240.1 Ping successful.
  • Page 43: Network --Tcpdump [--Pkt_Size <128 - 32768>]

    network --tcpdump [--pkt_size <128 - 32768>] Description Collects TCP/IP packet information based on a specific packet size (for example, 256 Kilobytes or KB). NOTE: To stop the tcpdump process, use the DR Series system CLI network --tcpdump --stop command. Syntax network --tcpdump --pkt_size 256 Result Successfully started tcpdump, please use "network --tcpdump --stop"...
  • Page 44: Network --Tcpdump [--Port ]

    network --tcpdump [--port <nfs | windows | replication | ost>] Description Filters TCP/IP packet information based on a specific port type. In this example, by specifying an OpenStorage Technology (OST) port type using the DR Series system CLI network --tcpdump --port ost command. Syntax network --tcpdump --port ost Result...
  • Page 45: Network --Iperf_Server --Client [--Port ] [--Window_Size

    network --iperf_server --client <ip address | hostname> [--port <number>] [--window_size <num bytes [KB/MB>] The DR Series system provides the --iperf set of DR Series system CLI commands (--iperf_client and --iperf_server) that let you test network performance between any client and server on the network that you designate. In addition to testing the network performance between these two designated endpoints, this set of --iperf commands also let you test if the firewall allows a connection between these two points.
  • Page 46 [--secondary <ip address>] network --setbonding [--mode <ALB | 802.3ad>] [--mtu <Supported MTU range 512 - 9000>] network --nslookup --destination <ip address | hostname> network --traceroute --destination <ip address | hostname> network --ping --destination <ip address | hostname> [--tries <number> [--size <number> network --troubleshoot [--links] [--gateway] [--ntp]...
  • Page 47: Ost

    This topic introduces the set of OpenStorage Technology-related DR Series system CLI commands that enable you to perform the following tasks: • Display command-specific information • Update the OST user password • Delete the OST client • Update the attributes of the OST client •...
  • Page 48: Ost --Show --Clients

    Throughput 352581KiB/s Replicated At: 2012-06-20 09:08:00 File /1339632000/ddt_unique_2_thr6 Target IP 10.250.201.49 Target ID Savings 13.10% Bytes 10585760 Throughput 352581KiB/s Replicated At: 2012-06-20 09:08:05 File /1339545600/ddt_unique Target IP 10.250.201.49 Target ID Savings 10.50% Bytes 10885750 Throughput 77101KiB/s Replicated At: 2012-06-20 09:08:34 NOTE: This example intentionally only shows three of the 10 replicated files that were processed.
  • Page 49: Ost --Setpassword

    active connections will remain. There are essentially two possible modes: Dedupe and Passthrough. To verify the current mode of an OST client, you can check these two sources of client statistics: • DR Series system CLI, using the stats --container --name command •...
  • Page 50: Ost --Limit --Speed < --Target

    NOTE: If an OST client has four or more CPUs, it is considered to be dedupe-capable. However, the OST client operating mode depends upon how it is configured in the DR Series system (Dedupe is the default OST client mode). If the administrator did not configure an OST client to operate in a specific mode and it is dedupe-capable, it will run in the Dedupe mode.
  • Page 51: Stats

    Syntax ost --help Result Usage: ost --show [--config] [--file_history] [--name <name>] [--clients] [--limits] ost --setpassword 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 --help ost <command>...
  • Page 52: Stats Command Usage

    In addition, this DR Series system CLI command also allows you to reset the following statistic types: • NFS: --reset --nfs • CIFS: --reset --cifs • OST: --reset --ost • Data Check: --reset --datacheck NOTE: For information on the stats --datacheck commands that are associated with the Data Check feature, see stats --datacheck.
  • Page 53: Stats --Cpu

    Total Inodes Dedupe Savings : 65.30% Compression Savings : 40.24% Total Savings : 77.12% stats --cpu Description Displays the current cumulative CPU statistics for a DR Series system. Syntax stats --cpu Result 13:00:00 up 9 days, 19:24, 2 users, load average: 1.12, 1.20, 1.18 Cpu(s): 1.4%us, 2.3%sy,...
  • Page 54: Stats --Network

    stats --network Description Displays the current network interfaces (eth0, eth1, eth2, eth3, and bond0) statistics for a DR Series system. Syntax stats --network Result eth0 Rx Bytes : 105604787051 eth0 Rx Packets : 9999546789 eth0 Rx Errors eth0 Rx Drops eth0 Rx Fifo Errors eth0 Rx Frame Errors eth0 Tx Bytes...
  • Page 55: Stats --Datacheck

    eth3 Tx Drops eth3 Tx Fifo Errors eth3 Tx Collision eth3 Tx Carrier Error bond0 Rx Bytes : 105604787051 bond0 Rx Packets : 135791120 bond0 Rx Errors bond0 Rx Drops bond0 Rx Fifo Errors bond0 Rx Frame Errors bond0 Tx Bytes : 108732530699 bond0 Tx Packets : 1646686197...
  • Page 56: Stats --Nfs

    Other Examples This example shows the output from the stats --datacheck command used on a DR Series system when Data Check is disabled. stats --datacheck Online Data Verification : Disabled Progress : Disabled Active Writes : No Active System Operations : No Total Detected Errors Last Complete Namespace Scan...
  • Page 57: Stats --Cifs

    READDIR 2312 3997 READDIRPLUS 1278 3499 FSSTAT FSINFO 6832 PATHCONF 5564 COMMIT 13579 stats --cifs Description Displays the current CIFS statistics for a DR Series system. Syntax stats --cifs Result CIFS Per Op Statistics Procedure Calls Avg(us) Max(us) Errors ----------------------------------------------------------- CONNECT 6842 19645...
  • Page 58 OPENDIR_BY_PATH CLOSEDIR 5698 MKDIR MKDIR_BY_PATH REMOVE REMOVE_BY_PATH RENAME RENAME_BY_PATH RMDIR RMDIR_BY_PATH FCHMOD 3271 70714 FCHMOD_BY_PATH FCHOWN FCHOWN_BY_PATH FSYNC STATVFS STATVFS_BY_PATH UTIME 19078 990020 UTIME_BY_PATH MKFIFO MKNOD READLINK READLINK_BY_PATH LINK LINK_BY_PATH SYMLINK SYMLINK_BY_PATH FLOCK SETXATTR 2749 49805 SETXATTR_BY_PATH 3525 88327 GETXATTR GETXATTR_BY_PATH 7861 44108...
  • Page 59: Stats --Ost

    LISTXATTR 29288 LISTXATTR_BY_PATH 1437 7562 REMOVEXATTR REMOVEXATTR_BY_PATH FD_FROM_PATH 8609 29080 GET_REAL_FILENAME 1392 CIFS I/O Statistics Procedure Avg(Bytes) Max(Bytes) Min(Bytes) --------------------------------------------------------------- READ 1576 2345 WRITE 1734 2450 stats --ost Description Displays the current OpenStorage Technology (OST) statistics categories for a DR Series system. Syntax stats --ost Result...
  • Page 60: Stats --Container --Name

    REPL_SVR_SETUP GET_IMAGE_INFO stats --container --name <name> Description Displays the current statistics for a specific container in a DR Series system that you define by name using the DR Series system CLI --name <name> command. Syntax stats --container --name backupsys-60_replicate Result Container Name : backupsys-60_replicate Container ID...
  • Page 61: Stats --Cleaner

    bytes, 1305 KB/s, replicated at : 2012-06-19 11:47:03 File : /vargen/source/status/DEV/August11/dev-status.doc, 100.00%, 86200 bytes, 4310 KB/s, replicated at : 2012-06-19 11:47:03 File : /vargen/source/MKT/whitepaper/eng/324.tar.gz, 0.00%, 5182 bytes, 259 KB/s, replicated at : 2012-06-19 11:47:03 File : /vargen/source/acctspay/status/Sept11/3242.tar.gz, 65.23%, 94616 bytes, 1456 KB/s, replicated at : 2012-06-19 11:47:03 File : /vargen/source/revenue/Q311/interna/324.xls, 0.00%, 5152 bytes, 286 KB/s, replicated at : 2012-06-19 11:47:03...
  • Page 62: Stats --Clients [--Type ]

    stats --clients [--type <nfs | cifs | ost>] Description Displays the current NFS, CIFS, or OST clients that are configured on the DR Series system. Syntax stats --clients Result No NFS clients connected. No CIFS clients connected. Client acme01 Plugin 1.1 OS Windows Server 2008 R2 64-bit Backup Software NetBackup 7.1.2012 Idle Time 00:00:20...
  • Page 63 stats --help Description Displays the list of all stats-related options that can be used as a reference when using the DR Series system CLI. Syntax stats --help Result Usage: stats --system stats --cpu stats --memory stats --network stats --datacheck stats --nfs stats --cifs stats --ost stats --container --name <name>...
  • Page 64: Stats --Help

    Stats --Datacheck This set of DR Series system CLI commands allow you to display the current Data Check statistics gathered by the system, reset the Data Check statistics for the system, and display the statistic-based Data Check help-related options. For more information, see Stats --Datacheck Command Usage.
  • Page 65: System Command Usage

    System Command Usage This topic introduces the system command usage: • system --show [options] • system --reboot • system --shutdown • system --upgrade • system --license [options] • system --setname --name • system --setcompression [options] • system --setdate [options] • system --setntp [options] •...
  • Page 66: System --Show [--Hardware]

    Service Tag : IVQXSS2 Product Name : Dell DR4000 BIOS Version : 1.11.0 Version : 2.0.0.0.47757 Build : 47757 Telnet State : Disabled Compression Level : fast Time Zone : US/Pacific Data Check : Enabled - namespace,blockmap,throttle:50% Marker Detection : Enabled IP Addr : 10.25.242.12...
  • Page 67 "EMM 0" "\\1\\0\\0\\0" HDB EM01 optimal "EMM 1" "\\1\\0\\0\\1" Component Signature Health Name Vendor PartNumber Power Supply HDB EP00 optimal "Power Supply 1" "DELL" "0NFCG1A02" Power Supply HDB EP01 optimal "Power Supply 2" "DELL" "0NFCG1A02" Component Signature Health Temp_Reading Name...
  • Page 68 system --show [--storage] Description Displays the service tag, size, configuration state, RAID level, the percentage used, and the state of the storage type (or types) installed on a DR Series system. Syntax system --show --storage Result Type Service Tag RawSize Configured RAIDLevel Used...
  • Page 69: System --Show [--Storage]

    Syntax system --show --ntp Result NTPD Service is : UP Server 1 : 0.centos.pool.ntp.org Server 2 : 1.centos.pool.ntp.org Server 3 : 2.centos.pool.ntp.org system --show [--version] Description Displays the currently installed version of the DR Series system software, and the date and time in which it was installed.
  • Page 70: System --Show [--Upgradefile]

    NOTE: To display the time zones that can be selected in a specific region, use the following command: system --show --timezones Chile Following are the time zones in Chile region: Continental Easter Island system --show [--upgradefile] Description Displays the current version of the DR Series system software upgrade file that resides on the system appliance. Syntax system --show --upgradefile Result...
  • Page 71: System --Reboot

    Upgrades the version of the DR Series system software installed on a supported DR Series hardware appliance. Syntax system --upgrade NOTE: To obtain the latest DR Series system upgrade image, navigate to the Dell Support website (dell.com/ support/drivers/us/en/19/Product/dell-DRSeries), and download the latest DR Series system software upgrade image file to the local system using WinSCP.
  • Page 72: System --License [--Validate] [--Add]

    • APOS licenses are those ordered later separately from Dell for new expansion shelves or for existing Dell MD1200 storage arrays intended for use as expansion shelf enclosures. NOTE: The 300 Gigabyte (GB) drive capacity (2.7 TB) version of the DR Series system does not support the addition of expansion shelf enclosures.
  • Page 73: System --Setname --Name

    Use the system --license [--validate] [--add] command to validate and install the license for the expansion shelf enclosure. • Power off (if needed) the Dell MD1200 storage array, physically connect the expansion shelf enclosure to the base DR Series system, and power on the expansion shelf enclosure. •...
  • Page 74: System --Setntp [--Add ]

    Syntax NOTE: Respond to the prompt to stop the NTP service by issuing a system --setntp --disable command. system --setdate --date 092913202012 --timezone US/Pacific Please stop NTP service before changing time. system --setntp --disable Result Shutting down ntpd: [ Fri Jun 29 13:20:00 PDT 2012 NTP service is already disabled.
  • Page 75: System --Setntp [--Enable]

    system --setntp [--enable] Description Enables the NTP service for your DR Series system. Syntax system --setntp --enable Result ntpd: Synchronizing with time server: Starting ntpd: To verify whether the NTP service was enabled, use the following command: system --setntp --enable NTP service is already enabled.
  • Page 76: System --Telnet [--Enable] [--Disable]

    Syntax system --setlogin Result Please enter administrator password: Please enter administrator's new password: Please re-enter administrator's new password: Changed administrator’s password. system --telnet [--enable] [--disable] Description Displays the current telnet access status, or you can use the command options to enable or disable telnet access for a DR Series system.
  • Page 77: System --Datacheck [--Disable ]

    system --datacheck [--disable <all | namespace | blockmap>] Disables one or both Data Check scan option types that can be used on a DR Series system. You can individually disable namespace or blockmap scan options, or both options using the all scan option (which means that both the namespace and blockmap scan types will be disabled).
  • Page 78: System --Marker [--Enable]

    Disables the marker detection status for all supported backup software on a DR Series system. For example, the DR Series system supports specific versions of data management application (DMA) software like NetBackup version 6.5 Dell DR and 7.1, Backup Exec 2010 and 2012, and Veeam 5.7 and 6.0. For a complete list of the supported DMAs, see the Series System Interoperability Guide .
  • Page 79: System --Storage [--Blink] [--Type ] [--Service_Tag ] [--Disk ]

    --license [--validate] [--add]. • Power off (if needed) the Dell MD1200 storage array, physically connect the expansion shelf enclosure to the base DR Series system, and power on the expansion shelf enclosure. • Use the system --add_storage --enclosure <service tag> command .
  • Page 80: System --Storage [--Unblink] [--Type ] [--Service_Tag ]

    system --storage [--unblink] [--type <internal | external>] [--service_tag <service tag>] [-- disk <slot num> Description Turns off an LED that is used in locating a specific physical disk or data storage expansion shelf (using the system -- storage command) in the DR Series system. Select from the following DR Series system CLI command options: •...
  • Page 81: User

    [--delete <server name> [--enable] [--disable] [--adjust_time] system --setlogin system --telnet [--enable] [--disable] system --datacheck [--enable <all|namespace|blockmap>] [--disable <all|namespace|blockmap>] [--throttle <1-100>] system --marker [--enable] [--disable] system --add_storage --enclosure <service tag> system --storage [--blink] [--type <internal|external] [--service_tag <service tag] [--disk <slot num>] [--unblink] [--type <internal|external>] [--service_tag <service tag>] [--disk <slot num>] system --help...
  • Page 82: User Command Usage

    User Command Usage This topic introduces the user command usage: • user --show [options] • user --enable --user [options] • user --disable --user [options] • user --help NOTE: If you specify a command without supplying the expected value or option, you will be prompted to provide the correct value or option.
  • Page 83: User --Disable --User

    NOTE: To enable the service user account instead of the root user account, simply substitute the service option with the --user option, as shown in the following example: user --enable --user service NOTE: After using Restore Manager, only the administrator account remains enabled (all other system accounts are disabled).
  • Page 85: Maintaining The Dr Series System

    Assists Dell Support understand the sequence of DR Series system operations. • Records DR Series system operations in the event that Dell Support needs to provide technical assistance. The Diagnostics command works by collecting all system-related information that assists in understanding system operations when diagnosing a problem or error condition in the DR Series system.
  • Page 86 • diagnostics --copy [options] • diagnostics --help NOTE: If you specify a command without supplying the expected value or option, you will be prompted to provide the correct value or option. diagnostics --show Description Displays a list of the diagnostics log files, by filename, size, status, and reason for generation. The diagnostics log files are a collection of all DR Series system-related information that describe the current state of your system.
  • Page 87: Diagnostics --Collect [--Name ]

    acme9_2012-07-18_09-48-26.lzip acme9_2012-07-18_10-34-48.lzip acme9_2012-07-25_14-09-15.lzip acme9_2012-07-30_14-35-30.lzip acme9_2012-07-30_15-25-59.lzip diagnostics --collect [--name <name>] Description Defines a specific name for the diagnostics file you want to generate using the --name option with the DR Series system CLI diagnostics --collect command. Syntax diagnostics -collect --name diag_acme99_10-02-12 Result Collecting diagnostics...done.
  • Page 88: Diagnostics --Collect --Dset

    --collect [--dset] Description Collects the current system hardware diagnostics information that may be needed by Dell Support personnel using the -- dset (Dell E-Support Tool) option with the DR Series system CLI diagnostics --collect command. Syntax diagnostics --collect --dset Result Collecting diagnostics...
  • Page 89: Diagnostics --Delete [--All]

    diagnostics --delete [--all] Description Deletes all of the diagnostics files on a DR Series system when using the --all option with the DR Series system CLI diagnostics --delete command. CAUTION: Carefully consider before using the DR Series system CLI --delete --all command to delete all current diagnostics log files on a DR Series system.
  • Page 90: Maintenance

    CIFS, NFS, or OST is lost. The set of maintenance commands and options should only be used when the DR Series system is in the Maintenance mode state. Dell recommends that you contact Dell Support before performing any of these DR Series system CLI commands.
  • Page 91: Maintenance --Filesystem --Scan_Status

    NOTE: If you specify a command without supplying the expected value or option, you will be prompted to provide the correct value or option. maintenance --filesystem [--scan_status] Description Displays the current filesystem checker status and scan progress for a DR Series system. Syntax maintenance --filesystem --scan_status Result...
  • Page 92: Maintenance --Filesystem [--Repair_Status [Verbose]]

    maintenance --filesystem [--repair_status [verbose]] Description Displays the current filesystem repair progress for a DR Series system. NOTE: If there is no repair status to report, the DR Series system returns the status message shown under Result. Syntax maintenance --filesystem --repair_status Result Filesystem checker is not running.
  • Page 93: Maintenance --Filesystem [--Repair_Now]

    Result Successfully restarted filesystem scan. maintenance --filesystem [--repair_now] Description Repairs any filesystem issues in a DR Series system based on the repair report findings. Syntax maintenance --filesystem --repair_now Result Successfully started cleaner. maintenance --filesystem [--reclaim_space] Description Reclaims disk space that was formerly occupied by data in the recycle bin in a DR Series system using the Cleaner process.
  • Page 94: Maintenance --Filesystem [--Start_Scan [Verify_Data]]

    Syntax maintenance --filesystem --clear_quarantine Result Successfully performed quarantine cleanup. maintenance --filesystem [--start_scan [verify_data]] Description Starts the filesystem scan process that acts to verify the data contained in a DR Series system. NOTE: Be aware that using this command places the filesystem into a read-only mode and pauses all active replications.
  • Page 95: Maintenance --Configuration [--Backup]

    DR Series system will be unable to detect any duplicates based on the existing archived data. NOTE: Use caution when considering whether you should reinitialize the dictionary. This type operation is only performed rarely, and when performed, only under special circumstances. Contact and consult with Dell Support before you use this command. Syntax You will need to type yes to continue or no to return to the system prompt when you are prompted whether you want to continue with this process.
  • Page 96: Maintenance --Hardware --Reinit_Nvram

    Dell Support because it permanently erases all data stored on the NVRAM in the Dell DR Series system hardware appliance. This command is only to be used when replacing the NVRAM in your hardware appliance. Contact Dell Support and seek assistance before you use this command.
  • Page 97: Maintenance --Disk [--Make_Standby [Slot Num]] [--Type | Service Tag Clear_Foreign]

    Result Shutting down interface bond0 Shutting down loopback interface: Bringing up loopback interface: Bringing up interface bond0: Determining IP information for bond0... done. [ Network settings configured successfully. result: 0 maintenance --disk [--make_standby [slot num]] [--type <internal | external-<num> | service tag>] --clear_foreign] Description Creates a standby disk for a DR Series system.
  • Page 98: Clear_Foreign]

    [--clear_quarantine] [--start_scan [verify_data]] [--stop_scan] maintenance --configuration [--backup] [--restore] [--reinit_dictionary] maintenance --hardware [--reinit_nvram] [--restore_hw_db] [--network_reconfigure] maintenance --disk [--make_standby [slot num]] [--type <internal|external-<num>|service tag>] [--clear_foreign] maintenance --help maintenance <command> <command-argument> <command> can be can be one of: --filesystem Maintenance operations on filesystem. --configuration Backup/Restore system configuration.
  • Page 99: Managing Dr Series System Storage Operations

    Managing DR Series System Storage Operations This topic introduces the DR Series system CLI commands that you can use for configuring and managing DR Series system backup operations, replication operations, and scheduling when to run Replication and disk Cleaner operations. The DR Series system CLI commands that provide these capabilities are grouped into the following categories: •...
  • Page 100: Connection --Show [--Name ]

    connection --show [--name <name>] Description Displays the status of a specific existing container connection that you define by name (backup) on a DR Series system. Syntax connection --show --name backup Result Container Name : backup NFS connection IP addresses NFS connection Root map : root NFS connection options : rw...
  • Page 101: Connection --Show [--Verbose]

    CIFS connection IP addresses CIFS connection Enabled : Yes CIFS connection status : Available Display the detailed status of a specific container connection (backup) by defining it by name using the --name backup command and defining the specific filesystem protocol type (--type nfs) on a DR Series system: connection --show --name backup --type nfs Container Name : backup...
  • Page 102: Connection --Add --Name --Type [--Clients ] [--Rootmap ] [--Options ]

    Result Container Entry ID Container Name : backup NFS connection Entry ID : 25 NFS connection IP addresses NFS connection Root map : root NFS connection options : rw NFS connection Enabled : Yes NFS connection status : Available CIFS connection Entry ID : 26 CIFS connection IP addresses CIFS connection Enabled...
  • Page 103: Connection --Delete --Name --Type [--Clients ]

    For example: • --clients command option only applies to NFS and CIFS type container connections. • --rootmap and --options command options apply only to NFS type container connections. • --capacity command option only applies to OpenStorage Technology (OST) type container connections, and lets you specify a positive integer value to represent the capacity size in Gigabytes (GB).
  • Page 104: Connection --Help

    Result Successfully updated connection entry. OST connection Quota : Unlimited OST connection Used Capacity : 5.0 GB OST connection Enabled : No connection --help Description Displays the listing of user and related options that you can use as a reference when using the DR Series system CLI. Syntax connection --help Result...
  • Page 105: Container

    For example: connection --help show Container This topic introduces the set of DR Series system CLI commands that allow you to perform the following tasks: • Display the status of all current containers (summary or detail) • Create (and name) new containers (the DR Series system limits support to 32 containers) •...
  • Page 106: Container --Add --Name

    Result Container Name : acme-41-cifs-1 Container Path : /containers/acme-41-cifs-1 Container Marker : commvault Other Examples Displays the detailed status of an existing container that you specify by name using the container --show --name -- verbose command: Container Name : acme55-S2 Container Path : /containers/acme55-S2 Container Marker...
  • Page 107: Container --Delete --Name [--Delete_Files]

    NOTE: Before you can delete a specific NFS or CIFS container, the connection to the container must be disabled before you can delete its files and directories. For details, see connection --disable --name <name> --type <nfs| cifs|ost>. Other Examples Deletes any existing NFS or CIFS container type and the data files within the specified container by combining the -- delete and the --delete_files DR Series system CLI commands: container --delete --name acme_17 --delete_files WARNING: All the data in the container acme_17 will be deleted!
  • Page 108: Container --Delete_Files --Name

    Other Examples Disables a CommVault marker on an existing container in the DR4000 system: container --marker --disable commvault --name acme99 Marker updated successfully. NOTE: To enable or disable the automatic marker setting type on an existing container in the DR4000 system, substitute Auto in place of CommVault, Networker, TSM (Tivoli Storage Manager), or ARCserve in the CLI command.
  • Page 109: Replication

    NOTE: To allow DR Series system replication operations, you must ensure that TCP ports 9904, 9911, 9915, and 9916 Dell DR Series System are enabled. For more information about supported ports for the DR Series system, see the Administrator Guide .
  • Page 110: Replication --Show [--Name ] [--Role ] [--Verbose] [--Limits]

    replication --show [--name <name>] [--role <source | target>] [--verbose] [--limits] Description Displays a detailed summary of replication-related information for a specific replication container in the DR Series system. Syntax replication --show --name acme-59 --role source --verbose Result Replication Container ID : 16 Replication Container : acme55-S2...
  • Page 111: Replication --Show

    Result Replication limits are enabled. Host Name Target IP Speed Limit acme-85 10.21.22.20 192 KBps NOTE: You can limit the bandwidth consumed by the replication process by setting a value in kilobytes/second (kbps), megabytes/second (mbps), gigabytes/second (gbps), or use an unlimited bandwidth (default). The minimum allowed bandwidth setting for a DR Series system is 192 kbps.
  • Page 112: Replication --Delete --Name --Role [--Force]

    Result NOTE: If you attempt to update a container that already has replication enabled, this displays the following message: Replication on backup is enabled and cannot be updated, please stop it first. When replication is enabled on the container, you must first disable it before you can update it. To disable replication on a container, enter the DR Series system CLI replication --stop command and define the container name and role: replication --stop --name <name>...
  • Page 113: Replication --Start --Name --Role

    replication --start --name <name> --role <source | target> Description Starts the replication process on an existing replication link to a container in a DR Series system. Syntax replication --start --name container2_replica --role target Result Replication configuration updated successfully. Replication Container : container2_replica Replication Role : Source...
  • Page 114: Replication --Resync --Name --Role

    Syntax replication --limit --speed 10gbps --target acme-60 Result Successfully updated replication limit for acme-60 to 10 Gbps. Changing traffic control policies ... done. replication --resync --name <name> --role <source | target> Description Resynchronizes the replication process between a source and target container in a replication relationship on a DR Series system.
  • Page 115 Syntax replication --help Result Usage: replication --show [--name <name>] [--role <source | target>] [--verbose] [--limits] replication --add --name <name>] --role <source | target> --peer <ip address | hostname> [--peer_name <name>] [--username <user name>] [--encryption <none | aes128 | aes256>] replication --update --name <name> --role <source | target>...
  • Page 116: Schedule

    Schedule A schedule is the means by which you set aside specific daily or weekly time periods for performing disk space reclamation or replication operations. Disk reclamation operations recover unused disk space from DR4000 system containers in which files were deleted, and replication operations are the process by which the key data is saved only once from multiple devices to minimize excessive or redundant storage of the same data.
  • Page 117: Schedule --Show [--Name ]

    Result Replication Schedule: Start Stop Sunday 22:00 05:00 Monday 22:00 05:00 Tuesday 22:00 05:00 Wednesday 22:00 05:00 Thursday 22:00 05:00 Friday 22:00 05:00 Saturday 22:00 05:00 schedule --show [--name <name>] Description Displays any existing Replication or Cleaner schedule for a selected container that you define by name on the DR Series system (using the --name <name>...
  • Page 118: Schedule --Delete --Day [--Cleaner] [--Name ] [--Replication]

    NOTE: Do not select 00:00 for a start time or stop time endpoint for midnight when setting Cleaner or Replication schedules (instead, use either the 23:55 or 00:05 value). Result schedule --add --day Monday --start_time 02:00 --stop_time 22:00 --cleaner schedule --add --day Tuesday --start_time 02:00 --stop_time 22:00 --cleaner schedule --add --day Wednesday --start_time 02:00 --stop_time 22:00 --cleaner schedule --add --day Thursday --start_time 02:00 --stop_time 22:00 --cleaner schedule --add --day Friday --start_time 02:00 --stop_time 22:00 --cleaner...
  • Page 119 [--replication] schedule --help schedule <command> <command-arguments> <command> can be one of: --show Displays command specific information. --add Adds a schedule for replication/cleaner. --delete Deletes a replication/cleaner schedule. For command-specific help, please type schedule --help <command> For example: schedule --help show...
  • Page 121: Data Integrity Checking

    Data Integrity Checking The DR Series system design includes an online data integrity verification feature known as Data Check, which checks for potential or unexpected data inconsistencies in the data store associated with the internal system deduplication engine. Data Check performs a series of checks for unexpected data inconsistencies as early as possible in the data ingest and backup process.
  • Page 122: Continuous Data Verification Scans

    five minutes when the other DR Series system operations are idle. For more information, see About Data Check Continuous Data Verification Scans. Continuous Data Verification Scans Data Check performs a data verification scan, also known as a blockmap scan, which cycles every two hours through all of the objects in the data store.
  • Page 123: Data Check Cli Commands

    Data Check: Namespace Scan Option The namespace scan option focuses on file attributes such as file size, file name, permissions, and last time modified. Data integrity verification is done using a checksum process. You can choose to enable or disable the Data Check namespace scan in the DR Series system based on the command setting you select.
  • Page 124: System --Datacheck Command Usage

    System --Datacheck Command Usage This topic introduces the system --datacheck command usage: • system --datacheck • system --datacheck--enable [options] • system --datacheck --disable [options] • system --datacheck --throttle [options] • system --help datacheck NOTE: If you specify a command without supplying the expected value or option, you will be prompted to provide the correct value or option.
  • Page 125: System --Datacheck [--Enable ]

    NOTE: This example shows all Data Check scan options being disabled. To disable only the namespace or the blockmap scan, simply replace the all option with either of the other option types you desire in the DR Series system CLI command. system --datacheck [--enable <all | namespace | blockmap>] Enables one or both Data Check scan options that can be used on a DR Series system.
  • Page 126: Stats --Datacheck

    Result Usage: system --datacheck [--enable <all|namespace|blockmap>] [--disable <all|namespace|blockmap>] [--throttle <1-100>] --enable Enables online data verification scans. --disable Disables online data verification scans. --throttle Sets the online data verification throttle percentage. Stats --Datacheck This set of DR Series system CLI commands allow you to display the current Data Check statistics gathered by the system, reset the Data Check statistics for the system, and display the statistic-based Data Check help-related options.
  • Page 127: Stats --Datacheck

    Last Complete Namespace Scan : 2012-02-02 17:48:18 Last Complete Blockmap Scan : 2012-02-02 16:33:08 Namespace Scans Completed : 183 Namespace Scan Entries Namespace Scan Errors Namespace Scan Start Time : 2012-02-02 17:43:08 Namespace Scan Progress : 100.00% Blockmap Scans Completed Blockmap Scan Entries Blockmap Scan Errors Blockmap Scan Start Time...
  • Page 129: Additional Linux Commands

    While these three Linux commands are available to the user, this topic and other topics related to these commands are not intended to be a reference source about or how to use these commands. Dell recommends that you consult a Linux command reference guide for more information about these commands and how they can be used.
  • Page 130: Grep

    To report bugs, see node `Bugs' in `gawk.info', which is section `Reporting Problems and Bugs' in the printed version. gawk is a pattern scanning and processing language. By default it reads standard input and writes standard output. Examples: gawk '{ sum += $1 }; END { print sum }' file gawk -F: '{ print $1 }' /etc/passwd grep Description...
  • Page 131: More

    -a, --text equivalent to --binary-files=text equivalent to --binary-files=without-match -d, --directories=ACTION how to handle directories ACTION is 'read', 'recurse', or 'skip' -D, --devices=ACTION how to handle devices, FIFOs and sockets ACTION is 'read' or 'skip' -R, -r, --recursive equivalent to --directories=recurse --include=PATTERN files that match PATTERN will be examined --exclude=PATTERN...

Table of Contents