Dell DR4000 System Command Line Reference Guide...
Page 2
Other trademarks and trade names may be used in this publication to refer to either the entities claiming the marks and names or their products. Dell Inc. disclaims any proprietary interest in trademarks and trade names other than its own.
Command Line Reference Guide About this Guide This guide explains how to use the command line interface (CLI) for the Dell DR4000 system to manage data backups, perform a variety of data storage operations, and use containers to meet backup and replication storage needs.
Page 12
NOTE: Always check for release notes on support.dell.com/manuals and read the release notes first, because they contain the most recently documented information about known issues with a specific product release.
NOTE: Unless otherwise noted, later references to "the system" or "DR4000 system" in this guide are used interchangeably to represent the Dell DR4000 system. The system has a simple installation process with full, intuitive remote setup and management capabilities and is available in three usable capacity —...
System • User This guide assumes that the DR4000 system has been deployed in its network location, and it is ready to be accessed using the DR4000 CLI commands. Accessing the DR4000 CLI Commands To access the DR4000 system CLI commands from the system command line...
Page 15
4 At the administrator password prompt, enter the password for the Administrator (the default is St0r@ge!): – Type St0r@ge! – Press <Enter> The DR4000 system's administrator prompt is displayed. 5 At the administrator prompt, type help. The DR4000 system CLI commands are displayed. administrator@mydr4000 > help DR4000 Help alerts View system events and configure email notifications.
Page 16
System tools available: awk grep more NOTE: The DR4000 system administrator account only provides access to the DR4000 system CLI command listed above. Access to any other Linux commands are not available, except for awk, grep, and more. Introducing the DR4000 System...
Managing the DR4000 System This chapter describes the CLI commands for configuring, managing, and viewing the current status of a DR4000 system. For example, the CLI alerts and system commands both contain options that provide administrators with the capability to configure, manage, and display the DR4000 system status.
Phone: 408-999-1212 Comments: Day Shift Administrator --show [--snmp] To display the current Simple Network Mail Protocol (SNMP) information for a DR4000 system, enter the following command string at the system prompt: administrator@mydr4000 > alerts --show --snmp SNMP Host Port Community ======================================= 10.25.25.10...
2011-12-19 18:19:09 Network Interface Controller PCI Slot 1 Port 0 disconnected. Reconnect it to a network and/or check your network switches or routers for network connectivity issues. Managing the DR4000 System...
2011-08-31 16:46:36 Network Interface Controller PCI slot 3, NIC index 2 disconnected. Reconnect it to a network and/or check network switches or routers for connectivity issues. PCI slot zero represents embedded NIC, external otherwise. Managing the DR4000 System...
To use 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 the values within quotation marks (for example, using the command string, --admin_name "John Smith"). Managing the DR4000 System...
To configure the email account for the administrator associated with the system, enter the following command string at the system prompt: administrator@mydr4000 > alerts --email --admin_email john_smith@acme.com Alert email settings updated. Recipients: Relay Host: relayhost13 Admin Name: John_Smith Company Name: Acme.com Admin Email: john_smith@acme.com Phone: Comment: Managing the DR4000 System...
NOTE: Verify that the configured email recipients receive the test email notification sent to them. This is an important check that proves they can receive DR4000 system alert notifications. administrator@mydr4000 > alerts --test_email Test mail sent.
To display the listing of alerts and related options that can be used as a reference when using the CLI, enter the following command string at the system prompt: administrator@mydr4000 > alerts --help Usage: alerts --show [--email] [--snmp] [--events] [--alerts] [--index <[-]number>] Managing the DR4000 System...
Page 28
Sends a test email using current e-mail settings. --snmp_add Sets SNMP traps for a host. --snmp_delete Stops sending SNMP traps to a host. --snmp_enable Enables SNMP traps for a host. --snmp_disable Disables SNMP traps for a host. Managing the DR4000 System...
For command-specific help, please type alerts help <command> For example: alerts --help show Authenticate This set of CLI commands let you configure the DR4000 system to authenticate with the Microsoft Windows Active Directory Services (ADS). Command Usage • authenticate --show [options] •...
ADS that may require its own administrative access rights (such as an executive management or finance group). --leave --user <user name> [--force] To leave an ADS domain, enter the following command string at the system prompt: administrator@mydr4000 > authenticate --leave --user administrator Managing the DR4000 System...
Restarting Windows Access Server... done. Enabling NTP service... done. NOTE: The --force command is optional and allows the DR4000 system to leave the ADS domain when communication between the system and the ADS domain is lost and --leave operation is pending or in progress.
The DR4000 system administrator that manages the DR4000 system has a different set of privileges than does the CIFS user administrator. For example, only the DR4000 system administrator can change the password for the CIFS user administrator. --guestmode [--enable, --disable]...
Page 33
Deletes a local workgroup user from CIFS authentication. --set Sets the password for a local workgroup user. --guestmode Configures all CIFS shares for guest-only access. For command-specific help, please type authenticate help <command> For example: authenticate --help show Managing the DR4000 System...
Display information about a DR4000 system • Manage an existing networking configuration • Restart networking • Configure the DR4000 to use DHCP or static IP addressing • Configure domain name servers (DNS) • Update the bonding mode or maximum transmission unit (MTU) •...
--show To display the current networking configuration for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > network --show Device : bond0 Boot protocol : dhcp IP Addr : 10.20.24.55 Netmask : 255.255.252.0 Gateway : 10.20.32.13...
Bringing up interface bond0: Determining IP information for bond0... done. [ --setdhcp To configure the DR4000 system to change to use the DHCP IP addressing, enter the example command string at the system prompt: administrator@mydr4000 > network --setdhcp Bond device operation successful. Please run 'network -- restart' for the changes to take affect.
--setbonding [--mode <ALB | 802.3ad>, --mtu <number>] To configure or update the bonding mode or to set the MTU number to use for a DR4000 system, enter the example commands string at the system prompt: administrator@mydr4000 > network --setbonding --mode ALB --mtu 1750 Bond device operation successful.
CAUTION: If the existing bonding setting is changed, the connection to the DR4000 system may be lost unless you are sure that the DR4000 system can accept this bonding type. If no options are specified, the following prompts are shown: administrator@mydr4000 >...
--destination requires a value : --destination <ip address | hostname> --ping, --destination <ip address | hostname> [--tries <number>] To ping a DR4000 system (which sends ICMP ECHO_REQUEST packets to verify it can be reached), enter the example commands string at the system prompt: administrator@mydr4000 >...
Page 40
= 0.032/0.043/0.049/0.005 ms If you specified the --tries option, but did not provide values, you are prompted as shown: administrator@mydr4000 > network --ping --destination 10.250.194.5 --tries --tries requires a value : --tries <number> number of attempts Managing the DR4000 System...
DR4000 system. By isolating the issue, you can better understand and resolve issues. To perform basic troubleshooting checks on the state of a DR4000 system, enter the example commands string at the system prompt: NOTE: When entering the network --troubleshoot command string, it checks and displays the current state for all of the --troubleshoot options.
Page 42
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.744/0.774/0.824/0.035 ms *** Checking NTP configuration Network time is enabled. Managing the DR4000 System...
Page 43
*** Checking DNS configuration DNS Suffix: acme.local Primary Nameserver: 10.25.19.5 Secondary Nameserver: 10.25.19.6 Pinging 10.25.19.5 Ping successful. No packet loss. RTT timings min/avg/max/mdev = 0.236/0.286/0.381/0.053 ms Pinging 10.25.19.6 Ping successful. No packet loss. RTT timings min/avg/max/mdev = 0.191/0.276/0.350/0.061 ms Managing the DR4000 System...
Page 44
Got IP address as 10.25.20.13 Got IP address as 10.25.20.13 No duplicate hostname found on the network. *** Checking portmapper portmap (pid 3589) is running Checking ports currently being used by portmapper program vers proto port 100000 portmapper 100000 portmapper Managing the DR4000 System...
For example: network --help show Stats This set of CLI commands let you display the current statistics for a DR4000 system in categories such as cumulative statistics for all containers, CPU, memory, network interfaces, NFS, CIFS, replication, and cleaner statistics.
--reset [options] • stats --help --system To display the current cumulative system statistics for all containers configured for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --system Capacity Used : 3.0 GB Capacity Free : 7989.0 GB...
Compression Savings : 40.24 % Total Savings : 77.12 % --cpu To display the current cumulative CPU statistics for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --cpu 13:00:00 up 19:24, 2 users, load average: 1.12, 1.20, 1.18...
Hugepagesize : 2048 kB --network To display the current network interfaces (eth0, eth1, eth2, eth3, and bond0) statistics for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --network eth0 Rx Bytes : 105604787051...
Tx Fifo Errors bond0 Tx Collision bond0 Tx Carrier Error --nfs To display the current NFS statistics for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --nfs Unfs Per Op Statistics Procedure...
FSSTAT FSINFO 6832 PATHCONF 5564 COMMIT 13579 --cifs To display the current CIFS statistics for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --cifs CIFS Per Op Statistics Procedure Calls Avg(us) Max(us) Errors...
REMOVEXATTR_BY_PATH 0 FD_FROM_PATH 8609 29080 --container --name <name> [--file] To display the current statistics for a container in a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --container --name backupswsys-60_replicate Container Name : backupswsys-60_replicate...
--replication --name <name> To display the current replication statistics for a container that is part of a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --replication stats -- replication --name backupswsys-60_replicate...
> stats --replication --name missing: name of container --cleaner The cleaner is an asynchronous process in the DR4000 system that reclaims disk storage space by reclaiming space that previously contained unreferenced datastore files. The cleaner process operates in two distinct phases: •...
Current Run Phase 4 End Time : 11/17/11 15:30:52 --reset [--nfs, --cifs] To reset current NFS or CIFS statistics for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > stats --reset -nfs Successfully reset NFS stats.
This CLI command and its options allow you to perform the following types of system-related tasks: • Displaying the current system configuration • Initializing, rebooting, or shutting down the DR4000 system • Upgrading the DR4000 system software • Configuring the compression type to use on the stored data •...
--marker [options] • system --help --show [--config, --hardware, --ntp, --version, --timezones, -- upgradefile, --upgradehistory] To display the current system configuration for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > system --show System Name : mydr4000...
Page 62
--dns, --timezones, --upgradefile, and --upgradehistory) in the same way that the --ntp option is used in the following example. administrator@mydr4000 > system --show --ntp NTPNTPD Service is : UP Server 1 : 0.centos.pool.ntp.org Server 2 : 1.centos.pool.ntp.org Server 3 : 2.centos.pool.ntp.org Managing the DR4000 System...
CAUTION: The --shutdown command powers Off the appliance on which the DR4000 system software is installed. Once the appliance is in a powered Off state, you may only be able to power On the appliance at its physical location unless iDRAC is configured on the network.
> system --setname --name missing: Name for the machine. --setcompression [--fast, --best] To set the compression type to use on the data stored by a DR4000 system, enter the example command string at the system prompt (--fast is the default setting): administrator@mydr4000 >...
--adjust_time] To add a new NTP server, delete an existing NTP server, enable or disable the existing NTP service, or synchronize the time on a DR4000 system with a designated NTP server, see the following command strings examples. To add a new NTP server, enter the example command string at the system prompt: administrator@mydr4000 >...
Page 66
> system --setntp --enable ntpd: Synchronizing with time server: [ Starting ntpd: To synchronize a DR4000 system with the NTP server, enter the following command string at the system prompt: administrator@mydr4000 > system --setntp --adjust_time Time difference less than 2 seconds. Not adjusting with server 0.centos.pool.ntp.org...
In this example, the system --telnet command returned the telnet access status as disabled. The following example shows the command string for enabling telnet access on your DR4000. To disable telnet access, enter the system --telnet -- disable command string.
To enable CommVault markers on a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > system --marker --enable commvault Successfully enabled system marker for commvault. system --help To display the list of all system-related options for reference when using the CLI, enter the following command string at the system prompt: administrator@mydr4000 >...
--setlogin Updates the login password. --telnet Enables or disables telnet access. --marker Enables or disables marker for CommVault or other backup software. For command-specific help, please type system help <command> For example: system --help show Managing the DR4000 System...
--enable [options] • user --disable [options] • user --help --show To display the current set of active users on a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > user --show User Name Terminal Login Time...
--disable, --user <service | root> To disable the service or root user account on a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > user --disable --user root "root" user disabled user --help To display the list of all user-related options for reference when using the CLI, enter the following command string at the system prompt: administrator@mydr4000 >...
DR4000 system. Diagnostics runs as a service during system startup, and this service in the DR4000 listens for incoming requests. There are two modes in which the diagnostics collection process is started: •...
Diagnostics process computes the sizes of each of these two log location directories. Whenever a log directory exceeds its maximum storage capacity, the oldest logs are deleted to free up space for the current logs that the DR4000 system generates. Command Usage •...
--collect [--name <name>, --reason <reason>, --force, --dset, --all] To generate a new diagnostics log file that represents the current state of a DR4000 system, enter the following command string at the system prompt: administrator@mydr4000 > diagnostics --collect Collecting diagnostics...done. Diagnostics file mydr4000_2011-11-17_17-15-52.lzip created.
As part of the troubleshooting process, you may be asked to provide a DSET log when you contact Dell Support. To collect all of the current system information (including -- dset) that may...
CAUTION: Carefully consider before attempting to use the --delete --all command to delete all of the current diagnostics log files on a DR4000 system. By deleting all diagnostics log files without first saving them to another location, the previous system status information they contained will be lost.
--disk commands manage the system disk drives. NOTE: This set of Maintenance commands provide some functionality that is not available in the DR4000 system GUI. To check the status of the DR4000 system, use the system --show CLI command to display the current status. Command Usage...
--disk [options] • maintenance --help --filesystem [--scan_status] To display the current filesystem checker status and scan progress for a DR4000 system, enter the following command string at the system prompt: administrator@mydr4000 > maintenance --filesystem --scan_status Filesystem checker : Preparing for filesystem check administrator@mydr4000 >...
To display the current filesystem repair progress for a DR4000 system, enter the following command string at the system prompt: NOTE: If there is no repair status to report, the DR4000 returns the following status message. administrator@mydr4000 > maintenance --filesystem --repair_status Filesystem checker is not running.
--filesystem [--repair_history] To display the filesystem checker history for a DR4000 system, enter the following command string at the system prompt: administrator@mydr4000 > maintenance --filesystem --repair_history 0 : Filesystem check time : Tue Sep 27 14:37:43 2011 Dry run finished at : Tue Sep 27 14:38:03 2011...
> maintenance --filesystem --reclaim_space Successfully started cleaner. --filesystem [--stop_reclaim_space] If a need exists to stop the disk space reclaim process in a DR4000 system, enter the following command string at the system prompt: administrator@mydr4000 > maintenance --filesystem --stop_reclaim_space Successfully stopped cleaner.
To see the status, please execute "maintenance --filesystem --scan_status". If you enter a maintenance --filesystem command (see the following example) when the DR4000 is not in Maintenance mode, the following return is displayed at the system prompt: administrator@mydr4000 > maintenance --filesystem --scan_restart "Operation not supported as system is not in maintenance...
When you reinitialize the dictionary, all entries that indicate there were previously archived data locations are removed. As a result, during new data ingests the DR4000 will not be able to detect any duplicates based on the existing archived data.
This command should only be used under the direction of Dell Support because it permanently erases all data stored on the NVRAM in the Dell DR4000 hardware appliance. This command is only to be used when replacing the NVRAM in your appliance.
One possible state is "foreign", which indicates that the --clear_foreign command needs to be run. In addition, an alert is generated if the DR4000 system detected that any of the disks were in a foreign state. administrator@mydr4000 > maintenance --disk --clear_foreign...
<command> <command-arguments> <command> can be one of: --filesystem Maintenance operations on filesystem. --configuration Backup/Restore system configuration. --hardware Manage appliance hardware. --disk Manage disk drives. For command-specific help, please type maintenance --help <command> For example: maintenance --help filesystem Maintaining the DR4000 System...
Schedule: configuring/managing replication and cleaner schedules for the system System Storage Operation Commands These DR4000 CLI system storage operation commands allow you to manage the connections to storage and replication containers, manage the containers, and manage storage and replication operations: •...
• connection --help --show [--name <name>, --type <nfs | cifs>, --verbose] To display the status of any existing container connection on a DR4000 system, enter the example command string at the system prompt: NOTE: In addition to displaying the current status of an existing container connection, this command also verifies if an existing container connection is disabled (by listing its status as offline).
--add, --name <name>, --type <nfs | cifs>, [--clients <ip address>, -- rootmap <nobody | root | administrator>, --options <nfs options>] To create a new connection to a container on a DR4000 system, enter the example command string at the system prompt:...
--update, --name <name>, --type <nfs | cifs> [--clients <ip address>, -- rootmap <nobody | root | administrator>, --options <nfs options>] To update an existing container connection by modifying its connection values on a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > connection –-update --name dataStorage3 --type nfs --clients 10.27.22.11...
: Available --delete, --name <name>, --type <nfs | cifs> [--clients <ip address>] To delete an existing container connection on a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > connection –-delete --name dataStorage3 --type nfs –-clients 10.27.22.11 Successfully deleted connection entry.
--disable, --name <name>, --type <nfs | cifs> To disable an existing container connection on a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > connection –-disable --name dataStorage3 --type nfs Successfully updated connection entry. NFS connection IP addresses : 10.27.22.11...
Page 95
Deletes an existing connection. --enable Enables access to a container through a connection. --disable Disables access to a container through a connection. For command-specific help, please type connection --help <command> For example: connection --help show Managing DR4000 System Storage Operations...
• container --delete • container --help --show [-name <name>, --verbose] To display a list of all current containers in a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > container –-show Container Entries are: backup swsys-59_replicate...
: Yes NFS connection status : Available --add, --name <name> To create and name a new container in a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > container --add --name dataStorage4 Container "dataStorage4" created successfully.
<command> can be one of: --show Displays the current list of containers. --add Adds a new container. --delete Deletes an existing container. For command-specific help, please type container --help <command> For example: container --help show Managing DR4000 System Storage Operations...
--help --show [--name <name>, --role <source | target>, --verbose, --limits] To display a list of existing replication containers (and respective roles) in a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > replication --show Container Name...
(kbps), megabytes/second (mbps), gigabytes/second (gbps), or use an unlimited bandwidth (default). The minimum allowed bandwidth setting for a DR4000 system is 192 kbps. For more information, see "--limit, --speed <<num><kbps | mbps | gbps> | default>, --target <ip address | hostname>" on 93.
: dataStorage4 Replication Enabled : Yes To verify that you have successfully added a replication link to a DR4000 system (or to view the current status of existing containers), enter the example command string at the system prompt: administrator@mydr4000 > replication --show...
Replication Enabled : No --delete, --name <name>, --role <source | target> [--force] To delete an existing replication link to a container in a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > replication --delete --name ds3replica --role target...
--start, --name <name>, --role <source | target> To start the replication process on an existing replication link to a container in a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > replication --start --name container2_replica --role target Replication configuration updated successfully.
To configure replication limits for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > replication --limit --speed 10gbps --target swsys-60 Successfully updated replication limit for swsys-60 to 10 Gbps. Changing traffic control policies ... done.
Page 105
<command> can be one of: --show Displays current replication status. --add Adds a replication link to a container. --update Updates a replication link to a container. --delete Deletes a replication link from a container. --start Starts replication. Managing DR4000 System Storage Operations...
--delete --day [options] • schedule --help --show [--cleaner, --replication] To display an existing cleaner schedule for a DR4000 system, enter the example command string at the system prompt: administrator@mydr4000 > schedule --show --cleaner NOTE: Do not select 00:00 when scheduling cleaner or replication schedules for midnight (instead, use 23:55 or 00:05).
20:00 --add --day <day of the week> [--start_time <hh:mm>, --stop_time <hh:mm>, --cleaner, --replication] To create a new cleaner schedule for a DR4000 system using start time and stop time setpoints, enter the example command string at the system prompt: administrator@mydr4000 > schedule --add --day Sunday...
"--show [--cleaner, --replication]" on 96. --delete --day <day of the week> [--cleaner, --replication] To delete a day in an existing cleaner or replication schedule for a DR4000 system, enter the example command string at the system prompt:...
Page 109
<command> can be one of: --show Displays existing cleaner or replication schedule. --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 Managing DR4000 System Storage Operations...
Page 110
Managing DR4000 System Storage Operations...
Linux command reference guide. To display the supported usage of the awk command with the DR4000 system, type the following at the DR4000 system CLI prompt: administrator@mydr4000 > awk...