-
IsilonOneFSVersion 7.1.1
CLI Administration Guide
-
Copyright 2013-2014 EMC Corporation. All rights reserved. Published in USA.Published July, 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.1.1 CLI Administration Guide
-
Introduction to this guide 27About this guide............................................................................................28Isilon scale-out NAS overview........................................................................28Where to go for support.................................................................................28
Isilon scale-out NAS 29OneFS storage architecture........................................................................... 30Isilon node components................................................................................30Internal and external networks...................................................................... 31Isilon cluster................................................................................................. 31
Cluster administration......................................................................31Quorum............................................................................................31Splitting and merging.......................................................................32Storage pools...................................................................................33IP address pools.............................................................................. 33
The OneFS operating system......................................................................... 33Data-access protocols......................................................................34Identity management and access control......................................... 34
Structure of the file system............................................................................35Data layout...................................................................................... 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.........................................................................................49
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.1.1 CLI Administration Guide 3
-
Open an SSH connection to a cluster................................................53Licensing.......................................................................................................53
License status..................................................................................54License configuration.......................................................................56Activate a license through the command-line interface.....................57View license information.................................................................. 57Unconfigure a license.......................................................................57
Certificates....................................................................................................58Replace or renew the SSL certificate.................................................58Verify an SSL certificate update........................................................59Self-signed SSL certificate data example..........................................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........................................................................... 63
File system settings.......................................................................................64Specify the cluster character encoding............................................. 64Enable or disable access time tracking ............................................64
Cluster monitoring.........................................................................................65Monitor the cluster...........................................................................65View node status............................................................................. 66
Monitoring cluster hardware..........................................................................66View node hardware status.............................................................. 66Chassis and drive states.................................................................. 66Check battery status........................................................................ 68SNMP monitoring............................................................................. 69
Events and notifications................................................................................72Coalesced events.............................................................................72Viewing event information................................................................74Responding to events.......................................................................77Managing event notification settings................................................78Managing event notification rules.................................................... 80
Cluster maintenance..................................................................................... 82Replacing node components............................................................ 82Upgrading node components........................................................... 82Managing drive firmware..................................................................82Managing cluster nodes................................................................... 85Upgrading OneFS............................................................................. 86
Remote support.............................................................................................87Remote support using SupportIQ..................................................... 87Remote support using ESRS Gateway............................................... 90
Cluster administration commands.................................................................92isi config.......................................................................................... 92isi email........................................................................................... 96isi email list..................................................................................... 97isi exttools....................................................................................... 97isi license activate........................................................................... 97
CONTENTS
4 OneFS 7.1.1 CLI Administration Guide
-
isi license status.............................................................................. 98isi license unconfigure..................................................................... 98isi perfstat........................................................................................98isi pkg create................................................................................... 98isi pkg delete................................................................................... 98isi pkg info....................................................................................... 99isi pkg install................................................................................... 99isi remotesupport connectemc modify............................................100isi remotesupport connectemc view............................................... 100isi services.....................................................................................101isi set.............................................................................................101isi snmp.........................................................................................104isi snmp list................................................................................... 105isi statistics client.......................................................................... 105isi statistics describe..................................................................... 111isi statistics drive........................................................................... 111isi statistics heat............................................................................113isi statistics history........................................................................ 117isi statistics list all......................................................................... 119isi statistics list classes..................................................................119isi statistics list events...................................................................120isi statistics list nodes................................................................... 120isi statistics list nooutput...............................................................121isi statistics list operations............................................................ 121isi statistics list orderby................................................................. 121isi statistics list output...................................................................122isi statistics list protocols.............................................................. 122isi statistics list stats..................................................................... 123isi statistics list totalby.................................................................. 123isi statistics protocol......................................................................124isi statistics pstat...........................................................................129isi statistics query.......................................................................... 131isi statistics system........................................................................132isi status........................................................................................134isi update.......................................................................................134isi version...................................................................................... 135isi_for_array...................................................................................136isi get.............................................................................................138isi_gather_info...............................................................................139
Event commands.........................................................................................143isi events cancel............................................................................ 143isi events list..................................................................................144isi events notifications create.........................................................145isi events notifications modify........................................................147isi events notifications delete........................................................ 148isi events notifications list............................................................. 148isi events quiet.............................................................................. 148isi events sendtest......................................................................... 149isi events settings list.................................................................... 149isi events settings set.....................................................................149isi events show.............................................................................. 149isi events unquiet.......................................................................... 150
Hardware commands.................................................................................. 150isi batterystatus............................................................................. 150isi devices......................................................................................151isi servicelight status..................................................................... 152
CONTENTS
OneFS 7.1.1 CLI Administration Guide 5
-
isi servicelight off...........................................................................152isi servicelight on...........................................................................153isi drivefirmware status..................................................................153isi firmware package...................................................................... 153isi firmware status..........................................................................154isi firmware update........................................................................ 155isi readonly off............................................................................... 156isi readonly on............................................................................... 157isi readonly show........................................................................... 158
Access zones 159Access zones overview ............................................................................... 160Access zone base-directory rules.................................................................161Access zones best practices........................................................................162Quality of service........................................................................................ 162Access zone limits.......................................................................................163Configuring an access zone.........................................................................164
Create an IP address pool for an access zone................................. 164Configure a SmartConnect zone for an access zone........................ 164Create an access zone....................................................................165Add an access zone to an existing IP address pool......................... 165Add an authentication provider to an access zone..........................166
Managing access zones.............................................................................. 166Modify an access zone................................................................... 166Delete an access zone....................................................................166Associate an IP address pool with an access zone..........................167Remove an authentication provider from an access zone............... 167
Access zone commands.............................................................................. 167isi zone restrictions create............................................................. 167isi zone restrictions delete............................................................. 168isi zone restrictions list.................................................................. 169isi zone zones create......................................................................169isi zone zones delete..................................................................... 172isi zone zones list.......................................................................... 172isi zone zones modify.....................................................................173isi zone zones view........................................................................ 178
Authentication and access control 179Authentication and access control overview................................................ 180Role-based access...................................................................................... 180
Roles and privileges.......................................................................180Data backup and restore privileges................................................ 191User permissions utility..................................................................192
Authentication............................................................................................ 192Supported authentication providers...............................................192Authentication provider features.................................................... 193Kerberos authentication.................................................................193LDAP.............................................................................................. 193Active Directory.............................................................................. 193NIS.................................................................................................194File provider................................................................................... 194Local provider................................................................................ 195
Data access control.....................................................................................195Authorization.............................................................................................. 195
Chapter 5
Chapter 6
CONTENTS
6 OneFS 7.1.1 CLI Administration Guide
-
SMB...............................................................................................196NFS................................................................................................ 196Mixed-permission environments.................................................... 197
Managing roles........................................................................................... 198View roles...................................................................................... 198View privileges...............................................................................198Create and modify a custom role.................................................... 199Delete a custom role...................................................................... 199
Managing authentication providers............................................................. 199Managing LDAP providers.............................................................. 200Managing Active Directory providers.............................................. 201Managing NIS providers................................................................. 203Managing file providers..................................................................203Managing local users and groups...................................................207
Managing access permissions.....................................................................211View expected user permissions.................................................... 211Configure access management settings......................................... 212Modify ACL policy settings..............................................................212Update cluster permissions............................................................212
Authentication and access control commands............................................ 213isi auth access............................................................................... 213isi auth ads create..........................................................................214isi auth ads delete......................................................................... 217isi auth ads list.............................................................................. 217isi auth ads modify.........................................................................218isi auth ads spn check................................................................... 222isi auth ads spn create................................................................... 222isi auth ads spn delete...................................................................223isi auth ads spn list........................................................................223isi auth ads trusts controllers list................................................... 224isi auth ads trusts list.....................................................................224isi auth ads trusts view.................................................................. 225isi auth ads view............................................................................ 225isi auth error.................................................................................. 225isi auth file create.......................................................................... 225isi auth file delete.......................................................................... 228isi auth file list............................................................................... 229isi auth file modify......................................................................... 229isi auth file view............................................................................. 236isi auth groups create.................................................................... 236isi auth groups delete.................................................................... 237isi auth groups flush...................................................................... 238isi auth groups list......................................................................... 238isi auth groups modify................................................................... 239isi auth groups members list.......................................................... 240isi auth groups view....................................................................... 241isi auth id.......................................................................................241isi auth krb5 add realm.................................................................. 241isi auth krb5 delete default............................................................ 242isi auth krb5 delete domain........................................................... 243isi auth krb5 delete realm.............................................................. 243isi auth krb5 list............................................................................. 244isi auth krb5 modify default........................................................... 244isi auth krb5 modify domain.......................................................... 245isi auth krb5 modify realm............................................................. 245isi auth krb5 write.......................................................................... 246
CONTENTS
OneFS 7.1.1 CLI Administration Guide 7
-
isi auth ldap create........................................................................ 246isi auth ldap delete........................................................................ 252isi auth ldap list............................................................................. 253isi auth ldap modify....................................................................... 253isi auth ldap view...........................................................................263isi auth local list.............................................................................263isi auth local view.......................................................................... 263isi auth local modify.......................................................................263isi auth log-level............................................................................ 265isi auth mapping delete................................................................. 266isi auth mapping dump.................................................................. 267isi auth mapping flush................................................................... 267isi auth mapping idrange............................................................... 268isi auth mapping import................................................................. 269isi auth mapping list...................................................................... 269isi auth mapping modify................................................................ 270isi auth mapping new.....................................................................272isi auth mapping token.................................................................. 273isi auth mapping upgrade-db......................................................... 273isi auth netgroups list.................................................................... 274isi auth nis create...........................................................................274isi auth nis delete.......................................................................... 277isi auth nis list............................................................................... 278isi auth nis modify..........................................................................278isi auth nis view............................................................................. 283isi auth privileges...........................................................................284isi auth refresh...............................................................................284isi auth roles create........................................................................284isi auth roles delete....................................................................... 285isi auth roles list............................................................................ 285isi auth roles members list............................................................. 286isi auth roles modify.......................................................................286isi auth roles privileges list.............................................................288isi auth roles view.......................................................................... 289isi auth settings global modify....................................................... 289isi auth settings global view........................................................... 291isi auth status................................................................................ 292isi auth users create.......................................................................293isi auth users delete.......................................................................294isi auth users flush.........................................................................295isi auth users list............................................................................295isi auth users modify......................................................................296isi auth users view......................................................................... 298
Identity management 301Identity management overview....................................................................302Identity types.............................................................................................. 302Access tokens............................................................................................. 303Access token generation............................................................................. 304
ID mapping.................................................................................... 304User mapping across systems and identities..................................306On-disk identity............................................................................. 308
Managing user identities.............................................................................309View user identity.......................................................................... 309Create a user-mapping rule............................................................ 310
Chapter 7
CONTENTS
8 OneFS 7.1.1 CLI Administration Guide
-
Merge Windows and UNIX tokens...................................................312Retrieve the primary group from LDAP............................................ 312Mapping rule options.....................................................................312Mapping rule operators..................................................................313
Auditing 315Auditing overview........................................................................................316Protocol audit events.................................................................................. 316Supported event types................................................................................ 316Supported audit tools................................................................................. 317Managing audit settings..............................................................................318
Enable system configuration auditing............................................ 318Enable protocol access auditing.....................................................318Auditing settings............................................................................319
Integrating with the EMC Common Event Enabler.........................................320Install CEE for Windows..................................................................320Configure CEE for Windows............................................................ 321
Auditing commands.................................................................................... 322isi audit settings modify.................................................................322isi audit settings view.................................................................... 324isi audit topics list..........................................................................324isi audit topics modify....................................................................325isi audit topics view....................................................................... 325
File sharing 327File sharing overview...................................................................................328SMB............................................................................................................ 328
SMB shares in access zones.......................................................... 329SMB Multichannel..........................................................................330SMB share management through MMC.......................................... 331Symbolic links through SMB.......................................................... 332
NFS............................................................................................................. 333HTTP and HTTPS.......................................................................................... 333FTP..............................................................................................................333Mixed protocol environments......................................................................333Write caching with SmartCache................................................................... 334
Write caching for asynchronous writes........................................... 334Write caching for synchronous writes............................................. 335
Managing SMB settings...............................................................................335View global SMB settings...............................................................335Configure global SMB settings....................................................... 335Enable or disable the SMB service................................................. 336Enable or disable SMB Multichannel.............................................. 336View default SMB share settings.................................................... 336Configure default SMB share settings.............................................337Enable or disable SMB Multichannel.............................................. 337
Managing SMB shares.................................................................................337Create an SMB share......................................................................338Modify an SMB share..................................................................... 339Delete an SMB share......................................................................340Limit access to /ifs share for the Everyone account........................ 340Configure multi-protocol home directory access............................. 340Supported expansion variables......................................................341
Managing the NFS service........................................................................... 342
Chapter 8
Chapter 9
CONTENTS
OneFS 7.1.1 CLI Administration Guide 9
-
View NFS settings...........................................................................342Configure NFS file sharing.............................................................. 342Enable or disable the NFS service...................................................342
Managing NFS exports.................................................................................343Configure default NFS export settings.............................................343Create a root-squashing rule for the default NFS export.................. 343Create an NFS export ..................................................................... 344Check NFS exports for errors.......................................................... 344Modify an NFS export..................................................................... 344Delete an NFS export......................................................................345
View FTP settings.........................................................................................345Enable FTP file sharing................................................................................ 346Configure FTP file sharing............................................................................ 346Enable and configure HTTP.......................................................................... 346SMB commands.......................................................................................... 348
isi smb log-level.............................................................................348isi smb log-level add...................................................................... 348isi smb log-level delete.................................................................. 349isi smb log-level list....................................................................... 349isi smb openfiles close...................................................................350isi smb openfiles list...................................................................... 350isi smb sessions delete..................................................................351isi smb sessions delete-user.......................................................... 351isi smb sessions list.......................................................................352isi smb settings global modify........................................................353isi smb settings global view........................................................... 355isi smb settings shares modify....................................................... 355isi smb settings shares view...........................................................359isi smb shares create..................................................................... 359isi smb shares delete..................................................................... 362isi smb shares list.......................................................................... 362isi smb shares modify.................................................................... 363isi smb shares permission create................................................... 367isi smb shares permission delete...................................................368isi smb shares permission list........................................................369isi smb shares permission modify.................................................. 369isi smb shares permission view......................................................370isi smb shares view........................................................................370
NFS commands........................................................................................... 371isi nfs exports check...................................................................... 371isi nfs exports create...................................................................... 371isi nfs exports delete......................................................................377isi nfs exports list...........................................................................378isi nfs exports modify.....................................................................379isi nfs exports reload......................................................................389isi nfs exports view.........................................................................389isi nfs netgroup bgwrite..................................................................389isi nfs netgroup check.................................................................... 389isi nfs netgroup expiration............................................................. 389isi nfs netgroup flush..................................................................... 390isi nfs netgroup lifetime................................................................. 390dealisi nfs netgroup retry............................................................... 390isi nfs nlm locks list....................................................................... 390isi nfs nlm locks waiters................................................................. 391isi nfs nlm sessions disconnect......................................................392isi nfs nlm sessions list.................................................................. 392
CONTENTS
10 OneFS 7.1.1 CLI Administration Guide
-
isi nfs settings export modify......................................................... 393isi nfs settings export view............................................................. 400isi nfs settings global modify..........................................................401isi nfs settings global view............................................................. 401
FTP commands............................................................................................ 402isi ftp accept-timeout..................................................................... 402isi ftp allow-dirlists.........................................................................402isi ftp allow-anon-access................................................................402isi ftp allow-anon-upload............................................................... 403isi ftp allow-downloads.................................................................. 403isi ftp allow-local-access................................................................ 403isi ftp allow-writes..........................................................................404isi ftp always-chdir-homedir........................................................... 404isi ftp anon-chown-username.........................................................404isi ftp anon-password-list...............................................................405isi ftp anon-password-list add........................................................405isi ftp anon-password-list remove.................................................. 405isi ftp anon-root-path..................................................................... 406isi ftp anon-umask......................................................................... 406isi ftp ascii-mode........................................................................... 407isi ftp connect-timeout................................................................... 407isi ftp chroot-exception-list............................................................ 407isi ftp chroot-exception-list add......................................................408isi ftp chroot-exception-list remove................................................ 408isi ftp chroot-local-mode................................................................ 408isi ftp chroot-list-enable................................................................. 409isi ftp data-timeout........................................................................ 409isi ftp denied-user-list.................................................................... 410isi ftp denied-user-list add............................................................. 410isi ftp denied-user-list delete..........................................................410isi ftp dirlist-localtime.................................................................... 411isi ftp dirlist-names........................................................................ 411isi ftp file-create-perm....................................................................412isi ftp local-root-path......................................................................412isi ftp local-umask..........................................................................413isi ftp server-to-server.................................................................... 413isi ftp session-support................................................................... 413isi ftp session-timeout................................................................... 414isi ftp user-config-dir...................................................................... 414
Home directories 415Home directories overview.......................................................................... 416Home directory permissions........................................................................416Authenticating SMB users........................................................................... 416Home directory creation through SMB......................................................... 416
Create home directories with expansion variables..........................417Create home directories with the --inheritable-path-acl option....... 418Create special home directories with the SMB share %U variable...419
Home directory creation through SSH and FTP............................................. 419Set the SSH or FTP login shell ........................................................ 419Set SSH/FTP home directory permissions.......................................420Set SSH/FTP home directory creation options.................................421Provision home directories with dot files........................................421
Home directory creation in a mixed environment......................................... 422Interactions between ACLs and mode bits................................................... 422
Chapter 10
CONTENTS
OneFS 7.1.1 CLI Administration Guide 11
-
Default home directory settings in authentication providers........................ 423Supported expansion variables...................................................................424Domain variables in home directory provisioning........................................ 425
Snapshots 427Snapshots overview.................................................................................... 428Data protection with SnapshotIQ.................................................................428Snapshot disk-space usage........................................................................ 428Snapshot schedules....................................................................................429Snapshot aliases........................................................................................ 429File and directory restoration.......................................................................429Best practices for creating snapshots..........................................................430Best practices for creating snapshot schedules...........................................430File clones...................................................................................................431
Shadow-store considerations.........................................................432Snapshot locks........................................................................................... 432Snapshot reserve........................................................................................ 433SnapshotIQ license functionality.................................................................433Creating snapshots with SnapshotIQ...........................................................433
Create a SnapRevert domain.......................................................... 434Create a snapshot schedule........................................................... 434Create a snapshot.......................................................................... 434Snapshot naming patterns............................................................. 434
Managing snapshots ..................................................................................437Reducing snapshot disk-space usage............................................ 437Delete a snapshot.......................................................................... 437Modify snapshot attributes............................................................ 438Modify a snapshot alias ................................................................ 438View snapshots..............................................................................438Snapshot information.................................................................... 439
Restoring snapshot data............................................................................. 439Revert a snapshot ......................................................................... 439Restore a file or directory using Windows Explorer..........................440Restore a file or directory through a UNIX command line.................441Clone a file from a snapshot...........................................................441
Managing snapshot schedules....................................................................441Modify a snapshot schedule ......................................................... 441Delete a snapshot schedule .......................................................... 442View snapshot schedules ..............................................................442
Managing snapshot aliases.........................................................................443Configure a snapshot alias for a snapshot schedule.......................443Assign a snapshot alias to a snapshot........................................... 443Reassign a snapshot alias to the live file system............................ 443View snapshot aliases................................................................... 443Snapshot alias information............................................................ 444
Managing with snapshot locks.................................................................... 444Create a snapshot lock...................................................................444Modify a snapshot lock expiration date..........................................445Delete a snapshot lock...................................................................445Snapshot lock information............................................................. 445
Configure SnapshotIQ settings ................................................................... 446SnapshotIQ settings ......................................................................446
Set the snapshot reserve.............................................................................447Snapshot commands.................................................................................. 448
Snapshot naming patterns............................................................. 448
Chapter 11
CONTENTS
12 OneFS 7.1.1 CLI Administration Guide
-
isi snapshot schedules create........................................................450isi snapshot schedules modify.......................................................452isi snapshot schedules delete........................................................453isi snapshot schedules list.............................................................454isi snapshot schedules view.......................................................... 455isi snapshot schedules pending list............................................... 455isi snapshot snapshots create........................................................456isi snapshot snapshots modify.......................................................457isi snapshot snapshots delete....................................................... 458isi snapshot snapshots list............................................................ 458isi snapshot snapshots view.......................................................... 460isi snapshot settings modify.......................................................... 460isi snapshot settings view.............................................................. 462isi snapshot locks create................................................................462isi snapshot locks modify...............................................................463isi snapshot locks delete............................................................... 464isi snapshot locks list.................................................................... 464isi snapshot locks view.................................................................. 465isi snapshot aliases create.............................................................466isi snapshot aliases modify............................................................466isi snapshot aliases delete.............................................................466isi snapshot aliases list..................................................................467isi snapshot aliases view............................................................... 468
Deduplication with SmartDedupe 469Deduplication overview...............................................................................470Deduplication jobs......................................................................................470Data replication and backup with deduplication..........................................471Snapshots with deduplication.....................................................................471Deduplication considerations......................................................................471Shadow-store considerations......................................................................472SmartDedupe license functionality..............................................................472Managing deduplication............................................................................. 472
Assess deduplication space savings ............................................. 473Specify deduplication settings ...................................................... 473View deduplication space savings .................................................473View a deduplication report ...........................................................474Deduplication job report information............................................. 474Deduplication information............................................................. 475
Deduplication commands........................................................................... 476isi dedupe settings modify............................................................. 476isi dedupe settings view.................................................................477isi dedupe stats............................................................................. 477isi dedupe reports list.................................................................... 477isi dedupe reports view ................................................................. 478
Data replication with SyncIQ 481SyncIQ backup and recovery overview.........................................................482Replication policies and jobs...................................................................... 482
Automated replication policies.......................................................483Source and target cluster association.............................................483Full and differential replication.......................................................484Controlling replication job resource consumption.......................... 484Replication reports.........................................................................485
Chapter 12
Chapter 13
CONTENTS
OneFS 7.1.1 CLI Administration Guide 13
-
Replication snapshots.................................................................................485Source cluster snapshots...............................................................485Target cluster snapshots................................................................ 486
Data failover and failback with SyncIQ.........................................................486Data failover.................................................................................. 487Data failback..................................................................................487
Recovery times and objectives for SyncIQ....................................................487SyncIQ license functionality........................................................................ 488Creating replication policies........................................................................488
Excluding directories in replication.................................................488Excluding files in replication.......................................................... 489File criteria options........................................................................ 490Configure default replication policy settings ..................................492Create a replication policy..............................................................492Create a SyncIQ domain................................................................. 493Assess a replication policy ............................................................ 493
Managing replication to remote clusters......................................................493Start a replication job.....................................................................494Pause a replication job ..................................................................494Resume a replication job ...............................................................494Cancel a replication job .................................................................494View active replication jobs ...........................................................495Replication job information ........................................................... 495
Initiating data failover and failback with SyncIQ.......................................... 495Fail over data to a secondary cluster ..............................................496Revert a failover operation............................................................. 496Fail back data to a primary cluster ................................................. 496
Performing disaster recovery for SmartLock directories................................497Recover SmartLock directories on a target cluster ..........................497Migrate SmartLock directories ....................................................... 498
Managing replication policies..................................................................... 499Modify a replication policy ............................................................ 499Delete a replication policy ............................................................. 500Enable or disable a replication policy ............................................ 500View replication policies ............................................................... 500Replication policy information .......................................................501
Managing replication to the local cluster..................................................... 501Cancel replication to the local cluster ............................................502Break local target association ....................................................... 502View replication policies targeting the local cluster........................ 502Remote replication policy information ........................................... 503
Managing replication performance rules..................................................... 503Create a network traffic rule ...........................................................503Create a file operations rule .......................................................... 503Modify a performance rule .............................................................504Delete a performance rule ............................................................. 504Enable or disable a performance rule ............................................ 504View performance rules .................................................................504
Managing replication reports.......................................................................505Configure default replication report settings ..................................505Delete replication reports...............................................................505View replication reports ................................................................ 505Replication report information........................................................506
Managing failed replication jobs................................................................. 508Resolve a replication policy ...........................................................508Reset a replication policy .............................................................. 508
CONTENTS
14 OneFS 7.1.1 CLI Administration Guide
-
Perform a full or differential replication.......................................... 509Managing changelists................................................................................. 509
Create a changelist........................................................................ 510View a changelist........................................................................... 510Changelist information...................................................................511
Data replication commands.........................................................................513isi sync policies create................................................................... 513isi sync policies modify.................................................................. 520isi sync policy delete......................................................................529isi sync policies list........................................................................ 529isi sync policies view......................................................................532isi sync policies disable................................................................. 532isi sync policies enable.................................................................. 532isi sync jobs start........................................................................... 533isi sync jobs pause.........................................................................533isi sync jobs resume.......................................................................533isi sync jobs cancel........................................................................ 534isi sync jobs list............................................................................. 534isi sync jobs view........................................................................... 535isi sync jobs reports list..................................................................535isi sync jobs reports view............................................................... 536isi sync settings modify..................................................................536isi sync settings view..................................................................... 537isi sync policies resolve................................................................. 537isi sync policies reset..................................................................... 538isi sync target cancel......................................................................538isi sync target list........................................................................... 538isi sync target view.........................................................................539isi sync target break....................................................................... 540isi sync target reports list............................................................... 540isi sync target reports view............................................................. 542isi sync target reports subreports list..............................................542isi sync target reports subreports view........................................... 544isi sync reports list......................................................................... 544isi sync reports view.......................................................................545isi sync reports rotate.....................................................................546isi sync reports subreports list....................................................... 546isi sync reports subreports view..................................................... 547isi sync recovery allow-write...........................................................548isi sync recovery resync-prep..........................................................548isi sync rules create........................................................................549isi sync rules modify.......................................................................550isi sync rules delete....................................................................... 551isi sync rules list............................................................................ 551isi sync rules view.......................................................................... 552isi_changelist_mod........................................................................552
Data layout with FlexProtect 555FlexProtect overview....................................................................................556File striping................................................................................................. 556Requested data protection.......................................................................... 556FlexProtect data recovery.............................................................................557
Smartfail........................................................................................ 557Node failures................................................................................. 557
Requesting data protection......................................................................... 558
Chapter 14
CONTENTS
OneFS 7.1.1 CLI Administration Guide 15
-
Requested protection settings.....................................................................558Requested protection disk space usage...................................................... 559
NDMP backup 561NDMP backup and recovery overview.......................................................... 562NDMP two way backup................................................................................ 562Snapshot-based incremental backups........................................................ 563NDMP protocol support............................................................................... 564Supported DMAs......................................................................................... 564NDMP hardware support............................................................................. 565NDMP backup limitations............................................................................565NDMP performance recommendations........................................................ 565Excluding files and directories from NDMP backups.................................... 567Configuring basic NDMP backup settings.................................................... 568
Configure and enable NDMP backup.............................................. 568Disable NDMP backup ...................................................................568View NDMP backup settings ..........................................................568NDMP backup settings .................................................................. 568
Managing NDMP user accounts................................................................... 569Create an NDMP user account ....................................................... 569Modify the password of an NDMP user account ............................. 569Delete an NDMP user account ....................................................... 569View NDMP user accounts ............................................................. 569
Managing NDMP backup devices.................................................................569Detect NDMP backup devices ........................................................570Modify an NDMP backup device entry name .................................. 570Delete a device entry for a disconnected NDMP backup device.......570View NDMP backup devices .......................................................... 570
Managing NDMP backup ports.................................................................... 571Modify NDMP backup port settings ................................................571Enable or disable an NDMP backup port.........................................571View NDMP backup ports .............................................................. 571NDMP backup port settings ........................................................... 571
Managing NDMP backup sessions...............................................................572End an NDMP session ................................................................... 572View NDMP sessions ..................................................................... 572NDMP session information ............................................................ 572
Managing restartable backups.................................................................... 573Configure restartable backups for EMC NetWorker..........................573View restartable backup contexts...................................................574Delete a restartable backup context............................................... 574Configure restartable backup settings............................................ 575View restartable backup settings................................................... 575
Managing file list backups.......................................................................... 575Format of a backup file list............................................................. 576Placement of the file list.................................................................576Start a file list backup.................................................................... 576
Improving NDMP restore performance......................................................... 577Specify a serial restore operation................................................... 577
Sharing tape drives between clusters.......................................................... 578Managing default NDMP settings.................................................................578
Set default NDMP settings for a directory....................................... 578Modify default NDMP settings for a directory.................................. 579View default NDMP settings for directories..................................... 579NDMP environment variables......................................................... 579
Chapter 15
CONTENTS
16 OneFS 7.1.1 CLI Administration Guide
-
Managing snapshot based incremental backups.........................................582Enable snapshot-based incremental backups for a directory.......... 582Delete snapshots for snapshot-based incremental backups...........582View snapshots for snapshot-based incremental backups............. 583
View NDMP backup logs ............................................................................. 583NDMP backup commands........................................................................... 583
isi ndmp user create.......................................................................583isi ndmp user modify..................................................................... 583isi ndmp user delete...................................................................... 584isi ndmp user list........................................................................... 584isi tape rescan............................................................................... 584isi tape rename.............................................................................. 585isi tape delete................................................................................ 585isi tape list..................................................................................... 586isi fc set......................................................................................... 586isi fc disable.................................................................................. 587isi fc enable................................................................................... 588isi fc list......................................................................................... 588isi ndmp kill................................................................................... 589isi ndmp list...................................................................................589isi ndmp probe...............................................................................590isi ndmp settings set......................................................................590isi ndmp settings list......................................................................591isi ndmp settings variables create..................................................592isi ndmp settings variables modify.................................................592isi ndmp settings variables delete..................................................593isi ndmp settings variables list.......................................................594isi ndmp dumpdates delete........................................................... 594isi ndmp dumpdates list................................................................ 594isi ndmp extensions context delete................................................ 595isi ndmp extensions contexts list................................................... 595isi ndmp extensions contexts view................................................. 596isi ndmp extensions settings modify.............................................. 596isi ndmp extensions settings view..................................................597
File retention with SmartLock 599SmartLock overview.................................................................................... 600Compliance mode....................................................................................... 600SmartLock directories................................................................................. 600Replication and backup with SmartLock...................................................... 601
SmartLock replication and backup limitations................................601SmartLock license functionality...................................................................602SmartLock considerations........................................................................... 602Set the compliance clock............................................................................ 603View the compliance clock.......................................................................... 603Creating a SmartLock directory.................................................................... 603
Retention periods...........................................................................603Autocommit time periods...............................................................604Create a SmartLock directory..........................................................604
Managing SmartLock directories................................................................. 605Modify a SmartLock directory......................................................... 605View SmartLock directory settings..................................................605SmartLock directory configuration settings.....................................606
Managing files in SmartLock directories...................................................... 609Set a retention period through a UNIX command line..................... 609
Chapter 16
CONTENTS
OneFS 7.1.1 CLI Administration Guide 17
-
Set a retention period through Windows Powershell.......................609Commit a file to a WORM state through a UNIX command line........ 610Commit a file to a WORM state through Windows Explorer..............610Override the retention period for all files in a SmartLock directory.. 610Delete a file committed to a WORM state .......................................611View WORM status of a file.............................................................611
SmartLock commands.................................................................................612isi worm domains create................................................................ 612isi worm domains modify............................................................... 615isi worm domains list..................................................................... 618isi worm domains view .................................................................. 620isi worm cdate set.......................................................................... 620isi worm cdate view........................................................................620isi worm files delete....................................................................... 620isi worm files view..........................................................................621
Protection domains 623Protection domains overview...................................................................... 624Protection domain considerations...............................................................624Create a protection domain ........................................................................ 625Delete a protection domain ........................................................................ 625
Data-at-rest-encryption 627Data-at-rest encryption overview................................................................. 628Self-encrypting drives..................................................................................628Data security on self-encrypted drives......................................................... 628Data migration to a self-encrypted-drives cluster.........................................629Chassis and drive states............................................................................. 629Smartfailed drive ERASE and REPLACE state examples................................ 631
SmartQuotas 635SmartQuotas overview................................................................................ 636Quota types................................................................................................ 636Default quota type.......................................................................................637Usage accounting and limits....................................................................... 638Disk-usage calculations.............................................................................. 640Quota notifications..................................................................................... 641Quota notification rules...............................................................................641Quota reports..............................................................................................642Creating quotas...........................................................................................642
Create an accounting quota........................................................... 643Create an enforcement quota......................................................... 643
Managing quotas........................................................................................ 644Search for quotas...........................................................................644Manage quotas.............................................................................. 644Export a quota configuration file.................................................... 645Import a quota configuration file.................................................... 645Managing quota notifications.........................................................646Managing quota reports................................................................. 648Basic quota settings...................................................................... 650Advisory limit quota notification rules settings...............................650Soft limit quota notification rules settings......................................651Hard limit quota notification rules settings.....................................651
Chapter 17
Chapter 18
Chapter 19
CONTENTS
18 OneFS 7.1.1 CLI Administration Guide
-
Limit notification settings...............................................................652Quota report settings..................................................................... 652Custom email notification template variable descriptions.............. 653
Quota commands........................................................................................654isi quota quotas create.................................................................. 654isi quota quotas delete.................................................................. 656isi quota quotas modify................................................................. 657isi quota quotas list....................................................................... 660isi quota quotas view..................................................................... 661isi quota quotas notifications clear................................................ 663isi quota quotas notifications create.............................................. 664isi quota quotas notifications delete.............................................. 666isi quota quotas notifications disable............................................ 668isi quota quotas notifications list................................................... 669isi quota quotas notifications modify............................................. 671isi quota quotas notifications view.................................................674isi quota reports create.................................................................. 675isi quota reports delete.................................................................. 676isi quota reports list....................................................................... 677isi quota settings notifications clear...............................................677isi quota settings notifications create.............................................677isi quota settings notifications delete............................................ 679isi quota settings notifications list................................................. 680isi quota settings notifications modify............................................681isi quota settings notifications view............................................... 682isi quota settings reports modify.................................................... 683isi quota settings reports view........................................................684
Storage Pools 685Storage pools overview............................................................................... 686About storage pools.................................................................................... 686Autoprovisioning.........................................................................................687Virtual hot spare..........................................................................................688Spillover..................................................................................................... 688Node pools................................................................................................. 689
Manual node pool management.....................................................689SSD pools................................................................................................... 690L3 cache overview.......................................................................................691
Migration to L3 cache.....................................................................692Required privileges........................................................................ 692
Tiers............................................................................................................692File pools.................................................................................................... 693File pool policies......................................................................................... 693Managing node pools..................................................................................694
Create a node pool manually..........................................................694Add a node to a manually managed node pool...............................694Change the name or protection policy of a node pool..................... 695Remove a node from a manually managed node pool.....................695
Managing L3 cache from the command line interface.................................. 695Set L3 cache as the default for new node pools..............................695Enable L3 cache on a specific node pool ....................................... 696Restore SSDs to storage drives for a node pool.............................. 696
Managing tiers............................................................................................ 696Create a tier................................................................................... 696Add or move node pools in a tier....................................................697
Chapter 20
CONTENTS
OneFS 7.1.1 CLI Administration Guide 19
-
Rename a tier.................................................................................697Delete a tier................................................................................... 697
Creating file pool policies............................................................................697Create a file pool policy..................................................................698File-matching options for file pool policies..................................... 698Valid wildcard characters............................................................... 700SmartPools settings....................................................................... 701Default file pool requested protection settings............................... 703Default file pool I/O optimization settings...................................... 704
Managing file pool policies......................................................................... 704Modify a file pool policy................................................................. 705Modify default storage pool settings.............................................. 705Configure default file pool policy settings.......................................706Prioritize a file pool policy.............................................................. 706Delete a file pool policy..................................................................707
Monitoring storage pools............................................................................ 707Monitor storage pools.................................................................... 707View the health of storage pools.................................................... 708View results of a SmartPools job.................................................... 708
Storage pool commands............................................................................. 708isi filepool apply............................................................