R e (Version )
Re Guide
DR Series System CLI Reference Guide 2
Table of ContentsIntroduction to the DR Series System Command Line Reference Guide............................................. 13
About the DR Series system CLI documentation......................................................................... 13Other information you may need...................................................................................................13Locating your system Service Tag................................................................................................14
Introducing the DR Series system........................................................................................................ 15Understanding the DR Series system CLI.................................................................................... 16Accessing the DR Series system CLI commands........................................................................ 16DR Series system CLI commands overview.................................................................................16
Managing the DR Series system.......................................................................................................... 19Alerts Commands.......................................................................................................................... 19
Alerts Command Usage.........................................................................................................20alerts --show [--email]............................................................................................................ 20alerts --show [--snmp]............................................................................................................ 20alerts --show [--events] [--index [--count ] [--all]................................21alerts --show [--alerts] [--index ] [--count ] [--all]................................21alerts --show [--summary]...................................................................................................... 22alerts --email [--relay_host ]...........................................................................22alerts --email [--appliance_alerts ]........................................................................ 22alerts --email [--software_updates ]...................................................................... 23alerts --email [--daily_report ]................................................................................23alerts --email [--daily_report_time ]........................................................................24alerts --email [--sender_email ]................................................................... 24alerts --test_email...................................................................................................................24alerts --snmp_add --host --port --community .................25alerts --snmp_delete --host .......................................................................... 25alerts --snmp_disable --host .........................................................................25alerts --snmp_enable --host ......................................................................... 25alerts --snmp_trap_email [--enable] [--disable]...................................................................... 26alerts --help............................................................................................................................ 26
Authenticate Commands................................................................................................................27Authenticate Command Usage..............................................................................................27authenticate --show [--users]................................................................................................. 27authenticate --show [--domain ]................................................................... 28authenticate --show [--login_group]........................................................................................28authenticate --join --domain [--ou ] --user .....................................................................................................................................28
DR Series System CLI Reference Guide 3
authenticate --leave [--user ] [--force]...............................................................29authenticate --update --kerberos........................................................................................... 29authenticate --add [--user ]...............................................................................30authenticate --add [--login_group ]............................................30authenticate --delete--user .............................................................................. 31authenticate --delete [--login_group ]........................................ 31authenticate --set --user .................................................................................. 31authenticate --guestmode [--enable] [--disable]..................................................................... 32authenticate --guestmode [--enable]......................................................................................32authenticate --guestmode [--disable]..................................................................................... 32authenticate --server_signing --mode ....................................33authenticate --help................................................................................................................. 33
Network.......................................................................................................................................... 35Network Command Usage.....................................................................................................36network --show.......................................................................................................................36network --delete..................................................................................................................... 37network --restart..................................................................................................................... 38network --setdhcp...................................................................................................................38network --setstatic_ip [--bondif ] [--nwif ] --ip --netmask [--gateway ]..........................................38network --create_bond........................................................................................................... 39network --create_eth.............................................................................................................. 40network --add_member.......................................................................................................... 40network --setdns [--suffix ] [--primary ] [--secondary ]....................................................................................................................... 41network --setbonding --bondif [--mode ] [--mtu ]................................................................................................................41network --update.................................................................................................................... 42network --factory_reset...........................................................................................................42network --host........................................................................................................................ 43network --route....................................................................................................................... 43network --nslookup --destination ...................................................43network --traceroute --destination .................................................44network --ping --destination [--tries ] [--size ] [--interface ]..................................................................................................... 44network --blink........................................................................................................................45network --enable.................................................................................................................... 45network --troubleshoot [--links] [--gateway] [--ntp] [--dns] [--active_domain] [--nis] [--clients] [--port_mapper] [--network_config] [--show_active ] [--interface ]..................................................................................................... 46
DR Series System CLI Reference Guide 4
network --troubleshoot --gateway --interface .............................................. 48network --troubleshoot [--show_active ]..................... 48network --tcpdump [--port ] [--pkt_size ][--file_size ] [--stop] [--host ] [--interface ]............ 48network --tcpdump [--pkt_size ]......................................................................49network --tcpdump [--file_size ]..............................................................................49network --tcpdump [--host ]......................................................................... 50network --tcpdump [--port ].......................................50network --iperf_client --server [--port ] [--window_size] [--interval ] [--time ]........................ 50network --iperf_server [--port ] [--window_size ]...................51network --help........................................................................................................................ 52
OST................................................................................................................................................ 54OST Command Usage.......................................................................................................... 54ost --show [--config] [--file_history] [--name ] [--active_files] [--name ] [--clients] [--limits]...................................................................................................................... 55ost --update --opdup_encryption .................................................56ost --delete_client --name ..............................................................56ost --update_client --name --mode ................................................................................................................................. 57ost --limit --speed ].....................................................................................................................................58ost --help................................................................................................................................ 58
RDA................................................................................................................................................59RDA Command Usage.......................................................................................................... 59rda --show [--config] [--file_history] [--name ] [--active_files] [--name ] [--clients] [--limits]...................................................................................................................... 60rda --update --opdup_encryption ................................................ 61rda --delete_client --name ............................................................. 61rda --update_client --name --mode ................................................................................................................................. 61rda --limit --speed --target ..............................................................................................................................62rda --partial_images --containerid [--delete ] [--timeout 0>].....................................................................................................................................62rda --help................................................................................................................................62
Stats............................................................................................................................................... 63Stats Command Usage..........................................................................................................64stats --system.........................................................................................................................65stats --cpu.............................................................................................................................. 65
DR Series System CLI Reference Guide 5
stats --memory....................................................................................................................... 65stats --network........................................................................................................................66stats --datacheck....................................................................................................................67stats --nfs............................................................................................................................... 68stats --cifs...............................................................................................................................69stats --ost............................................................................................................................... 70stats --rds............................................................................................................................... 71stats --ndmp........................................................................................................................... 72stats --ndmp_completed.........................................................................................................72stats --iscsi [--verbose]...........................................................................................................72stats --fc [--iostat] [--linkstat].................................................................................................. 73stats --container --name .......................................................................................... 75stats --storage_group --name .................................................................................. 75stats --replication [--name ].......................................................................................76stats --cleaner........................................................................................................................ 76stats --clients [--type ]............................................77stats --reset [--nfs] [--cifs] [--ost] [--rds] [--datacheck]............................................................78stats --reset --datacheck........................................................................................................ 78stats --seed............................................................................................................................ 78stats --help............................................................................................................................. 79stats --datacheck....................................................................................................................80stats --datacheck Command Usage...................................................................................... 80stats --help datacheck............................................................................................................80
Storage Group commands............................................................................................................ 81Storage Group Command Usage.......................................................................................... 81storage_group --show [--name ] [--verbose]............................................................. 81storage_group --add --name [--compression_mode ].............................82storage_group --update --name [--compression_mode ]........................82storage_group --encryption --name [--set ] [--mode
DR Series System CLI Reference Guide 6
system --show [--storage]...................................................................................................... 89system --show [--license] [--verbose].....................................................................................89system --show [--ntp]............................................................................................................. 90system --show [--version].......................................................................................................90system --show [--timezones [Region]]................................................................................... 90system --show [--upgradefile]................................................................................................ 91system --show [--upgradehistory]...........................................................................................91system --show [--marker]....................................................................................................... 91system --show [--replication_traffic]....................................................................................... 92system --show [--opdup_traffic]..............................................................................................92system --show [--backup_traffic]............................................................................................ 92system --show [--mgmt_traffic]...............................................................................................92system --init............................................................................................................................93system --init --secure_erase ...................................................94system --reboot...................................................................................................................... 97system --shutdown................................................................................................................. 97system --upgrade................................................................................................................... 97system --license [--validate] [--add]....................................................................................... 98system --setname --name ..............................................................................99system --setdate [--date ] [--timezone ]..............................................99system --setntp [--add ]............................................................................... 100system --setntp [--delete ]........................................................................... 100system --setntp [--enable].................................................................................................... 100system --setntp [--disable]................................................................................................... 101system --setntp [--adjust_time].............................................................................................101system --hybrid_replication [--enable][--disable][--status].................................................... 101system --rdairgap [--enable][--disable][--set_retention_period ][--get_retention_period][--open][--close][--status].....................................................................102system --rdairgap_schedule [--start_time ][--end_time ][--remove]......102system --setlogin.................................................................................................................. 103system --telnet [--enable | --disable]....................................................................................103system --datacheck --enable............................................................................................... 103system --datacheck --disable...............................................................................................104system --datacheck --throttle............................................................................................... 104system --marker [--enable] [--disable]..................................................................................104system --verify_on_read [--enable] [--disable]......................................................................105system --add_storage --enclosure ................................................................ 105system --storage [--set_usage_alert ]............................................................ 106
DR Series System CLI Reference Guide 7
system --storage [--blink] [--type ] [--service_tag ] [--disk].......................................................................................................................... 106system --storage [--unblink] [--type ] [--service_tag ] [--disk........................................................................................................................... 107system --mgmt_traffic...........................................................................................................107system --backup_traffic........................................................................................................ 107system --replication_traffic................................................................................................... 108system --opdup_traffic..........................................................................................................108system --help........................................................................................................................109
User..............................................................................................................................................110User Command Usage........................................................................................................ 111user --show [--users] [--logins] [--verbose][--name ] [--roles .........................................................................111user --enable --user ...................................................................................112user --disable --user .................................................................................. 112user --add --name ......................................................................................... 112user --update --name [--new_name ] [--add_roles ] [--remove_roles ] [--full_name ] [--phone ] [--email_addr ] [--description ]................................................................................113user --delete --name ......................................................................................113user --setpassword --name ........................................................................... 113user --help............................................................................................................................ 114
Virtual Machine............................................................................................................................ 114Virtual Machine Command Usage.......................................................................................115virtual_machine -- show [--service_tag ].........................................................115virtual_machine --show --summary......................................................................................115virtual_machine --update [--host ] [--name ] [--email ] [--company ] [--comments ].......... 116virtual_machine --register [--host ] [--name ] [--email ] [--company ] [--comments ].......... 116virtual_machine --unregister [--force]................................................................................... 116virtual_machine –delete --service_tag ...........................................................117
Maintaining the DR Series System..................................................................................................... 118Diagnostics...................................................................................................................................118
Diagnostics Command Usage............................................................................................. 119diagnostics --start-service.................................................................................................... 119diagnostics --show............................................................................................................... 119diagnostics --collect..............................................................................................................120diagnostics --collect [--name ]................................................................................ 120diagnostics --collect [--reason ].............................................................................120
DR Series System CLI Reference Guide 8
diagnostics --collect [--force]................................................................................................121diagnostics --collect [--dset]................................................................................................. 121diagnostics --collect [--logs]................................................................................................. 121diagnostics --collect [--cores]............................................................................................... 122diagnostics --collect [--tcpdump].......................................................................................... 122diagnostics --collect [--process_dump].................................................................................122diagnostics --collect [--all].................................................................................................... 123diagnostics --delete [--name ].................................................................................123diagnostics --delete [--all].....................................................................................................123diagnostics --copy --name --host :>............................... 124diagnostics --help................................................................................................................. 124
Maintenance.................................................................................................................................125Maintenance Command Usage........................................................................................... 125maintenance --filesystem [--start_scan [verify_data | verify_rda_metadata | verify_metadata][--storage_group ]....................................................................................................126maintenance --filesystem [--stop_scan]............................................................................... 126maintenance --filesystem [--scan_status].............................................................................127maintenance --filesystem [--scan_report [verbose]].............................................................127maintenance --filesystem [--repair_status [verbose]]........................................................... 128maintenance --filesystem [--repair_history [verbose]].......................................................... 128maintenance --filesystem [--scan_restart [verify_data | verify_rda_metadata |verify_metadata]].................................................................................................................. 129maintenance --filesystem [--repair_now].............................................................................. 129maintenance --filesystem [--reclaim_space].........................................................................129maintenance --filesystem [--clear_quarantine]..................................................................... 130maintenance --filesystem [--clear_quarantine]..................................................................... 130maintenance --filesystem --show_throughput...................................................................... 130maintenance --configuration [--backup]............................................................................... 130maintenance --configuration [--restore]................................................................................131maintenance --configuration [--reinit_dictionary].................................................................. 131maintenance --configuration [--reset_web_certificate]......................................................... 132maintenance --configuration --enable_sha256_web_certificate........................................... 132maintenance --hardware [--reinit_nvram]............................................................................. 132maintenance --hardware [--restore_hw_db]......................................................................... 133maintenance --hardware [--motherboard_replaced].............................................................133maintenance --disk [--make_standby [slot num]] [--type ] --clear_foreign]............................................................................................................ 133maintenance --remote_access [--show]...............................................................................134maintenance --remote_access [--enable].............................................................................134
DR Series System CLI Reference Guide 9
maintenance --remote_access [--racreset].......................................................................... 135maintenance --remote_access [--static_ip] [--ip ] [--netmask ][--gateway ] [--device ]..................................135maintenance --remote access [--disable].............................................................................135maintenance --vdisk --check_consistency --type [--service_tag].......................................................................................................................136maintenance --help.............................................................................................................. 136
Managing DR Series System Storage Operations............................................................................. 138System Storage Operation Commands.......................................................................................138Connection................................................................................................................................... 138
Connection Command Usage..............................................................................................138connection --show [--name ]...................................................................................139connection --show [--name ] [--type ] [--verbose]................................................................................................................................139connection --show [--verbose]............................................................................................. 140connection --add --name --type [--clients][--dma ][--initiator ][--target ][--rootmap ] [--options ] [--capacity ].................................................... 141connection --update --name --type [--clients ][--dma ][--initiator ][--target ][--rootmap ] [--options ] [--capacity ]......................................... 142connection --delete --name --type [--clients ]............................................................................................................143connection --enable --name --type .................................. 143connection --disable --name --type ................................. 143connection --help..................................................................................................................144
Container......................................................................................................................................145Container Command Usage................................................................................................ 145container --show...................................................................................................................145container --show [--name ] [--verbose]................................................................... 145container --add --name [--type ] [--tape_size ][--no_of_drives ][--is_oem ][--oem_vendor ][--group_name ]............ 146container --update --name [--no_of_drives ].............................................. 147container --delete --name ...................................................................................... 147container --delete --name [--delete_files]...............................................................148container --marker [--enable ] [--disable ] --name ......... 148container --delete_files --name ..............................................................................149container --help.................................................................................................................... 149
VTL...............................................................................................................................................150
DR Series System CLI Reference Guide 10
VTL Command Usage......................................................................................................... 150vtl --show [--name ].................................................................................................150vtl --show --verbose [--name ]................................................................................ 151vtl --update_carts --name --add --no_of_tapes .....................................152vtl --activate --name [--force ]................................................................. 152vtl --deactivate --name ...........................................................................................152vtl --rescan --name [--force ]...................................................................152vtl --set_rw --name [--id ].......................................................................153vtl --show_replstate --name ................................................................................... 153vtl --help............................................................................................................................... 154
NDMP...........................................................................................................................................154NDMP Command Usage..................................................................................................... 154ndmp --show........................................................................................................................ 155ndmp --update [--port ].................................................................................155ndmp --help.......................................................................................................................... 155
iSCSI............................................................................................................................................ 156ISCSI Command Usage...................................................................................................... 156iscsi --show [--user]..............................................................................................................156iscsi --setpassword...............................................................................................................157iscsi --sessions.....................................................................................................................157iscsi --help............................................................................................................................ 158
FC.................................................................................................................................................158FC Command Usage........................................................................................................... 158fc --show [--verbose] [--target]............................................................................................. 158fc --sessions [--topology] [--condensed].............................................................................. 161fc --help ...........................................................................................................161
Replication....................................................................................................................................162Replication Command Usage.............................................................................................. 162replication --show [--name ] [--role ] [--verbose] [--limits].............163replication --show................................................................................................................. 163replication --show [--limits]................................................................................................... 164replication --add --name --role --peer [--peer_name ] [--peer_group_name ] [--replication_traffic ] [--encryption ][--username ]...............164replication --update --name --role [--peer ] [--encryption ] [--username ]..............165replication --delete --name --role [--force]................................. 166replication --start --name --role ................................................. 166replication --stop --name --role ..................................................167
DR Series System CLI Reference Guide 11
replication --limit --speed --target ............................................................................................................................167replication --resync --name --role ..............................................167replication --troubleshoot --peer ..................................................168replication --help...................................................................................................................168
Seed............................................................................................................................................. 169Seed Command Usage....................................................................................................... 170seed --create --op [--enc_type ] [--storage_group_name]............................................................................................................................... 171seed --add_container --name ................................................................ 171seed --add_device --server --volume --username --domain ...................................................................................................... 171seed --cleanup..................................................................................................................... 172seed --remove_device..........................................................................................................172seed --show..........................................................................................................................172seed --start........................................................................................................................... 173seed --help........................................................................................................................... 173
Schedule...................................................................................................................................... 174Schedule Command Usage.................................................................................................174schedule --show [--cleaner]................................................................................................. 174schedule --show [--replication] [--name ]................................................................ 175schedule --add --day [--cleaner] [--replication] [--start_time ] [--stop_time ] [--name ]............................................................................... 175schedule --delete --day [--cleaner] [--name ] [--replication]...... 176schedule --help.....................................................................................................................176
Data Integrity Checking....................................................................................................................... 178About Data Check....................................................................................................................... 178
Priority Write Verify Scans...................................................................................................178Continuous Data Verification Scans.................................................................................... 179Data Check CLI Commands................................................................................................179Data Check Options.............................................................................................................179
Data Check: Namespace Scan Option........................................................................180Data Check: Blockmap Scan Option........................................................................... 180Data Check: All Data Scan Option.............................................................................. 180
System --Datacheck.....................................................................................................................180System --Datacheck Command Usage............................................................................... 180system --datacheck.............................................................................................................. 180system --datacheck --disable...............................................................................................181system --datacheck --enable............................................................................................... 181system --datacheck --throttle............................................................................................... 182
DR Series System CLI Reference Guide 12
system --help datacheck......................................................................................................182stats --datacheck..........................................................................................................................182
stats --datacheck Command Usage.................................................................................... 183stats --datacheck..................................................................................................................183
Additional Linux Commands................................................................................................................185grep.............................................................................................................................................. 185more............................................................................................................................................. 186
About us...............................................................................................................................................187Index.................................................................................................................................................... 188
DR Series System CLI Reference GuideOther information you may need
13
Introduction to the DR Series SystemCommand Line Reference Guide
This guide provides detailed information for managing DR Series system data backup and replication operationsby using the DR Series system command line interface (CLI).
About the DR Series system CLIdocumentationThis document provides information about using the DR Series system command line interface (CLI) formanaging your data backups, performing a variety of data storage operations, and using containers to meet yourbackup and replication storage needs.
NOTE: The DR Series system CLI provides one method for managing the DR Series system, with theother being the DR Series system graphical user interface (GUI). In some instances, the DR Series systemCLI might provide additional features and options that are not available in the DR Series system GUI andvice versa.
Other information you may needThe following table lists the documentation available for the DR Series systems. The documents listed areavailable at support.quest.com/DR-Series by selecting your specific DR Series system. For more informationabout DR Series system hardware, see the safety and regulatory information that shipped with your DR Seriessystem. Warranty information might be included as a separate document.
Document Description
DR Series System Getting Started Guide Provides an overview of how to set up the physicalDR Series system hardware and includes technicalspecifications.
DR Series System Owner's Manual Provides information about applicable physical DRSeries system features, troubleshooting the DRSeries system, and installing or replacing the DRSeries system components.
DR2000v Deployment Guide Provides information about deploying the virtualDR Series system, DR2000v, on supported virtualplatforms.
DR Series System Administrator Guide Provides information about managing backup andreplication operations using the DR Series systemGUI.
http://support.quest.com/DR-Series
DR Series System CLI Reference GuideLocating your system Service Tag
14
Document Description
DR Series System Interoperability Guide Provides information on supported hardware andsoftware for the DR Series systems.
DR Series System Command Line Reference Guide Provides information about managing DR Seriessystem data backup and replication operations usingthe DR Series system command line interface (CLI).
DR Series System Release Notes Provides the latest information about new featuresand known issues with a specific product release.
NOTE: Always check for the latest documentation updates and release notes at support.quest.com/dr-series, and read the release notes first because they contain the most recently documented informationabout known issues with a specific product release.
Locating your system Service TagYour system is identified by a unique Express Service Code and Service Tag number. You can find the ExpressService Code and Service Tag on the front of a DR Series hardware system by pulling out the informationtag. You can also find service tag information on the Support page in the DR Series system GUI. Service taginformation is useful in routing support calls to the appropriate personnel for resolution.
http://support.quest.com/DR-Serieshttp://support.quest.com/DR-Series
DR Series System CLI Reference GuideIntroducing the DR Series system
15
Introducing the DR Series systemThe DR Series system is a high-performance, disk-based backup and recovery appliance that is simple to deployand manage and offers unsurpassed Total Cost of Ownership benefits. Features such as innovative firmwareand an all-inclusive licensing model ensure optimal functionality and provide the assurance of no hidden costs forvaluable future features.
NOTE: Unless otherwise noted, later references to "the system" or "DR Series system" are usedinterchangeably to represent the DR Series system.A purpose-built backup-to-disk appliance, the DR Series system provides advanced deduplication andcompression technology to store data most efficiently. The DR Series hardware appliances are 2U, rack-based,system backup storage repositories, that include deduplication and compression technology in their operatingsystems. A virtual machine (VM) version is also available (that is connected via a license with a DR Serieshardware appliance) to provide robust, disk-based data backup capability on Virtual Machine host servers, whiletaking advantage of replicating to a deduplication-enabled appliance.
Data Protection | DR Series of backup and deduplication appliances support all the major backup softwareapplications in use today and can lower your backup storage costs to as little as $.16/GB while reducing your totalcost of ownership. The purpose built appliances achieve these results using patented Rapid technology as well asbuilt-in, variable block-based deduplication and compression. The DR Series helps you to:
• Reduce your backup storage footprint
• Speed up recovery
• Reduce or eliminate the need for physical tapes for backup
• Optimize network bandwidth by lowering the amount of data sent to disaster recovery sites
The DR Series system includes the following features:
• Advanced data protection and disaster recover
• Two management interfaces: a command line interface (CLI) or a system graphical user interface (GUI) forthe system software to manage storage containers.
• Support for a wide variety of data backup installations and environments.
• A simple installation process that provides full, intuitive remote setup and management capabilities.
The system is available in many drive capacities to fit SMB, enterprise, and remote office environments. Theinternal system drive capacity and available physical capacities of the DR Series system vary, depending on yoursystem type and drives installed. For details about specific drive capacities and models available, see the DRSeries System Interoperability Guide or the latest DR Series System Release Notes.
Understanding the DR Series system CLI
The DR Series system command line interface (CLI) provides the means for managing the status, data capacity,storage savings, and throughput of data containers.
NOTE: An online data verification or data-checking feature called Data Check is enabled by default on theDR Series system. For more information about Data Check, see Data Integrity Checking.
Data Integrity Checking=GUID-D1224879-84FF-4727-8218-FB3B51B720D9=1=en-us=.xml
DR Series System CLI Reference GuideDR Series system CLI commands overview
16
Understanding the DR Series system CLIThe DR Series system command line interface (CLI) provides the means for managing the status, data capacity,storage savings, and throughput of data containers.
NOTE: An online data verification or data-checking feature called Data Check is enabled by default on theDR Series system. For more information about Data Check, see Data Integrity Checking.
Accessing the DR Series system CLIcommandsThis guide assumes that your DR Series system has been deployed in the proper network location and is ready tobe accessed by the DR Series system CLI commands.
To access the DR Series system CLI commands from the system CLI prompt, complete the following steps.
1. Launch a terminal emulation application and start the process for logging in to the DR Series system.2. In Host Name (or IP address), type the host name or IP address for the DR Series system, and click
Open.3. At the system prompt, enter the username for the Administrator:
◦ Type administrator
◦ Press
4. At the administrator password prompt, enter the password for the Administrator (the default is St0r@ge!):
◦ Type St0r@ge!
◦ Press
The DR Series system administrator prompt is displayed.5. At the administrator prompt, type help.
The DR Series system CLI commands are displayed.
DR Series system CLI commandsoverviewThe following command groups are available in the DR Series system CLI.
NOTE: The DR Series system Administrator account only provides access to the DR Series system CLIcommands listed in this section. There is no access to Linux commands other than grep or more from theDR Series system command line with the Administrator account.
For more information on each command group, run the following command:
--help show
Data Integrity Checking=GUID-D1224879-84FF-4727-8218-FB3B51B720D9=1=en-us=.xml
DR Series System CLI Reference GuideDR Series system CLI commands overview
17
Table 1. DR Series System CLI Commands Overview
Command Group Description
alerts View system events and configure emailnotifications, contact information, and daily reports.
authenticate Configure Active Directory (AD) authentication.
connection Configure NFS | CIFS | OST | RDS | NDMP| ISCSI |FC access to a container.
container Configure a file system to share over NFS | CIFS |OST | RDS | NDMP | ISCSI | FC.
diagnostics Gather log information for support issues.
help Display this help message.
iscsi Manage and view iscsi connection types for VTLcontainers.
ndmp Manage and view ndmp connection types for VTLcontainers.
fc Manage and view fibre channel connection types forVTL containers.
maintenance Repair the data and state of the system.
network Configure networking properties.
ost Configure OST for Veritas (formerly Symantec)backup applications.
rda Configure Rapid Data Access (RDA) for the NetVaultapplication.
replication Manage replication between systems.
seed Configure and manage seeding import or export.
schedule Manage replication and cleaner schedules in thesystem.
stats View statistics for system components.
storage_group Manage and view the storage groups on a DRSeries system
system Manage and view the system configuration.
DR Series System CLI Reference GuideDR Series system CLI commands overview
18
Command Group Description
user Enable or disable service and root accounts on thenode.
virtual machine Manage and view DR2000v virtual machines.
vtl Manage and view VTL container types.
grep
more
System tools
DR Series System CLI Reference GuideAlerts Commands
19
Managing the DR Series systemThis topic introduces the DR Series system CLI commands for configuring, managing, and viewing the currentstatus of a DR Series system. For example, the DR Series system CLI alerts and system commands bothcontain options that provide administrators with the capability to configure, manage, and display the status of thea DR Series system.
The following list of commands provide the functionality for configuring, managing, and displaying the DR Seriessystem status:
• Alerts
• Authenticate
• Network
• OST (OpenStorage Technology)
• RDA (Rapid Data Access)
• Stats (statistics)
• Storage Group
• System
• User
• Virtual Machine
Alerts CommandsThis topic introduces the set of DR Series system CLI commands that enable you to perform the following tasks:
• Display system alerts and events.
• Create new email accounts or modify existing email accounts for recipients, which are used for email alertnotifications.
• Select to receive notifications about appliance alerts and software updates.
• Test to confirm that email account recipients can receive alerts via Simple Network Management Protocol(SNMP) traps for a designated host.
• Set, enable, disable, or delete SNMP traps for a designated host.
DR Series System CLI Reference Guidealerts --show [--snmp]
20
Alerts Command UsageThis topic introduces the alerts command usage:
• alerts --show [options]
• alerts --email [options]
• alerts --test_email
• alerts --snmp_add [options]
• alerts --snmp_delete --host
• alerts --snmp_enable --host
• alerts --snmp_disable --host
• alerts --snmp_trap_email [options]
• alerts --help
NOTE: If you specify a command without supplying the expected value or option, you will be prompted toprovide 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 Seriessystem.
Syntaxalerts --show --email
ResultRecipients: [email protected] Host: 10.10.10.10Admin Name: John SmithCompany Name: Acme.comAdmin Email: [email protected]: 408-555-1212Comments: Day Shift Administrator
alerts --show [--snmp]Description
Displays the current SNMP information for a DR Series system.
Syntaxalerts --show --snmp
ResultHost Status Port Community10.20.20.10 Enabled 2100 snmpPublic10.25.19.11 Enabled 1120 snmpPublic12
DR Series System CLI Reference Guidealerts --show [--alerts] [--index ] [--count ] [--all]
21
10.12.14.20 Enabled 1550 snmpPublic11
NOTE: For more information about configuring a host to receive SNMP alerts, see alerts --email [--relay_host ].
alerts --show [--events] [--index [--count ] [--all]Description
Displays the current list of system events.
NOTE: The default is to display the 32 most recent events (this example is intentionally brief). The countand index options can also be used to filter the list of events (alerts –show –events –index oralerts --show --events --index ).
Syntaxalerts --show --events
ResultIndex Severity Time Event Message---------------------------------------------------------------------------------399 INFO 2012-06-10 14:07:18 System diagnostic package collected.398 INFO 2012-06-10 12:21:47 Successfully updated Cleaner schedule.397 INFO 2012-06-10 12:20:03 User service enabled.
alerts --show [--alerts] [--index ] [--count ] [--all]Description
Displays the current list of DR Series system alerts.
NOTE: By default, all DR Series system alerts are displayed.
Syntaxalerts --show --alerts
ResultIndex 1 Time2012-06-19 18:19:09 Alert MessageNetwork Interface Controller Embedded (LOM) Port 1 disconnected. Reconnect it to a network and/or check your network switches or routers for network connectivity issues.Index2 Time2012-06-19 18:19:09 Alert MessageNetwork 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.
alerts --email [--relay_host server name]=GUID-E3AB677C-7278-4DA9-B08C-04C6B732AA82=2=en-us=.xmlalerts --email [--relay_host server name]=GUID-E3AB677C-7278-4DA9-B08C-04C6B732AA82=2=en-us=.xml
DR Series System CLI Reference Guidealerts --email [--appliance_alerts ]
22
Index 3 Time2012-06-19 18:19:09 Alert MessageNetwork Interface Controller PCI Slot 1 Port 1 disconnected. Reconnect it to a network and/or check your network switches or routers for network connectivity issues.
alerts --show [--summary]Description
Displays a summary list of DR Series system alerts.
Syntaxalerts --show --summary
ResultTotal alert messages: 5Total event messages: 42Last event index: 42
alerts --email [--relay_host ]Description
Configures the email relay host that can receive alert email notifications for the DR Series system.
Syntaxalerts --email --relay_host relayhost13
ResultAlert email settings updated.Recipients: [email protected];[email protected] Host: relayhost13Admin Name: John_SmithCompany Name: Acme.comAdmin Email: [email protected]: 408-555-1212Comments: Day Shift Administrator
alerts --email [--appliance_alerts ]Description
Configures the “yes/no” setting for sending email notifications to the administrator of a DR Series system whenthere are alerts for the system appliance. Setting this option to yes causes the system administrator to receiveemail notifications when there are system appliance alerts (setting this option to no means that the systemadministrator will not receive email notifications about system appliance alerts).
Syntaxalerts --email --appliance_alerts yes
DR Series System CLI Reference Guidealerts --email [--daily_report ]
23
ResultAlert email settings updated.Recipients : [email protected] Host : acme-sys-60.western.localAdmin Name : Juan CoronaCompany Name : Acme Inc.Admin Email : [email protected] : 438-999-6699Comments : Days shift1 administratorAppliance Alerts : YesSoftware Updates : YesEmail SNMP Trap's : NoEmail Daily container stats : Yes
alerts --email [--software_updates ]Description
Configures the “yes/no” setting for sending email notifications to the administrator of a DR Series system whenthere are updates for the system software installed on the system appliance. Setting this option to yes causes thesystem administrator to receive email notifications when there are system software updates (setting this option tono means that the system administrator will not receive email notifications about system software updates).
Syntaxalerts --email --software_updates yes
ResultAlert email settings updated.Recipients : [email protected] Host : acme-sys-60.western.localAdmin Name : Juan CoronaCompany Name : Acme Inc.Admin Email : [email protected] : 438-999-6699Comments : Days shift1 administratorAppliance Alerts : YesSoftware Updates : YesEmail SNMP Trap's : NoEmail Daily container stats : Yes
alerts --email [--daily_report ]Description
Configures the “yes/no” setting for sending daily statistics about each container to the administrator of a DRSeries system. Setting this option to yes causes the system administrator to receive email notifications containingthe statistics for the last 24 hours for each container (setting this option to no means that the system administratorwill not receive daily email notifications about container statistics).
Syntaxalerts --email --daily_report --yes Enables daily container stats notification on DR. --no Disables daily container stats notification on DR.
DR Series System CLI Reference Guidealerts --test_email
24
Resultalerts --email --daily_report yesAlert email settings updated.Daily container stats notification has been enabled.Recipients : [email protected] Host : acme-sys-60.western.localAdmin Name : Juan CoronaCompany Name : Acme Inc.Admin Email : [email protected] : 438-999-6699Comments : Days shift1 administratorAppliance Alerts : YesSoftware Updates : YesEmail SNMP Trap's : NoEmail Daily container stats : Yes
alerts --email [--daily_report_time ]Description
Sets the time for the daily container statistics report to be sent.
Syntaxalerts --email --daily_report_time
Resultalerts --email --daily_report_time
alerts --email [--sender_email ]Description
Sends the alert email to the specified sender.
Syntaxalerts --email --sender_email [email protected]
alerts --test_emailDescription
Sends a test email alert notification to all of the configured email recipients in the DR Series system.
NOTE: Verify that the configured email recipients received the test email notifications that were sent. Thisis an important check that proves that the designated email recipients can receive DR Series system alertnotifications.
Syntaxalerts --test_email
ResultTest email sent.
DR Series System CLI Reference Guidealerts --snmp_enable --host
25
alerts --snmp_add --host --port --community Description
Sets SNMP traps for a host by defining its host name, port number, and listing the corresponding SNMPcommunity.
Syntaxalerts --snmp_add --host 10.12.14.20 --port 1550 --community snmpPublic1
ResultHost "10.12.14.20" added to SNMP alert recipients.
alerts --snmp_delete --host Description
Deletes SNMP traps for a host by identifying it by name or IP address at the DR Series system prompt.
Syntaxalerts --snmp_delete --host 10.10.10.12
ResultHost "10.10.10.12" deleted from SNMP alert recipients.
alerts --snmp_disable --host Description
Disables SNMP traps for a host by identifying it by name or IP address at the DR Series system prompt.
Syntaxalerts --snmp_disable --host 10.12.14.20
ResultHost "10.12.14.20" disabled for SNMP alerts.
alerts --snmp_enable --host Description
Enables SNMP traps for a host by identifying it by name or IP address at the DR Series system prompt.
Syntaxalerts --snmp_enable --host 10.12.14.20
ResultHost "10.12.14.20" enabled for SNMP alerts.
DR Series System CLI Reference Guidealerts --help
26
alerts --snmp_trap_email [--enable] [--disable]Description
Enables or disables SNMP traps to be sent out as an email message.
Syntaxalerts --snmp_trap_email --enable
ResultSuccessfully enabled SNMP Trap email forwarding.
NOTE: To disable SNMP trap mail forwarding, substitute the --disable command, as in the followingexample:alerts --snmp_trap_email --disableSuccessfully disabled SNMP Trap email forwarding.
alerts --helpDescription
Displays the listing of alerts and related options for using the DR Series system CLI.
Syntaxalerts --help
ResultUsage: alerts --show [--email] [--snmp] [--events] [--index ] [--count ] [--all] [--alerts] [--index ] [--count ] [--all] [--summary] alerts --email [--relay_host ] [--appliance_alerts ] [--software_updates ] [--daily_report_time ] [--sender_email
DR Series System CLI Reference Guideauthenticate --show [--users]
27
--snmp_enable Enables SNMP traps for a host.--snmp_disable Disables SNMP traps for a host.--snmp_trap_email Enables/Disables SNMP traps to be sent out as an email.For command-specific help, please type alerts --help For example: alerts --help show
Authenticate CommandsThis topic introduces the set of DR Series system CLI commands that let you configure the DR Series system soit can authenticate with the Microsoft Windows Active Directory Services (ADS).
For information about specific authenticate commands, see Authenticate Command Usage.
Authenticate Command UsageThis topic introduces the authenticate command usage:
• authenticate --show [options]
• authenticate --join [options]
• authenticate --leave [options]
• authenticate --update --kerberos
• authenticate --add [options]
• authenticate --delete [options]
• authenticate --set --user
• authenticate --guestmode [options]
• authenticate --server_signing --mode
• authenticate --help
NOTE: If you specify a command without supplying the expected value or option, you will be prompted toprovide the correct value or option.
authenticate --show [--users]Description
Displays the current status of the Microsoft Active Directory Service (ADS) domain, or if it is not joined, it candisplay the status of any authorized local CIFS user. For more information, see the authenticate --show [--domain].
NOTE: If this command is entered, but the DR Series system has not joined the ADS to any domain, thefollowing message is displayed.This system has not joined any domain.
Syntaxauthenticate --show
ResultDomain: ads.storage.local
Authenticate Command Usage=GUID-8A05F2F3-0D49-4BA3-91F8-AE5B5B4DB514=2=en-us=.xmlauthenticate --show [--domain domain name]=GUID-B2167FEA-2580-486B-B732-B278A8C6CD85=1=en-us=.xmlauthenticate --show [--domain domain name]=GUID-B2167FEA-2580-486B-B732-B278A8C6CD85=1=en-us=.xml
DR Series System CLI Reference Guideauthenticate --join --domain [--ou ] --user
28
If you have joined the ADS to a designated domain and you want to see the authorized users, enter theauthenticate --show --users command to display the current status:
authenticate --show --usersadministrator2administrator
authenticate --show [--domain ]Description
Displays the current status of the Active Directory Services (ADS) domain to which the DR Series system isjoined.
NOTE: If you have not joined the DR Series system to an ADS domain, use the DR Series system CLIauthenticate --join --domain command. For more information, see authenticate --join --domain [--ou ] --user .
Syntaxauthenticate --show --domain acme-ad.acme.local
ResultDomain Name : acme-ad.acme.localDomain Controller Time : 2012-10-19 12:13:40 PDTSystem Time : 2012-10-19 12:13:40 PDTTime Skew : 0 secsDomain Controller Name : test-ad-2008r2.acme-ad.acme.localDomain Controller Address : 10.20.20.4
authenticate --show [--login_group]Description
Displays the currently enabled and authenticated login group on a Microsoft Active Directory Services domain.
Syntaxauthenticate --show --login_group
ResultLogin group: acmeADS\Domain Admins
authenticate --join --domain [--ou] --user Description
Joins the DR Series system to an Active Directory Services (ADS) domain when you specify the ADS domainname and a valid user (administrator) for that domain.
authenticate --join --domain domain name [--ou org-unit name] -=GUID-1A935916-407F-4426-B951-1DB5AC0BBB18=2=en-us=.xmlauthenticate --join --domain domain name [--ou org-unit name] -=GUID-1A935916-407F-4426-B951-1DB5AC0BBB18=2=en-us=.xml
DR Series System CLI Reference Guideauthenticate --update --kerberos
29
NOTE: When attempting to join the ADS domain, the administrator password is required for that domain toensure that the join operation is successful. Supported domain names are limited to 64 characters in lengthand 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 RestoreManager (RM), after it completes you must manually rejoin the desired ADS domain using theauthenticate --join command.
Syntaxauthenticate --join --domain ads.storage.local --user administrator
ResultEnter password for [email protected]:Successfully joined domain ads.storage.localDisabling NTP service... done.Updated Windows Access Server Configuration.Updated Kerberos configuration.Updated machine password.Updated DNS.Restarting Windows Access Server... done.
NOTE: The --ou command is optional and allows for defining a specific organizational group in theADS that requires its own administrative access rights (such as an executive management or financegroup). In case of multiple organizational groups, use the following format: "”
authenticate --leave [--user ] [--force]Description
Enables a DR Series system to leave a Microsoft Active Directory Services (ADS) domain when you provide avalid administrator password.
Syntaxauthenticate --leave --user administrator
ResultEnter password for [email protected]:Successfully left domain ads.storage.local.Updated Windows Access Server configuration.Updated Kerberos configurationRestarting Windows Access Server... done.Enabling NTP service... done.
NOTE: The --force command is optional and allows the DR Series system to leave the ADS domain whencommunication between the system and the ADS domain is lost and the --leave operation is pending or inprogress.
authenticate --update --kerberosDescription
Updates a Microsoft Active Directory Service (ADS) Kerberos configuration (Kerberos is a computer networkauthentication protocol).
DR Series System CLI Reference Guideauthenticate --add [--login_group ]
30
Syntaxauthenticate --update --kerberos
ResultUpdated kerberos configuration.
authenticate --add [--user ]Description
Adds a new local CIFS workgroup user for CIFS authentication (and administrative tasks) after you provide andconfirm the CIFS user password.
Syntaxauthenticate --add --user administrator2
ResultEnter password for new CIFS user administrator2:Re-enter password for new CIFS user administrator2:Added CIFS user administrator2.
authenticate --add [--login_group ]Description
Adds an authenticated login group in an Active Directory Services (ADS) domain in accordance with the followingADS login group guidelines:
• Log in as an administrator via the CLI, and use SSH, Telnet, or a local console connection as a domain\user that is part of a login group. When you log in as an administrator via the CLI, you are promptedto use the credentials of the user account by which you log in (for example: if you log in as a Domain\administrator, you need to respond using these credentials).
• Log in as an administrator via the GUI, and use a web interface connection as a domain\user that is part ofa login group (when this has been enabled via the CLI).
• If no login group is specified, or the group is disabled, no access using domain accounts is permitted.
• Adding a login group can only be enabled via the CLI.
• Adding a login group is only possible when the DR Series system is already joined to a domain.
• If the login group name has a space in it, it must be contained within double-quotation marks (“ “).
• When adding a login group, it must use the naming convention of Domain\group name.
• The login group must exist in the domain before you can add it (a check is performed to verify that thegroup exists in ADS).
• Changes made to the login group take effect on the next log in attempt (no active checking is done ongroup, which matches how Windows ADS works).
NOTE: To delete an existing login group, see authenticate --delete [--login_group ].
authenticate --delete [--login_group DOMAINLOGIN GROUP]=GUID-2B63327C-C49D-4888-9A54-D497FC033F78=1=en-us=.xmlauthenticate --delete [--login_group DOMAINLOGIN GROUP]=GUID-2B63327C-C49D-4888-9A54-D497FC033F78=1=en-us=.xml
DR Series System CLI Reference Guideauthenticate --set --user
31
Syntaxauthenticate --add --login_group "acmeads\Domain Admins"
ResultSuccessfully added login group acmeads\Domain Admins.
authenticate --delete--user Description
Deletes an existing local CIFS workgroup user from CIFS authentication (and administrative tasks).
Syntaxauthenticate --delete --user administrator2
ResultDeleted CIFS user administrator2.
authenticate --delete [--login_group ]Description
Deletes an existing authenticated login group in an Active Directory Services (ADS) domain. For more informationabout DR Series system and ADS login group guidelines, see authenticate --add [--login_group ].
NOTE: Ensure that the login group exists in the Active Directory Services (ADS) domain, and that the “\”and any spaces in the login group name are in quotation marks (“ “).
Syntaxauthenticate --delete --login_group "acmeads\Domain Admins"
ResultDeleted login group acmeads\Domain Admins.
authenticate --set --user Description
Sets the password for an existing local CIFS workgroup user when you create and confirm the new password.
Syntaxauthenticate --set --user administrator2
ResultEnter new password for CIFS user administrator2:Re-enter new password for CIFS user administrator2:Changed administrator2's password.
authenticate --add [--login_group DOMAINLOGIN GROUP]=GUID-B2C2B0DB-8835-4437-B252-362D3D7B6AAA=1=en-us=.xmlauthenticate --add [--login_group DOMAINLOGIN GROUP]=GUID-B2C2B0DB-8835-4437-B252-362D3D7B6AAA=1=en-us=.xml
DR Series System CLI Reference Guideauthenticate --guestmode [--disable]
32
NOTE: The DR Series system administrator that manages the DR Series system has a different set ofprivileges than does the CIFS user administrator. For example, only the DR Series system administratorcan change the password for the CIFS user administrator.
authenticate --guestmode [--enable] [--disable]Description
Configures all CIFS shares for guest-only access by enabling or disabling this capability. For specific examples ofenabling or disabling guest-only access, see authenticate --guestmode --enable and authenticate --guestmode --disable.
Syntaxauthenticate --guestmode
ResultMust include either enable or disable option.--guestmode - Configures all CIFS shares for guest only access.Usage: authenticate --guestmode [--enable] [--disable] --enable Enable only guest access CIFS shares. --disable Disable only guest access for CIFS shares.
authenticate --guestmode [--enable]Description
Configures all CIFS shares for guest-only access.
Syntaxauthenticate --guestmode --enable
ResultRestarting Windows Access Server... done.
NOTE: If you attempt to enable guestmode for all CIFS shares when the DR Series system is alreadyjoined to an ADS domain by (using the DR Series system CLI authenticate --guestmode --enablecommand), the following error message displays: This node is already joined to domain .Please leave the domain before enabling the guest-only mode.
authenticate --guestmode [--disable]Description
Disables all CIFS shares as guest-only access.
Syntaxauthenticate --guestmode --disable
ResultRestarting Windows Access Server... done.
authenticate --guestmode [--enable]=GUID-850C95F5-3717-42B2-9E99-8F82ED69A052=1=en-us=.xmlauthenticate --guestmode [--disable]=GUID-030BC631-E78B-49A4-8AB5-DA1542CFB81A=1=en-us=.xmlauthenticate --guestmode [--disable]=GUID-030BC631-E78B-49A4-8AB5-DA1542CFB81A=1=en-us=.xml
DR Series System CLI Reference Guideauthenticate --help
33
NOTE: If you attempt to enable guestmode for all CIFS shares when the DR Series system is alreadyjoined to an ADS domain (using the DR Series system CLI authenticate --guestmode --enablecommand), the following error message displays: This node is already joined to domain .Please leave the domain before enabling the guest-only mode.
authenticate --server_signing --mode Description
Configures the server signing for Common Internet File System (CIFS) on a DR Series system. This is a securityprovision based on Server Message Block (SMB) signing, a form of packet authentication. After CIFS-basedusers are authenticated, SMB signing adds a digital signature to each packet that is transferred between clientand server. These digital signatures verify that the identity of the server matches the credentials expected by theclient, and vice versa. By verifying that every packet that is received comes from an authenticated source, thesedigital signatures ensure the integrity of the communications. The DR Series system CLI --server_signing --mode command contains four values:
• auto — Configures authentication via server signing to be automatically performed.
• mandatory — Configures authentication via server signing as mandatory, or the connection will bedropped.
• disabled — Disables authentication via server signing so that no connections are accepted.
Syntaxauthenticate --server_signing --mode auto
ResultSuccessfully added server signing to auto.
authenticate --helpDescription
Displays the list of all authenticate-related options that can be used as a reference when using the DR Seriessystem CLI.
Syntax authenticate --help
ResultUsage:authenticate --show [--users] [--domain ] [--login_group]authenticate --join --domain [--ou ] --user authenticate --leave [--user ] [--force]authenticate --update --kerberosauthenticate --add [--user ] [--login_group ]authenticate --delete [--user ]
DR Series System CLI Reference Guideauthenticate --help
34
[--login_group ]authenticate --set --user authenticate --guestmode [--enable] [--disable]authenticate --server_signing --mode authenticate --helpauthenticate can be one of:--show Displays current ADS domain, authorized local CIFS users, and login group.--join Joins an ADS domain.--leave Leaves an ADS domain.--update Updates ADS configuration.--add Creates local workgroup user for CIFS authentication or adds login group.--delete Deletes local workgroup user from CIFS authentication or deletes login group.--set Sets password for a local workgroup user.--guestmode Configures all CIFS shares for guest only access.--server_signing Configures server signing for CIFS.For command-specific help, please type authenticate --help For example: authenticate --help show
DR Series System CLI Reference GuideNetwork
35
NetworkThe DR Series system CLI commands let you perform the following network-related tasks:
• Displays information about a DR Series system.
• Deletes network interfaces.
• Restarts networking.
• Configures bond interface to use DHCP.
• Assigns a static IP address to the bond interface.
• Creates bond interfaces for the system.
• Creates eth interfaces for the system.
• Adds an interface to an existing bond.
• Configures servers in the domain name system (DNS).
• Updates the bonding mode or maximum transmission unit (MTU).
• Updates bonding and individual interface information.
• Resets networking to factory configuration.
• Manages local hosts.
• Manages local routes.
• Looks up the IP address or hostname for a specific destination.
• Starts a packet trace route for a specific network host.
• Pings a destination host
• Blinks LED on the specific ethernet device.
• Starts the specific ethernet devices on restart.
• Does not start the specific ethernet devices on restart.
• Performs basic troubleshooting.
• Capture network traffic.
• Runs iperf (Network Performance) in client mode.
• Runs iperf (Network Performance) in server mode.
DR Series System CLI Reference Guidenetwork --show
36
Network Command Usage• network --show [options]
• network --delete (Option only available on a Physical DR)
• network --restart
• network --setdhcp [options]
• network --setstatic_ip [options]
• network --create_bond (Option only available on a Physical DR)
• network --create_eth (Option only available on a Physical DR)
• network --add_member (Option only available on a Physical DR)
• network --setdns [options]
• network --setbonding [options] (Option only available on a Physical DR)
• network --update (Option only available on a Physical DR)
• network --factory_reset (Option only available on a Physical DR)
• network --host (Option only available on a Physical DR)
• network --route (Option only available on a Physical DR)
• network --nslookup [options]
• network --traceroute [options]
• network --ping [options]
• network --blink (Option only available on a Physical DR)
• network --enable (Option only available on a Physical DR)
• network --disable (Option only available on a Physical DR)
• network --troubleshoot [options]
• network --tcpdump [options]
• network --iperf_client [options]
• network --iperf_server [options]
• network --help
NOTE: If you specify a command without supplying the expected value or option, you are prompted toprovide the correct value or option.
NOTE: Most network commands require a network --restart command for the changes to occur.
network --showDescription
Displays the current networking configuration for a DR Series system. (Only a Physical DR has sub-options fornetwork –show.)
DR Series System CLI Reference Guidenetwork --delete
37
Syntaxnetwork --show [--bondif ] [--nwif ] [--hosts] [--routes] [--interface ] --bondif Bond interface(s) to show. --nwif Eth interface(s) to show. --hosts Show local host. --routes Show local routes. --interface Routes for a specific interface.
ResultDevice : bond0Enabled : yesLink : yesBoot protocol : dhcpIP Addr : 10.20.24.55Netmask : 255.255.252.0Gateway : 10.20.32.13MAC Addr : 78:2B:CB:47:D0:08MTU : 1500Bonding options : "mode=balance-alb miimon=100 xmit_hash_policy=2"Slave Interfaces : eth0,eth1,eth2,eth3eth0 MAC : 78:2B:CB:47:D0:08eth0 Max Speed : 1000baseT/Fulleth0 Speed : 1000Mb/seth0 Duplex : Fulleth1 MAC : 00:50:56:93:5A:02eth1 Max Speed : 1000baseT/Fulleth1 Speed : 1000Mb/seth1 Duplex : Fulleth2 MAC : 00:50:56:93:5A:03eth2 Max Speed : 1000baseT/Fulleth2 Speed : 1000Mb/seth2 Duplex : Fulleth3 MAC : 00:50:56:93:5A:04eth3 Max Speed : 1000baseT/Fulleth3 Speed : 1000Mb/seth3 Duplex : FullDNS Suffix : storage.localPrimary Nameserver : 10.25.19.15Secondary Nameserver : 10.25.19.16
network --deleteDescription
The command deletes a network interface.
Syntaxnetwork --delete [--bondif ] [--member ] [--nwif ] --bondif Bond interface(s) to delete. --member Bond member interface(s) to delete. --nwif Eth interface(s) to delete.
For example, to delete network interface eth2, run the command: network --delete --nwif eth2
DR Series System CLI Reference Guidenetwork --setstatic_ip [--bondif ] [--nwif ] --ip --netmask
[--gateway ]38
ResultInterface delete successful. Please restart networking for the changes to take effect.
network --restartDescription
Restarts the current networking configuration for a DR Series system.
Syntaxnetwork --restart
ResultShutting down interface eth0: [ OK ]Shutting down interface eth1: [ OK ]Shutting down interface eth2: [ OK ]Shutting down interface eth3: [ OK ]Shutting down loopback interface: [ OK ]Bringing up loopback interface: [ OK ]Bringing up interface bond0: Determining IP information for bond0... done. [ OK ]DNS Updated hostname: acme11.storage.local
network --setdhcpDescription
Configures the DR Server system to use the dynamic host configuration protocol (DHCP) form of IP addressing.(The options bondif and nwif are only available on a Physical DR.)
Syntaxnetwork --setdhcp [--bondif ] [--nwif ] --bondif Bond interface to create (dhcp). --nwif Eth interface to create (dhcp).
ResultBond device operation successful. Please run 'network --restart' for the changes to take affect.
network --setstatic_ip [--bondif ] [--nwif] --ip --netmask [--gateway ]Description
Configures the DR Series system to use a static IP address and configures the corresponding netmask (and/orthe routing gateway for a DR Series system). The options bondif and nwif are only available on a Physical DR.
DR Series System CLI Reference Guidenetwork --create_bond
39
Syntaxnetwork --setstatic_ip --ip 10.20.20.20 --netmask 255.255.222.0 --gateway 10.25.20.10 --bondif Bond interface to