Isilon

OneFS
Version 7.2

CLI Administration Guide

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

Published November, 2014
EMC believes the information in this publication is accurate as of its publication date. The information is subject to change
without notice.
The information in this publication is provided as is. EMC Corporation makes no representations or warranties of any kind with
respect to the information in this publication, and specifically disclaims implied warranties of merchantability or fitness for a
particular purpose. Use, copying, and distribution of any EMC software described in this publication requires an applicable
software license.
EMC, EMC, and the EMC logo are registered trademarks or trademarks of EMC Corporation in the United States and other
countries. 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 ([Link]
EMC Corporation
Hopkinton, Massachusetts 01748-9103
1-508-435-1000 In North America 1-866-464-7381
[Link]

OneFS 7.2 CLI Administration Guide

CONTENTS

Chapter 1

Introduction to this guide

27

About this guide............................................................................................28

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

Chapter 2

Isilon scale-out NAS

29

OneFS storage architecture........................................................................... 30

Isilon node components................................................................................30
Internal and external networks...................................................................... 31
Isilon cluster................................................................................................. 31
Cluster administration......................................................................31
Quorum............................................................................................31
Splitting and merging.......................................................................32
Storage pools...................................................................................33
IP address pools.............................................................................. 33
The OneFS operating system......................................................................... 33
Data-access protocols......................................................................34
Identity management and access control......................................... 34
Structure of the file system............................................................................35
Data layout...................................................................................... 35
Writing files......................................................................................36
Reading files.................................................................................... 36
Metadata layout...............................................................................36
Locks and concurrency.....................................................................37
Striping............................................................................................ 37
Data protection overview...............................................................................37
N+M data protection........................................................................ 38
Data mirroring.................................................................................. 39
The file system journal..................................................................... 39
Virtual hot spare.............................................................................. 39
Balancing protection with storage space.......................................... 39
VMware integration....................................................................................... 39
Software modules......................................................................................... 40

Chapter 3

Introduction to the OneFS command-line interface

41

OneFS command-line interface overview....................................................... 42

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

Chapter 4

General cluster administration

51

General cluster administration overview........................................................52

User interfaces.............................................................................................. 52
Connecting to the cluster...............................................................................52
Log in to the web administration interface........................................53
OneFS 7.2 CLI Administration Guide

CONTENTS

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

Licensing.......................................................................................................53
License status..................................................................................54
License configuration....................................................................... 56
Activate a license through the command-line interface.....................57
View license information.................................................................. 57
Unconfigure a license.......................................................................57
Certificates....................................................................................................58
Replace or renew the SSL certificate................................................. 58
Verify an SSL certificate update........................................................ 59
Self-signed SSL certificate data example.......................................... 59
Cluster identity..............................................................................................60
Set the cluster name ....................................................................... 60
Cluster contact information........................................................................... 60
Specify contact information .............................................................61
Cluster date and time.................................................................................... 61
Set the cluster date and time........................................................... 62
Specify an NTP time server............................................................... 62
SMTP email settings...................................................................................... 62
Configure SMTP email settings ........................................................ 62
View SMTP email settings.................................................................63
Configuring the cluster join mode..................................................................63
Specify the cluster join mode .......................................................... 63
Cluster join modes........................................................................... 64
File system settings.......................................................................................64
Specify the cluster character encoding............................................. 64
Enable or disable access time tracking ............................................ 65
Cluster monitoring.........................................................................................65
Monitor the cluster...........................................................................66
View node status............................................................................. 66
Monitoring cluster hardware..........................................................................66
View node hardware status.............................................................. 66
Chassis and drive states.................................................................. 66
Check battery status........................................................................ 69
SNMP monitoring............................................................................. 69
Events and notifications................................................................................ 73
Coalesced events............................................................................. 73
Viewing event information................................................................75
Responding to events.......................................................................77
Managing event notification settings................................................79
Managing event notification rules.................................................... 81
Cluster maintenance..................................................................................... 83
Replacing node components............................................................ 83
Upgrading node components........................................................... 83
Managing drive firmware..................................................................83
Managing cluster nodes................................................................... 88
Upgrading OneFS............................................................................. 89
Remote support.............................................................................................89
Remote support using SupportIQ..................................................... 90
Remote support using ESRS Gateway............................................... 93
Cluster administration commands.................................................................95
isi config.......................................................................................... 95
isi email........................................................................................... 99
isi email list................................................................................... 100
isi exttools..................................................................................... 100
isi license activate......................................................................... 101
4

OneFS 7.2 CLI Administration Guide

CONTENTS

isi license status............................................................................ 101

isi license unconfigure................................................................... 101
isi perfstat......................................................................................101
isi pkg create................................................................................. 101
isi pkg delete................................................................................. 102
isi pkg info..................................................................................... 102
isi pkg install................................................................................. 103
isi remotesupport connectemc modify............................................103
isi remotesupport connectemc view............................................... 104
isi services..................................................................................... 104
isi set.............................................................................................105
isi snmp.........................................................................................108
isi snmp list................................................................................... 109
isi statistics client.......................................................................... 109
isi statistics describe..................................................................... 115
isi statistics drive........................................................................... 115
isi statistics heat............................................................................117
isi statistics history........................................................................ 121
isi statistics list all......................................................................... 123
isi statistics list classes..................................................................123
isi statistics list events...................................................................124
isi statistics list nodes................................................................... 124
isi statistics list nooutput...............................................................125
isi statistics list operations............................................................ 125
isi statistics list orderby................................................................. 126
isi statistics list output...................................................................126
isi statistics list protocols.............................................................. 127
isi statistics list stats..................................................................... 127
isi statistics list totalby.................................................................. 128
isi statistics protocol......................................................................128
isi statistics pstat...........................................................................134
isi statistics query.......................................................................... 136
isi statistics system........................................................................137
isi status........................................................................................ 139
isi update.......................................................................................139
isi version...................................................................................... 140
isi_for_array...................................................................................141
isi get.............................................................................................143
isi_gather_info...............................................................................144
Event commands.........................................................................................149
isi events cancel............................................................................ 149
isi events list..................................................................................149
isi events notifications create.........................................................151
isi events notifications modify........................................................152
isi events notifications delete........................................................ 154
isi events notifications list............................................................. 154
isi events quiet.............................................................................. 154
isi events sendtest......................................................................... 154
isi events settings list.................................................................... 155
isi events settings set.....................................................................155
isi events show.............................................................................. 155
isi events unquiet.......................................................................... 156
Hardware commands.................................................................................. 156
isi batterystatus............................................................................. 156
isi devices......................................................................................157
isi servicelight status..................................................................... 158
OneFS 7.2 CLI Administration Guide

CONTENTS

isi servicelight off...........................................................................158

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

Chapter 5

Access zones

167

Access zones overview ............................................................................... 168

Access zone base directory rules.................................................................168
Access zones best practices........................................................................169
Access zone limits.......................................................................................169
Quality of service........................................................................................ 170
Managing access zones.............................................................................. 171
Create an access zone....................................................................171
Associate an IP address pool with an access zone..........................171
Modify an access zone................................................................... 172
Add an authentication provider to an access zone..........................172
Remove an authentication provider from an access zone............... 172
Delete an access zone....................................................................172
Access zone commands.............................................................................. 173
isi zone restrictions create............................................................. 173
isi zone restrictions delete............................................................. 174
isi zone restrictions list.................................................................. 174
isi zone zones create......................................................................175
isi zone zones delete..................................................................... 178
isi zone zones list.......................................................................... 178
isi zone zones modify.....................................................................179
isi zone zones view........................................................................ 184

Chapter 6

Authentication and access control

185

Authentication and access control overview................................................ 186

Role-based access...................................................................................... 186
Roles and privileges.......................................................................186
Data backup and restore privileges................................................ 197
User permissions utility..................................................................198
Authentication............................................................................................ 198
Supported authentication providers...............................................198
Authentication provider features.................................................... 199
Kerberos authentication.................................................................199
LDAP.............................................................................................. 200
Active Directory.............................................................................. 200
NIS.................................................................................................201
File provider................................................................................... 201
Local provider................................................................................ 202
Data access control..................................................................................... 202
Authorization.............................................................................................. 202
SMB...............................................................................................203
NFS................................................................................................ 203
Mixed-permission environments.................................................... 204
Managing roles........................................................................................... 205
6

OneFS 7.2 CLI Administration Guide

CONTENTS

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

View privileges...............................................................................205
Create and modify a custom role.................................................... 206
Delete a custom role...................................................................... 206
Managing authentication providers............................................................. 206
Managing LDAP providers.............................................................. 207
Managing Active Directory providers.............................................. 208
Managing NIS providers................................................................. 209
Managing file providers..................................................................210
Managing local users and groups...................................................214
Managing MIT Kerberos authentication.......................................... 218
Managing access permissions.....................................................................225
View expected user permissions.................................................... 225
Configure access management settings......................................... 226
Modify ACL policy settings..............................................................227
Update cluster permissions............................................................227
Authentication and access control commands............................................ 228
isi auth access............................................................................... 228
isi auth ads create..........................................................................229
isi auth ads delete......................................................................... 232
isi auth ads list.............................................................................. 232
isi auth ads modify.........................................................................233
isi auth ads spn check................................................................... 237
isi auth ads spn create................................................................... 237
isi auth ads spn delete...................................................................238
isi auth ads spn list........................................................................239
isi auth ads trusts controllers list................................................... 239
isi auth ads trusts list.....................................................................240
isi auth ads trusts view.................................................................. 240
isi auth ads view............................................................................ 240
isi auth error.................................................................................. 241
isi auth file create.......................................................................... 241
isi auth file delete.......................................................................... 244
isi auth file list............................................................................... 245
isi auth file modify......................................................................... 245
isi auth file view............................................................................. 252
isi auth groups create.................................................................... 252
isi auth groups delete.................................................................... 253
isi auth groups flush...................................................................... 254
isi auth groups list......................................................................... 254
isi auth groups modify................................................................... 255
isi auth groups members list.......................................................... 256
isi auth groups view....................................................................... 257
isi auth id.......................................................................................257
isi auth krb5 realm create...............................................................258
isi auth krb5 realm delete.............................................................. 258
isi auth krb5 realm modify............................................................. 258
isi auth krb5 realm list................................................................... 259
isi auth krb5 realm view................................................................. 259
isi auth krb5 create........................................................................ 260
isi auth krb5 delete........................................................................ 260
isi auth krb5 list............................................................................. 261
isi auth krb5 view...........................................................................261
isi auth krb5 domain create........................................................... 261
isi auth krb5 domain delete........................................................... 262
isi auth krb5 domain modify.......................................................... 262
OneFS 7.2 CLI Administration Guide

CONTENTS

isi auth krb5 domain list................................................................ 262

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

Chapter 7

Identity management

319

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

8

OneFS 7.2 CLI Administration Guide

CONTENTS

Identity types.............................................................................................. 320

Access tokens............................................................................................. 321
Access token generation............................................................................. 322
ID mapping.................................................................................... 322
User mapping................................................................................ 324
On-disk identity............................................................................. 326
Managing ID mappings............................................................................... 327
Create an identity mapping............................................................ 327
Modify an identity mapping............................................................328
Delete an identity mapping............................................................ 328
View an identity mapping...............................................................328
Flush the identity mapping cache...................................................329
View a user token...........................................................................329
Configure identity mapping settings...............................................330
View identity mapping settings...................................................... 330
Managing user identities.............................................................................330
View user identity.......................................................................... 331
Create a user-mapping rule............................................................ 332
Merge Windows and UNIX tokens................................................... 333
Retrieve the primary group from LDAP............................................ 333
Mapping rule options..................................................................... 334
Mapping rule operators..................................................................335

Chapter 8

Auditing

337

Auditing overview........................................................................................338
Protocol audit events.................................................................................. 338
Supported event types................................................................................ 338
Supported audit tools................................................................................. 339
Managing audit settings..............................................................................340
Enable system configuration auditing............................................ 340
Enable protocol access auditing.....................................................340
Auditing settings............................................................................341
Integrating with the EMC Common Event Enabler.........................................342
Install CEE for Windows..................................................................343
Configure CEE for Windows............................................................ 344
Auditing commands.................................................................................... 344
isi audit settings modify.................................................................344
isi audit settings view.................................................................... 346
isi audit topics list..........................................................................347
isi audit topics modify....................................................................348
isi audit topics view....................................................................... 348

Chapter 9

File sharing

349

File sharing overview...................................................................................350

SMB............................................................................................................ 350
SMB shares in access zones.......................................................... 351
SMB Multichannel..........................................................................351
SMB share management through MMC.......................................... 353
Symbolic links through SMB.......................................................... 354
Anonymous access to SMB shares................................................. 355
NFS............................................................................................................. 355
NFS exports....................................................................................355
NFS aliases.................................................................................... 356
NFS log files................................................................................... 356
OneFS 7.2 CLI Administration Guide

CONTENTS

HTTP and HTTPS.......................................................................................... 357

FTP.............................................................................................................. 357
Mixed protocol environments...................................................................... 357
Write caching with SmartCache................................................................... 357
Write caching for asynchronous writes........................................... 358
Write caching for synchronous writes............................................. 358
Managing SMB settings...............................................................................359
View global SMB settings............................................................... 359
Configure global SMB settings....................................................... 359
Enable or disable the SMB service................................................. 359
Enable or disable SMB Multichannel.............................................. 360
View default SMB share settings.................................................... 360
Configure default SMB share settings.............................................361
Enable or disable SMB Multichannel.............................................. 361
Managing SMB shares.................................................................................361
Create an SMB share......................................................................362
Modify an SMB share..................................................................... 363
Delete an SMB share......................................................................364
Limit access to /ifs share for the Everyone account........................ 364
Configure anonymous access to a single SMB share...................... 364
Configure anonymous access to all SMB shares in an access zone.365
Configure multi-protocol home directory access............................. 366
Supported expansion variables......................................................366
Managing the NFS service........................................................................... 367
View NFS settings...........................................................................367
Configure NFS file sharing.............................................................. 367
Enable or disable the NFS service...................................................368
Managing NFS exports.................................................................................368
Configure default NFS export settings.............................................368
Create a root-squashing rule for an export......................................369
Create an NFS export ..................................................................... 369
Check NFS exports for errors.......................................................... 370
Modify an NFS export..................................................................... 370
Delete an NFS export......................................................................370
Managing NFS aliases................................................................................. 371
Create an NFS alias........................................................................ 371
Modify an NFS alias........................................................................371
Delete an NFS alias........................................................................ 372
List NFS aliases.............................................................................. 372
View an NFS alias...........................................................................373
View FTP settings.........................................................................................373
Enable FTP file sharing................................................................................ 374
Configure FTP file sharing............................................................................ 374
Enable and configure HTTP.......................................................................... 374
SMB commands.......................................................................................... 376
isi smb log-level.............................................................................376
isi smb log-level add...................................................................... 376
isi smb log-level delete.................................................................. 377
isi smb log-level list....................................................................... 377
isi smb openfiles close...................................................................378
isi smb openfiles list...................................................................... 378
isi smb sessions delete..................................................................379
isi smb sessions delete-user.......................................................... 379
isi smb sessions list.......................................................................380
isi smb settings global modify........................................................381
isi smb settings global view........................................................... 383
10

OneFS 7.2 CLI Administration Guide

CONTENTS

isi smb settings shares modify....................................................... 384

isi smb settings shares view...........................................................387
isi smb shares create..................................................................... 387
isi smb shares delete..................................................................... 390
isi smb shares list.......................................................................... 391
isi smb shares modify.................................................................... 391
isi smb shares permission create................................................... 396
isi smb shares permission delete................................................... 396
isi smb shares permission list........................................................ 397
isi smb shares permission modify.................................................. 398
isi smb shares permission view......................................................399
isi smb shares view........................................................................399
NFS commands........................................................................................... 400
isi nfs log-level...............................................................................400
isi nfs aliases create...................................................................... 401
isi nfs aliases delete...................................................................... 401
isi nfs aliases list........................................................................... 402
isi nfs aliases modify..................................................................... 403
isi nfs aliases view......................................................................... 403
isi nfs exports check...................................................................... 404
isi nfs exports create...................................................................... 405
isi nfs exports delete......................................................................411
isi nfs exports list...........................................................................412
isi nfs exports modify..................................................................... 414
isi nfs exports reload......................................................................425
isi nfs exports view.........................................................................425
isi nfs netgroup bgwrite..................................................................425
isi nfs netgroup check.................................................................... 425
isi nfs netgroup expiration............................................................. 426
isi nfs netgroup flush..................................................................... 426
isi nfs netgroup lifetime................................................................. 426
isi nfs netgroup retry...................................................................... 426
isi nfs nlm locks list....................................................................... 427
isi nfs nlm locks waiters................................................................. 428
isi nfs nlm sessions disconnect......................................................429
isi nfs nlm sessions list.................................................................. 429
isi nfs settings export modify......................................................... 430
isi nfs settings export view............................................................. 438
isi nfs settings global modify..........................................................439
isi nfs settings global view............................................................. 440
isi nfs settings zone modify............................................................440
isi nfs settings zone view............................................................... 441
FTP commands............................................................................................ 441
isi ftp accept-timeout..................................................................... 441
isi ftp allow-dirlists.........................................................................442
isi ftp allow-anon-access................................................................442
isi ftp allow-anon-upload............................................................... 443
isi ftp allow-downloads.................................................................. 443
isi ftp allow-local-access................................................................ 443
isi ftp allow-writes..........................................................................444
isi ftp always-chdir-homedir........................................................... 444
isi ftp anon-chown-username......................................................... 445
isi ftp anon-password-list...............................................................445
isi ftp anon-password-list add........................................................445
isi ftp anon-password-list remove.................................................. 446
isi ftp anon-root-path..................................................................... 446
OneFS 7.2 CLI Administration Guide

11

CONTENTS

isi ftp anon-umask......................................................................... 447

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

Chapter 10

Home directories

457

Home directories overview.......................................................................... 458

Home directory permissions........................................................................458
Authenticating SMB users........................................................................... 458
Home directory creation through SMB......................................................... 458
Create home directories with expansion variables..........................459
Create home directories with the --inheritable-path-acl option....... 460
Create special home directories with the SMB share %U variable...461
Home directory creation through SSH and FTP............................................. 462
Set the SSH or FTP login shell ........................................................ 462
Set SSH/FTP home directory permissions....................................... 462
Set SSH/FTP home directory creation options.................................463
Provision home directories with dot files........................................464
Home directory creation in a mixed environment......................................... 465
Interactions between ACLs and mode bits................................................... 465
Default home directory settings in authentication providers........................ 465
Supported expansion variables................................................................... 466
Domain variables in home directory provisioning........................................ 467

Chapter 11

Snapshots

469

Snapshots overview.................................................................................... 470

Data protection with SnapshotIQ.................................................................470
Snapshot disk-space usage........................................................................ 470
Snapshot schedules....................................................................................471
Snapshot aliases........................................................................................ 471
File and directory restoration.......................................................................471
Best practices for creating snapshots..........................................................472
Best practices for creating snapshot schedules........................................... 472
File clones...................................................................................................473
Shadow-store considerations.........................................................474
Snapshot locks........................................................................................... 474
Snapshot reserve........................................................................................ 475
12

OneFS 7.2 CLI Administration Guide

CONTENTS

SnapshotIQ license functionality.................................................................475

Creating snapshots with SnapshotIQ...........................................................475
Create a SnapRevert domain.......................................................... 476
Create a snapshot schedule........................................................... 476
Create a snapshot.......................................................................... 476
Snapshot naming patterns............................................................. 477
Managing snapshots .................................................................................. 479
Reducing snapshot disk-space usage............................................ 479
Delete a snapshot.......................................................................... 480
Modify snapshot attributes............................................................ 480
Modify a snapshot alias ................................................................ 480
View snapshots..............................................................................481
Snapshot information.................................................................... 481
Restoring snapshot data............................................................................. 482
Revert a snapshot ......................................................................... 482
Restore a file or directory using Windows Explorer..........................482
Restore a file or directory through a UNIX command line.................483
Clone a file from a snapshot...........................................................483
Managing snapshot schedules....................................................................484
Modify a snapshot schedule ......................................................... 484
Delete a snapshot schedule .......................................................... 484
View snapshot schedules ..............................................................484
Managing snapshot aliases.........................................................................485
Configure a snapshot alias for a snapshot schedule.......................485
Assign a snapshot alias to a snapshot........................................... 485
Reassign a snapshot alias to the live file system............................ 486
View snapshot aliases................................................................... 486
Snapshot alias information............................................................ 486
Managing with snapshot locks.................................................................... 487
Create a snapshot lock...................................................................487
Modify a snapshot lock expiration date..........................................487
Delete a snapshot lock...................................................................488
Snapshot lock information............................................................. 488
Configure SnapshotIQ settings ................................................................... 488
SnapshotIQ settings ......................................................................489
Set the snapshot reserve.............................................................................490
Snapshot commands.................................................................................. 490
Snapshot naming patterns............................................................. 490
isi snapshot schedules create........................................................ 493
isi snapshot schedules modify....................................................... 494
isi snapshot schedules delete........................................................496
isi snapshot schedules list.............................................................496
isi snapshot schedules view.......................................................... 498
isi snapshot schedules pending list............................................... 498
isi snapshot snapshots create........................................................499
isi snapshot snapshots modify.......................................................500
isi snapshot snapshots delete....................................................... 501
isi snapshot snapshots list............................................................ 501
isi snapshot snapshots view.......................................................... 503
isi snapshot settings modify.......................................................... 503
isi snapshot settings view.............................................................. 505
isi snapshot locks create................................................................505
isi snapshot locks modify...............................................................506
isi snapshot locks delete............................................................... 507
isi snapshot locks list.................................................................... 508
isi snapshot locks view.................................................................. 509
OneFS 7.2 CLI Administration Guide

13

CONTENTS

isi snapshot aliases create.............................................................509

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

Chapter 12

Deduplication with SmartDedupe

513

Deduplication overview...............................................................................514
Deduplication jobs......................................................................................514
Data replication and backup with deduplication..........................................515
Snapshots with deduplication.....................................................................515
Deduplication considerations......................................................................515
Shadow-store considerations......................................................................516
SmartDedupe license functionality..............................................................516
Managing deduplication............................................................................. 516
Assess deduplication space savings ............................................. 517
Specify deduplication settings ...................................................... 517
View deduplication space savings .................................................518
View a deduplication report ...........................................................518
Deduplication job report information............................................. 518
Deduplication information............................................................. 519
Deduplication commands........................................................................... 520
isi dedupe settings modify............................................................. 520
isi dedupe settings view.................................................................521
isi dedupe stats............................................................................. 521
isi dedupe reports list.................................................................... 522
isi dedupe reports view ................................................................. 522

Chapter 13

Data replication with SyncIQ

525

SyncIQ backup and recovery overview......................................................... 526

Replication policies and jobs...................................................................... 526
Automated replication policies.......................................................527
Source and target cluster association.............................................527
Full and differential replication.......................................................528
Controlling replication job resource consumption.......................... 528
Replication reports.........................................................................529
Replication snapshots.................................................................................529
Source cluster snapshots............................................................... 529
Target cluster snapshots................................................................ 530
Data failover and failback with SyncIQ.........................................................530
Data failover.................................................................................. 531
Data failback..................................................................................531
Recovery times and objectives for SyncIQ....................................................531
SyncIQ license functionality........................................................................ 532
Creating replication policies........................................................................ 532
Excluding directories in replication.................................................532
Excluding files in replication.......................................................... 533
File criteria options........................................................................ 534
Configure default replication policy settings ..................................536
Create a replication policy..............................................................536
Create a SyncIQ domain................................................................. 537
Assess a replication policy ............................................................ 537
Managing replication to remote clusters......................................................537
Start a replication job.....................................................................538
14

OneFS 7.2 CLI Administration Guide

CONTENTS

Pause a replication job ..................................................................538

Resume a replication job ...............................................................538
Cancel a replication job .................................................................538
View active replication jobs ...........................................................539
Replication job information ........................................................... 539
Initiating data failover and failback with SyncIQ.......................................... 539
Fail over data to a secondary cluster ..............................................540
Revert a failover operation............................................................. 540
Fail back data to a primary cluster ................................................. 540
Performing disaster recovery for SmartLock directories................................541
Recover SmartLock directories on a target cluster ..........................541
Migrate SmartLock directories ....................................................... 542
Managing replication policies..................................................................... 543
Modify a replication policy ............................................................ 543
Delete a replication policy ............................................................. 544
Enable or disable a replication policy ............................................ 544
View replication policies ............................................................... 544
Replication policy information .......................................................545
Managing replication to the local cluster..................................................... 546
Cancel replication to the local cluster ............................................ 546
Break local target association ....................................................... 546
View replication policies targeting the local cluster........................ 546
Remote replication policy information ........................................... 547
Managing replication performance rules..................................................... 547
Create a network traffic rule ...........................................................547
Create a file operations rule .......................................................... 548
Modify a performance rule .............................................................548
Delete a performance rule ............................................................. 548
Enable or disable a performance rule ............................................ 548
View performance rules .................................................................549
Managing replication reports.......................................................................549
Configure default replication report settings ..................................549
Delete replication reports...............................................................549
View replication reports ................................................................ 550
Replication report information........................................................551
Managing failed replication jobs................................................................. 552
Resolve a replication policy ........................................................... 553
Reset a replication policy .............................................................. 553
Perform a full or differential replication.......................................... 553
Managing changelists................................................................................. 554
Create a changelist........................................................................ 554
View a changelist........................................................................... 555
Changelist information...................................................................555
Data replication commands.........................................................................557
isi sync policies create................................................................... 557
isi sync policies modify.................................................................. 565
isi sync policy delete...................................................................... 574
isi sync policies list........................................................................ 574
isi sync policies view......................................................................577
isi sync policies disable................................................................. 577
isi sync policies enable.................................................................. 577
isi sync jobs start........................................................................... 578
isi sync jobs pause.........................................................................578
isi sync jobs resume.......................................................................579
isi sync jobs cancel........................................................................ 579
isi sync jobs list............................................................................. 579
OneFS 7.2 CLI Administration Guide

15

CONTENTS

isi sync jobs view........................................................................... 580

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

Chapter 14

Data layout with FlexProtect

601

FlexProtect overview....................................................................................602
File striping................................................................................................. 602
Requested data protection.......................................................................... 602
FlexProtect data recovery.............................................................................603
Smartfail........................................................................................ 603
Node failures................................................................................. 603
Requesting data protection......................................................................... 604
Requested protection settings.....................................................................604
Requested protection disk space usage...................................................... 605

Chapter 15

NDMP backup

607

NDMP backup and recovery overview.......................................................... 608

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

OneFS 7.2 CLI Administration Guide

CONTENTS

NDMP backup settings .................................................................. 615

Managing NDMP user accounts................................................................... 615
Create an NDMP user account ....................................................... 615
Modify the password of an NDMP user account ............................. 615
Delete an NDMP user account ....................................................... 615
View NDMP user accounts ............................................................. 616
Managing NDMP backup devices.................................................................616
Detect NDMP backup devices ........................................................ 616
Modify an NDMP backup device entry name .................................. 616
Delete a device entry for a disconnected NDMP backup device.......616
View NDMP backup devices .......................................................... 617
Managing NDMP backup ports.................................................................... 617
Modify NDMP backup port settings ................................................617
Enable or disable an NDMP backup port.........................................617
View NDMP backup ports .............................................................. 617
NDMP backup port settings ........................................................... 618
Managing NDMP backup sessions...............................................................618
End an NDMP session ................................................................... 618
View NDMP sessions ..................................................................... 618
NDMP session information ............................................................ 619
Managing restartable backups.................................................................... 619
Configure restartable backups for EMC NetWorker..........................620
View restartable backup contexts...................................................620
Delete a restartable backup context............................................... 621
Configure restartable backup settings............................................ 621
View restartable backup settings................................................... 621
Managing file list backups.......................................................................... 621
Format of a backup file list............................................................. 622
Placement of the file list.................................................................623
Start a file list backup.................................................................... 623
Improving NDMP restore performance......................................................... 623
Specify a serial restore operation................................................... 624
Sharing tape drives between clusters.......................................................... 624
Managing default NDMP settings.................................................................625
Set default NDMP settings for a directory....................................... 625
Modify default NDMP settings for a directory.................................. 625
View default NDMP settings for directories..................................... 625
NDMP environment variables......................................................... 626
Managing snapshot based incremental backups.........................................628
Enable snapshot-based incremental backups for a directory.......... 628
Delete snapshots for snapshot-based incremental backups...........629
View snapshots for snapshot-based incremental backups............. 629
View NDMP backup logs ............................................................................. 629
NDMP backup commands........................................................................... 629
isi ndmp user create.......................................................................629
isi ndmp user modify..................................................................... 630
isi ndmp user delete...................................................................... 630
isi ndmp user list........................................................................... 631
isi tape rescan............................................................................... 631
isi tape rename.............................................................................. 632
isi tape delete................................................................................ 632
isi tape list..................................................................................... 632
isi fc set......................................................................................... 633
isi fc disable.................................................................................. 634
isi fc enable................................................................................... 635
isi fc list......................................................................................... 635
OneFS 7.2 CLI Administration Guide

17

CONTENTS

isi ndmp kill................................................................................... 636

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

Chapter 16

File retention with SmartLock

645

SmartLock overview.................................................................................... 646

Compliance mode....................................................................................... 646
SmartLock directories................................................................................. 646
Replication and backup with SmartLock...................................................... 647
SmartLock replication and backup limitations................................647
SmartLock license functionality...................................................................648
SmartLock considerations........................................................................... 648
Set the compliance clock............................................................................ 649
View the compliance clock.......................................................................... 649
Creating a SmartLock directory.................................................................... 649
Retention periods...........................................................................649
Autocommit time periods............................................................... 650
Create a SmartLock directory..........................................................650
Managing SmartLock directories................................................................. 651
Modify a SmartLock directory......................................................... 651
View SmartLock directory settings..................................................651
SmartLock directory configuration settings.....................................652
Managing files in SmartLock directories...................................................... 655
Set a retention period through a UNIX command line..................... 655
Set a retention period through Windows Powershell.......................655
Commit a file to a WORM state through a UNIX command line........ 656
Commit a file to a WORM state through Windows Explorer..............656
Override the retention period for all files in a SmartLock directory.. 656
Delete a file committed to a WORM state ....................................... 657
View WORM status of a file.............................................................657
SmartLock commands.................................................................................658
isi worm domains create................................................................ 658
isi worm domains modify............................................................... 661
isi worm domains list..................................................................... 665
isi worm domains view .................................................................. 666
isi worm cdate set.......................................................................... 666
isi worm cdate view........................................................................667
isi worm files delete....................................................................... 667
isi worm files view..........................................................................667

Chapter 17
18

OneFS 7.2 CLI Administration Guide

Protection domains

669

CONTENTS

Protection domains overview...................................................................... 670

Protection domain considerations...............................................................670
Create a protection domain ........................................................................ 671
Delete a protection domain ........................................................................ 671

Chapter 18

Data-at-rest-encryption

673

Data-at-rest encryption overview................................................................. 674

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

Chapter 19

SmartQuotas

681

SmartQuotas overview................................................................................ 682

Quota types................................................................................................ 682
Default quota type.......................................................................................683
Usage accounting and limits....................................................................... 685
Disk-usage calculations.............................................................................. 686
Quota notifications..................................................................................... 687
Quota notification rules...............................................................................687
Quota reports..............................................................................................688
Creating quotas...........................................................................................688
Create an accounting quota........................................................... 689
Create an enforcement quota......................................................... 689
Managing quotas........................................................................................ 690
Search for quotas...........................................................................690
Manage quotas.............................................................................. 690
Export a quota configuration file.................................................... 691
Import a quota configuration file.................................................... 691
Managing quota notifications.........................................................692
Managing quota reports................................................................. 694
Basic quota settings...................................................................... 696
Advisory limit quota notification rules settings............................... 696
Soft limit quota notification rules settings...................................... 697
Hard limit quota notification rules settings.....................................698
Limit notification settings...............................................................698
Quota report settings..................................................................... 698
Custom email notification template variable descriptions.............. 699
Quota commands........................................................................................700
isi quota quotas create.................................................................. 700
isi quota quotas delete.................................................................. 702
isi quota quotas modify................................................................. 703
isi quota quotas list....................................................................... 706
isi quota quotas view..................................................................... 708
isi quota quotas notifications clear................................................ 709
isi quota quotas notifications create.............................................. 710
isi quota quotas notifications delete.............................................. 712
isi quota quotas notifications disable............................................ 714
isi quota quotas notifications list................................................... 715
isi quota quotas notifications modify............................................. 717
isi quota quotas notifications view.................................................720
isi quota reports create.................................................................. 722
isi quota reports delete.................................................................. 722
OneFS 7.2 CLI Administration Guide

19

CONTENTS

isi quota reports list....................................................................... 723

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

Chapter 20

Storage Pools

733

Storage pools overview............................................................................... 734

Storage pool functions................................................................................ 734
Autoprovisioning.........................................................................................736
Virtual hot spare..........................................................................................736
Spillover..................................................................................................... 737
Node pools................................................................................................. 737
Node compatibilities......................................................................737
Manual node pools........................................................................ 738
Suggested protection.................................................................................. 739
Protection policies...................................................................................... 739
SSD strategies.............................................................................................740
Global namespace acceleration.................................................................. 740
L3 cache overview....................................................................................... 741
Migration to L3 cache.....................................................................742
L3 cache on HD400 node pools......................................................742
Required privileges........................................................................ 743
Tiers............................................................................................................743
File pools.................................................................................................... 743
File pool policies......................................................................................... 743
Managing node pools through the command-line interface......................... 744
Add a compatible node to a node pool........................................... 744
Merge compatible node pools........................................................ 745
Delete a compatibility.................................................................... 746
Create a node pool manually..........................................................746
Add a node to a manually managed node pool...............................747
Change the name or protection policy of a node pool..................... 747
Remove a node from a manually managed node pool.....................747
Managing L3 cache from the command-line interface.................................. 747
Set L3 cache as the default for new node pools..............................748
Enable L3 cache on a specific node pool ....................................... 748
Restore SSDs to storage drives for a node pool.............................. 748
Managing tiers............................................................................................ 749
Create a tier................................................................................... 749
Add or move node pools in a tier.................................................... 749
Rename a tier.................................................................................749
Delete a tier................................................................................... 750
Creating file pool policies............................................................................750
Create a file pool policy..................................................................751
File-matching options for file pool policies..................................... 751
Valid wildcard characters............................................................... 753
SmartPools settings....................................................................... 753
Default file pool requested protection settings............................... 755
Default file pool I/O optimization settings...................................... 756
Managing file pool policies......................................................................... 757
20

OneFS 7.2 CLI Administration Guide

CONTENTS

Modify a file pool policy................................................................. 757

Modify default storage pool settings.............................................. 758
Configure default file pool policy settings.......................................758
Prioritize a file pool policy.............................................................. 759
Delete a file pool policy..................................................................759
Monitoring storage pools............................................................................ 760
Monitor storage pools.................................................................... 760
View the health of storage pools.................................................... 760
View results of a SmartPools job.................................................... 760
Storage pool commands............................................................................. 761
isi filepool apply............................................................................ 761
isi filepool default-policy modify.................................................... 763
isi filepool default-policy view........................................................765
isi filepool policies create.............................................................. 765
isi filepool policies delete.............................................................. 768
isi filepool policies list................................................................... 769
isi filepool policies modify............................................................. 769
isi filepool policies view................................................................. 773
isi filepool templates list................................................................773
isi filepool templates view..............................................................774
isi storagepool compatibilities active create...................................774
isi storagepool compatibilities active delete.................................. 775
isi storagepool compatibilities active list....................................... 775
isi storagepool compatibilities active view..................................... 776
isi storagepool compatibilities available list.................................. 777
isi storagepool health.................................................................... 778
isi storagepool list......................................................................... 778
isi storagepool nodepools create................................................... 778
isi storagepool nodepools delete................................................... 779
isi storagepool nodepools list........................................................ 779
isi storagepool nodepools modify.................................................. 780
isi storagepool nodepools view......................................................781
isi storagepool settings modify...................................................... 782
isi storagepool settings view.......................................................... 783
isi storagepool tiers create............................................................. 783
isi storagepool tiers delete.............................................................784
isi storagepool tiers list..................................................................784
isi storagepool tiers modify............................................................ 785
isi storagepool tiers view................................................................785

Chapter 21

System jobs

787

System jobs overview..................................................................................788

System jobs library......................................................................................788
Job operation.............................................................................................. 791
Job performance impact.............................................................................. 792
Job priorities............................................................................................... 793
Managing system jobs................................................................................ 793
Start a job...................................................................................... 793
Pause a job.................................................................................... 794
Modify a job...................................................................................794
Resume a job................................................................................. 794
Cancel a job................................................................................... 795
Modify job type settings................................................................. 795
View active jobs............................................................................. 796
View job history............................................................................. 796
OneFS 7.2 CLI Administration Guide

21

CONTENTS

Managing impact policies........................................................................... 797

Create an impact policy..................................................................797
View impact policy settings............................................................ 797
Modify an impact policy................................................................. 798
Delete an impact policy..................................................................798
Viewing job reports and statistics................................................................799
View statistics for a job in progress................................................ 799
View a report for a completed job...................................................799
Job management commands....................................................................... 800
isi job events list............................................................................800
isi job jobs cancel.......................................................................... 802
isi job jobs list............................................................................... 803
isi job jobs modify..........................................................................804
isi job jobs pause...........................................................................805
isi job jobs resume.........................................................................805
isi job jobs start............................................................................. 806
isi job jobs view............................................................................. 807
isi job policies create..................................................................... 808
isi job policies delete..................................................................... 809
isi job policies list.......................................................................... 810
isi job policies modify.................................................................... 811
isi job policies view........................................................................812
isi job reports list........................................................................... 812
isi job reports view.........................................................................814
isi job statistics list........................................................................ 814
isi job statistics view......................................................................816
isi job types list..............................................................................817
isi job status.................................................................................. 818
isi job types modify........................................................................ 819
isi job types view........................................................................... 820

Chapter 22

Networking

821

Networking overview................................................................................... 822

Internal network overview........................................................................... 822
Internal IP address ranges..............................................................822
Internal network failover................................................................ 823
External client network overview................................................................. 823
External network settings............................................................... 823
IP address pools............................................................................ 824
IPv6 support.................................................................................. 824
SmartConnect module....................................................................825
Connection balancing.................................................................... 825
IP address allocation......................................................................826
IP address failover......................................................................... 827
IP address rebalancing...................................................................827
SmartConnect DNS service.............................................................828
DNS name resolution..................................................................... 828
NIC aggregation............................................................................. 829
Routing options............................................................................. 829
VLANs............................................................................................ 830
Managing internal network settings.............................................................831
Add or remove an internal IP address range................................... 831
Modify an internal network netmask.............................................. 831
Configure and enable internal network failover.............................. 832
Disable internal network failover....................................................833
22

OneFS 7.2 CLI Administration Guide

CONTENTS

Managing external network settings............................................................ 833

Configure DNS settings.................................................................. 833
Managing external network subnets............................................................834
Create a subnet..............................................................................834
Modify a subnet............................................................................. 834
Delete a subnet..............................................................................834
View subnets................................................................................. 835
Enable or disable VLAN tagging......................................................835
Add or remove a DSR address........................................................ 836
Managing IP address pools......................................................................... 836
Create an IP address pool...............................................................836
Modify an IP address pool.............................................................. 837
Delete an IP address pool...............................................................837
View IP address pools.................................................................... 837
Add or remove an IP address range................................................ 838
Configure IP address allocation......................................................838
Configure an IP rebalance policy.................................................... 839
Configure an IP failover policy........................................................ 840
Managing SmartConnect Settings................................................................840
Configure a SmartConnect zone..................................................... 841
Add or remove a SmartConnect zone alias......................................841
Configure a SmartConnect connection balancing policy................. 842
Configure a SmartConnect service IP address................................. 842
Configure a SmartConnect service subnet...................................... 843
Managing network interface members.........................................................843
Add or remove a network interface................................................. 843
Configure NIC Aggregation..............................................................844
Add or remove a static route...........................................................845
View network interfaces................................................................. 846
Managing network interface provisioning rules............................................846
Create a network interface provisioning rule...................................847
Modify a network interface provisioning rule.................................. 847
Delete a network interface provisioning rule...................................847
View network interface provisioning rules...................................... 847
Managing routing options........................................................................... 848
Enable or disable source-based routing......................................... 848
Add or remove a static route...........................................................849
Networking commands................................................................................849
isi networks................................................................................... 849
isi networks create pool................................................................. 851
isi networks create rule.................................................................. 856
isi networks create subnet............................................................. 857
isi networks delete pool................................................................. 858
isi networks delete rule.................................................................. 859
isi networks delete subnet............................................................. 859
isi networks dnscache disable....................................................... 860
isi networks dnscache enable........................................................ 860
isi networks dnscache flush........................................................... 860
isi networks dnscache modify........................................................ 860
isi networks dnscache statistics.....................................................861
isi networks list interfaces..............................................................861
isi networks list pools.................................................................... 862
isi networks list rules..................................................................... 863
isi networks list subnets................................................................ 864
isi networks modify pool................................................................ 865
isi networks modify rule................................................................. 869
OneFS 7.2 CLI Administration Guide

23

CONTENTS

isi networks modify subnet............................................................ 871

isi networks sbr enable.................................................................. 872
isi networks sbr disable................................................................. 872

Chapter 23

Hadoop

873

Hadoop overview........................................................................................ 874

Hadoop architecture....................................................................................874
Hadoop compute layer................................................................... 874
HDFS storage layer......................................................................... 874
How Hadoop is implemented on OneFS.......................................................875
Hadoop distributions supported by OneFS.................................................. 875
WebHDFS.................................................................................................... 876
Secure impersonation................................................................................. 876
Ambari agent.............................................................................................. 877
Virtual HDFS racks.......................................................................................877
HDFS implementation considerations..........................................................878
HDFS directories and Hadoop user accounts.................................. 878
HDFS settings in access zones....................................................... 878
HDFS and SmartConnect................................................................ 878
Implementing Hadoop with OneFS................................................. 879
Managing the HDFS service......................................................................... 879
Configure HDFS service settings..................................................... 879
HDFS service settings.....................................................................880
View HDFS service settings.............................................................881
Enable or disable the HDFS service................................................ 881
Managing HDFS access zone settings..........................................................882
Supported HDFS authentication methods.......................................882
Set the HDFS authentication method in an access zone..................882
Configure HDFS authentication properties on the Hadoop client.....883
Create a local Hadoop user............................................................ 883
Set the HDFS root directory in an access zone................................ 884
Enable or disable WebHDFS within an access zone........................ 884
Configure Ambari agent settings.................................................... 885
Configuring secure impersonation...............................................................885
Create a proxy user........................................................................ 885
Modify a proxy user........................................................................886
Delete a proxy user........................................................................ 886
List the members of a proxy user....................................................886
View proxy users............................................................................ 887
Managing virtual HDFS racks....................................................................... 887
Create a virtual HDFS rack.............................................................. 887
Modify a virtual HDFS rack..............................................................888
Delete a virtual HDFS rack.............................................................. 889
View virtual HDFS racks..................................................................889
HDFS commands......................................................................................... 890
isi hdfs settings modify.................................................................. 890
isi hdfs settings view......................................................................891
isi hdfs proxyusers create.............................................................. 891
isi hdfs proxyusers modify............................................................. 892
isi hdfs proxyusers delete.............................................................. 894
isi hdfs proxyusers members list.................................................... 895
isi hdfs proxyusers list................................................................... 896
isi hdfs proxyusers view................................................................. 896
isi hdfs racks create....................................................................... 897
isi hdfs racks modify...................................................................... 897
24

OneFS 7.2 CLI Administration Guide

CONTENTS

isi hdfs racks delete....................................................................... 898

isi hdfs racks list............................................................................ 898
isi hdfs racks view..........................................................................899

Chapter 24

Antivirus

901

Antivirus overview....................................................................................... 902

On-access scanning.................................................................................... 902
Antivirus policy scanning............................................................................ 903
Individual file scanning............................................................................... 903
Antivirus scan reports................................................................................. 903
ICAP servers................................................................................................ 904
Supported ICAP servers............................................................................... 904
Anitvirus threat responses...........................................................................904
Configuring global antivirus settings........................................................... 905
Exclude files from antivirus scans ..................................................905
Configure on-access scanning settings ..........................................906
Configure antivirus threat response settings ..................................906
Configure antivirus report retention settings...................................906
Enable or disable antivirus scanning.............................................. 906
Managing ICAP servers................................................................................ 907
Add and connect to an ICAP server ................................................ 907
Test an ICAP server connection.......................................................907
Temporarily disconnect from an ICAP server .................................. 907
Reconnect to an ICAP server .......................................................... 908
Remove an ICAP server .................................................................. 908
Create an antivirus policy ........................................................................... 908
Managing antivirus policies.........................................................................909
Modify an antivirus policy ............................................................. 909
Delete an antivirus policy .............................................................. 909
Enable or disable an antivirus policy ............................................. 909
View antivirus policies .................................................................. 910
Managing antivirus scans............................................................................910
Scan a file...................................................................................... 910
Manually run an antivirus policy.....................................................910
Stop a running antivirus scan.........................................................910
Managing antivirus threats..........................................................................911
Manually quarantine a file .............................................................911
Remove a file from quarantine .......................................................911
View threats .................................................................................. 911
Antivirus threat information........................................................... 911
Managing antivirus reports..........................................................................912
Export an antivirus report............................................................... 912
View antivirus reports ....................................................................912
View antivirus events..................................................................... 913
Antivirus commands................................................................................... 913
isi avscan policy add......................................................................913
isi avscan policy edit......................................................................914
isi avscan policy delete.................................................................. 916
isi avscan policy.............................................................................916
isi avscan policy run.......................................................................916
isi avscan manual.......................................................................... 917
isi avscan quarantine..................................................................... 917
isi avscan unquarantine................................................................. 917
isi avscan report threat.................................................................. 918
isi avscan report scan.................................................................... 918
OneFS 7.2 CLI Administration Guide

25

CONTENTS

isi avscan report purge...................................................................919

isi avscan settings......................................................................... 920
isi avscan get................................................................................. 922

Chapter 25

VMware integration

923

VMware integration overview.......................................................................924

VAAI............................................................................................................ 924
VASA...........................................................................................................924
Isilon VASA alarms......................................................................... 924
VASA storage capabilities.............................................................. 925
Configuring VASA support........................................................................... 925
Enable VASA.................................................................................. 925
Download the Isilon vendor provider certificate..............................926
Add the Isilon vendor provider....................................................... 926
Disable or re-enable VASA...........................................................................927

26

OneFS 7.2 CLI Administration Guide

CHAPTER 1
Introduction to this guide

This section contains the following topics:

l
l
l

About this guide....................................................................................................28

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

Introduction to this guide

27

Introduction to this guide

About this guide

This guide describes how the Isilon OneFS command-line interface provides access to
cluster configuration, management, and monitoring functionality. This guide also lists
and describes all OneFS-specific commands that extend the standard UNIX command set.
We value your feedback. Please send any comments or suggestions about this guide to
docfeedback@[Link].

Isilon scale-out NAS overview

The EMC Isilon scale-out NAS storage platform combines modular hardware with unified
software to harness unstructured data. Powered by the distributed OneFS operating
system, an EMC Isilon cluster delivers a scalable pool of storage with a global
namespace.
The platform's unified software provides centralized web-based and command-line
administration to manage the following features:
l

A symmetrical cluster that runs a distributed file system

Scale-out nodes that add capacity and performance

Storage options that manage files, block data, and tiering

Flexible data protection and high availability

Software modules that control costs and optimize resources

Where to go for support

You can contact EMC Isilon Technical Support for any questions about EMC Isilon
products.
Online Support

Live Chat
Create a Service Request

Telephone Support

United States: 800-782-4362 (1-800-SVC-4EMC)

Canada: 800-543-4782
Worldwide: +1-508-497-7901
For local phone numbers in your country, see EMC Customer
Support Centers.

Help with online

support

28

OneFS 7.2 CLI Administration Guide

For questions specific to EMC Online Support registration or

access, email support@[Link].

CHAPTER 2
Isilon scale-out NAS

This section contains the following topics:

l
l
l
l
l
l
l
l
l

OneFS storage architecture................................................................................... 30

Isilon node components........................................................................................30
Internal and external networks.............................................................................. 31
Isilon cluster......................................................................................................... 31
The OneFS operating system................................................................................. 33
Structure of the file system....................................................................................35
Data protection overview.......................................................................................37
VMware integration............................................................................................... 39
Software modules................................................................................................. 40

Isilon scale-out NAS

29

Isilon scale-out NAS

OneFS storage architecture

EMC Isilon takes a scale-out approach to storage by creating a cluster of nodes that runs
a distributed file system. OneFS combines the three layers of storage architecturefile
system, volume manager, and data protectioninto a scale-out NAS cluster.
Each node adds resources to the cluster. Because each node contains globally coherent
RAM, as a cluster becomes larger, it becomes faster. Meanwhile, the file system expands
dynamically and redistributes content, which eliminates the work of partitioning disks
and creating volumes.
Nodes work as peers to spread data across the cluster. Segmenting and distributing data
a process known as stripingnot only protects data, but also enables a user
connecting to any node to take advantage of the entire cluster's performance.
OneFS uses distributed software to scale data across commodity hardware. Each node
helps control data requests, boosts performance, and expands the cluster's capacity. No
master device controls the cluster; no slaves invoke dependencies. Instead, each node
helps control data requests, boosts performance, and expands the cluster's capacity.

Isilon node components

As a rack-mountable appliance, a storage node includes the following components in a
2U or 4U rack-mountable chassis with an LCD front panel: memory, CPUs, RAM, NVRAM,
network interfaces, InfiniBand adapters, disk controllers, and storage media. An Isilon
cluster comprises three or more nodes, up to 144.
When you add a node to a cluster, you increase the cluster's aggregate disk, cache, CPU,
RAM, and network capacity. OneFS groups RAM into a single coherent cache so that a
data request on a node benefits from data that is cached anywhere. NVRAM is grouped to
write data with high throughput and to protect write operations from power failures. As
the cluster expands, spindles and CPU combine to increase throughput, capacity, and
inpu