+ All Categories
Home > Documents > &RPPDQG /LQH ReIHUHQFH Guidesupport-public.cfm.quest.com/43946_DR_Series_System_CLI... ·...

&RPPDQG /LQH ReIHUHQFH Guidesupport-public.cfm.quest.com/43946_DR_Series_System_CLI... ·...

Date post: 18-Mar-2020
Category:
Upload: others
View: 0 times
Download: 0 times
Share this document with a friend
187
R e (Version ) Re Guide
Transcript
  • 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


Recommended