OneFS 7.2.1 CLI Administration Guide - Dell Technologies US...Dell believes the information in this publication is accurate as of its publication date. The information is subject to

IsilonOneFSVersion 7.2.1

CLI Administration Guide

Copyright © 2013-2017 EMC Corporation All rights reserved.

Published January 2017

Dell believes the information in this publication is accurate as of its publication date. The information is subject to change without notice.

THE INFORMATION IN THIS PUBLICATION IS PROVIDED “AS-IS.“ DELL MAKES NO REPRESENTATIONS OR WARRANTIES OF ANY KIND

WITH RESPECT TO THE INFORMATION IN THIS PUBLICATION, AND SPECIFICALLY DISCLAIMS IMPLIED WARRANTIES OF

MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. USE, COPYING, AND DISTRIBUTION OF ANY DELL SOFTWARE DESCRIBED

IN THIS PUBLICATION REQUIRES AN APPLICABLE SOFTWARE LICENSE.

Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be the property of their respective owners.

Published in the USA.

EMC CorporationHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.EMC.com

2 OneFS 7.2.1 CLI Administration Guide

Introduction to this guide 27About this guide......................................................................................... 28Isilon scale-out NAS overview.................................................................... 28Where to go for support............................................................................. 28

Isilon scale-out NAS 29OneFS storage architecture....................................................................... 30Isilon node components.............................................................................. 30Internal and external networks.................................................................... 31Isilon cluster................................................................................................31

Cluster administration.................................................................... 31Quorum.......................................................................................... 31Splitting and merging.....................................................................32Storage pools................................................................................ 33IP address pools.............................................................................33

The OneFS operating system..................................................................... 33Data-access protocols................................................................... 34Identity management and access control.......................................34

Structure of the file system........................................................................35Data layout.................................................................................... 36Writing files................................................................................... 36Reading files.................................................................................. 36Metadata layout.............................................................................37Locks and concurrency.................................................................. 37Striping..........................................................................................37

Data protection overview........................................................................... 38N+M data protection..................................................................... 39Data mirroring................................................................................39The file system journal...................................................................39Virtual hot spare............................................................................ 39Balancing protection with storage space....................................... 40

VMware integration....................................................................................40Software modules...................................................................................... 40

Introduction to the OneFS command-line interface 43OneFS command-line interface overview................................................... 44Syntax diagrams......................................................................................... 44Universal options........................................................................................ 45Command-line interface privileges............................................................. 46SmartLock compliance command permissions............................................50OneFS time values......................................................................................52

General cluster administration 53General cluster administration overview.....................................................54User interfaces...........................................................................................54Connecting to the cluster...........................................................................55

Log in to the web administration interface.................................... 55Open an SSH connection to a cluster............................................ 55

Chapter 1

Chapter 2

Chapter 3

Chapter 4

CONTENTS

OneFS 7.2.1 CLI Administration Guide 3

Licensing.................................................................................................... 56License status............................................................................... 56License configuration.................................................................... 59Activate a license through the command-line interface................. 60View license information................................................................60Unconfigure a license.................................................................... 60

Certificates................................................................................................. 61Replace or renew the SSL certificate.............................................61Verify an SSL certificate update....................................................62Self-signed SSL certificate data example...................................... 63

Cluster identity...........................................................................................63Set the cluster name .................................................................... 64

Cluster contact information........................................................................64Specify contact information ......................................................... 64

Cluster date and time................................................................................. 65Set the cluster date and time........................................................ 65Specify an NTP time server...........................................................66

SMTP email settings.................................................................................. 66Configure SMTP email settings .................................................... 67View SMTP email settings............................................................. 67

Configuring the cluster join mode............................................................... 67Specify the cluster join mode ........................................................68

File system settings....................................................................................68Specify the cluster character encoding......................................... 68Enable or disable access time tracking ..........................................69

Security hardening..................................................................................... 70STIG hardening profile................................................................... 70Apply a security hardening policy................................................... 71Revert a security hardening policy................................................. 73View the security hardening status................................................ 74

Cluster monitoring...................................................................................... 75Monitor the cluster........................................................................ 75View node status........................................................................... 76

Monitoring cluster hardware.......................................................................76View node hardware status............................................................76Chassis and drive states................................................................ 76Check battery status..................................................................... 79SNMP monitoring..........................................................................80

Events and notifications............................................................................. 84Coalesced events...........................................................................84Viewing event information............................................................. 86Responding to events.................................................................... 89Managing event notification settings............................................. 91Managing event notification rules..................................................92

Cluster maintenance...................................................................................95Replacing node components..........................................................95Upgrading node components.........................................................95Managing drive firmware............................................................... 95Managing cluster nodes................................................................ 101Upgrading OneFS.........................................................................103

Remote support........................................................................................ 103Remote support using SupportIQ................................................. 104Remote support using ESRS........................................................ 107

Cluster administration commands..............................................................110isi config....................................................................................... 110isi email......................................................................................... 115

CONTENTS


isi email list....................................................................................116isi exttools.....................................................................................116isi hardening apply........................................................................ 116isi hardening revert....................................................................... 117isi hardening status....................................................................... 117isi license activate......................................................................... 117isi license status............................................................................ 118isi license unconfigure................................................................... 118isi perfstat.....................................................................................118isi pkg create................................................................................ 118isi pkg delete.................................................................................119isi pkg info.....................................................................................119isi pkg install.................................................................................120isi remotesupport connectemc modify......................................... 120isi remotesupport connectemc view..............................................121isi services....................................................................................122isi set............................................................................................122isi snmp........................................................................................ 126isi snmp list...................................................................................127isi statistics client......................................................................... 127isi statistics describe.................................................................... 133isi statistics drive..........................................................................133isi statistics heat.......................................................................... 136isi statistics history.......................................................................140isi statistics list all.........................................................................142isi statistics list classes.................................................................142isi statistics list events................................................................. 143isi statistics list nodes...................................................................143isi statistics list nooutput..............................................................144isi statistics list operations........................................................... 144isi statistics list orderby................................................................145isi statistics list output................................................................. 145isi statistics list protocols............................................................. 146isi statistics list stats.................................................................... 146isi statistics list totalby................................................................. 147isi statistics protocol.....................................................................147isi statistics pstat......................................................................... 154isi statistics query........................................................................ 155isi statistics system...................................................................... 157isi status.......................................................................................158isi update......................................................................................159isi version..................................................................................... 160isi_for_array................................................................................. 161isi get........................................................................................... 163isi_gather_info............................................................................. 164isi_phone_home........................................................................... 170

Event commands....................................................................................... 171isi events cancel............................................................................ 171isi events list.................................................................................172isi events notifications create....................................................... 174isi events notifications modify...................................................... 175isi events notifications delete....................................................... 177isi events notifications list.............................................................177isi events quiet..............................................................................177isi events sendtest........................................................................178isi events settings list................................................................... 178

CONTENTS


isi events settings set................................................................... 178isi events show............................................................................. 179isi events unquiet..........................................................................179

Hardware commands................................................................................ 180isi batterystatus........................................................................... 180isi devices.....................................................................................180isi servicelight status.................................................................... 182isi servicelight off......................................................................... 182isi servicelight on..........................................................................183isi drivefirmware status................................................................ 183isi firmware package.....................................................................184isi firmware status........................................................................ 185isi firmware update.......................................................................186isi readonly off..............................................................................187isi readonly on.............................................................................. 188isi readonly show.......................................................................... 189

Access zones 191Access zones overview ............................................................................ 192Access zone base directory rules.............................................................. 192Access zones best practices..................................................................... 193Access zone limits.....................................................................................193Quality of service...................................................................................... 194Managing access zones.............................................................................194

Create an access zone................................................................. 195Associate an IP address pool with an access zone........................195Modify an access zone................................................................. 195Add an authentication provider to an access zone........................196Remove an authentication provider from an access zone.............196Delete an access zone.................................................................. 196

Access zone commands............................................................................ 197isi zone restrictions create........................................................... 197isi zone restrictions delete............................................................198isi zone restrictions list.................................................................198isi zone zones create.................................................................... 199isi zone zones delete....................................................................202isi zone zones list.........................................................................202isi zone zones modify...................................................................203isi zone zones view...................................................................... 209

Authentication 211Authentication...........................................................................................212Authentication provider features...............................................................212Supported authentication providers.......................................................... 212Active Directory........................................................................................ 213LDAP.........................................................................................................214NIS............................................................................................................214Kerberos authentication............................................................................ 214

Keytabs and SPNs overview.........................................................215MIT Kerberos protocol support.................................................... 215

File provider.............................................................................................. 215Local provider........................................................................................... 216Managing Active Directory providers........................................................ 216

Configure an Active Directory provider........................................ 216

Chapter 5

Chapter 6

CONTENTS


Modify an Active Directory provider.............................................217Delete an Active Directory provider..............................................217

Managing LDAP providers......................................................................... 217Configure an LDAP provider......................................................... 217Modify an LDAP provider............................................................. 218Delete an LDAP provider.............................................................. 218

Managing NIS providers............................................................................ 219Configure an NIS provider............................................................ 219Modify an NIS provider................................................................ 219Delete an NIS provider.................................................................220

Managing MIT Kerberos authentication....................................................220Managing MIT Kerberos realms................................................... 220Managing MIT Kerberos providers............................................... 222Managing MIT Kerberos domains.................................................225Managing SPNs and keys.............................................................227

Managing file providers............................................................................ 229Configure a file provider.............................................................. 229Generate a password file............................................................. 230Modify a file provider...................................................................230Delete a file provider.................................................................... 231Password file format.................................................................... 231Group file format......................................................................... 232Netgroup file format.................................................................... 233

Managing local users and groups.............................................................. 233View a list of users and groups by provider.................................. 233Create a local user....................................................................... 234Create a local group.....................................................................234Naming rules for local users and groups.......................................234Configure or modify a local password policy................................ 235Local password policy settings.................................................... 235Modify a local user.......................................................................237Modify a local group.................................................................... 237Delete a local user........................................................................237Delete a local group..................................................................... 238

Authentication and access control commands..........................................238isi auth access............................................................................. 238isi auth ads create........................................................................239isi auth ads delete........................................................................ 242isi auth ads list............................................................................. 243isi auth ads modify....................................................................... 244isi auth ads spn check..................................................................248isi auth ads spn create................................................................. 248isi auth ads spn delete..................................................................249isi auth ads spn list.......................................................................249isi auth ads trusts controllers list................................................. 250isi auth ads trusts list....................................................................251isi auth ads trusts view................................................................. 251isi auth ads view.......................................................................... 252isi auth error................................................................................ 252isi auth file create........................................................................ 252isi auth file delete.........................................................................256isi auth file list..............................................................................256isi auth file modify........................................................................257isi auth file view........................................................................... 264isi auth groups create.................................................................. 264isi auth groups delete...................................................................265

CONTENTS


isi auth groups flush.....................................................................266isi auth groups list........................................................................266isi auth groups members list.........................................................267isi auth groups modify..................................................................268isi auth groups view..................................................................... 269isi auth id..................................................................................... 270isi auth krb5 realm create............................................................ 270isi auth krb5 realm delete............................................................. 271isi auth krb5 realm modify............................................................ 271isi auth krb5 realm list.................................................................. 272isi auth krb5 realm view............................................................... 272isi auth krb5 create...................................................................... 272isi auth krb5 delete...................................................................... 273isi auth krb5 list............................................................................274isi auth krb5 view......................................................................... 274isi auth krb5 domain create..........................................................274isi auth krb5 domain delete.......................................................... 275isi auth krb5 domain modify......................................................... 275isi auth krb5 domain list............................................................... 275isi auth krb5 domain view.............................................................276isi auth krb5 spn create................................................................276isi auth krb5 spn delete................................................................ 277isi auth krb5 spn check................................................................ 277isi auth krb5 spn fix...................................................................... 277isi auth krb5 spn import............................................................... 278isi auth krb5 spn list..................................................................... 278isi auth ldap create.......................................................................279isi auth ldap delete.......................................................................286isi auth ldap list............................................................................ 286isi auth ldap modify...................................................................... 287isi auth ldap view..........................................................................297isi auth local list........................................................................... 298isi auth local modify..................................................................... 298isi auth local view.........................................................................300isi auth log-level...........................................................................300isi auth mapping create................................................................ 301isi auth mapping delete................................................................ 302isi auth mapping dump................................................................. 303isi auth mapping flush.................................................................. 304isi auth mapping import............................................................... 305isi auth mapping modify...............................................................305isi auth mapping token.................................................................306isi auth mapping view...................................................................307isi auth netgroups list...................................................................308isi auth nis create.........................................................................308isi auth nis delete.......................................................................... 311isi auth nis list...............................................................................312isi auth nis modify.........................................................................312isi auth nis view............................................................................ 318isi auth privileges..........................................................................318isi auth refresh............................................................................. 319isi auth roles create...................................................................... 319isi auth roles delete......................................................................320isi auth roles list...........................................................................320isi auth roles members list............................................................ 321isi auth roles modify.....................................................................322

CONTENTS


isi auth roles privileges list........................................................... 323isi auth roles view........................................................................ 324isi auth settings global modify......................................................325isi auth settings global view......................................................... 327isi auth settings krb5 modify........................................................ 327isi auth settings krb5 view........................................................... 328isi auth settings mapping modify..................................................328isi auth settings mapping view..................................................... 329isi auth status.............................................................................. 330isi auth users create.....................................................................330isi auth users delete..................................................................... 332isi auth users flush....................................................................... 333isi auth users list.......................................................................... 333isi auth users modify.................................................................... 334isi auth users view........................................................................337

Configuration access control 339Role-based access....................................................................................340Roles and privileges.................................................................................. 340

Roles........................................................................................... 340Privileges..................................................................................... 344

Managing roles......................................................................................... 352View roles.................................................................................... 352View privileges.............................................................................352Create and modify a custom role................................................. 353Delete a custom role....................................................................354

Identity management 355Identity management overview.................................................................356Identity types........................................................................................... 356Access tokens.......................................................................................... 357Access token generation.......................................................................... 358

ID mapping.................................................................................. 358User mapping.............................................................................. 360On-disk identity........................................................................... 362

Managing ID mappings............................................................................. 364Create an identity mapping..........................................................364Modify an identity mapping......................................................... 364Delete an identity mapping.......................................................... 365View an identity mapping.............................................................365Flush the identity mapping cache................................................ 366View a user token........................................................................ 366Configure identity mapping settings............................................ 367View identity mapping settings.................................................... 367

Managing user identities...........................................................................367View user identity........................................................................ 368Create a user-mapping rule......................................................... 369Merge Windows and UNIX tokens............................................... 370Retrieve the primary group from LDAP........................................ 371Mapping rule options.................................................................... 371Mapping rule operators................................................................372

Home directories 377Home directories overview....................................................................... 378

Chapter 7

Chapter 8

Chapter 9

CONTENTS


Home directory permissions..................................................................... 378Authenticating SMB users........................................................................ 378Home directory creation through SMB..................................................... 378

Create home directories with expansion variables....................... 379Create home directories with the --inheritable-path-acl option...380Create special home directories with the SMB share %U variable....381

Home directory creation through SSH and FTP........................................382Set the SSH or FTP login shell ....................................................382Set SSH/FTP home directory permissions.................................. 383Set SSH/FTP home directory creation options........................... 384Provision home directories with dot files..................................... 385

Home directory creation in a mixed environment......................................385Interactions between ACLs and mode bits................................................385Default home directory settings in authentication providers.....................386Supported expansion variables................................................................. 387Domain variables in home directory provisioning...................................... 389

Data access control 391Data access control overview................................................................... 392ACLs.........................................................................................................392UNIX permissions..................................................................................... 393Mixed-permission environments............................................................... 393

NFS access of Windows-created files......................................... 393SMB access of UNIX-created files...............................................393

Managing access permissions...................................................................394View expected user permissions.................................................. 394Configure access management settings...................................... 395Modify ACL policy settings..........................................................396Update cluster permissions..........................................................396

File sharing 399File sharing overview................................................................................ 400

Mixed protocol environments...................................................... 400Write caching with SmartCache...................................................401

SMB......................................................................................................... 402SMB shares in access zones........................................................403SMB Multichannel....................................................................... 403SMB share management through MMC...................................... 405Symbolic links and SMB clients................................................... 406Anonymous access to SMB shares.............................................. 407Managing SMB settings...............................................................407Managing SMB shares..................................................................410SMB commands........................................................................... 417

NFS.......................................................................................................... 442NFS exports................................................................................ 443NFS aliases.................................................................................. 443NFS log files................................................................................ 444Managing the NFS service...........................................................444Managing NFS exports................................................................ 445Managing NFS aliases..................................................................448NFS commands............................................................................451

FTP.......................................................................................................... 496View FTP settings........................................................................496

Chapter 10

Chapter 11

CONTENTS


Enable FTP file sharing................................................................ 496Configure FTP file sharing........................................................... 497FTP commands............................................................................497

HTTP and HTTPS..................................................................................... 514Enable and configure HTTP..........................................................514

Auditing 517Auditing overview......................................................................................518Syslog....................................................................................................... 518

Enable syslog............................................................................... 518Syslog forwarding........................................................................ 519

Protocol audit events................................................................................519Sample config audit log............................................................... 520

Supported event types..............................................................................521Supported audit tools............................................................................... 522Managing audit settings........................................................................... 522

Enable system configuration auditing.......................................... 522Enable protocol access auditing...................................................523Auditing settings..........................................................................524

Integrating with the EMC Common Event Enabler................................... 525Install CEE for Windows.............................................................. 526Configure CEE for Windows........................................................ 527

Auditing commands.................................................................................. 527isi audit settings modify............................................................... 528isi audit settings view.................................................................. 530isi audit topics list........................................................................ 530isi audit topics modify...................................................................531isi audit topics view...................................................................... 531

Snapshots 533Snapshots overview................................................................................. 534Data protection with SnapshotIQ............................................................. 534Snapshot disk-space usage...................................................................... 534Snapshot schedules..................................................................................535Snapshot aliases.......................................................................................535File and directory restoration................................................................... 535Best practices for creating snapshots...................................................... 536Best practices for creating snapshot schedules....................................... 536File clones.................................................................................................537

Shadow-store considerations...................................................... 538Snapshot locks......................................................................................... 538Snapshot reserve..................................................................................... 539SnapshotIQ license functionality.............................................................. 539Creating snapshots with SnapshotIQ........................................................539

Create a SnapRevert domain.......................................................540Create a snapshot schedule.........................................................540Create a snapshot........................................................................ 541Snapshot naming patterns........................................................... 541

Managing snapshots ................................................................................544Reducing snapshot disk-space usage.......................................... 544Delete a snapshot........................................................................ 545Modify snapshot attributes..........................................................545Modify a snapshot alias .............................................................. 545View snapshots............................................................................546

Chapter 12

Chapter 13

CONTENTS


Snapshot information.................................................................. 547Restoring snapshot data...........................................................................547

Revert a snapshot .......................................................................547Restore a file or directory using Windows Explorer......................548Restore a file or directory through a UNIX command line............ 548Clone a file from a snapshot........................................................ 549

Managing snapshot schedules.................................................................. 549Modify a snapshot schedule ....................................................... 549Delete a snapshot schedule ........................................................ 550View snapshot schedules ............................................................550

Managing snapshot aliases........................................................................551Configure a snapshot alias for a snapshot schedule..................... 551Assign a snapshot alias to a snapshot...........................................551Reassign a snapshot alias to the live file system...........................551View snapshot aliases.................................................................. 552Snapshot alias information.......................................................... 552

Managing with snapshot locks..................................................................552Create a snapshot lock................................................................ 553Modify a snapshot lock expiration date....................................... 553Delete a snapshot lock.................................................................553Snapshot lock information...........................................................554

Configure SnapshotIQ settings ................................................................554SnapshotIQ settings ................................................................... 555

Set the snapshot reserve......................................................................... 556Snapshot commands................................................................................ 556

Snapshot naming patterns...........................................................556isi snapshot schedules create...................................................... 560isi snapshot schedules modify...................................................... 561isi snapshot schedules delete.......................................................564isi snapshot schedules list............................................................564isi snapshot schedules view......................................................... 565isi snapshot schedules pending list.............................................. 566isi snapshot snapshots create...................................................... 567isi snapshot snapshots modify..................................................... 568isi snapshot snapshots delete...................................................... 569isi snapshot snapshots list........................................................... 570isi snapshot snapshots view......................................................... 572isi snapshot settings modify.........................................................572isi snapshot settings view............................................................ 574isi snapshot locks create..............................................................574isi snapshot locks modify............................................................. 575isi snapshot locks delete.............................................................. 576isi snapshot locks list....................................................................577isi snapshot locks view.................................................................578isi snapshot aliases create............................................................578isi snapshot aliases modify...........................................................579isi snapshot aliases delete............................................................579isi snapshot aliases list.................................................................580isi snapshot aliases view............................................................... 581

Deduplication with SmartDedupe 583Deduplication overview.............................................................................584Deduplication jobs.................................................................................... 584Data replication and backup with deduplication........................................585Snapshots with deduplication...................................................................585

Chapter 14

CONTENTS


Deduplication considerations....................................................................585Shadow-store considerations................................................................... 586SmartDedupe license functionality........................................................... 586Managing deduplication............................................................................587

Assess deduplication space savings ............................................ 587Specify deduplication settings .................................................... 587View deduplication space savings ............................................... 588View a deduplication report ........................................................ 588Deduplication job report information........................................... 588Deduplication information............................................................590

Deduplication commands..........................................................................590isi dedupe settings modify........................................................... 590isi dedupe settings view...............................................................592isi dedupe stats............................................................................592isi dedupe reports list.................................................................. 592isi dedupe reports view ............................................................... 593

Data replication with SyncIQ 595SyncIQ backup and recovery overview.....................................................596Replication policies and jobs.....................................................................596

Automated replication policies..................................................... 597Source and target cluster association..........................................598Full and differential replication.....................................................598Controlling replication job resource consumption........................ 598Replication reports...................................................................... 599

Replication snapshots.............................................................................. 600Source cluster snapshots............................................................ 600Target cluster snapshots............................................................. 600

Data failover and failback with SyncIQ......................................................601Data failover.................................................................................601Data failback................................................................................602

Recovery times and objectives for SyncIQ............................................... 602SyncIQ license functionality..................................................................... 603Creating replication policies......................................................................603

Excluding directories in replication.............................................. 603Excluding files in replication.........................................................604File criteria options...................................................................... 604Configure default replication policy settings ...............................606Create a replication policy........................................................... 606Create a SyncIQ domain.............................................................. 607Assess a replication policy .......................................................... 607

Managing replication to remote clusters...................................................608Start a replication job.................................................................. 608Pause a replication job ................................................................609Resume a replication job .............................................................609Cancel a replication job ...............................................................609View active replication jobs ........................................................ 609Replication job information ..........................................................610

Initiating data failover and failback with SyncIQ........................................610Fail over data to a secondary cluster ........................................... 610Revert a failover operation............................................................611Fail back data to a primary cluster ............................................... 611

Performing disaster recovery for SmartLock directories...........................612Recover SmartLock directories on a target cluster ..................... 612Migrate SmartLock directories ....................................................613

Chapter 15

CONTENTS


Managing replication policies.................................................................... 615Modify a replication policy ...........................................................615Delete a replication policy ........................................................... 615Enable or disable a replication policy ........................................... 616View replication policies .............................................................. 616Replication policy information ..................................................... 617

Managing replication to the local cluster...................................................618Cancel replication to the local cluster ..........................................618Break local target association ......................................................618View replication policies targeting the local cluster...................... 619Remote replication policy information ......................................... 619

Managing replication performance rules...................................................620Create a network traffic rule ...................................................... 620Create a file operations rule ........................................................620Modify a performance rule ..........................................................620Delete a performance rule ........................................................... 621Enable or disable a performance rule ...........................................621View performance rules ...............................................................621

Managing replication reports.................................................................... 622Configure default replication report settings .............................. 622Delete replication reports............................................................ 622View replication reports .............................................................. 623Replication report information..................................................... 624

Managing failed replication jobs................................................................625Resolve a replication policy .........................................................625Reset a replication policy ............................................................625Perform a full or differential replication....................................... 626

Managing changelists............................................................................... 626Create a changelist...................................................................... 627View a changelist......................................................................... 627Changelist information.................................................................628

Data replication commands...................................................................... 630isi sync policies create................................................................. 630isi sync policies modify................................................................ 639isi sync policies delete................................................................. 649isi sync policies list...................................................................... 650isi sync policies view.................................................................... 652isi sync policies disable................................................................ 653isi sync policies enable.................................................................653isi sync jobs start.........................................................................654isi sync jobs pause....................................................................... 654isi sync jobs resume.....................................................................655isi sync jobs cancel...................................................................... 655isi sync jobs list............................................................................655isi sync jobs view......................................................................... 656isi sync jobs reports list................................................................657isi sync jobs reports view............................................................. 657isi sync settings modify............................................................... 658isi sync settings view................................................................... 659isi sync policies resolve................................................................659isi sync policies reset................................................................... 660isi sync target cancel...................................................................660isi sync target list......................................................................... 661isi sync target view...................................................................... 662isi sync target break.................................................................... 662isi sync target reports list............................................................ 663

CONTENTS


isi sync target reports view..........................................................665isi sync target reports subreports list.......................................... 665isi sync target reports subreports view........................................ 667isi sync reports list.......................................................................667isi sync reports view.................................................................... 669isi sync reports rotate..................................................................669isi sync reports subreports list.....................................................669isi sync reports subreports view................................................... 671isi sync recovery allow-write........................................................ 671isi sync recovery resync-prep...................................................... 672isi sync rules create..................................................................... 673isi sync rules modify.....................................................................674isi sync rules delete......................................................................675isi sync rules list...........................................................................676isi sync rules view........................................................................ 677isi_changelist_mod...................................................................... 677

Data layout with FlexProtect 681FlexProtect overview............................................................................... 682File striping...............................................................................................682Requested data protection....................................................................... 682FlexProtect data recovery........................................................................683

Smartfail......................................................................................683Node failures............................................................................... 683

Requesting data protection...................................................................... 684Requested protection settings................................................................. 684Requested protection disk space usage....................................................685

NDMP backup 687NDMP backup and recovery overview......................................................688NDMP two-way backup............................................................................688NDMP three-way backup......................................................................... 689

Setting preferred IPs for NDMP three-way operations ...............689Configure preferred IP settings for NDMP three-way operations....689

Snapshot-based incremental backups...................................................... 690NDMP protocol support............................................................................ 691Supported DMAs.......................................................................................691NDMP hardware support..........................................................................692NDMP backup limitations......................................................................... 692NDMP performance recommendations.....................................................692Excluding files and directories from NDMP backups.................................694Configuring basic NDMP backup settings................................................ 695

Configure and enable NDMP backup........................................... 695Disable NDMP backup ................................................................ 696View NDMP backup settings ...................................................... 696NDMP backup settings ...............................................................696

Managing NDMP user accounts............................................................... 696Create an NDMP user account ................................................... 696Modify the password of an NDMP user account .........................697Delete an NDMP user account ....................................................697View NDMP user accounts ......................................................... 697

Managing NDMP backup devices............................................................. 697Detect NDMP backup devices .................................................... 698

Chapter 16

Chapter 17

CONTENTS


Modify an NDMP backup device entry name .............................. 698Delete a device entry for a disconnected NDMP backup device.. 698View NDMP backup devices ....................................................... 698

Managing NDMP backup ports.................................................................699Modify NDMP backup port settings ........................................... 699Enable or disable an NDMP backup port......................................699View NDMP backup ports ...........................................................699NDMP backup port settings ....................................................... 700

Managing NDMP backup sessions............................................................ 700End an NDMP session .................................................................700View NDMP sessions ...................................................................701NDMP session information .......................................................... 701

Managing restartable backups.................................................................. 702Configure restartable backups for EMC NetWorker.................... 702View restartable backup contexts................................................703Delete a restartable backup context............................................ 703Configure restartable backup settings......................................... 703View restartable backup settings................................................. 704

Managing file list backups.........................................................................704Format of a backup file list.......................................................... 705Placement of the file list.............................................................. 705Start a file list backup.................................................................. 706

NDMP restore operations.........................................................................706Parallel restore operation.............................................................706Serial restore operation................................................................707Specify a serial restore operation.................................................707

Sharing tape drives between clusters....................................................... 707Managing default NDMP settings.............................................................708

Set default NDMP settings for a directory...................................708Modify default NDMP settings for a directory............................. 708View default NDMP settings for directories.................................709NDMP environment variables...................................................... 709

Managing snapshot based incremental backups........................................ 712Enable snapshot-based incremental backups for a directory........ 712Delete snapshots for snapshot-based incremental backups..........712View snapshots for snapshot-based incremental backups............ 713

View NDMP backup logs .......................................................................... 713NDMP backup commands......................................................................... 713

isi ndmp user create..................................................................... 713isi ndmp user modify.....................................................................714isi ndmp user delete......................................................................714isi ndmp user list...........................................................................715isi tape rescan.............................................................................. 715isi tape rename............................................................................. 716isi tape delete............................................................................... 716isi tape list.................................................................................... 717isi fc set........................................................................................ 717isi fc disable..................................................................................719isi fc enable.................................................................................. 719isi fc list....................................................................................... 720isi ndmp kill................................................................................... 721isi ndmp list.................................................................................. 721isi ndmp probe............................................................................. 722isi ndmp settings set.................................................................... 723isi ndmp settings list.................................................................... 724isi ndmp settings variables create................................................ 725

CONTENTS


isi ndmp settings variables modify............................................... 725isi ndmp settings variables delete.................................................726isi ndmp settings variables list......................................................727isi ndmp dumpdates delete...........................................................727isi ndmp dumpdates list................................................................728isi ndmp extensions context delete.............................................. 728isi ndmp extensions contexts list..................................................729isi ndmp extensions contexts view............................................... 729isi ndmp extensions settings modify.............................................730isi ndmp extensions settings view................................................ 730

File retention with SmartLock 733SmartLock overview................................................................................. 734Compliance mode..................................................................................... 734SmartLock directories.............................................................................. 734Replication and backup with SmartLock................................................... 735

SmartLock replication and backup limitations.............................. 735SmartLock license functionality................................................................736SmartLock considerations.........................................................................737Set the compliance clock.......................................................................... 737View the compliance clock........................................................................738Creating a SmartLock directory................................................................738

Retention periods........................................................................ 738Autocommit time periods.............................................................738Create a SmartLock directory......................................................739

Managing SmartLock directories.............................................................. 739Modify a SmartLock directory..................................................... 740View SmartLock directory settings.............................................. 740SmartLock directory configuration settings................................. 741

Managing files in SmartLock directories................................................... 744Set a retention period through a UNIX command line.................. 744Set a retention period through Windows Powershell................... 745Commit a file to a WORM state through a UNIX command line... 745Commit a file to a WORM state through Windows Explorer.........746Override the retention period for all files in a SmartLock directory....746Delete a file committed to a WORM state ...................................746View WORM status of a file......................................................... 747

SmartLock commands.............................................................................. 748isi worm domains create.............................................................. 748isi worm domains modify..............................................................752isi worm domains list....................................................................756isi worm domains view ................................................................ 757isi worm cdate set........................................................................757isi worm cdate view..................................................................... 758isi worm files delete..................................................................... 758isi worm files view........................................................................758

Protection domains 761Protection domains overview....................................................................762Protection domain considerations.............................................................762Create a protection domain ..................................................................... 763Delete a protection domain ......................................................................763

Chapter 18

Chapter 19

CONTENTS


Data-at-rest-encryption 765Data-at-rest encryption overview.............................................................766Self-encrypting drives.............................................................................. 766Data security on self-encrypted drives..................................................... 766Data migration to a self-encrypted-drives cluster.....................................767Chassis and drive states........................................................................... 767Smartfailed drive REPLACE state.............................................................770Smartfailed drive ERASE state................................................................. 772

SmartQuotas 773SmartQuotas overview............................................................................. 774Quota types.............................................................................................. 774Default quota type.................................................................................... 775Usage accounting and limits......................................................................777Disk-usage calculations.............................................................................778Quota notifications................................................................................... 779Quota notification rules............................................................................ 780Quota reports........................................................................................... 780Creating quotas.........................................................................................781

Create an accounting quota......................................................... 781Create an enforcement quota...................................................... 782

Managing quotas...................................................................................... 782Search for quotas........................................................................ 782Manage quotas............................................................................ 783Export a quota configuration file..................................................784Import a quota configuration file..................................................784Managing quota notifications.......................................................785Email quota notification messages............................................... 786Managing quota reports...............................................................789Basic quota settings..................................................................... 791Advisory limit quota notification rules settings............................. 791Soft limit quota notification rules settings................................... 792Hard limit quota notification rules settings...................................794Limit notification settings............................................................ 795Quota report settings.................................................................. 795

Quota commands......................................................................................796isi quota quotas create.................................................................796isi quota quotas delete................................................................. 799isi quota quotas modify................................................................800isi quota quotas list......................................................................803isi quota quotas view................................................................... 805isi quota quotas notifications clear.............................................. 806isi quota quotas notifications create............................................ 808isi quota quotas notifications delete..............................................811isi quota quotas notifications disable............................................ 813isi quota quotas notifications list.................................................. 814isi quota quotas notifications modify............................................ 817isi quota quotas notifications view............................................... 820isi quota reports create................................................................822isi quota reports delete................................................................ 823isi quota reports list..................................................................... 824isi quota settings notifications clear.............................................824isi quota settings notifications create.......................................... 825isi quota settings notifications delete...........................................827isi quota settings notifications list................................................828

Chapter 20

Chapter 21

CONTENTS


isi quota settings notifications modify..........................................829isi quota settings notifications view............................................. 832isi quota settings reports modify..................................................833isi quota settings reports view..................................................... 834

Storage Pools 835Storage pools overview............................................................................ 836Storage pool functions............................................................................. 836Autoprovisioning.......................................................................................838Node pools............................................................................................... 838

Node class compatibilities............................................................839SSD compatibilities......................................................................840Manual node pools.......................................................................840

Virtual hot spare........................................................................................841Spillover.................................................................................................... 841Suggested protection............................................................................... 842Protection policies....................................................................................842SSD strategies..........................................................................................843Global namespace acceleration.................................................................844L3 cache overview....................................................................................844

Migration to L3 cache..................................................................845L3 cache on NL-series and HD-series node pools........................ 846

Tiers......................................................................................................... 846File pool policies....................................................................................... 846Managing node pools through the command-line interface.......................847

Create a node class compatibility.................................................847Merge compatible node pools...................................................... 848Delete a node class compatibility................................................. 849Create an SSD compatibility........................................................849Delete an SSD compatibility........................................................ 850Create a node pool manually........................................................ 851Add a node to a manually managed node pool.............................. 851Change the name or protection policy of a node pool.................. 852Remove a node from a manually managed node pool................... 852Modify default storage pool settings........................................... 852SmartPools settings.................................................................... 853

Managing L3 cache from the command-line interface..............................855Set L3 cache as the default for new node pools.......................... 856Enable L3 cache on a specific node pool .....................................856Restore SSDs to storage drives for a node pool.......................... 856

Managing tiers..........................................................................................857Create a tier.................................................................................857Add or move node pools in a tier.................................................. 857Rename a tier.............................................................................. 857Delete a tier.................................................................................858

Creating file pool policies..........................................................................858Create a file pool policy............................................................... 859Valid wildcard characters.............................................................859Default file pool requested protection settings............................ 860Default file pool I/O optimization settings.................................... 861

Managing file pool policies........................................................................862Modify a file pool policy............................................................... 862Configure default file pool policy settings....................................863Prioritize a file pool policy............................................................864Delete a file pool policy................................................................864

Chapter 22

CONTENTS


Monitoring storage pools..........................................................................865Monitor storage pools..................................................................865View the health of storage pools................................................. 865View results of a SmartPools job................................................. 866

Storage pool commands........................................................................... 866isi filepool apply........................................................................... 866isi filepool default-policy modify.................................................. 869isi filepool default-policy view...................................................... 870isi filepool policies create..............................................................871isi filepool policies delete..............................................................874isi filepool policies list...................................................................875isi filepool policies modify............................................................ 876isi filepool policies view................................................................ 879isi filepool templates list...............................................................880isi filepool templates view.............................................................881isi storagepool compatibilities class active create.........................881isi storagepool compatibilities class active delete........................ 882isi storagepool compatibilities class active list............................. 883isi storagepool compatibilities class active view...........................884isi storagepool compatibilities class available list..........................884isi storagepool compatibilities ssd active create.......................... 885isi storagepool compatibilities ssd active delete........................... 887isi storagepool compatibilities ssd active list................................888isi storagepool compatibilities ssd active view............................. 889isi storagepool compatibilities ssd available list............................ 889isi storagepool health...................................................................890isi storagepool list........................................................................890isi storagepool nodepools create.................................................. 891isi storagepool nodepools delete...................................................891isi storagepool nodepools list....................................................... 892isi storagepool nodepools modify.................................................893isi storagepool nodepools view.................................................... 894isi storagepool settings modify.................................................... 895isi storagepool settings view........................................................896isi storagepool tiers create...........................................................897isi storagepool tiers delete........................................................... 897isi storagepool tiers list................................................................ 898isi storagepool tiers modify..........................................................898isi storagepool tiers view............................................................. 899

System jobs 901System jobs overview...............................................................................902System jobs library................................................................................... 902Job operation........................................................................................... 904Job performance impact.......................................................................... 905Job priorities............................................................................................ 906Managing system jobs.............................................................................. 906

Start a job....................................................................................907Pause a job........................

Documents

OneFS 7.2.1 CLI Administration Guide - Dell Technologies US...Dell believes the information in this publication is accurate as of its publication date. The information is subject to