Isilon OneFS 7.2.0 CLI Administration Guide

IsilonOneFSVersion 7.2.0

CLI Administration Guide

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

Published July, 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.2.0 CLI Administration Guide

Introduction to this guide 25

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

Isilon scale-out NAS 27

OneFS storage architecture........................................................................... 28Isilon node components................................................................................28Internal and external networks...................................................................... 29Isilon cluster................................................................................................. 29

Cluster administration......................................................................29Quorum............................................................................................29Splitting and merging.......................................................................30Storage pools...................................................................................31IP address pools.............................................................................. 31

The OneFS operating system......................................................................... 31Data-access protocols......................................................................32Identity management and access control......................................... 32

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

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

VMware integration....................................................................................... 37Software modules......................................................................................... 38

Introduction to the OneFS command-line interface 39

OneFS command-line interface overview....................................................... 40Syntax diagrams........................................................................................... 40Universal options.......................................................................................... 41Command-line interface privileges................................................................ 41SmartLock compliance command permissions.............................................. 45OneFS time values.........................................................................................48

General cluster administration 49

General cluster administration overview........................................................50User interfaces.............................................................................................. 50Connecting to the cluster...............................................................................51

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

Chapter 1

Chapter 2

Chapter 3

Chapter 4

CONTENTS

OneFS 7.2.0 CLI Administration Guide 3

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

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

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

Cluster identity..............................................................................................58Set the cluster name ....................................................................... 58

Cluster contact information........................................................................... 59Specify contact information .............................................................59

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

SMTP email settings...................................................................................... 61Configure SMTP email settings ........................................................ 61View SMTP email settings.................................................................62

Configuring the cluster join mode..................................................................62Specify the cluster join mode .......................................................... 62

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

Cluster monitoring.........................................................................................64Monitor the cluster...........................................................................65View node status............................................................................. 65

Monitoring cluster hardware..........................................................................65View node hardware status.............................................................. 65Chassis and drive states.................................................................. 65Check battery status........................................................................ 68SNMP monitoring............................................................................. 68

Events and notifications................................................................................72Coalesced events.............................................................................72Viewing event information................................................................74Responding to events.......................................................................76Managing event notification settings................................................78Managing event notification rules.................................................... 80

Cluster maintenance..................................................................................... 82Replacing node components............................................................ 82Upgrading node components........................................................... 82Managing drive firmware..................................................................82Managing cluster nodes................................................................... 87Upgrading OneFS............................................................................. 89

Remote support.............................................................................................90Remote support using SupportIQ..................................................... 90Remote support using ESRS Gateway............................................... 93

Cluster administration commands.................................................................95isi config.......................................................................................... 96isi email......................................................................................... 100isi email list................................................................................... 101isi exttools..................................................................................... 101isi license activate......................................................................... 101isi license status............................................................................ 101

CONTENTS


isi license unconfigure................................................................... 102isi perfstat......................................................................................102isi pkg create................................................................................. 102isi pkg delete................................................................................. 102isi pkg info..................................................................................... 103isi pkg install................................................................................. 103isi remotesupport connectemc modify............................................104isi remotesupport connectemc view............................................... 105isi services.....................................................................................105isi set.............................................................................................106isi snmp.........................................................................................109isi snmp list................................................................................... 110isi statistics client.......................................................................... 110isi statistics describe..................................................................... 116isi statistics drive........................................................................... 116isi statistics heat............................................................................118isi statistics history........................................................................ 121isi statistics list all......................................................................... 123isi statistics list classes..................................................................124isi statistics list events...................................................................124isi statistics list nodes................................................................... 125isi statistics list nooutput...............................................................125isi statistics list operations............................................................ 126isi statistics list orderby................................................................. 126isi statistics list output...................................................................127isi statistics list protocols.............................................................. 127isi statistics list stats..................................................................... 128isi statistics list totalby.................................................................. 128isi statistics protocol......................................................................129isi 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..................................................................... 158isi servicelight off...........................................................................158

CONTENTS


isi 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.................................................................168Access zones best practices........................................................................169Access zone limits.......................................................................................169Quality of service........................................................................................ 170Managing access zones.............................................................................. 170

Create an access zone....................................................................170Associate an IP address pool with an access zone..........................171Modify an access zone................................................................... 171Add an authentication provider to an access zone..........................171Remove an authentication provider from an access zone............... 172Delete an access zone....................................................................172

Access zone commands.............................................................................. 172isi zone restrictions create............................................................. 172isi zone restrictions delete............................................................. 173isi zone restrictions list.................................................................. 174isi zone zones create......................................................................174isi zone zones delete..................................................................... 177isi zone zones list.......................................................................... 177isi zone zones modify.....................................................................178isi zone zones view........................................................................ 184

Authentication and access control 185

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

Roles and privileges.......................................................................186Data backup and restore privileges................................................ 197User permissions utility..................................................................198

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

Data access control.....................................................................................202Authorization.............................................................................................. 202

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

Managing roles........................................................................................... 205View roles...................................................................................... 205

Chapter 5

Chapter 6

CONTENTS


View privileges...............................................................................205Create and modify a custom role.................................................... 206Delete a custom role...................................................................... 206

Managing authentication providers............................................................. 206Managing LDAP providers.............................................................. 207Managing Active Directory providers.............................................. 208Managing NIS providers................................................................. 209Managing file providers..................................................................210Managing local users and groups...................................................214Managing MIT Kerberos authentication.......................................... 218

Managing access permissions.....................................................................225View expected user permissions.................................................... 226Configure access management settings......................................... 227Modify ACL policy settings..............................................................227Update cluster permissions............................................................227

Authentication and access control commands............................................ 228isi auth access............................................................................... 228isi auth ads create..........................................................................229isi auth ads delete......................................................................... 232isi auth ads list.............................................................................. 233isi auth ads modify.........................................................................234isi auth ads spn check................................................................... 237isi auth ads spn create................................................................... 238isi auth ads spn delete...................................................................238isi auth ads spn list........................................................................239isi auth ads trusts controllers list................................................... 240isi auth ads trusts list.....................................................................240isi auth ads trusts view.................................................................. 241isi auth ads view............................................................................ 241isi auth error.................................................................................. 241isi auth file create.......................................................................... 242isi auth file delete.......................................................................... 245isi auth file list............................................................................... 245isi auth file modify......................................................................... 246isi auth file view............................................................................. 252isi auth groups create.................................................................... 253isi auth groups delete.................................................................... 254isi auth groups flush...................................................................... 254isi auth groups list......................................................................... 255isi auth groups modify................................................................... 255isi auth groups members list.......................................................... 257isi auth groups view....................................................................... 258isi auth id.......................................................................................258isi auth krb5 realm create...............................................................258isi auth krb5 realm delete.............................................................. 259isi auth krb5 realm modify............................................................. 259isi auth krb5 realm list................................................................... 260isi auth krb5 realm view................................................................. 260isi auth krb5 create........................................................................ 260isi auth krb5 delete........................................................................ 261isi auth krb5 list............................................................................. 261isi auth krb5 view...........................................................................262isi auth krb5 domain create........................................................... 262isi auth krb5 domain delete........................................................... 262isi auth krb5 domain modify.......................................................... 263isi auth krb5 domain list................................................................ 263

CONTENTS


isi auth krb5 domain view.............................................................. 263isi auth krb5 spn create..................................................................264isi auth krb5 spn delete................................................................. 264isi auth krb5 spn check.................................................................. 264isi auth krb5 spn fix....................................................................... 265isi auth krb5 spn import................................................................. 265isi auth krb5 spn list...................................................................... 265isi auth settings krb5 modify..........................................................266isi auth settings krb5 view............................................................. 266isi auth ldap create........................................................................ 266isi auth ldap delete........................................................................ 273isi auth ldap list............................................................................. 274isi auth ldap modify....................................................................... 274isi auth ldap view...........................................................................284isi auth local list.............................................................................284isi auth local view.......................................................................... 284isi auth local modify.......................................................................285isi auth log-level............................................................................ 286isi auth mapping delete................................................................. 287isi auth mapping dump.................................................................. 288isi auth mapping flush................................................................... 289isi auth mapping idrange............................................................... 289isi auth mapping import................................................................. 291isi auth mapping view.................................................................... 291isi auth mapping modify................................................................ 292isi auth mapping create..................................................................293isi auth mapping token.................................................................. 294isi auth netgroups list.................................................................... 294isi auth nis create...........................................................................295isi auth nis delete.......................................................................... 298isi auth nis list............................................................................... 298isi auth nis modify..........................................................................299isi auth nis view............................................................................. 304isi auth privileges...........................................................................304isi auth refresh...............................................................................305isi auth roles create........................................................................305isi auth roles delete....................................................................... 305isi auth roles list............................................................................ 306isi auth roles members list............................................................. 306isi auth roles modify.......................................................................307isi auth roles privileges list.............................................................309isi auth roles view.......................................................................... 309isi auth settings global modify....................................................... 310isi auth settings global view........................................................... 312isi auth status................................................................................ 312isi auth users create.......................................................................313isi auth users delete.......................................................................315isi auth users flush.........................................................................315isi auth users list............................................................................316isi auth users modify......................................................................317isi auth users view......................................................................... 319

Identity management 321

Identity management overview....................................................................322Identity types.............................................................................................. 322

Chapter 7

CONTENTS


Access tokens............................................................................................. 323Access token generation............................................................................. 324

ID mapping.................................................................................... 324User mapping................................................................................ 326On-disk identity............................................................................. 328

Managing ID mappings............................................................................... 329Create an identity mapping............................................................ 329Modify an identity mapping............................................................330Delete an identity mapping............................................................ 330View an identity mapping...............................................................330Flush the identity mapping cache...................................................331View a user token...........................................................................331Configure identity mapping settings...............................................332View identity mapping settings...................................................... 332

Managing user identities.............................................................................332View user identity.......................................................................... 333Create a user-mapping rule............................................................ 334Merge Windows and UNIX tokens...................................................335Retrieve the primary group from LDAP............................................ 335Mapping rule options.....................................................................336Mapping rule operators..................................................................337

Auditing 339

Auditing overview........................................................................................340Syslog......................................................................................................... 340

Enable syslog.................................................................................340Syslog forwarding.......................................................................... 341

Protocol audit events.................................................................................. 341Sample config audit log................................................................. 342

Supported event types................................................................................ 343Supported audit tools................................................................................. 343Managing audit settings..............................................................................344

Enable system configuration auditing............................................ 344Enable protocol access auditing.....................................................345Auditing settings............................................................................346

Integrating with the EMC Common Event Enabler.........................................347Install CEE for Windows..................................................................347Configure CEE for Windows............................................................ 348

Auditing commands.................................................................................... 349isi audit settings modify.................................................................349isi audit settings view.................................................................... 351isi audit topics list..........................................................................352isi audit topics modify....................................................................352isi audit topics view....................................................................... 353

File sharing 355

File sharing overview...................................................................................356Mixed protocol environments.........................................................356Write caching with SmartCache...................................................... 357

SMB............................................................................................................ 358SMB shares in access zones.......................................................... 359SMB Multichannel..........................................................................359SMB share management through MMC.......................................... 361Symbolic links and SMB clients......................................................361

Chapter 8

Chapter 9

CONTENTS


Anonymous access to SMB shares................................................. 363Managing SMB settings................................................................. 363Managing SMB shares................................................................... 365SMB commands.............................................................................371

NFS............................................................................................................. 395NFS exports....................................................................................395NFS aliases.................................................................................... 395NFS log files................................................................................... 396Managing the NFS service.............................................................. 396Managing NFS exports................................................................... 397Managing NFS aliases.................................................................... 400NFS commands.............................................................................. 403

FTP..............................................................................................................444View FTP settings........................................................................... 444Enable FTP file sharing................................................................... 444Configure FTP file sharing............................................................... 445FTP commands...............................................................................445

HTTP and HTTPS.......................................................................................... 460Enable and configure HTTP.............................................................460

Home directories 463

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

Create home directories with expansion variables..........................465Create home directories with the --inheritable-path-acl option....... 466Create special home directories with the SMB share %U variable...467

Home directory creation through SSH and FTP............................................. 468Set the SSH or FTP login shell ........................................................ 468Set SSH/FTP home directory permissions.......................................468Set SSH/FTP home directory creation options.................................469Provision home directories with dot files........................................470

Home directory creation in a mixed environment......................................... 471Interactions between ACLs and mode bits................................................... 471Default home directory settings in authentication providers........................ 471Supported expansion variables...................................................................472Domain variables in home directory provisioning........................................ 474

Snapshots 475

Snapshots overview.................................................................................... 476Data protection with SnapshotIQ.................................................................476Snapshot disk-space usage........................................................................ 476Snapshot schedules....................................................................................477Snapshot aliases........................................................................................ 477File and directory restoration.......................................................................477Best practices for creating snapshots..........................................................478Best practices for creating snapshot schedules...........................................478File clones...................................................................................................479

Shadow-store considerations.........................................................480Snapshot locks........................................................................................... 480Snapshot reserve........................................................................................ 481SnapshotIQ license functionality.................................................................481Creating snapshots with SnapshotIQ...........................................................481

Chapter 10

Chapter 11

CONTENTS


Create a SnapRevert domain.......................................................... 482Create a snapshot schedule........................................................... 482Create a snapshot.......................................................................... 482Snapshot naming patterns............................................................. 483

Managing snapshots ..................................................................................485Reducing snapshot disk-space usage............................................ 485Delete a snapshot.......................................................................... 486Modify snapshot attributes............................................................ 486Modify a snapshot alias ................................................................ 486View snapshots..............................................................................487Snapshot information.................................................................... 487

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

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

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

Managing with snapshot locks.................................................................... 493Create a snapshot lock...................................................................493Modify a snapshot lock expiration date..........................................493Delete a snapshot lock...................................................................494Snapshot lock information............................................................. 494

Configure SnapshotIQ settings ................................................................... 494SnapshotIQ settings ......................................................................495

Set the snapshot reserve.............................................................................496Snapshot commands.................................................................................. 496

Snapshot naming patterns............................................................. 496isi snapshot schedules create........................................................499isi snapshot schedules modify.......................................................500isi snapshot schedules delete........................................................502isi snapshot schedules list.............................................................502isi snapshot schedules view.......................................................... 504isi snapshot schedules pending list............................................... 504isi snapshot snapshots create........................................................505isi snapshot snapshots modify.......................................................506isi snapshot snapshots delete....................................................... 507isi snapshot snapshots list............................................................ 507isi snapshot snapshots view.......................................................... 509isi snapshot settings modify.......................................................... 509isi snapshot settings view.............................................................. 511isi snapshot locks create................................................................511isi snapshot locks modify...............................................................512isi snapshot locks delete............................................................... 513isi snapshot locks list.................................................................... 514isi snapshot locks view.................................................................. 515isi snapshot aliases create.............................................................515isi snapshot aliases modify............................................................515

CONTENTS


isi snapshot aliases delete.............................................................516isi snapshot aliases list..................................................................516isi snapshot aliases view............................................................... 517

Deduplication with SmartDedupe 519

Deduplication overview...............................................................................520Deduplication jobs......................................................................................520Data replication and backup with deduplication..........................................521Snapshots with deduplication.....................................................................521Deduplication considerations......................................................................521Shadow-store considerations......................................................................522SmartDedupe license functionality..............................................................522Managing deduplication............................................................................. 522

Assess deduplication space savings ............................................. 523Specify deduplication settings ...................................................... 523View deduplication space savings .................................................524View a deduplication report ...........................................................524Deduplication job report information............................................. 524Deduplication information............................................................. 525

Deduplication commands........................................................................... 526isi dedupe settings modify............................................................. 526isi dedupe settings view.................................................................527isi dedupe stats............................................................................. 527isi dedupe reports list.................................................................... 528isi dedupe reports view ................................................................. 529

Data replication with SyncIQ 531

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

Automated replication policies.......................................................533Source and target cluster association.............................................533Full and differential replication.......................................................534Controlling replication job resource consumption.......................... 534Replication reports.........................................................................535

Replication snapshots.................................................................................535Source cluster snapshots...............................................................535Target cluster snapshots................................................................ 536

Data failover and failback with SyncIQ.........................................................536Data failover.................................................................................. 537Data failback..................................................................................537

Recovery times and objectives for SyncIQ....................................................537SyncIQ license functionality........................................................................ 538Creating replication policies........................................................................538

Excluding directories in replication.................................................538Excluding files in replication.......................................................... 539File criteria options........................................................................ 540Configure default replication policy settings ..................................542Create a replication policy..............................................................542Create a SyncIQ domain................................................................. 543Assess a replication policy ............................................................ 543

Managing replication to remote clusters......................................................543Start a replication job.....................................................................544Pause a replication job ..................................................................544Resume a replication job ...............................................................544

Chapter 12

Chapter 13

CONTENTS


Cancel a replication job .................................................................544View active replication jobs ...........................................................545Replication job information ........................................................... 545

Initiating data failover and failback with SyncIQ.......................................... 545Fail over data to a secondary cluster ..............................................546Revert a failover operation............................................................. 546Fail back data to a primary cluster ................................................. 547

Performing disaster recovery for SmartLock directories................................547Recover SmartLock directories on a target cluster ..........................547Migrate SmartLock directories ....................................................... 548

Managing replication policies..................................................................... 550Modify a replication policy ............................................................ 550Delete a replication policy ............................................................. 550Enable or disable a replication policy ............................................ 551View replication policies ............................................................... 551Replication policy information .......................................................552

Managing replication to the local cluster..................................................... 552Cancel replication to the local cluster ............................................553Break local target association ....................................................... 553View replication policies targeting the local cluster........................ 553Remote replication policy information ........................................... 554

Managing replication performance rules..................................................... 554Create a network traffic rule ...........................................................554Create a file operations rule .......................................................... 554Modify a performance rule .............................................................555Delete a performance rule ............................................................. 555Enable or disable a performance rule ............................................ 555View performance rules .................................................................556

Managing replication reports.......................................................................556Configure default replication report settings ..................................556Delete replication reports...............................................................556View replication reports ................................................................ 557Replication report information........................................................558

Managing failed replication jobs................................................................. 559Resolve a replication policy ...........................................................559Reset a replication policy .............................................................. 559Perform a full or differential replication.......................................... 560

Managing changelists................................................................................. 560Create a changelist........................................................................ 561View a changelist........................................................................... 561Changelist information...................................................................562

Data replication commands.........................................................................564isi sync policies create................................................................... 564isi sync policies modify.................................................................. 572isi sync policies delete................................................................... 580isi sync policies list........................................................................ 581isi sync policies view......................................................................583isi sync policies disable................................................................. 584isi sync policies enable.................................................................. 584isi sync jobs start........................................................................... 584isi sync jobs pause.........................................................................585isi sync jobs resume.......................................................................585isi sync jobs cancel........................................................................ 586isi sync jobs list............................................................................. 586isi sync jobs view........................................................................... 587isi sync jobs reports list..................................................................587

CONTENTS


isi sync jobs reports view............................................................... 588isi sync settings modify..................................................................588isi sync settings view..................................................................... 589isi sync policies resolve................................................................. 589isi sync policies reset..................................................................... 590isi sync target cancel......................................................................590isi sync target list........................................................................... 590isi sync target view.........................................................................591isi sync target break....................................................................... 592isi sync target reports list............................................................... 592isi sync target reports view............................................................. 594isi sync target reports subreports list..............................................594isi sync target reports subreports view........................................... 596isi sync reports list......................................................................... 596isi sync reports view.......................................................................598isi sync reports rotate.....................................................................598isi sync reports subreports list....................................................... 598isi sync reports subreports view..................................................... 600isi sync recovery allow-write...........................................................600isi sync recovery resync-prep..........................................................601isi sync rules create........................................................................601isi sync rules modify.......................................................................602isi sync rules delete....................................................................... 603isi sync rules list............................................................................ 604isi sync rules view.......................................................................... 604isi_changelist_mod........................................................................605

Data layout with FlexProtect 609

FlexProtect overview....................................................................................610File striping................................................................................................. 610Requested data protection.......................................................................... 610FlexProtect data recovery.............................................................................611

Smartfail........................................................................................ 611Node failures................................................................................. 611

Requesting data protection......................................................................... 612Requested protection settings.....................................................................612Requested protection disk space usage...................................................... 613

NDMP backup 615

NDMP backup and recovery overview.......................................................... 616NDMP two-way backup................................................................................616Snapshot-based incremental backups........................................................ 617NDMP protocol support............................................................................... 618Supported DMAs......................................................................................... 618NDMP hardware support............................................................................. 619NDMP backup limitations............................................................................619NDMP performance recommendations........................................................ 620Excluding files and directories from NDMP backups.................................... 621Configuring basic NDMP backup settings.................................................... 623

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

Managing NDMP user accounts................................................................... 624

Chapter 14

Chapter 15

CONTENTS


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

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

Managing NDMP backup ports.................................................................... 626Modify NDMP backup port settings ................................................626Enable or disable an NDMP backup port.........................................626View NDMP backup ports .............................................................. 627NDMP backup port settings ........................................................... 627

Managing NDMP backup sessions...............................................................627End an NDMP session ................................................................... 627View NDMP sessions ..................................................................... 628NDMP session information ............................................................ 628

Managing restartable backups.................................................................... 629Configure restartable backups for EMC NetWorker..........................629View restartable backup contexts...................................................630Delete a restartable backup context............................................... 630Configure restartable backup settings............................................ 630View restartable backup settings................................................... 631

Managing file list backups.......................................................................... 631Format of a backup file list............................................................. 632Placement of the file list.................................................................632Start a file list backup.................................................................... 632

Parallel restore operation............................................................................ 633Specify a serial restore operation................................................... 633

Sharing tape drives between clusters.......................................................... 634Managing default NDMP settings.................................................................634

Set default NDMP settings for a directory....................................... 634Modify default NDMP settings for a directory.................................. 634View default NDMP settings for directories..................................... 635NDMP environment variables......................................................... 635

Managing snapshot based incremental backups.........................................638Enable snapshot-based incremental backups for a directory.......... 638Delete snapshots for snapshot-based incremental backups...........638View snapshots for snapshot-based incremental backups............. 639

View NDMP backup logs ............................................................................. 639NDMP backup commands........................................................................... 639

isi ndmp user create.......................................................................639isi ndmp user modify..................................................................... 640isi ndmp user delete...................................................................... 640isi ndmp user list........................................................................... 640isi tape rescan............................................................................... 641isi tape rename.............................................................................. 641isi tape delete................................................................................ 642isi tape list..................................................................................... 642isi fc set......................................................................................... 643isi fc disable.................................................................................. 644isi fc enable................................................................................... 644isi fc list......................................................................................... 645isi ndmp kill................................................................................... 646isi ndmp list...................................................................................646

CONTENTS


isi ndmp probe...............................................................................647isi ndmp settings set......................................................................647isi ndmp settings list......................................................................648isi ndmp settings variables create..................................................649isi ndmp settings variables modify.................................................649isi ndmp settings variables delete..................................................650isi ndmp settings variables list.......................................................651isi ndmp dumpdates delete........................................................... 651isi ndmp dumpdates list................................................................ 651isi ndmp extensions context delete................................................ 652isi ndmp extensions contexts list................................................... 652isi ndmp extensions contexts view................................................. 653isi ndmp extensions settings modify.............................................. 654isi ndmp extensions settings view..................................................654

File retention with SmartLock 655

SmartLock overview.................................................................................... 656Compliance mode....................................................................................... 656SmartLock directories................................................................................. 656Replication and backup with SmartLock...................................................... 657

SmartLock replication and backup limitations................................657SmartLock license functionality...................................................................658SmartLock considerations........................................................................... 658Set the compliance clock............................................................................ 659View the compliance clock.......................................................................... 659Creating a SmartLock directory.................................................................... 659

Retention periods...........................................................................659Autocommit time periods...............................................................660Create a SmartLock directory..........................................................660

Managing SmartLock directories................................................................. 661Modify a SmartLock directory......................................................... 661View SmartLock directory settings..................................................661SmartLock directory configuration settings.....................................662

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

SmartLock commands.................................................................................668isi worm domains create................................................................ 668isi worm domains modify............................................................... 671isi worm domains list..................................................................... 675isi worm domains view .................................................................. 676isi worm cdate set.......................................................................... 676isi worm cdate view........................................................................677isi worm files delete....................................................................... 677isi worm files view..........................................................................677

Protection domains 679

Protection domains overview...................................................................... 680Protection domain considerations...............................................................680

Chapter 16

Chapter 17

CONTENTS


Create a protection domain ........................................................................ 681Delete a protection domain ........................................................................ 681

Data-at-rest-encryption 683

Data-at-rest encryption overview................................................................. 684Self-encrypting drives..................................................................................684Data security on self-encrypted drives......................................................... 684Data migration to a self-encrypted-drives cluster.........................................685Chassis and drive states............................................................................. 685Smartfailed drive REPLACE state..................................................................688Smartfailed drive ERASE state..................................................................... 689

SmartQuotas 691

SmartQuotas overview................................................................................ 692Quota types................................................................................................ 692Default quota type.......................................................................................693Usage accounting and limits....................................................................... 695Disk-usage calculations.............................................................................. 696Quota notifications..................................................................................... 697Quota notification rules...............................................................................697Quota reports..............................................................................................698Creating quotas...........................................................................................698

Create an accounting quota........................................................... 699Create an enforcement quota......................................................... 699

Managing quotas........................................................................................ 700Search for quotas...........................................................................700Manage quotas.............................................................................. 700Export a quota configuration file.................................................... 701Import a quota configuration file.................................................... 702Managing quota notifications.........................................................702Email quota notification messages.................................................704Managing quota reports................................................................. 706Basic quota settings...................................................................... 708Advisory limit quota notification rules settings...............................708Soft limit quota notification rules settings......................................709Hard limit quota notification rules settings.....................................710Limit notification settings...............................................................710Quota report settings..................................................................... 711

Quota commands........................................................................................712isi quota quotas create.................................................................. 712isi quota quotas delete.................................................................. 714isi quota quotas modify................................................................. 715isi quota quotas list....................................................................... 718isi quota quotas view..................................................................... 720isi quota quotas notifications clear................................................ 721isi quota quotas notifications create.............................................. 722isi quota quotas notifications delete.............................................. 725isi quota quotas notifications disable............................................ 726isi quota quotas notifications list................................................... 728isi quota quotas notifications modify............................................. 730isi quota quotas notifications view.................................................733isi quota reports create.................................................................. 734isi quota reports delete.................................................................. 735isi quota reports list....................................................................... 736

Chapter 18

Chapter 19

CONTENTS


isi quota settings notifications clear...............................................736isi quota settings notifications create.............................................736isi quota settings notifications delete............................................ 739isi quota settings notifications list................................................. 740isi quota settings notifications modify............................................740isi quota settings notifications view............................................... 742isi quota settings reports modify.................................................... 743isi quota settings reports view........................................................745

Storage Pools 747

Storage pools overview............................................................................... 748Storage pool functions................................................................................ 748Autoprovisioning.........................................................................................750Node pools................................................................................................. 750

Node compatibilities......................................................................750Manual node pools........................................................................ 751

Virtual hot spare..........................................................................................751Spillover..................................................................................................... 752Suggested protection.................................................................................. 752Protection policies...................................................................................... 753SSD strategies.............................................................................................753Global namespace acceleration.................................................................. 754L3 cache overview.......................................................................................755

Migration to L3 cache.....................................................................756L3 cache on HD400 node pools......................................................756

Tiers............................................................................................................756File pool policies......................................................................................... 756Managing node pools through the command-line interface......................... 757

Add a compatible node to a node pool...........................................758Merge compatible node pools........................................................758Delete a compatibility.................................................................... 759Create a node pool manually..........................................................759Add a node to a manually managed node pool...............................760Change the name or protection policy of a node pool..................... 760Remove a node from a manually managed node pool.....................760

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

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

Creating file pool policies............................................................................763Create a file pool policy..................................................................764File-matching options for file pool policies..................................... 764Valid wildcard characters............................................................... 766SmartPools settings....................................................................... 766Default file pool requested protection settings............................... 769Default file pool I/O optimization settings...................................... 770

Managing file pool policies......................................................................... 771Modify a file pool policy................................................................. 771Modify default storage pool settings.............................................. 772Configure default file pool policy settings.......................................772

Chapter 20

CONTENTS


Prioritize a file pool policy.............................................................. 773Delete a file pool policy..................................................................773

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

Storage pool commands............................................................................. 775isi filepool apply............................................................................ 775isi filepool default-policy modify.................................................... 777isi filepool default-policy view........................................................779isi filepool policies create.............................................................. 779isi filepool policies delete.............................................................. 782isi filepool policies list................................................................... 783isi filepool policies modify............................................................. 783isi filepool policies view................................................................. 787isi filepool templates list................................................................787isi filepool templates view..............................................................788isi storagepool compatibilities active create...................................788isi storagepool compatibilities active delete.................................. 789isi storagepool compatibilities active list....................................... 789isi storagepool compatibilities active view..................................... 790isi storagepool compatibilities available list.................................. 791isi storagepool health.................................................................... 792isi storagepool list......................................................................... 792isi storagepool nodepools create................................................... 792isi storagepool nodepools delete................................................... 793isi storagepool nodepools list........................................................ 793isi storagepool nodepools modify.................................................. 794isi storagepool nodepools view......................................................795isi storagepool settings modify...................................................... 796isi storagepool settings view.......................................................... 797isi storagepool tiers create............................................................. 797isi storagepool tiers delete.............................................................798isi storagepool tiers list..................................................................798isi storagepool tiers modify............................................................ 799isi storagepool tiers view................................................................799

System jobs 801

System jobs overview..................................................................................802System jobs library......................................................................................802Job operation.............................................................................................. 805Job performance impact.............................................................................. 806Job priorities............................................................................................... 807Managing system jobs................................................................................ 807

Start a job...................................................................................... 808Pause a job.................................................................................... 808Modify a job...................................................................................808Resume a job................................................................................. 809Cancel a job................................................................................... 809Modify job type settings.................................................................810View active jobs............................................................................. 810View job history............................................................................. 810

Managing impact policies........................................................................... 811Create an impact policy..................................................................811View impact policy settings............................................................812

Chapter 21

CONTENTS


Modify an impact policy................................................................. 812Delete an impact policy..................................................................813

Viewing job reports and statistics................................................................813View statistics for a job in progress................................................ 813View a report for a completed job...................................................814

Job management commands....................................................................... 815isi job events list............................................................................815isi job jobs cancel.......................................................................... 817isi job jobs list............................................................................... 817isi job jobs modify..........................................................................818isi job jobs pause...........................................................................819isi job jobs resume.........................................................................820isi job jobs start............................................................................. 820isi job jobs view............................................................................. 822isi job policies create..................................................................... 823isi job policies delete..................................................................... 823isi job policies list.......................................................................... 824isi job policies modify.................................................................... 825isi job policies view........................................................................826isi job reports list................................................................

Documents

Isilon OneFS 7.2.0 CLI Administration Guide