ontap command reference...sep 12, 2016  · metrocluster operation history commands . . 302...

2128
ONTAP Command Reference

Upload: others

Post on 21-Oct-2020

9 views

Category:

Documents


0 download

TRANSCRIPT

  • ONTAP Command Reference

  • First Edition (September 2018)

    © Copyright Lenovo 2018. LENOVO and THINKSYSTEM are trademarks of Lenovo. All other trademarks are the property of their respective owners.

    LIMITED AND RESTRICTED RIGHTS NOTICE: If data or software is delivered pursuant to a General Services Administration (GSA) contract, use, reproduction, or disclosure is subject to restrictions set forth in Contract No. GS-35F- 05925.

  • Contents

    Chapter 1. exit . . . . . . . . . . . . . . 1

    Chapter 2. history . . . . . . . . . . . . 3

    Chapter 3. man . . . . . . . . . . . . . 5

    Chapter 4. redo . . . . . . . . . . . . . 7

    Chapter 5. rows . . . . . . . . . . . . . 9

    Chapter 6. set . . . . . . . . . . . . . 11

    Chapter 7. top . . . . . . . . . . . . . 15

    Chapter 8. up . . . . . . . . . . . . . 17

    Chapter 9. application commands . . 19application create . . . . . . . . . . . . . . 19application delete . . . . . . . . . . . . . . 19application modify . . . . . . . . . . . . . . 20application show . . . . . . . . . . . . . . 21application show-detail . . . . . . . . . . . . 21application show-statistics . . . . . . . . . . 27application show-template . . . . . . . . . . 29application provisioning commands . . . . . . . 30

    application provisioning revert-volume-qos . . 30application provisioning config commands . . 31

    application snapshot commands . . . . . . . . 31application snapshot create . . . . . . . . 31application snapshot delete . . . . . . . . 32application snapshot restore . . . . . . . . 32application snapshot show . . . . . . . . 33

    application volume commands . . . . . . . . . 34application volume remove . . . . . . . . 34application volume show . . . . . . . . . 35

    Chapter 10. autobalance commands . . . . . . . . . . . . . . . 37autobalance aggregate commands . . . . . . . 37

    autobalance aggregate show-aggregate- state . . . . . . . . . . . . . . . . . 37autobalance aggregate show-unbalanced- volume-state . . . . . . . . . . . . . . 39autobalance aggregate config commands. . . 41

    autobalance volume commands . . . . . . . . 43autobalance volume rebalance commands . . 43

    Chapter 11. Cluster Commands. . . . 47cluster add-node . . . . . . . . . . . . . . 47

    cluster add-node-status . . . . . . . . . . . 48cluster create. . . . . . . . . . . . . . . . 49cluster join . . . . . . . . . . . . . . . . . 50cluster modify . . . . . . . . . . . . . . . 50cluster ping-cluster . . . . . . . . . . . . . 51cluster remove-node . . . . . . . . . . . . . 52cluster setup . . . . . . . . . . . . . . . . 53cluster show . . . . . . . . . . . . . . . . 57cluster contact-info commands . . . . . . . . 58

    cluster contact-info modify . . . . . . . . 58cluster contact-info show . . . . . . . . . 59

    cluster date commands. . . . . . . . . . . . 59cluster date modify. . . . . . . . . . . . 59cluster date show . . . . . . . . . . . . 60Manage the timezone zoneinfo files. . . . . . 62

    cluster ha commands . . . . . . . . . . . . 63cluster ha modify . . . . . . . . . . . . 63cluster ha show . . . . . . . . . . . . . 63

    cluster identity commands . . . . . . . . . . 63cluster identity modify . . . . . . . . . . 64cluster identity show . . . . . . . . . . . 64

    cluster image commands . . . . . . . . . . . 65cluster image cancel-update . . . . . . . . 65cluster image pause-update . . . . . . . . 65cluster image resume-update . . . . . . . 65cluster image show . . . . . . . . . . . 66cluster image show-update-history . . . . . 67cluster image show-update-log . . . . . . . 68cluster image show-update-log-detail . . . . 69cluster image show-update-progress . . . . 71cluster image update . . . . . . . . . . . 74cluster image validate . . . . . . . . . . 75cluster image package commands . . . . . 76

    cluster kernel-service commands . . . . . . . . 77cluster kernel-service show . . . . . . . . 78

    cluster log-forwarding commands . . . . . . . 79cluster log-forwarding create . . . . . . . . 79cluster log-forwarding delete . . . . . . . . 80cluster log-forwarding modify . . . . . . . 80cluster log-forwarding show . . . . . . . . 80

    cluster peer commands. . . . . . . . . . . . 81cluster peer create . . . . . . . . . . . . 81cluster peer delete . . . . . . . . . . . . 86cluster peer modify. . . . . . . . . . . . 87cluster peer modify-local-name . . . . . . . 89cluster peer ping. . . . . . . . . . . . . 90

    © Copyright Lenovo 2018 i

  • cluster peer show . . . . . . . . . . . . 91Cluster Peer Connection Commands . . . . 98cluster peer health commands . . . . . . . 99Cluster Peer Offer Commands . . . . . . . 101cluster peer policy commands . . . . . . . 103

    cluster quorum-service commands . . . . . . . 104cluster quorum-service options commands . . . . . . . . . . . . . . . 104

    cluster ring commands . . . . . . . . . . . . 105cluster ring show . . . . . . . . . . . . 105

    Cluster Statistics Commands . . . . . . . . . 106cluster statistics show . . . . . . . . . . 106

    cluster time-service commands . . . . . . . . 108cluster time-service ntp commands . . . . . 108

    Chapter 12. Event Commands . . . . 115event catalog commands . . . . . . . . . . . 115

    event catalog show . . . . . . . . . . . 115event config commands . . . . . . . . . . . 117

    event config force-sync . . . . . . . . . . 117event config modify . . . . . . . . . . . 117event config set-proxy-password . . . . . . 118event config show . . . . . . . . . . . . 119

    event destination commands . . . . . . . . . 120event destination create . . . . . . . . . . 120event destination delete . . . . . . . . . . 121event destination modify . . . . . . . . . 122event destination show . . . . . . . . . . 124

    event filter commands . . . . . . . . . . . . 125event filter copy . . . . . . . . . . . . . 125event filter create . . . . . . . . . . . . 126event filter delete . . . . . . . . . . . . 127event filter rename . . . . . . . . . . . . 128event filter show . . . . . . . . . . . . . 129event filter test . . . . . . . . . . . . . 131event filter rule commands . . . . . . . . . 132

    event log commands . . . . . . . . . . . . . 136event log show . . . . . . . . . . . . . 136

    event mailhistory commands. . . . . . . . . . 139event mailhistory delete . . . . . . . . . . 139event mailhistory show . . . . . . . . . . 140

    event notification commands . . . . . . . . . 141event notification create . . . . . . . . . . 141event notification delete . . . . . . . . . . 142event notification modify . . . . . . . . . 142event notification show . . . . . . . . . . 143event notification destination commands . . . 143event notification history commands . . . . . 148

    event route commands . . . . . . . . . . . . 150event route add-destinations . . . . . . . . 150

    event route modify . . . . . . . . . . . . 151event route remove-destinations . . . . . . 152event route show . . . . . . . . . . . . 152

    event snmphistory commands . . . . . . . . . 154event snmphistory delete . . . . . . . . . 154event snmphistory show . . . . . . . . . 155

    event status commands . . . . . . . . . . . 156event status show . . . . . . . . . . . . 156

    Chapter 13. Job Commands . . . . . 159job delete . . . . . . . . . . . . . . . . . 159job pause . . . . . . . . . . . . . . . . . 159job resume. . . . . . . . . . . . . . . . . 160job show . . . . . . . . . . . . . . . . . 160job show-bynode . . . . . . . . . . . . . . 162job show-cluster . . . . . . . . . . . . . . 163job show-completed . . . . . . . . . . . . . 165job stop . . . . . . . . . . . . . . . . . . 167job unclaim . . . . . . . . . . . . . . . . 167job watch-progress . . . . . . . . . . . . . 168job history commands . . . . . . . . . . . . 168

    job history show . . . . . . . . . . . . . 168job initstate commands . . . . . . . . . . . . 170

    job initstate show . . . . . . . . . . . . 170job private commands . . . . . . . . . . . . 171

    job private delete . . . . . . . . . . . . 172job private pause . . . . . . . . . . . . 172job private resume . . . . . . . . . . . . 173job private show . . . . . . . . . . . . . 173job private show-completed . . . . . . . . 175job private stop . . . . . . . . . . . . . 177job private watch-progress . . . . . . . . 177

    job schedule commands . . . . . . . . . . . 178job schedule delete . . . . . . . . . . . 178job schedule show . . . . . . . . . . . . 178job schedule show-jobs . . . . . . . . . . 179job schedule cron commands . . . . . . . 180job schedule interval commands . . . . . . 183

    Chapter 14. lun commands . . . . . . 187lun create . . . . . . . . . . . . . . . . . 187lun delete . . . . . . . . . . . . . . . . . 190lun maxsize . . . . . . . . . . . . . . . . 190lun modify . . . . . . . . . . . . . . . . . 192lun move-in-volume . . . . . . . . . . . . . 195lun resize . . . . . . . . . . . . . . . . . 196lun show . . . . . . . . . . . . . . . . . 197lun bind commands . . . . . . . . . . . . . 202

    lun bind create . . . . . . . . . . . . . 202lun bind destroy . . . . . . . . . . . . . 202

    ii ONTAP Command Reference

  • lun bind show . . . . . . . . . . . . . . 203Manage Lun Copy Operations . . . . . . . . . 204

    lun copy cancel . . . . . . . . . . . . . 204lun copy modify . . . . . . . . . . . . . 205lun copy pause . . . . . . . . . . . . . 205lun copy resume. . . . . . . . . . . . . 206lun copy show . . . . . . . . . . . . . 206lun copy start . . . . . . . . . . . . . . 208

    lun igroup commands . . . . . . . . . . . . 209lun igroup add . . . . . . . . . . . . . 209lun igroup bind . . . . . . . . . . . . . 209lun igroup create . . . . . . . . . . . . 210lun igroup delete. . . . . . . . . . . . . 211lun igroup disable-aix-support . . . . . . . 212lun igroup modify . . . . . . . . . . . . 212lun igroup remove . . . . . . . . . . . . 213lun igroup rename . . . . . . . . . . . . 213lun igroup show . . . . . . . . . . . . . 214lun igroup unbind . . . . . . . . . . . . 215

    lun import commands . . . . . . . . . . . . 216lun import create . . . . . . . . . . . . 216lun import delete . . . . . . . . . . . . 216lun import pause. . . . . . . . . . . . . 217lun import prepare-to-downgrade . . . . . . 218lun import resume . . . . . . . . . . . . 218lun import show . . . . . . . . . . . . . 218lun import start . . . . . . . . . . . . . 221lun import stop . . . . . . . . . . . . . 221lun import throttle . . . . . . . . . . . . 222lun import verify commands . . . . . . . . 222

    lun mapping commands . . . . . . . . . . . 223lun mapping add-reporting-nodes . . . . . . 223lun mapping create. . . . . . . . . . . . 224lun mapping delete. . . . . . . . . . . . 225lun mapping remove-reporting-nodes . . . . 226lun mapping show . . . . . . . . . . . . 227lun mapping show-initiator. . . . . . . . . 228

    Manage Lun Move Operations . . . . . . . . . 229lun move cancel . . . . . . . . . . . . . 230lun move modify . . . . . . . . . . . . . 230lun move pause . . . . . . . . . . . . . 231lun move resume . . . . . . . . . . . . 231lun move show . . . . . . . . . . . . . 231lun move start. . . . . . . . . . . . . . 233

    lun persistent-reservation commands . . . . . . 234lun persistent-reservation clear . . . . . . . 234lun persistent-reservation show . . . . . . . 234

    lun portset commands . . . . . . . . . . . . 236lun portset add . . . . . . . . . . . . . 236lun portset create . . . . . . . . . . . . 237

    lun portset delete . . . . . . . . . . . . 237lun portset remove . . . . . . . . . . . . 238lun portset show. . . . . . . . . . . . . 238

    lun transition commands . . . . . . . . . . . 240lun transition show . . . . . . . . . . . . 240lun transition start . . . . . . . . . . . . 241lun transition 7-mode commands . . . . . . 241

    Chapter 15. metrocluster commands . . . . . . . . . . . . . . . 245metrocluster configure . . . . . . . . . . . . 245metrocluster heal . . . . . . . . . . . . . . 247metrocluster modify . . . . . . . . . . . . . 248metrocluster show. . . . . . . . . . . . . . 249metrocluster switchback . . . . . . . . . . . 250metrocluster switchover . . . . . . . . . . . 251metrocluster check commands. . . . . . . . . 252

    metrocluster check disable-periodic- check . . . . . . . . . . . . . . . . . 252metrocluster check enable-periodic-check . . 252metrocluster check run . . . . . . . . . . 252metrocluster check show . . . . . . . . . 254metrocluster check aggregate commands. . . 256metrocluster check cluster commands . . . . 259metrocluster check config-replication commands . . . . . . . . . . . . . . . 261metrocluster check connection commands . . . . . . . . . . . . . . . 263metrocluster check lif commands . . . . . . 265metrocluster check node commands. . . . . 268

    metrocluster config-replication commands . . . . 272metrocluster config-replication cluster- storage-configuration commands . . . . . . 273metrocluster config-replication resync-status commands . . . . . . . . . . . . . . . 274

    metrocluster configuration-settings commands . . 274metrocluster configuration-settings show- status . . . . . . . . . . . . . . . . . 274metrocluster configuration-settings connection commands . . . . . . . . . . 276metrocluster configuration-settings dr-group commands . . . . . . . . . . . . . . . 283metrocluster configuration-settings interface commands . . . . . . . . . . . . . . . 286

    metrocluster interconnect commands . . . . . . 291metrocluster interconnect adapter commands . . . . . . . . . . . . . . . 291metrocluster interconnect mirror commands . . . . . . . . . . . . . . . 296

    metrocluster node commands . . . . . . . . . 298metrocluster node show. . . . . . . . . . 298

    metrocluster operation commands . . . . . . . 301metrocluster operation show . . . . . . . . 301

    © Copyright Lenovo 2018 iii

  • metrocluster operation history commands . . 302metrocluster vserver commands . . . . . . . . 303

    metrocluster vserver recover-from-partial- switchback . . . . . . . . . . . . . . . 303metrocluster vserver recover-from-partial- switchover . . . . . . . . . . . . . . . 304metrocluster vserver resync . . . . . . . . 304metrocluster vserver show . . . . . . . . . 304

    Chapter 16. Network Commands . . . 307network ping . . . . . . . . . . . . . . . . 307network ping6 . . . . . . . . . . . . . . . 308network test-path . . . . . . . . . . . . . . 309network traceroute . . . . . . . . . . . . . 310network traceroute6 . . . . . . . . . . . . . 311network arp commands. . . . . . . . . . . . 313

    network arp create . . . . . . . . . . . . 313network arp delete . . . . . . . . . . . . 313network arp show . . . . . . . . . . . . 314network arp active-entry commands . . . . . 314

    network cloud commands. . . . . . . . . . . 316network cloud routing-table commands . . . 316

    network connections commands . . . . . . . . 316network connections active commands. . . . 317network connections listening commands. . . 322

    network device-discovery commands . . . . . . 324network device-discovery show. . . . . . . 324

    network fcp commands. . . . . . . . . . . . 326network fcp adapter commands . . . . . . 326network fcp topology commands . . . . . . 330network fcp zone commands. . . . . . . . 332

    network interface commands . . . . . . . . . 333network interface create. . . . . . . . . . 333network interface delete. . . . . . . . . . 336network interface migrate . . . . . . . . . 336network interface migrate-all . . . . . . . . 337network interface modify . . . . . . . . . 338network interface rename . . . . . . . . . 340network interface revert . . . . . . . . . . 341network interface show . . . . . . . . . . 341network interface start-cluster-check . . . . 345network interface capacity commands . . . . 345network interface check commands . . . . . 347network interface dns-lb-stats commands . . 348network interface failover-groups commands . . . . . . . . . . . . . . . 350network interface lif-weights commands . . . 353

    network ipspace commands . . . . . . . . . . 354network ipspace create . . . . . . . . . . 354network ipspace delete . . . . . . . . . . 354network ipspace rename . . . . . . . . . 355

    network ipspace show . . . . . . . . . . 355network ndp commands . . . . . . . . . . . 356

    network ndp default-router commands . . . . 356network ndp neighbor commands . . . . . . 357network ndp prefix commands . . . . . . . 361

    network options commands . . . . . . . . . . 362network options cluster-health-notifications commands . . . . . . . . . . . . . . . 362network options detect-switchless-cluster commands . . . . . . . . . . . . . . . 363network options ipv6 commands . . . . . . 364network options load-balancing commands . . . . . . . . . . . . . . . 365network options port-health-monitor commands . . . . . . . . . . . . . . . 366network options send-soa commands . . . . 368network options switchless-cluster commands . . . . . . . . . . . . . . . 369

    network port commands . . . . . . . . . . . 370network port delete . . . . . . . . . . . 370network port modify . . . . . . . . . . . 370network port show . . . . . . . . . . . . 372network port show-address-filter-info . . . . 374Manage broadcast domains . . . . . . . . 375network port ifgrp commands . . . . . . . 380network port vlan commands. . . . . . . . 383

    network qos-marking commands . . . . . . . . 385network qos-marking modify . . . . . . . . 385network qos-marking show . . . . . . . . 386

    network route commands . . . . . . . . . . . 387network route create . . . . . . . . . . . 387network route delete . . . . . . . . . . . 387network route show . . . . . . . . . . . 388network route show-lifs . . . . . . . . . . 389network route active-entry commands . . . . 389

    network routing-groups commands . . . . . . . 391network routing-groups create . . . . . . . 391network routing-groups delete . . . . . . . 392network routing-groups show . . . . . . . 392network routing-groups route commands . . . 393

    network subnet commands . . . . . . . . . . 395network subnet add-ranges . . . . . . . . 395network subnet create . . . . . . . . . . 396network subnet delete . . . . . . . . . . 397network subnet modify . . . . . . . . . . 397network subnet remove-ranges . . . . . . . 398network subnet rename . . . . . . . . . . 398network subnet show . . . . . . . . . . . 399

    network tcpdump commands . . . . . . . . . 400network tcpdump show . . . . . . . . . . 400network tcpdump start . . . . . . . . . . 401

    iv ONTAP Command Reference

  • network tcpdump stop . . . . . . . . . . 401network tcpdump trace commands . . . . . 402

    network test-link commands . . . . . . . . . . 403network test-link run-test . . . . . . . . . 403network test-link show . . . . . . . . . . 404network test-link start-server . . . . . . . . 405network test-link stop-server . . . . . . . . 405

    network tuning commands . . . . . . . . . . 406network tuning icmp6 commands . . . . . . 406network tuning tcp commands . . . . . . . 407network tuning icmp commands . . . . . . 408

    Chapter 17. protection-type commands . . . . . . . . . . . . . . . 411protection-type show . . . . . . . . . . . . 411

    Chapter 18. qos commands . . . . . . 413qos adaptive-policy-group commands . . . . . . 413

    qos adaptive-policy-group create . . . . . . 413qos adaptive-policy-group delete . . . . . . 414qos adaptive-policy-group modify . . . . . . 414qos adaptive-policy-group rename . . . . . 415qos adaptive-policy-group show . . . . . . 416

    qos policy-group commands . . . . . . . . . 417qos policy-group create . . . . . . . . . . 417qos policy-group delete . . . . . . . . . . 418qos policy-group modify . . . . . . . . . 419qos policy-group rename . . . . . . . . . 420qos policy-group show . . . . . . . . . . 420

    qos settings commands . . . . . . . . . . . 421qos settings cache commands . . . . . . . 421

    qos statistics commands . . . . . . . . . . . 423qos statistics resource commands . . . . . 423qos statistics volume commands . . . . . . 426qos statistics workload commands . . . . . 433qos statistics characteristics commands . . . 442qos statistics latency commands . . . . . . 443qos statistics performance commands . . . . 445

    qos workload commands . . . . . . . . . . . 446qos workload show . . . . . . . . . . . 446

    Chapter 19. Security Commands . . . 449security snmpusers . . . . . . . . . . . . . 449security audit commands . . . . . . . . . . . 450

    security audit modify . . . . . . . . . . . 450security audit show . . . . . . . . . . . 451security audit log commands . . . . . . . . 451

    Show Commands . . . . . . . . . . . . . . 452security certificate create . . . . . . . . . 452security certificate delete . . . . . . . . . 453

    security certificate generate-csr. . . . . . . 454security certificate install . . . . . . . . . 456security certificate show. . . . . . . . . . 458security certificate show-generated . . . . . 460security certificate show-truststore . . . . . 461security certificate show-user-installed . . . . 463security certificate sign . . . . . . . . . . 465security certificate ca-issued commands . . . 467Show Commands . . . . . . . . . . . . 469

    security config commands . . . . . . . . . . 471security config modify . . . . . . . . . . 471security config show . . . . . . . . . . . 472security config ocsp commands . . . . . . 473security config status commands . . . . . . 476

    security key-manager commands . . . . . . . . 477security key-manager add . . . . . . . . . 477security key-manager create-key . . . . . . 477security key-manager delete . . . . . . . . 479security key-manager delete-key- database . . . . . . . . . . . . . . . 479security key-manager delete-kmip-config . . . 480security key-manager prepare-to- downgrade . . . . . . . . . . . . . . . 480security key-manager query . . . . . . . . 480security key-manager restore. . . . . . . . 482security key-manager setup . . . . . . . . 484security key-manager show . . . . . . . . 486security key-manager update-passphrase . . 486security key-manager backup commands. . . 487security key-manager certificate commands . . . . . . . . . . . . . . . 488security key-manager config commands . . . 489security key-manager key commands . . . . 490

    security login commands . . . . . . . . . . . 491security login create . . . . . . . . . . . 491security login delete . . . . . . . . . . . 494security login expire-password . . . . . . . 495security login lock . . . . . . . . . . . . 495security login modify . . . . . . . . . . . 496security login password . . . . . . . . . . 497security login password-prepare-to- downgrade . . . . . . . . . . . . . . . 498security login show. . . . . . . . . . . . 499security login unlock . . . . . . . . . . . 501security login whoami. . . . . . . . . . . 501SSH login banner . . . . . . . . . . . . 502security login domain-tunnel commands . . . 503security login motd commands . . . . . . . 505security login publickey commands . . . . . 507security login role commands . . . . . . . 510

    security protocol commands. . . . . . . . . . 519

    © Copyright Lenovo 2018 v

  • security protocol modify. . . . . . . . . . 519security protocol show . . . . . . . . . . 519security protocol ssh commands . . . . . . 520

    Manage SAML authentication single sign-on configuration . . . . . . . . . . . . . . . . 521

    security saml-sp create . . . . . . . . . . 521security saml-sp delete . . . . . . . . . . 522security saml-sp modify . . . . . . . . . . 523security saml-sp repair . . . . . . . . . . 523security saml-sp show . . . . . . . . . . 524security saml-sp status commands . . . . . 524

    Security Session Commands . . . . . . . . . 525security session kill-cli . . . . . . . . . . 525security session show . . . . . . . . . . 527Security Session Limit Commands . . . . . 529Security Session Request-Statistics Commands. . . . . . . . . . . . . . . 542

    security ssh commands. . . . . . . . . . . . 553security ssh add . . . . . . . . . . . . . 553security ssh modify . . . . . . . . . . . 554security ssh prepare-to-downgrade . . . . . 554security ssh remove . . . . . . . . . . . 555security ssh show . . . . . . . . . . . . 556

    Virutal Server SSL Management . . . . . . . . 557security ssl modify . . . . . . . . . . . . 557security ssl show . . . . . . . . . . . . 559

    Chapter 20. SnapLock Commands. . . . . . . . . . . . . . . 561SnapLock Clock commands . . . . . . . . . . 561

    snaplock compliance-clock initialize . . . . . 561snaplock compliance-clock show . . . . . . 562snaplock compliance-clock ntp commands . . . . . . . . . . . . . . . 563

    snaplock event-retention commands . . . . . . 564snaplock event-retention abort . . . . . . . 564snaplock event-retention apply . . . . . . . 564snaplock event-retention show . . . . . . . 565snaplock event-retention show-vservers . . . 566snaplock event-retention policy commands . . . . . . . . . . . . . . . 567

    snaplock legal-hold commands . . . . . . . . 569snaplock legal-hold abort . . . . . . . . . 569snaplock legal-hold begin . . . . . . . . . 570snaplock legal-hold dump-files . . . . . . . 570snaplock legal-hold dump-litigations . . . . . 571snaplock legal-hold end . . . . . . . . . . 572snaplock legal-hold show . . . . . . . . . 573

    SnapLock Log commands . . . . . . . . . . 574snaplock log create . . . . . . . . . . . 575snaplock log delete . . . . . . . . . . . 575

    snaplock log modify . . . . . . . . . . . 576snaplock log show . . . . . . . . . . . . 576SnapLock Log File commands . . . . . . . 577

    Chapter 21. SnapMirror Commands. . . . . . . . . . . . . . . 581snapmirror abort . . . . . . . . . . . . . . 581snapmirror break . . . . . . . . . . . . . . 584snapmirror create . . . . . . . . . . . . . . 586snapmirror delete . . . . . . . . . . . . . . 592snapmirror initialize . . . . . . . . . . . . . 594snapmirror initialize-ls-set . . . . . . . . . . . 599snapmirror list-destinations . . . . . . . . . . 600snapmirror modify . . . . . . . . . . . . . . 604snapmirror promote . . . . . . . . . . . . . 607snapmirror protect. . . . . . . . . . . . . . 608snapmirror quiesce . . . . . . . . . . . . . 610snapmirror release. . . . . . . . . . . . . . 611snapmirror restore . . . . . . . . . . . . . . 613snapmirror resume . . . . . . . . . . . . . 620snapmirror resync . . . . . . . . . . . . . . 622snapmirror set-options . . . . . . . . . . . . 627snapmirror show . . . . . . . . . . . . . . 628snapmirror show-history . . . . . . . . . . . 650snapmirror update . . . . . . . . . . . . . . 655snapmirror update-ls-set . . . . . . . . . . . 659snapmirror config-replication commands . . . . . 660

    snapmirror config-replication cluster-storage- configuration commands . . . . . . . . . 660snapmirror config-replication status commands . . . . . . . . . . . . . . . 661

    snapmirror policy commands . . . . . . . . . 664snapmirror policy add-rule . . . . . . . . . 664snapmirror policy create. . . . . . . . . . 666snapmirror policy delete. . . . . . . . . . 667snapmirror policy modify . . . . . . . . . 668snapmirror policy modify-rule . . . . . . . 669snapmirror policy remove-rule . . . . . . . 670snapmirror policy show . . . . . . . . . . 671

    snapmirror snapshot-owner commands . . . . . 673snapmirror snapshot-owner create . . . . . 673snapmirror snapshot-owner delete . . . . . 674snapmirror snapshot-owner show . . . . . . 674

    Chapter 22. statistics-v1 commands . . . . . . . . . . . . . . . 677statistics-v1 nfs commands . . . . . . . . . . 677

    statistics-v1 nfs show-mount . . . . . . . . 677statistics-v1 nfs show-nlm . . . . . . . . . 678statistics-v1 nfs show-statusmon . . . . . . 680statistics-v1 nfs show-v3 . . . . . . . . . 682

    vi ONTAP Command Reference

  • statistics-v1 nfs show-v4 . . . . . . . . . 688statistics-v1 protocol-request-size commands. . . 697

    statistics-v1 protocol-request-size show . . . 697

    Chapter 23. Statistics Commands. . . . . . . . . . . . . . . 701statistics show . . . . . . . . . . . . . . . 701statistics show-periodic . . . . . . . . . . . 703statistics start . . . . . . . . . . . . . . . 705statistics stop . . . . . . . . . . . . . . . 707statistics aggregate commands . . . . . . . . 707

    statistics aggregate show . . . . . . . . . 707statistics cache commands . . . . . . . . . . 708

    statistics cache flash-pool commands . . . . 708statistics catalog directory . . . . . . . . . . 709

    statistics catalog instance commands . . . . 709statistics catalog object commands . . . . . 710statistics catalog counter commands . . . . 711

    statistics disk commands . . . . . . . . . . . 712statistics disk show . . . . . . . . . . . 712

    statistics lif commands . . . . . . . . . . . . 713statistics lif show . . . . . . . . . . . . 713

    statistics lun commands . . . . . . . . . . . 714statistics lun show . . . . . . . . . . . . 714

    statistics namespace commands . . . . . . . . 715statistics namespace show . . . . . . . . 715

    statistics nfs commands . . . . . . . . . . . 716statistics nfs show-mount . . . . . . . . . 716statistics nfs show-nlm . . . . . . . . . . 718statistics nfs show-statusmon . . . . . . . 720statistics nfs show-v3. . . . . . . . . . . 722statistics nfs show-v4. . . . . . . . . . . 727

    statistics oncrpc commands . . . . . . . . . . 737statistics oncrpc show-rpc-calls . . . . . . 737

    statistics node commands . . . . . . . . . . 738statistics node show . . . . . . . . . . . 738

    statistics port commands . . . . . . . . . . . 739statistics port fcp commands. . . . . . . . 739

    Performance Preset configuration directory . . . . 740statistics preset delete . . . . . . . . . . 740statistics preset modify . . . . . . . . . . 742statistics preset show. . . . . . . . . . . 743Performance Preset Detail directory . . . . . 743

    statistics settings commands . . . . . . . . . 744statistics settings modify . . . . . . . . . 744statistics settings show . . . . . . . . . . 745

    statistics samples directory . . . . . . . . . . 745statistics samples delete . . . . . . . . . 745statistics samples show . . . . . . . . . . 746

    statistics system commands . . . . . . . . . . 747

    statistics system show . . . . . . . . . . 747statistics top commands . . . . . . . . . . . 747

    statistics top client commands . . . . . . . 747statistics top file commands . . . . . . . . 748

    statistics volume commands. . . . . . . . . . 749statistics volume show . . . . . . . . . . 749

    statistics vserver commands. . . . . . . . . . 750statistics vserver show . . . . . . . . . . 750

    statistics workload commands . . . . . . . . . 751statistics workload show . . . . . . . . . 751

    Chapter 24. storage-service commands . . . . . . . . . . . . . . . 753storage-service show . . . . . . . . . . . . 753

    Chapter 25. Storage Commands . . . 755Storage aggregate Commands . . . . . . . . . 755

    storage aggregate add-disks . . . . . . . . 756storage aggregate auto-provision . . . . . . 759storage aggregate create . . . . . . . . . 760storage aggregate delete . . . . . . . . . 763storage aggregate mirror . . . . . . . . . 764storage aggregate modify . . . . . . . . . 765storage aggregate offline . . . . . . . . . 768storage aggregate online . . . . . . . . . 768storage aggregate remove-stale-record . . . 768storage aggregate rename . . . . . . . . . 769storage aggregate restrict . . . . . . . . . 769storage aggregate scrub . . . . . . . . . 770storage aggregate show. . . . . . . . . . 771storage aggregate show-auto-provision- progress . . . . . . . . . . . . . . . . 779storage aggregate show-cumulated- efficiency . . . . . . . . . . . . . . . 780storage aggregate show-efficiency . . . . . 784storage aggregate show-resync-status . . . . 787storage aggregate show-scrub-status . . . . 788storage aggregate show-space . . . . . . . 789storage aggregate show-spare-disks . . . . 793storage aggregate show-status . . . . . . . 798storage aggregate verify. . . . . . . . . . 799storage aggregate efficiency commands . . . 800storage aggregate inode-upgrade commands . . . . . . . . . . . . . . . 804storage aggregate object-store commands . . . . . . . . . . . . . . . 806storage aggregate plex commands . . . . . 817storage aggregate reallocation commands . . 820Storage Aggregate Relocation Commands . . 824Storage Aggregate Resynchronization Commands. . . . . . . . . . . . . . . 825

    © Copyright Lenovo 2018 vii

  • storage array commands . . . . . . . . . . . 829storage array modify . . . . . . . . . . . 829storage array remove . . . . . . . . . . . 830storage array rename . . . . . . . . . . . 830storage array show. . . . . . . . . . . . 831storage array config commands. . . . . . . 832storage array disk commands . . . . . . . 834storage array port commands . . . . . . . 837

    storage automated-working-set-analyzer commands. . . . . . . . . . . . . . . . . 840

    storage automated-working-set-analyzer show . . . . . . . . . . . . . . . . . 840storage automated-working-set-analyzer start . . . . . . . . . . . . . . . . . 842storage automated-working-set-analyzer stop . . . . . . . . . . . . . . . . . 843storage automated-working-set-analyzer volume commands. . . . . . . . . . . . 843

    storage bridge commands . . . . . . . . . . 845storage bridge add . . . . . . . . . . . . 845storage bridge modify . . . . . . . . . . 845storage bridge refresh . . . . . . . . . . 846storage bridge remove . . . . . . . . . . 846storage bridge show . . . . . . . . . . . 847storage bridge config-dump commands . . . 859storage bridge coredump commands . . . . 862storage bridge firmware commands . . . . . 864

    storage disk commands . . . . . . . . . . . 864storage disk assign . . . . . . . . . . . 864storage disk fail . . . . . . . . . . . . . 867storage disk reassign . . . . . . . . . . . 868storage disk refresh-ownership . . . . . . . 868storage disk remove . . . . . . . . . . . 869storage disk remove-reservation . . . . . . 869storage disk removeowner . . . . . . . . . 870storage disk replace . . . . . . . . . . . 870storage disk set-foreign-lun . . . . . . . . 872storage disk set-led . . . . . . . . . . . 872storage disk show . . . . . . . . . . . . 874storage disk unfail . . . . . . . . . . . . 889storage disk updatefirmware . . . . . . . . 890storage disk zerospares . . . . . . . . . . 890storage disk error commands . . . . . . . 891storage disk firmware commands . . . . . . 892Storage disk option Command . . . . . . . 898

    storage encryption commands . . . . . . . . . 900storage encryption disk commands . . . . . 900

    storage errors commands . . . . . . . . . . . 909storage errors show . . . . . . . . . . . 909

    storage failover commands . . . . . . . . . . 909storage failover giveback . . . . . . . . . 910

    storage failover modify . . . . . . . . . . 911storage failover show . . . . . . . . . . . 913storage failover show-giveback . . . . . . . 927storage failover show-takeover . . . . . . . 928storage failover takeover . . . . . . . . . 931storage failover hwassist commands. . . . . 932storage failover internal-options commands . . . . . . . . . . . . . . . 936storage failover mailbox-disk commands . . . 939storage failover progress-table commands . . 940

    storage firmware commands. . . . . . . . . . 941storage firmware download . . . . . . . . 941storage firmware acp commands . . . . . . 942storage firmware disk commands . . . . . . 944storage firmware shelf commands . . . . . . 945

    storage iscsi-initiator commands . . . . . . . . 947storage iscsi-initiator add-target . . . . . . 947storage iscsi-initiator connect . . . . . . . 948storage iscsi-initiator disconnect . . . . . . 948storage iscsi-initiator remove-target . . . . . 949storage iscsi-initiator show . . . . . . . . 949

    storage load commands . . . . . . . . . . . 950storage load balance . . . . . . . . . . . 950storage load show . . . . . . . . . . . . 951

    storage path commands . . . . . . . . . . . 952storage path quiesce . . . . . . . . . . . 952storage path resume . . . . . . . . . . . 953storage path show . . . . . . . . . . . . 953storage path show-by-initiator . . . . . . . 957

    Storage pool Commands . . . . . . . . . . . 958storage pool add . . . . . . . . . . . . 959storage pool create . . . . . . . . . . . 960storage pool delete . . . . . . . . . . . 962storage pool reassign. . . . . . . . . . . 962storage pool show . . . . . . . . . . . . 963storage pool show-aggregate . . . . . . . 965storage pool show-available-capacity . . . . 966storage pool show-disks . . . . . . . . . 967

    Storage Port Commands . . . . . . . . . . . 968storage port disable . . . . . . . . . . . 968storage port enable . . . . . . . . . . . 969storage port rescan . . . . . . . . . . . 969storage port reset . . . . . . . . . . . . 970storage port reset-device . . . . . . . . . 970storage port show . . . . . . . . . . . . 971

    Storage raid-options Commands . . . . . . . . 974storage raid-options modify . . . . . . . . 978storage raid-options show . . . . . . . . . 978

    storage shelf commands . . . . . . . . . . . 979storage shelf show . . . . . . . . . . . . 979

    viii ONTAP Command Reference

  • Storage ACP Commands . . . . . . . . . 994storage shelf drawer commands . . . . . 1000storage shelf firmware commands . . . . . 1007storage shelf location-led commands . . . 1008

    storage switch commands . . . . . . . . . 1010storage switch add. . . . . . . . . . . 1010storage switch modify . . . . . . . . . 1011storage switch refresh . . . . . . . . . 1012storage switch remove . . . . . . . . . 1012storage switch show . . . . . . . . . . 1013

    storage tape commands . . . . . . . . . . 1031storage tape offline. . . . . . . . . . . 1031storage tape online. . . . . . . . . . . 1032storage tape position . . . . . . . . . . 1032storage tape reset . . . . . . . . . . . 1033storage tape show . . . . . . . . . . . 1034storage tape show-errors . . . . . . . . 1037storage tape show-media-changer . . . . 1038storage tape show-supported-status. . . . 1040storage tape show-tape-drive . . . . . . 1041storage tape trace . . . . . . . . . . . 1042storage tape alias commands . . . . . . 1043storage tape config-file commands . . . . 1045storage tape library commands . . . . . . 1047storage tape load-balance commands . . . 1051

    Chapter 26. System Commands . . 1053system cluster-switch commands. . . . . . . 1053

    system cluster-switch create . . . . . . . 1053system cluster-switch delete . . . . . . . 1054system cluster-switch modify . . . . . . 1054system cluster-switch prepare-to- downgrade . . . . . . . . . . . . . . 1055system cluster-switch show . . . . . . . 1055system cluster-switch show-all . . . . . . 1057system cluster-switch log commands . . . 1058system cluster-switch polling-interval commands . . . . . . . . . . . . . . 1061system cluster-switch threshold commands . . . . . . . . . . . . . . 1061

    system chassis commands . . . . . . . . . 1062system chassis show . . . . . . . . . . 1062system chassis fru commands . . . . . . 1063

    system controller commands . . . . . . . . 1065system controller show . . . . . . . . . 1065system controller bootmedia commands . . 1066system controller clus-flap-threshold commands . . . . . . . . . . . . . . 1069system controller config commands . . . . 1069system controller environment commands . . . . . . . . . . . . . . 1074

    system controller flash-cache commands . . 1076system controller fru commands . . . . . 1078system controller ioxm commands . . . . 1085system controller location-led commands . . . . . . . . . . . . . . 1087system controller memory commands . . . 1088system controller nvram-bb-threshold commands . . . . . . . . . . . . . . 1089system controller pci commands . . . . . 1090system controller pcicerr commands. . . . 1091system controller platform-capability commands . . . . . . . . . . . . . . 1092system controller service-event commands . . . . . . . . . . . . . . 1093system controller slot commands . . . . . 1095system controller sp commands . . . . . 1097

    system configuration commands . . . . . . . 1100system configuration backup commands . . 1100system configuration recovery commands . . . . . . . . . . . . . . 1106

    system feature-usage commands. . . . . . . 1109system feature-usage show-history . . . . 1109system feature-usage show-summary . . . 1110

    system fru-check commands . . . . . . . . 1111system fru-check show . . . . . . . . . 1111

    system ha commands . . . . . . . . . . . 1112High-Availability interconnect device nic reset . . . . . . . . . . . . . . . . 1112

    system health commands . . . . . . . . . . 1126system health alert commands . . . . . . 1126system health autosupport commands . . . 1131system health config commands . . . . . 1133system health policy commands . . . . . 1134system health status commands . . . . . 1136system health subsystem commands . . . 1137

    system license commands . . . . . . . . . 1138system license add. . . . . . . . . . . 1138system license clean-up. . . . . . . . . 1138system license delete . . . . . . . . . . 1139system license show . . . . . . . . . . 1140system license show-status . . . . . . . 1141system license capacity commands . . . . 1142system license entitlement-risk commands . . . . . . . . . . . . . . 1143system license status commands . . . . . 1145

    system node commands . . . . . . . . . . 1146system node halt . . . . . . . . . . . 1146system node migrate-root . . . . . . . . 1147system node modify . . . . . . . . . . 1148system node reboot . . . . . . . . . . 1149system node rename . . . . . . . . . . 1150

    © Copyright Lenovo 2018 ix

  • system node restore-backup . . . . . . . 1150system node revert-to . . . . . . . . . 1151system node run. . . . . . . . . . . . 1151system node run-console . . . . . . . . 1153system node show . . . . . . . . . . . 1153system node show-discovered . . . . . . 1155system node show-memory-errors . . . . 1156system node autosupport commands . . . 1158system node coredump commands . . . . 1180system node environment commands . . . 1196system node external-cache commands . . 1199system node firmware commands . . . . . 1201system node hardware commands . . . . 1202system node image commands . . . . . . 1207system node internal-switch commands . . 1214system node nfs commands . . . . . . . 1216system node power commands. . . . . . 1217system node root-mount commands. . . . 1218system node upgrade-revert commands . . 1220system node virtual-machine commands . . 1222

    system script commands . . . . . . . . . . 1231system script delete . . . . . . . . . . 1231system script show . . . . . . . . . . 1232system script start . . . . . . . . . . . 1233system script stop . . . . . . . . . . . 1233system script upload . . . . . . . . . . 1234

    system service-processor commands . . . . . 1234system service-processor reboot-sp . . . . 1234system service-processor show . . . . . 1235system service-processor api-service commands . . . . . . . . . . . . . . 1236system service-processor image commands . . . . . . . . . . . . . . 1238system service-processor log commands . . 1242system service-processor network commands . . . . . . . . . . . . . . 1243system service-processor ssh commands . . . . . . . . . . . . . . 1252

    system services commands . . . . . . . . . 1254system services firewall commands . . . . 1254system services manager commands . . . 1259system services ndmp commands. . . . . 1263Manage Web Protocols . . . . . . . . . 1280

    SMTape Commands . . . . . . . . . . . . 1283system smtape abort . . . . . . . . . . 1283system smtape backup . . . . . . . . . 1284system smtape break . . . . . . . . . . 1285system smtape continue . . . . . . . . 1285system smtape restore . . . . . . . . . 1286system smtape showheader . . . . . . . 1287system smtape status commands . . . . . 1288

    system status commands . . . . . . . . . . 1291system status show . . . . . . . . . . 1291

    system snmp commands . . . . . . . . . . 1293system snmp authtrap . . . . . . . . . 1293system snmp contact . . . . . . . . . . 1293system snmp enable-snmpv3 . . . . . . 1294system snmp init . . . . . . . . . . . 1294system snmp location . . . . . . . . . 1295system snmp prepare-to-downgrade . . . 1296system snmp show . . . . . . . . . . 1296system snmp community commands . . . 1296system snmp traphost commands. . . . . 1298

    system timeout commands . . . . . . . . . 1300system timeout modify . . . . . . . . . 1300system timeout show . . . . . . . . . . 1300

    Chapter 27. Template Commands. . . . . . . . . . . . . . 1301template copy . . . . . . . . . . . . . . 1301template delete . . . . . . . . . . . . . . 1301template download . . . . . . . . . . . . 1301template provision . . . . . . . . . . . . . 1302template rename . . . . . . . . . . . . . 1303template show . . . . . . . . . . . . . . 1303template show-permissions . . . . . . . . . 1305template upload. . . . . . . . . . . . . . 1305Template Parameter Commands . . . . . . . 1306

    template parameter modify . . . . . . . 1306template parameter show . . . . . . . . 1306

    Chapter 28. Volume Commands . . 1309volume autosize. . . . . . . . . . . . . . 1309volume create . . . . . . . . . . . . . . 1310volume delete . . . . . . . . . . . . . . 1318volume expand . . . . . . . . . . . . . . 1319volume make-vsroot . . . . . . . . . . . . 1320volume modify . . . . . . . . . . . . . . 1321volume mount . . . . . . . . . . . . . . 1330volume offline . . . . . . . . . . . . . . 1331volume online . . . . . . . . . . . . . . 1331volume rehost . . . . . . . . . . . . . . 1332volume rename . . . . . . . . . . . . . . 1333volume restrict . . . . . . . . . . . . . . 1333volume show . . . . . . . . . . . . . . . 1334volume show-footprint . . . . . . . . . . . 1351volume show-space . . . . . . . . . . . . 1356volume size . . . . . . . . . . . . . . . 1361volume transition-prepare-to-downgrade . . . . 1362volume unmount . . . . . . . . . . . . . 1362volume aggregate commands . . . . . . . . 1362

    x ONTAP Command Reference

  • volume aggregate vacate . . . . . . . . 1363volume clone commands . . . . . . . . . . 1363

    volume clone create . . . . . . . . . . 1363volume clone show. . . . . . . . . . . 1366volume clone sharing-by-split commands . . . . . . . . . . . . . . 1369volume clone split commands . . . . . . 1372

    volume efficiency commands . . . . . . . . 1377volume efficiency check . . . . . . . . . 1377volume efficiency modify . . . . . . . . 1377volume efficiency off . . . . . . . . . . 1379volume efficiency on . . . . . . . . . . 1379volume efficiency prepare-to-downgrade . . 1380volume efficiency promote . . . . . . . . 1380volume efficiency revert-to. . . . . . . . 1381volume efficiency show . . . . . . . . . 1381volume efficiency start . . . . . . . . . 1386volume efficiency stat. . . . . . . . . . 1387volume efficiency stop . . . . . . . . . 1391volume efficiency undo . . . . . . . . . 1391volume efficiency policy commands . . . . 1393

    volume encryption commands . . . . . . . . 1396volume encryption conversion commands . . . . . . . . . . . . . . 1396volume encryption rekey commands . . . . 1399volume encryption secure-purge commands . . . . . . . . . . . . . . 1401

    volume file commands . . . . . . . . . . . 1402volume file compact-data . . . . . . . . 1402volume file modify . . . . . . . . . . . 1403volume file privileged-delete . . . . . . . 1404volume file reservation . . . . . . . . . 1404volume file show-disk-usage . . . . . . . 1405volume file show-filehandle . . . . . . . 1406volume file show-inode . . . . . . . . . 1407volume file clone commands . . . . . . . 1409volume file fingerprint commands . . . . . 1417volume file retention commands . . . . . 1423

    volume flexgroup commands . . . . . . . . 1424volume flexgroup deploy . . . . . . . . 1424volume flexgroup qtree-disable . . . . . . 1425

    volume inode-upgrade commands . . . . . . 1426volume inode-upgrade prepare-to- downgrade . . . . . . . . . . . . . . 1426volume inode-upgrade resume . . . . . . 1426volume inode-upgrade show . . . . . . . 1427

    Volume Move commands . . . . . . . . . . 1428volume move abort. . . . . . . . . . . 1428volume move modify . . . . . . . . . . 1429volume move show . . . . . . . . . . 1431volume move start . . . . . . . . . . . 1437

    volume move trigger-cutover . . . . . . . 1439volume move recommend commands . . . 1439volume move target-aggr commands . . . 1440

    volume qtree commands . . . . . . . . . . 1441volume qtree create . . . . . . . . . . 1441volume qtree delete . . . . . . . . . . 1443volume qtree modify . . . . . . . . . . 1443volume qtree oplocks. . . . . . . . . . 1444volume qtree rename . . . . . . . . . . 1445volume qtree security . . . . . . . . . . 1446volume qtree show. . . . . . . . . . . 1447volume qtree statistics . . . . . . . . . 1448volume qtree statistics-reset . . . . . . . 1450

    volume quota commands . . . . . . . . . . 1451volume quota modify . . . . . . . . . . 1451volume quota off . . . . . . . . . . . 1452volume quota on. . . . . . . . . . . . 1453volume quota report . . . . . . . . . . 1454volume quota resize . . . . . . . . . . 1459volume quota show . . . . . . . . . . 1459volume quota policy commands . . . . . 1463

    volume reallocation commands . . . . . . . 1475volume reallocation measure . . . . . . . 1475volume reallocation off . . . . . . . . . 1476volume reallocation on . . . . . . . . . 1476volume reallocation quiesce . . . . . . . 1477volume reallocation restart . . . . . . . . 1477volume reallocation schedule. . . . . . . 1478volume reallocation show . . . . . . . . 1479volume reallocation start . . . . . . . . 1480volume reallocation stop . . . . . . . . 1481

    volume schedule-style commands . . . . . . 1482volume schedule-style prepare-to- downgrade . . . . . . . . . . . . . . 1482

    Volume SnapLock Commands . . . . . . . . 1482volume snaplock modify . . . . . . . . 1482volume snaplock prepare-to-downgrade . . 1484volume snaplock show . . . . . . . . . 1484

    volume snapshot commands . . . . . . . . 1487volume snapshot compute-reclaimable. . . 1487volume snapshot create . . . . . . . . . 1487volume snapshot delete . . . . . . . . . 1488volume snapshot modify . . . . . . . . 1489volume snapshot modify-snaplock-expiry- time . . . . . . . . . . . . . . . . 1490volume snapshot partial-restore-file . . . . 1490volume snapshot prepare-for-revert . . . . 1491volume snapshot rename . . . . . . . . 1492volume snapshot restore . . . . . . . . 1492volume snapshot restore-file . . . . . . . 1493

    © Copyright Lenovo 2018 xi

  • volume snapshot show . . . . . . . . . 1494volume snapshot show-delta . . . . . . . 1499volume snapshot autodelete commands . . 1499volume snapshot policy commands . . . . 1503

    volume transition-convert-dir commands . . . . 1510volume transition-convert-dir show . . . . 1510volume transition-convert-dir start. . . . . 1511

    Chapter 29. Vserver Commands . . 1513vserver add-aggregates . . . . . . . . . . 1513vserver add-protocols . . . . . . . . . . . 1513vserver context . . . . . . . . . . . . . . 1514vserver create . . . . . . . . . . . . . . 1514vserver delete . . . . . . . . . . . . . . 1516vserver modify . . . . . . . . . . . . . . 1516vserver prepare-for-revert . . . . . . . . . . 1518vserver remove-aggregates . . . . . . . . . 1518vserver remove-protocols . . . . . . . . . . 1519vserver rename . . . . . . . . . . . . . . 1519vserver restamp-msid . . . . . . . . . . . 1520vserver show . . . . . . . . . . . . . . . 1520vserver show-aggregates . . . . . . . . . . 1524vserver show-protocols. . . . . . . . . . . 1525vserver start . . . . . . . . . . . . . . . 1525vserver stop . . . . . . . . . . . . . . . 1526vserver unlock . . . . . . . . . . . . . . 1526vserver active-directory commands . . . . . . 1527

    vserver active-directory create . . . . . . 1527vserver active-directory delete . . . . . . 1528vserver active-directory modify . . . . . . 1528vserver active-directory password- change . . . . . . . . . . . . . . . 1529vserver active-directory password-reset . . 1529vserver active-directory show . . . . . . 1530

    Vserver Audit Commands . . . . . . . . . . 1531vserver audit create . . . . . . . . . . 1531vserver audit delete . . . . . . . . . . 1533vserver audit disable . . . . . . . . . . 1533vserver audit enable . . . . . . . . . . 1534vserver audit modify . . . . . . . . . . 1534vserver audit prepare-to-downgrade . . . . 1536vserver audit rotate-log . . . . . . . . . 1536vserver audit show . . . . . . . . . . . 1537

    vserver check commands . . . . . . . . . . 1539vserver check lif-multitenancy commands . . . . . . . . . . . . . . 1539

    vserver cifs commands . . . . . . . . . . . 1544vserver cifs add-netbios-aliases . . . . . 1544vserver cifs create . . . . . . . . . . . 1545vserver cifs delete . . . . . . . . . . . 1546

    vserver cifs modify . . . . . . . . . . . 1546vserver cifs nbtstat . . . . . . . . . . . 1548vserver cifs prepare-to-downgrade . . . . 1550vserver cifs remove-netbios-aliases . . . . 1551vserver cifs repair-modify . . . . . . . . 1552vserver cifs show . . . . . . . . . . . 1553vserver cifs start . . . . . . . . . . . . 1554vserver cifs stop . . . . . . . . . . . . 1555BranchCache Commands . . . . . . . . 1555vserver cifs character-mapping commands . . . . . . . . . . . . . . 1560vserver cifs connection commands . . . . 1563vserver cifs domain commands . . . . . . 1565vserver cifs group-policy commands . . . . 1575vserver cifs home-directory commands. . . 1593vserver cifs options commands . . . . . . 1598vserver cifs security commands. . . . . . 1611CIFS session Commands . . . . . . . . 1615Share Commands . . . . . . . . . . . 1624vserver cifs superuser commands . . . . . 1640vserver cifs symlink commands . . . . . . 1642vserver cifs users-and-groups commands . . . . . . . . . . . . . . 1645

    vserver config-replication commands . . . . . 1659vserver config-replication pause . . . . . 1659vserver config-replication resume . . . . . 1659vserver config-replication show . . . . . . 1660

    vserver data-policy commands . . . . . . . . 1660vserver data-policy export . . . . . . . . 1660vserver data-policy import . . . . . . . . 1661vserver data-policy validate . . . . . . . 1662

    vserver export-policy commands . . . . . . . 1663vserver export-policy check-access . . . . 1663vserver export-policy copy. . . . . . . . 1666vserver export-policy create . . . . . . . 1666vserver export-policy delete . . . . . . . 1667vserver export-policy rename. . . . . . . 1667vserver export-policy show . . . . . . . 1667vserver export-policy access-cache commands . . . . . . . . . . . . . . 1668vserver export-policy config-checker commands . . . . . . . . . . . . . . 1677vserver export-policy cache commands . . 1681vserver export-policy netgroup commands . . . . . . . . . . . . . . 1682vserver export-policy rule commands . . . 1686

    vserver fcp commands . . . . . . . . . . . 1702vserver fcp create . . . . . . . . . . . 1702vserver fcp delete . . . . . . . . . . . 1703vserver fcp modify . . . . . . . . . . . 1703vserver fcp show . . . . . . . . . . . 1704

    xii ONTAP Command Reference

  • vserver fcp start . . . . . . . . . . . . 1705vserver fcp stop . . . . . . . . . . . . 1705vserver fcp initiator commands . . . . . . 1705vserver fcp interface commands . . . . . 1706vserver fcp nameserver commands . . . . 1708vserver fcp ping-igroup commands . . . . 1709vserver fcp ping-initiator commands . . . . 1710vserver fcp portname commands . . . . . 1711vserver fcp topology commands . . . . . 1712vserver fcp wwn commands . . . . . . . 1713vserver fcp wwpn-alias commands . . . . 1714

    vserver fpolicy commands . . . . . . . . . 1716vserver fpolicy disable . . . . . . . . . 1716vserver fpolicy enable. . . . . . . . . . 1717vserver fpolicy engine-connect . . . . . . 1718vserver fpolicy engine-disconnect . . . . . 1719vserver fpolicy prepare-to-downgrade . . . 1719vserver fpolicy show . . . . . . . . . . 1720vserver fpolicy show-enabled . . . . . . 1721vserver fpolicy show-engine . . . . . . . 1722vserver fpolicy show-passthrough-read- connection . . . . . . . . . . . . . . 1724vserver fpolicy policy commands . . . . . 1726

    vserver group-mapping commands . . . . . . 1756vserver group-mapping create . . . . . . 1756vserver group-mapping delete . . . . . . 1757vserver group-mapping insert . . . . . . 1757vserver group-mapping modify . . . . . . 1758vserver group-mapping show . . . . . . 1759vserver group-mapping swap . . . . . . 1760

    vserver iscsi commands . . . . . . . . . . 1761vserver iscsi create. . . . . . . . . . . 1761vserver iscsi delete . . . . . . . . . . . 1762vserver iscsi modify . . . . . . . . . . 1762vserver iscsi show . . . . . . . . . . . 1764vserver iscsi start . . . . . . . . . . . 1765vserver iscsi stop . . . . . . . . . . . 1765vserver iscsi command commands . . . . 1766vserver iscsi connection commands . . . . 1767vserver iscsi initiator commands . . . . . 1769vserver iscsi interface commands . . . . . 1770vserver iscsi isns commands . . . . . . . 1775vserver iscsi security commands . . . . . 1779vserver iscsi session commands . . . . . 1786

    vserver locks commands . . . . . . . . . . 1791vserver locks break . . . . . . . . . . 1791vserver locks show. . . . . . . . . . . 1792

    vserver migrate commands . . . . . . . . . 1798vserver migrate cleanup . . . . . . . . . 1798vserver migrate cutover . . . . . . . . . 1798

    vserver migrate pause . . . . . . . . . 1798vserver migrate repeer . . . . . . . . . 1799vserver migrate resume . . . . . . . . . 1799vserver migrate show . . . . . . . . . . 1800vserver migrate show-progress . . . . . . 1802vserver migrate show-volume . . . . . . 1804vserver migrate start . . . . . . . . . . 1805

    vserver name-mapping commands . . . . . . 1806vserver name-mapping create . . . . . . 1806vserver name-mapping delete . . . . . . 1807vserver name-mapping insert. . . . . . . 1807vserver name-mapping modify . . . . . . 1808vserver name-mapping refresh-hostname- ip . . . . . . . . . . . . . . . . . 1809vserver name-mapping show. . . . . . . 1810vserver name-mapping swap. . . . . . . 1811

    vserver nfs commands . . . . . . . . . . . 1812vserver nfs create . . . . . . . . . . . 1812vserver nfs delete . . . . . . . . . . . 1819vserver nfs modify . . . . . . . . . . . 1819vserver nfs off. . . . . . . . . . . . . 1826vserver nfs on . . . . . . . . . . . . . 1826vserver nfs prepare-for-v3-ms-dos-client- downgrade . . . . . . . . . . . . . . 1827vserver nfs prepare-to-downgrade . . . . 1827vserver nfs show . . . . . . . . . . . 1827vserver nfs start . . . . . . . . . . . . 1834vserver nfs status . . . . . . . . . . . 1834vserver nfs stop . . . . . . . . . . . . 1835vserver nfs credentials commands. . . . . 1835vserver nfs kerberos commands . . . . . 1838vserver nfs pnfs commands . . . . . . . 1846

    vserver nvme commands . . . . . . . . . . 1850vserver nvme create . . . . . . . . . . 1850vserver nvme delete . . . . . . . . . . 1851vserver nvme modify . . . . . . . . . . 1851vserver nvme show . . . . . . . . . . 1852vserver nvme show-interface . . . . . . . 1852vserver nvme feature commands . . . . . 1853vserver nvme namespace commands . . . 1854vserver nvme subsystem commands. . . . 1857

    vserver peer commands . . . . . . . . . . 1863vserver peer accept . . . . . . . . . . 1864vserver peer create. . . . . . . . . . . 1864vserver peer delete. . . . . . . . . . . 1866vserver peer modify . . . . . . . . . . 1866vserver peer modify-local-name . . . . . 1866vserver peer reject . . . . . . . . . . . 1867vserver peer repair-peer-name . . . . . . 1867vserver peer resume . . . . . . . . . . 1868

    © Copyright Lenovo 2018 xiii

  • vserver peer show . . . . . . . . . . . 1868vserver peer show-all . . . . . . . . . . 1870vserver peer suspend. . . . . . . . . . 1871vserver peer permission commands . . . . 1871vserver peer transition commands. . . . . 1873

    vserver san commands . . . . . . . . . . . 1876vserver san prepare-to-downgrade . . . . 1876

    vserver security commands . . . . . . . . . 1876vserver security file-directory commands . . 1876vserver security trace commands . . . . . 1915

    vserver services commands . . . . . . . . . 1927vserver services access-check commands . . . . . . . . . . . . . . 1927vserver services name-service commands . . . . . . . . . . . . . . 1939vserver services ndmp commands . . . . 2024Web Services Configuration . . . . . . . 2053

    vserver smtape commands . . . . . . . . . 2057

    vserver smtape break. . . . . . . . . . 2057SnapDiff RPC Server Commands . . . . . . . 2057

    vserver snapdiff-rpc-server off . . . . . . 2057vserver snapdiff-rpc-server on . . . . . . 2057vserver snapdiff-rpc-server show . . . . . 2058

    vserver vscan commands . . . . . . . . . . 2059vserver vscan disable. . . . . . . . . . 2059vserver vscan enable . . . . . . . . . . 2059vserver vscan reset . . . . . . . . . . 2060vserver vscan show . . . . . . . . . . 2060vserver vscan show-events . . . . . . . 2061Vserver Vscan Connection-status Commands. . . . . . . . . . . . . . 2063vserver vscan on-access-policy commands . . . . . . . . . . . . . . 2069vserver vscan on-demand-task commands . . . . . . . . . . . . . . 2083vserver vscan scanner-pool commands . . 2096

    xiv ONTAP Command Reference

  • Chapter 1. exit

    Quit the CLI session

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The eexxiitt command ends the current CLI session.

    Examples

    The following example ends the current CLI session: cluster1::> exit Goodbye

    © Copyright Lenovo 2018 1

  • 2 ONTAP Command Reference

  • Chapter 2. history

    Show the history of commands for this CLI session

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The hhiissttoorryy command displays the command history of the current CLI session. A numeric ID precedes each command. Use this number with the Chapter 4 “redo” on page 7 command to re-execute that history item.

    Examples

    The following example displays the command history of the current CLI session: cluster1::> history

    1 vserver show 2 man volume show 3 volume delete -vserver vs0 -volume temporary2 4 volume modify { -volume temp* } -state offline

    cluster1::> redo 3

    © Copyright Lenovo 2018 3

  • 4 ONTAP Command Reference

  • Chapter 3. man

    Display the online manual pages

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The mmaann command displays the manual page of the command you specify. If you do not specify a command, command displays the man page index.

    Parameters

    [] - Valid CLI commandThe command for which you'd like to see the manual page. The syntax of the command is the same as the command itself. The mmaann command supports abbreviations and tab completion of the command name.

    Examples

    The following example displays the manual page for the storage aggregate create command. cluster1::> man sto aggr cre

    That example could also have been fully specified as:

    cluster1::> man storage aggregate create

    © Copyright Lenovo 2018 5

  • 6 ONTAP Command Reference

  • Chapter 4. redo

    Execute a previous command

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The rreeddoo command re-executes a command that has been executed previously in the current CLI session. Specify a previously run command using:

    • A string that matches part of a previous command. For example, if the only volume command you have run is volume show, enter rreeddoo vol to re-execute the command.

    • The numeric ID of a previous command, as listed by the Chapter 2 “history” on page 3 command. For example, enter rreeddoo 4 to re-execute the fourth command in the history list.

    • A negative offset from the end of the history list. For example, enter rreeddoo -2 to re-execute the command that you ran two commands ago.

    Parameters

    [] - String, Event Number, or Negative OffsetUse this parameter to specify a string, a numeric ID from the command history, or a negative number that identifies the command to be re-executed.

    Examples

    The following example re-executes command number 10 in the command history: cluster1::> redo 10

    © Copyright Lenovo 2018 7

  • 8 ONTAP Command Reference

  • Chapter 5. rows

    Show/Set the rows for the CLI session

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The rroowwss command displays the number of rows that can be displayed in the current CLI session before the interface pauses output. If you do not set this value, it adjusts automatically based on the actual height of your terminal. If the actual height is undefined, the default number of rows is 24.

    Specify a number to set the number of rows that can be displayed. Setting this value manually disables auto- adjustment. Specify zero (0) to disable pausing.

    You can also set this value using the Chapter 6 “set” on page 11 -rows command.

    Parameters

    [] - Number of Rows the Screen Can DisplayUse this parameter to specify the number of rows your terminal can display.

    Examples

    The following example displays the current number of rows, then resets the number of rows to 48: cluster1::> rows

    36

    cluster1::> rows 48

    © Copyright Lenovo 2018 9

  • 10 ONTAP Command Reference

  • Chapter 6. set

    Display/Set CLI session settings

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The sseett command changes attributes of the user interface.

    Parameters

    [-privilege ] - Privilege LevelUse this parameter to specify the privilege level of the command session. Possible values are

    • admin - Used for routine system management commands

    • advanced - Used for infrequent, dangerous, or complicated commands

    • diagnostic - Used for detailed diagnostic commands that are used only by support personnel

    [-confirmations {on|off}] - Confirmation MessagesUse this parameter with the value on to specify that the interface prompt for confirmation before executing potentially dangerous commands. Use this parameter with the value off to specify that the interface not prompt for confirmation, even before potentially dangerous commands execute. The default setting is on.

    [-showallfields {true|false}] - Show All FieldsUse this parameter with the value true to specify that the interface display all field columns when displaying tabular output. Use this parameter with the value false to specify that the interface display only selected columns. The default setting is false.

    [-showseparator ] - Show SeparatorUse this parameter to specify the characters to use as the field separator. The field separator is used between field columns when -showallfields is set to "true". The separator can be from one to three characters in length. When specifying the separator, enclose it in quotation marks ("). Set the separator to one or more spaces to disable this feature.

    [-active-help {true|false}] - Active HelpUse this parameter with the value true to specify that pressing the question mark (?) key is sufficient to execute a help request. Use this parameter with the value false to specify that you must press the Return key after the question mark key to execute a help request. The default setting is true.

    [-units {auto|raw|B|KB|MB|GB|TB|PB}] - Data UnitsUse this parameter to specify the default units used when reporting data sizes. Possible values are:

    • auto - Auto-scale data size for human-readable output

    • raw - Bytes without unit designation

    • B - Bytes

    • KB - Kilobytes

    • MB - Megabytes

    • GB - Gigabytes

    • TB - Terabytes

    • PB - Petabytes

    The default setting is auto.

    © Copyright Lenovo 2018 11

  • [-rows ] - Pagination Rows ('0' disables)Use this parameter to specify the number of rows that can be displayed in the current CLI session before the interface pauses output. If you do not set this value, it adjusts automatically based on the actual height of your terminal. If the actual height is undefined, the default number of rows is 24.

    Setting this value manually disables auto-adjustment. Specify zero (0) to disable pausing.

    You can also set this value using the Chapter 5 “rows” on page 9 command.

    [-vserver ] - Default VserverUse this parameter to specify the name of the Vserver to use as the default value for the -vserver parameter of commands.

    WARNING: Vserverized commands that only have a single required parameter, which is the -vserver, allow the Vserver to be specified positionally, without - vserver preceeding it. Due to this, care must be take when using CLI commands that do not require the -vserver parameter. For example, using the "vserver nfs delete *" command will ignore the "set -vserver" value as the parser considers the "*" to be the Vserver.

    [-node ] - Default NodeUse this parameter to specify the name of the node to use as the default value for the -node parameter of commands.

    [-stop-on-error {true|false}] - Stop On ErrorUse this parameter with the value true to specify that continuing commands should stop if they encounter an error. Use this parameter with the value false to specify that continuing commands should continue if they encounter an error.

    [-prompt-timestamp {above|inline|none}] - Display Prompt TimestampPrint the current date and time as a part of the prompt. The possible values are

    • above - print the timestamp using the system timestamp format on the line above the remainder of the prompt.

    • inline - print the timestamp using the system timestamp format at the beginning of the line with the remainder of the prompt.

    • none - do not print the timestamp.

    The default value is none.

    Examples

    The following example sets the privilege level to advanced. cluster1::> set -privilege advanced

    Warning: These advanced commands are potentially dangerous; use them only when directed to do so by NetApp personnel.

    Do you wish to continue? (y or n): y

    cluster1::*>

    The following examples cause all columns to be shown in output rows, with a comma used as the field separator.

    cluster1::> set -showallfields true

    cluster1::> set -showseparator ","

    cluster1::> network port show node,port,role,link,mtu,autonegotiate-admin,autonegotiate-oper,duplex-admin,duplex-oper,speed-admin,speed-oper,flowcontrol-admin,flowcontrol-oper,mac,up-admin,type,ifgrp-node,ifgrp-port,ifgrp-distr-func,ifgrp-mode,vlan-node,vlan-port,vlan-tag, Node,Port,Role,Link,MTU,Auto-Negotiation Administrative,Auto-Negotiation Operational,Duplex Mode Administrative,Duplex Mode Operational,Speed Administrative,Speed Operational,Flow Control Administrative,Flow Control Operational,MAC Address,Up Administrative,Port Type,Interface Group Parent Node,Interface Group Parent Port,Distribution,Create Policy,Parent VLAN Node,Parent VLAN Port,VLAN Tag, node1,e0a,cluster,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:90:20:e9,true,physical,-,-,-,-,-,-,-, node1,e0b,cluster,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:90:20:f3,true,physical,-,-,-,-,-,-,-,

    12 ONTAP Command Reference

  • node1,e0c,data,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:90:20:fd,true,physical,-,-,-,-,-,-,-, node1,e0d,data,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:90:20:07,true,physical,-,-,-,-,-,-,-, node2,e0a,cluster,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:2e:b6:62,true,physical,-,-,-,-,-,-,-, node2,e0b,cluster,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:2e:b6:6c,true,physical,-,-,-,-,-,-,-, node2,e0c,data,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:2e:b6:76,true,physical,-,-,-,-,-,-,-, node2,e0d,data,up,1500,true,true,full,full,auto,1000,full,none,00:0c:29:2e:b6:80,true,physical,-,-,-,-,-,-,-,

    The following example shows how to create a prompt with a timestamp.

    cluster1::> set -prompt-timestamp above

    [2/25/2016 16:38:38] cluster1::>

    Chapter 6. set 13

  • 14 ONTAP Command Reference

  • Chapter 7. top

    Go to the top-level directory

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The ttoopp command changes the current working directory of the command prompt to the top-level command directory.

    Examples

    The following example returns the command prompt from the “storage aggregate” on page 755 directory to the top-level directory: cluster1::storage aggregate> top

    cluster1::>

    © Copyright Lenovo 2018 15

  • 16 ONTAP Command Reference

  • Chapter 8. up

    Go up one directory

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    The uupp command, which can also be specified as two dots (..), changes the current working directory of the command prompt to the directory that is up one level in the command hierarchy.

    Examples

    The following example takes the command prompt up one level from the “storage aggregate” on page 755directory: cluster1::storage aggregate> up

    cluster1::storage>

    © Copyright Lenovo 2018 17

  • 18 ONTAP Command Reference

  • Chapter 9. application commands

    Display and manage applications

    application create(DEPRECATED)-Create an application

    Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

    Description

    Note: This command is deprecated and may be removed in a future release of Data ONTAP.

    This command creates an application from an application template. It provisions storage for the application and optionally performs additional configuration.

    Parameters

    -vserver - VserverThe Vserver in which the application is created.

    -application - ApplicationThe name for the application to create.

    -application-template - Application TemplateThe application template upon which to base creation of the application.

    [-parameters , ...] - Application Template Customization ParametersA comma separated list of parameter names and their values to customize the application template for the desired application. The specific parameters which may be used to customize an application vary depending on the specified application template. For each template, there are both required and optional parameters. Attempting to execute the command without a required parameter will result in failure and a message identifying the missing parameter. Command line tab-completion provides lists of parameters and descriptions of the syntax required to specify the parameter values. A parameter and its value is specified as: parameter-name:parameter-value. Multiple parameters are specified by separating them with a comma as: parameter1-name:parameter1-value,parameter2-name:parameter2-value. The correct syntax for specifying a parameter value depends on the type of the parameter. Some parameters must be specified for multiple instances of the same type of object. These are specified using a zero- based array index to identify each unique object. These types of objects have sub-parameters that provide values for specific attributes of each object. A sub-parameter and its value for the Nth instance of an object is specified as: object-type[n].sub-parameter-name:sub-parameter-value.

    [-foreground {true|false}] - Execute in the ForegroundA boolean value that determines if the application creation executes synchronously at the command prompt in the foreground or asynchronously in the background. If this parameter is not supplied, it defaults to true and the application creation is executed synchronously at the command prompt.

    Examples

    The following command creates application app1 in Vserver vs1 based on the SAN application template with 5 LUNs totaling 200 GB in size and maps the new application LUNs to initiator group ig1. cluster1::> application create -vserver vs1 -application app1 -application-template SAN -parameters os-type:linux,application-components[0].name:data,application-components[0].total-size:200GB,application-components[0].lun-count:5,application-components[0].igroup-name:ig1

    application deleteDelete an application

    © Copyright Lenovo 2018 19

  • Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

    Description

    This command deletes an application.

    Parameters

    -vserver - VserverThe Vserver from which to delete the application.

    -application - ApplicationThe name of the application to delete.

    [-foreground {true|false}] - Execute in the ForegroundA boolean value that determines if the application deletion executes synchronously at the command prompt in the foreground or asynchronously in the background. If this parameter is not supplied, it defaults to true and the application deletion is executed synchronously at the command prompt.

    Examples

    The following command deletes application app1 from Vserver vs1. cluster1::> application delete -vserver vs1 -application app1

    application modify(DEPRECATED)-Modify properties of an application

    Availability: This command is available to cluster and Vserver administrators at the advanced privilege level.

    Description

    This command modifies properties of an application. The user must specify the names of one or more existing application components of an existing application and properties to apply to those application components. The command fails and the application remains in its initial state unless all of the application components can be modified at once.

    Parameters

    -vserver - VserverThe Vserver hosting the application.

    -application - ApplicationThe name of the application to modify.

    -application-components , ... - Application ComponentsA list of application component names to modify.

    [-storage-service ] - Storage ServiceThe new storage service to use for the listed application components. The “storage-service show” on page 753 command displays the available storage services. If the current aggregates hosting the application components can accommodate the requested storage service, the application components are modified to use the new storage service. If the current aggregates hosting the application components cannot accommodate the requested storage service, the command fails and all the specified application components continue with their existing storage services. Modifying the storage service of application components results in modifying the associated QoS policies to reflect the new storage service. The contents of the application components continue to remain on the same storage elements.

    [-foreground {true|false}] - Execute in the Foreground

    20 ONTAP Command Reference

  • A boolean value that determines if the application modification executes synchronously at the command prompt in the foreground or asynchronously in the background. If this parameter is not supplied, it defaults to true and the application modification is executed synchronously at the command prompt.

    Examples

    The following command modifies application app1 in Vserver vs1 based on the BasicModify application template. Application components component1 and component2 are modified to use the extreme storage service. cluster1::> application modify -vserver vs1 -application app1 -application-components component1,component2 -storage-service extremeThe following command modifies application app1 in Vserver vs1 based on the BasicModify application template. Application component component1 is modified to use the value storage service and application component component2 is modified to use the extreme storage service. cluster1::*> application modify -vserver vs1 -application app1 -application-template BasicModify -parameters application-components[0].name:component1,application-components[0].storage-service:value,application-components[1].name:component2,application-components[1].storage-service:extreme

    application showDisplay applications

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    This command displays applications. An application groups storage objects to perform application-granular operations.

    Parameters

    { [-fields , ...]Specifies fields that you want included in the output. You can use -fields ? to display the available fields.

    | [-instance ]}Specifies the display of all available fields for each selected application.

    [-vserver ] - VserverSelects applications belonging to Vservers that match the parameter value.

    [-application ] - ApplicationSelects applications with names that match the parameter value.

    Examplescluster1::> application show Vserver Application --------- -------------------------------------------- vs1 app1

    app2 app3 app4

    4 entries were displayed.

    application show-detailDisplay application details

    Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

    Description

    This command displays storage and protocol elements of applications.

    Chapter 9. application commands 21

  • Parameters

    { [-fields , ...]Specifies fields that you want included in the output. You can use -fields ? to display the available fields.

    | [-instance ]}Specifies the display of all available fields for each selected application.

    [-vserver ] - VserverSelects elements of applications belonging to Vservers that match the parameter value.

    [-application ] - ApplicationSelects elements of applications with an application name that matches the parameter value.

    [-element-type {lun|lun-clone|nas|igroup}] - Type of ObjectSelects application elements with type that matches the parameter value. Possible values are lun for application provisioned LUNs on SAN applications, lun-clone for auxiliary LUNs in SAN applications, igroup for protocol elements in SAN applications and nas for application provisioned storage and protocol information in NAS applications.

    [-application-component ] - Application ComponentSelects application elements which belong to the application component that matches the parameter value. Only application provisioned storage elements of type lun, nas can belong to application components.

    [-element-name ] - Name of ObjectSelects application elements with an element name that matches the parameter value.

    [-application-template ] - Application TemplateSelects application elements that belong to applications with templates that match the parameter value.

    [-application-template-version ] - Application Template VersionSelects application elements that belong to applications with template version that match the parameter value.

    [-application-uuid ] - Application UUIDSelects application elements that belong to applications whose UUID matches the parameter value.

    [-application-component-uuid ] - Application Component UUIDSelects application elements which belong to the application component whose UUID that matches the parameter value.

    [-application-component-storage-service ] - Storage ServiceSelects application elements which belong to the application component with a storage service that matches the parameter value.

    [-nas-element-path ] - Volume PathSelects application elements with a NAS element path that matches the parameter value. This field is valid only for elements of type nas.

    [-nas-element-size {[KB|MB|GB|TB|PB]}] - Volume SizeSelects application elements with NAS element size that matches the parameter value. This field is valid only for elements of type nas

    [-cifs-share-name ] - CIFS Share NameSelects application elements with a CIFS share that matches the parameter value. This field is valid only for elements of type nas.

    [-cifs-server-fqdn ] - CIFS Server NameSelects application elements with a CIFS Server that matches the parameter value. This field is valid for only elements of type nas.

    22 ONTAP Command Reference

  • [-cifs-permissions , ...] - CIFS User PermissionsSelects application elements with CIFS Permissions that matches the parameter value. This field is valid for only elements of type nas.

    [-cifs-access-ips , ...] - Recommended LIFs for CIFSSelects application elements with CIFS LIFs that matches the parameter value. This field is valid for only elements of type nas. The CIFS access IPs are recommended LIFs for CIFS access. If LIFs local to the volume are available, then these are recommended. If not, two remote LIFs are returned. Data can be accessed over other available LIFs but that is not recommended.

    [-nfs-export-policy-name ] - Export Policy NameSelects application elements with an export policy name that matches the parameter value. This field is valid for only elements of type nas.

    [-nfs-permissions , ...] - NFS PermissionsSelects application elements with NFS permissions that matches the parameter value. This field is valid for only elements of type nas.

    [-nfs-access-ips , ...] - Recommended LIFs for NFSSelects application elements with NFS LIFs that matches the parameter value. This field is valid for only elements of type nas. The NFS access IPs are recommended LIFs for NFS access. If LIFs local to the volume are available, then these are recommended. If not, two remote LIFs are returned. Data can be accessed over other available LIFs but that is not recommended.

    [-lun ] - LUN NameSelects application elements with a LUN name that matches the parameter value. This field is valid for only elements of type lun and lun-clone.

    [-lun-path ] - LUN PathSelects application elements with LUN path that matches the parameter value. This field is valid for only elements of type lun and lun-clone.

    [-serial ] - LUN SerialSelects application elements with a LUN serial number that matches the parameter value. This field is valid for only elements of type lun and lun-clone.

    [-lun-ids , ...] - LUN IDsSelects application elements with LUN IDs that match the parameter value. This field is valid for only elements of type lun and lun-clone.

    [-size {[KB|MB|GB|TB|PB]}] - Element SizeSelects application elements with a LUN size that matches the parameter value. This field is valid for only elements of type lun and lun-clone.

    [-igroups , ...] - IgroupsSelects application elements mapped to igroups with names that match the parameter value. This field is valid for only elements of type lun and lun-clone.

    [-initiator , ...] - InitiatorsSelects application elements mapped to initiators that matches the parameter value. This field is valid for only elements of type igroup.

    [-is-protection-supported {true|false}] - Is Protection SupportedSelects applications with is-protection-supported flag that matches the parameter value. The is- protection-supported flag indicates if any type of protection is supported for the application.

    [-is-protected {true|false}] - Is Application ProtectedSelects applications with is-protected flag that matches the parameter value. The is-protected flag indicates if any type of protection is enabled for the application.

    [-local-RPO ] - Local RPOSelects applications with local-RPO that matches the parameter value.

    Chapter 9. application commands 23

  • [-local-RPO-description ] - Local RPO descriptionSelects applications with local-RPO-descriptions that match the parameter