Isilon OneFS 7.1.1 CLI Administration Guide - Dell EMC US · Introduction to the OneFS command-line interface 41 ... OneFS 7.1.1 CLI Administration Guide 3. ... isi_gather_info

IsilonOneFSVersion 7.1.1

CLI Administration Guide

Copyright 2013-2015 EMC Corporation. All rights reserved. Published in USA.

Published June, 2015

EMC believes the information in this publication is accurate as of its publication date. The information is subject to changewithout notice.

The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind withrespect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for aparticular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicablesoftware license.

EMC, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and othercountries. All other trademarks used herein are the property of their respective owners.

For the most up-to-date regulatory document for your product line, go to EMC Online Support (https://support.emc.com).

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

2 OneFS 7.1.1 CLI Administration Guide

Introduction to this guide 27

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

Isilon scale-out NAS 29

OneFS 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...................................................................................... 35Writing files......................................................................................36Reading files.................................................................................... 36Metadata layout...............................................................................36Locks and concurrency.....................................................................37Striping............................................................................................37

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

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

Introduction to the OneFS command-line interface 41

OneFS command-line interface overview....................................................... 42Syntax diagrams........................................................................................... 42Universal options.......................................................................................... 43Command-line interface privileges................................................................ 43SmartLock compliance command permissions.............................................. 47OneFS time values.........................................................................................50

General cluster administration 51

General cluster administration overview........................................................52User interfaces.............................................................................................. 52Connecting to the cluster...............................................................................52

Log in to the web administration interface........................................53

Chapter 1

Chapter 2

Chapter 3

Chapter 4

CONTENTS

OneFS 7.1.1 CLI Administration Guide 3

Open an SSH connection to a cluster................................................53Licensing.......................................................................................................53

License status..................................................................................54License configuration.......................................................................56Activate a license through the command-line interface.....................57View license information.................................................................. 57Unconfigure a license.......................................................................57

Certificates....................................................................................................58Replace or renew the SSL certificate.................................................58Verify an SSL certificate update........................................................59Self-signed SSL certificate data example..........................................60

Cluster identity..............................................................................................60Set the cluster name ....................................................................... 60

Cluster contact information........................................................................... 61Specify contact information .............................................................61

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

SMTP email settings...................................................................................... 63Configure SMTP email settings ........................................................ 63View SMTP email settings.................................................................63

Configuring the cluster join mode..................................................................64Specify the cluster join mode .......................................................... 64Cluster join modes........................................................................... 64

File system settings.......................................................................................64Specify the cluster character encoding............................................. 65Enable or disable access time tracking ............................................65

Cluster monitoring.........................................................................................66Monitor the cluster...........................................................................66View node status............................................................................. 66

Monitoring cluster hardware..........................................................................67View node hardware status.............................................................. 67Chassis and drive states.................................................................. 67Check battery status........................................................................ 69SNMP monitoring............................................................................. 70

Events and notifications................................................................................73Coalesced events.............................................................................73Viewing event information................................................................75Responding to events.......................................................................78Managing event notification settings................................................79Managing event notification rules.................................................... 81

Cluster maintenance..................................................................................... 83Replacing node components............................................................ 83Upgrading node components........................................................... 84Managing drive firmware..................................................................84Managing cluster nodes................................................................... 87Upgrading OneFS............................................................................. 88

Remote support.............................................................................................89Remote support using SupportIQ..................................................... 89Remote support using ESRS Gateway............................................... 92

Cluster administration commands.................................................................94isi config.......................................................................................... 94isi email........................................................................................... 99isi email list................................................................................... 100isi exttools..................................................................................... 100isi license activate......................................................................... 100

CONTENTS


isi license status............................................................................ 100isi license unconfigure................................................................... 101isi perfstat......................................................................................101isi pkg create................................................................................. 101isi pkg delete................................................................................. 101isi pkg info..................................................................................... 102isi pkg install................................................................................. 102isi remotesupport connectemc modify............................................103isi remotesupport connectemc view............................................... 104isi services.....................................................................................104isi set.............................................................................................105isi snmp.........................................................................................108isi snmp list................................................................................... 109isi statistics client.......................................................................... 109isi statistics describe..................................................................... 115isi statistics drive........................................................................... 115isi statistics heat............................................................................117isi statistics history........................................................................ 121isi statistics list all......................................................................... 123isi statistics list classes..................................................................123isi statistics list events...................................................................124isi statistics list nodes................................................................... 124isi statistics list nooutput...............................................................125isi statistics list operations............................................................ 125isi statistics list orderby................................................................. 126isi statistics list output...................................................................126isi statistics list protocols.............................................................. 127isi statistics list stats..................................................................... 127isi statistics list totalby.................................................................. 128isi statistics protocol......................................................................128isi statistics pstat...........................................................................134isi statistics query.......................................................................... 136isi statistics system........................................................................137isi status........................................................................................139isi update.......................................................................................139isi version...................................................................................... 140isi_for_array...................................................................................141isi get.............................................................................................143isi_gather_info...............................................................................144

Event commands.........................................................................................149isi events cancel............................................................................ 149isi events list..................................................................................149isi events notifications create.........................................................151isi events notifications modify........................................................152isi events notifications delete........................................................ 154isi events notifications list............................................................. 154isi events quiet.............................................................................. 154isi events sendtest......................................................................... 154isi events settings list.................................................................... 155isi events settings set.....................................................................155isi events show.............................................................................. 155isi events unquiet.......................................................................... 156

Hardware commands.................................................................................. 156isi batterystatus............................................................................. 156isi devices......................................................................................157isi servicelight status..................................................................... 158

CONTENTS


isi servicelight off...........................................................................158isi servicelight on...........................................................................159isi drivefirmware status..................................................................159isi firmware package...................................................................... 160isi firmware status..........................................................................160isi firmware update........................................................................ 162isi readonly off............................................................................... 163isi readonly on............................................................................... 164isi readonly show........................................................................... 165

Access zones 167

Access zones overview ............................................................................... 168Access zone base-directory rules.................................................................169Access zones best practices........................................................................170Quality of service........................................................................................ 170Access zone limits.......................................................................................171Configuring an access zone.........................................................................171

Create an IP address pool for an access zone................................. 171Configure a SmartConnect zone for an access zone........................ 172Create an access zone....................................................................172Add an access zone to an existing IP address pool......................... 172Add an authentication provider to an access zone..........................173

Managing access zones.............................................................................. 173Modify an access zone................................................................... 173Delete an access zone....................................................................174Associate an IP address pool with an access zone..........................174Remove an authentication provider from an access zone............... 174

Access zone commands.............................................................................. 175isi zone restrictions create............................................................. 175isi zone restrictions delete............................................................. 175isi zone restrictions list.................................................................. 176isi zone zones create......................................................................177isi zone zones delete..................................................................... 179isi zone zones list.......................................................................... 180isi zone zones modify.....................................................................180isi zone zones view........................................................................ 186

Authentication and access control 187

Authentication and access control overview................................................ 188Role-based access...................................................................................... 188

Roles and privileges.......................................................................188Data backup and restore privileges................................................ 199User permissions utility..................................................................200

Authentication............................................................................................ 200Supported authentication providers...............................................200Authentication provider features.................................................... 201Kerberos authentication.................................................................201LDAP.............................................................................................. 201Active Directory.............................................................................. 202NIS.................................................................................................202File provider................................................................................... 202Local provider................................................................................ 203

Data access control.....................................................................................203Authorization.............................................................................................. 204

Chapter 5

Chapter 6

CONTENTS


SMB...............................................................................................204NFS................................................................................................ 205Mixed-permission environments.................................................... 205

Managing roles........................................................................................... 206View roles...................................................................................... 206View privileges...............................................................................206Create and modify a custom role.................................................... 207Delete a custom role...................................................................... 208

Managing authentication providers............................................................. 208Managing LDAP providers.............................................................. 208Managing Active Directory providers.............................................. 210Managing NIS providers................................................................. 211Managing file providers..................................................................212Managing local users and groups...................................................215

Managing access permissions.....................................................................219View expected user permissions.................................................... 219Configure access management settings......................................... 220Modify ACL policy settings..............................................................221Update cluster permissions............................................................221

Authentication and access control commands............................................ 222isi auth access............................................................................... 222isi auth ads create..........................................................................223isi auth ads delete......................................................................... 226isi auth ads list.............................................................................. 226isi auth ads modify.........................................................................227isi auth ads spn check................................................................... 231isi auth ads spn create................................................................... 231isi auth ads spn delete...................................................................232isi auth ads spn list........................................................................233isi auth ads trusts controllers list................................................... 233isi auth ads trusts list.....................................................................234isi auth ads trusts view.................................................................. 234isi auth ads view............................................................................ 234isi auth error.................................................................................. 235isi auth file create.......................................................................... 235isi auth file delete.......................................................................... 238isi auth file list............................................................................... 239isi auth file modify......................................................................... 239isi auth file view............................................................................. 246isi auth groups create.................................................................... 246isi auth groups delete.................................................................... 247isi auth groups flush...................................................................... 248isi auth groups list......................................................................... 248isi auth groups modify................................................................... 249isi auth groups members list.......................................................... 250isi auth groups view....................................................................... 251isi auth id.......................................................................................251isi auth krb5 add realm.................................................................. 252isi auth krb5 delete default............................................................ 252isi auth krb5 delete domain........................................................... 253isi auth krb5 delete realm.............................................................. 253isi auth krb5 list............................................................................. 254isi auth krb5 modify default........................................................... 254isi auth krb5 modify domain.......................................................... 255isi auth krb5 modify realm............................................................. 255isi auth krb5 write.......................................................................... 256

CONTENTS


isi auth ldap create........................................................................ 256isi auth ldap delete........................................................................ 263isi auth ldap list............................................................................. 263isi auth ldap modify....................................................................... 264isi auth ldap view...........................................................................273isi auth local list.............................................................................273isi auth local view.......................................................................... 274isi auth local modify.......................................................................274isi auth log-level............................................................................ 276isi auth mapping delete................................................................. 276isi auth mapping dump.................................................................. 278isi auth mapping flush................................................................... 278isi auth mapping idrange............................................................... 279isi auth mapping import................................................................. 280isi auth mapping list...................................................................... 280isi auth mapping modify................................................................ 281isi auth mapping new.....................................................................283isi auth mapping token.................................................................. 284isi auth mapping upgrade-db......................................................... 284isi auth netgroups list.................................................................... 285isi auth nis create...........................................................................285isi auth nis delete.......................................................................... 288isi auth nis list............................................................................... 289isi auth nis modify..........................................................................289isi auth nis view............................................................................. 295isi auth privileges...........................................................................295isi auth refresh...............................................................................295isi auth roles create........................................................................296isi auth roles delete....................................................................... 296isi auth roles list............................................................................ 296isi auth roles members list............................................................. 297isi auth roles modify.......................................................................298isi auth roles privileges list.............................................................299isi auth roles view.......................................................................... 300isi auth settings global modify....................................................... 300isi auth settings global view........................................................... 303isi auth status................................................................................ 304isi auth users create.......................................................................304isi auth users delete.......................................................................306isi auth users flush.........................................................................306isi auth users list............................................................................307isi auth users modify......................................................................308isi auth users view......................................................................... 310

Identity management 311

Identity management overview....................................................................312Identity types.............................................................................................. 312Access tokens............................................................................................. 313Access token generation............................................................................. 314

ID mapping.................................................................................... 314User mapping across systems and identities..................................316On-disk identity............................................................................. 318

Managing user identities.............................................................................319View user identity.......................................................................... 319Create a user-mapping rule............................................................ 321

Chapter 7

CONTENTS


Merge Windows and UNIX tokens...................................................322Retrieve the primary group from LDAP............................................ 322Mapping rule options.....................................................................323Mapping rule operators..................................................................324

Auditing 327

Auditing overview........................................................................................328Protocol audit events.................................................................................. 328Supported event types................................................................................ 328Supported audit tools................................................................................. 329Managing audit settings..............................................................................330

Enable system configuration auditing............................................ 330Enable protocol access auditing.....................................................330Auditing settings............................................................................331

Integrating with the EMC Common Event Enabler.........................................332Install CEE for Windows..................................................................332Configure CEE for Windows............................................................ 333

Auditing commands.................................................................................... 334isi audit settings modify.................................................................334isi audit settings view.................................................................... 336isi audit topics list..........................................................................336isi audit topics modify....................................................................337isi audit topics view....................................................................... 337

File sharing 339

File sharing overview...................................................................................340SMB............................................................................................................ 340

SMB shares in access zones.......................................................... 341SMB Multichannel..........................................................................341SMB share management through MMC.......................................... 343Symbolic links through SMB.......................................................... 344

NFS............................................................................................................. 345HTTP and HTTPS.......................................................................................... 345FTP..............................................................................................................345Mixed protocol environments......................................................................345Write caching with SmartCache................................................................... 346

Write caching for asynchronous writes........................................... 346Write caching for synchronous writes............................................. 347

Managing SMB settings...............................................................................347View global SMB settings...............................................................347Configure global SMB settings....................................................... 347Enable or disable the SMB service................................................. 348Enable or disable SMB Multichannel.............................................. 348View default SMB share settings.................................................... 348Configure default SMB share settings.............................................349Enable or disable SMB Multichannel.............................................. 349

Managing SMB shares.................................................................................350Create an SMB share......................................................................350Modify an SMB share..................................................................... 351Delete an SMB share......................................................................352Limit access to /ifs share for the Everyone account........................ 352Configure multi-protocol home directory access............................. 353Supported expansion variables......................................................353

Managing the NFS service........................................................................... 354

Chapter 8

Chapter 9

CONTENTS


View NFS settings...........................................................................354Configure NFS file sharing.............................................................. 354Enable or disable the NFS service...................................................355

Managing NFS exports.................................................................................355Configure default NFS export settings.............................................355Create a root-squashing rule for the default NFS export.................. 356Create an NFS export ..................................................................... 356Check NFS exports for errors.......................................................... 356Modify an NFS export..................................................................... 357Delete an NFS export......................................................................357

View FTP settings.........................................................................................357Enable FTP file sharing................................................................................ 358Configure FTP file sharing............................................................................ 358Enable and configure HTTP.......................................................................... 359SMB commands.......................................................................................... 360

isi smb log-level.............................................................................360isi smb log-level add...................................................................... 360isi smb log-level delete.................................................................. 362isi smb log-level list....................................................................... 362isi smb openfiles close...................................................................362isi smb openfiles list...................................................................... 363isi smb sessions delete..................................................................363isi smb sessions delete-user.......................................................... 364isi smb sessions list.......................................................................365isi smb settings global modify........................................................365isi smb settings global view........................................................... 368isi smb settings shares modify....................................................... 368isi smb settings shares view...........................................................372isi smb shares create..................................................................... 372isi smb shares delete..................................................................... 375isi smb shares list.......................................................................... 375isi smb shares modify.................................................................... 376isi smb shares permission create................................................... 380isi smb shares permission delete...................................................381isi smb shares permission list........................................................382isi smb shares permission modify.................................................. 382isi smb shares permission view......................................................383isi smb shares view........................................................................384

NFS commands........................................................................................... 384isi nfs exports check...................................................................... 384isi nfs exports create...................................................................... 385isi nfs exports delete......................................................................391isi nfs exports list...........................................................................391isi nfs exports modify.....................................................................393isi nfs exports reload......................................................................402isi nfs exports view.........................................................................403isi nfs netgroup bgwrite..................................................................403isi nfs netgroup check.................................................................... 403isi nfs netgroup expiration............................................................. 403isi nfs netgroup flush..................................................................... 404isi nfs netgroup lifetime................................................................. 404dealisi nfs netgroup retry............................................................... 404isi nfs nlm locks list....................................................................... 404isi nfs nlm locks waiters................................................................. 405isi nfs nlm sessions disconnect......................................................406isi nfs nlm sessions list.................................................................. 406

CONTENTS


isi nfs settings export modify......................................................... 407isi nfs settings export view............................................................. 414isi nfs settings global modify..........................................................415isi nfs settings global view............................................................. 415

FTP commands............................................................................................ 416isi ftp accept-timeout..................................................................... 416isi ftp allow-dirlists.........................................................................416isi ftp allow-anon-access................................................................416isi ftp allow-anon-upload............................................................... 417isi ftp allow-downloads.................................................................. 417isi ftp allow-local-access................................................................ 417isi ftp allow-writes..........................................................................418isi ftp always-chdir-homedir........................................................... 418isi ftp anon-chown-username.........................................................419isi ftp anon-password-list...............................................................419isi ftp anon-password-list add........................................................419isi ftp anon-password-list remove.................................................. 420isi ftp anon-root-path..................................................................... 420isi ftp anon-umask......................................................................... 421isi ftp ascii-mode........................................................................... 421isi ftp connect-timeout................................................................... 422isi ftp chroot-exception-list............................................................ 422isi ftp chroot-exception-list add......................................................422isi ftp chroot-exception-list remove................................................ 423isi ftp chroot-local-mode................................................................ 423isi ftp chroot-list-enable................................................................. 424isi ftp data-timeout........................................................................ 424isi ftp denied-user-list.................................................................... 425isi ftp denied-user-list add............................................................. 425isi ftp denied-user-list delete..........................................................425isi ftp dirlist-localtime.................................................................... 426isi ftp dirlist-names........................................................................ 426isi ftp file-create-perm....................................................................427isi ftp local-root-path......................................................................427isi ftp local-umask..........................................................................428isi ftp server-to-server.................................................................... 428isi ftp session-support................................................................... 429isi ftp session-timeout................................................................... 429isi ftp user-config-dir...................................................................... 430

Home directories 431

Home directories overview.......................................................................... 432Home directory permissions........................................................................432Authenticating SMB users........................................................................... 432Home directory creation through SMB......................................................... 432

Create home directories with expansion variables..........................433Create home directories with the --inheritable-path-acl option....... 434Create special home directories with the SMB share %U variable...435

Home directory creation through SSH and FTP............................................. 436Set the SSH or FTP login shell ........................................................ 436Set SSH/FTP home directory permissions.......................................436Set SSH/FTP home directory creation options.................................437Provision home directories with dot files........................................438

Home directory creation in a mixed environment......................................... 439Interactions between ACLs and mode bits................................................... 439

Chapter 10

CONTENTS


Default home directory settings in authentication providers........................ 439Supported expansion variables...................................................................440Domain variables in home directory provisioning........................................ 442

Snapshots 443

Snapshots overview.................................................................................... 444Data protection with SnapshotIQ.................................................................444Snapshot disk-space usage........................................................................ 444Snapshot schedules....................................................................................445Snapshot aliases........................................................................................ 445File and directory restoration.......................................................................445Best practices for creating snapshots..........................................................446Best practices for creating snapshot schedules...........................................446File clones...................................................................................................447

Shadow-store considerations.........................................................448Snapshot locks........................................................................................... 448Snapshot reserve........................................................................................ 449SnapshotIQ license functionality.................................................................449Creating snapshots with SnapshotIQ...........................................................449

Create a SnapRevert domain.......................................................... 450Create a snapshot schedule........................................................... 450Create a snapshot.......................................................................... 450Snapshot naming patterns............................................................. 451

Managing snapshots ..................................................................................453Reducing snapshot disk-space usage............................................ 453Delete a snapshot.......................................................................... 454Modify snapshot attributes............................................................ 454Modify a snapshot alias ................................................................ 454View snapshots..............................................................................455Snapshot information.................................................................... 455

Restoring snapshot data............................................................................. 456Revert a snapshot ......................................................................... 456Restore a file or directory using Windows Explorer..........................456Restore a file or directory through a UNIX command line.................457Clone a file from a snapshot...........................................................457

Managing snapshot schedules....................................................................458Modify a snapshot schedule ......................................................... 458Delete a snapshot schedule .......................................................... 458View snapshot schedules ..............................................................458

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

Managing with snapshot locks.................................................................... 461Create a snapshot lock...................................................................461Modify a snapshot lock expiration date..........................................461Delete a snapshot lock...................................................................462Snapshot lock information............................................................. 462

Configure SnapshotIQ settings ................................................................... 462SnapshotIQ settings ......................................................................463

Set the snapshot reserve.............................................................................464Snapshot commands.................................................................................. 464

Snapshot naming patterns............................................................. 464

Chapter 11

CONTENTS


isi snapshot schedules create........................................................467isi snapshot schedules modify.......................................................468isi snapshot schedules delete........................................................470isi snapshot schedules list.............................................................470isi snapshot schedules view.......................................................... 472isi snapshot schedules pending list............................................... 472isi snapshot snapshots create........................................................473isi snapshot snapshots modify.......................................................474isi snapshot snapshots delete....................................................... 475isi snapshot snapshots list............................................................ 475isi snapshot snapshots view.......................................................... 477isi snapshot settings modify.......................................................... 477isi snapshot settings view.............................................................. 479isi snapshot locks create................................................................479isi snapshot locks modify...............................................................480isi snapshot locks delete............................................................... 481isi snapshot locks list.................................................................... 482isi snapshot locks view.................................................................. 483isi snapshot aliases create.............................................................483isi snapshot aliases modify............................................................483isi snapshot aliases delete.............................................................484isi snapshot aliases list..................................................................484isi snapshot aliases view............................................................... 485

Deduplication with SmartDedupe 487

Deduplication overview...............................................................................488Deduplication jobs......................................................................................488Data replication and backup with deduplication..........................................489Snapshots with deduplication.....................................................................489Deduplication considerations......................................................................490Shadow-store considerations......................................................................490SmartDedupe license functionality..............................................................491Managing deduplication............................................................................. 491

Assess deduplication space savings ............................................. 491Specify deduplication settings ...................................................... 492View deduplication space savings .................................................492View a deduplication report ...........................................................492Deduplication job report information............................................. 493Deduplication information............................................................. 494

Deduplication commands........................................................................... 494isi dedupe settings modify............................................................. 494isi dedupe settings view.................................................................495isi dedupe stats............................................................................. 496isi dedupe reports list.................................................................... 496isi dedupe reports view ................................................................. 497

Data replication with SyncIQ 499

SyncIQ backup and recovery overview.........................................................500Replication policies and jobs...................................................................... 500

Automated replication policies.......................................................501Source and target cluster association.............................................501Full and differential replication.......................................................502Controlling replication job resource consumption.......................... 502Replication reports.........................................................................503

Chapter 12

Chapter 13

CONTENTS


Replication snapshots.................................................................................503Source cluster snapshots...............................................................503Target cluster snapshots................................................................ 504

Data failover and failback with SyncIQ.........................................................504Data failover.................................................................................. 505Data failback..................................................................................505

Recovery times and objectives for SyncIQ....................................................505SyncIQ license functionality........................................................................ 506Creating replication policies........................................................................506

Excluding directories in replication.................................................506Excluding files in replication.......................................................... 507File criteria options........................................................................ 508Configure default replication policy settings ..................................510Create a replication policy..............................................................510Create a SyncIQ domain................................................................. 511Assess a replication policy ............................................................ 511

Managing replication to remote clusters......................................................511Start a replication job.....................................................................512Pause a replication job ..................................................................512Resume a replication job ...............................................................512Cancel a replication job .................................................................512View active replication jobs ...........................................................513Replication job information ........................................................... 513

Initiating data failover and failback with SyncIQ.......................................... 513Fail over data to a secondary cluster ..............................................514Revert a failover operation............................................................. 514Fail back data to a primary cluster ................................................. 515

Performing disaster recovery for SmartLock directories................................515Recover SmartLock directories on a target cluster ..........................515Migrate SmartLock directories ....................................................... 516

Managing replication policies..................................................................... 518Modify a replication policy ............................................................ 518Delete a replication policy ............................................................. 518Enable or disable a replication policy ............................................ 519View replication policies ............................................................... 519Replication policy information .......................................................520

Managing replication to the local cluster..................................................... 520Cancel replication to the local cluster ............................................521Break local target association ....................................................... 521View replication policies targeting the local cluster........................ 521Remote replication policy information ........................................... 522

Managing replication performance rules..................................................... 522Create a network traffic rule ...........................................................522Create a file operations rule .......................................................... 522Modify a performance rule .............................................................523Delete a performance rule ............................................................. 523Enable or disable a performance rule ............................................ 523View performance rules .................................................................524

Managing replication reports.......................................................................524Configure default replication report settings ..................................524Delete replication reports...............................................................524View replication reports ................................................................ 525Replication report information........................................................526

Managing failed replication jobs................................................................. 527Resolve a replication policy ...........................................................527Reset a replication policy .............................................................. 527

CONTENTS


Perform a full or differential replication.......................................... 528Managing changelists................................................................................. 528

Create a changelist........................................................................ 529View a changelist........................................................................... 529Changelist information...................................................................530

Data replication commands.........................................................................532isi sync policies create................................................................... 532isi sync policies modify.................................................................. 540isi sync policies delete................................................................... 548isi sync policies list........................................................................ 549isi sync policies view......................................................................551isi sync policies disable................................................................. 552isi sync policies enable.................................................................. 552isi sync jobs start........................................................................... 552isi sync jobs pause.........................................................................553isi sync jobs resume.......................................................................553isi sync jobs cancel........................................................................ 554isi sync jobs list............................................................................. 554isi sync jobs view........................................................................... 555isi sync jobs reports list..................................................................555isi sync jobs reports view............................................................... 556isi sync settings modify..................................................................556isi sync settings view..................................................................... 557isi sync policies resolve................................................................. 557isi sync policies reset..................................................................... 558isi sync target cancel......................................................................558isi sync target list........................................................................... 558isi sync target view.........................................................................559isi sync target break....................................................................... 560isi sync target reports list............................................................... 560isi sync target reports view............................................................. 562isi sync target reports subreports list..............................................562isi sync target reports subreports view........................................... 564isi sync reports list......................................................................... 564isi sync reports view.......................................................................566isi sync reports rotate.....................................................................566isi sync reports subreports list....................................................... 566isi sync reports subreports view..................................................... 568isi sync recovery allow-write...........................................................568isi sync recovery resync-prep..........................................................569isi sync rules create........................................................................569isi sync rules modify.......................................................................570isi sync rules delete....................................................................... 571isi sync rules list............................................................................ 572isi sync rules view.......................................................................... 572isi_changelist_mod........................................................................573

Data layout with FlexProtect 577

FlexProtect overview....................................................................................578File striping................................................................................................. 578Requested data protection.......................................................................... 578FlexProtect data recovery.............................................................................579

Smartfail........................................................................................ 579Node failures................................................................................. 579

Requesting data protection......................................................................... 580

Chapter 14

CONTENTS


Requested protection settings.....................................................................580Requested protection disk space usage...................................................... 581

NDMP backup 583

NDMP backup and recovery overview.......................................................... 584NDMP two-way backup................................................................................584Snapshot-based incremental backups........................................................ 585NDMP protocol support............................................................................... 586Supported DMAs......................................................................................... 586NDMP hardware support............................................................................. 587NDMP backup limitations............................................................................587NDMP performance recommendations........................................................ 588Excluding files and directories from NDMP backups.................................... 589Configuring basic NDMP backup settings.................................................... 591

Configure and enable NDMP backup.............................................. 591Disable NDMP backup ...................................................................591View NDMP backup settings ..........................................................591NDMP backup settings .................................................................. 591

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

Managing NDMP backup devices.................................................................593Detect NDMP backup devices ........................................................593Modify an NDMP backup device entry name .................................. 593Delete a device entry for a disconnected NDMP backup device.......593View NDMP backup devices .......................................................... 594

Managing NDMP backup ports.................................................................... 594Modify NDMP backup port settings ................................................594Enable or disable an NDMP backup port.........................................594View NDMP backup ports .............................................................. 595NDMP backup port settings ........................................................... 595

Managing NDMP backup sessions...............................................................595End an NDMP session ................................................................... 595View NDMP sessions ..................................................................... 596NDMP session information ............................................................ 596

Managing restartable backups.................................................................... 597Configure restartable backups for EMC NetWorker..........................597View restartable backup contexts...................................................597Delete a restartable backup context............................................... 598Configure restartable backup settings............................................ 598View restartable backup settings................................................... 598

Managing file list backups.......................................................................... 599Format of a backup file list............................................................. 599Placement of the file list.................................................................600Start a file list backup.................................................................... 600

NDMP restore operations............................................................................ 601Parallel restore operation...............................................................601Serial restore operation..................................................................601Specify a serial restore operation................................................... 601

Sharing tape drives between clusters.......................................................... 601Managing default NDMP settings.................................................................602

Set default NDMP settings for a directory....................................... 602Modify default NDMP settings for a directory.................................. 602

Chapter 15

CONTENTS


View default NDMP settings for directories..................................... 603NDMP environment variables......................................................... 603

Managing snapshot based incremental backups.........................................606Enable snapshot-based incremental backups for a directory.......... 606Delete snapshots for snapshot-based incremental backups...........606View snapshots for snapshot-based incremental backups............. 607

View NDMP backup logs ............................................................................. 607NDMP backup commands........................................................................... 607

isi ndmp user create.......................................................................607isi ndmp user modify..................................................................... 608isi ndmp user delete...................................................................... 608isi ndmp user list........................................................................... 608isi tape rescan............................................................................... 609isi tape rename.............................................................................. 609isi tape delete................................................................................ 610isi tape list..................................................................................... 610isi fc set......................................................................................... 611isi fc disable.................................................................................. 612isi fc enable................................................................................... 612isi fc list......................................................................................... 613isi ndmp kill................................................................................... 614isi ndmp list...................................................................................614isi ndmp probe...............................................................................615isi ndmp settings set......................................................................615isi ndmp settings list......................................................................616isi ndmp settings variables create..................................................617isi ndmp settings variables modify.................................................617isi ndmp settings variables delete..................................................618isi ndmp settings variables list.......................................................619isi ndmp dumpdates delete........................................................... 619isi ndmp dumpdates list................................................................ 619isi ndmp extensions context delete................................................ 620isi ndmp extensions contexts list................................................... 620isi ndmp extensions contexts view................................................. 621isi ndmp extensions settings modify.............................................. 622isi ndmp extensions settings view..................................................622

File retention with SmartLock 623

SmartLock overview.................................................................................... 624Compliance mode....................................................................................... 624SmartLock directories................................................................................. 624Replication and backup with SmartLock...................................................... 625

SmartLock replication and backup limitations................................625SmartLock license functionality...................................................................626SmartLock considerations........................................................................... 626Set the compliance clock............................................................................ 627View the compliance clock.......................................................................... 627Creating a SmartLock directory.................................................................... 627

Retention periods...........................................................................627Autocommit time periods...............................................................628Create a SmartLock directory..........................................................628

Managing SmartLock directories................................................................. 629Modify a SmartLock directory......................................................... 629View SmartLock directory settings..................................................629SmartLock directory configuration settings.....................................630

Chapter 16

CONTENTS


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

SmartLock commands.................................................................................636isi worm domains create................................................................ 636isi worm domains modify............................................................... 639isi worm domains list..................................................................... 643isi worm domains view .................................................................. 644isi worm cdate set.......................................................................... 644isi worm cdate view........................................................................645isi worm files delete....................................................................... 645isi worm files view..........................................................................645

Protection domains 647

Protection domains overview...................................................................... 648Protection domain considerations...............................................................648Create a protection domain ........................................................................ 649Delete a protection domain ........................................................................ 649

Data-at-rest-encryption 651

Data-at-rest encryption overview................................................................. 652Self-encrypting drives..................................................................................652Data security on self-encrypted drives......................................................... 652Data migration to a self-encrypted-drives cluster.........................................653Chassis and drive states............................................................................. 653Smartfailed drive REPLACE state..................................................................656Smartfailed drive ERASE state..................................................................... 657

SmartQuotas 659

SmartQuotas overview................................................................................ 660Quota types................................................................................................ 660Default quota type.......................................................................................661Usage accounting and limits....................................................................... 663Disk-usage calculations.............................................................................. 664Quota notifications..................................................................................... 665Quota notification rules...............................................................................666Quota reports..............................................................................................666Creating quotas...........................................................................................667

Create an accounting quota........................................................... 667Create an enforcement quota......................................................... 667

Managing quotas........................................................................................ 668Search for quotas...........................................................................668Manage quotas.............................................................................. 668Export a quota configuration file.................................................... 669Import a quota configuration file.................................................... 670Managing quota notifications.........................................................670Email quota notification messages.................................................672Managing quota reports................................................................. 674

Chapter 17

Chapter 18

Chapter 19

CONTENTS


Basic quota settings...................................................................... 676Advisory limit quota notification rules settings...............................676Soft limit quota notification rules settings......................................677Hard limit quota notification rules settings.....................................678Limit notification settings...............................................................678Quota report settings..................................................................... 679

Quota commands........................................................................................680isi quota quotas create.................................................................. 680isi quota quotas delete.................................................................. 682isi quota quotas modify................................................................. 683isi quota quotas list....................................................................... 686isi quota quotas view..................................................................... 688isi quota quotas notifications clear................................................ 689isi quota quotas notifications create.............................................. 690isi quota quotas notifications delete.............................................. 693isi quota quotas notifications disable............................................ 694isi quota quotas notifications list................................................... 696isi quota quotas notifications modify............................................. 698isi quota quotas notifications view.................................................701isi quota reports create.................................................................. 702isi quota reports delete.................................................................. 703isi quota reports list....................................................................... 704isi quota settings notifications clear...............................................704isi quota settings notifications create.............................................704isi quota settings notifications delete............................................ 707isi quota settings notifications list................................................. 708isi quota settings notifications modify............................................708isi quota settings notifications view............................................... 710isi quota settings reports modify.................................................... 711isi quota settings reports view........................................................713

Storage Pools 715

Storage pools overview............................................................................... 716About storage pools.................................................................................... 716Autoprovisioning.........................................................................................717Virtual hot spare..........................................................................................718Spillover..................................................................................................... 718Node pools................................................................................................. 719

Manual node pool management.....................................................719SSD pools................................................................................................... 720L3 cache overview.......................................................................................721

Migration to L3 cache.....................................................................722Required privileges........................................................................ 722

Tiers............................................................................................................722File pools.................................................................................................... 723File pool policies......................................................................................... 723Managing node pools..................................................................................724

Create a node pool manually..........................................................724Add a node to a manually managed node pool...............................724Change the name or protection policy of a node pool..................... 725Remove a node from a manually managed node pool.....................725

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

Chapter 20

CONTENTS


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

Creating file pool policies............................................................................728Create a file pool policy..................................................................728File-matching options for file pool policies..................................... 729Valid wildcard characters............................................................... 731SmartPools settings....................................................................... 731Default file pool requested protection settings............................... 734Default file pool I/O optimization settings...................................... 735

Managing file pool policies......................................................................... 736Modify a file pool policy................................................................. 736Modify default storage pool settings.............................................. 737Configure default file pool policy settings.......................................737Prioritize a file pool policy.............................................................. 738Delete a file pool policy..................................................................738

Monitoring storage pools...........................................................

Documents

Isilon OneFS 7.1.1 CLI Administration Guide - Dell EMC US · Introduction to the OneFS command-line interface 41 ... OneFS 7.1.1 CLI Administration Guide 3. ... isi_gather_info