+ All Categories
Home > Documents > Onefs Cli Administration Guide 7 2

Onefs Cli Administration Guide 7 2

Date post: 05-Sep-2015
Category:
Upload: eshu0123456789
View: 314 times
Download: 17 times
Share this document with a friend
Description:
onefs
Popular Tags:
928
Isilon OneFS Version 7.2 CLI Administration Guide
Transcript
  • IsilonOneFSVersion 7.2

    CLI Administration Guide

  • Copyright 2013-2014 EMC Corporation. All rights reserved. Published in USA.Published November, 2014EMC 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 CLI Administration Guide

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

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

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

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

    Structure of the file system............................................................................35Data layout...................................................................................... 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 41OneFS command-line interface overview....................................................... 42Syntax diagrams........................................................................................... 42Universal options.......................................................................................... 43Command-line interface privileges................................................................ 43SmartLock compliance command permissions.............................................. 47OneFS time values.........................................................................................50

    General cluster administration 51General 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.2 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..........................................59

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

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

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

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

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

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

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

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

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

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

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

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

    CONTENTS

    4 OneFS 7.2 CLI Administration Guide

  • isi license status............................................................................ 101isi license unconfigure................................................................... 101isi perfstat......................................................................................101isi pkg create................................................................................. 101isi pkg delete................................................................................. 102isi pkg info..................................................................................... 102isi pkg install................................................................................. 103isi 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

    OneFS 7.2 CLI Administration Guide 5

  • 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 167Access zones overview ............................................................................... 168Access zone base directory rules.................................................................168Access zones best practices........................................................................169Access zone limits.......................................................................................169Quality of service........................................................................................ 170Managing access zones.............................................................................. 171

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

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

    Authentication and access control 185Authentication 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........................................................................................... 205

    Chapter 5

    Chapter 6

    CONTENTS

    6 OneFS 7.2 CLI Administration Guide

  • View roles...................................................................................... 205View 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.................................................... 225Configure access management settings......................................... 226Modify 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.............................................................................. 232isi auth ads modify.........................................................................233isi auth ads spn check................................................................... 237isi auth ads spn create................................................................... 237isi auth ads spn delete...................................................................238isi auth ads spn list........................................................................239isi auth ads trusts controllers list................................................... 239isi auth ads trusts list.....................................................................240isi auth ads trusts view.................................................................. 240isi auth ads view............................................................................ 240isi auth error.................................................................................. 241isi auth file create.......................................................................... 241isi auth file delete.......................................................................... 244isi auth file list............................................................................... 245isi auth file modify......................................................................... 245isi auth file view............................................................................. 252isi auth groups create.................................................................... 252isi auth groups delete.................................................................... 253isi auth groups flush...................................................................... 254isi auth groups list......................................................................... 254isi auth groups modify................................................................... 255isi auth groups members list.......................................................... 256isi auth groups view....................................................................... 257isi auth id.......................................................................................257isi auth krb5 realm create...............................................................258isi auth krb5 realm delete.............................................................. 258isi auth krb5 realm modify............................................................. 258isi auth krb5 realm list................................................................... 259isi auth krb5 realm view................................................................. 259isi auth krb5 create........................................................................ 260isi auth krb5 delete........................................................................ 260isi auth krb5 list............................................................................. 261isi auth krb5 view...........................................................................261isi auth krb5 domain create........................................................... 261isi auth krb5 domain delete........................................................... 262isi auth krb5 domain modify.......................................................... 262

    CONTENTS

    OneFS 7.2 CLI Administration Guide 7

  • isi auth krb5 domain list................................................................ 262isi auth krb5 domain view.............................................................. 263isi auth krb5 spn create..................................................................263isi auth krb5 spn delete................................................................. 263isi auth krb5 spn check.................................................................. 264isi auth krb5 spn fix....................................................................... 264isi auth krb5 spn import................................................................. 264isi auth krb5 spn list...................................................................... 265isi auth settings krb5 modify..........................................................265isi auth settings krb5 view............................................................. 266isi auth ldap create........................................................................ 266isi auth ldap delete........................................................................ 272isi auth ldap list............................................................................. 273isi auth ldap modify....................................................................... 273isi auth ldap view...........................................................................283isi auth local list.............................................................................283isi auth local view.......................................................................... 283isi auth local modify.......................................................................284isi auth log-level............................................................................ 285isi auth mapping delete................................................................. 286isi auth mapping dump.................................................................. 287isi auth mapping flush................................................................... 288isi auth mapping idrange............................................................... 288isi auth mapping import................................................................. 290isi auth mapping view.................................................................... 290isi auth mapping modify................................................................ 291isi auth mapping create..................................................................292isi auth mapping token.................................................................. 293isi auth netgroups list.................................................................... 293isi auth nis create...........................................................................294isi auth nis delete.......................................................................... 297isi auth nis list............................................................................... 297isi auth nis modify..........................................................................298isi auth nis view............................................................................. 303isi auth privileges...........................................................................303isi auth refresh...............................................................................304isi auth roles create........................................................................304isi auth roles delete....................................................................... 304isi auth roles list............................................................................ 305isi auth roles members list............................................................. 305isi auth roles modify.......................................................................306isi auth roles privileges list.............................................................308isi auth roles view.......................................................................... 308isi auth settings global modify....................................................... 309isi auth settings global view........................................................... 311isi auth status................................................................................ 311isi auth users create.......................................................................312isi auth users delete.......................................................................314isi auth users flush.........................................................................314isi auth users list............................................................................315isi auth users modify......................................................................316isi auth users view......................................................................... 318

    Identity management 319Identity management overview....................................................................320

    Chapter 7

    CONTENTS

    8 OneFS 7.2 CLI Administration Guide

  • Identity types.............................................................................................. 320Access tokens............................................................................................. 321Access token generation............................................................................. 322

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

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

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

    Auditing 337Auditing overview........................................................................................338Protocol audit events.................................................................................. 338Supported event types................................................................................ 338Supported audit tools................................................................................. 339Managing audit settings..............................................................................340

    Enable system configuration auditing............................................ 340Enable protocol access auditing.....................................................340Auditing settings............................................................................341

    Integrating with the EMC Common Event Enabler.........................................342Install CEE for Windows..................................................................343Configure CEE for Windows............................................................ 344

    Auditing commands.................................................................................... 344isi audit settings modify.................................................................344isi audit settings view.................................................................... 346isi audit topics list..........................................................................347isi audit topics modify....................................................................348isi audit topics view....................................................................... 348

    File sharing 349File sharing overview...................................................................................350SMB............................................................................................................ 350

    SMB shares in access zones.......................................................... 351SMB Multichannel..........................................................................351SMB share management through MMC.......................................... 353Symbolic links through SMB.......................................................... 354Anonymous access to SMB shares................................................. 355

    NFS............................................................................................................. 355NFS exports....................................................................................355NFS aliases.................................................................................... 356NFS log files................................................................................... 356

    Chapter 8

    Chapter 9

    CONTENTS

    OneFS 7.2 CLI Administration Guide 9

  • HTTP and HTTPS.......................................................................................... 357FTP..............................................................................................................357Mixed protocol environments......................................................................357Write caching with SmartCache................................................................... 357

    Write caching for asynchronous writes........................................... 358Write caching for synchronous writes............................................. 358

    Managing SMB settings...............................................................................359View global SMB settings...............................................................359Configure global SMB settings....................................................... 359Enable or disable the SMB service................................................. 359Enable or disable SMB Multichannel.............................................. 360View default SMB share settings.................................................... 360Configure default SMB share settings.............................................361Enable or disable SMB Multichannel.............................................. 361

    Managing SMB shares.................................................................................361Create an SMB share......................................................................362Modify an SMB share..................................................................... 363Delete an SMB share......................................................................364Limit access to /ifs share for the Everyone account........................ 364Configure anonymous access to a single SMB share...................... 364Configure anonymous access to all SMB shares in an access zone.365Configure multi-protocol home directory access............................. 366Supported expansion variables......................................................366

    Managing the NFS service........................................................................... 367View NFS settings...........................................................................367Configure NFS file sharing.............................................................. 367Enable or disable the NFS service...................................................368

    Managing NFS exports.................................................................................368Configure default NFS export settings.............................................368Create a root-squashing rule for an export......................................369Create an NFS export ..................................................................... 369Check NFS exports for errors.......................................................... 370Modify an NFS export..................................................................... 370Delete an NFS export......................................................................370

    Managing NFS aliases................................................................................. 371Create an NFS alias........................................................................ 371Modify an NFS alias........................................................................371Delete an NFS alias........................................................................ 372List NFS aliases..............................................................................372View an NFS alias...........................................................................373

    View FTP settings.........................................................................................373Enable FTP file sharing................................................................................ 374Configure FTP file sharing............................................................................ 374Enable and configure HTTP.......................................................................... 374SMB commands.......................................................................................... 376

    isi smb log-level.............................................................................376isi smb log-level add...................................................................... 376isi smb log-level delete.................................................................. 377isi smb log-level list....................................................................... 377isi smb openfiles close...................................................................378isi smb openfiles list...................................................................... 378isi smb sessions delete..................................................................379isi smb sessions delete-user.......................................................... 379isi smb sessions list.......................................................................380isi smb settings global modify........................................................381isi smb settings global view........................................................... 383

    CONTENTS

    10 OneFS 7.2 CLI Administration Guide

  • isi smb settings shares modify....................................................... 384isi smb settings shares view...........................................................387isi smb shares create..................................................................... 387isi smb shares delete..................................................................... 390isi smb shares list.......................................................................... 391isi smb shares modify.................................................................... 391isi smb shares permission create................................................... 396isi smb shares permission delete...................................................396isi smb shares permission list........................................................397isi smb shares permission modify.................................................. 398isi smb shares permission view......................................................399isi smb shares view........................................................................399

    NFS commands........................................................................................... 400isi nfs log-level...............................................................................400isi nfs aliases create...................................................................... 401isi nfs aliases delete...................................................................... 401isi nfs aliases list........................................................................... 402isi nfs aliases modify..................................................................... 403isi nfs aliases view......................................................................... 403isi nfs exports check...................................................................... 404isi nfs exports create...................................................................... 405isi nfs exports delete......................................................................411isi nfs exports list...........................................................................412isi nfs exports modify.....................................................................414isi nfs exports reload......................................................................425isi nfs exports view.........................................................................425isi nfs netgroup bgwrite..................................................................425isi nfs netgroup check.................................................................... 425isi nfs netgroup expiration............................................................. 426isi nfs netgroup flush..................................................................... 426isi nfs netgroup lifetime................................................................. 426isi nfs netgroup retry...................................................................... 426isi nfs nlm locks list....................................................................... 427isi nfs nlm locks waiters................................................................. 428isi nfs nlm sessions disconnect......................................................429isi nfs nlm sessions list.................................................................. 429isi nfs settings export modify......................................................... 430isi nfs settings export view............................................................. 438isi nfs settings global modify..........................................................439isi nfs settings global view............................................................. 440isi nfs settings zone modify............................................................440isi nfs settings zone view............................................................... 441

    FTP commands............................................................................................ 441isi ftp accept-timeout..................................................................... 441isi ftp allow-dirlists.........................................................................442isi ftp allow-anon-access................................................................442isi ftp allow-anon-upload............................................................... 443isi ftp allow-downloads.................................................................. 443isi ftp allow-local-access................................................................ 443isi ftp allow-writes..........................................................................444isi ftp always-chdir-homedir........................................................... 444isi ftp anon-chown-username.........................................................445isi ftp anon-password-list...............................................................445isi ftp anon-password-list add........................................................445isi ftp anon-password-list remove.................................................. 446isi ftp anon-root-path..................................................................... 446

    CONTENTS

    OneFS 7.2 CLI Administration Guide 11

  • isi ftp anon-umask......................................................................... 447isi ftp ascii-mode........................................................................... 447isi ftp connect-timeout................................................................... 448isi ftp chroot-exception-list............................................................ 448isi ftp chroot-exception-list add......................................................448isi ftp chroot-exception-list remove................................................ 449isi ftp chroot-local-mode................................................................ 449isi ftp chroot-list-enable................................................................. 450isi ftp data-timeout........................................................................ 450isi ftp denied-user-list.................................................................... 451isi ftp denied-user-list add............................................................. 451isi ftp denied-user-list delete..........................................................451isi ftp dirlist-localtime.................................................................... 452isi ftp dirlist-names........................................................................ 452isi ftp file-create-perm....................................................................453isi ftp local-root-path......................................................................453isi ftp local-umask..........................................................................454isi ftp server-to-server.................................................................... 454isi ftp session-support................................................................... 455isi ftp session-timeout................................................................... 455isi ftp user-config-dir...................................................................... 456

    Home directories 457Home directories overview.......................................................................... 458Home directory permissions........................................................................458Authenticating SMB users........................................................................... 458Home directory creation through SMB......................................................... 458

    Create home directories with expansion variables..........................459Create home directories with the --inheritable-path-acl option....... 460Create special home directories with the SMB share %U variable...461

    Home directory creation through SSH and FTP............................................. 462Set the SSH or FTP login shell ........................................................ 462Set SSH/FTP home directory permissions.......................................462Set SSH/FTP home directory creation options.................................463Provision home directories with dot files........................................464

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

    Snapshots 469Snapshots overview.................................................................................... 470Data protection with SnapshotIQ.................................................................470Snapshot disk-space usage........................................................................ 470Snapshot schedules....................................................................................471Snapshot aliases........................................................................................ 471File and directory restoration.......................................................................471Best practices for creating snapshots..........................................................472Best practices for creating snapshot schedules...........................................472File clones...................................................................................................473

    Shadow-store considerations.........................................................474Snapshot locks........................................................................................... 474Snapshot reserve........................................................................................ 475

    Chapter 10

    Chapter 11

    CONTENTS

    12 OneFS 7.2 CLI Administration Guide

  • SnapshotIQ license functionality.................................................................475Creating snapshots with SnapshotIQ...........................................................475

    Create a SnapRevert domain.......................................................... 476Create a snapshot schedule........................................................... 476Create a snapshot.......................................................................... 476Snapshot naming patterns............................................................. 477

    Managing snapshots ..................................................................................479Reducing snapshot disk-space usage............................................ 479Delete a snapshot.......................................................................... 480Modify snapshot attributes............................................................ 480Modify a snapshot alias ................................................................ 480View snapshots..............................................................................481Snapshot information.................................................................... 481

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

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

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

    Managing with snapshot locks.................................................................... 487Create a snapshot lock...................................................................487Modify a snapshot lock expiration date..........................................487Delete a snapshot lock...................................................................488Snapshot lock information............................................................. 488

    Configure SnapshotIQ settings ................................................................... 488SnapshotIQ settings ......................................................................489

    Set the snapshot reserve.............................................................................490Snapshot commands.................................................................................. 490

    Snapshot naming patterns............................................................. 490isi snapshot schedules create........................................................493isi snapshot schedules modify.......................................................494isi snapshot schedules delete........................................................496isi snapshot schedules list.............................................................496isi snapshot schedules view.......................................................... 498isi snapshot schedules pending list............................................... 498isi snapshot snapshots create........................................................499isi snapshot snapshots modify.......................................................500isi snapshot snapshots delete....................................................... 501isi snapshot snapshots list............................................................ 501isi snapshot snapshots view.......................................................... 503isi snapshot settings modify.......................................................... 503isi snapshot settings view.............................................................. 505isi snapshot locks create................................................................505isi snapshot locks modify...............................................................506isi snapshot locks delete............................................................... 507isi snapshot locks list.................................................................... 508isi snapshot locks view.................................................................. 509

    CONTENTS

    OneFS 7.2 CLI Administration Guide 13

  • isi snapshot aliases create.............................................................509isi snapshot aliases modify............................................................509isi snapshot aliases delete.............................................................510isi snapshot aliases list..................................................................510isi snapshot aliases view............................................................... 511

    Deduplication with SmartDedupe 513Deduplication overview...............................................................................514Deduplication jobs......................................................................................514Data replication and backup with deduplication..........................................515Snapshots with deduplication.....................................................................515Deduplication considerations......................................................................515Shadow-store considerations......................................................................516SmartDedupe license functionality..............................................................516Managing deduplication............................................................................. 516

    Assess deduplication space savings ............................................. 517Specify deduplication settings ...................................................... 517View deduplication space savings .................................................518View a deduplication report ...........................................................518Deduplication job report information............................................. 518Deduplication information............................................................. 519

    Deduplication commands........................................................................... 520isi dedupe settings modify............................................................. 520isi dedupe settings view.................................................................521isi dedupe stats............................................................................. 521isi dedupe reports list.................................................................... 522isi dedupe reports view ................................................................. 522

    Data replication with SyncIQ 525SyncIQ backup and recovery overview.........................................................526Replication policies and jobs...................................................................... 526

    Automated replication policies.......................................................527Source and target cluster association.............................................527Full and differential replication.......................................................528Controlling replication job resource consumption.......................... 528Replication reports.........................................................................529

    Replication snapshots.................................................................................529Source cluster snapshots...............................................................529Target cluster snapshots................................................................ 530

    Data failover and failback with SyncIQ.........................................................530Data failover.................................................................................. 531Data failback..................................................................................531

    Recovery times and objectives for SyncIQ....................................................531SyncIQ license functionality........................................................................ 532Creating replication policies........................................................................532

    Excluding directories in replication.................................................532Excluding files in replication.......................................................... 533File criteria options........................................................................ 534Configure default replication policy settings ..................................536Create a replication policy..............................................................536Create a SyncIQ domain................................................................. 537Assess a replication policy ............................................................ 537

    Managing replication to remote clusters......................................................537Start a replication job.....................................................................538

    Chapter 12

    Chapter 13

    CONTENTS

    14 OneFS 7.2 CLI Administration Guide

  • Pause a replication job ..................................................................538Resume a replication job ...............................................................538Cancel a replication job .................................................................538View active replication jobs ...........................................................539Replication job information ........................................................... 539

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

    Performing disaster recovery for SmartLock directories................................541Recover SmartLock directories on a target cluster ..........................541Migrate SmartLock directories ....................................................... 542

    Managing replication policies..................................................................... 543Modify a replication policy ............................................................ 543Delete a replication policy ............................................................. 544Enable or disable a replication policy ............................................ 544View replication policies ............................................................... 544Replication policy information .......................................................545

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

    Managing replication performance rules..................................................... 547Create a network traffic rule ...........................................................547Create a file operations rule .......................................................... 548Modify a performance rule .............................................................548Delete a performance rule ............................................................. 548Enable or disable a performance rule ............................................ 548View performance rules .................................................................549

    Managing replication reports.......................................................................549Configure default replication report settings ..................................549Delete replication reports...............................................................549View replication reports ................................................................ 550Replication report information........................................................551

    Managing failed replication jobs................................................................. 552Resolve a replication policy ...........................................................553Reset a replication policy .............................................................. 553Perform a full or differential replication.......................................... 553

    Managing changelists................................................................................. 554Create a changelist........................................................................ 554View a changelist........................................................................... 555Changelist information...................................................................555

    Data replication commands.........................................................................557isi sync policies create................................................................... 557isi sync policies modify.................................................................. 565isi sync policy delete......................................................................574isi sync policies list........................................................................ 574isi sync policies view......................................................................577isi sync policies disable................................................................. 577isi sync policies enable.................................................................. 577isi sync jobs start........................................................................... 578isi sync jobs pause.........................................................................578isi sync jobs resume.......................................................................579isi sync jobs cancel........................................................................ 579isi sync jobs list............................................................................. 579

    CONTENTS

    OneFS 7.2 CLI Administration Guide 15

  • isi sync jobs view........................................................................... 580isi sync jobs reports list..................................................................580isi sync jobs reports view............................................................... 581isi sync settings modify..................................................................581isi sync settings view..................................................................... 582isi sync policies resolve................................................................. 583isi sync policies reset..................................................................... 583isi sync target cancel......................................................................583isi sync target list........................................................................... 584isi sync target view.........................................................................585isi sync target break....................................................................... 585isi sync target reports list............................................................... 586isi sync target reports view............................................................. 587isi sync target reports subreports list..............................................588isi sync target reports subreports view........................................... 589isi sync reports list......................................................................... 589isi sync reports view.......................................................................591isi sync reports rotate.....................................................................591isi sync reports subreports list....................................................... 591isi sync reports subreports view..................................................... 593isi sync recovery allow-write...........................................................593isi sync recovery resync-prep..........................................................594isi sync rules create........................................................................594isi sync rules modify.......................................................................595isi sync rules delete....................................................................... 597isi sync rules list............................................................................ 597isi sync rules view.......................................................................... 598isi_changelist_mod........................................................................598

    Data layout with FlexProtect 601FlexProtect overview....................................................................................602File striping................................................................................................. 602Requested data protection.......................................................................... 602FlexProtect data recovery.............................................................................603

    Smartfail........................................................................................ 603Node failures................................................................................. 603

    Requesting data protection......................................................................... 604Requested protection settings.....................................................................604Requested protection disk space usage...................................................... 605

    NDMP backup 607NDMP backup and recovery overview.......................................................... 608NDMP two way backup................................................................................ 608Snapshot-based incremental backups........................................................ 609NDMP protocol support............................................................................... 610Supported DMAs......................................................................................... 610NDMP hardware support............................................................................. 611NDMP backup limitations............................................................................611NDMP performance recommendations........................................................ 611Excluding files and directories from NDMP backups.................................... 613Configuring basic NDMP backup settings.................................................... 614

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

    Chapter 14

    Chapter 15

    CONTENTS

    16 OneFS 7.2 CLI Administration Guide

  • NDMP backup settings .................................................................. 615Managing NDMP user accounts................................................................... 615

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

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

    Managing NDMP backup ports.................................................................... 617Modify NDMP backup port settings ................................................617Enable or disable an NDMP backup port.........................................617View NDMP backup ports .............................................................. 617NDMP backup port settings ........................................................... 618

    Managing NDMP backup sessions...............................................................618End an NDMP session ................................................................... 618View NDMP sessions ..................................................................... 618NDMP session information ............................................................ 619

    Managing restartable backups.................................................................... 619Configure restartable backups for EMC NetWorker..........................620View restartable backup contexts...................................................620Delete a restartable backup context............................................... 621Configure restartable backup settings............................................ 621View restartable backup settings................................................... 621

    Managing file list backups.......................................................................... 621Format of a backup file list............................................................. 622Placement of the file list.................................................................623Start a file list backup.................................................................... 623

    Improving NDMP restore performance......................................................... 623Specify a serial restore operation................................................... 624

    Sharing tape drives between clusters.......................................................... 624Managing default NDMP settings.................................................................625

    Set default NDMP settings for a directory....................................... 625Modify default NDMP settings for a directory.................................. 625View default NDMP settings for directories..................................... 625NDMP environment variables......................................................... 626

    Managing snapshot based incremental backups.........................................628Enable snapshot-based incremental backups for a directory.......... 628Delete snapshots for snapshot-based incremental backups...........629View snapshots for snapshot-based incremental backups............. 629

    View NDMP backup logs ............................................................................. 629NDMP backup commands........................................................................... 629

    isi ndmp user create.......................................................................629isi ndmp user modify..................................................................... 630isi ndmp user delete...................................................................... 630isi ndmp user list........................................................................... 631isi tape rescan............................................................................... 631isi tape rename.............................................................................. 632isi tape delete................................................................................ 632isi tape list..................................................................................... 632isi fc set......................................................................................... 633isi fc disable.................................................................................. 634isi fc enable................................................................................... 635isi fc list......................................................................................... 635

    CONTENTS

    OneFS 7.2 CLI Administration Guide 17

  • isi ndmp kill................................................................................... 636isi ndmp list...................................................................................636isi ndmp probe...............................................................................637isi ndmp settings set......................................................................637isi ndmp settings list......................................................................639isi ndmp settings variables create..................................................639isi ndmp settings variables modify.................................................640isi ndmp settings variables delete..................................................640isi ndmp settings variables list.......................................................641isi ndmp dumpdates delete........................................................... 641isi ndmp dumpdates list................................................................ 642isi ndmp extensions context delete................................................ 642isi ndmp extensions contexts list................................................... 643isi ndmp extensions contexts view................................................. 643isi ndmp extensions settings modify.............................................. 644isi ndmp extensions settings view..................................................644

    File retention with SmartLock 645SmartLock overview.................................................................................... 646Compliance mode....................................................................................... 646SmartLock directories................................................................................. 646Replication and backup with SmartLock...................................................... 647

    SmartLock replication and backup limitations................................647SmartLock license functionality...................................................................648SmartLock considerations........................................................................... 648Set the compliance clock............................................................................ 649View the compliance clock.......................................................................... 649Creating a SmartLock directory.................................................................... 649

    Retention periods...........................................................................649Autocommit time periods...............................................................650Create a SmartLock directory..........................................................650

    Managing SmartLock directories................................................................. 651Modify a SmartLock directory......................................................... 651View SmartLock directory settings..................................................651SmartLock directory configuration settings.....................................652

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

    SmartLock commands.................................................................................658isi worm domains create................................................................ 658isi worm domains modify............................................................... 661isi worm domains list..................................................................... 665isi worm domains view .................................................................. 666isi worm cdate set.......................................................................... 666isi worm cdate view........................................................................667isi worm files delete....................................................................... 667isi worm files view..........................................................................667

    Protection domains 669

    Chapter 16

    Chapter 17

    CONTENTS

    18 OneFS 7.2 CLI Administration Guide

  • Protection domains overview...................................................................... 670Protection domain considerations...............................................................670Create a protection domain ........................................................................ 671Delete a protection domain ........................................................................ 671

    Data-at-rest-encryption 673Data-at-rest encryption overview................................................................. 674Self-encrypting drives..................................................................................674Data security on self-encrypted drives......................................................... 674Data migration to a self-encrypted-drives cluster.........................................675Chassis and drive states............................................................................. 675Smartfailed drive ERASE and REPLACE state examples................................ 678

    SmartQuotas 681SmartQuotas overview................................................................................ 682Quota types................................................................................................ 682Default quota type.......................................................................................683Usage accounting and limits....................................................................... 685Disk-usage calculations.............................................................................. 686Quota notifications..................................................................................... 687Quota notification rules...............................................................................687Quota reports..............................................................................................688Creating quotas...........................................................................................688

    Create an accounting quota........................................................... 689Create an enforcement quota......................................................... 689

    Managing quotas........................................................................................ 690Search for quotas...........................................................................690Manage quotas.............................................................................. 690Export a quota configuration file.................................................... 691Import a quota configuration file.................................................... 691Managing quota notifications.........................................................692Managing quota reports................................................................. 694Basic quota settings...................................................................... 696Advisory limit quota notification rules settings...............................696Soft limit quota notification rules settings......................................697Hard limit quota notification rules settings.....................................698Limit notification settings...............................................................698Quota report settings..................................................................... 698Custom email notification template variable descriptions.............. 699

    Quota commands........................................................................................700isi quota quotas create.................................................................. 700isi quota quotas delete.................................................................. 702isi quota quotas modify................................................................. 703isi quota quotas list....................................................................... 706isi quota quotas view..................................................................... 708isi quota quotas notifications clear................................................ 709isi quota quotas notifications create.............................................. 710isi quota quotas notifications delete.............................................. 712isi quota quotas notifications disable............................................ 714isi quota quotas notifications list................................................... 715isi quota quotas notifications modify............................................. 717isi quota quotas notifications view.................................................720isi quota reports create.................................................................. 722isi quota reports delete.................................................................. 722

    Chapter 18

    Chapter 19

    CONTENTS

    OneFS 7.2 CLI Administration Guide 19

  • isi quota reports list....................................................................... 723isi quota settings notifications clear...............................................724isi quota settings notifications create.............................................724isi quota settings notifications delete............................................ 726isi quota settings notifications list................................................. 727isi quota settings notifications modify............................................727isi quota settings notifications view............................................... 729isi quota settings reports modify.................................................... 730isi quota settings reports view........................................................731

    Storage Pools 733Storage pools overview............................................................................... 734Storage pool functions................................................................................ 734Autoprovisioning.........................................................................................736Virtual hot spare..........................................................................................736Spillover..................................................................................................... 737Node pools................................................................................................. 737

    Node compatibilities......................................................................737Manual node pools........................................................................ 738

    Suggested protection.................................................................................. 739Protection policies..................


Recommended