onefs 7.2.1 cli administration guide - dell emc · isi config ... 217 configure or modify a local...
TRANSCRIPT
-
IsilonOneFSVersion 7.2.1
CLI Administration Guide
-
Copyright 2013-2016 EMC Corporation. All rights reserved. Published in the USA.
Published June 2016
EMC believes the information in this publication is accurate as of its publication date. The information is subject to changewithout notice.
The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind withrespect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for aparticular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicablesoftware license.
EMC, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and othercountries. All other trademarks used herein are the property of their respective owners.
For the most up-to-date regulatory document for your product line, go to EMC Online Support (https://support.emc.com).
EMC CorporationHopkinton, Massachusetts 01748-91031-508-435-1000 In North America 1-866-464-7381www.EMC.com
2 OneFS 7.2.1 CLI Administration Guide
-
Introduction to this guide 27
About this guide............................................................................................28Isilon scale-out NAS overview........................................................................28Where to go for support.................................................................................28
Isilon scale-out NAS 29
OneFS storage architecture........................................................................... 30Isilon node components................................................................................30Internal and external networks...................................................................... 31Isilon cluster................................................................................................. 31
Cluster administration......................................................................31Quorum............................................................................................31Splitting and merging.......................................................................32Storage pools...................................................................................33IP address pools.............................................................................. 33
The OneFS operating system......................................................................... 33Data-access protocols......................................................................33Identity 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 43
OneFS command-line interface overview....................................................... 44Syntax diagrams........................................................................................... 44Universal options.......................................................................................... 45Command-line interface privileges................................................................ 45SmartLock compliance command permissions.............................................. 49OneFS time values.........................................................................................52
General cluster administration 53
General cluster administration overview........................................................54User interfaces.............................................................................................. 54Connecting to the cluster...............................................................................55
Log in to the web administration interface........................................55
Chapter 1
Chapter 2
Chapter 3
Chapter 4
CONTENTS
OneFS 7.2.1 CLI Administration Guide 3
-
Open an SSH connection to a cluster................................................55Licensing.......................................................................................................56
License status..................................................................................57License configuration.......................................................................59Activate a license through the command-line interface.....................60View license information.................................................................. 60Unconfigure a license.......................................................................60
Certificates....................................................................................................61Replace or renew the SSL certificate.................................................61Verify an SSL certificate update........................................................62Self-signed SSL certificate data example..........................................63
Cluster identity..............................................................................................63Set the cluster name ....................................................................... 63
Cluster contact information........................................................................... 64Specify contact information .............................................................64
Cluster date and time.................................................................................... 65Set the cluster date and time........................................................... 65Specify an NTP time server............................................................... 66
SMTP email settings...................................................................................... 66Configure SMTP email settings ........................................................ 66View SMTP email settings.................................................................67
Configuring the cluster join mode..................................................................67Specify the cluster join mode .......................................................... 68
File system settings.......................................................................................68Specify the cluster character encoding............................................. 68Enable or disable access time tracking ............................................69
Security hardening........................................................................................ 69STIG hardening profile......................................................................70Apply a security hardening policy.....................................................71Revert a security hardening policy.................................................... 72View the security hardening status...................................................74
Cluster monitoring.........................................................................................74Monitor the cluster...........................................................................75View node status............................................................................. 75
Monitoring cluster hardware..........................................................................75View node hardware status.............................................................. 75Chassis and drive states.................................................................. 75Check battery status........................................................................ 78SNMP monitoring............................................................................. 78
Events and notifications................................................................................82Coalesced events.............................................................................82Viewing event information................................................................84Responding to events.......................................................................87Managing event notification settings................................................89Managing event notification rules.................................................... 90
Cluster maintenance..................................................................................... 93Replacing node components............................................................ 93Upgrading node components........................................................... 93Managing drive firmware..................................................................93Managing cluster nodes................................................................... 98Upgrading OneFS........................................................................... 100
Remote support.......................................................................................... 101Remote support using SupportIQ................................................... 101Remote support using ESRS........................................................... 105
Cluster administration commands...............................................................107isi config........................................................................................ 107
CONTENTS
4 OneFS 7.2.1 CLI Administration Guide
-
isi email......................................................................................... 112isi email list................................................................................... 112isi exttools..................................................................................... 113isi hardening apply........................................................................ 113isi hardening revert........................................................................ 113isi hardening status....................................................................... 114isi license activate......................................................................... 114isi license status............................................................................ 114isi license unconfigure................................................................... 114isi perfstat......................................................................................115isi pkg create................................................................................. 115isi pkg delete................................................................................. 115isi pkg info..................................................................................... 115isi pkg install................................................................................. 116isi remotesupport connectemc modify............................................117isi remotesupport connectemc view............................................... 118isi services.....................................................................................118isi set.............................................................................................118isi snmp.........................................................................................122isi snmp list................................................................................... 122isi statistics client.......................................................................... 123isi statistics describe..................................................................... 128isi statistics drive........................................................................... 129isi statistics heat............................................................................131isi statistics history........................................................................ 134isi statistics list all......................................................................... 136isi statistics list classes..................................................................136isi statistics list events...................................................................137isi statistics list nodes................................................................... 137isi statistics list nooutput...............................................................138isi statistics list operations............................................................ 138isi statistics list orderby................................................................. 138isi statistics list output...................................................................139isi statistics list protocols.............................................................. 139isi statistics list stats..................................................................... 140isi statistics list totalby.................................................................. 140isi statistics protocol......................................................................141isi statistics pstat...........................................................................146isi statistics query.......................................................................... 148isi statistics system........................................................................149isi status........................................................................................150isi update.......................................................................................151isi version...................................................................................... 152isi_for_array...................................................................................153isi get.............................................................................................154isi_gather_info...............................................................................156isi_phone_home............................................................................ 160
Event commands.........................................................................................161isi events cancel............................................................................ 161isi events list..................................................................................161isi events notifications create.........................................................163isi events notifications modify........................................................164isi events notifications delete........................................................ 165isi events notifications list............................................................. 166isi events quiet.............................................................................. 166isi events sendtest......................................................................... 166
CONTENTS
OneFS 7.2.1 CLI Administration Guide 5
-
isi events settings list.................................................................... 166isi events settings set.....................................................................167isi events show.............................................................................. 167isi events unquiet.......................................................................... 167
Hardware commands.................................................................................. 168isi batterystatus............................................................................. 168isi devices......................................................................................168isi servicelight status..................................................................... 170isi servicelight off...........................................................................170isi servicelight on...........................................................................170isi drivefirmware status..................................................................171isi firmware package...................................................................... 171isi firmware status..........................................................................172isi firmware update........................................................................ 173isi readonly off............................................................................... 174isi readonly on............................................................................... 175isi readonly show........................................................................... 176
Access zones 177
Access zones overview ............................................................................... 178Access zone base directory rules.................................................................178Access zones best practices........................................................................179Access zone limits.......................................................................................179Quality of service........................................................................................ 180Managing access zones.............................................................................. 180
Create an access zone....................................................................180Associate an IP address pool with an access zone..........................181Modify an access zone................................................................... 181Add an authentication provider to an access zone..........................181Remove an authentication provider from an access zone............... 182Delete an access zone....................................................................182
Access zone commands.............................................................................. 182isi zone restrictions create............................................................. 182isi zone restrictions delete............................................................. 183isi zone restrictions list.................................................................. 184isi zone zones create......................................................................184isi zone zones delete..................................................................... 187isi zone zones list.......................................................................... 187isi zone zones modify.....................................................................188isi zone zones view........................................................................ 193
Authentication 195
Authentication............................................................................................ 196Authentication provider features................................................................. 196Supported authentication providers............................................................ 196Active Directory........................................................................................... 197LDAP........................................................................................................... 197NIS..............................................................................................................198Kerberos authentication..............................................................................198
Keytabs and SPNs overview........................................................... 198MIT Kerberos protocol support....................................................... 199
File provider................................................................................................ 199Local provider............................................................................................. 199Managing Active Directory providers............................................................200
Chapter 5
Chapter 6
CONTENTS
6 OneFS 7.2.1 CLI Administration Guide
-
Configure an Active Directory provider............................................200Modify an Active Directory provider................................................ 200Delete an Active Directory provider.................................................200
Managing LDAP providers............................................................................201Configure an LDAP provider............................................................201Modify an LDAP provider................................................................ 202Delete an LDAP provider.................................................................202
Managing NIS providers.............................................................................. 202Configure an NIS provider.............................................................. 202Modify an NIS provider...................................................................203Delete an NIS provider................................................................... 203
Managing MIT Kerberos authentication....................................................... 203Managing MIT Kerberos realms...................................................... 203Managing MIT Kerberos providers.................................................. 205Managing MIT Kerberos domains................................................... 208Managing SPNs and keys............................................................... 209
Managing file providers...............................................................................212Configure a file provider................................................................. 212Generate a password file................................................................212Modify a file provider..................................................................... 213Delete a file provider...................................................................... 213Password file format...................................................................... 213Group file format............................................................................214Netgroup file format....................................................................... 215
Managing local users and groups................................................................ 215View a list of users and groups by provider.....................................216Create a local user......................................................................... 216Create a local group....................................................................... 216Naming rules for local users and groups.........................................217Configure or modify a local password policy...................................217Local password policy settings.......................................................218Modify a local user.........................................................................219Modify a local group.......................................................................219Delete a local user......................................................................... 219Delete a local group....................................................................... 220
Authentication and access control commands............................................ 220isi auth access............................................................................... 220isi auth ads create..........................................................................221isi auth ads delete......................................................................... 223isi auth ads list.............................................................................. 224isi auth ads modify.........................................................................225isi auth ads spn check................................................................... 228isi auth ads spn create................................................................... 228isi auth ads spn delete...................................................................229isi auth ads spn list........................................................................229isi auth ads trusts controllers list................................................... 230isi auth ads trusts list.....................................................................231isi auth ads trusts view.................................................................. 231isi auth ads view............................................................................ 231isi auth error.................................................................................. 231isi auth file create.......................................................................... 232isi auth file delete.......................................................................... 234isi auth file list............................................................................... 235isi auth file modify......................................................................... 235isi auth file view............................................................................. 241isi auth groups create.................................................................... 241
CONTENTS
OneFS 7.2.1 CLI Administration Guide 7
-
isi auth groups delete.................................................................... 242isi auth groups flush...................................................................... 243isi auth groups list......................................................................... 243isi auth groups members list.......................................................... 244isi auth groups modify................................................................... 244isi auth groups view....................................................................... 246isi auth id.......................................................................................246isi auth krb5 realm create...............................................................246isi auth krb5 realm delete.............................................................. 247isi auth krb5 realm modify............................................................. 247isi auth krb5 realm list................................................................... 248isi auth krb5 realm view................................................................. 248isi auth krb5 create........................................................................ 248isi auth krb5 delete........................................................................ 249isi auth krb5 list............................................................................. 249isi auth krb5 view...........................................................................250isi auth krb5 domain create........................................................... 250isi auth krb5 domain delete........................................................... 250isi auth krb5 domain modify.......................................................... 250isi auth krb5 domain list................................................................ 251isi auth krb5 domain view.............................................................. 251isi auth krb5 spn create..................................................................251isi auth krb5 spn delete................................................................. 252isi auth krb5 spn check.................................................................. 252isi auth krb5 spn fix....................................................................... 252isi auth krb5 spn import................................................................. 253isi auth krb5 spn list...................................................................... 253isi auth ldap create........................................................................ 253isi auth ldap delete........................................................................ 260isi auth ldap list............................................................................. 260isi auth ldap modify....................................................................... 260isi auth ldap view...........................................................................269isi auth local list.............................................................................269isi auth local modify.......................................................................270isi auth local view.......................................................................... 271isi auth log-level............................................................................ 272isi auth mapping create..................................................................272isi auth mapping delete................................................................. 273isi auth mapping dump.................................................................. 274isi auth mapping flush................................................................... 275isi auth mapping import................................................................. 275isi auth mapping modify................................................................ 275isi auth mapping token.................................................................. 276isi auth mapping view.................................................................... 277isi auth netgroups list.................................................................... 278isi auth nis create...........................................................................278isi auth nis delete.......................................................................... 281isi auth nis list............................................................................... 281isi auth nis modify..........................................................................281isi auth nis view............................................................................. 286isi auth privileges...........................................................................286isi auth refresh...............................................................................287isi auth roles create........................................................................287isi auth roles delete....................................................................... 287isi auth roles list............................................................................ 288isi auth roles members list............................................................. 288
CONTENTS
8 OneFS 7.2.1 CLI Administration Guide
-
isi auth roles modify.......................................................................289isi auth roles privileges list.............................................................290isi auth roles view.......................................................................... 291isi auth settings global modify....................................................... 291isi auth settings global view........................................................... 293isi auth settings krb5 modify..........................................................294isi auth settings krb5 view............................................................. 294isi auth settings mapping modify................................................... 294isi auth settings mapping view.......................................................295isi auth status................................................................................ 296isi auth users create.......................................................................296isi auth users delete.......................................................................298isi auth users flush.........................................................................298isi auth users list............................................................................298isi auth users modify......................................................................299isi auth users view......................................................................... 301
Configuration access control 303
Role-based access...................................................................................... 304Roles and privileges.................................................................................... 304
Roles............................................................................................. 304Privileges....................................................................................... 308
Managing roles........................................................................................... 316View roles...................................................................................... 316View privileges...............................................................................316Create and modify a custom role.................................................... 317Delete a custom role...................................................................... 317
Identity management 319
Identity management overview....................................................................320Identity 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
Chapter 7
Chapter 8
CONTENTS
OneFS 7.2.1 CLI Administration Guide 9
-
Home directories 337
Home directories overview.......................................................................... 338Home directory permissions........................................................................338Authenticating SMB users........................................................................... 338Home directory creation through SMB......................................................... 338
Create home directories with expansion variables..........................339Create home directories with the --inheritable-path-acl option....... 340Create special home directories with the SMB share %U variable...341
Home directory creation through SSH and FTP............................................. 342Set the SSH or FTP login shell ........................................................ 342Set SSH/FTP home directory permissions.......................................342Set SSH/FTP home directory creation options.................................343Provision home directories with dot files........................................344
Home directory creation in a mixed environment......................................... 345Interactions between ACLs and mode bits................................................... 345Default home directory settings in authentication providers........................ 345Supported expansion variables...................................................................346Domain variables in home directory provisioning........................................ 348
Data access control 349
Data access control overview...................................................................... 350ACLs............................................................................................................350UNIX permissions........................................................................................351Mixed-permission environments................................................................. 351
NFS access of Windows-created files..............................................351SMB access of UNIX-created files................................................... 351
Managing access permissions.....................................................................352View expected user permissions.................................................... 352Configure access management settings......................................... 353Modify ACL policy settings..............................................................353Update cluster permissions............................................................354
File sharing 355
File sharing overview...................................................................................356Mixed protocol environments.........................................................356Write caching with SmartCache...................................................... 357
SMB............................................................................................................ 358SMB shares in access zones.......................................................... 359SMB Multichannel..........................................................................359SMB share management through MMC.......................................... 361Symbolic links and SMB clients......................................................362Anonymous access to SMB shares................................................. 363Managing SMB settings................................................................. 363Managing SMB shares................................................................... 366SMB commands.............................................................................371
NFS............................................................................................................. 393NFS exports....................................................................................393NFS aliases.................................................................................... 393NFS log files................................................................................... 394Managing the NFS service.............................................................. 394Managing NFS exports................................................................... 395Managing NFS aliases.................................................................... 398NFS commands.............................................................................. 401
Chapter 9
Chapter 10
Chapter 11
CONTENTS
10 OneFS 7.2.1 CLI Administration Guide
-
FTP..............................................................................................................439View FTP settings........................................................................... 439Enable FTP file sharing................................................................... 439Configure FTP file sharing............................................................... 440FTP commands...............................................................................440
HTTP and HTTPS.......................................................................................... 455Enable and configure HTTP.............................................................455
Auditing 457
Auditing overview........................................................................................458Syslog......................................................................................................... 458
Enable syslog.................................................................................458Syslog forwarding.......................................................................... 459
Protocol audit events.................................................................................. 459Sample config audit log................................................................. 460
Supported event types................................................................................ 461Supported audit tools................................................................................. 461Managing audit settings..............................................................................462
Enable system configuration auditing............................................ 462Enable protocol access auditing.....................................................463Auditing settings............................................................................464
Integrating with the EMC Common Event Enabler.........................................465Install CEE for Windows..................................................................466Configure CEE for Windows............................................................ 467
Auditing commands.................................................................................... 467isi audit settings modify.................................................................467isi audit settings view.................................................................... 469isi audit topics list..........................................................................470isi audit topics modify....................................................................470isi audit topics view....................................................................... 471
Snapshots 473
Snapshots overview.................................................................................... 474Data protection with SnapshotIQ.................................................................474Snapshot disk-space usage........................................................................ 474Snapshot schedules....................................................................................475Snapshot aliases........................................................................................ 475File and directory restoration.......................................................................475Best practices for creating snapshots..........................................................476Best practices for creating snapshot schedules...........................................476File clones...................................................................................................477
Shadow-store considerations.........................................................478Snapshot locks........................................................................................... 478Snapshot reserve........................................................................................ 479SnapshotIQ license functionality.................................................................479Creating snapshots with SnapshotIQ...........................................................479
Create a SnapRevert domain.......................................................... 480Create a snapshot schedule........................................................... 480Create a snapshot.......................................................................... 480Snapshot naming patterns............................................................. 481
Managing snapshots ..................................................................................483Reducing snapshot disk-space usage............................................ 483Delete a snapshot.......................................................................... 484Modify snapshot attributes............................................................ 484
Chapter 12
Chapter 13
CONTENTS
OneFS 7.2.1 CLI Administration Guide 11
-
Modify a snapshot alias ................................................................ 484View snapshots..............................................................................485Snapshot information.................................................................... 485
Restoring snapshot data............................................................................. 486Revert a snapshot ......................................................................... 486Restore a file or directory using Windows Explorer..........................486Restore a file or directory through a UNIX command line.................487Clone a file from a snapshot...........................................................487
Managing snapshot schedules....................................................................488Modify a snapshot schedule ......................................................... 488Delete a snapshot schedule .......................................................... 488View snapshot schedules ..............................................................488
Managing snapshot aliases.........................................................................489Configure a snapshot alias for a snapshot schedule.......................489Assign a snapshot alias to a snapshot........................................... 489Reassign a snapshot alias to the live file system............................ 490View snapshot aliases................................................................... 490Snapshot alias information............................................................ 490
Managing with snapshot locks.................................................................... 491Create a snapshot lock...................................................................491Modify a snapshot lock expiration date..........................................491Delete a snapshot lock...................................................................492Snapshot lock information............................................................. 492
Configure SnapshotIQ settings ................................................................... 492SnapshotIQ settings ......................................................................493
Set the snapshot reserve.............................................................................494Snapshot commands.................................................................................. 494
Snapshot naming patterns............................................................. 494isi snapshot schedules create........................................................497isi snapshot schedules modify.......................................................498isi snapshot schedules delete........................................................500isi snapshot schedules list.............................................................501isi snapshot schedules view.......................................................... 502isi snapshot schedules pending list............................................... 502isi snapshot snapshots create........................................................503isi snapshot snapshots modify.......................................................504isi snapshot snapshots delete....................................................... 505isi snapshot snapshots list............................................................ 505isi snapshot snapshots view.......................................................... 507isi snapshot settings modify.......................................................... 507isi snapshot settings view.............................................................. 509isi snapshot locks create................................................................509isi snapshot locks modify...............................................................510isi snapshot locks delete............................................................... 511isi snapshot locks list.................................................................... 512isi snapshot locks view.................................................................. 513isi snapshot aliases create.............................................................513isi snapshot aliases modify............................................................513isi snapshot aliases delete.............................................................514isi snapshot aliases list..................................................................514isi snapshot aliases view............................................................... 515
Deduplication with SmartDedupe 517
Deduplication overview...............................................................................518Deduplication jobs......................................................................................518
Chapter 14
CONTENTS
12 OneFS 7.2.1 CLI Administration Guide
-
Data replication and backup with deduplication..........................................519Snapshots with deduplication.....................................................................519Deduplication considerations......................................................................519Shadow-store considerations......................................................................520SmartDedupe license functionality..............................................................520Managing deduplication............................................................................. 520
Assess deduplication space savings ............................................. 521Specify deduplication settings ...................................................... 521View deduplication space savings .................................................522View a deduplication report ...........................................................522Deduplication job report information............................................. 522Deduplication information............................................................. 523
Deduplication commands........................................................................... 524isi dedupe settings modify............................................................. 524isi dedupe settings view.................................................................525isi dedupe stats............................................................................. 525isi dedupe reports list.................................................................... 526isi dedupe reports view ................................................................. 527
Data replication with SyncIQ 529
SyncIQ backup and recovery overview.........................................................530Replication policies and jobs...................................................................... 530
Automated replication policies.......................................................531Source and target cluster association.............................................531Full and differential replication.......................................................532Controlling replication job resource consumption.......................... 532Replication reports.........................................................................533
Replication snapshots.................................................................................533Source cluster snapshots...............................................................533Target cluster snapshots................................................................ 534
Data failover and failback with SyncIQ.........................................................534Data failover.................................................................................. 535Data failback..................................................................................535
Recovery times and objectives for SyncIQ....................................................536SyncIQ license functionality........................................................................ 536Creating replication policies........................................................................537
Excluding directories in replication.................................................537Excluding files in replication.......................................................... 538File criteria options........................................................................ 538Configure default replication policy settings ..................................540Create a replication policy..............................................................540Create a SyncIQ domain................................................................. 541Assess a replication policy ............................................................ 541
Managing replication to remote clusters......................................................541Start a replication job.....................................................................542Pause a replication job ..................................................................542Resume a replication job ...............................................................542Cancel a replication job .................................................................542View active replication jobs ...........................................................543Replication job information ........................................................... 543
Initiating data failover and failback with SyncIQ.......................................... 543Fail over data to a secondary cluster ..............................................544Revert a failover operation............................................................. 544Fail back data to a primary cluster ................................................. 545
Performing disaster recovery for SmartLock directories................................545
Chapter 15
CONTENTS
OneFS 7.2.1 CLI Administration Guide 13
-
Recover SmartLock directories on a target cluster ..........................545Migrate SmartLock directories ....................................................... 546
Managing replication policies..................................................................... 548Modify a replication policy ............................................................ 548Delete a replication policy ............................................................. 548Enable or disable a replication policy ............................................ 549View replication policies ............................................................... 549Replication policy information .......................................................550
Managing replication to the local cluster..................................................... 551Cancel replication to the local cluster ............................................551Break local target association ....................................................... 551View replication policies targeting the local cluster........................ 551Remote replication policy information ........................................... 552
Managing replication performance rules..................................................... 552Create a network traffic rule ...........................................................552Create a file operations rule .......................................................... 553Modify a performance rule .............................................................553Delete a performance rule ............................................................. 553Enable or disable a performance rule ............................................ 553View performance rules .................................................................554
Managing replication reports.......................................................................554Configure default replication report settings ..................................554Delete replication reports...............................................................554View replication reports ................................................................ 555Replication report information........................................................556
Managing failed replication jobs................................................................. 557Resolve a replication policy ...........................................................557Reset a replication policy .............................................................. 557Perform a full or differential replication.......................................... 558
Managing changelists................................................................................. 558Create a changelist........................................................................ 559View a changelist........................................................................... 559Changelist information...................................................................560
Data replication commands.........................................................................562isi sync policies create................................................................... 562isi sync policies modify.................................................................. 569isi sync policies delete................................................................... 578isi sync policies list........................................................................ 578isi sync policies view......................................................................581isi sync policies disable................................................................. 581isi sync policies enable.................................................................. 582isi sync jobs start........................................................................... 582isi sync jobs pause.........................................................................583isi sync jobs resume.......................................................................583isi sync jobs cancel........................................................................ 583isi sync jobs list............................................................................. 584isi sync jobs view........................................................................... 585isi sync jobs reports list..................................................................585isi sync jobs reports view............................................................... 585isi sync settings modify..................................................................586isi sync settings view..................................................................... 587isi sync policies resolve................................................................. 587isi sync policies reset..................................................................... 587isi sync target cancel......................................................................588isi sync target list........................................................................... 588isi sync target view.........................................................................589
CONTENTS
14 OneFS 7.2.1 CLI Administration Guide
-
isi sync target break....................................................................... 589isi sync target reports list............................................................... 590isi sync target reports view............................................................. 591isi sync target reports subreports list..............................................592isi sync target reports subreports view........................................... 593isi sync reports list......................................................................... 593isi sync reports view.......................................................................595isi sync reports rotate.....................................................................595isi sync reports subreports list....................................................... 595isi sync reports subreports view..................................................... 596isi sync recovery allow-write...........................................................597isi sync recovery resync-prep..........................................................598isi sync rules create........................................................................598isi sync rules modify.......................................................................599isi sync rules delete....................................................................... 600isi sync rules list............................................................................ 601isi sync rules view.......................................................................... 601isi_changelist_mod........................................................................601
Data layout with FlexProtect 605
FlexProtect overview....................................................................................606File striping................................................................................................. 606Requested data protection.......................................................................... 606FlexProtect data recovery.............................................................................607
Smartfail........................................................................................ 607Node failures................................................................................. 607
Requesting data protection......................................................................... 608Requested protection settings.....................................................................608Requested protection disk space usage...................................................... 609
NDMP backup 611
NDMP backup and recovery overview.......................................................... 612NDMP two-way backup................................................................................612NDMP three-way backup............................................................................. 613
Setting preferred IPs for NDMP three-way operations .....................613Configure preferred IP settings for NDMP three-way operations...... 613
Snapshot-based incremental backups........................................................ 614NDMP protocol support............................................................................... 615Supported DMAs......................................................................................... 615NDMP hardware support............................................................................. 615NDMP backup limitations............................................................................616NDMP performance recommendations........................................................ 616Excluding files and directories from NDMP backups.................................... 617Configuring basic NDMP backup settings.................................................... 619
Configure and enable NDMP backup.............................................. 619Disable NDMP backup ...................................................................619View NDMP backup settings ..........................................................619NDMP backup settings .................................................................. 620
Managing NDMP user accounts................................................................... 620Create an NDMP user account ....................................................... 620Modify the password of an NDMP user account ............................. 620Delete an NDMP user account ....................................................... 620View NDMP user accounts ............................................................. 621
Managing NDMP backup devices.................................................................621
Chapter 16
Chapter 17
CONTENTS
OneFS 7.2.1 CLI Administration Guide 15
-
Detect NDMP backup devices ........................................................621Modify an NDMP backup device entry name .................................. 621Delete a device entry for a disconnected NDMP backup device.......621View NDMP backup devices .......................................................... 622
Managing NDMP backup ports.................................................................... 622Modify NDMP backup port settings ................................................622Enable or disable an NDMP backup port.........................................622View NDMP backup ports .............................................................. 623NDMP backup port settings ........................................................... 623
Managing NDMP backup sessions...............................................................623End an NDMP session ................................................................... 623View NDMP sessions ..................................................................... 624NDMP session information ............................................................ 624
Managing restartable backups.................................................................... 625Configure restartable backups for EMC NetWorker..........................625View restartable backup contexts...................................................626Delete a restartable backup context............................................... 626Configure restartable backup settings............................................ 626View restartable backup settings................................................... 627
Managing file list backups.......................................................................... 627Format of a backup file list............................................................. 628Placement of the file list.................................................................628Start a file list backup.................................................................... 628
NDMP restore operations............................................................................ 629Parallel restore operation...............................................................629Serial restore operation..................................................................629Specify a serial restore operation................................................... 629
Sharing tape drives between clusters.......................................................... 630Managing default NDMP settings.................................................................630
Set default NDMP settings for a directory....................................... 630Modify default NDMP settings for a directory.................................. 631View default NDMP settings for directories..................................... 631NDMP environment variables......................................................... 631
Managing snapshot based incremental backups.........................................634Enable snapshot-based incremental backups for a directory.......... 634Delete snapshots for snapshot-based incremental backups...........635View snapshots for snapshot-based incremental backups............. 635
View NDMP backup logs ............................................................................. 635NDMP backup commands........................................................................... 636
isi ndmp user create.......................................................................636isi ndmp user modify..................................................................... 636isi ndmp user delete...................................................................... 637isi ndmp user list........................................................................... 637isi tape rescan............................................................................... 637isi tape rename.............................................................................. 638isi tape delete................................................................................ 638isi tape list..................................................................................... 639isi fc set......................................................................................... 639isi fc disable.................................................................................. 641isi fc enable................................................................................... 641isi fc list......................................................................................... 641isi ndmp kill................................................................................... 642isi ndmp list...................................................................................642isi ndmp probe...............................................................................643isi ndmp settings set......................................................................644isi ndmp settings list......................................................................645
CONTENTS
16 OneFS 7.2.1 CLI Administration Guide
-
isi ndmp settings variables create..................................................646isi ndmp settings variables modify.................................................646isi ndmp settings variables delete..................................................647isi ndmp settings variables list.......................................................647isi ndmp dumpdates delete........................................................... 648isi ndmp dumpdates list................................................................ 648isi ndmp extensions context delete................................................ 649isi ndmp extensions contexts list................................................... 649isi ndmp extensions contexts view................................................. 650isi ndmp extensions settings modify.............................................. 650isi ndmp extensions settings view..................................................651
File retention with SmartLock 653
SmartLock overview.................................................................................... 654Compliance mode....................................................................................... 654SmartLock directories................................................................................. 654Replication and backup with SmartLock...................................................... 655
SmartLock replication and backup limitations................................655SmartLock license functionality...................................................................656SmartLock considerations........................................................................... 656Set the compliance clock............................................................................ 657View the compliance clock.......................................................................... 657Creating a SmartLock directory.................................................................... 658
Retention periods...........................................................................658Autocommit time periods...............................................................658Create a SmartLock directory..........................................................658
Managing SmartLock directories................................................................. 659Modify a SmartLock directory......................................................... 659View SmartLock directory settings..................................................660SmartLock directory configuration settings.....................................660
Managing files in SmartLock directories...................................................... 663Set a retention period through a UNIX command line..................... 664Set a retention period through Windows Powershell.......................664Commit a file to a WORM state through a UNIX command line........ 664Commit a file to a WORM state through Windows Explorer..............665Override the retention period for all files in a SmartLock directory.. 665Delete a file committed to a WORM state .......................................665View WORM status of a file.............................................................666
SmartLock commands.................................................................................667isi worm domains create................................................................ 667isi worm domains modify............................................................... 670isi worm domains list..................................................................... 674isi worm domains view .................................................................. 675isi worm cdate set.......................................................................... 675isi worm cdate view........................................................................676isi worm files delete....................................................................... 676isi worm files view..........................................................................676
Protection domains 679
Protection domains overview...................................................................... 680Protection domain considerations...............................................................680Create a protection domain ........................................................................ 681Delete a protection domain ........................................................................ 681
Chapter 18
Chapter 19
CONTENTS
OneFS 7.2.1 CLI Administration Guide 17
-
Data-at-rest-encryption 683
Data-at-rest encryption overview................................................................. 684Self-encrypting drives..................................................................................684Data security on self-encrypted drives......................................................... 684Data migration to a self-encrypted-drives cluster.........................................685Chassis and drive states............................................................................. 685Smartfailed drive REPLACE state..................................................................688Smartfailed drive ERASE state..................................................................... 689
SmartQuotas 691
SmartQuotas overview................................................................................ 692Quota types................................................................................................ 692Default quota type.......................................................................................693Usage accounting and limits....................................................................... 695Disk-usage calculations.............................................................................. 696Quota notifications..................................................................................... 697Quota notification rules...............................................................................698Quota reports..............................................................................................698Creating quotas...........................................................................................699
Create an accounting quota........................................................... 699Create an enforcement quota......................................................... 699
Managing quotas........................................................................................ 700Search for quotas...........................................................................700Manage quotas.............................................................................. 700Export a quota configuration file.................................................... 701Import a quota configuration file.................................................... 702Managing quota notifications.........................................................702Email quota notification messages.................................................704Managing quota reports................................................................. 706Basic quota settings...................................................................... 708Advisory limit quota notification rules settings...............................708Soft limit quota notification rules settings......................................709Hard limit quota notification rules settings.....................................710Limit notification settings...............................................................710Quota report settings..................................................................... 711
Quota commands........................................................................................712isi quota quotas create.................................................................. 712isi quota quotas delete.................................................................. 714isi quota quotas modify................................................................. 715isi quota quotas list....................................................................... 718isi quota quotas view..................................................................... 720isi quota quotas notifications clear................................................ 721isi quota quotas notifications create.............................................. 722isi quota quotas notifications delete.............................................. 725isi quota quotas notifications disable............................................ 726isi quota quotas notifications list................................................... 728isi quota quotas notifications modify............................................. 730isi quota quotas notifications view.................................................733isi quota reports create.................................................................. 734isi quota reports delete.................................................................. 735isi quota reports list....................................................................... 736isi quota settings notifications clear...............................................736isi quota settings notifications create.............................................736isi quota settings notifications delete............................................ 739
Chapter 20
Chapter 21
CONTENTS
18 OneFS 7.2.1 CLI Administration Guide
-
isi quota settings notifications list................................................. 740isi quota settings notifications modify............................................740isi quota settings notifications view............................................... 742isi quota settings reports modify.................................................... 743isi quota settings reports view........................................................744
Storage Pools 747
Storage pools overview............................................................................... 748Storage pool functions................................................................................ 748Autoprovisioning.........................................................................................750Node pools................................................................................................. 750
Node class compatibilities............................................................. 751SSD compatibilities........................................................................752Manual node pools........................................................................ 752
Virtual hot spare..........................................................................................753Spillover..................................................................................................... 753Suggested protection.................................................................................. 754Protection policies...................................................................................... 754SSD strategies.............................................................................................755Global namespace acceleration.................................................................. 756L3 cache overview.......................................................................................756
Migration to L3 cache.....................................................................757L3 cache on NL-series and HD-series node pools............................758
Tiers............................................................................................................758File pool policies......................................................................................... 758Managing node pools through the command-line interface......................... 759
Create a node class compatibility...................................................759Merge compatible node pools........................................................760Delete a node class compatibility...................................................761Create an SSD compatibility........................................................... 761Delete an SSD compatibility........................................................... 762Create a node pool manually..........................................................763Add a node to a manually managed node pool...............................763Change the name or protection policy of a node pool..................... 763Remove a node from a manually managed node pool.....................764Modify default storage pool settings.............................................. 764SmartPools settings....................................................................... 764
Managing L3 cache from the command-line interface.................................. 767Set L3 cache as the default for new node pools..............................767Enable L3 cache on a specific node pool ....................................... 768Restore SSDs to storage drives for a node pool.............................. 768
Managing tiers............................................................................................ 768Create a tier................................................................................... 768Add or move node pools in a tier....................................................769Rename a tier.................................................................................769Delete a tier................................................................................... 769
Creating file pool policies............................................................................769Create a file pool policy..................................................................770Valid wildcard characters............................................................... 771Default file pool requested protection settings............................... 771Default file pool I/O optimization settings...................................... 773
Managing file pool policies......................................................................... 773Modify a file pool policy................................................................. 774Configure default file pool policy settings.......................................774Prioritize a file pool policy.............................................................. 775
Chapter 22
CONTENTS
OneFS 7.2.1 CLI Administration Guide 19
-
Delete a file pool policy..................................................................775Monitoring storage pools............................................................................ 776
Monitor storage pools.................................................................... 776View the health of storage pools.................................................... 776View results of a SmartPools job.................................................... 777
Storage pool commands............................................................................. 777isi filepool apply............................................................................ 777isi filepool default-policy modify.................................................... 780isi filepool default-policy view........................................................781isi filepool policies create.............................................................. 781isi filepool policies delete.............................................................. 784isi filepool policies list................................................................... 785isi filepool policies modify............................................................. 786isi filepool policies view................................................................. 789isi filepool templates list................................................................789isi filepool templates view..............................................................790isi storagepool compatibilities class active create..........................790isi storagepool compatibilities class active delete..........................791isi storagepool compatibilities class active list...............................791isi storagepool compatibilities class active view............................ 792isi storagepool compatibilities class available list..........................793isi storagepool compatibilities ssd active create............................ 793isi storagepool compatibilities ssd active delete............................ 795isi storagepool compatibilities ssd active list................................. 796isi storagepool compatibilities ssd active vie