0% found this document useful (0 votes)
4 views

onefs930cliref

The document is a command reference for PowerScale OneFS version 9.3.0.0, providing detailed information on various CLI commands and their usage. It includes chapters on command syntax, help resources, and a comprehensive list of commands organized alphabetically. Important notes, cautions, and warnings are also highlighted to ensure proper usage and prevent data loss or hardware damage.

Uploaded by

晨王
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
0% found this document useful (0 votes)
4 views

onefs930cliref

The document is a command reference for PowerScale OneFS version 9.3.0.0, providing detailed information on various CLI commands and their usage. It includes chapters on command syntax, help resources, and a comprehensive list of commands organized alphabetically. Important notes, cautions, and warnings are also highlighted to ensure proper usage and prevent data loss or hardware damage.

Uploaded by

晨王
Copyright
© © All Rights Reserved
We take content rights seriously. If you suspect this is your content, claim it here.
Available Formats
Download as PDF, TXT or read online on Scribd
You are on page 1/ 654

PowerScale OneFS

9.3.0.0 CLI Command Reference


9.3.0.0

November 2021
注意、小心和警告

注: “注意”表示帮助您更好地使用该产品的重要信息。

小心: “小心”表示可能会损坏硬件或导致数据丢失,并告诉您如何避免此类问题。

警告: “警告”表示可能会导致财产损失、人身伤害甚至死亡。

© 2010 - 2021 年 Dell Inc. 或其子公司。保留所有权利。Dell、EMC 和其他商标是 Dell Inc. 或其附属机构的商标。其他商标可能是其各自所有者


的商标。
Contents

Chapter 1: 本指南简介.................................................................................................................. 20
关于本指南..........................................................................................................................................................................20
语法图.................................................................................................................................................................................. 20
从何处获得帮助..................................................................................................................................................................21
用于获取帮助的其他选项...........................................................................................................................................21

Chapter 2: OneFS isi 命令 A 至 C..................................................................................................22


isi antivirus cava................................................................................................................................................................ 26
isi antivirus cava filters.....................................................................................................................................................26
isi antivirus cava filters list.............................................................................................................................................. 27
isi antivirus cava filters modify....................................................................................................................................... 27
isi antivirus cava filters view...........................................................................................................................................29
isi antivirus cava jobs........................................................................................................................................................29
isi antivirus cava jobs create...........................................................................................................................................29
isi antivirus cava jobs delete........................................................................................................................................... 30
isi antivirus cava jobs list.................................................................................................................................................. 31
isi antivirus cava jobs modify.......................................................................................................................................... 32
isi antivirus cava jobs start..............................................................................................................................................33
isi antivirus cava jobs view.............................................................................................................................................. 34
isi antivirus cava servers..................................................................................................................................................34
isi antivirus cava servers create.................................................................................................................................... 34
isi antivirus cava servers delete.....................................................................................................................................35
isi antivirus cava servers list........................................................................................................................................... 35
isi antivirus cava servers modify....................................................................................................................................36
isi antivirus cava servers view........................................................................................................................................ 37
isi antivirus cava settings.................................................................................................................................................37
isi antivirus cava settings modify...................................................................................................................................37
isi antivirus cava settings view.......................................................................................................................................39
isi antivirus cava status....................................................................................................................................................39
isi antivirus icap policies create......................................................................................................................................39
isi antivirus icap policies delete.......................................................................................................................................41
isi antivirus icap policies list............................................................................................................................................. 41
isi antivirus policies modify..............................................................................................................................................42
isi antivirus icap policies start.........................................................................................................................................44
isi antivirus icap policies view......................................................................................................................................... 44
isi antivirus icap settings modify....................................................................................................................................45
isi antivirus icap settings view........................................................................................................................................ 47
isi antivirus icap servers create......................................................................................................................................47
isi antivirus icap servers delete...................................................................................................................................... 48
isi antivirus icap servers list............................................................................................................................................ 48
isi antivirus icap servers view......................................................................................................................................... 49
isi antivirus icap servers modify.....................................................................................................................................49
isi antivirus quarantine..................................................................................................................................................... 50
isi antivirus release............................................................................................................................................................50

Contents 3
isi antivirus reports delete...............................................................................................................................................50
isi antivirus reports scans list.......................................................................................................................................... 51
isi antivirus reports scans view...................................................................................................................................... 52
isi antivirus reports threats list...................................................................................................................................... 53
isi antivirus reports threats view................................................................................................................................... 54
isi antivirus scan................................................................................................................................................................ 54
isi antivirus status..............................................................................................................................................................54
isi audit progress global view..........................................................................................................................................55
isi audit progress view......................................................................................................................................................55
isi audit settings global modify.......................................................................................................................................56
isi audit settings global view...........................................................................................................................................58
isi audit settings modify................................................................................................................................................... 58
isi audit settings view....................................................................................................................................................... 60
isi audit topics list...............................................................................................................................................................61
isi audit topics modify....................................................................................................................................................... 61
isi audit topics view...........................................................................................................................................................62
isi auth access.................................................................................................................................................................... 62
isi auth ads create............................................................................................................................................................. 63
isi auth ads delete............................................................................................................................................................. 66
isi auth ads list....................................................................................................................................................................66
isi auth ads modify.............................................................................................................................................................67
isi auth ads spn check....................................................................................................................................................... 71
isi auth ads spn create...................................................................................................................................................... 71
isi auth ads spn delete.......................................................................................................................................................71
isi auth ads spn fix.............................................................................................................................................................72
isi auth ads spn list............................................................................................................................................................ 72
isi auth ads trusts controllers list...................................................................................................................................73
isi auth ads trusts list........................................................................................................................................................74
isi auth ads view.................................................................................................................................................................74
isi auth duo modify............................................................................................................................................................ 74
isi auth error........................................................................................................................................................................75
isi auth file create.............................................................................................................................................................. 76
isi auth file delete...............................................................................................................................................................78
isi auth file list.....................................................................................................................................................................79
isi auth file modify............................................................................................................................................................. 79
isi auth file view................................................................................................................................................................. 84
isi auth groups create.......................................................................................................................................................85
isi auth groups delete....................................................................................................................................................... 86
isi auth groups flush..........................................................................................................................................................86
isi auth groups list..............................................................................................................................................................87
isi auth groups members list........................................................................................................................................... 87
isi auth groups modify...................................................................................................................................................... 88
isi auth groups view.......................................................................................................................................................... 90
isi auth id............................................................................................................................................................................. 90
isi auth krb5 create............................................................................................................................................................91
isi auth krb5 delete........................................................................................................................................................... 92
isi auth krb5 domain create............................................................................................................................................ 92
isi auth krb5 domain delete............................................................................................................................................. 92
isi auth krb5 domain list................................................................................................................................................... 93
isi auth krb5 domain modify............................................................................................................................................93

4 Contents
isi auth krb5 domain view................................................................................................................................................93
isi auth krb5 list..................................................................................................................................................................94
isi auth krb5 realm create................................................................................................................................................94
isi auth krb5 realm delete................................................................................................................................................ 95
isi auth krb5 realm list...................................................................................................................................................... 95
isi auth krb5 realm modify............................................................................................................................................... 96
isi auth krb5 realm view................................................................................................................................................... 96
isi auth krb5 spn check.................................................................................................................................................... 96
isi auth krb5 spn create................................................................................................................................................... 97
isi auth krb5 spn delete....................................................................................................................................................97
isi auth krb5 spn fix...........................................................................................................................................................98
isi auth krb5 spn import................................................................................................................................................... 98
isi auth krb5 spn list..........................................................................................................................................................98
isi auth krb5 view.............................................................................................................................................................. 99
isi auth ldap create............................................................................................................................................................99
isi auth ldap delete.......................................................................................................................................................... 105
isi auth ldap list.................................................................................................................................................................105
isi auth ldap modify......................................................................................................................................................... 106
isi auth ldap view.............................................................................................................................................................. 113
isi auth local list.................................................................................................................................................................114
isi auth local modify..........................................................................................................................................................114
isi auth local view..............................................................................................................................................................116
isi auth log-level modify.................................................................................................................................................. 116
isi auth log-level view...................................................................................................................................................... 116
isi auth mapping create................................................................................................................................................... 117
isi auth mapping delete................................................................................................................................................... 118
isi auth mapping dump.................................................................................................................................................... 119
isi auth mapping flush......................................................................................................................................................119
isi auth mapping import.................................................................................................................................................. 120
isi auth mapping list.........................................................................................................................................................120
isi auth mapping modify.................................................................................................................................................. 121
isi auth mapping token.................................................................................................................................................... 121
isi auth mapping view......................................................................................................................................................122
isi auth netgroups view.................................................................................................................................................. 123
isi auth nis create.............................................................................................................................................................123
isi auth nis delete............................................................................................................................................................. 126
isi auth nis list................................................................................................................................................................... 126
isi auth nis modify............................................................................................................................................................ 127
isi auth nis view.................................................................................................................................................................131
isi auth privileges.............................................................................................................................................................. 131
isi auth refresh..................................................................................................................................................................132
isi auth roles create......................................................................................................................................................... 132
isi auth roles delete..........................................................................................................................................................132
isi auth roles list................................................................................................................................................................133
isi auth roles members list............................................................................................................................................. 134
isi auth roles modify........................................................................................................................................................ 135
isi auth roles privileges list.............................................................................................................................................136
isi auth roles view.............................................................................................................................................................137
isi auth settings acls modify.......................................................................................................................................... 137
isi auth settings acls view.............................................................................................................................................. 140

Contents 5
isi auth settings global modify....................................................................................................................................... 141
isi auth settings global view.......................................................................................................................................... 142
isi auth settings krb5 modify.........................................................................................................................................143
isi auth settings krb5 view.............................................................................................................................................144
isi auth settings mapping modify................................................................................................................................. 144
isi auth settings mapping view..................................................................................................................................... 145
isi auth status................................................................................................................................................................... 145
isi auth users create........................................................................................................................................................ 146
isi auth users delete.........................................................................................................................................................147
isi auth users flush........................................................................................................................................................... 148
isi auth users list...............................................................................................................................................................148
isi auth users modify....................................................................................................................................................... 149
isi auth users view............................................................................................................................................................ 151
isi batterystatus list.........................................................................................................................................................152
isi batterystatus view......................................................................................................................................................152
isi certificate authority delete.......................................................................................................................................152
isi certificate authority import...................................................................................................................................... 153
isi certificate authority list............................................................................................................................................. 153
isi certificate authority modify......................................................................................................................................154
isi certificate authority view..........................................................................................................................................154
isi certificate server delete............................................................................................................................................155
isi certificate server import........................................................................................................................................... 155
isi certificate server list..................................................................................................................................................156
isi certificate server modify...........................................................................................................................................156
isi certificate server view...............................................................................................................................................157
isi certificate settings modify........................................................................................................................................157
isi certificate settings view........................................................................................................................................... 158
isi cloud access add.........................................................................................................................................................158
isi cloud access list.......................................................................................................................................................... 159
isi cloud access remove................................................................................................................................................. 159
isi cloud access view.......................................................................................................................................................160
isi cloud accounts create............................................................................................................................................... 160
isi cloud accounts delete................................................................................................................................................162
isi cloud accounts list......................................................................................................................................................163
isi cloud accounts modify...............................................................................................................................................163
isi cloud accounts view.................................................................................................................................................. 165
isi cloud archive................................................................................................................................................................165
isi cloud jobs cancel.........................................................................................................................................................166
isi cloud jobs create.........................................................................................................................................................166
isi cloud jobs files list.......................................................................................................................................................167
isi cloud jobs list............................................................................................................................................................... 168
isi cloud jobs pause..........................................................................................................................................................169
isi cloud jobs resume....................................................................................................................................................... 170
isi cloud jobs view............................................................................................................................................................ 170
isi cloud pools create....................................................................................................................................................... 171
isi cloud pools delete....................................................................................................................................................... 172
isi cloud pools list............................................................................................................................................................. 172
isi cloud pools modify...................................................................................................................................................... 173
isi cloud pools view.......................................................................................................................................................... 174
isi cloud proxies create................................................................................................................................................... 174

6 Contents
isi cloud proxies delete....................................................................................................................................................175
isi cloud proxies list..........................................................................................................................................................176
isi cloud proxies modify.................................................................................................................................................. 176
isi cloud proxies view.......................................................................................................................................................177
isi cloud recall....................................................................................................................................................................178
isi cloud restore_coi........................................................................................................................................................ 179
isi cloud settings modify.................................................................................................................................................179
isi cloud settings regenerate-enc ryption-key........................................................................................................... 181
isi cloud settings view..................................................................................................................................................... 181
isi cluster atime modify...................................................................................................................................................182
isi cluster atime view.......................................................................................................................................................182
isi cluster config............................................................................................................................................................... 182
isi cluster config exports................................................................................................................................................183
isi cluster config exports create...................................................................................................................................183
isi cluster config exports list......................................................................................................................................... 183
isi cluster config exports view...................................................................................................................................... 184
isi cluster config imports................................................................................................................................................184
isi cluster config imports create...................................................................................................................................185
isi cluster config imports list......................................................................................................................................... 185
isi cluster config imports view...................................................................................................................................... 186
isi cluster contact modify.............................................................................................................................................. 186
isi cluster contact view...................................................................................................................................................187
isi cluster encoding list................................................................................................................................................... 187
isi cluster encoding modify............................................................................................................................................ 188
isi cluster encoding view................................................................................................................................................ 188
isi cluster identity modify............................................................................................................................................... 188
isi cluster identity view................................................................................................................................................... 189
isi cluster internal-networks modify............................................................................................................................ 189
isi cluster internal-networks view................................................................................................................................ 190
isi cluster join-mode modify.......................................................................................................................................... 190
isi cluster join-mode view.............................................................................................................................................. 190
isi cluster lnnset modify.................................................................................................................................................. 191
isi cluster lnnset view...................................................................................................................................................... 191
isi cluster reboot............................................................................................................................................................... 191
isi cluster shutdown........................................................................................................................................................ 192
isi cluster time modify.....................................................................................................................................................192
isi cluster time view.........................................................................................................................................................192
isi cluster time timezone modify.................................................................................................................................. 193
isi cluster time timezone view...................................................................................................................................... 193
isi compression stats list................................................................................................................................................ 193
isi compression stats view.............................................................................................................................................194
isi compression settings modify................................................................................................................................... 195
isi compression settings view....................................................................................................................................... 195
isi config.............................................................................................................................................................................195

Chapter 3: OneFS isi 命令 D 至 L.................................................................................................199


isi dedupe inline settings modify..................................................................................................................................202
isi dedupe inline settings view......................................................................................................................................203
isi dedupe reports list.....................................................................................................................................................203
isi dedupe reports view ................................................................................................................................................ 204

Contents 7
isi dedupe settings modify............................................................................................................................................ 204
isi dedupe settings view................................................................................................................................................ 205
isi dedupe stats............................................................................................................................................................... 206
isi devices add..................................................................................................................................................................206
isi devices config modify............................................................................................................................................... 207
isi devices config view................................................................................................................................................... 208
isi devices drive add....................................................................................................................................................... 208
isi devices drive firmware list....................................................................................................................................... 208
isi devices drive firmware update list.........................................................................................................................209
isi devices drive firmware update start...................................................................................................................... 210
isi devices drive firmware update view...................................................................................................................... 210
isi devices drive firmware view.................................................................................................................................... 210
isi devices format..............................................................................................................................................................211
isi devices list.....................................................................................................................................................................211
isi devices node add........................................................................................................................................................ 212
isi devices node list..........................................................................................................................................................212
isi devices node smartfail............................................................................................................................................... 213
isi devices node stopfail................................................................................................................................................. 213
isi devices purpose.......................................................................................................................................................... 214
isi devices purposelist..................................................................................................................................................... 214
isi devices smartfail......................................................................................................................................................... 215
isi devices stopfail............................................................................................................................................................215
isi devices suspend.......................................................................................................................................................... 216
isi devices view.................................................................................................................................................................216
isi diagnostics gather settings modify.........................................................................................................................217
isi diagnostics gather settings view............................................................................................................................ 218
isi diagnostics gather start............................................................................................................................................ 218
isi diagnostics gather status..........................................................................................................................................219
isi diagnostics gather stop............................................................................................................................................ 220
isi diagnostics netlogger settings modify.................................................................................................................. 220
isi diagnostics netlogger settings view....................................................................................................................... 221
isi diagnostics netlogger start.......................................................................................................................................221
isi diagnostics netlogger status................................................................................................................................... 222
isi diagnostics netlogger stop.......................................................................................................................................222
isi email settings modify................................................................................................................................................ 222
isi email settings view.................................................................................................................................................... 223
isi esrs modify.................................................................................................................................................................. 224
isi esrs view...................................................................................................................................................................... 225
isi esrs dataitems list...................................................................................................................................................... 226
isi esrs dataitems modify...............................................................................................................................................226
isi esrs download list.......................................................................................................................................................227
isi esrs download start................................................................................................................................................... 227
isi esrs download view................................................................................................................................................... 228
isi esrs telemetry modify............................................................................................................................................... 228
isi esrs telemetry view................................................................................................................................................... 228
isi event alerts create.....................................................................................................................................................229
isi event alerts delete..................................................................................................................................................... 230
isi event alerts list........................................................................................................................................................... 230
isi event alerts modify.....................................................................................................................................................231
isi event alerts view........................................................................................................................................................ 233

8 Contents
isi event channels create...............................................................................................................................................234
isi event channels delete............................................................................................................................................... 236
isi event channels list..................................................................................................................................................... 236
isi event channels modify.............................................................................................................................................. 237
isi event channels view..................................................................................................................................................239
isi event events list.........................................................................................................................................................239
isi event events view......................................................................................................................................................240
isi event groups bulk...................................................................................................................................................... 240
isi event groups list..........................................................................................................................................................241
isi event groups modify..................................................................................................................................................242
isi event groups view......................................................................................................................................................242
isi event maintenance list..............................................................................................................................................243
isi event maintenance modify.......................................................................................................................................243
isi event maintenance view...........................................................................................................................................244
isi event settings modify............................................................................................................................................... 244
isi event settings view................................................................................................................................................... 245
isi event test create....................................................................................................................................................... 245
isi event thresholds list.................................................................................................................................................. 245
isi event thresholds modify...........................................................................................................................................246
isi event thresholds reset.............................................................................................................................................. 247
isi event thresholds view...............................................................................................................................................248
isi event types list........................................................................................................................................................... 248
isi fc settings list............................................................................................................................................................. 249
isi fc settings modify...................................................................................................................................................... 249
isi fc settings view.......................................................................................................................................................... 250
isi file-filter settings modify..........................................................................................................................................250
isi file-filter settings view...............................................................................................................................................251
isi filepool apply............................................................................................................................................................... 252
isi filepool default-policy modify.................................................................................................................................. 254
isi filepool default-policy view......................................................................................................................................256
isi filepool policies create.............................................................................................................................................. 256
isi filepool policies delete...............................................................................................................................................260
isi filepool policies list..................................................................................................................................................... 260
isi filepool policies modify...............................................................................................................................................261
isi filepool policies view..................................................................................................................................................265
isi filepool templates list................................................................................................................................................ 266
isi filepool templates view............................................................................................................................................. 267
isi_for_array..................................................................................................................................................................... 267
isi ftp settings modify.................................................................................................................................................... 268
isi ftp settings view.........................................................................................................................................................273
isi_gather_info................................................................................................................................................................. 274
isi get..................................................................................................................................................................................278
isi hardening apply...........................................................................................................................................................279
isi hardening revert.........................................................................................................................................................280
isi hardening status.........................................................................................................................................................280
isi hdfs crypto encryption-zones create................................................................................................................... 280
isi hdfs crypto settings modify..................................................................................................................................... 281
isi hdfs crypto encryption-zones list........................................................................................................................... 281
isi hdfs crypto settings view......................................................................................................................................... 281
isi hdfs fsimage job settings modify........................................................................................................................... 282

Contents 9
isi hdfs fsimage job settings view............................................................................................................................... 282
isi hdfs fsimage job view............................................................................................................................................... 283
isi hdfs fsimage latest delete........................................................................................................................................283
isi hdfs fsimage latest view.......................................................................................................................................... 283
isi hdfs fsimage settings modify.................................................................................................................................. 284
isi hdfs fsimage settings view...................................................................................................................................... 284
isi hdfs inotify settings modify.....................................................................................................................................285
isi hdfs inotify settings view.........................................................................................................................................285
isi hdfs inotify stream reset..........................................................................................................................................286
isi hdfs inotify stream view...........................................................................................................................................286
isi hdfs log-level modify.................................................................................................................................................286
isi hdfs log-level view..................................................................................................................................................... 287
isi hdfs proxyusers create............................................................................................................................................. 287
isi hdfs proxyusers delete............................................................................................................................................. 288
isi hdfs proxyusers list....................................................................................................................................................289
isi hdfs proxyusers members list................................................................................................................................. 290
isi hdfs proxyusers modify............................................................................................................................................. 291
isi hdfs proxyusers view................................................................................................................................................ 292
isi hdfs racks create....................................................................................................................................................... 293
isi hdfs racks delete........................................................................................................................................................293
isi hdfs racks list..............................................................................................................................................................294
isi hdfs racks modify.......................................................................................................................................................294
isi hdfs racks view...........................................................................................................................................................295
isi hdfs ranger-plugin settings modify........................................................................................................................295
isi hdfs ranger-plugin settings view............................................................................................................................296
isi hdfs settings modify..................................................................................................................................................296
isi hdfs settings view......................................................................................................................................................298
isi http settings modify.................................................................................................................................................. 298
isi http settings view...................................................................................................................................................... 299
isi ipmi features list......................................................................................................................................................... 299
isi ipmi features modify..................................................................................................................................................300
isi ipmi features view......................................................................................................................................................300
isi ipmi network modify...................................................................................................................................................301
isi ipmi network view...................................................................................................................................................... 302
isi ipmi nodes list............................................................................................................................................................. 302
isi ipmi nodes view.......................................................................................................................................................... 303
isi ipmi settings modify.................................................................................................................................................. 303
isi ipmi settings view...................................................................................................................................................... 304
isi ipmi user modify......................................................................................................................................................... 304
isi ipmi user view............................................................................................................................................................. 305
isi 作业事件列表..............................................................................................................................................................305
isi job jobs cancel.............................................................................................................................................................307
isi job jobs list................................................................................................................................................................... 307
isi job jobs modify............................................................................................................................................................308
isi job jobs pause............................................................................................................................................................. 309
isi job jobs resume............................................................................................................................................................310
isi job jobs start................................................................................................................................................................ 310
isi job jobs view.................................................................................................................................................................312
isi job policies create....................................................................................................................................................... 313
isi job policies delete........................................................................................................................................................313

10 Contents
isi job policies list..............................................................................................................................................................314
isi job policies modify...................................................................................................................................................... 315
isi job policies view.......................................................................................................................................................... 316
isi job reports list.............................................................................................................................................................. 317
isi job reports view...........................................................................................................................................................318
isi job statistics view....................................................................................................................................................... 318
isi job status...................................................................................................................................................................... 319
isi job types list................................................................................................................................................................ 320
isi job types modify.......................................................................................................................................................... 321
isi job types view............................................................................................................................................................. 322
isi keymanager kmip servers create............................................................................................................................323
isi keymanager kmip servers delete............................................................................................................................ 324
isi keymanager kmip servers modify...........................................................................................................................324
isi keymanager kmip servers list.................................................................................................................................. 325
isi keymanager kmip servers view...............................................................................................................................326
isi keymanager sed migrate local.................................................................................................................................326
isi keymanager sed migrate retry................................................................................................................................ 326
isi keymanager sed migrate server..............................................................................................................................327
isi keymanager sed settings modify............................................................................................................................ 327
isi keymanager sed settings view................................................................................................................................328
isi keymanager sed status............................................................................................................................................. 328
isi license activation start..............................................................................................................................................329
isi license activation view..............................................................................................................................................329
isi license add................................................................................................................................................................... 330
isi license generate......................................................................................................................................................... 330
isi license list..................................................................................................................................................................... 331
isi license view.................................................................................................................................................................. 331
isi keymanager sed migrate local.................................................................................................................................332

Chapter 4: OneFS isi 命令 N 到 R................................................................................................333


isi namelength.................................................................................................................................................................. 336
isi namelength create..................................................................................................................................................... 336
isi namelength delete......................................................................................................................................................337
isi namelength list............................................................................................................................................................337
isi namelength modify.................................................................................................................................................... 338
isi namelength view........................................................................................................................................................ 338
isi ndmp contexts delete............................................................................................................................................... 339
isi ndmp contexts list..................................................................................................................................................... 339
isi ndmp contexts view.................................................................................................................................................. 339
isi ndmp dumpdates delete........................................................................................................................................... 340
isi ndmp dumpdates list................................................................................................................................................. 340
isi ndmp sessions delete.................................................................................................................................................341
isi ndmp sessions list...................................................................................................................................................... 342
isi ndmp sessions view................................................................................................................................................... 343
isi ndmp settings diagnostics modify..........................................................................................................................343
isi ndmp settings diagnostics view..............................................................................................................................344
isi ndmp settings global modify....................................................................................................................................344
isi ndmp settings global view....................................................................................................................................... 345
isi ndmp settings preferred-ips create.......................................................................................................................345
isi ndmp settings preferred-ips delete....................................................................................................................... 346

Contents 11
isi ndmp settings preferred-ips list............................................................................................................................. 346
isi ndmp settings preferred-ips modify...................................................................................................................... 347
isi ndmp settings preferred-ips view.......................................................................................................................... 347
isi ndmp settings variables create...............................................................................................................................348
isi ndmp settings variables delete............................................................................................................................... 348
isi ndmp settings variables list..................................................................................................................................... 349
isi ndmp settings variables modify..............................................................................................................................350
isi ndmp users create..................................................................................................................................................... 350
isi ndmp users delete...................................................................................................................................................... 351
isi ndmp users list............................................................................................................................................................ 351
isi ndmp users modify.................................................................................................................................................... 352
isi ndmp users view........................................................................................................................................................ 352
isi network dnscache flush........................................................................................................................................... 352
isi network dnscache modify........................................................................................................................................353
isi network dnscache view............................................................................................................................................355
isi network external modify.......................................................................................................................................... 355
isi network external view.............................................................................................................................................. 356
isi network groupnets create....................................................................................................................................... 356
isi network groupnets delete........................................................................................................................................357
isi network groupnets list.............................................................................................................................................. 357
isi network groupnets modify.......................................................................................................................................358
isi network groupnets view...........................................................................................................................................359
isi network interfaces list.............................................................................................................................................. 360
isi network pools create................................................................................................................................................. 361
isi network pools delete.................................................................................................................................................364
isi network pools list....................................................................................................................................................... 364
isi network pools modify................................................................................................................................................365
isi network pools rebalance-ips................................................................................................................................... 369
isi network pools sc-resume-nodes............................................................................................................................ 370
isi network pools sc-suspend-nodes.......................................................................................................................... 370
isi network pools view.....................................................................................................................................................371
isi network rules create.................................................................................................................................................. 371
isi network rules delete.................................................................................................................................................. 372
isi network rules list........................................................................................................................................................ 372
isi network rules modify.................................................................................................................................................373
isi network rules view.....................................................................................................................................................374
isi network sc-rebalance-all.......................................................................................................................................... 374
isi network subnets create............................................................................................................................................375
isi network subnets delete............................................................................................................................................ 376
isi network subnets list...................................................................................................................................................377
isi network subnets modify........................................................................................................................................... 378
isi network subnets view...............................................................................................................................................380
isi nfs aliases create....................................................................................................................................................... 380
isi nfs aliases delete.........................................................................................................................................................381
isi nfs aliases list...............................................................................................................................................................381
isi nfs aliases modify.......................................................................................................................................................382
isi nfs aliases view...........................................................................................................................................................383
isi nfs exports check...................................................................................................................................................... 384
isi nfs exports create..................................................................................................................................................... 385
isi nfs exports delete...................................................................................................................................................... 390

12 Contents
isi nfs exports list.............................................................................................................................................................391
isi nfs exports modify..................................................................................................................................................... 393
isi nfs exports reload.......................................................................................................................................................401
isi nfs exports view.........................................................................................................................................................402
isi nfs log-level modify................................................................................................................................................... 402
isi nfs log-level view....................................................................................................................................................... 403
isi nfs netgroup check....................................................................................................................................................403
isi nfs netgroup flush......................................................................................................................................................403
isi nfs netgroup modify.................................................................................................................................................. 404
isi nfs nlm locks list......................................................................................................................................................... 404
isi nfs nlm locks waiters.................................................................................................................................................405
isi nfs nlm sessions check............................................................................................................................................. 406
isi nfs nlm sessions delete.............................................................................................................................................406
isi nfs nlm sessions list................................................................................................................................................... 407
isi nfs nlm sessions refresh...........................................................................................................................................408
isi nfs nlm sessions view................................................................................................................................................408
isi nfs settings export modify.......................................................................................................................................409
isi nfs settings export view............................................................................................................................................416
isi nfs settings global modify......................................................................................................................................... 417
isi nfs settings global view.............................................................................................................................................418
isi nfs settings zone modify...........................................................................................................................................418
isi nfs settings zone view...............................................................................................................................................419
isi ntp servers create..................................................................................................................................................... 420
isi ntp servers delete...................................................................................................................................................... 420
isi ntp servers list............................................................................................................................................................. 421
isi ntp servers modify......................................................................................................................................................421
isi ntp servers view......................................................................................................................................................... 422
isi ntp settings modify....................................................................................................................................................422
isi ntp settings view........................................................................................................................................................423
isi performance datasets create..................................................................................................................................423
isi performance datasets delete.................................................................................................................................. 424
isi performance datasets list........................................................................................................................................ 424
isi peformance datasets modify...................................................................................................................................425
isi performance datasets view..................................................................................................................................... 425
isi performance filters apply......................................................................................................................................... 425
isi performance filters list..............................................................................................................................................426
isi performance filters modify...................................................................................................................................... 426
isi performance filters remove..................................................................................................................................... 427
isi performance filters view...........................................................................................................................................427
isi performance metrics list...........................................................................................................................................427
isi performance metrics view....................................................................................................................................... 428
isi performance settings modify.................................................................................................................................. 428
isi performance settings view...................................................................................................................................... 429
isi performance workloads list......................................................................................................................................429
isi performance workloads modify.............................................................................................................................. 430
isi performance workloads pin..................................................................................................................................... 430
isi performance workloads unpin.................................................................................................................................430
isi performance workloads view................................................................................................................................... 431
isi quota quotas create................................................................................................................................................... 431
isi quota quotas delete...................................................................................................................................................433

Contents 13
isi quota quotas list.........................................................................................................................................................435
isi quota quotas modify..................................................................................................................................................436
isi quota quotas notifications clear............................................................................................................................. 439
isi quota quotas notifications create.......................................................................................................................... 440
isi quota quotas notifications delete...........................................................................................................................442
isi quota quotas notifications disable......................................................................................................................... 443
isi quota quotas notifications list.................................................................................................................................444
isi quota quotas notifications modify......................................................................................................................... 446
isi quota quotas notifications view............................................................................................................................. 448
isi quota quotas view..................................................................................................................................................... 450
isi quota reports create.................................................................................................................................................. 451
isi quota reports delete.................................................................................................................................................. 451
isi quota reports list........................................................................................................................................................452
isi quota settings mappings create............................................................................................................................. 453
isi quota settings mappings delete............................................................................................................................. 453
isi quota settings mappings list....................................................................................................................................454
isi quota settings mappings modify............................................................................................................................ 454
isi quota settings mappings view................................................................................................................................ 455
isi quota settings notifications clear...........................................................................................................................455
isi quota settings notifications create........................................................................................................................455
isi quota settings notifications delete........................................................................................................................ 457
isi quota settings notifications list.............................................................................................................................. 458
isi quota settings notifications modify....................................................................................................................... 458
isi quota settings notifications view........................................................................................................................... 460
isi quota settings reports modify................................................................................................................................. 461
isi quota settings reports view.....................................................................................................................................462
isi readonly list................................................................................................................................................................. 463
isi readonly modify.......................................................................................................................................................... 463
isi readonly view.............................................................................................................................................................. 464

Chapter 5: OneFS isi 命令 S 至 Z................................................................................................ 465


isi s3 buckets create...................................................................................................................................................... 469
isi s3 buckets delete....................................................................................................................................................... 470
isi s3 buckets list............................................................................................................................................................. 470
isi s3 buckets modify.......................................................................................................................................................471
isi s3 buckets view.......................................................................................................................................................... 472
isi services s3 disable..................................................................................................................................................... 472
isi services s3 enable...................................................................................................................................................... 472
isi s3 keys create............................................................................................................................................................. 472
isi s3 keys delete..............................................................................................................................................................473
isi s3 log-level...................................................................................................................................................................473
isi s3 log-level modify..................................................................................................................................................... 474
isi s3 log-level view......................................................................................................................................................... 474
isi s3 mykeys create........................................................................................................................................................474
isi s3 mykeys delete........................................................................................................................................................475
isi s3 mykeys view...........................................................................................................................................................475
isi s3 settings global modify..........................................................................................................................................476
isi s3 settings global view..............................................................................................................................................476
isi s3 settings zone modify............................................................................................................................................476
isi s3 settings zone view................................................................................................................................................477

14 Contents
isi servicelight list............................................................................................................................................................ 477
isi servicelight modify.....................................................................................................................................................478
isi servicelight view.........................................................................................................................................................478
isi services.........................................................................................................................................................................479
isi set.................................................................................................................................................................................. 479
isi smb log-level filters create...................................................................................................................................... 482
isi smb log-level filters delete.......................................................................................................................................483
isi smb log-level filters list.............................................................................................................................................483
isi smb log-level filters view..........................................................................................................................................484
isi smb log-level modify................................................................................................................................................. 484
isi smb log-level view..................................................................................................................................................... 485
isi smb openfiles close................................................................................................................................................... 485
isi smb openfiles list........................................................................................................................................................486
isi smb sessions delete...................................................................................................................................................486
isi smb sessions delete-user......................................................................................................................................... 487
isi smb sessions list.........................................................................................................................................................488
isi smb settings global modify...................................................................................................................................... 488
isi smb settings global view.......................................................................................................................................... 490
isi smb settings shares modify......................................................................................................................................491
isi smb settings shares view.........................................................................................................................................495
isi smb settings zone modify........................................................................................................................................ 495
isi smb settings zone view............................................................................................................................................ 496
isi smb shares create......................................................................................................................................................497
isi smb shares delete...................................................................................................................................................... 499
isi smb shares list............................................................................................................................................................ 500
isi smb shares modify......................................................................................................................................................501
isi smb shares permission create................................................................................................................................ 506
isi smb shares permission delete................................................................................................................................. 507
isi smb shares permission list....................................................................................................................................... 507
isi smb shares permission modify................................................................................................................................508
isi smb shares permission view....................................................................................................................................509
isi smb shares view..........................................................................................................................................................510
isi snapshot aliases create............................................................................................................................................. 510
isi snapshot aliases delete............................................................................................................................................. 510
isi snapshot aliases list.................................................................................................................................................... 511
isi snapshot aliases modify............................................................................................................................................ 512
isi snapshot aliases view................................................................................................................................................ 512
isi snapshot locks create................................................................................................................................................512
isi snapshot locks delete................................................................................................................................................ 513
isi snapshot locks list...................................................................................................................................................... 514
isi snapshot locks modify............................................................................................................................................... 515
isi snapshot locks view................................................................................................................................................... 516
isi snapshot schedules create.......................................................................................................................................516
isi snapshot schedules delete....................................................................................................................................... 518
isi snapshot schedules list............................................................................................................................................. 518
isi snapshot schedules modify...................................................................................................................................... 519
isi snapshot schedules pending list..............................................................................................................................521
isi snapshot schedules view.......................................................................................................................................... 521
isi snapshot settings modify......................................................................................................................................... 522
isi snapshot settings view............................................................................................................................................. 523

Contents 15
isi snapshot snapshots create......................................................................................................................................523
isi snapshot snapshots delete...................................................................................................................................... 524
isi snapshot snapshots list............................................................................................................................................ 525
isi snapshot snapshots modify.....................................................................................................................................526
isi snapshot snapshots view......................................................................................................................................... 527
isi snapshot writable create..........................................................................................................................................527
isi snapshot writable delete.......................................................................................................................................... 528
isi snapshot writable list................................................................................................................................................ 528
isi snapshot writable view............................................................................................................................................. 529
isi snmp settings modify................................................................................................................................................530
isi snmp settings view.....................................................................................................................................................531
isi ssh settings modify....................................................................................................................................................532
isi statistics client............................................................................................................................................................533
isi statistics data-reduction.......................................................................................................................................... 537
isi statistics data-reduction view................................................................................................................................ 537
isi statistics drive............................................................................................................................................................ 538
isi statistics heat............................................................................................................................................................. 539
isi statistics list keys.......................................................................................................................................................542
isi statistics list operations............................................................................................................................................542
isi statistics protocol...................................................................................................................................................... 543
isi statistics pstat............................................................................................................................................................ 547
isi statistics query current............................................................................................................................................ 548
isi statistics query history............................................................................................................................................. 549
isi status............................................................................................................................................................................ 550
isi storagepool health......................................................................................................................................................551
isi storagepool list............................................................................................................................................................ 551
isi storagepool nodepools create.................................................................................................................................552
isi storagepool nodepools delete................................................................................................................................. 552
isi storagepool nodepools list....................................................................................................................................... 553
isi storagepool nodepools modify................................................................................................................................553
isi storagepool nodepools view....................................................................................................................................555
isi storagepool nodetypes list.......................................................................................................................................555
isi storagepool settings modify....................................................................................................................................556
isi storagepool settings view........................................................................................................................................ 557
isi storagepool tiers create........................................................................................................................................... 558
isi storagepool tiers delete............................................................................................................................................559
isi storagepool tiers list..................................................................................................................................................559
isi storagepool tiers modify.......................................................................................................................................... 560
isi storagepool tiers view.............................................................................................................................................. 560
isi storagepool unprovisioned view..............................................................................................................................561
isi swift accounts create................................................................................................................................................561
isi swift accounts delete................................................................................................................................................562
isi swift accounts list......................................................................................................................................................562
isi swift accounts modify.............................................................................................................................................. 563
isi swift accounts view.................................................................................................................................................. 564
isi sync certificates peer delete...................................................................................................................................564
isi sync certificates peer import.................................................................................................................................. 565
isi sync certificates peer list.........................................................................................................................................565
isi sync certificates peer modify................................................................................................................................. 566
isi sync certificates peer view..................................................................................................................................... 566

16 Contents
isi sync certificates server delete............................................................................................................................... 567
isi sync certificates server import...............................................................................................................................567
isi sync certificates server list..................................................................................................................................... 568
isi sync certificates server modify.............................................................................................................................. 568
isi sync certificates server view.................................................................................................................................. 569
isi sync jobs cancel......................................................................................................................................................... 569
isi sync jobs list................................................................................................................................................................ 570
isi sync jobs pause.......................................................................................................................................................... 570
isi sync jobs reports list.................................................................................................................................................. 571
isi sync jobs reports view............................................................................................................................................... 571
isi sync jobs resume........................................................................................................................................................ 572
isi sync jobs start.............................................................................................................................................................572
isi sync jobs view.............................................................................................................................................................573
isi sync policies create................................................................................................................................................... 573
isi sync policies delete....................................................................................................................................................579
isi sync policies disable...................................................................................................................................................579
isi sync policies enable................................................................................................................................................... 580
isi sync policies list..........................................................................................................................................................580
isi sync policies modify...................................................................................................................................................582
isi sync policies reset..................................................................................................................................................... 589
isi sync policies resolve..................................................................................................................................................590
isi sync policies view...................................................................................................................................................... 590
isi sync recovery allow-write........................................................................................................................................590
isi sync recovery resync-prep.......................................................................................................................................591
isi sync reports list...........................................................................................................................................................591
isi sync reports rotate....................................................................................................................................................593
isi sync reports subreports list.....................................................................................................................................593
isi sync reports subreports view................................................................................................................................. 595
isi sync reports view...................................................................................................................................................... 595
isi sync rules create........................................................................................................................................................595
isi sync rules delete........................................................................................................................................................ 596
isi sync rules list...............................................................................................................................................................597
isi sync rules modify....................................................................................................................................................... 597
isi sync rules reports list................................................................................................................................................598
isi sync rules reports view............................................................................................................................................ 599
isi sync rules view........................................................................................................................................................... 599
isi sync service policies create.....................................................................................................................................600
isi sync service policies delete..................................................................................................................................... 604
isi sync service policies disable....................................................................................................................................605
isi sync service policies enable.................................................................................................................................... 605
isi sync service policies list........................................................................................................................................... 605
isi sync service policies modify.................................................................................................................................... 606
isi sync service policies reset.........................................................................................................................................611
isi sync service policies resolve.................................................................................................................................... 612
isi sync service policies view.........................................................................................................................................612
isi sync service recovery allow-write.......................................................................................................................... 612
isi sync service recovery resync-prep........................................................................................................................ 613
isi sync service target break......................................................................................................................................... 614
isi sync service target cancel........................................................................................................................................614
isi sync service target list.............................................................................................................................................. 615

Contents 17
isi sync service target view........................................................................................................................................... 615
isi sync settings modify.................................................................................................................................................. 616
isi sync settings view...................................................................................................................................................... 617
isi sync target break........................................................................................................................................................ 617
isi sync target cancel...................................................................................................................................................... 618
isi sync target list.............................................................................................................................................................619
isi sync target reports list............................................................................................................................................. 620
isi sync target reports subreports list.........................................................................................................................621
isi sync target reports subreports view.....................................................................................................................622
isi sync target reports view.......................................................................................................................................... 623
isi sync target view.........................................................................................................................................................623
isi tape delete...................................................................................................................................................................624
isi tape list......................................................................................................................................................................... 624
isi tape modify..................................................................................................................................................................625
isi tape rename................................................................................................................................................................ 625
isi tape rescan..................................................................................................................................................................626
isi tape view......................................................................................................................................................................627
isi upgrade cluster add-nodes...................................................................................................................................... 627
isi upgrade cluster add-remaining-nodes.................................................................................................................. 627
isi upgrade cluster archive............................................................................................................................................ 628
isi upgrade cluster assess............................................................................................................................................. 628
isi upgrade cluster commit............................................................................................................................................628
isi upgrade cluster drain................................................................................................................................................ 629
isi upgrade cluster firmware......................................................................................................................................... 629
isi upgrade cluster firmware start...............................................................................................................................630
isi upgrade cluster from-version.................................................................................................................................. 631
isi upgrade cluster nodes firmware............................................................................................................................. 631
isi upgrade cluster nodes list........................................................................................................................................ 632
isi upgrade cluster nodes view.....................................................................................................................................632
isi upgrade cluster pause...............................................................................................................................................633
isi upgrade cluster resume............................................................................................................................................ 633
isi upgrade cluster retry-last-action........................................................................................................................... 633
isi upgrade cluster rollback........................................................................................................................................... 634
isi upgrade cluster reboot............................................................................................................................................. 634
isi upgrade cluster settings...........................................................................................................................................635
isi upgrade cluster start.................................................................................................................................................635
isi upgrade cluster to-version...................................................................................................................................... 636
isi upgrade cluster unblock........................................................................................................................................... 636
isi upgrade cluster view................................................................................................................................................. 637
isi upgrade patches abort..............................................................................................................................................637
isi upgrade patches install............................................................................................................................................. 637
isi upgrade patches list.................................................................................................................................................. 638
isi upgrade patches uninstall........................................................................................................................................ 638
isi upgrade patches view...............................................................................................................................................639
isi version.......................................................................................................................................................................... 639
isi worm cdate set.......................................................................................................................................................... 640
isi worm cdate view........................................................................................................................................................640
isi worm create................................................................................................................................................................ 640
isi worm domains create................................................................................................................................................ 641
isi worm domains list...................................................................................................................................................... 643

18 Contents
isi worm domains modify............................................................................................................................................... 644
isi worm domains view .................................................................................................................................................. 647
isi worm files delete........................................................................................................................................................ 647
isi worm files view...........................................................................................................................................................648
isi zone restrictions create........................................................................................................................................... 648
isi zone restrictions delete............................................................................................................................................649
isi zone restrictions list.................................................................................................................................................. 649
isi zone zones create..................................................................................................................................................... 650
isi zone zones delete.......................................................................................................................................................651
isi zone zones list............................................................................................................................................................ 652
isi zone zones modify.....................................................................................................................................................652
isi zone zones view.........................................................................................................................................................654

Contents 19
1
本指南简介
本章介业本参考指南,并提供了有关如何从 Isilon 技业支持业得帮助的信息。

主简:
• 关于本指南
• 业法业
• 从何业业得帮助

关于本指南
本指南列出并介绍了扩展标准 UNIX 命令集的所有特定于 OneFS 的命令。
注: isi healthcheck CLI 命令的文档具有其自己的 OneFS 文档和 Dell EMC 信息中心,可在 https://
community.emc.com/docs/DOC-71575 上找到。
您的建议有助于我们提高文档的准确性、组织结构和整体质量。请将您的反馈发送到 http://bit.ly/isilon-docfeedback。如果您
无法通过该 URL 提供反馈,请向 [email protected] 发送电子邮件。

语法图
每个命令的格式在语法图中进行了介绍。
以下约定适用于语法图:

元素 描述

[] 方括号指示可选元素。如果在指定命令时省略方括号的内容,
则命令仍可成功运行。

<> 尖括号指示占位符值。您必须将尖括号的内容替换为有效值,
否则命令会失败。

{} 大括号指示一组元素。如果大括号的内容由竖线分隔,则内容
是互斥的。如果大括号的内容未由竖线分隔,则内容必须一起
指定。

| 竖线分隔大括号中的互斥元素。

... 省略号指示前面的元素可以多次重复。如果省略号紧接在大括
号或括号之后,则大括号或括号的内容可以多次重复。

每个 isi 命令划分为三个部分:命令、必需选项和可选选项。必需选项具有位置性,这意味着您必须按照它们在语法图中的显
示顺序来指定它们。但是,您可以通过在尖括号中显示的文本前加上双短划线,以其他顺序指定必需选项。例如,考虑 isi
snapshot snapshots create。

isi snapshot snapshots create <name> <path>


[--expires <timestamp>]
[--alias <string>]
[--verbose]

20 本指南简介
如果 <name> 和 <path> 选项前面加有双短划线,则这两个选项可以在命令中四处移动。例如,以下命令有效,其中
onefs_root 是 OneFS 安装的根目录:

isi snapshot snapshots create --verbose --path /onefs_root/data --alias newSnap_alias --


name newSnap

可以接受缩短版本的命令,只要该命令明确且不适用于多个命令。例如,isi snap snap c newSnap /onefs_root/


data 等效于 isi snapshot snapshots create newSnap /onefs_root/data,因为每个单词的根都仅属于一个命
令。如果某个单词属于多个命令,则命令会失败。例如,isi sn snap c newSnap /onefs_root/data 不等于 isi
snapshot snapshots create newSnap /onefs_root/data,因为 isi sn 的根可能属于 isi snapshot 或 isi
snmp。
如果您开始键入某个单词,然后按 TAB 键,则只要该单词明确并且仅适用于一个命令,该单词的其余部分便会自动显现。例
如,isi snap 会补充完整为 isi snapshot,因为这是唯一有效的可能性。但是,isi sn 不会补充完整,因为它是 isi
snapshot 和 isi snmp 的根。

从何处获得帮助
Dell Technologies 支持网站 (https://www.dell.com/support) 包含有关产品和服务的重要信息,包括驱动程序、安装包、产品文
档、知识库文章和公告。
可能需要有效的支持合同和帐户才能访问有关特定 Dell Technologies 产品或服务的所有可用信息。

用于获取帮助的其他选项
本部分包含用于获取有关 PowerScale 产品的问题解答的资源。

Dell Technologies 支持 ● https://www.dell.com/support/incidents-online/en-us/contactus/product/isilon-onefs


电话支持 ● 美国:1-800-SVC-4EMC (1-800-782-4362)
● 加拿大:1-800-543-4782
● 全球:1-508-497-7901
● 在 https://www.dell.com/support/incidents-online/en-us/contactus/product/isilon-
onefs 可获取特定国家或地区的本地电话号码。
PowerScale OneFS 文档信息中心 ● https://www.dell.com/support/kbdoc/en-us/000152189/powerscale-onefs-info-hubs
提供自助服务的戴尔社区公告板 ● https://www.dell.com/community

本指南简介 21
2
OneFS isi 命令 A 至 C
本章包含 OneFS CLI 命令文档 isi antivirus policies create 至 isi config。

主简:
• isi antivirus cava
• isi antivirus cava filters
• isi antivirus cava filters list
• isi antivirus cava filters modify
• isi antivirus cava filters view
• isi antivirus cava jobs
• isi antivirus cava jobs create
• isi antivirus cava jobs delete
• isi antivirus cava jobs list
• isi antivirus cava jobs modify
• isi antivirus cava jobs start
• isi antivirus cava jobs view
• isi antivirus cava servers
• isi antivirus cava servers create
• isi antivirus cava servers delete
• isi antivirus cava servers list
• isi antivirus cava servers modify
• isi antivirus cava servers view
• isi antivirus cava settings
• isi antivirus cava settings modify
• isi antivirus cava settings view
• isi antivirus cava status
• isi antivirus icap policies create
• isi antivirus icap policies delete
• isi antivirus icap policies list
• isi antivirus policies modify
• isi antivirus icap policies start
• isi antivirus icap policies view
• isi antivirus icap settings modify
• isi antivirus icap settings view
• isi antivirus icap servers create
• isi antivirus icap servers delete
• isi antivirus icap servers list
• isi antivirus icap servers view
• isi antivirus icap servers modify
• isi antivirus quarantine
• isi antivirus release
• isi antivirus reports delete
• isi antivirus reports scans list
• isi antivirus reports scans view
• isi antivirus reports threats list
• isi antivirus reports threats view
• isi antivirus scan
• isi antivirus status
• isi audit progress global view
• isi audit progress view

22 OneFS isi 命令 A 至 C
• isi audit settings global modify
• isi audit settings global view
• isi audit settings modify
• isi audit settings view
• isi audit topics list
• isi audit topics modify
• isi audit topics view
• isi auth access
• isi auth ads create
• isi auth ads delete
• isi auth ads list
• isi auth ads modify
• isi auth ads spn check
• isi auth ads spn create
• isi auth ads spn delete
• isi auth ads spn fix
• isi auth ads spn list
• isi auth ads trusts controllers list
• isi auth ads trusts list
• isi auth ads view
• isi auth duo modify
• isi auth error
• isi auth file create
• isi auth file delete
• isi auth file list
• isi auth file modify
• isi auth file view
• isi auth groups create
• isi auth groups delete
• isi auth groups flush
• isi auth groups list
• isi auth groups members list
• isi auth groups modify
• isi auth groups view
• isi auth id
• isi auth krb5 create
• isi auth krb5 delete
• isi auth krb5 domain create
• isi auth krb5 domain delete
• isi auth krb5 domain list
• isi auth krb5 domain modify
• isi auth krb5 domain view
• isi auth krb5 list
• isi auth krb5 realm create
• isi auth krb5 realm delete
• isi auth krb5 realm list
• isi auth krb5 realm modify
• isi auth krb5 realm view
• isi auth krb5 spn check
• isi auth krb5 spn create
• isi auth krb5 spn delete
• isi auth krb5 spn fix
• isi auth krb5 spn import
• isi auth krb5 spn list
• isi auth krb5 view
• isi auth ldap create

OneFS isi 命令 A 至 C 23
• isi auth ldap delete
• isi auth ldap list
• isi auth ldap modify
• isi auth ldap view
• isi auth local list
• isi auth local modify
• isi auth local view
• isi auth log-level modify
• isi auth log-level view
• isi auth mapping create
• isi auth mapping delete
• isi auth mapping dump
• isi auth mapping flush
• isi auth mapping import
• isi auth mapping list
• isi auth mapping modify
• isi auth mapping token
• isi auth mapping view
• isi auth netgroups view
• isi auth nis create
• isi auth nis delete
• isi auth nis list
• isi auth nis modify
• isi auth nis view
• isi auth privileges
• isi auth refresh
• isi auth roles create
• isi auth roles delete
• isi auth roles list
• isi auth roles members list
• isi auth roles modify
• isi auth roles privileges list
• isi auth roles view
• isi auth settings acls modify
• isi auth settings acls view
• isi auth settings global modify
• isi auth settings global view
• isi auth settings krb5 modify
• isi auth settings krb5 view
• isi auth settings mapping modify
• isi auth settings mapping view
• isi auth status
• isi auth users create
• isi auth users delete
• isi auth users flush
• isi auth users list
• isi auth users modify
• isi auth users view
• isi batterystatus list
• isi batterystatus view
• isi certificate authority delete
• isi certificate authority import
• isi certificate authority list
• isi certificate authority modify
• isi certificate authority view
• isi certificate server delete

24 OneFS isi 命令 A 至 C
• isi certificate server import
• isi certificate server list
• isi certificate server modify
• isi certificate server view
• isi certificate settings modify
• isi certificate settings view
• isi cloud access add
• isi cloud access list
• isi cloud access remove
• isi cloud access view
• isi cloud accounts create
• isi cloud accounts delete
• isi cloud accounts list
• isi cloud accounts modify
• isi cloud accounts view
• isi cloud archive
• isi cloud jobs cancel
• isi cloud jobs create
• isi cloud jobs files list
• isi cloud jobs list
• isi cloud jobs pause
• isi cloud jobs resume
• isi cloud jobs view
• isi cloud pools create
• isi cloud pools delete
• isi cloud pools list
• isi cloud pools modify
• isi cloud pools view
• isi cloud proxies create
• isi cloud proxies delete
• isi cloud proxies list
• isi cloud proxies modify
• isi cloud proxies view
• isi cloud recall
• isi cloud restore_coi
• isi cloud settings modify
• isi cloud settings regenerate-enc ryption-key
• isi cloud settings view
• isi cluster atime modify
• isi cluster atime view
• isi cluster config
• isi cluster config exports
• isi cluster config exports create
• isi cluster config exports list
• isi cluster config exports view
• isi cluster config imports
• isi cluster config imports create
• isi cluster config imports list
• isi cluster config imports view
• isi cluster contact modify
• isi cluster contact view
• isi cluster encoding list
• isi cluster encoding modify
• isi cluster encoding view
• isi cluster identity modify
• isi cluster identity view

OneFS isi 命令 A 至 C 25
• isi cluster internal-networks modify
• isi cluster internal-networks view
• isi cluster join-mode modify
• isi cluster join-mode view
• isi cluster lnnset modify
• isi cluster lnnset view
• isi cluster reboot
• isi cluster shutdown
• isi cluster time modify
• isi cluster time view
• isi cluster time timezone modify
• isi cluster time timezone view
• isi compression stats list
• isi compression stats view
• isi compression settings modify
• isi compression settings view
• isi config

isi antivirus cava


管理 CAVA 防病毒设置和策略。

语法

isi antivirus cava {<action> | <subcommand>}


[--timeout <integer>]

选项
--timeout <integer>
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

isi antivirus cava filters


管理 CAVA 防病毒筛选器。

语法
isi antivirus cava filters <action>
[--timeout <integer>]

选项
--timeout <integer>
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

26 OneFS isi 命令 A 至 C
isi antivirus cava filters list
列出 CAVA 筛选器。

语法
isi antivirus cava filters list
[{--limit | -l}<integer>]
[--sort (zone_name |
filter_enabled | open_on_fail |
scan_profile | scan_cloudpool_files)]
[{--descending | -d}]
[--format (table | json
| csv | list)]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]

选项
{--limit | -l} < 整数 >]
显示防病毒 cava 筛选器的数量。
[--sort (zone_name | filter_enabled | open_on_fail | scan_profile | scan_cloudpool_files)]
按指定字段对数据进行排序。
[{--descending | -d}]
按降序对数据进行排序。
[--format (table | json | csv | list)]
以表格、JSON、CSV 或列表格式显示防病毒 cava 筛选器。
[{--no-header | -a}]
不会以 CSV 或表格格式显示标头。
[{--no-footer | -z}]
不显示表格摘要页脚信息。
[{--verbose | -v}]
显示更多详细信息。

isi antivirus cava filters modify


修改 CAVA 筛选器。

语法
isi antivirus cava filters modify<zone>
[{--filter-enabled | -e}<boolean>]
[{--open-on-fail | -f} <boolean>]
[{--file-extensions | -t} <string> | --add-file-extensions <string> | --remove-file-
extensions
<string>]
[--revert-file-extensions]
[{--add-common-file-extensions | -n}]
[{--file-extension-action | -a} (include | exclude)]
[{--scan-if-no-extension | -o}<boolean>]
[{--paths-to-exclude | -x} <string> | --clear-paths-to-exclude |--add-paths-to-
exclude <string>
| --remove-paths-to-exclude <string>]

OneFS isi 命令 A 至 C 27
[{--scan-cloudpool-files | -c} <boolean>]
[{--scan-profile | -s}(standard | strict)]
[--revert-scan-profile]
[{--verbose | -v}]

选项
<分区>
显示访问分区
[{--filter-enabled | -e}< 布尔值 >]
为 AV 扫描启用访问分区。
[{--open-on-fail | -f} < 布尔值 >]
当扫描失败时允许访问文件。
[{--file-extensions | -t} < 字符串 >
显示要在扫描决策中使用的文件扩展名数组(包含列表或排除列表)。为要在扫描决策中使用的每个附
加文件扩展名数组(包含列表或排除列表)指定 --file-extensions。
[--add-file-extensions < 字符串 >]
添加要在扫描决策中使用的文件扩展名数组(包含列表或排除列表)。为要添加的每个附加项目指定 --
add-file-extensions。
[--remove-file-extensions < 字符串 >]
删除要在扫描决策中使用的文件扩展名数组(包含列表或排除列表)。为要删除的每个附加项目指定 --
remove-file-extensions。
[--revert-file-extensions]
将值设置为 --file-extensions 的系统默认值。
[{--add-common-file-extensions | -n}]
添加要在扫描决策中使用的 50 多个常用文件扩展名的列表。
[{--file-extension-action | -a} (include | exclude)]
决定当文件与文件扩展名列表中的条目匹配时是要包含还是排除文件。
[{--scan-if-no-extension | -o} < 布尔值 >]
在不使用扩展名的情况下扫描文件。
[{--paths-to-exclude | -x} < 字符串 >]
引用根访问分区下不扫描的相对路径列表。为根访问分区下不扫描的每个附加相对路径列表指定 --
paths-to-exclude 。
{--clear-paths-to-exclude}
清除根访问分区下不扫描的相对路径列表的值。
{--add-paths-to-exclude < 字符串 >}
添加根访问分区下不扫描的相对路径列表。为要添加的每个附加项目指定 --add-paths-to-
exclude。
{--remove-paths-to-exclude < 字符串 >}
删除根访问分区下不扫描的相对路径列表。为要删除的每个附加项目指定 --remove-paths-to-
exclude。
[{--scan-cloudpool-files | -c} < 布尔值 >]
对 cloudpool 文件执行实时扫描。
[{--scan-profile | -s} (standard | strict)]
修改给定分区的扫描配置文件。
[--revert-scan-profile]
将值设置为 --scan-profile 的系统默认值。
[{--verbose | -v}]
显示更多详细信息。

28 OneFS isi 命令 A 至 C
isi antivirus cava filters view
查看 CAVA 筛选器。

语法
isi antivirus cava filters view <zone>

选项
<分区>
显示访问分区。

isi antivirus cava jobs


管理 CAVA 防病毒作业。

语法
isi antivirus cava jobs <action>
[--timeout <integer>]

选项
[--timeout < 整数 >]
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

isi antivirus cava jobs create


创建 CAVA 防病毒作业。

语法
isi antivirus cava jobs create <job-name>
[{--description | -d} <string>]
[{--enabled | -e} <boolean>]
[{--schedule | -s} (schedule | avsigupdate)]
[{--impact | -i} <string>]
[{--ignore-previous-scan-status | -f}]
[{--file-extensions | -t} <string>]
[{--add-common-file-extensions | -A}]
[{--file-extension-action | -a} (include | exclude)]
[{--scan-if-no-extension | -o} <boolean>]
[{--paths-to-include | -p} <path>]
[{--paths-to-exclude | -x} <string>]
[{--scan-cloudpool-files | -c} <boolean>]
[{--verbose | -v}]

OneFS isi 命令 A 至 C 29
选项
<job-name>
显示防病毒作业的唯一短名称。
[{--description | -d} < 字符串 >]
显示作业的自由格式客户描述。
[{--enabled | -e} < 布尔值 >]
引用所启用的作业。
[{--schedule | -s} (schedule | avsigupdate)]
以 isi-schedule 格式或 avsigupdate 标记显示正在运行的作业的计划。isi-schedule 的示例包括:“every
Friday”或“every day at 4:00”。当防病毒服务器上的病毒签名文件更新时,特殊 avsigupdate 标记会启动
作业。
[{--impact | -i} < 字符串 >
指定防病毒扫描作业的影响策略。可以指定 LOW、MEDIUM、HIGH、OFF_HOURS 或创建的自定义影
响策略。
[{--ignore-previous-scan-status | -f}]
强制扫描文件,无论最近是否扫描了文件。
[{--file-extensions | -t} < 字符串 >]
显示要在扫描决策中使用的文件扩展名数组(包含列表或排除列表)。为要在扫描决策中使用的每个附
加文件扩展名数组(包含列表或排除列表)指定 --file-extensions。
[{--add-common-file-extensions | -A}]
添加要在扫描决策中使用的 50 多个常用文件扩展名的列表。
[{--file-extension-action | -a} (include | exclude)]
确定当文件与文件扩展名列表中的条目匹配时是包含还是排除文件。
[{--scan-if-no-extension | -o} < 布尔值 >]
在不使用扩展名的情况下扫描文件。
[{--paths-to-include | -p} < 路径 >]
显示 /ifs 下要扫描的绝对路径数组。为 /ifs 下要扫描的每个附加绝对路径数组指定 --paths-to-
include。
[{--paths-to-exclude | -x} < 字符串 >
显示 /ifs 内要从 AV 扫描中排除的相对路径数组。为 /ifs 内要从 AV 扫描中排除的每个附加相对路
径数组指定 --paths-to-exclude。
[{--scan-cloudpool-files | -c} < 布尔值 >]
对 cloudpool 文件执行扫描。
[{--verbose | -v}]
显示更多详细信息。

isi antivirus cava jobs delete


删除 CAVA 防病毒作业。

语法
isi antivirus cava jobs delete { <job-name> | --all }
[{--verbose | -v}]
[{--force | -f}]

30 OneFS isi 命令 A 至 C
选项
<job-name>
显示防病毒作业的唯一短名称。
--all
删除所有 CEE/CAVA 作业。
[{--verbose | -v}]
显示更多详细信息。
[{--force | -f}]
请勿要求确认。

isi antivirus cava jobs list


列出 CAVA 防病毒作业。

语法
isi antivirus cava jobs list
[{--limit | -l} <integer>]
[--sort (job_name |
paths_to_include | paths_to_exclude
|schedule | enabled)]
[{--descending | -d}]
[--format (table | json | csv | list)]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]

选项
[{--limit | -l} < 整数 >]
显示防病毒 cava 作业的数量。
[--sort (job_name | paths_to_include | paths_to_exclude |schedule | enabled)]
按指定字段对数据进行排序。
[{--descending | -d}]
按降序对数据进行排序。
[--format (table | json | csv | list)]
以表格、JSON、CSV 或列表格式显示防病毒 cava 作业。
[{--no-header | -a}]
不会以 CSV 或表格格式显示标头。
[{--no-footer | -z}]
不显示表格摘要页脚信息。
[{--verbose | -v}]
显示更多详细信息。

OneFS isi 命令 A 至 C 31
isi antivirus cava jobs modify
修改 CAVA 防病毒作业。

语法
isi antivirus cava jobs modify <job-name>
[{--new-name | -n} <string>]
[{--description | -d} <string>]
[{--enabled | -e} <boolean>]
[{--schedule | -s} (<schedule> | avsigupdate)]
[{--impact | -i} <string>]
[--revert-impact]
[{--ignore-previous-scan-status | -f}]
[--revert-ignore-previous-scan-status]
[{--file-extensions | -t} <string> | --add-file-extensions <string>
| --remove-file-extensions <string>]
[--revert-file-extensions]
[{--add-common-file-extensions | -A}]
[{--file-extension-action | -a} (include | exclude)]
[{--scan-if-no-extension | -o} <boolean>]
[{--paths-to-include | -p} <path> | --add-paths-to-include <path>
| --remove-paths-to-include <path>]
[--revert-paths-to-include]
[{--paths-to-exclude | -x} <string> | --clear-paths-to-exclude | --add-paths-to-
exclude
<string> | --remove-paths-to-exclude <string>]
[{--scan-cloudpool-files | -c} <boolean>]
[{--verbose | -v}]

选项
<job-name>
显示防病毒作业的唯一短名称。
[{--new-name | -n} < 字符串 >]
将作业短名称更改为 <字符串>。
[{--description | -d} < 字符串 >]
显示作业的自由格式客户描述。
[{--enabled | -e}< 布尔值 >]
启用防病毒作业。
[{--schedule | -s} (<schedule> | avsigupdate)]
以 isi-schedule 格式或 avsigupdate 标记显示正在运行的作业的计划。isi-schedule 的示例包括:“every
Friday”或“every day at 4:00”。当防病毒服务器上的病毒签名文件更新时,特殊 avsigupdate 标记会启动
作业。
--impact | -i} < 字符串 >]
指定防病毒扫描作业的影响策略。可以指定 LOW、MEDIUM、HIGH、OFF_HOURS 或创建的自定义影
响策略。
[--revert-impact]
将值设置为 --impact 的系统默认值。
[{--ignore-previous-scan-status | -f}]
强制扫描文件,无论最近是否扫描了文件。
[--revert-ignore-previous-scan-status]
将值设置为 --ignore-previous-scan-status 的系统默认值。
[{--file-extensions | -t} < 字符串 >
显示要在扫描决策中使用的文件扩展名数组(包含列表或排除列表)。为要在扫描决策中使用的每个附
加文件扩展名数组(包含列表或排除列表)指定 --file-extensions。

32 OneFS isi 命令 A 至 C
[--add-file-extensions < 字符串 >]
添加要在扫描决策中使用的文件扩展名数组(包含列表或排除列表)。为要添加的每个附加项目指定 --
add-file-extensions。
[--remove-file-extensions < 字符串 >]
删除要在扫描决策中使用的文件扩展名数组(包含列表或排除列表)。为要删除的每个附加项目指定 --
remove-file-extensions。
[--revert-file-extensions]
将值设置为 --file-extensions 的系统默认值。
[{--add-common-file-extensions | -n}]
添加要在扫描决策中使用的 50 多个常用文件扩展名的列表。
[{--file-extension-action | -a} (include | exclude)]
确定当文件与文件扩展名列表中的条目匹配时是要包含还是排除文件。
[{--scan-if-no-extension | -o} < 布尔值 >]
在不使用扩展名的情况下扫描文件。
{--paths-to-include | -p} < 路径 >
显示 /ifs 下要扫描的绝对路径数组。为 /ifs 下要扫描的每个附加绝对路径数组指定 --paths-to-
include。
{--add-paths-to-include < 路径 >}
添加 /ifs 下要扫描的绝对路径数组。(默认情况下为“/ifs”)。为要添加的每个附加项目指定 --add-
paths-to-include。
{--remove-paths-to-include < 路径 >}
删除 /ifs 下要扫描的绝对路径数组。为要删除的每个附加项目指定 --remove-paths-to-
include。
--revert-paths-to-include
将值设置为 --paths-to-include 的系统默认值。
{--paths-to-exclude | -x} < 字符串 >
引用 /ifs 内要从 AV 扫描中排除的相对路径数组。为 /ifs 内要从 AV 扫描中排除的每个附加相对路径
数组指定 --paths-to-exclude。
{--clear-paths-to-exclude}
清除 /ifs 内要从 AV 扫描中排除的相对路径数组的值。
{--add-paths-to-exclude < 字符串 >}
添加 /ifs 内要从 AV 扫描中排除的相对路径数组。为要添加的每个附加项目指定 --add-paths-to-
exclude。
{--remove-paths-to-exclude < 字符串 >}
删除 /ifs 内要从 AV 扫描中排除的相对路径数组。为要删除的每个附加项目指定 --remove-paths-
to-exclude。
[{--scan-cloudpool-files | -c} < 布尔值 >]
对 cloudpool 文件执行实时扫描。
[{--verbose | -v}]
显示更多详细信息。

isi antivirus cava jobs start


手动计划扫描作业。

语法
isi antivirus cava jobs start <job-name>
[--report-id <string>]
[{--ignore-previous-scan-status | -f}]

OneFS isi 命令 A 至 C 33
选项
<job-name>
显示防病毒作业的唯一短名称。
[--report-id < 字符串 >]
显示扫描报告的可选 ID。
[{--ignore-previous-scan-status | -f}]
强制扫描文件,无论最近是否扫描了文件。

isi antivirus cava jobs view


查看 CAVA 防病毒作业。

语法
isi antivirus cava jobs view <job-name>

选项
<job-name>
显示防病毒作业的唯一短名称。

isi antivirus cava servers


管理 CEE/CAVA 服务器。

语法
isi antivirus cava servers <action>
[--timeout <integer>]

选项
[--timeout} < 整数 >]
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

isi antivirus cava servers create


添加 CEE/CAVA 服务器。

语法
isi antivirus cava servers create <server-name> <server-uri>
[{--enabled | -e} <boolean>]
[{--verbose | -v}]

34 OneFS isi 命令 A 至 C
选项
server-name
显示 CEE/CAVA 服务器的唯一短名称。
server-uri
引用 CEE/CAVA 服务器的 URI。
[{--enabled | -e} < 布尔值 >]
确定是否启用 CAVA 服务器。
[{--verbose | -v}]
显示更多详细信息。

isi antivirus cava servers delete


删除 CEE/CAVA 服务器。

语法
isi antivirus cava servers delete { <server-name> | --all }
[{--verbose | -v}]
[{--force | -f}]

选项
server-name
显示 CEE/CAVA 服务器的唯一短名称。
--all
删除所有 CEE/CAVA 服务器。
[{--verbose | -v}]
显示更多详细信息。
[{--force | -f}]
请勿要求确认。

isi antivirus cava servers list


列出 CEE/CAVA 防病毒服务器。

语法
isi antivirus cava servers list
[{--limit | -l} <integer>]
[--sort (server_name | server_uri | enabled | server_type)]
[{--descending | -d}]
[--format (table | json | csv | list)]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]

OneFS isi 命令 A 至 C 35
选项
[{--limit | -l} < 整数 >]
显示防病毒 cava 服务器的数量。
[--sort (server_name | server_uri | enabled | server_type)]
按指定字段对数据进行排序。
[{--descending | -d}]
按降序对数据进行排序。
[--format (table | json | csv | list)]
以表格、JSON、CSV 或列表格式显示防病毒 cava 服务器。
[{--no-header | -a}]
不会以 CSV 或表格格式显示标头。
[{--no-footer | -z}]
不显示表格摘要页脚信息。
[{--verbose | -v}]
显示更多详细信息。

isi antivirus cava servers modify


修改 CEE/CAVA 服务器。

语法
isi antivirus cava servers modify <server-name>
[{--new-name | -n} <string>]
[{--server-uri | -u} <server_uri>]
[{--enabled | -e} <boolean>]
[{--verbose | -v}]

选项
server-name
显示 CEE/CAVA 服务器的唯一短名称。
[{--new-name | -n} < 字符串 >]
显示 CEE/CAVA 服务器的新唯一短名称。
[{--server-uri | -u} < 服务器 uri>]
引用 CEE/CAVA 服务器的 URI。
[{--enabled | -e} < 布尔值 >]
确定是否启用 CAVA 服务器。
[{--verbose | -v}]
显示更多详细信息。

36 OneFS isi 命令 A 至 C
isi antivirus cava servers view
查看 CEE/CAVA 服务器的属性。

语法
isi antivirus cava servers view <server-name>

选项
server-name
显示 CEE/CAVA 服务器的唯一短名称。

isi antivirus cava settings


管理 CAVA 防病毒全局设置。

语法
isi antivirus cava settings <action>
[--timeout <integer>]

选项
[--timeout < 整数 >]
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

isi antivirus cava settings modify


修改防病毒设置。

语法
isi antivirus cava settings modify
[{--service-enabled | -e} <boolean>]
[{--scan-all-zones | -Z} | {--scan-zones | -z} <access_zone> | --clear-scan-
zones |
--add-scan-zones <access_zone> | --remove-scan-zones <access_zone>]
[{--ip-pool | -i} <string>]
[--revert-ip-pool]
[{--report-expiry | -r} <duration>]
[--revert-report-expiry]
[{--scan-timeout | -t} <duration>]
[--revert-scan-timeout]
[{--scan-cloudpool-timeout | -c} <duration>]
[--revert-scan-cloudpool-timeout]
[{--scan-size-maximum | -m} <SIZE>]
[--revert-scan-size-maximum]
[{--force | -f}]
[{--verbose | -v}]

OneFS isi 命令 A 至 C 37
选项
[{--service-enabled | -e} < 布尔值 >]
确定 CAVA 防病毒服务是打开还是关闭。
--scan-all-zones | -Z
将所有访问分区添加到已启用扫描的访问分区列表。
{--scan-zones | -z} < 访问分区 >
显示已启用防病毒扫描的访问分区列表。为已启用防病毒扫描的每个附加访问分区列表指定 --scan-
zones。
--clear-scan-zones
清除已启用防病毒扫描的访问分区列表的值。
{--add-scan-zones} < 访问分区 >
添加已启用防病毒扫描的访问分区列表。为要添加的每个附加项目指定 --add-scan-zones 。
{--remove-scan-zones } < 访问分区 >
删除已启用防病毒扫描的访问分区列表。为要删除的每个附加项目指定 --remove-scan-zones。
[{--ip-pool | -i} < 字符串 >]
显示 CEE/CAVA 服务器使用的 IP 池的 ID。ID 应由 groupnet 名称、子网名称和池名称组成。
示例:groupnet0.subnet0.pool0 或 groupnet0:subnet0:pool0。
有关更多信息,请查看 isi-network 的手册页。
--revert-ip-pool
将值设置为 --ip-pool 的系统默认值。
[{--report-expiry | -r} < 持续时间 >]
确定保留扫描报告的秒数。
--revert-report-expiry
将值设置为 --report-expiry 的系统默认值。
[{--scan-timeout | -t} < 持续时间 >]
确定 SMB 将等待防病毒扫描完成的秒数。
--revert-scan-timeout
将值设置为 --scan-timeout 的系统默认值。
[{--scan-cloudpool-timeout | -c} < 持续时间 >]
确定 SMB 将等待 cloudpool 文件的防病毒扫描完成的秒数。
--revert-scan-cloudpool-timeout
将值设置为 --scan-cloudpool-timeout 的系统默认值。
[{--scan-size-maximum | -m} < 大小 >]
确定将扫描的文件的最大大小(以 kB 为单位)。
--revert-scan-size-maximum
将值设置为 --scan-size-maximum 的系统默认值。
[{--force | -f}]
请勿要求确认。
[{--verbose | -v}]
显示更多详细信息。

38 OneFS isi 命令 A 至 C
isi antivirus cava settings view
查看防病毒设置。

语法
isi antivirus cava settings view
[--format (list | json)]

选项
[--format (list | json)]
以列表或 JSON 格式显示防病毒 cava 设置。

isi antivirus cava status


查看节点上的 CAVA 防病毒状态。

语法
isi antivirus cava status
[{--servers | -s} | {--system-stats | -i}]
[{--verbose | -v}]
[--format (table | json | csv | list)]

选项
--servers | -s
显示每台 CAVA 服务器的状态和扩展信息。
--system-stats | -i
显示 CAVA 防病毒系统的常规扫描统计信息。
--verbose | -v
显示更多详细信息。
--format (table | json | csv | list
以表格、JSON、CSV 或列表格式显示防病毒 cava。

isi antivirus icap policies create


创建防病毒扫描策略。

语法
isi antivirus icap policies create <name>
[--description <string>]
[--enabled {true | false}]
[--schedule <schedule>]
[--impact <impact-policy>]
[--force-run {yes | no}]
[--paths <path>...]

OneFS isi 命令 A 至 C 39
[--recursion-depth <integer>]
[--verbose]

选项
<name>
指定策略的名称。
--description <string>
指定策略的描述。
{--enabled | -e} {true | false}
确定策略是已启用还是已禁用。如果设置为 true,则策略已启用。默认值为 false。
{--schedule | -s} < 计划 >
指定策略运行的时间。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“Saturday”和“sat”都有效。
{--impact | -i} < 影响策略 >
指定防病毒扫描作业的影响策略。您可以指定 LOW、MEDIUM、HIGH、OFF_HOURS 或创建的自定义影
响策略。
{--force-run | -r} {yes | no}
确定是否强制进行策略扫描。如果强制进行扫描,则扫描所有文件(无论 OneFS 是否将文件标记为已扫
描,也无论全局设置是否指定不应扫描某些文件)。
--paths <path>

40 OneFS isi 命令 A 至 C
指定运行策略时要扫描的目录。要指定多个路径,请重复 --path 选项。例如:

--paths /ifs/data/directory1 --paths /ifs/data/directory2

--recursion-depth <integer>
注: 此选项已弃用,在指定时不会影响防病毒扫描。

指定要在扫描中包含的子目录深度。
{--verbose | -v}
显示一条消息,确认防病毒策略已创建。

isi antivirus icap policies delete


删除防病毒扫描策略。

语法
isi antivirus icap policies delete {<name> | --all}
[--force]
[--verbose]

选项
{< 名称 > | --all}
删除指定策略或所有策略。
{--force | -f}
不会提示您确认是否要删除策略。
{--verbose | -v}
显示一条消息,确认防病毒策略已删除。

isi antivirus icap policies list


列出 ICAP 防病毒扫描策略。

语法
isi antivirus icap policies list
[--limit <integer>]
[--sort {name | description | enabled}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort < 属性 >

OneFS isi 命令 A 至 C 41
按照指定的属性对显示的输出进行排序。
以下值有效:

name 按服务器的 URL 对输出进行排序。


description 按服务器的描述对输出进行排序。
enabled 按服务器的状态对输出进行排序。

{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi antivirus policies modify


修改防病毒扫描策略。

语法
isi antivirus icap policies modify <id>
[--name <new-name>]
[--description <string>]
[--enabled {true | false}]
[--schedule <schedule>]
[--clear-schedule]
[--impact <impact-policy>]
[--clear-impact]
[--force-run {true | false}]
[--paths <path>
[--clear-paths]
[--add-paths <path>]
[--remove-paths <path>]
[--recursion-depth <integer>]

选项
<ID>
修改含指定策略标识号的策略。
{--name | -n} < 新名称 >
指定此策略的新名称。
--description <string>
指定策略的描述。
{--enabled | -e} {true | false}
确定此策略是已启用还是已禁用。如果设置为 true,则策略已启用。默认值为 false。
{--schedule | -s} < 计划 >
指定策略运行的时间。

42 OneFS isi 命令 A 至 C
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“Saturday”和“sat”都有效。
--clear-schedule
删除策略的当前计划。
{--impact | -i} < 影响策略 >
指定防病毒扫描作业的影响策略。您可以指定 LOW、MEDIUM、HIGH、OFF_HOURS 或创建的自定义影
响策略。
--clear-impact
清除防病毒扫描作业的当前影响策略。
{--force-run | -r} {yes | no}
确定是否强制进行策略扫描。如果强制进行扫描,则扫描所有文件(无论 OneFS 是否将文件标记为已扫
描,也无论全局设置是否指定不应扫描某些文件)。
--paths <path>
指定运行策略时要扫描的目录。要指定多个路径,请重复 --path 选项。例如:

--paths /ifs/data/directory1 --paths /ifs/data/directory2

注: 如果指定此选项,指定的路径将替换列表中所有以前指定的路径。

--clear-paths
清除要扫描的路径的列表。
--add-paths <path>
将指定路径添加到要扫描的路径列表。
--remove-paths <path>
从要扫描的路径列表中删除指定路径。

OneFS isi 命令 A 至 C 43
{--verbose | -v}
显示一条消息,确认防病毒策略已修改。

isi antivirus icap policies start


运行 ICAP 防病毒策略。

语法
isi antivirus icap policies start <policy>
[--report-id <id>]
[--force-run {true | false}]
[--update {yes | no}]

选项
< 策略 >
运行指定策略。
--report-id <ID>
将指定 ID 分配给为 ICAP 防病毒扫描策略的此次运行生成的报告。如果未指定 ID,则 OneFS 将自动分
配一个。
{ --force-run | -r} {true | false}
确定是否强制进行扫描。如果强制进行扫描,则扫描所有文件(无论 OneFS 是否将文件标记为已扫描,
也无论全局设置是否指定不应扫描某些文件)。
--update {yes | no}
指定是否在策略文件中更新上次运行时间。默认值为 yes。

isi antivirus icap policies view


显示有关 ICAP 防病毒扫描策略的信息。

语法
isi antivirus icap policies view <name>

选项
< 名称 >
显示有关指定策略的信息。

44 OneFS isi 命令 A 至 C
isi antivirus icap settings modify
设置和显示 ICAP 防病毒扫描的全局配置设置。

语法
isi antivirus icap settings modify
[--fail-open {true | false}]
[{--glob-filters <string>... | --clear-glob-filters
| --add-glob-filters <string> | --remove-glob-filters <string>}]
[--glob-filters-enabled {true | false}]
[--glob-filters-include {true | false}]
[--path-prefixes <path>... | --clear-path-prefixes
| --add-path-prefixes <path> | --remove-path-prefixes <path>}]
[--repair {true | false}]
[--report-expiry <integer><time>]
[--scan-cloudpool-files{true | false}]
[--scan-on-close {true | false}]
[--scan-on-open {true | false}]
[--scan-size-maximum <integer>{k | M | G | T | P}]
[--service {true | false}]
[--quarantine {true | false}]
[--truncate {true | false}]
[--verbose]

选项
--fail-open {true | false}
如果 --scan-on-open 设置为 true,则确定用户是否可以访问无法扫描的文件。如果将此选项设置
为 false,则用户在 ICAP 服务器扫描文件之前无法访问文件。
如果 --scan-on-open 设置为 true,则此选项无效。
--glob-filter < 字符串 >
指定文件名或扩展名。要指定多个筛选器,您必须在同一个命令中包含多个 --glob-filter 选项。指
定此选项将删除任何现有全局筛选器。
包括通配符的所有字符串都必须用引号引起来,例如 "* .jpg"。您可以包含以下通配符:

通配符 说明
* 可与替换星号的任何字符串匹配。
例如,指定“m*”可与“movies”和“m123”匹配

[] 可与括号中包含的任何字符或由连字符隔开的一系列字符匹配。
例如,指定“b[aei]t”可与“bat”、“bet”和“bit”匹配
例如,指定“1[4-7]2”可与“142”、“152”、“162”和“172”匹配
您可通过在第一个括号后面紧跟一个感叹号来排除括号中的字符。
例如,指定“b[!ie]”可与“bat”匹配,但不与“bit”或“bet”匹配
如果是第一个或最后一个字符,您可与括号中的括号匹配。
例如,指定“[[c]at”可与“cat”和“[at”匹配
如果是第一个或最后一个字符,您可与括号中的连字符匹配。
例如,指定“car[-s]”可与“cars”和“car-”匹配

? 可与替换问号的任何字符匹配。
例如,指定“t?p”可与“tap”、“tip”和“top”匹配

OneFS isi 命令 A 至 C 45
注: 如果指定此选项,指定的筛选器将替换列表中所有以前指定的筛选器。

--clear-glob-filters
清除筛选器的列表。
--add-glob-filters <字符串>
将指定筛选器添加到筛选器列表中。
--remove-glob-filters <字符串>
将指定筛选器从筛选器列表中删除。
--glob-filters-enabled {true | false}
确定是否启用全局筛选器。如果未指定全局筛选器,则全局筛选器会保持禁用状态,即使此选项设置为
true 也是如此。
--glob-filters-include {true | false}
确定 OneFS 解释全局筛选器的方式。如果设置为 true,则 OneFS 仅扫描与全局筛选器匹配的文件。如
果设置为 false,则 OneFS 仅扫描不与任何全局筛选器匹配的文件。
--path-prefix < 路径 >
如果指定,则仅扫描指定目录路径中包含的文件。此选项仅影响访问时扫描。要指定多个目录,您必须
在同一个命令中包含多个 --path-prefix 选项。指定此选项将删除任何现有路径前缀。
注: 如果指定此选项,指定的筛选器将替换列表中所有以前指定的筛选器。

--clear-path-prefixes
清除路径的列表。
--add-path-prefixes <路径>
将指定路径添加到路径列表。
--remove-path-prefixes <路径>
将指定路径从路径列表中删除。
--repair {true | false}
确定 OneFS 是否尝试修复在其中检测到威胁的文件。
--report-expiry < 整数 > < 时间 >
确定 OneFS 在删除防病毒扫描报告之前保留这些报告的时间长度。
以下 < 时间 > 值有效:

支持 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

--scan-cloudpool-files {true | false}


确定是否扫描 cloudpool 文件以进行防病毒。
--scan-on-close {true | false}
确定是否在关闭文件之后扫描文件。
--scan-on-open {true | false}
确定是否在将文件发送给用户之前扫描文件。
--scan-size-maximum < 整数 >{k | M | G | T | P}
如果指定,则 OneFS 不会将大于指定大小的文件发送给 ICAP 服务器进行扫描。
注: 虽然参数接受大于 2GB 的值,但是 OneFS 不扫描大于 2GB 的文件。

--service {true | false}


确定防病毒服务是否正在运行。

46 OneFS isi 命令 A 至 C
--quarantine {true | false}
确定 OneFS 是否隔离在其中检测到威胁的文件。如果 --repair 设置为 true,OneFS 将尝试先修复
再隔离文件。如果 --truncate 和 --quarantine 都设置为 true,--truncate 选项将被忽略。
--truncate {true | false}
确定 OneFS 是否截断在其中检测到威胁的文件。如果 --repair 设置为 true,OneFS 将尝试先修复
再截断文件。如果 --truncate 和 --quarantine 都设置为 true,--truncate 选项将被忽略。
{--verbose | -v}
将显示一条消息,确认这些设置已修改。

isi antivirus icap settings view


显示 ICAP 防病毒设置。

语法
isi antivirus icap settings view

选项
此命令没有选项。

isi antivirus icap servers create


添加并连接到 ICAP 服务器。

语法
isi antivirus icap servers create <url>
[--description <string>]
[--enabled {yes | no}]
[--verbose]

选项
<URL>
指定的 ICAP 服务器的 URL。
--description <string>
指定策略的可选描述。
{--enabled | -n} {yes | no}
确定是否启用 ICAP 服务器。
{--verbose | -v}
将显示一条消息,确认服务器已添加。

OneFS isi 命令 A 至 C 47
isi antivirus icap servers delete
删除 ICAP 防病毒服务器。

语法
isi antivirus icap servers delete {<url> | --all}
[--verbose]
[--force]

选项
<URL>
删除指定的 ICAP 防病毒服务器。
--all
删除所有 ICAP 防病毒服务器。
{--verbose | -v}
将显示一条消息,确认 OneFS 已从 ICAP 服务器断开连接。
{--force | -f}
不会显示确认提示。

isi antivirus icap servers list


显示 OneFS 前连接到的 ICAP 防病毒服务器的列表。

语法
isi antivirus icap servers list
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort < 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

url 按服务器的 URL 对输出进行排序。


description 按服务器的描述对输出进行排序。
enabled 按服务器的状态对输出进行排序。

{--descending | -d}
以相反的顺序显示输出。

48 OneFS isi 命令 A 至 C
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi antivirus icap servers view


显示有关 ICAP 服务器的信息。

语法
isi antivirus icap servers view <url>

选项
<URL>
显示有关指定 ICAP 服务器的信息。

isi antivirus icap servers modify


修改 ICAP 服务器的设置。

语法
isi antivirus icap servers modify <url>
[--enabled {yes | no}]
[--description <string>]
[--verbose]

选项
<URL>
指定的 ICAP 服务器的 URL。
--description < 字符串 >
指定策略的可选描述。
{--enabled | -n} {yes | no}
确定是否启用 ICAP 服务器。
{--verbose | -v}
将显示一条消息,确认服务器已添加。

OneFS isi 命令 A 至 C 49
isi antivirus quarantine
手动隔离文件。无法读取或写入隔离的文件。

语法
isi antivirus quarantine <file>
[--verbose]

选项
<file>
隔离指定文件。在 /ifs 文件系统中指定为绝对文件路径。
{--verbose | -v}
将显示一条消息,确认文件已隔离。

isi antivirus release


从隔离中删除文件。无法读取或写入隔离的文件。

语法
isi antivirus release <file>
[--verbose]

选项
<file>
从隔离中删除指定文件。在 /ifs 文件系统中指定为文件路径。
{--verbose | -v}
将显示一条消息,确认文件已消除隔离。

isi antivirus reports delete


删除防病毒报告。

语法
isi antivirus reports delete {< 扫描 ID> | --all}
[--age < 整数 >< 时间 >]
[--verbose]
[--force]

选项
<扫描 ID>
删除具有指定 ID 的防病毒报告。

50 OneFS isi 命令 A 至 C
--all
删除所有防病毒报告。
--age< 整数 >< 时间 >
删超过指定期限的所有报告。
以下 < 时间 > 值有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

{--verbose | -v}
显示一条消息,确认这些报告已删除。
{--force | -f}
不会显示确认提示。

isi antivirus reports scans list


显示有关最近防病毒扫描的信息。

语法
isi antivirus reports scans list
[--policy-id <string>]
[--status <status>]
[--limit <integer>]
[--offset <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--policy-id < 字符串 >
根据策略的 ID 筛选输出。
--status < 状态 >
根据扫描作业的当前状态筛选输出。
以下值有效:

Finish 仅显示已完成的作业。
Succeeded 仅显示已成功完成的作业。
Failed 仅显示失败的作业。
Cancelled 仅显示取消的作业。
Started 仅显示正在运行的作业。
Paused 仅显示已暂停的作业。

OneFS isi 命令 A 至 C 51
Resumed 仅显示已暂停、然后恢复的作业。
Pending 仅显示待处理的作业。

{--limit | -l} < 整数 >


显示不超过指定的项目数。
{--offset | -o} < 整数 >
指定要从扫描报告开头绕过的条目数。
--sort < 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

id 按防病毒报告的 ID 对输出进行排序。
policy_id 按创建报告的策略 ID 对输出进行排序。
status 按防病毒扫描的状态对输出进行排序。
start 按防病毒扫描的启动时间对输出进行排序。
files 按防病毒扫描已扫描的文件数对输出进行排序。
infections 按防病毒扫描检测到的威胁数对输出进行排序。

{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi antivirus reports scans view


显示防病毒报告。

语法
isi antivirus reports scans view <ID>

选项
<ID>
显示具有指定 ID 的防病毒报告。

52 OneFS isi 命令 A 至 C
isi antivirus reports threats list
列出防病毒威胁报告。

语法
isi antivirus reports threats list
[--scan-id <string>]
[--file <string>]
[--remediation <string>]
[--limit <integer>]
[--offset <integer>]
[--sort {scan_id | file | remediation | threat | time}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--scan-id < 字符串 >
扫描报告的唯一标识符。
--file < 字符串 >
包含威胁报告的文件名。
--remediation < 字符串 >
修正威胁所采取的措施的说明。
{--limit | -l} < 整数 >
要显示的防病毒威胁的最大数量。
{--offset | -o} < 整数 >
要从开头跳过的威胁报告条目的数量。
--sort < 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

scan-id 威胁报告扫描的唯一标识符。
file 包含威胁的文件。
remediation 为缓解威胁而采取的措施。
threat 按特定威胁进行排序。
time 按威胁时间进行排序。

{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 53
isi antivirus reports threats view
显示有关检测到的威胁的信息。

语法
isi antivirus reports threats view <ID>

选项
<ID>
显示有关具有指定 ID 的威胁的信息。

isi antivirus scan


手动对文件进行病毒扫描。

语法
isi antivirus scan <file>
[--policy <id>]
[--report-id <id>]
[--ignore-previous-scan-status {yes | no}]

选项
<file>
扫描指定文件。
{--policy | -p} <id>(仅限 ICAP)
为此扫描分配策略 ID。默认 ID 为 MANUAL。
--report-id <ID>
将指定 ID 分配给为此防病毒扫描生成的报告。如果未指定 ID,OneFS 将自动分配一个。
{ --ignore-previous-scan-status} {true | false}(仅限 ICAP)
强制执行扫描(即使与 ICAP 策略冲突)。如果强制进行扫描,则扫描所有文件(无论 OneFS 是否将文
件标记为已扫描,也无论全局设置是否指定不应扫描某些文件)。

isi antivirus status


显示有关文件扫描状态的信息。

语法
isi antivirus status <file>

54 OneFS isi 命令 A 至 C
选项
<file>
显示有关指定文件的信息。指定文件的完整路径名。文件必须在 /ifs 文件系统内。
{--verbose | -v}
显示更多详细信息。

isi audit progress global view


显示群集的最新协议审核事件日志时间。它还显示群集中到 CEE 服务器的最旧未发送协议审核事件的时间以及到系统日志的最
旧非转发协议审核事件的时间。

语法
isi audit progress global view

OneFS 显示群集审核事件的日志时间。

isi audit progress view


针对当前节点显示协议审核事件到 CEE 服务器和系统日志的传送进度。这是默认视图。还可以指定逻辑节点编号以查看当前节
点的协议审核事件的传送进度。

语法
isi audit progress view
[--lnn <integer>]

选项
--lnn< 整数 >
显示协议审核事件到 CEE 服务器和系统日志的传送进度的逻辑节点编号视图。该视图包括最后捕获的协
议审核事件的时间戳以及发送到与节点对应的 CEE 服务器和系统日志的最后一个事件的时间戳。
以下命令针对当前节点显示协议审核事件到 CEE 服务器和系统日志的传送进度:

isi audit progress view

OneFS 显示进度报告。
以下命令显示协议审核事件到 CEE 服务器和系统日志的传送进度的逻辑节点编号视图:

isi audit progress view --lnn=2

OneFS 按逻辑节点编号视图显示进度报告。

OneFS isi 命令 A 至 C 55
isi audit settings global modify
启用或禁用全局审核配置更改和协议访问,并在群集上配置其他协议审核设置。

语法
isi audit settings global modify
[--protocol-auditing-enabled {yes | no}]
[--audited-zones <zones>]
[--clear-audited-zones]
[--add-audited-zones <zones>]
[--remove-audited-zones <zones>]
[--cee-server-uris <uris>]
[--clear-cee-server-uris]
[--add-cee-server-uris <uris>]
[--remove-cee-server-uris <uris>]
[--hostname <string>]
[--config-auditing-enabled {yes | no}]
[--config-syslog-enabled {yes | no}]
[--cee-log-time <string>]
[--syslog-log-time <string>]
[--config-syslog-servers <string>]
[--clear-config-syslog-servers]
[--add-config-syslog-servers <string>]
[--remove-config-syslog-servers <string>]
[--protocol-syslog-servers <string>]
[--clear-protocol-syslog-servers]
[--add-protocol-syslog-servers <string>]
[--remove-protocol-syslog-servers <string>
[--verbose]

选项
--protocol-auditing-enabled {yes | no}
启用或禁用通过 SMB、NFS 和 HDFS 协议的数据访问请求审核。
--audited-zones < 访问分区 >
指定在启用协议审核的情况下要审核的一个或多个访问分区(以逗号分隔)。此选项会覆盖访问分区列
表中的所有条目;要在不影响当前条目的情况下添加或删除访问分区,请使用 --add-audited-
zones 或 --remove-audited-zones。
--clear-audited-zones
如果启用协议审核,清除要审核的访问分区的完整列表。
--add-audited-zones < 访问分区 >
在启用了协议审核的情况下向要审核的分区列表添加一个或多个访问分区(以逗号分隔)。
--remove-audited-zones < 访问分区 >
在启用协议审核的情况下删除一个或多个要审核的访问分区(以逗号分隔)。
--cee-server-uris <URI>
指定在启用了协议审核的情况下要转发审核日志的一个或多个 CEE 服务器 URI(以逗号分隔)。将事件
导出到多个 CEE 服务器时,OneFS CEE 导出服务使用循环调度负载平衡。此选项将覆盖 CEE 服务器
URI 列表中的所有条目。要添加或删除 URI 而不影响当前条目,请使用 --add-cee-server-uris 或
--remove-cee-server-uris。
--clear-cee-server-uris
如果启用协议审核,清除要向其转发审核日志的 CEE 服务器 URI 的完整列表。
--add-cee-server-uris <URI>
将一个或多个 CEE 服务器 URI(以逗号分隔)添加到启用协议审核时要将审核日志转发到的 URI 列表。
--remove-cee-server-uris <URI>

56 OneFS isi 命令 A 至 C
在启用了协议审核的情况下从要转发审核日志的 URI 列表中删除一个或多个 CEE 服务器 URI(以逗号分
隔)。
--hostname < 字符串 >
指定转发协议事件时使用的存储群集的名称,通常是 SmartConnect 分区名称。如果不实施
SmartConnect,则该值必须与群集的主机名匹配,以便第三方审核应用程序能够识别。如果将该字段留
空,则用节点名称填充每个节点的事件(群集名称 + LNN)。仅当第三方审核应用程序需要时,才需要
此设置。
--config-auditing-enabled {yes | no}
启用或禁用对通过 API 发送的系统配置更改请求的审核。
--config-syslog-enabled {yes | no}
启用或禁用将系统配置更改转发到系统日志。
--cee-log-time <date>
指定审核 CEE 转发程序将转发协议访问日志的最终日期。采用以下格式指定 < 日期 >:

[protocol]@<YYYY>-<MM>-<DD> <HH>:<MM>:<SS>

--syslog-log-time <date>
指定审核系统日志转发程序将转发日志的最终日期。要转发 SMB、NFS 和 HDFS 流量日志,请指定
protocol。要转发配置更改日志,请指定 config。采用以下格式指定 < 日期 >:

[protocol|config]@<YYYY>-<MM>-<DD> <HH>:<MM>:<SS>

--config-syslog-servers < 字符串 >


指定要将审核配置更改日志转发到的远程服务器的列表。您必须为要将审核配置更改日志转发到的每个
服务器指定 --config-syslog-servers。
--clear-config-syslog-servers
清除要将审核配置更改日志转发到以在系统日志中记录的远程服务器列表。
--add-config-syslog-servers < 字符串 >
将服务器添加到要将审核配置更改日志转发到以在系统日志中记录的远程服务器列表。您必须为每个要
添加的附加服务器指定 --add-config-syslog-servers 选项。
--remove-config-syslog-servers < 字符串 >
从要将审核配置更改日志转发到以在系统日志中记录的远程服务器列表中删除服务器。您必须为每个要
删除的服务器指定 --remove-config-syslog-servers 选项。
--protocol-syslog-servers < 字符串 >
指定要将审核协议日志转发到的远程服务器列表。您必须为每个要删除的服务器指定 --protocol-
syslog-servers 选项。
--clear-protocol-syslog-servers
清除要将审核协议日志转发到以在系统日志中记录的远程服务器列表。
--add-protocol-syslog-servers < 字符串 >
将服务器添加到要将审核协议日志转发到以在系统日志中记录的远程服务器列表。您必须为每个要添加
的服务器指定 --add-protocol-syslog-servers 选项。
--remove-protocol-syslog-servers < 字符串 >
从要将审核协议日志转发到以在系统日志中记录的远程服务器列表中删除服务器。您必须为每个要删除
的服务器指定 --remove-protocol-syslog-servers 选项。
{--verbose | -v}
显示运行命令的结果。

OneFS isi 命令 A 至 C 57
isi audit settings global view
显示在群集上配置的全局审核设置。

语法
isi audit settings global view

选项
此命令没有选项。

示例
以下命令会显示在群集上配置的审核设置:

isi audit settings global view

系统将显示与以下文本类似的输出:

Protocol Auditing Enabled: Yes


Audited Zones: System, zoneA
CEE Server URIs: http://example.com:12228/cee
Hostname: mycluster
Config Auditing Enabled: Yes
Config Syslog Enabled: Yes

isi audit settings modify


让您可在访问分区内为在访问分区中失败或成功的协议事件类型设置筛选器,以及指定要转发到系统日志的事件类型。

语法
isi audit settings modify
[--audit-failure <event types>]
[--clear-audit-failure]
[--add-audit-failure <event types>]
[--remove-audit-failure <event types>]
[--audit-success <event types>]
[--clear-audit-success]
[--add-audit-success <event types>]
[--remove-audit-success <event types>]
[--syslog-audit-events <event types>]
[--clear-syslog-audit-events]
[--add-syslog-audit-events <event types>]
[--remove-syslog-audit-events <event types>]
[--syslog-forwarding-enabled {yes | no}]
[--zone<access zone>]
[--verbose]

选项
--audit-failure< 事件类型 >
为失败的审核协议事件类型指定一个或多个筛选器(以逗号分隔)。以下事件类型有效:

58 OneFS isi 命令 A 至 C
● close
● create
● delete
● get_security
● logoff
● logon
● read
● rename
● set_security
● tree_connect
● write
● all
此选项覆盖筛选事件类型的当前列表。要添加或删除筛选器而不影响当前列表,请使用 --add-audit-
failure 或 --remove-audit-failure 配置设置。
--clear-audit-failure
为失败的审核协议事件类型清除所有筛选器。
--add-audit-failure< 事件类型 >
为失败的审核协议事件类型添加一个或多个筛选器(以逗号分隔)。有效事件类型值与 --audit-
failure 相同。
--remove-audit-failure< 事件类型 >
为失败的审核协议事件类型删除一个或多个筛选器(以逗号分隔)。有效事件类型值与 --audit-
failure 相同。
--audit-success< 事件类型 >
为成功的审核协议事件类型指定一个或多个筛选器(以逗号分隔)。以下事件类型有效:
● close
● create
● delete
● get_security
● logoff
● logon
● read
● rename
● set_security
● tree_connect
● write
● all
此选项覆盖筛选事件类型的当前列表。要添加或删除筛选器而不影响当前列表,请使用 --add-audit-
success 或 --remove-audit-success 配置设置。
--clear-audit-success
为成功的审核协议事件类型清除所有筛选器。
--add-audit-success< 事件类型 >
为成功的审核协议事件类型添加一个或多个筛选器(以逗号分隔)。有效事件类型值与 --audit-
success 相同。
--remove-audit-success< 事件类型 >
为成功的审核协议事件类型删除一个或多个筛选器(以逗号分隔)。有效事件类型值与 --audit-
success 相同。
--syslog-audit-events< 事件类型 >
指定要转发到系统日志的审核协议事件类型。只有同时与 syslog-audit-events 和 --audit-
success 或 --audit-failure 匹配的那些事件才会转发到系统日志。以下事件类型有效:
● close
● create
● delete
● get_security
● logoff

OneFS isi 命令 A 至 C 59
● logon
● read
● rename
● set_security
● tree_connect
● write
● all
此选项覆盖转发事件类型的当前列表。要添加或删除事件类型而不影响当前列表,请使用 --add-
syslog-audit-events 或 --remove-syslog-audit-events 配置设置。
--clear-syslog-audit-events
清除将转发到系统日志的所有审核协议事件类型。
--add-syslog-audit-events< 事件类型 >
添加将转发到系统日志的一个或多个审核协议事件类型(以逗号分隔)。有效事件类型值与 --
syslog-audit-events 相同。
--remove-syslog-audit-events< 事件类型 >
删除将转发到系统日志的一个或多个审核协议事件类型(以逗号分隔)。有效事件类型值与 --
syslog-audit-events 相同。
--syslog-forwarding-enabled {yes | no}
在指定访问分区中启用或禁用系统日志转发审核事件。
--zone< 访问分区 >
指定要应用事件类型筛选器或转发到系统日志的访问分区。
{--verbose | -v}
显示运行命令的结果。

注: 每个审核的事件都会消耗系统资源;只能记录审核应用程序支持的事件。

isi audit settings view


显示访问分区中的审核筛选器设置以及是否启用系统日志转发。

语法
isi audit settings view
[--zone<access zone>]

选项
--zone< 访问分区 >
指定要查看的访问分区的名称。

示例
以下命令将显示 zoneA 访问分区中配置的审核设置:

isi audit settings view --zone=zoneA

系统将显示与以下文本类似的输出:

Audit Failure: create, delete, rename, set_security, close


Audit Success: create, delete, rename, set_security, close

60 OneFS isi 命令 A 至 C
Syslog Audit Events: close
Syslog Forwarding Enabled: No

isi audit topics list


显示已配置审核主题的列表,这些主题是审核数据的内部集合。

语法
isi audit topics list
[--limit < 整数 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi audit topics modify


修改审核主题的属性。

语法
isi audit topics modify < 名称 >
[--max-cached-messages < 整数 >]
[--verbose]

选项
< 名称 >
指定要修改的审核主题的名称。有效值为 protocol 和 config。
--max-cached-messages< 整数 >
指定在将审核消息写入永久存储之前要缓存的审核消息的最大数量。数量越大,便可以越高效地处理审
核事件。如果指定 0,将同步发送每个审核事件。
{--verbose | -v}

OneFS isi 命令 A 至 C 61
显示运行命令的结果。

isi audit topics view


显示审核主题的属性。

语法
isi audit topics view < 名称 >

选项
< 名称 >
指定要查看其属性的审核主题的名称。有效值为 protocol 和 config。

isi auth access


列出用户访问给定文件或目录所具备的权限。

语法
isi auth access {<user> | --uid <integer> | --sid <string>} <path>
[--zone <string>]
[--share <string>]
[--numeric]
[--verbose]

选项
< 用户 >
指定用户名。
--sid< 字符串 >
按 SID 指定用户。
--uid< 整数 >
按 UID 指定用户
< 路径 >
指定 /ifs 下文件或目录的路径。
--zone< 字符串 >
指定访问分区。
--share< 字符串 >
指定为其报告共享配置和文件/目录访问信息的 SMB 共享名称。
{--numeric | -n}
显示用户的数字标识符。
{--verbose | -v}
显示更多详细信息。

62 OneFS isi 命令 A 至 C
isi auth ads create
配置 Active Directory 提供程序并加入 Active Directory 域。

语法
isi auth ads create <name> <user>
[--machine-account <string>]
[--instance <string>]
[--password <string>]
[--organizational-unit <string>]
[--kerberos-nfs-spn {yes | no} ]
[--kerberos-hdfs-spn {yes | no} ]
[--dns-domain <dns-domain>]
[--groupnet <groupnet>]
[--allocate-gids {yes | no}]
[--allocate-uids {yes | no}]
[--assume-default-domain {yes | no}]
[--check-online-interval <duration>]
[--create-home-directory {yes | no}]
[--domain-offline-alerts {yes | no}]
[--findable-groups <string>...]
[--findable-users <string>...]
[--home-directory-template <path>]
[--ignore-all-trusts {yes | no}]
[--ignored-trusted-domains <dns-domain>...]
[--include-trusted-domains <dns-domain>...]
[--ldap-sign-and-seal {yes | no}]
[--login-shell <path>]
[--lookup-domains <dns-domain>...]
[--lookup-groups {yes | no}]
[--lookup-normalize-groups {yes | no}]
[--lookup-normalize-users {yes | no}]
[--lookup-users {yes | no}]
[--machine-password-changes {yes | no}]
[--machine-password-lifespan <duration>]
[--node-dc-affinity <string>]
[--node-dc-affinity-timeout <timestamp>]
[--nss-enumeration {yes | no}]
[--restrict-findable {yes | no}]
[--sfu-support {none | rfc2307}]
[--store-sfu-mappings {yes | no}]
[--unfindable-groups <string>...]
[--unfindable-users <string>...]
[--verbose]

选项
< 名称 >
指定可解析为 IPv4 或 IPv6 地址的完全限定的 Active Directory 域名。域名也用作提供程序名称。
< 用户 >
指定有权将计算机帐户加入 Active Directory 域的帐户的用户名。
--machine-account < 字符串 >
Active Directory 使用的计算机帐户名称。默认值为群集名称。
--instance < 字符串 >
为此实例设置 Active Directory 名称。
--password < 字符串 >
指定提供程序用户帐户的密码。如果忽略此选项,系统将提示您提供密码。
--organizational-unit < 字符串 >

OneFS isi 命令 A 至 C 63
指定要连接到 Active Directory 服务器的组织单位 (OU) 的名称。按以下格式指定 OU:OuName 或
OuName1/SubName2。
--kerberos-nfs-spn {yes | no}
指定是否添加 SPN 以使用 Kerberized NFS。
--kerberos-hdfs-spn {yes | no}
指定是否添加 SPN 以使用 Kerberized HDFS。
--dns-domain <DNS 域 >
指定要使用的 DNS 搜索域,而不是在 --name 设置中指定的域。
--groupnet <groupnet>
指定 Active Directory 提供程序引用的 groupnet。groupnet 是顶层网络容器,用于管理针对 DNS 名称服
务器的主机名解析且包含子网和 IP 地址池。groupnet 指定与外部服务器通信时 Active Directory 提供程
序将使用的网络属性。
--allocate-gids {yes | no}
对未映射的 Active Directory 组启用或禁用 GID 分配。ID 映射程序可以主动向没有 GID 的 Active
Directory 组分配 GID。如果禁用此选项,将不会主动分配 GID,但如果用户的主组不包括 GID,系统可
以分配一个。
--allocate-uids {yes | no}
对未映射的 Active Directory 用户启用或禁用 UID 分配。ID 映射程序可以主动向没有 UID 的 Active
Directory 用户分配 UID。如果禁用此选项,将不会主动分配 UID,但如果用户的身份不包括 UID,系统
可能会分配一个。
--assume-default-domain {yes | no}
支持在主域中查找非限定的用户名。
--check-online-interval < 持续时间 >
指定提供程序执行在线检查的间隔时间,格式为 < 整数 >{Y|M|W|D|H|m|s}。
--create-home-directory {yes | no}
指定是否在用户首次登录时创建主目录(如果尚不存在用户的主目录)。
--domain-offline-alerts {yes | no}
指定是否在域离线时发送警报。如果将此选项设置为 yes,则按照全局通知规则中的指定发送通知。默
认值为 no。
--findable-groups < 字符串 >...
指定此身份认证提供程序可解析的组的列表。重复此选项可指定多个列表项。
--findable-users < 字符串 >...
指定此身份认证提供程序可解析的用户的列表。重复此选项可指定多个列表项。
--home-directory-template < 路径 >
指定要在创建主目录时使用的模板路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符
序列将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户
名、提供程序域名和分区名称。有关更多信息,请参见“主目录”部分。
注: 如果您将 Active Directory 与 Services for UNIX (SFU) 结合使用,则 Windows 创建的目录名称
中的空格会转换成下划线以便实现 UNIX 兼容性。

--ignore-all-trusts {yes | no}


指定是否忽略所有受信任域。
--ignored-trusted-domains <DNS 域 >...
如果禁用 --ignore-all-trusts,则指定要忽略的受信任域的列表。重复此选项可指定多个列表
项。
--include-trusted-domains <DNS 域 >...
指定在启用 --ignore-all-trusts 的情况下要包括的受信任域列表。重复此选项可指定多个列表
项。
--ldap-sign-and-seal {yes | no}
指定是否对针对域控制器的 LDAP 请求使用加密和签名。
--login-shell < 路径 >
指定在 Active Directory 服务器不提供登录 Shell 信息的情况下要使用的登录 Shell 的完整路径。此设置
仅适用于通过 SSH 访问文件系统的用户。

64 OneFS isi 命令 A 至 C
--lookup-domains < 字符串 >...
指定将用户和组查找限制到的域的列表。重复此选项可指定多个列表项。
--lookup-groups {yes | no}
指定在分配 GID 之前是否在其他提供程序中查找 Active Directory 组。
--lookup-normalize-groups {yes | no}
指定在查找 Active Directory 组名称之前是否将它们规范化为小写。
--lookup-normalize-users {yes | no}
指定在查找 Active Directory 用户名之前是否将它们规范化为小写。
--lookup-users {yes | no}
指定在分配 UID 之前是否在其他提供程序中查找 Active Directory 用户。
--machine-password-changes {yes | no}
指定是否出于安全目的启用计算机帐户密码的定期更改。
--machine-password-lifespan < 持续时间 >
设置计算机帐户密码的最长期限,格式为 < 整数 >{Y|M|W|D|H|m|s}。
{--node-dc-affinity | -x} < 字符串 >
指定节点应以独占模式与之通信(建立关联)的域控制器。此选项应与使用 --node-dc-affinity-
timeout 选项配置的超时值配合使用。否则,将指定 30 分钟的默认超时值。

注: 此设置用于调试目的,在普通操作期间不应配置此设置。要禁用此功能,请使用超时值 0。

{--node-dc-affinity-timeout} < 时间戳 >


使用日期格式 <YYYY>-<MM>-<DD> 或日期/时间格式 <YYYY>-<MM>-<DD>T<hh>:<mm>[:<ss>] 为关
联到域控制器的本地节点指定超时设置。
注: 值为 0 时禁用关联。禁用关联时,可能不会立即结束与指定域控制器之间的通信。它可能会持续
到可以选择其他域控制器。

--nss-enumeration {yes | no}


指定是否允许 Active Directory 提供程序响应 getpwent 和 getgrent 请求。
--restrict-findable {yes | no}
指定是否检查身份认证提供程序,以查看可查找和不可查找用户和组的筛选列表。
--sfu-support {none | rfc2307}
指定是否支持针对 Windows 域控制器的 RFC 2307 属性。Windows UNIX 集成和 Services For UNIX
(SFU) 技术需要 RFC 2307。
--store-sfu-mappings {yes | no}
指定是否在 ID 映射程序中永久存储 SFU 映射。
--unfindable-groups < 字符串 >...
指定此身份认证提供程序无法解析的组的列表。重复此选项可指定多个列表项。
--unfindable-users < 字符串 >...
指定此身份认证提供程序无法解析的用户的列表。重复此选项可指定多个列表项。
{--verbose | -v}
显示运行命令的结果。

OneFS isi 命令 A 至 C 65
isi auth ads delete
删除 Active Directory 提供程序,包括离开提供程序所加入的 Active Directory 域。 离开 Active Directory 域将中断向正在访问
域的用户提供服务。 离开 Active Directory 域后,用户便不能再从群集访问域。

语法
isi auth ads delete <provider-name>
[--force]
[--verbose]

选项
< 提供程序名称 >
指定要删除的提供程序的名称。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示运行命令的结果。

示例
要离开名为 some.domain.org 的 Active Directory 域并删除与之关联的身份认证提供程序,请运行以下命令:

isi auth ads delete some.domain.org

在确认提示符下,键入 y。

isi auth ads list


显示 Active Directory 提供程序的列表。

语法
isi auth ads list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}

66 OneFS isi 命令 A 至 C
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
要查看群集连接到的所有 Active Directory 提供程序的列表,请运行以下命令:

isi auth ads list

系统将显示身份验证提供程序的列表。

isi auth ads modify


修改 Active Directory 身份认证提供程序。

语法
isi auth ads modify <provider-name>
[--reset-schannel {yes | no}]
[--domain-controller <string>]
[--authentication {yes | no}]
[--allocate-gids {yes | no}]
[--allocate-uids {yes | no}]
[--assume-default-domain {yes | no}]
[--check-online-interval <duration>]
[--create-home-directory {yes | no}]
[--domain-offline-alerts {yes | no}]
[--findable-groups <string>...]
[--clear-findable-groups]
[--add-findable-groups <string>...]
[--remove-findable-groups <string>...]
[--findable-users <string>...]
[--clear-findable-users]
[--add-findable-users <string>...]
[--remove-findable-users <string>...]
[--home-directory-template <path>]
[--ignore-all-trusts {yes | no}]
[--ignored-trusted-domains <dns-domain>]
[--clear-ignored-trusted-domains]
[--add-ignored-trusted-domains <dns-domain>]
[--remove-ignored-trusted-domains <dns-domain>]
[--include-trusted-domains <dns-domain>]
[--clear-include-trusted-domains]
[--add-include-trusted-domains <dns-domain>]
[--remove-include-trusted-domains <dns-domain>]
[--ldap-sign-and-seal {yes | no}]
[--login-shell <path>]
[--lookup-domains <dns-domain>]
[--clear-lookup-domains]
[--add-lookup-domains <dns-domain>]
[--remove-lookup-domains <dns-domain>]
[--lookup-groups {yes | no}]
[--lookup-normalize-groups {yes | no}]
[--lookup-normalize-users {yes | no}]
[--lookup-users {yes | no}]
[--machine-password-changes {yes | no}]
[--machine-password-lifespan <duration>]
[--node-dc-affinity <string>]
[--node-dc-affinity-timeout <timestamp>]
[--nss-enumeration {yes | no}]
[--restrict-findable {yes | no}]
[--sfu-support {none | rfc2307}]
[--store-sfu-mappings {yes | no}]

OneFS isi 命令 A 至 C 67
[--unfindable-groups <string>...]
[--clear-unfindable-groups]
[--add-unfindable-groups <string>...]
[--remove-unfindable-groups <string>...]
[--unfindable-users <string>...]
[--clear-unfindable-users]
[--add-unfindable-users <string>...]
[--remove-unfindable-users <string>...]
[--verbose]

选项
< 提供程序名称 >
指定 Active Directory 提供程序加入的域名(也是 Active Directory 提供程序名称)。
--reset-schannel {yes | no}
将安全通道重置为主域。
--domain-controller <DNS 域 >
指定域控制器。
--authentication {yes | no}
启用将提供程序用于身份验证以及身份。
--allocate-gids {yes | no}
对未映射的 Active Directory 组启用或禁用 GID 分配。ID 映射程序可以主动向没有 GID 的 Active
Directory 组分配 GID。如果禁用此选项,则不主动分配 GID,但是当用户的主组不包含 GID 时,系统可
以分配一个 GID。
--allocate-uids {yes | no}
对未映射的 Active Directory 用户启用或禁用 UID 分配。ID 映射程序可以主动向没有 UID 的 Active
Directory 用户分配 UID。如果禁用此选项,则不主动分配 UID,但是当用户身份不包含 UID 时,系统可
以分配一个 UID。
--assume-default-domain {yes | no}
支持在主域中查找非限定的用户名。
--check-online-interval < 持续时间 >
指定提供程序执行在线检查的间隔时间,格式为 < 整数 >{Y|M|W|D|H|m|s}。
--create-home-directory {yes | no}
指定是否在用户首次登录时创建主目录(如果尚不存在用户的主目录)。
--domain-offline-alerts {yes | no}
指定是否在域离线时发送警报。如果将此选项设置为 yes,则按照全局通知规则中的指定发送通知。默
认值为 no。
--findable-groups < 字符串 >...
指定此身份认证提供程序可解析的组的列表。重复此选项可指定多个列表项。
--clear-findable-groups
从可查找组列表中删除所有条目。
--add-findable-groups < 字符串 >...
添加一个条目到此身份认证提供程序可解析的组的列表。重复此选项可指定多个列表项。
--remove-findable-groups < 字符串 >...
从此身份认证提供程序可解析的组的列表中删除一个条目。重复此选项可指定多个列表项。
--findable-users < 字符串 >...
指定此身份认证提供程序可解析的用户的列表。重复此选项可指定多个列表项。
--clear-findable-users
从可查找用户列表中删除所有条目。
--add-findable-users < 字符串 >...
添加一个条目到此身份认证提供程序可解析的用户的列表。重复此选项可指定多个列表项。
--remove-findable-users < 字符串 >...

68 OneFS isi 命令 A 至 C
从此身份认证提供程序可解析的用户的列表中删除一个条目。重复此选项可指定多个列表项。
--home-directory-template < 路径 >
指定要在创建主目录时使用的模板路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符
序列将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户
名、提供程序域名和分区名称。有关更多信息,请参见“主目录”部分。
注: 如果您将 Active Directory 与 Services for UNIX (SFU) 结合使用,则 Windows 创建的目录名称
中的空格会转换成下划线以便实现 UNIX 兼容性。

--ignore-all-trusts {yes | no}


指定是否忽略所有受信任域。
--ignored-trusted-domains <DNS 域 >
如果禁用 --ignore-all-trusts,则指定要忽略的受信任域的列表。重复此选项可指定多个列表
项。
--clear-ignored-trusted-domains
如果禁用 --ignore-all-trusts,则清除已忽略的受信任域的列表。
--add-ignored-trusted-domains <DNS 域 >
如果禁用 --ignore-all-trusts,则向要忽略的受信任域的列表添加域。重复此选项可指定多个列
表项。
--remove-ignored-trusted-domains <DNS 域 >
如果禁用 --ignore-all-trusts,则从要忽略的受信任域的列表中删除指定域。重复此选项可指定
多个列表项。
--include-trusted-domains <DNS 域 >
如果启用 --ignore-all-trusts,则指定要包含的受信任域的列表。重复此选项可指定多个列表
项。
--clear-include-trusted-domains
如果启用 --ignore-all-trusts,则清除要包含的受信任域的列表。
--add-include-trusted-domains <DNS 域 >
如果启用 --ignore-all-trusts,则向要包含的受信任域的列表添加域。重复此选项可指定多个列
表项。
--remove-include-trusted-domains <DNS 域 >
如果启用 --ignore-all-trusts,则从要包含的受信任域的列表中删除指定域。重复此选项可指定
多个列表项。
--ldap-sign-and-seal {yes | no}
指定是否对针对域控制器的 LDAP 请求使用加密和签名。
--login-shell < 路径 >
如果 Active Directory 服务器未提供登录 Shell 信息,则指定要使用的登录 Shell 的路径。此设置仅适用
于通过 SSH 访问文件系统的用户。
--lookup-domains < 字符串 >
指定将用户和组查找限制到的域的列表。重复此选项可指定多个列表项。
--clear-lookup-domains
清除用户和组查找的受限域的列表。
--add-lookup-domains < 字符串 >
向用于用户和组查找的受限域列表添加条目。重复此选项可指定多个列表项。
--remove-lookup-domains < 字符串 >
从用于用户和组查找的域列表中删除条目。重复此选项可指定多个列表项。
--lookup-groups {yes | no}
指定在分配 GID 之前是否在其他提供程序中查找 Active Directory 组。
--lookup-normalize-groups {yes | no}
指定在查找 Active Directory 组名称之前是否将它们规范化为小写。
--lookup-normalize-users {yes | no}
指定在查找 Active Directory 用户名之前是否将它们规范化为小写。
--lookup-users {yes | no}

OneFS isi 命令 A 至 C 69
指定在分配 UID 之前是否在其他提供程序中查找 Active Directory 用户。
--machine-password-changes {yes | no}
指定是否出于安全目的启用计算机帐户密码的定期更改。
--machine-password-lifespan < 持续时间 >
设置计算机帐户密码的最长期限,格式为 < 整数 >{Y|M|W|D|H|m|s}。
{--node-dc-affinity | -x} < 字符串 >
指定节点应以独占方式进行通信(关联)的域控制器。此选项应与使用 --node-dc-affinity-
timeout 选项配置的超时值配合使用。否则,将指定 30 分钟的默认超时值。

注: 此设置用于调试目的,在普通操作期间不应配置此设置。要禁用此功能,请使用超时值 0。

{--node-dc-affinity-timeout} < 时间戳 >


使用日期格式 <YYYY>-<MM>-<DD> 或日期/时间格式 <YYYY>-<MM>-<DD>T<hh>:<mm>[:<ss>] 为关
联到域控制器的本地节点指定超时设置。
注: 值为 0 时禁用关联。禁用关联时,可能不会立即结束与指定域控制器之间的通信。它可能会持续
到可以选择其他域控制器。

--nss-enumeration {yes | no}


指定是否允许 Active Directory 提供程序响应 getpwent 和 getgrent 请求。
--restrict-findable {yes | no}
指定是否检查身份认证提供程序,以查看可查找和不可查找用户和组的筛选列表。
--sfu-support {none | rfc2307}
指定是否对域控制器支持 RFC 2307 属性。Windows UNIX 集成和 Services For UNIX (SFU) 技术需要
RFC 2307。
--store-sfu-mappings {yes | no}
指定是否在 ID 映射程序中永久存储 SFU 映射。
--unfindable-groups < 字符串 >...
指定此身份认证提供程序无法解析的组的列表。重复此选项可指定多个列表项。
--clear-unfindable-groups
从不可查找组列表中删除所有条目。
--add-unfindable-groups < 字符串 >...
添加一个条目到此身份认证提供程序无法解析的组的列表。重复此选项可指定多个列表项。
--remove-unfindable-groups < 字符串 >...
从此身份认证提供程序无法解析的组的列表中删除一个条目。重复此选项可指定多个列表项。
--unfindable-users < 字符串 >...
指定此身份认证提供程序无法解析的用户的列表。重复此选项可指定多个列表项。
--clear-unfindable-users
从不可查找用户列表中删除所有条目。
--add-unfindable-users < 字符串 >...
添加一个条目到此身份认证提供程序无法解析的用户的列表。重复此选项可指定多个列表项。
--remove-unfindable-users < 字符串 >...
从此身份认证提供程序无法解析的用户的列表中删除一个条目。重复此选项可指定多个列表项。
{--verbose | -v}
显示运行命令的结果。

70 OneFS isi 命令 A 至 C
isi auth ads spn check
检查有效的服务主体名称 (SPN)。

语法
isi auth ads spn check < 提供程序名称 >

选项
< 提供程序名称 >
指定 Active Directory 提供程序名称。

isi auth ads spn create


为计算机帐户添加一个或多个服务主体名称 (SPN)。必须将 SPN 填充到所有域控制器,以使它们对客户端可用。

语法
isi auth ads spn create <provider-name> <spn>
[--user <string>]
[--password <string>]

选项
< 提供程序名称 >
指定 Active Directory 提供程序名称。
<spn>
指定服务主体名称。
{--user | -U} < 字符串 >
指定有权在 Active Directory 域中创建 SPN 的管理用户帐户名称。
{--password | -P} < 字符串 >
指定管理用户帐户密码。

isi auth ads spn delete


删除一个或多个注册了计算机帐户的 SPN。

语法
isi auth ads spn delete <provider-name> <spn>
[--user <string>]
[--password <string>]

OneFS isi 命令 A 至 C 71
选项
< 提供程序名称 >
指定 Active Directory 提供程序名称。
<spn>
指定服务主体名称。
{--user | -U} < 字符串 >
指定有权在 Active Directory 域中修改 SPN 的管理用户帐户名称。
{--password | -P} < 字符串 >
指定管理用户帐户密码。

isi auth ads spn fix


为 Active Directory 提供程序添加缺少的服务主体名称 (SPN)。

语法
isi auth ads spn fix <provider-name>
[--spn <string>]
[--user <string>]
[--password <string>]
[--noremove

选项
< 提供程序名称 >
指定 Active Directory 提供程序名称。
--spn < 字符串 >
指定服务主体名称。
--user < 字符串 >
指定有权为 Active Directory 域添加 SPN 的管理用户帐户名称。
--password < 字符串 >
指定管理用户帐户密码。
--noremove
指定不删除任何意外 SPN,而是添加缺少的 SPN。

isi auth ads spn list


显示针对计算机帐户注册的服务主体名称 (SPN) 的列表。

语法
isi auth ads spn list < 提供程序名称 >
[--limit < 整数 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

72 OneFS isi 命令 A 至 C
选项
< 提供程序名称 >
指定 Active Directory 提供程序名称。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi auth ads trusts controllers list


显示受信任域的域控制器列表。

语法
isi auth ads trusts controllers list <provider-name>
[--dc-site <string>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
< 提供程序名称 > < 字符串 >
指定 Active Directory 提供程序。
--dc-site
指定域控制器站点。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 73
示例
以下命令显示名为 ad.isilon.com 的 Active Directory 提供程序中的受信任域的列表:

isi auth ads trusts controllers list ad.isilon.com

isi auth ads trusts list


显示受信任域的列表。

语法
isi auth ads trusts list <provider-name>

选项
< 提供程序名称 >
指定 Active Directory 提供程序。

isi auth ads view


显示 Active Directory 提供程序的属性。

语法
isi auth ads view <provider-name>
[--verbose]

选项
< 提供程序名称 >
指定要查看的提供程序的名称。
{--verbose | -v}
显示更多详细信息。

isi auth duo modify


修改 Duo 提供程序设置。

语法
isi auth duo modify
[--autopush <boolean>]
[--enabled <boolean>]
[--failmode <string>]
[--fallback-local-ip <boolean>]
[--groups <string>]
[--http-proxy <string>]

74 OneFS isi 命令 A 至 C
[--https-timeout <integer>]
[--prompts <integer>]
[--pushinfo <boolean>]
[--host <string>]
[--ikey <string>]
[--set-skey]
[{--verbose | -v}]
[{--help | -h}]

选项
--autopush < 布尔值 >
指定 Duo 是否会自动将推送登录请求发送至用户电话。
--enabled < 布尔值 >
指定 Duo 提供程序是否已启用。
--failmode < 字符串 >
指定在配置或服务出错时,Duo 是否将进入故障“保护”状态(允许访问)或“停止工作”状态(拒绝访
问)。
--fallback-local-ip < 布尔值 >
指定如果无法检测到客户端 IP,Duo 是否将报告服务器 IP。
--groups < 字符串 >
指定需要 Duo 的组的列表(默认为所有组)。
--http-proxy < 字符串 >
指定要使用的 HTTP 代理。
--https-timeout < 整数 >
指定等待来自 Duo 安全的 HTTPS 响应的秒数。
--prompts < 整数 >
指定要显示的身份验证提示的最大数量(1-3,默认值为 3)。
--pushinfo < 布尔值 >
指定在 Duo 推送消息中包含信息。
--host < 字符串 >
指定 API 主机名。
--ikey < 字符串 >
指定集成密钥。
--set-skey
指定密钥。
--verbose | -v
显示更多详细信息。
--help | -h
显示此命令的帮助。

isi auth error


显示来自身份认证日志文件的错误代码定义。

语法
isi auth error <error-code>

OneFS isi 命令 A 至 C 75
选项
< 错误代码 >
指定要恢复的错误代码。

示例
要查看错误代码 4 的定义,请运行以下命令:

isi auth error 4

系统将显示与以下示例类似的输出:

4 = ERROR_TOO_MANY_OPEN_FILES

isi auth file create


创建文件提供程序。

语法
isi auth file create < 名称 >
[--password-file < 路径 >]
[--group-file < 路径 >]
[--authentication {yes | no}]
[--create-home-directory {yes | no}]
[--enabled {yes | no}]
[--enumerate-groups {yes | no}]
[--enumerate-users {yes | no}]
[--findable-groups < 字符串 >]
[--findable-users < 字符串 >]
[--group-domain < 字符串 >]
[--home-directory-template < 路径 >]
[--listable-groups < 字符串 >]
[--listable-users < 字符串 >]
[--login-shell < 路径 >]
[--modifiable-groups < 字符串 >]
[--modifiable-users < 字符串 >]
[--netgroup-file < 路径 >]
[--normalize-groups {yes | no}]
[--normalize-users {yes | no}]
[--ntlm-support {全部 | v2only | none}]
[--provider-domain < 字符串 >]
[--restrict-findable {yes | no}]
[--restrict-listable {yes | no}]
[--restrict-modifiable {yes | no}]
[--unfindable-groups < 字符串 >]
[--unfindable-users < 字符串 >]
[--unlistable-groups < 字符串 >]
[--unlistable-users < 字符串 >]
[--unmodifiable-groups < 字符串 >]
[--unmodifiable-users < 字符串 >]
[--user-domain < 字符串 >]
[--verbose]

选项
< 名称 >
设置文件提供程序名称。

76 OneFS isi 命令 A 至 C
--password-file< 路径 >
指定 passwd.db 替换文件的路径。
--group-file< 路径 >
指定 group 替换文件的路径。
--authentication {yes | no}
启用或禁用将提供程序用于身份认证以及身份。默认值为 yes。
--create-home-directory {yes | no}
指定是否在用户首次登录时创建主目录(如果尚不存在用户的主目录)。
--enabled {yes | no}
启用或禁用提供程序。
--findable-groups< 字符串 >
指定在启用了 --restrict-findable 的情况下可在此提供程序中找到的组的列表。重复此选项可指
定每个额外的可查找组。如果填充此选项,将无法解析未包含在此列表中的组。
--findable-users< 字符串 >
指定在启用了 --restrict-findable 的情况下可在此提供程序中找到的用户的列表。重复此选项可
指定每个额外的可查找用户。如果填充此选项,将无法解析未包含在此列表中的用户。
--group-domain< 字符串 >
指定该提供程序将用于确定组的域。默认组域为 FILE_GROUPS。
--home-directory-template< 路径 >
指定要用作主目录命名模板的路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符序列
将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户名、提
供程序域名和分区名称。有关更多信息,请参见“主目录”部分。
--listable-groups< 字符串 >
指定在启用了 --restrict-listable 的情况下可以列出的组。重复此选项可指定多个列表项。如果
填充此选项,将无法列出未包含在此列表中的任何组。
--listable-users< 字符串 >
指定在启用了 --restrict-listable 情况下可在该提供程序中列出的用户。重复此选项可指定多个
列表项。如果填充此选项,将无法列出未包含在此列表中的任何用户。
--login-shell< 路径 >
指定用户登录 Shell 的路径。此设置仅适用于通过 SSH 访问文件系统的用户。
--modifiable-groups< 字符串 >
指定在启用了 --restrict-modifiable 情况下可在该提供程序中修改的组。重复此选项可指定多个
列表项。如果填充此选项,将无法修改未包含在此列表中的任何组。
--modifiable-users< 字符串 >
指定在启用了 --restrict-modifiable 情况下可在该提供程序中修改的用户。重复此选项可指定多
个列表项。如果填充此选项,将无法修改未包含在此列表中的任何用户。
--netgroup-file< 路径 >
指定 netgroup 替换文件的路径。
--normalize-groups {yes | no}
在查找前将组名称规范为小写。
--normalize-users {yes | no}
在查找前将用户名规范为小写。
--ntlm-support {all | v2only | none}
对于具有 NTLM 兼容凭据的用户,指定支持的 NTLM 版本。有效值是 all、v2only 和 none。
NTLMv2 通过 NTLM 提供额外的安全性。
--provider-domain< 字符串 >
指定提供程序用于确定用户名和组名称的域。
--restrict-findable {yes | no}
指定是否检查提供程序,以查看可查找和不可查找用户和组的筛选列表。
--restrict-listable {yes | no}

OneFS isi 命令 A 至 C 77
指定是否检查提供程序,以查看可列出和不可列出的用户和组的筛选列表。
--restrict-modifiable {yes | no}
指定是否检查提供程序,以查看可修改和不可修改的用户和组的筛选列表。
--unfindable-groups< 字符串 >
如果启用了 --restrict-findable 而可查找组列表为空,则指定无法由该提供程序解析的组。重复
此选项可指定多个列表项。
--unfindable-users< 字符串 >
如果启用了 --restrict-findable 而可查找用户列表为空,则指定无法由该提供程序解析的用户。
重复此选项可指定多个列表项。
--unlistable-groups< 字符串 >
如果启用了 --restrict-listable 而可列表组列表为空,则指定无法由该提供程序列出的组。重复
此选项可指定多个列表项。
--unlistable-users< 字符串 >
如果启用了 --restrict-listable 而可列表用户列表为空,则指定无法由该提供程序列出的用户。
重复此选项可指定多个列表项。
--unmodifiable-groups< 字符串 >
如果启用了 --restrict-modifiable 而可修改组列表为空,则指定无法修改的组。重复此选项可指
定多个列表项。
--unmodifiable-users< 字符串 >
如果启用了 --restrict-modifiable 而可修改用户列表为空,则指定无法修改的用户。重复此选项
可指定多个列表项。
--user-domain< 字符串 >
指定该提供程序将用于确定用户的域。默认用户域为 FILE_USERS。
{--verbose | -v}
显示更多详细信息。

isi auth file delete


删除文件提供程序。

语法
isi auth file delete <provider-name>
[--force]
[--verbose]

选项
< 提供程序名称 >
指定要删除的提供程序的名称。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示更多详细信息。

78 OneFS isi 命令 A 至 C
isi auth file list
显示文件提供程序的列表。

语法
isi auth file list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi auth file modify


修改文件提供程序。

语法
isi auth file modify < 提供程序名称 >
[--name < 字符串 >]
[--password-file < 路径 >]
[--group-file < 路径 >]
[--authentication {yes | no}]
[--create-home-directory {yes | no}]
[--enabled {yes | no}]
[--enumerate-groups {yes | no}]
[--enumerate-users {yes | no}]
[--findable-groups < 字符串 >]
[--clear-findable-groups]
[--add-findable-groups < 字符串 >]
[--remove-findable-groups < 字符串 >]
[--findable-users < 字符串 >]
[--clear-findable-users]
[--add-findable-users < 字符串 >]
[--remove-findable-users < 字符串 >]
[--group-domain < 字符串 >]
[--home-directory-template < 路径 >]
[--listable-groups < 字符串 >]
[--clear-listable-groups]
[--add-listable-groups < 字符串 >]
[--remove-listable-groups < 字符串 >]
[--listable-users < 字符串 >]

OneFS isi 命令 A 至 C 79
[--clear-listable-users]
[--add-listable-users < 字符串 >]
[--remove-listable-users < 字符串 >]
[--login-shell < 路径 >]
[--modifiable-groups < 字符串 >]
[--clear-modifiable-groups]
[--add-modifiable-groups < 字符串 >]
[--remove-modifiable-groups < 字符串 >]
[--modifiable-users < 字符串 >]
[--clear-modifiable-users]
[--add-modifiable-users < 字符串 >]
[--remove-modifiable-users < 字符串 >]
[--netgroup-file < 路径 >]
[--normalize-groups {yes | no}]
[--normalize-users {yes | no}]
[--ntlm-support {全部 | v2only | none}]
[--provider-domain < 字符串 >]
[--restrict-findable {yes | no}]
[--restrict-listable {yes | no}]
[--restrict-modifiable {yes | no}]
[--unfindable-groups < 字符串 >]
[--clear-unfindable-groups]
[--add-unfindable-groups < 字符串 >]
[--remove-unfindable-groups < 字符串 >]
[--unfindable-users < 字符串 >]
[--clear-unfindable-users]
[--add-unfindable-users < 字符串 >]
[--remove-unfindable-users < 字符串 >]
[--unlistable-groups < 字符串 >]
[--clear-unlistable-groups]
[--add-unlistable-groups < 字符串 >]
[--remove-unlistable-groups < 字符串 >]
[--unlistable-users < 字符串 >]
[--clear-unlistable-users]
[--add-unlistable-users < 字符串 >]
[--remove-unlistable-users < 字符串 >]
[--unmodifiable-groups < 字符串 >]
[--clear-unmodifiable-groups]
[--add-unmodifiable-groups < 字符串 >]
[--remove-unmodifiable-groups < 字符串 >]
[--unmodifiable-users < 字符串 >]
[--clear-unmodifiable-users]
[--add-unmodifiable-users < 字符串 >]
[--remove-unmodifiable-users < 字符串 >]
[--user-domain < 字符串 >]
[--verbose]

选项
< 提供程序名称 >
指定要修改的文件提供程序的名称。不能修改此设置。
--name< 字符串 >
指定身份认证提供程序的新名称。
--password-file < 路径 >
指定 passwd.db 替换文件的路径。
--group-file< 路径 >
指定 group 替换文件的路径。
--authentication {yes | no}
启用或禁用将提供程序用于身份认证以及身份。默认值为 yes。
--cache-entry-expiry< 持续时间 >
指定缓存条目到期前的时间长度,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。要关闭缓存到期,请将该值
设置为 off。
--create-home-directory {yes | no}
指定是否在用户首次登录时创建主目录(如果尚不存在用户的主目录)。

80 OneFS isi 命令 A 至 C
--enabled {yes | no}
启用或禁用提供程序。
--enumerate-groups {yes | no}
指定是否允许提供程序枚举组。
--enumerate-users {yes | no}
指定是否允许提供程序枚举用户。
--findable-groups< 字符串 >
指定在启用了 --restrict-findable 的情况下可在该提供程序中找到的组。重复此选项可指定多个
列表项。如果填充此选项,将无法解析未包含在此列表中的任何组。此选项会覆盖可查找组列表中的所
有现有条目;要在不影响当前条目的情况下添加或删除组,请使用 --add-findable-groups 或 --
remove-findable-groups。
--clear-findable-groups
从可查找组列表中删除所有条目。
--add-findable-groups< 字符串 >
在启用了 --restrict-findable 的情况下向已选中的可查找组列表添加条目。重复此选项可指定多
个列表项。
--remove-findable-groups< 字符串 >
在启用了 --restrict-findable 的情况下从已选中的可查找组列表中删除条目。重复此选项可指定
多个列表项。
--findable-users< 字符串 >
指定在启用了 --restrict-findable 的情况下可在该提供程序中找到的用户。重复此选项可指定多
个列表项。如果填充此选项,将无法解析未包含在此列表中的任何用户。此选项会覆盖可查找用户列表
中的所有现有条目;要在不影响当前条目的情况下添加或删除用户,请使用 --add-findable-users
或 --remove-findable-users。
--clear-findable-users
从可查找用户列表中删除所有条目。
--add-findable-users< 字符串 >
在启用了 --restrict-findable 的情况下向已选中的可查找用户列表添加条目。重复此选项可指定
多个列表项。
--remove-findable-users< 字符串 >
在启用了 --restrict-findable 的情况下从已选中的可查找用户列表中删除条目。重复此选项可指
定多个列表项。
--group-domain< 字符串 >
指定提供程序用于确定组的域。默认组域为 FILE_GROUPS。
--group-file< 路径 >
指定 group 替换文件的路径。
--home-directory-template< 路径 >
指定要用作主目录命名模板的路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符序列
将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户名、提
供程序域名和分区名称。有关更多信息,请参见“主目录”部分。
--listable-groups< 字符串 >
指定在启用了 --restrict-listable 的情况下可在该提供程序中查看的组。重复此选项可指定多个
列表项。如果填充此选项,将无法查看未包含在此列表中的任何组。此选项会覆盖可列表组列表中的所
有现有条目;要在不影响当前条目的情况下添加或删除组,请使用 --add-listable-groups 或 --
remove-listable-groups。
--clear-listable-groups
从可查看组列表中删除所有条目。
--add-listable-groups< 字符串 >
在启用了 --restrict-listable 的情况下向已选中的可查看组列表添加条目。重复此选项可指定多
个列表项。
--remove-listable-groups< 字符串 >

OneFS isi 命令 A 至 C 81
在启用了 --restrict-listable 的情况下从已选中的可查看组列表中删除条目。重复此选项可指定
多个列表项。
--listable-users< 字符串 >
指定在启用了 --restrict-listable 的情况下可在该提供程序中查看的用户。重复此选项可指定多
个列表项。如果填充此选项,将无法查看未包含在此列表中的任何用户。此选项会覆盖可列表用户列表
中的所有现有条目;要在不影响当前条目的情况下添加或删除用户,请使用 --add-listable-users
或 --remove-listable-users。
--clear-listable-users
从可查看用户列表中删除所有条目。
--add-listable-users< 字符串 >
在启用了 --restrict-listable 的情况下向已选中的可查看用户列表添加条目。重复此选项可指定
多个列表项。
--remove-listable-users< 字符串 >
在启用了 --restrict-listable 的情况下从已选中的可查看用户列表中删除条目。重复此选项可指
定多个列表项。
--login-shell< 路径 >
指定用户登录 Shell 的路径。此设置仅适用于通过 SSH 访问文件系统的用户。
--modifiable-groups< 字符串 >
指定在启用了 --restrict-modifiable 的情况下可以修改的组。重复此选项可指定多个列表项。如
果填充此选项,将无法修改未包含在此列表中的任何组。此选项会覆盖可修改组列表中的所有现有条
目;要在不影响当前条目的情况下添加或删除组,请使用 --add-modifiable-groups 或 --
remove-modifiable-groups。
--clear-modifiable-groups
从可修改组列表中删除所有条目。
--add-modifiable-groups< 字符串 >
在启用了 --restrict-modifiable 的情况下向已选中的可修改组列表添加条目。重复此选项可指定
多个列表项。
--remove-modifiable-groups< 字符串 >
在启用了 --restrict-modifiable 的情况下从已选中的可修改组列表中删除条目。重复此选项可指
定多个列表项。
--modifiable-users< 字符串 >
指定在启用了 --restrict-modifiable 的情况下可以修改的用户。重复此选项可指定多个列表项。
如果填充此选项,将无法修改未包含在此列表中的任何用户。此选项会覆盖可修改用户列表中的所有现
有条目;要在不影响当前条目的情况下添加或删除用户,请使用 --add-modifiable-users 或 --
remove-modifiable-users。
--clear-modifiable-users
从可修改用户列表中删除所有条目。
--add-modifiable-users< 字符串 >
在启用了 --restrict-modifiable 的情况下向已选中的可修改用户列表添加条目。重复此选项可指
定多个列表项。
--remove-modifiable-users< 字符串 >
在启用了 --restrict-modifiable 的情况下从已选中的可修改用户列表中删除条目。重复此选项可
指定多个列表项。
--netgroup-file< 路径 >
指定 netgroup 替换文件的路径。
--normalize-groups {yes | no}
在查找前将组名称规范为小写。
--normalize-users {yes | no}
在查找前将用户名规范为小写。
--ntlm-support {all | v2only | none}
对于具有 NTLM 兼容凭据的用户,指定支持的 NTLM 版本。有效值是 all、v2only 和 none。
NTLMv2 通过 NTLM 提供额外的安全性,建议这样做。

82 OneFS isi 命令 A 至 C
--password-file< 路径 >
指定 passwd.db 替换文件的路径。
--provider-domain< 字符串 >
指定该提供程序用于确定用户名和组名称的域。
--restrict-findable {yes | no}
指定是否检查该提供程序,以查看可查找和不可查找用户和组的筛选列表。
--restrict-listable {yes | no}
指定是否检查该提供程序,以查看可查看和不可查看用户和组的筛选列表。
--restrict-modifiable {yes | no}
指定是否检查该提供程序,以查看可修改和不可修改用户和组的筛选列表。
--unfindable-groups< 字符串 >
如果启用了 --restrict-findable 而可查找组列表为空,则指定无法由该提供程序解析的组。重复
此选项可指定多个列表项。此选项会覆盖不可查找组列表中的所有现有条目;要在不影响当前条目的情
况下添加或删除组,请使用 --add-unfindable-groups 或 --remove-unfindable-groups。
--clear-unfindable-groups
从不可查找组列表中删除所有条目。
--add-unfindable-groups< 字符串 >
在启用了 --restrict-findable 的情况下向已选中的不可查找组列表添加条目。重复此选项可指定
多个列表项。
--remove-unfindable-groups< 字符串 >
在启用了 --restrict-findable 的情况下从已选中的不可查找组列表中删除条目。重复此选项可指
定多个列表项。
--unfindable-users< 字符串 >
如果启用了 --restrict-findable 而可查找用户列表为空,则指定无法由该提供程序解析的用户。
重复此选项可指定多个列表项。此选项会覆盖不可查找用户列表中的所有现有条目;要在不影响当前条
目的情况下添加或删除用户,请使用 --add-unfindable-users 或 --remove-unfindable-
users。
--clear-unfindable-users
从不可查找组列表中删除所有条目。
--add-unfindable-users< 字符串 >
在启用了 --restrict-findable 的情况下向已选中的不可查找用户列表添加条目。重复此选项可指
定多个列表项。
--remove-unfindable-users< 字符串 >
在启用了 --restrict-findable 的情况下从已选中的不可查找用户列表中删除条目。重复此选项可
指定多个列表项。
--unlistable-groups< 字符串 >
如果启用了 --restrict-listable 而可查看组列表为空,则指定无法由该提供程序列出的组。重复
此选项可指定多个列表项。此选项会覆盖不可列出组列表中的所有现有条目;要在不影响当前条目的情
况下添加或删除组,请使用 --add-unlistable-groups 或 --remove-unlistable-groups。
--clear-unlistable-groups
从不可查看组列表中删除所有条目。
--add-unlistable-groups< 字符串 >
在启用了 --restrict-listable 的情况下向已选中的不可查看组列表添加条目。重复此选项可指定
多个列表项。
--remove-unlistable-groups< 字符串 >
在启用了 --restrict-listable 的情况下从已选中的不可查看组列表中删除条目。重复此选项可指
定多个列表项。
--unlistable-users< 字符串 >
如果启用了 --restrict-listable 而可查看用户列表为空,则指定无法由该提供程序列出的用户。
重复此选项可指定多个列表项。此选项会覆盖不可列出用户列表中的所有现有条目;要在不影响当前条
目的情况下添加或删除用户,请使用 --add-unlistable-users 或 --remove-unlistable-
users。

OneFS isi 命令 A 至 C 83
--clear-unlistable-users
从不可查看用户列表中删除所有条目。
--add-unlistable-users< 字符串 >
在启用了 --restrict-listable 的情况下向已选中的不可查看用户列表添加条目。重复此选项可指
定多个列表项。
--remove-unlistable-users< 字符串 >
在启用了 --restrict-listable 的情况下从已选中的不可查看用户列表中删除条目。重复此选项可
指定多个列表项。
--unmodifiable-groups< 字符串 >
如果启用了 --restrict-modifiable 而可修改组列表为空,则指定无法修改的组。重复此选项可指
定多个列表项。此选项会覆盖此提供程序的不可修改组列表中的所有现有条目;要在不影响当前条目的
情况下添加或删除组,请使用 --add-unmodifiable-groups 或 --remove-unmodifiable-
groups。
--clear-unmodifiable-groups
从不可修改组列表中删除所有条目。
--add-unmodifiable-groups< 字符串 >
在启用了 --restrict-modifiable 的情况下向已选中的不可修改组列表添加条目。重复此选项可指
定多个列表项。
--remove-unmodifiable-groups< 字符串 >
在启用了 --restrict-modifiable 的情况下从已选中的不可修改组列表中删除条目。重复此选项可
指定多个列表项。
--unmodifiable-users< 字符串 >
如果启用了 --restrict-modifiable 而可修改用户列表为空,则指定无法修改的用户。重复此选项
可指定多个列表项。此选项会覆盖此提供程序的不可修改用户列表中的所有现有条目;要在不影响当前
条目的情况下添加或删除用户,请使用 --add-unmodifiable-users 或 --remove-
unmodifiable-users。
--clear-unmodifiable-users
从不可修改用户列表中删除所有条目。
--add-unmodifiable-users< 字符串 >
在启用了 --restrict-modifiable 的情况下向已选中的不可修改用户列表添加条目。重复此选项可
指定多个列表项。
--remove-unmodifiable-users< 字符串 >
在启用了 --restrict-modifiable 的情况下从已选中的不可修改用户列表中删除条目。重复此选项
可指定多个列表项。
--user-domain< 字符串 >
指定该提供程序将用于确定用户的域。默认用户域为 FILE_USERS。
{--verbose | -v}
显示详细信息。

isi auth file view


显示文件提供程序的属性。

语法
isi auth file view <provider-name>

选项
< 提供程序名称 >

84 OneFS isi 命令 A 至 C
指定要查看的提供程序的名称。

isi auth groups create


创建本地组。

语法
isi auth groups create <name>
[--gid <integer>]
[--add-user <name>]
[--add-group <name>]
[--add-gid <integer>]
[--add-uid <integer>]
[--add-sid <string>
[--add-wellknown <name>]
[--zone <string>]
[--provider <string>]
[--verbose]
[--force]

选项
< 名称 >
指定组名称。
--gid < 整数 >
用指定的值覆盖自动分配的 UNIX 组标识符 (GID)。不建议设置此选项。
--add-user < 名称 >
指定要添加到组的用户的名称。重复此选项可指定多个用户。
--add-group < 名称 >
指定要添加到此组的组的名称。重复此选项可指定多个组。
--add-gid < 整数 >
指定要添加到此组的组的 SID。重复此选项可指定多个组。
--add-uid < 整数 >
指定要添加到组的用户的 UID。重复此选项可指定多个用户。
--add-sid < 字符串 >
指定要添加到组的角色的 Windows 安全标识符 (SID),例如 S-1-5-21-13。重复此选项可指定多个
SID。
--add-wellknown < 名称 >
指定要添加到组的已知角色名称。重复此选项可指定多个角色。
--zone < 字符串 >
指定要在其中创建组的访问分区。
--provider < 字符串 >
在指定的访问分区指定本地身份认证提供程序。
{--verbose | -v}
显示更多详细信息。
{--force | -f}
禁止显示命令行提示符和消息。

OneFS isi 命令 A 至 C 85
isi auth groups delete
从系统中删除本地组。 删除组之前将先删除组成员。

语法
isi auth groups delete {<group> | --gid <integer> | --sid <string>}
[--zone <string>]
[--provider <string>]
[--force]
[--verbose]

选项
此命令需要 < 组 >、--gid< 整数 > 或 --sid< 字符串 >。
<组>
按名称指定组。
--gid< 整数 >
按 GID 指定组。
<组>
--sid< 字符串 >
按 SID 指定组。
--zone< 字符串 >
指定包含该组的访问分区的名称。
--provider< 字符串 >
指定组的身份认证提供程序。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示运行命令的结果。

isi auth groups flush


刷新缓存组信息。

语法
isi auth groups flush

选项
此命令没有选项。

示例
要刷新所有缓存组信息,请运行以下命令:

isi auth groups flush

86 OneFS isi 命令 A 至 C
isi auth groups list
显示组列表。

语法
isi auth groups list
[--domain <string>]
[--zone <string>]
[--provider <string>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--domain< 字符串 >
指定提供程序域。
--zone< 字符串 >
指定访问分区。
--provider< 字符串 >
指定身份认证提供程序。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi auth groups members list


显示与组关联的成员列表。

语法
isi auth groups members list {<group> | --gid <integer> | --sid <string>}
[--zone <string>]
[--provider <string>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

OneFS isi 命令 A 至 C 87
选项
此命令需要 < 组 >、--gid< 整数 > 或 --sid< 字符串 >。
<组>
按名称指定组。
--gid< 整数 >
按 GID 指定组。
--sid< 字符串 >
按 SID 指定组。
--zone< 字符串 >
指定访问分区。
--provider< 字符串 >
指定身份认证提供程序。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi auth groups modify


修改本地组。

语法
isi auth groups modify {<group> | --gid <integer> | --sid <string>}
[--new-gid <integer>]
[--add-uid <integer>]
[--remove-uid <integer>]
[--add-user <name>]
[--add-group <name>]
[--add-gid <integer>
[--remove-user <name>]
[--remove-group <name>]
[--remove-gid <integer>]
[--add-sid <string>]
[--remove-sid <string>]
[--add-wellknown <name>]
[--remove-wellknown <name>]
[--zone <string>]
[--provider <string>]
[--verbose]
[--force]

选项
此命令需要 < 组 >、--gid < 整数 > 或 --sid < 字符串 >。
<组>

88 OneFS isi 命令 A 至 C
按名称指定组。
--gid < 整数 >
按 GID 指定组。
--sid < 字符串 >
按安全标识符 (SID) 指定组。
--new-gid < 整数 >
为组指定新的 GID。不建议设置此选项。
--add-uid < 整数 >
指定要添加到组的用户 UID。重复此选项可指定多个列表项。
--remove-uid < 整数 >
指定要从组中删除的用户 UID。重复此选项可指定多个列表项。
--add-user < 名称 >
指定要添加到组的用户的名称。重复此选项可指定多个列表项。
--remove-user < 名称 >
指定要从组中删除的用户的名称。重复此选项可指定多个列表项。
--add-group < 名称 >
指定要添加到此组的组的名称。重复此选项可指定多个要添加的组。
--remove-group < 名称 >
指定要从此组中删除的组的名称。重复此选项可指定多个要删除的组。
--add-gid < 整数 >
指定要添加到此组的组的 SID。重复此选项可指定多个要添加的 GID。
--remove-gid < 整数 >
指定要从此组中删除的组的 SID。重复此选项可指定多个要删除的 GID。
--add-sid < 字符串 >
指定要添加到组的对象的 SID,例如 S-1-5-21-13。重复此选项可指定多个列表项。
--remove-sid < 字符串 >
指定要从组中删除的对象 SID。重复此选项可指定多个列表项。
--add-wellknown < 名称 >
指定要添加到组的已知 SID。重复此选项可指定多个列表项。
--remove-wellknown < 名称 >
指定要从组中删除的已知 SID。重复此选项可指定多个列表项。
--zone < 字符串 >
指定组的访问分区。
--provider < 字符串 >
采用格式 type:instance 指定组的身份验证提供程序。有效的提供程序类型如下。
● ads
● 文件
● ldap
● local
● nis
例如,ldap:auth1 指定名为 auth1 的 LDAP 提供程序。
{--verbose | -v}
显示更多详细信息。
{--force | -f}
禁止显示命令行提示符和消息。

OneFS isi 命令 A 至 C 89
isi auth groups view
显示组的属性,包括历史安全标识符 (SID) 信息。

语法
isi auth groups view {<group> | --gid <integer> | --sid <string>}
[--cached]
[--provider <string>]
[--show-groups]
[--zone <string>]

选项
<组>
按名称指定组。
--gid< 整数 >
按 GID 指定组。
--sid< 字符串 >
按 SID 指定组。
--cached
显示缓存信息。
--provider< 字符串 >
指定身份认证提供程序的名称。
--show-groups
显示将该组作为成员包括在内的组。
--zone< 字符串 >
指定访问分区。

isi auth id
显示访问令牌。

语法
isi auth id

选项
此命令没有选项。

90 OneFS isi 命令 A 至 C
isi auth krb5 create
创建 MIT Kerberos 提供程序,并将用户加入 MIT Kerberos 领域。

语法
isi auth krb5 create < 领域 > {< 用户 > | --keytab-file < 字符串 > }
[--password < 字符串 >]
[--spn < 字符串 >]
[--groupnet <groupnet>]
[--is-default-realm {yes | no}]
[--kdc < 字符串 >]
[--admin-server < 字符串 >]
[--default-domain < 字符串 >]
[--verbose]

选项
< 领域 >
指定 Kerberos 领域名称。
< 用户 >
指定有权在 Kerberos 领域中创建服务主体名称 (SPN) 的用户的名称。
--keytab-file< 字符串 >
指定要导入的密钥表文件。
--password< 字符串 >
指定用于加入 Kerberos 领域的密码。
--spn< 字符串 >
指定要注册的 SPN。为每个要注册的附加 SPN 指定 --spn。
--groupnet<groupnet>
指定 Kerberos 提供程序引用的 groupnet。groupnet 是顶层网络容器,用于管理针对 DNS 名称服务器的
主机名解析且包含子网和 IP 地址池。groupnet 指定与外部服务器通信时 Kerberos 提供程序将使用的网
络属性。
--is-default-realm {yes | no}
指定 Kerberos 领域是否为默认值。
--kdc< 字符串 >
指定密钥分发中心 (KDC) 的主机名、IPv4 地址或 IPv6 地址。为每个要添加到领域的附加 KDC 指定 --
kdc。
--admin-server< 字符串 >
指定管理服务器(主要 KDC)的主机名、IPv4 地址或 IPv6 地址。
--default-domain< 字符串 >
为用于转换 Kerberos v4 主体名称的 Kerberos 领域指定默认 Kerberos 域。
{--verbose | -v}
显示详细信息。

OneFS isi 命令 A 至 C 91
isi auth krb5 delete
删除 MIT Kerberos 身份认证提供程序,并从 MIT Kerberos 领域中删除用户。

语法
isi auth krb5 delete <provider-name>
[--force]

选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。
{--force | -f}
指定不提示确认。

isi auth krb5 domain create


创建 MIT Kerberos 域映射。

语法
isi auth krb5 domain create <domain> <realm>

选项
<domain>
指定 Kerberos 域的名称。
< 领域 >
指定 Kerberos 领域的名称。

isi auth krb5 domain delete


删除 MIT Kerberos 域映射。

语法
isi auth krb5 domain delete <domain>
[--force]

选项
<domain>
指定 Kerberos 域的名称。
{--force | -f}
指定不提示确认。

92 OneFS isi 命令 A 至 C
isi auth krb5 domain list
显示 MIT Kerberos 域映射的列表。

语法
isi auth krb5 domain list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
{--limit | -l} < 整数 >
指定要显示的 Kerberos 域映射的数量。
--format {table | json | csv | list}
指定是以表格、JSON、CSV 还是列表格式显示 Kerberos 域映射。
{--no-header | -a}
指定不以 CSV 或表格格式显示页眉。
{--no-footer | -z}
指定不显示表格摘要页脚信息。

isi auth krb5 domain modify


修改 MIT Kerberos 域映射。

语法
isi auth krb5 domain modify <domain>
[--realm <string>]

选项
<domain>
指定 Kerberos 域名。
--realm< 字符串 >
指定 Kerberos 领域名称。

isi auth krb5 domain view


显示 MIT Kerberos 域映射的属性。

语法
isi auth krb5 domain view <domain>

OneFS isi 命令 A 至 C 93
选项
<domain>
指定 Kerberos 域名。

isi auth krb5 list


显示 MIT Kerberos 身份认证提供程序的列表。

语法
isi auth krb5 list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
{--limit | -l} < 整数 >
指定要显示的 Kerberos 提供程序的数量。
--format {table | json | csv | list}
指定以表格、JSON、CSV 或列表格式显示 Kerberos 提供程序。
{--no-header | -a}
指定不以 CSV 或表格格式显示页眉。
{--no-footer | -z}
指定不显示表格摘要页脚信息。

isi auth krb5 realm create


创建 MIT Kerberos 领域。

语法
isi auth krb5 realm create <realm>
[--is-default-realm {yes | no}]
[--kdc <string>]
[--admin-server <string>]
[--default-domain <string>]

选项
< 领域 >
指定 Kerberos 领域的名称。
--is-default-realm {yes | no}
指定 Kerberos 领域是否为默认领域。
--kdc< 字符串 >
指定密钥分发中心 (KDC) 的主机名、IPv4 地址或 IPv6 地址。 为每个要添加到领域的附加 KDC 指定 --
kdc。

94 OneFS isi 命令 A 至 C
--admin-server< 字符串 >
指定管理服务器(主要 KDC)的主机名、IPv4 地址或 IPv6 地址。
--default-domain< 字符串 >
为用于转换 v4 主体名称的领域指定默认域。

isi auth krb5 realm delete


删除 MIT Kerberos 领域。

语法
isi auth krb5 realm delete <realm>
[--force]

选项
< 领域 >
指定 Kerberos 领域名称。
{--force | -f}
指定不提示确认。

isi auth krb5 realm list


显示 MIT Kerberos 领域的列表。

语法
isi auth krb5 realm list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
{--limit | -l} < 整数 >
指定要显示的 Kerberos 领域的数量。
--format {table | json | csv | list}
指定是以表格、JSON、CSV 还是列表格式显示 Kerberos 领域。
{--no-header | -a}
指定不以 CSV 或表格格式显示页眉。
{--no-footer | -z}
指定不显示表格摘要页脚信息。

OneFS isi 命令 A 至 C 95
isi auth krb5 realm modify
修改 MIT Kerberos 领域。

语法
isi auth krb5 realm modify <realm>
[--is-default-realm {yes | no}]
[--kdc <string>]
[--admin-server <string>]
[--default-domain <string>]

选项
< 领域 >
指定 Kerberos 领域名称。
--is-default-realm {yes | no}
指定 Kerberos 领域是否为默认值。
--kdc< 字符串 >
指定密钥分发中心 (KDC) 的主机名、IPv4 地址或 IPv6 地址。 为每个要添加到领域的附加 KDC 指定 --
kdc。
--admin-server< 字符串 >
指定管理服务器(主要 KDC)的主机名、IPv4 地址或 IPv6 地址。
--default-domain< 字符串 >
为用于转换 v4 主体名称的 Kerberos 领域指定默认域。

isi auth krb5 realm view


显示 MIT Kerberos 领域的属性。

语法
isi auth krb5 realm view <realm>

选项
< 领域 >
指定 Kerberos 领域名称。

isi auth krb5 spn check


检查 MIT Kerberos 提供程序是否缺少服务主体名称 (SPN)。

语法
isi auth krb5 spn check <provider-name>

96 OneFS isi 命令 A 至 C
选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。

isi auth krb5 spn create


为 MIT Kerberos 提供程序创建或更新密钥。

语法
isi auth krb5 spn create <provider-name> <user> <spn>
[--password <string>]

选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。
< 用户 >
指定有权在 Kerberos 领域中创建服务主体名称 (SPN) 的用户名。
<spn>
指定 SPN。
--password< 字符串 >
指定 Kerberos 领域修改期间使用的密码。

isi auth krb5 spn delete


从 MIT Kerberos 提供程序中删除密钥。

语法
isi auth krb5 spn delete <provider-name> <spn> {<kvno> | --all}

选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。
<spn>
指定服务主体名称 (SPN)。
<kvno>
指定密钥版本号。
--all
删除所有密钥版本。

OneFS isi 命令 A 至 C 97
isi auth krb5 spn fix
为 MIT Kerberos 提供程序添加缺少的服务主体名称 (SPN)。

语法
isi auth krb5 spn fix <provider-name> <user>
[--password <string>]
[--force]

选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。
< 用户 >
指定有权将客户端加入指定 Kerberos 域的用户名。
--password< 字符串 >
指定在修改 Kerberos 领域时使用的密码。
{--force | -f}
指定不提示确认。

isi auth krb5 spn import


从 MIT Kerberos 提供程序的密钥表文件导入密钥。

语法
isi auth krb5 spn import <provider-name> <keytab-file>

选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。
< 密钥表文件 >
指定要导入的密钥表文件。

isi auth krb5 spn list


列出为 MIT Kerberos 提供程序注册的服务主体名称 (SPN) 和密钥。

语法
isi auth krb5 spn list <provider-name>
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

98 OneFS isi 命令 A 至 C
选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。
{--limit | -l} < 整数 >
指定要显示的 SPN 和密钥的数量。
--format {table | json | csv | list}
指定以表格、JSON、CSV 或列表格式显示 SPN 和密钥。
{--no-header | -a}
指定不以 CSV 或表格格式显示页眉。
{--no-footer | -z}
指定不显示表格摘要页脚信息。

isi auth krb5 view


显示 MIT Kerberos 身份认证提供程序的属性。

语法
isi auth krb5 view <provider-name>

选项
< 提供程序名称 >
指定 Kerberos 提供程序名称。

isi auth ldap create


创建 LDAP 提供程序。

语法
isi auth ldap create <name>
[--base-dn <string>]
[--server-uris <string>]
[--alternate-security-identities-attribute <string>]
[--authentication {yes | no}]
[--balance-servers {yes | no}]
[--bind-dn <string>]
[--bind-timeout <integer>]
[--certificate-authority-file <string>]
[--check-online-interval <duration>]
[--cn-attribute <string>]
[--create-home-directory {yes | no}]
[--crypt-password-attribute <string>]
[--email-attribute <string>]
[--enabled {yes | no}]
[--enumerate-groups {yes | no}]
[--enumerate-users {yes | no}]
[--findable-groups <string>]
[--findable-users <string>]
[--gecos-attribute <string>]
[--gid-attribute <string>]
[--group-base-dn <string>]

OneFS isi 命令 A 至 C 99
[--group-domain <string>]
[--group-filter <string>]
[--group-members-attribute <string>]
[--group-search-scope <scope>]
[--home-directory-template <string>]
[--homedir-attribute <string>]
[--ignore-tls-errors {yes | no}]
[--listable-groups <string>]
[--listable-users <string>]
[--login-shell <string>]
[--member-lookup-method {default | rfc2307bis}
[--member-of-attribute <string>]
[--name-attribute <string>]
[--netgroup-base-dn <string>]
[--netgroup-filter <string>]
[--netgroup-members-attribute <string>]
[--netgroup-search-scope <scope>]
[--netgroup-triple-attribute <string>]
[--normalize-groups {yes | no}]
[--normalize-users {yes | no}]
[--nt-password-attribute <string>]
[--ntlm-support {all | v2only | none}]
[--provider-domain <string>]
[--require-secure-connection {yes | no}]
[--restrict-findable {yes | no}]
[--restrict-listable {yes | no}]
[--search-scope <scope>]
[--search-timeout <integer>]
[--shadow-user-filter <string>]
[--shadow-expire-attribute <string>]
[--shadow-flag-attribute <string>]
[--shadow-inactive-attribute <string>]
[--shadow-last-change-attribute <string>]
[--shadow-max-attribute <string>]
[--shadow-min-attribute <string>]
[--shadow-warning-attribute <string>]
[--shell-attribute <string>]
[--ssh-public-key-attribute <string>]
[--uid-attribute <string>]
[--unfindable-groups <string>]
[--unfindable-users <string>]
[--unique-group-members-attribute <string>]
[--unlistable-groups <string>]
[--unlistable-users <string>]
[--user-base-dn <string>]
[--user-domain <string>]
[--user-filter <string>]
[--user-search-scope <scope>]
[--groupnet <groupnet>]
[--template {default | rfc2307 | ad-idmu | ldapsam}
[--bind-password <string>]
[--set-bind-password]
[--force | -f]
[--verbose] | -v

选项
< 名称 >
设置 LDAP 提供程序名称。
--base-dn < 字符串 >
设置要在其中搜索身份的树的根。例如,CN=Users,DC=mycompany,DC=com。
--server-uris < 字符串 >
指定访问服务器时要使用的 LDAP 服务器 URI 的列表。重复此选项可指定多个列表项。
以如下格式指定 LDAP 服务器 URI:ldaps://< 服务器 >:< 端口 >(安全 LDAP)或 ldap://< 服务器 >:< 端口 >
(非安全 LDAP)。
服务器可指定为 IPv4 地址、IPv6 地址或主机名。

100 OneFS isi 命令 A 至 C


如果您不指定端口号,将使用默认端口 389(安全 LDAP)或 636(非安全 LDAP)。

注: 如果您指定非安全 LDAP,绑定密码将以明文形式传输到服务器。

--alternate-security-identities-attribute < 字符串 >


指定搜索备选安全身份时要使用的名称。OneFS 尝试将 Kerberos 主体解析到用户时会使用该名称。
--authentication {yes | no}
启用或禁用将提供程序用于身份认证以及身份。默认值为 yes。
--balance-servers {yes | no}
使提供程序针对每个请求连接到随机服务器。
--bind-dn < 字符串 >
指定绑定到 LDAP 服务器时要使用的可分辨名称。例如,
CN=myuser,CN=Users,DC=mycompany,DC=com。
--bind-timeout < 整数 >
指定绑定到 LDAP 服务器时的超时时间(以秒为单位)。
--certificate-authority-file < 路径 >
指定根证书文件的路径。
--check-online-interval < 持续时间 >
指定提供程序执行在线检查的间隔时间,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--cn-attribute < 字符串 >
指定包含通用名称的 LDAP 属性。默认值为 cn。
--create-home-directory {yes | no}
指定当用户首次登录时是否自动创建一个主目录(如果不存在针对该用户的主目录)。
--crypt-password-attribute < 字符串 >
指定包含 UNIX 密码的 LDAP 属性。此设置无默认值。
--email-attribute < 字符串 >
指定包含电子邮件地址的 LDAP 属性。默认值为 mail。
--enabled {yes | no}
启用或禁用提供程序。
--enumerate-groups {yes | no}
指定是否允许提供程序枚举组。
--enumerate-users {yes | no}
指定是否允许提供程序枚举用户。
--findable-groups < 字符串 >
指定在启用了 --restrict-findable 的情况下可在此提供程序中找到的组的列表。重复此选项可指
定每个额外的可查找组。如果填充此选项,将无法解析未包含在此列表中的组。
--findable-users < 字符串 >
指定在启用了 --restrict-findable 的情况下可在此提供程序中找到的用户的列表。重复此选项可
指定每个额外的可查找用户。如果填充此选项,将无法解析未包含在此列表中的用户。
--gecos-attribute < 字符串 >
指定包含 GECOS 字段的 LDAP 属性。默认值为 gecos。
--gid-attribute < 字符串 >
指定包含 GID 的 LDAP 属性。默认值为 gidNumber。
--group-base-dn < 字符串 >
指定用于开始在 LDAP 中搜索组的条目的可分辨名称。
--group-domain < 字符串 >
指定提供程序用于确定组的域。默认组域为 LDAP_GROUPS。
--group-filter < 字符串 >
设置组对象的 LDAP 筛选器。
--group-members-attribute < 字符串 >

OneFS isi 命令 A 至 C 101


指定包含组成员的 LDAP 属性。默认值为 memberUid。
--group-search-scope < 范围 >
定义在 LDAP 中执行组搜索的基本可分辨名称 (DN) 的默认深度。
以下值有效:

default 应用 --search-scope 中的设置。


注: 不能指定 --search-scope=default。例如,如果指定 --group-
search-scope=default,搜索范围将设置为 --search-scope 的值。

base 仅在基本 DN 中搜索条目。


onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN。

--home-directory-template < 路径 >


指定要用作主目录命名模板的路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符序列
将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户名、提
供程序域名和分区名称。有关主目录变量的更多信息,请参见“主目录”。
--homedir-attribute < 字符串 >
指定包含主目录的 LDAP 属性。默认值为 homeDirectory。
--ignore-tls-errors {yes | no}
即使身份检查失败,也可通过安全连接继续。
--listable-groups < 字符串 >
指定在启用了 --restrict-listable 的情况下可在此提供程序中查看的组的列表。重复此选项可指
定多个列表项。如果填充此选项,将无法查看未包含在此列表中的组。
--listable-users < 字符串 >
指定在启用了 --restrict-listable 的情况下可在此提供程序中查看的用户的列表。重复此选项可
指定多个列表项。如果填充此选项,将无法查看未包含在此列表中的用户。
--login-shell < 路径 >
为通过 SSH 访问文件系统的用户指定用户登录 Shell 的路径名。
--member-lookup-method {default | rfc2307bis}
设置执行组成员查找的方法。直接更改此选项时请格外小心。
--member-of-attribute < 字符串 >
设置在 LDAP 中搜索反向成员关系时要使用的属性。此 LDAP 值应当是 posixAccount 用户类型的属性,
该用户类型描述 POSIX 用户是其成员的组。
--name-attribute < 字符串 >
指定包含用作登录名的 UID 的 LDAP 属性。默认值为 uid。
--netgroup-base-dn < 字符串 >
指定用于开始在 LDAP 中搜索网络组的条目的可分辨名称。
--netgroup-filter < 字符串 >
设置网络组对象的 LDAP 筛选器。
--netgroup-members-attribute < 字符串 >
指定包含网络组成员的 LDAP 属性。默认值为 memberNisNetgroup。
--netgroup-search-scope < 范围 >
定义在 LDAP 中执行网络组搜索的基本可分辨名称 (DN) 的深度。
以下值有效:

default 应用 --search-scope 中的设置。


注: 不能指定 --search-scope=default。例如,如果指定 --group-
search-scope=default,搜索范围将设置为 --search-scope 的值。

base 仅在基本 DN 中搜索条目。

102 OneFS isi 命令 A 至 C


onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN。

--netgroup-triple-attribute < 字符串 >


指定包含网络三元组的 LDAP 属性。默认值为 nisNetgroupTriple。
--normalize-groups {yes | no}
在查找前将组名称规范为小写。
--normalize-users {yes | no}
在查找前将用户名规范为小写。
--nt-password-attribute < 字符串 >
指定包含 Windows 密码的 LDAP 属性。常用值是 ntpasswdhash。
--ntlm-support {all | v2only | none}
对于具有 NTLM 兼容凭据的用户,指定支持的 NTLM 版本。
--provider-domain < 字符串 >
指定提供程序用于确定用户名和组名称的域。
--require-secure-connection {yes | no}
指定是否需要 TLS 连接。
--restrict-findable {yes | no}
指定是否检查提供程序,以查看可查找和不可查找用户和组的筛选列表。
--restrict-listable {yes | no}
指定是否检查提供程序,以查看可列出和不可列出的用户和组的筛选列表。
--search-scope < 范围 >
定义执行 LDAP 搜索的基本可分辨名称 (DN) 的默认深度。
以下值有效:

base 仅在基本 DN 中搜索条目。


onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN 本身。

--search-timeout < 整数 >


指定停止重试并且搜索失败之前的秒数。默认值为 100。
--shadow-user-filter < 字符串 >
设置卷影用户对象的 LDAP 筛选器。
--shadow-expire-attribute < 字符串 >
设置表示帐户到期的绝对日期的属性名称。
--shadow-flag-attribute < 字符串 >
设置指示用于存储标记值的卷影映射部分的属性名称。
--shadow-inactive-attribute < 字符串 >
设置指示用户允许的非活动天数的属性名称。
--shadow-last-change-attribute < 字符串 >
设置指示上次更改卷影信息的属性名称。
--shadow-max-attribute < 字符串 >
设置指示密码有效的最大天数的属性名称。
--shadow-min-attribute < 字符串 >
设置指示卷影更改之间的最小天数的属性名称。
--shadow-warning-attribute < 字符串 >

OneFS isi 命令 A 至 C 103


设置指示密码过期以警告用户前的天数的属性名称。
--shell-attribute < 字符串 >
指定包含用户的 UNIX 登录 Shell 的 LDAP 属性。默认值为 loginShell。
--ssh-public-key-attribute < 字符串 >
设置包含用户 SSH 公钥的属性名称。
--uid-attribute < 字符串 >
指定包含 UID 编号的 LDAP 属性。默认值为 uidNumber。
--unfindable-groups < 字符串 >
如果启用了 --restrict-findable 而可查找组列表为空,则指定无法由该提供程序解析的组列表。
重复此选项可指定多个列表项。
--unfindable-users < 字符串 >
如果启用了 --restrict-findable 而可查找用户列表为空,则指定无法由该提供程序解析的用户列
表。重复此选项可指定多个列表项。
--unique-group-members-attribute < 字符串 >
指定包含唯一组成员的 LDAP 属性。该属性用于确定当按用户的 DN 而不是用户名查询 LDAP 服务器时
用户所属的组。此设置无默认值。
--unlistable-groups < 字符串 >
如果启用了 --restrict-listable 而可列表组列表为空,则指定无法由这一无法查看的提供程序列
出的组列表。重复此选项可指定多个列表项。
--unlistable-users < 字符串 >
如果启用了 --restrict-listable 而可列表用户列表为空,则指定无法由这一无法查看的提供程序
列出的用户列表。重复此选项可指定多个列表项。
--user-base-dn < 字符串 >
指定用于开始在 LDAP 中搜索用户的条目的可分辨名称。
--user-domain < 字符串 >
指定提供程序用于确定用户的域。默认用户域为 LDAP_USERS。
--user-filter < 字符串 >
设置用户对象的 LDAP 筛选器。
--user-search-scope < 范围 >
定义在 LDAP 中执行用户搜索的基本可分辨名称 (DN) 的深度。
以下值有效:

default 应用在默认查询设置中定义的搜索范围。
base 仅在基本 DN 中搜索条目。
onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN 本身。

--groupnet <groupnet>
指定 LDAP 提供程序引用的 groupnet。groupnet 是顶层网络容器,用于管理针对 DNS 名称服务器的主
机名解析且包含子网和 IP 地址池。groupnet 指定与外部服务器通信时 LDAP 提供程序将使用的网络属
性。
--template {default | rfc-2307 | ad-idmu | ldapsam}
指定要用于配置 LDAP 提供程序的模板。模板提供预先选择的属性。模板有:RFC 2307、Active
Directory Identity Management for UNIX (ad-idmu) 和 LDAP for Samba (ldapsam)。
--bind-password < 字符串 >
设置绑定到 LDAP 服务器时所使用的可分辨名称的密码。要以交互方式设置密码,请使用 --set-
bind-password 选项。
--set-bind-password
以交互方式设置绑定到 LDAP 服务器时所使用的可分辨名称的密码。此选项不能与 --bind-password
配合使用。

104 OneFS isi 命令 A 至 C


[--force | -f
指定在创建或修改 LDAP 提供程序时忽略警告。
{--verbose | -v}
显示运行命令的结果。

isi auth ldap delete


删除 LDAP 提供程序。

语法
isi auth ldap delete <provider-name>
[--force]
[--verbose]

选项
< 提供程序名称 >
指定要删除的提供程序的名称。
{--force | -f}
禁止显示命令行提示符和消息。
< 提供程序名称 >
指定要删除的提供程序的名称。
{--verbose | -v}
显示更多详细信息。

isi auth ldap list


显示 LDAP 提供程序列表。

语法
isi auth ldap list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。

OneFS isi 命令 A 至 C 105


{--verbose | -v}
显示更多详细信息。

isi auth ldap modify


修改 LDAP 提供程序。

语法
isi auth ldap modify <provider-name>
[--name <string>]
[--base-dn <string>]
[--server-uris <string>]
[--add-server-uris <string>]
[--remove-server-uris <string>]
[--alternate-security-identities-attribute <string>]
[--authentication {yes | no}]
[--balance-servers {yes | no}]
[--bind-dn <string>]
[--bind-timeout <integer>]
[--certificate-authority-file <string>]
[--check-online-interval <duration>]
[--cn-attribute <string>]
[--create-home-directory {yes | no}]
[--crypt-password-attribute <string>]
[--email-attribute <string>]
[--enabled {yes | no}]
[--enumerate-groups {yes | no}]
[--enumerate-users {yes | no}]
[--findable-groups <string>]
[--clear-findable-groups]
[--add-findable-groups <string>]
[--remove-findable-groups <string>]
[--findable-users <string>]
[--clear-findable-users]
[--add-findable-users <string>]
[--remove-findable-users <string>]
[--gecos-attribute <string>]
[--gid-attribute <string>]
[--group-base-dn <string>]
[--group-domain <string>]
[--group-filter <string>]
[--group-members-attribute <string>]
[--group-search-scope <scope>]
[--homedir-attribute <string>]
[--home-directory-template <string>]
[--ignore-tls-errors {yes | no}]
[--listable-groups <string>]
[--clear-listable-groups]
[--add-listable-groups <string>]
[--remove-listable-groups <string>]
[--listable-users <string>]
[--clear-listable-users]
[--add-listable-users <string>]
[--remove-listable-users <string>]
[--login-shell <string>]
[--member-lookup-method {default | rfc2307bis}]
[--member-of-attribute <string>]
[--name-attribute <string>]
[--netgroup-base-dn <string>]
[--netgroup-filter <string>]
[--netgroup-members-attribute <string>]
[--netgroup-search-scope <scope>]
[--netgroup-triple-attribute <string>]
[--normalize-groups {yes | no}]
[--normalize-users {yes | no}]
[--nt-password-attribute <string>]

106 OneFS isi 命令 A 至 C


[--ntlm-support {all | v2only | none}]
[--provider-domain <string>]
[--require-secure-connection {yes | no}]
[--restrict-findable {yes | no}]
[--restrict-listable {yes | no}]
[--search-scope <scope>]
[--search-timeout <integer>]
[--shadow-user-filter <string>]
[--shadow-expire-attribute <string>]
[--shadow-flag-attribute <string>]
[--shadow-inactive-attribute <string>]
[--shadow-last-change-attribute <string>]
[--shadow-max-attribute <string>]
[--shadow-min-attribute <string>]
[--shadow-warning-attribute <string>]
[--shell-attribute <string>]
[--ssh-public-key-attribute <string>]
[--uid-attribute <string>]
[--unfindable-groups <string>]
[--clear-unfindable-groups]
[--add-unfindable-groups <string>]
[--remove-unfindable-groups <string>]
[--unfindable-users <string>]
[--clear-unfindable-users]
[--add-unfindable-users <string>]
[--remove-unfindable-users <string>]
[--unique-group-members-attribute <string>]
[--unlistable-groups <string>]
[--clear-unlistable-groups]
[--add-unlistable-groups <string>]
[--remove-unlistable-groups <string>]
[--unlistable-users <string>]
[--clear-unlistable-users]
[--add-unlistable-users <string>]
[--remove-unlistable-users <string>]
[--user-base-dn <string>]
[--user-domain <string>]
[--user-filter <string>]
[--user-search-scope <scope>]
[--template {default | rfc2307 | ad-idmu | ldapsam}
[--bind-password <string>]
[--set-bind-password]
[--force | -f]
[--verbose | -v]

选项
< 提供程序名称 >
指定要修改的 LDAP 提供程序的名称。
--name < 字符串 >
指定身份认证提供程序的新名称。
--base-dn < 字符串 >
设置要在其中搜索身份的树的根。例如,CN=Users,DC=mycompany,DC=com。
--server-uris < 字符串 >
指定访问服务器时要使用的 LDAP 服务器 URI 的列表。重复此选项可指定多个列表项。
以如下格式指定 LDAP 服务器 URI:ldaps://< 服务器 >:< 端口 >(安全 LDAP)或 ldap://< 服务器 >:< 端口 >
(非安全 LDAP)。
服务器可指定为 IPv4 地址、IPv6 地址或主机名。
如果您不指定端口号,将使用默认端口 389(安全 LDAP)或 636(非安全 LDAP)。

注: 如果您指定非安全 LDAP,绑定密码将以明文形式传输到服务器。

--add-server-uris < 字符串 >。


向服务器 URI 列表添加条目。重复此选项可指定多个列表项。

OneFS isi 命令 A 至 C 107


要添加的服务器可指定为 IPv4 地址、IPv6 地址或主机名。
--remove-server-uris < 字符串 >
从服务器 URI 列表中删除条目。重复此选项可指定多个列表项。
要删除的服务器可指定为 IPv4 地址、IPv6 地址或主机名。
--alternate-security-identities-attribute < 字符串 >
指定搜索备选安全身份时要使用的名称。OneFS 尝试将 Kerberos 主体解析到用户时会使用该名称。
--authentication {yes | no}
启用或禁用将此提供程序用于身份认证以及身份。默认值为 yes。
--balance-servers {yes | no}
使该提供程序针对每个请求连接到随机服务器。
--bind-dn < 字符串 >
指定绑定到 LDAP 服务器时要使用的可分辨名称。例如,
CN=myuser,CN=Users,DC=mycompany,DC=com。
--bind-timeout < 整数 >
指定绑定到 LDAP 服务器时的超时时间(以秒为单位)。
--certificate-authority-file < 路径 >
指定根证书文件的路径。
--check-online-interval < 持续时间 >
指定提供程序执行在线检查的间隔时间,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--cn-attribute < 字符串 >
指定包含通用名称的 LDAP 属性。默认值为 cn。
--create-home-directory {yes | no}
指定是否在用户首次登录时创建主目录(如果尚不存在用户的主目录)。通过 --home-directory-
template 命令在路径模板中指定目录路径。
--crypt-password-attribute < 字符串 >
指定包含 UNIX 密码的 LDAP 属性。此设置无默认值。
--email-attribute < 字符串 >
指定包含电子邮件地址的 LDAP 属性。默认值为 mail。
--enabled {yes | no}
启用或禁用此提供程序。
--enumerate-groups {yes | no}
指定是否允许提供程序枚举组。
--enumerate-users {yes | no}
指定是否允许提供程序枚举用户。
--findable-groups < 字符串 >
指定在启用了 --restrict-findable 的情况下可在此提供程序中找到的组的列表。重复此选项可指
定多个列表项。如果填充此选项,将无法在此提供程序中解析未包含在此列表中的组。此选项会覆盖可
查找组列表中的条目;要在不影响当前条目的情况下添加或删除组,请使用 --add-findable-
groups 或 --remove-findable-groups。
--clear-findable-groups
删除可查找组的列表。
--add-findable-groups < 字符串 >
在启用了 --restrict-findable 的情况下向已选中的可查找组列表添加条目。重复此选项可指定多
个列表项。
--remove-findable-groups < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的可查找组列表中删除条目。重复此选项可指定
多个列表项。
--findable-users < 字符串 >
指定在启用了 --restrict-findable 的情况下可在此提供程序中找到的用户的列表。重复此选项可
指定多个列表项。如果填充此选项,将无法在此提供程序中解析未包含在此列表中的用户。此选项会覆

108 OneFS isi 命令 A 至 C


盖可查找用户列表中的条目;要在不影响当前条目的情况下添加或删除用户,请使用 --add-
findable-users 或 --remove-findable-users。
--clear-findable-users
删除可查找用户的列表。
--add-findable-users < 字符串 >
在启用了 --restrict-findable 的情况下向已选中的可查找用户列表添加条目。重复此选项可指定
多个列表项。
--remove-findable-users < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的可查找用户列表中删除条目。重复此选项可指
定多个列表项。
--gecos-attribute < 字符串 >
指定包含 GECOS 字段的 LDAP 属性。默认值为 gecos。
--gid-attribute < 字符串 >
指定包含 GID 的 LDAP 属性。默认值为 gidNumber。
--group-base-dn < 字符串 >
指定用于开始在 LDAP 中搜索组的条目的可分辨名称。
--group-domain < 字符串 >
指定该提供程序将用于确定组的域。默认组域为 LDAP_GROUPS。
--group-filter < 字符串 >
设置组对象的 LDAP 筛选器。
--group-members-attribute < 字符串 >
指定包含组成员的 LDAP 属性。默认值为 memberUid。
--group-search-scope < 范围 >
定义在 LDAP 中执行组搜索的基本可分辨名称 (DN) 的默认深度。
以下值有效:

default 应用 --search-scope 中的设置。

注:

不能指定 --search-scope=default。例如,如果指定 --group-search-


scope=default,搜索范围将设置为 --search-scope 的值。

base 仅在基本 DN 中搜索条目。


onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN。

--home-directory-template < 路径 >


指定要用作主目录命名模板的路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符序列
将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户名、提
供程序域名和分区名称。有关更多信息,请参见“主目录”部分。
--homedir-attribute < 字符串 >
指定搜索主目录时使用的 LDAP 属性。默认值为 homeDirectory。
--ignore-tls-errors {yes | no}
即使身份检查失败,也可通过安全连接继续。
--listable-groups < 字符串 >
指定在启用了 --restrict-listable 的情况下可在此提供程序中查看的组的列表。重复此选项可指
定多个列表项。如果填充此选项,将无法在此提供程序中查看未包含在此列表中的组。此选项会覆盖可
列表组列表中的条目;要在不影响当前条目的情况下添加或删除组,请使用 --add-listable-
groups 或 --remove-listable-groups。
--clear-listable-groups
从可查看组列表中删除所有条目。

OneFS isi 命令 A 至 C 109


--add-listable-groups < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的可列表组列表添加条目。重复此选项可指定多
个列表项。
--remove-listable-groups < 字符串 >
在启用了 --restrict-listable 的情况下从已选中的可查看组列表中删除条目。重复此选项可指定
多个列表项。
--listable-users < 字符串 >
指定在启用了 --restrict-listable 的情况下可在此提供程序中查看的用户的列表。重复此选项可
指定多个列表项。如果填充此选项,将无法在此提供程序中查看未包含在此列表中的用户。此选项会覆
盖可列表用户列表中的条目;要在不影响当前条目的情况下添加或删除用户,请使用 --add-
listable-users 或 --remove-listable-users。
--clear-listable-users
从可查看用户列表中删除所有条目。
--add-listable-users < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的可列表用户列表添加条目。重复此选项可指定
多个列表项。
--remove-listable-users < 字符串 >
在启用了 --restrict-listable 的情况下从已选中的可查看用户列表中删除条目。重复此选项可指
定多个列表项。
--login-shell < 路径 >
为通过 SSH 访问文件系统的用户指定用户的登录 Shell 的路径名。
--member-lookup-method {default | rfc2307bis
设置执行组成员查找的方法。直接更改此选项时请格外小心。
--member-of-attribute < 字符串 >
设置在 LDAP 中搜索反向成员关系时要使用的属性。此 LDAP 值应当是 posixAccount 用户类型的属性,
该用户类型描述 POSIX 用户是其成员的组。
--name-attribute < 字符串 >
指定包含用作登录名的 UID 的 LDAP 属性。默认值为 uid。
--netgroup-base-dn < 字符串 >
指定用于开始在 LDAP 中搜索网络组的条目的可分辨名称。
--netgroup-filter < 字符串 >
设置网络组对象的 LDAP 筛选器。
--netgroup-members-attribute < 字符串 >
指定包含网络组成员的 LDAP 属性。默认值为 memberNisNetgroup。
--netgroup-search-scope < 范围 >
定义在 LDAP 中执行网络组搜索的基本可分辨名称 (DN) 的深度。
以下值有效:

default 应用 --search-scope 中的设置。

注:

不能指定 --search-scope=default。例如,如果指定 --group-search-


scope=default,搜索范围将设置为 --search-scope 的值。

base 仅在基本 DN 中搜索条目。


onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN。

--netgroup-triple-attribute < 字符串 >


指定包含网络三元组的 LDAP 属性。默认值为 nisNetgroupTriple。
--normalize-groups {yes | no}

110 OneFS isi 命令 A 至 C


在查找前将组名称规范为小写。
--normalize-users {yes | no}
在查找前将用户名规范为小写。
--nt-password-attribute < 字符串 >
指定包含 Windows 密码的 LDAP 属性。常用值是 ntpasswdhash。
--ntlm-support {all | v2only | none}
对于具有 NTLM 兼容凭据的用户,指定支持的 NTLM 版本。
以下值有效:
all
v2only
none
--provider-domain < 字符串 >
指定该提供程序用于确定用户名和组名称的域。
--require-secure-connection {yes | no}
指定是否需要 TLS 连接。
--restrict-findable {yes | no}
指定是否检查该提供程序,以查看可查找和不可查找用户和组的筛选列表。
--restrict-listable {yes | no}
指定是否检查该提供程序,以查看可查看和不可查看用户和组的筛选列表。
--search-scope < 范围 >
定义执行 LDAP 搜索的基本可分辨名称 (DN) 的默认深度。
以下值有效:

base 仅在基本 DN 中搜索条目。


onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN 本身。

--search-timeout < 整数 >


指定停止重试并且搜索失败之前的秒数。默认值为 100。
--shadow-user-filter < 字符串 >
设置卷影用户对象的 LDAP 筛选器。
--shadow-expire-attribute < 字符串 >
设置表示帐户到期的绝对日期的属性名称。
--shadow-flag-attribute < 字符串 >
设置指示用于存储标记值的卷影映射部分的属性名称。
--shadow-inactive-attribute < 字符串 >
设置指示用户允许的非活动天数的属性名称。
--shadow-last-change-attribute < 字符串 >
设置指示上次更改卷影信息的属性名称。
--shadow-max-attribute < 字符串 >
设置指示密码有效的最大天数的属性名称。
--shadow-min-attribute < 字符串 >
设置指示卷影更改之间的最小天数的属性名称。
--shadow-warning-attribute < 字符串 >
设置指示密码过期以警告用户前的天数的属性名称。
--shell-attribute < 字符串 >
指定搜索用户的 UNIX 登录 Shell 时使用的 LDAP 属性。默认值为 loginShell。

OneFS isi 命令 A 至 C 111


--ssh-public-key-attribute < 字符串 >
设置包含用户 SSH 公钥的所用属性名称。
--uid-attribute < 字符串 >
指定包含 UID 编号的 LDAP 属性。默认值为 uidNumber。
--unfindable-groups < 字符串 >
指定在启用了 --restrict-findable 的情况下无法在此提供程序中找到的组。重复此选项可指定多
个列表项。此选项会覆盖不可查找组列表中的条目;要在不影响当前条目的情况下添加或删除组,请使
用 --add-unfindable-groups 或 --remove-unfindable-groups。
--clear-unfindable-groups
从不可查找组列表中删除所有条目。
--add-unfindable-groups < 字符串 >
在启用了 --restrict-findable 的情况下向已选中的不可查找组列表添加条目。重复此选项可指定
多个列表项。
--remove-unfindable-groups < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的不可查找组列表中删除条目。重复此选项可指
定多个列表项。
--unfindable-users < 字符串 >
指定在启用了 --restrict-findable 的情况下无法在此提供程序中找到的用户。重复此选项可指定
多个列表项。此选项会覆盖不可查找用户列表中的条目;要在不影响当前条目的情况下添加或删除用
户,请使用 --add-unfindable-users 或 --remove-unfindable-users。
--clear-unfindable-users
从不可查找组列表中删除所有条目。
--add-unfindable-users < 字符串 >
在启用了 --restrict-findable 的情况下向已选中的不可查找用户列表添加条目。重复此选项可指
定多个列表项。
--remove-unfindable-users < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的不可查找用户列表中删除条目。重复此选项可
指定多个列表项。
--unique-group-members-attribute < 字符串 >
指定包含唯一组成员的 LDAP 属性。该属性用于确定当按用户的 DN 而不是用户名查询 LDAP 服务器时
用户所属的组。此设置无默认值。
--unlistable-groups < 字符串 >
指定在启用了 --restrict-listable 的情况下无法在此提供程序中列出的组。重复此选项可指定多
个列表项。此选项会覆盖不可列出组列表中的条目;要在不影响当前条目的情况下添加或删除组,请使
用 --add-unlistable-groups 或 --remove-unlistable-groups。
--clear-unlistable-groups
从不可查看组列表中删除所有条目。
--add-unlistable-groups < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的不可查看组列表添加条目。重复此选项可指定
多个列表项。
--remove-unlistable-groups < 字符串 >
在启用了 --restrict-listable 的情况下从已选中的不可查看组列表中删除条目。重复此选项可指
定多个列表项。
--unlistable-users < 字符串 >
指定在启用了 --restrict-listable 的情况下无法在此提供程序中查看的用户。重复此选项可指定
多个列表项。此选项会覆盖不可列出用户列表中的条目;要在不影响当前条目的情况下添加或删除用
户,请使用 --add-unlistable-users 或 --remove-unlistable-users。
--clear-unlistable-users
从不可查看用户列表中删除所有条目。
--add-unlistable-users < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的不可查看用户列表添加条目。重复此选项可指
定多个列表项。

112 OneFS isi 命令 A 至 C


--remove-unlistable-users < 字符串 >
在启用了 --restrict-listable 的情况下从已选中的不可查看用户列表中删除条目。重复此选项可
指定多个列表项。
--user-base-dn < 字符串 >
指定用于开始在 LDAP 中搜索用户的条目的可分辨名称。
--user-domain < 字符串 >
指定该提供程序将用于确定用户的域。默认用户域为 LDAP_USERS。
--user-filter < 字符串 >
设置用户对象的 LDAP 筛选器。
--user-search-scope < 范围 >
定义在 LDAP 中执行用户搜索的基本可分辨名称 (DN) 的深度。有效值如下所示:
以下值有效:

default 应用 --search-scope 中的设置。

注:

不能指定 --search-scope=default。例如,如果指定 --user-search-


scope=default,搜索范围将设置为 --search-scope 的值。

base 仅在基本 DN 中搜索条目。


onelevel 搜索比基本 DN 低一个级别的所有条目。
subtree 搜索基本 DN 及其下面的所有条目。
children 搜索基本 DN 下的所有条目,但不包括基本 DN。

--template {default | rfc-2307 | ad-idmu | ldapsam}


指定要用于配置 LDAP 提供程序的模板。模板提供预先选择的属性。模板提供预先选择的属性。模板
有:RFC 2307、Active Directory Identity Management for UNIX (ad-idmu) 和 LDAP for Samba
(ldapsam)。
--bind-password < 字符串 >
设置绑定到 LDAP 服务器时所使用的可分辨名称的密码。要以交互方式设置密码,请使用 --set-
bind-password 选项。
--set-bind-password
以交互方式设置绑定到 LDAP 服务器时所使用的可分辨名称的密码。此选项不能与 --bind-password
配合使用。
{--force | -f}
指定在创建或修改 LDAP 提供程序时忽略警告。
{--verbose | -v}
显示详细信息。

isi auth ldap view


显示 LDAP 提供程序的属性。

语法
isi auth ldap view <provider-name>

选项
< 提供程序名称 >

OneFS isi 命令 A 至 C 113


指定要查看的提供程序的名称。

isi auth local list


显示本地提供程序列表。

语法
isi auth local list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi auth local modify


修改本地提供程序。

语法
isi auth local modify <provider-name>
[--authentication {yes | no}]
[--create-home-directory {yes | no}]
[--home-directory-template <string>]
[--lockout-duration <duration>]
[--lockout-threshold <integer>]
[--lockout-window <duration>]
[--login-shell <string>]
[--machine-name <string>]
[--min-password-age <duration>]
[--max-password-age <duration>]
[--min-password-length <integer>]
[--password-prompt-time <duration>]
[--password-complexity{lowercase | uppercase |
numeric | symbol}]
[--clear-password-complexity]
[--add-password-complexity {lowercase | uppercase |
numeric | symbol}]
[--remove-password-complexity <string>]
[--password-history-length <integer>]
[--verbose]

114 OneFS isi 命令 A 至 C


选项
< 提供程序名称 >
指定要修改的本地提供程序的名称。
--authentication {yes | no}
将提供程序用于身份认证以及身份。 默认设置为 yes。
--create-home-directory {yes | no}
在用户首次登录时创建主目录。
--home-directory-template< 字符串 >
指定要用作主目录命名模板的路径。 该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符序列
将在创建主目录时动态替换为表示特定变量的字符串。 例如,%U、%D 和 %Z 会分别替换为用户名、提
供程序域名和分区名称。 有关更多信息,请参见“主目录”部分。
--lockout-duration< 持续时间 >
设置在多次登录尝试失败后帐户将变为不可访问的时间长度。
--lockout-threshold< 整数 >
指定帐户被锁定之前登录尝试失败的次数。
--lockout-window< 持续时间 >
设置时间段,在该时间段内必须进行由 --lockout-threshold 选项指定的失败尝试次数才能锁定帐
户。 指定持续时间的格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--login-shell< 字符串 >
指定 UNIX 登录 Shell 的路径。
--machine-name< 字符串 >
指定要用于为提供程序确定符合条件的用户名和组名称的域。
--min-password-age< 持续时间 >
设置最短密码期限,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--max-password-age< 持续时间 >
设置最长密码期限,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--min-password-length< 整数 >
设置最短密码长度。
--password-prompt-time< 持续时间 >
设置提示用户更改密码的剩余时间,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--password-complexity {lowercase | uppercase | numeric | symbol}
指定密码需要满足的条件。 密码必须至少包含每个指定选项的一个字符才会有效。 例如,如果指定
lowercase 和 numeric,则密码必须至少包含一个小写字符和一个数字才会有效。 可以使用符号,但
# 和 @ 除外。
--clear-password-complexity
清除针对其验证新密码的参数列表。
--add-password-complexity {lowercase | uppercase | numeric | symbol
添加针对其验证新密码的参数列表。 重复此命令可指定其他密码复杂性选项。
--remove-password-complexity< 字符串 >
从针对其验证新密码的参数列表中删除项目。 重复此命令可指定要删除的每个密码复杂性选项。
--password-history-length< 整数 >
指定要存储的、之前用过的密码数量以防止重用之前的密码。 最大密码历史记录长度为 24。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 115


isi auth local view
显示本地提供程序的属性。

语法
isi auth local view <provider-name>

选项
< 提供程序名称 >
指定要查看的提供程序的名称。

isi auth log-level modify


指定节点上的身份认证服务的日志记录级别。

语法
isi auth log-level modify <level>
[--verbose]

选项
< 级别 >
为当前节点设置日志级别。日志级别确定记录的信息的量。
有效值如下所示,它们按最少到最多信息的顺序排列:
● always
● error
● warning
● info
● verbose
● debug
● trace
注: 级别 verbose、debug 和 trace 可能会导致性能问题。级别 debug 和 trace 记录可能仅在
咨询 EMC Isilon 技术支持人员时才有用的信息。

{--verbose | -v}
显示详细信息。

isi auth log-level view


显示节点上的身份认证服务的日志记录级别。

语法
isi auth log-level view

116 OneFS isi 命令 A 至 C


选项
此命令没有选项。

isi auth mapping create


在源身份和目标身份之间创建手动映射,或自动为源身份生成映射。

语法
isi auth mapping create {<source>| --source-uid <integer>
| --source-gid <integer> | --source-sid <string>}
[{--uid | --gid | --sid}]
[--on-disk]
[--2way]
[{--target <string> | --target-uid <integer>
| --target-gid <string> | --target-sid <string>}]
[--zone<string>]

选项
<源>
按身份类型指定映射源,格式为< 类型 >:< 值 >— 例如 UID:2002。
--source-uid< 整数 >
按 UID 指定映射源。
--source-gid< 整数 >
按 GID 指定映射源。
--source-sid< 字符串 >
按 SID 指定映射源。
--uid
在身份不存在映射的情况下,生成映射;否则,检索已映射的 UID。
--gid
在身份不存在映射的情况下,生成映射;否则,检索已映射的 GID。
--sid
在身份不存在映射的情况下,生成映射;否则,检索已映射的 SID。
--on-disk
指定源磁盘身份应以目标身份表示。
--2way
指定双向或反向映射。
--target< 字符串 >
按身份类型指定映射目标,格式为< 类型 >:< 值 >— 例如 UID:2002。
--target-uid< 整数 >
按 UID 指定映射目标。
--target-gid< 整数 >
按 GID 指定映射目标。
--target-sid< 字符串 >
按 SID 指定映射目标。
--zone< 字符串 >
指定对其应用 ID 映射的访问分区。 如果未指定访问分区,则对默认系统分区应用映射。

OneFS isi 命令 A 至 C 117


isi auth mapping delete
删除一个或多个身份映射。

语法
isi auth mapping delete {<source>| --source-uid <integer>
| --source-gid <integer> | --source-sid <string> | --all}
[{--only-generated | --only-external | --2way | --target <string>
| --target-uid <integer> | --target-gid <integer> | --target-sid <string>}]
[--zone<string>]
[{--force | -f}]

选项
<源>
按身份类型指定映射源,格式为< 类型 >:< 值 >— 例如 UID:2002。
--source-uid < 整数 >
按 UID 指定映射源。
--source-gid < 整数 >
按 GID 指定映射源。
--source-sid < 字符串 >
按 SID 指定映射源。
--all
删除指定访问分区中的所有身份映射。若要进一步筛选,可结合 --only-generated 和 --only-
external 使用。
--only-generated
仅删除自动创建且包括从内部用户和组 ID 生成的 UID 或 GID 的身份映射。必须结合 --all 使用。
--only-external
仅删除自动创建且包括外部身份认证源中的 UID 或 GID 的身份映射。必须结合 --all 使用。
--2way
指定或删除双向或反向映射。
--target < 字符串 >
按身份类型指定映射目标,格式为< 类型 >:< 值 >— 例如 UID:2002。
--target-uid < 整数 >
按 UID 指定映射目标。
--target-gid < 整数 >
按 GID 指定映射目标。
--target-sid < 字符串 >
按 SID 指定映射目标。
--zone< 字符串 >
删除指定访问分区中的身份映射。若未指定访问分区,则从默认系统分区删除映射。
{--force | -f}
不会提示您确认要删除映射。

118 OneFS isi 命令 A 至 C


isi auth mapping dump
显示或打印内核映射数据库。

语法
isi auth mapping dump <file>
[--zone <string>]
[{--verbose | -v}]

选项
若未指定选项,将显示完整内核映射数据库。
<file>
将数据库转储到指定的本地文件,其中 <file> 是 /ifs 文件系统内的绝对路径。如果文件不存在,则
会创建该文件。如果文件存在,则会将其覆盖。
--zone < 字符串 >
显示指定访问分区中的数据库。若未指定访问分区,将显示所有映射。

示例
要查看内核映射数据库,请运行以下命令:

isi auth mapping dump

系统将显示与以下示例类似的输出:

["ZID:1", "UID:6299", [["SID:S-1-5-21-1195855716-1407", 128]]]


["ZID:1", "GID:1000000", [["SID:S-1-5-21-1195855716-513", 48]]]
["ZID:1", "SID:S-1-5-21-1195855716-1407", [["UID:6299", 144]]]
["ZID:1", "SID:S-1-5-21-1195855716-513", [["GID:1000000", 32]]]

isi auth mapping flush


刷新一个或所有身份映射的缓存。如果修改了 ID 映射规则,则刷新缓存可能比较有用。

语法
isi auth mapping flush {--all | --source <string>
| --source-uid <integer> | --source-gid <integer>
| --source-sid <string>}
[--zone<string>]

选项
必须指定 --all 或其中一个源选项。
--all
刷新群集上的所有身份映射。
--source < 字符串 >
按身份类型指定映射源,格式为< 类型 >:< 值 >— 例如 UID:2002。

OneFS isi 命令 A 至 C 119


--source-uid < 整数 >
按 UID 指定源身份。
--source-gid < 整数 >
按 GID 指定源身份。
--source-sid < 字符串 >
按 SID 指定源身份。
--zone< 字符串 >
指定源身份的访问分区。若未指定访问分区,将从默认系统分区刷新指定源身份的任何映射。

isi auth mapping import


将映射从源文件导入 ID 映射数据库。

语法
isi auth mapping import <file>
[{--replace | -r}]
[{--verbose]| -v}]

选项
< 文件 >
指定要导入的文件的完整路径。文件内容的格式必须与运行 isi auth mapping dump 命令后显示的
输出格式相同。文件必须指定 /ifs 文件系统内的绝对路径。
{--replace | -r}
使用文件内容覆盖映射数据库文件中的现有条目。
{--verbose | -v}
显示详细信息。

isi auth mapping list


显示访问分区的 ID 映射数据库。

语法
isi auth mapping list
[--zone < 字符串 >]

选项
--zone< 字符串 >
指定访问分区。

120 OneFS isi 命令 A 至 C


isi auth mapping modify
设置或修改两个身份之间的映射。

语法
isi auth mapping modify {<source>| --source-uid <integer>
| --source-gid <integer> | --source-sid <string> | --target <string>
| --target-uid <integer> | --target-gid <string> | --target-sid <string>}
[--on-disk]
[--2way]
[--zone<string>]

选项
<源>
按身份类型指定映射源,格式为< 类型 >:< 值 >— 例如 UID:2002。
--source-uid< 整数 >
按 UID 指定映射源。
--source-gid< 整数 >
按 GID 指定映射源。
--source-sid< 字符串 >
按 SID 指定映射源。
--target< 字符串 >
按身份类型指定映射目标,格式为< 类型 >:< 值 >— 例如 UID:2002。
--target-uid< 整数 >
按 UID 指定映射目标。
--target-gid< 整数 >
按 GID 指定映射目标。
--target-sid< 字符串 >
按 SID 指定映射目标。
--on-disk
指定源磁盘身份应以目标身份表示。
--2way
指定双向或反向映射。
--zone< 字符串 >
指定对其应用 ID 映射的访问分区。 如果未指定访问分区,则对默认系统分区应用映射。

isi auth mapping token


显示在身份验证期间为用户计算的访问令牌(包括用户的历史组)。

语法
isi auth mapping token {<user> | --uid <integer>
| --kerberos-principal <string>}
[--zone <string>]
[--primary-gid <integer>]
[--gid <integer>]

OneFS isi 命令 A 至 C 121


选项
此命令需要 < 用户 > 或 --uid< 整数 > 或 --kerberos-principal< 字符串 >。
< 用户 >
按名称指定用户。
--uid< 整数 >
按 UID 指定用户。
--kerberos-principal< 字符串 >
按名称指定 Kerberos 主体。例如,[email protected]
--zone< 字符串 >
指定包含映射的访问分区的名称。
--primary-gid< 整数 >
指定主 GID。
--gid< 整数 >
指定令牌 GID。重复此选项可指定多个 GID。

isi auth mapping view


显示身份的映射。

语法
isi auth mapping view {<id>| --uid <integer>
| --gid <integer> | --sid <string>}
[--nocreate]
[--zone <string>]

选项
<ID>
指定源身份类型的 ID,格式为< 类型 >:< 值 >— 例如 UID:2002。
--uid< 整数 >
按 UID 指定映射源。
--gid< 整数 >
按 GID 指定映射源。
--sid< 字符串 >
按 SID 指定映射源。
--nocreate
指定不能创建不存在的映射。
--zone
指定源身份的访问分区。 若未指定访问分区,OneFS 将显示默认系统分区中的映射。

示例
以下命令显示的是 zone3 访问分区中 UID 为 2002 的用户的映射:

isi auth mapping view uid:2002 --zone=zone3

系统将显示与以下示例类似的输出:

122 OneFS isi 命令 A 至 C


Type Mapping
---------- ----------------------------------------------
Name test1
On-disk UID:2002
Unix UID 2002
Unix GID None
SMB S-1-5-21-1776575851-2890035977-2418728619-1004
NFSv4 test1

isi auth netgroups view


显示有关网络组的信息。

语法
isi auth netgroups view < 网络组 >
[--zone < 字符串 >]
[--provider < 字符串 >]
[--recursive {true | false}]
[--ignore-errors {true | false}]

选项
< 网络组 >
指定网络组名称。
--zone< 字符串 >
指定访问分区。
--provider< 字符串 >
指定身份认证提供程序。
--recursive {true | false}
指定是否以递归方式解析嵌套网络组。默认值为 true。
--ignore {true | false}
指定是否忽略错误和无法解析的网络组。默认值为 false。

isi auth nis create


创建 NIS 提供程序。

语法
isi auth nis create < 名称 >
[--nis-domain < 字符串 >]
[--servers < 字符串 >]
[--authentication {yes | no}]
[--balance-servers {yes | no}]
[--check-online-interval < 持续时间 >]
[--create-home-directory {yes | no}]
[--enabled {yes | no}]
[--enumerate-groups {yes | no}]
[--enumerate-users {yes | no}]
[--findable-groups < 字符串 >]
[--findable-users < 字符串 >]
[--group-domain < 字符串 >]
[--home-directory-template < 路径 >]

OneFS isi 命令 A 至 C 123


[--hostname-lookup {yes | no}]
[--listable-groups < 字符串 >]
[--listable-users < 字符串 >]
[--login-shell < 路径 >]
[--normalize-groups {yes | no}]
[--normalize-users {yes | no}]
[--provider-domain < 字符串 >]
[--ntlm-support {全部 | v2only | none}]
[--request-timeout < 整数 >]
[--restrict-findable {yes | no}]
[--restrict-listable {yes | no}]
[--retry-time <integer>]
[--unfindable-groups < 字符串 >]
[--unfindable-users < 字符串 >]
[--unlistable-groups < 字符串 >]
[--unlistable-users < 字符串 >]
[--user-domain < 字符串 >]
[--ypmatch-using-tcp {yes | no}]
[--groupnet <groupnet>]
[--verbose]

选项
< 名称 >
设置 NIS 提供程序的名称。
--nis-domain< 字符串 >
指定 NIS 域名。
--servers< 字符串 >
指定要由该提供程序使用的 NIS 服务器的列表。以 IPv4 地址或主机名指定 NIS 服务器。重复此选项可指
定多个列表项。
--authentication {yes | no}
启用或禁用将提供程序用于身份认证以及身份。默认值为 yes。
--balance-servers {yes | no}
使提供程序针对每个请求连接到随机服务器。
--check-online-interval< 持续时间 >
指定提供程序执行在线检查的间隔时间,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--create-home-directory {yes | no}
指定是否在用户首次登录时创建主目录(如果尚不存在用户的主目录)。
--enabled {yes | no}
启用或禁用提供程序。
--enumerate-groups {yes | no}
指定是否允许提供程序枚举组。
--enumerate-users {yes | no}
指定是否允许提供程序枚举用户。
--findable-groups< 字符串 >
指定在启用了 --restrict-findable 的情况下可在该提供程序中找到的组。重复此选项可指定多个
列表项。如果填充此选项,将无法解析未包含在此列表中的组。
--findable-users< 字符串 >
指定在启用了 --restrict-findable 的情况下可在该提供程序中找到的用户。重复此选项可指定多
个列表项。如果填充此选项,将无法解析未包含在此列表中的用户。
--group-domain< 字符串 >
指定该提供程序将用于确定组的域。默认组域为 NIS_GROUPS。
--home-directory-template< 路径 >
指定要用作主目录命名模板的路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符序列
将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户名、提
供程序域名和分区名称。有关更多信息,请参见“主目录”部分。

124 OneFS isi 命令 A 至 C


--hostname-lookup {yes | no}
启用或禁用主机名查找。
--listable-groups< 字符串 >
指定在启用了 --restrict-listable 的情况下可在该提供程序中查看的组。重复此选项可指定多个
列表项。如果填充此选项,将无法查看未包含在此列表中的组。
--listable-users< 字符串 >
指定在启用了 --restrict-listable 的情况下可在该提供程序中查看的用户。重复此选项可指定多
个列表项。如果填充此选项,将无法查看未包含在此列表中的用户。
--login-shell< 路径 >
指定用户登录 Shell 的路径。此设置仅适用于通过 SSH 访问文件系统的用户。
--normalize-groups {yes | no}
在查找前将组名称规范为小写。
--normalize-users {yes | no}
在查找前将用户名规范为小写。
--provider-domain< 字符串 >
指定该提供程序用于确定用户名和组名称的域。
--ntlm-support {all | v2only | none}
对于具有 NTLM 兼容凭据的用户,指定支持的 NTLM 版本。有效值是 all、v2only 和 none。
NTLMv2 通过 NTLM 提供额外的安全性。
--request-timeout< 整数 >
指定请求超时间隔(以秒为单位)。默认值为 20。
--restrict-findable {yes | no}
指定是否检查该提供程序,以查看可查找和不可查找用户和组的筛选列表。
--restrict-listable {yes | no}
指定是否检查该提供程序,以查看可查看和不可查看用户和组的筛选列表。
--retry-time< 整数 >
设置超时期限(以秒为单位),超过该期限后,将重试请求。默认值为 5。
--unfindable-groups< 字符串 >
如果启用了 --restrict-findable 而可查找组列表为空,则指定无法由该提供程序解析的组。重复
此选项可指定多个列表项。
--unfindable-users< 字符串 >
如果启用了 --restrict-findable 而可查找用户列表为空,则指定无法由该提供程序解析的用户。
重复此选项可指定多个列表项。
--unlistable-groups< 字符串 >
如果启用了 --restrict-listable 而可列表组列表为空,则指定无法由该提供程序查看的组。重复
此选项可指定多个列表项。
--unlistable-users< 字符串 >
如果启用了 --restrict-listable 而可列表用户列表为空,则指定无法由该提供程序查看的用户。
重复此选项可指定多个列表项。
--user-domain < 字符串 >
指定该提供程序将用于确定用户的域。默认用户域为 NIS_USERS。
--ypmatch-using-tcp {yes | no}
将 TCP 用于 YP Match 操作。
--groupnet<groupnet>
指定 NIS 提供程序引用的 groupnet。groupnet 是顶层网络容器,用于管理针对 DNS 名称服务器的主机
名解析且包含子网和 IP 地址池。groupnet 指定与外部服务器通信时 NIS 提供程序将使用的网络属性。
{--verbose | -v}
显示运行命令的结果。

OneFS isi 命令 A 至 C 125


isi auth nis delete
删除 NIS 提供程序。

语法
isi auth nis delete <provider-name>
[--force]
[--verbose]

选项
< 提供程序名称 >
指定要删除的提供程序的名称。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
在运行命令之后返回成功或失败消息。

isi auth nis list


显示 NIS 提供程序列表,并指示提供程序是否正常运行。

语法
isi auth nis list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

126 OneFS isi 命令 A 至 C


isi auth nis modify
修改 NIS 提供程序。

语法
isi auth nis modify <provider-name>
[--name <string>]
[--nis-domain <string>]
[--servers <string>]
[--add-servers <string>]
[--remove-servers <string>]
[--authentication {yes | no}]
[--balance-servers {yes | no}]
[--check-online-interval <duration>]
[--create-home-directory {yes | no}]
[--enabled {yes | no}]
[--enumerate-groups {yes | no}]
[--enumerate-users {yes | no}]
[--findable-groups <string>]
[--clear-findable-groups]
[--add-findable-groups <string>]
[--remove-findable-groups <string>]
[--findable-users <string>]
[--clear-findable-users]
[--add-findable-users <string>]
[--remove-findable-users <string>]
[--group-domain <string>]
[--home-directory-template <string>]
[--hostname-lookup {yes | no}]
[--listable-groups <string>]
[--clear-listable-groups]
[--add-listable-groups <string>]
[--remove-listable-groups <string>]
[--listable-users <string>]
[--clear-listable-users]
[--add-listable-users <string>]
[--remove-listable-users <string>]
[--login-shell <string>]
[--normalize-groups {yes | no}]
[--normalize-users {yes | no}]
[--provider-domain <string>]
[--ntlm-support {all | v2only | none}]
[--request-timeout <integer>]
[--restrict-findable {yes | no}]
[--restrict-listable {yes | no}]
[--retry-time <integer>]
[--unfindable-groups <string>]
[--clear-unfindable-groups]
[--add-unfindable-groups <string>]
[--remove-unfindable-groups <string>]
[--unfindable-users <string>]
[--clear-unfindable-users]
[--add-unfindable-users <string>]
[--remove-unfindable-users <string>]
[--unlistable-groups <string>]
[--clear-unlistable-groups]
[--add-unlistable-groups <string>]
[--remove-unlistable-groups <string>]
[--unlistable-users <string>]
[--clear-unlistable-users]
[--add-unlistable-users <string>]
[--remove-unlistable-users <string>]
[--user-domain <string>]
[--ypmatch-using-tcp {yes | no}]
[--verbose]

OneFS isi 命令 A 至 C 127


选项
< 提供程序名称 >
指定要修改的 NIS 提供程序的名称。
--name < 字符串 >
指定身份认证提供程序的新名称。
--nis-domain < 字符串 >
指定 NIS 域名。
--servers < 字符串 >
指定要由该提供程序使用的 NIS 服务器的列表。重复此选项可指定多个列表项。以 IPv4 地址或主机名指
定 NIS 服务器。此选项会覆盖 NIS 服务器列表中的条目;要在不影响当前条目的情况下添加或删除服务
器,请使用 --add-servers 或 --remove-servers。
--add-servers < 字符串 >
向 NIS 服务器列表添加条目。重复此选项可指定多个项目。
--remove-servers < 字符串 >
从 NIS 服务器列表中删除条目。重复此选项可指定多个项目。
--authentication {yes | no}
启用或禁用将此提供程序用于身份认证以及身份。默认值为 yes。
--balance-servers {yes | no}
使该提供程序针对每个请求连接到随机服务器。
--check-online-interval < 持续时间 >
指定提供程序执行在线检查的间隔时间,格式为 < 整数 >[{Y | M | W | D | H | m | s}]。
--create-home-directory {yes | no}
指定是否在用户首次登录时创建主目录(如果尚不存在用户的主目录)。
--enabled {yes | no}
启用或禁用此提供程序。
--enumerate-groups {yes | no}
指定是否允许此提供程序枚举组。
--enumerate-users {yes | no}
指定是否允许此提供程序枚举用户。
--findable-groups < 字符串 >
指定在启用了 --restrict-findable 的情况下可在该提供程序中找到的组。重复此选项可指定多个
列表项。如果填充此选项,将无法解析未包含在此列表中的组。此选项会覆盖可查找组列表中的条目;
要在不影响当前条目的情况下添加或删除组,请使用 --add-findable-groups 或 --remove-
findable-groups。
--clear-findable-groups
从可查找组列表中删除所有条目。
--add-findable-groups < 字符串 >
在启用了 --restrict-findable 的情况下向已选中的可查找组列表添加条目。重复此选项可指定多
个列表项。
--remove-findable-groups < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的可查找组列表中删除条目。重复此选项可指定
多个列表项。
--findable-users < 字符串 >
指定在启用了 --restrict-findable 的情况下可在该提供程序中找到的用户。重复此选项可指定多
个列表项。如果填充此选项,将无法解析未包含在此列表中的用户。此选项会覆盖可查找用户列表中的
条目;要在不影响当前条目的情况下添加或删除用户,请使用 --add-findable-users 或 --
remove-findable-users。
--clear-findable-users
从可查找用户列表中删除所有条目。
--add-findable-users < 字符串 >

128 OneFS isi 命令 A 至 C


在启用了 --restrict-findable 的情况下向已选中的可查找用户列表添加条目。重复此选项可指定
多个列表项。
--remove-findable-users < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的可查找用户列表中删除条目。重复此选项可指
定多个列表项。
--group-domain < 字符串 >
指定该提供程序将用于确定组的域。默认组域为 NIS_GROUPS。
--home-directory-template < 路径 >
指定要用作主目录命名模板的路径。该路径必须以 /ifs 开头,可以包括特殊字符序列,这些字符序列
将在创建主目录时动态替换为表示特定变量的字符串。例如,%U、%D 和 %Z 会分别替换为用户名、提
供程序域名和分区名称。有关更多信息,请参见“主目录”部分。
--hostname-lookup {yes | no}
启用或禁用主机名查找。
--listable-groups < 字符串 >
指定在启用了 --restrict-listable 的情况下可在该提供程序中查看的组。重复此选项可指定多个
列表项。如果填充此选项,将无法查看未包含在此列表中的组。此选项会覆盖可列表组列表中的条目;
要在不影响当前条目的情况下添加或删除组,请使用 --add-listable-groups 或 --remove-
listable-groups。
--clear-listable-groups
从可查看组列表中删除所有条目。
--add-listable-groups < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的可查看组列表添加条目。重复此选项可指定多
个列表项。
--remove-listable-groups < 字符串 >
在启用了 --restrict-listable 的情况下从已选中的可查看组列表中删除条目。重复此选项可指定
多个列表项。
--listable-users < 字符串 >
指定在启用了 --restrict-listable 的情况下可在该提供程序中查看的用户。重复此选项可指定多
个列表项。如果填充此选项,将无法查看未包含在此列表中的用户。此选项会覆盖可列表用户列表中的
条目;要在不影响当前条目的情况下添加或删除用户,请使用 --add-listable-users 或 --
remove-listable-users。
--clear-listable-users
从可查看用户列表中删除所有条目。
--add-listable-users < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的可查看用户列表添加条目。重复此选项可指定
多个列表项。
--remove-listable-users < 字符串 >
在启用了 --restrict-listable 的情况下从已选中的可查看用户列表中删除条目。重复此选项可指
定多个列表项。
--login-shell < 路径 >
指定用户登录 Shell 的路径。此设置仅适用于通过 SSH 访问文件系统的用户。
--normalize-groups {yes | no}
在查找前将组名称规范为小写。
--normalize-users {yes | no}
在查找前将用户名规范为小写。
--provider-domain < 字符串 >
指定该提供程序用于确定用户名和组名称的域。
--ntlm-support {all | v2only | none}
对于具有 NTLM 兼容凭据的用户,指定支持的 NTLM 版本。有效值有 all、v2only 和 none。
NTLMv2 通过 NTLM 提供额外的安全。
--request-timeout < 整数 >
指定请求超时间隔(以秒为单位)。默认值为 20。

OneFS isi 命令 A 至 C 129


--restrict-findable {yes | no}
指定是否检查该提供程序,以查看可查找和不可查找用户和组的筛选列表。
--restrict-listable {yes | no}
指定是否检查该提供程序,以查看可查看和不可查看用户和组的筛选列表。
--retry-time < 整数 >
设置超时期限(以秒为单位),超过该期限后,将重试请求。默认值为 5。
--unfindable-groups < 字符串 >
指定在启用了 --restrict-findable 的情况下无法在此提供程序中找到的组。重复此选项可指定多
个列表项。此选项会覆盖不可查找组列表中的条目;要在不影响当前条目的情况下添加或删除组,请使
用 --add-unfindable-groups 或 --remove-unfindable-groups。
--clear-unfindable-groups
从不可查找组列表中删除所有条目。
--add-unfindable-groups < 字符串 >
在启用了 --restrict-findable 的情况下向已选中的不可查找组列表添加条目。重复此选项可指定
多个列表项。
--remove-unfindable-groups < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的不可查找组列表中删除条目。重复此选项可指
定多个列表项。
--unfindable-users < 字符串 >
指定在启用了 --restrict-findable 的情况下无法在此提供程序中找到的用户。重复此选项可指定
多个列表项。此选项会覆盖不可查找用户列表中的条目;要在不影响当前条目的情况下添加或删除用
户,请使用 --add-unfindable-users 或 --remove-unfindable-users。
--clear-unfindable-users
从不可查找组列表中删除所有条目。
--add-unfindable-users < 字符串 >
在启用了 --restrict-findable 的情况下向已选中的不可查找用户列表添加条目。重复此选项可指
定多个列表项。
--remove-unfindable-users < 字符串 >
在启用了 --restrict-findable 的情况下从已选中的不可查找用户列表中删除条目。重复此选项可
指定多个列表项。
--unlistable-groups < 字符串 >
指定在启用了 --restrict-listable 的情况下无法在此提供程序中列出的组。重复此选项可指定多
个列表项。此选项会覆盖不可列出组列表中的条目;要在不影响当前条目的情况下添加或删除组,请使
用 --add-unlistable-groups 或 --remove-unlistable-groups。
--clear-unlistable-groups
从不可列出组列表中删除所有条目。
--add-unlistable-groups < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的不可查看组列表添加条目。重复此选项可指定
多个列表项。
--remove-unlistable-groups < 字符串 >
在启用了 --restrict-listable 的情况下从已选中的不可查看组列表中删除条目。重复此选项可指
定多个列表项。
--unlistable-users < 字符串 >
指定在启用了 --restrict-listable 的情况下无法在此提供程序中列出的用户。重复此选项可指定
多个列表项。此选项会覆盖不可列出用户列表中的条目;要在不影响当前条目的情况下添加或删除用
户,请使用 --add-unlistable-users 或 --remove-unlistable-users。
--clear-unlistable-users
从不可查看用户列表中删除所有条目。
--add-unlistable-users < 字符串 >
在启用了 --restrict-listable 的情况下向已选中的不可查看用户列表添加条目。重复此选项可指
定多个列表项。
--remove-unlistable-users < 字符串 >

130 OneFS isi 命令 A 至 C


在启用了 --restrict-listable 的情况下从已选中的不可查看用户列表中删除条目。重复此选项可
指定多个列表项。
--user-domain < 字符串 >
指定该提供程序将用于确定用户的域。默认用户域为 NIS_USERS。
--ypmatch-using-tcp {yes | no}
将 TCP 用于 YP Match 操作。
{--verbose | -v}
显示运行命令的结果。

isi auth nis view


显示 NIS 提供程序的属性。

语法
isi auth nis view <provider-name>

选项
< 提供程序名称 >
指定要查看的提供程序的名称。

isi auth privileges


显示系统权限的列表。

语法
isi auth privileges
[--zone <string>
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--zone < 字符串 >
指定要显示系统权限的访问分区。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。
注: 使用 --verbose 选项时,输出 Read Write: No 表示权限为只读。

OneFS isi 命令 A 至 C 131


isi auth refresh
刷新身份认证系统配置设置。

语法
isi auth refresh

选项
此命令没有选项。

isi auth roles create


创建自定义角色。
此命令会创建一个空角色。要为该角色分配权限并添加成员,请运行 isi auth roles modify 命令。

语法
isi auth roles create <name>
[--description <string>]
[--zone <string>]
[--verbose]

选项
< 名称 >
指定角色的名称。
--description < 字符串 >
指定角色的描述。
--zone < 字符串 >
指定要在其中创建角色的访问分区的名称。
{--verbose | -v}
显示运行命令的结果。

isi auth roles delete


删除角色。

语法
isi auth roles delete <role>
[--zone <string>
[--force]
[--verbose]

132 OneFS isi 命令 A 至 C


选项
< 角色 >
指定要删除的角色的名称。
--zone < 字符串 >
指定要从中删除角色的访问分区的名称。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示更多详细信息。

isi auth roles list


显示角色列表。

语法
isi auth roles list
[--zone <string>]
[--limit <integer>]
[--sort {id | name | description}]
[{--descending | -d}]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--zone < 字符串 >
指定要为其列出角色的访问分区。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort {id | name | description}
指定要据以对数据进行排序的字段。
{--descending | -d}
指定按降序进行数据排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 133


isi auth roles members list
显示角色成员的列表。

语法
isi auth roles members list <role>
[--zone <string>]
[--limit <integer>]
[--sort {id | name | type}]
[{--descending | -d}]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
< 角色 >
按名称指定角色。
--zone < 字符串 >
指定要显示角色成员的访问分区。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort {id | name | type}
按指定字段对数据进行排序。
{--descending | -d}
按降序对数据进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
要查看 SystemAdmin 角色的成员,请运行以下命令:

isi auth roles members list systemadmin

在以下示例输出中,SystemAdmin 角色当前包含一个成员,即一个名为 admin 的用户:

Type Name
----------
user admin
----------
Total: 1

134 OneFS isi 命令 A 至 C


isi auth roles modify
修改角色。

语法
isi auth roles modify <role>
[--zone <string>]
[--name <string>]
[--description <string>]
[--add-group <string>]
[--remove-group <string>]
[--add-gid <integer>]
[--remove-gid <integer>]
[--add-uid <integer>]
[--remove-uid <integer>]
[--add-user <string>]
[--remove-user <string>]
[--add-sid <string>]
[--remove-sid <string>]
[--add-wellknown <string>]
[--remove-wellknown <string>]
[--add-priv <string>]
[--add-priv-ro <string>]
[--remove-priv <string>]
[--verbose]

选项
< 角色 >
指定要修改的角色的名称。
--zone < 字符串 >
指定要修改角色的分区的名称。
--name < 字符串 >
指定角色的新名称。仅适用于自定义角色。
--description < 字符串 >
指定角色的描述。
--add-group < 字符串 >
向角色添加具有指定名称的组。对每个额外项目重复此选项。
--remove-group < 字符串 >
从角色中删除具有指定名称的组。对每个额外项目重复此选项。
--add-gid < 整数 >
向角色添加具有指定 GID 的组。对每个额外项目重复此选项。
--remove-gid < 整数 >
从角色中删除具有指定 GID 的组。对每个额外项目重复此选项。
--add-uid < 整数 >
向角色添加具有指定 UID 的组。对每个额外项目重复此选项。
--remove-uid < 整数 >
从角色中删除具有指定 UID 的组。对每个额外项目重复此选项。
--add-user < 字符串 >
向角色添加具有指定名称的用户。对每个额外项目重复此选项。
--remove-user < 字符串 >
从角色中删除具有指定名称的用户。对每个额外项目重复此选项。
--add-sid < 字符串 >

OneFS isi 命令 A 至 C 135


向角色添加具有指定 SID 的用户或组。对每个额外项目重复此选项。
--remove-sid < 字符串 >
从角色中删除具有指定 SID 的用户或组。对每个额外项目重复此选项。
--add-wellknown < 字符串 >
向角色添加具有指定名称(例如 Everyone)的已知 SID。对每个额外项目重复此选项。
--remove-wellknown < 字符串 >
从角色中删除具有指定名称的已知 SID。对每个额外项目重复此选项。
--add-priv < 字符串 >
为角色添加读/写权限。仅适用于自定义角色。对每个额外项目重复此选项。
--add-priv-ro < 字符串 >
为角色添加只读权限。仅适用于自定义角色。对每个额外项目重复此选项。
--remove-priv < 字符串 >
从角色中删除权限。仅适用于自定义角色。对每个额外项目重复此选项。
{--verbose | -v}
显示运行命令的结果。

isi auth roles privileges list


显示与角色关联的权限列表。

语法
isi auth roles privileges list <role>
[--zone <string>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
< 角色 >
按名称指定角色。
--zone < 字符串 >
指定角色的访问分区。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

136 OneFS isi 命令 A 至 C


示例
要列出与内置 SecurityAdmin 角色关联的权限,请运行以下命令:

isi auth roles privileges list securityadmin

系统将显示与以下示例类似的输出:

ID
----------------------
ISI_PRIV_LOGIN_CONSOLE
ISI_PRIV_LOGIN_PAPI
ISI_PRIV_LOGIN_SSH
ISI_PRIV_AUTH
ISI_PRIV_ROLE
----------------------
Total: 5

isi auth roles view


显示角色的属性。

语法
isi auth roles view <role>
[--zone <string>

选项
< 角色 >
指定要查看的角色的名称。
--zone < 字符串 >
指定角色的访问分区。

isi auth settings acls modify


修改 OneFS 的访问控制列表 (ACL) 设置。

语法
isi auth settings acls modify
[--create-over-smb {allow | disallow}]
[--chmod {remove | replace | replace_users_and_groups | merge | deny | ignore}]
[--chmod-inheritable {yes | no}]
[--chown {owner_group_and_acl | owner_group_only | ignore}]
[--access {unix | windows}]
[--rwx {retain | full_control}]
[--group-owner-inheritance {native | parent | creator}]
[--chmod-007 {default | remove}]
[--calcmode-owner {owner_aces | owner_only}]
[--calcmode-group {group_aces | group_only}]
[--synthetic-denies {none | remove}]
[--utimes {only_owner | owner_and_write}]
[--dos-attr {deny_smb | deny_smb_and_nfs}]
[--calcmode {approx | 777}]

OneFS isi 命令 A 至 C 137


[--calcmode-traverse {ignore | require}]
[--verbose]

选项
--create-over-smb {allow | disallow}
指定是允许还是拒绝通过 SMB 创建 ACL。
注: 系统上的可继承 ACL 优先于此设置。如果已在文件夹上设置可继承 ACL,此文件夹中创建的任
何新文件和文件夹将继承此文件夹的 ACL。禁用此设置不会删除文件上当前设置的 ACL。如果您想
要清除现有的 ACL,请运行 chmod -b <mode> <file> 命令删除 ACL 并设置正确权限。

--chmod {remove | replace | replace_users_and_groups | merge | deny | ignore}


指定在具有 ACL 的文件上本地或通过 NFS 启动 chmod 操作时如何处理权限。此设置控制任何影响
UNIX 权限的元素,包括文件系统资源管理器。启用此策略设置不会改变 chmod 操作对没有 ACL 的文件
的影响。以下值有效:

删除 对于 chmod 操作,将删除任何现有的 ACL,改为设置 chmod 权限。仅当您不需


要从 Windows 中设置权限时选择此选项。
replace 删除现有 ACL 并创建等同于 UNIX 权限的 ACL。仅当您想要删除 Windows 权限,
但不想让文件具有合成 ACL 时选择此选项。
replace_users_an 删除现有 ACL 并创建等同于旧 ACL 中引用的所有用户/组的 UNIX 权限的 ACL。
d_groups 仅当您想要删除 Windows 权限,但不想让文件具有合成 ACL 时选择此选项。
merge 使用现有 ACL 合并 chmod 提供的权限。可能为每个身份(所有者、组和任何
人)修改或创建 ACE,但其他所有 ACE 保持不变。可继承 ACE 也保持不变,便
于 Windows 用户继续继承相应权限。但是,UNIX 用户可针对这三个标准身份中
的每一个身份设置特定权限。
deny 防止用户执行 NFS 和本地 chmod 操作。如果您不想允许通过 NFS 使用权限集,
请启用此设置。
ignore 如果文件具有现有 ACL,将忽略 chmod 操作,这会阻止 NFS 客户端更改 ACL。
如果已在目录上定义可继承 ACL,并且想针对权限使用此 ACL,请选择此选项。

小心: 如果您尝试在当前在具有 ACL 的文件上设置的相同权限上运行 chmod 命令,可能会导致操作


静默失败。该操作看似成功,但如果要检查群集上的权限,您会注意到 chmod 命令无任何下效果。
作为备选方案,您可以独立于当前权限运行 chmod 命令,然后执行另一个 chmod 命令恢复到原始
权限。例如,如果文件显示 755 UNIX 权限,并且您想要确认此数字,即可运行 chmod 700
file; chmod 755 file。

--chmod-inheritable {yes | no}


在 Windows 系统上,目录的 ACE 可以定义详细的继承规则。在 UNIX 系统上,不会继承模式位。如果
使通过 chmod 命令对目录创建的 ACL 可继承,对于紧密控制的环境更为安全,但可能拒绝一些原本应
有访问权限的 Windows 用户的访问。
--chown {owner_group_and_acl | owner_group_only | ignore}
更改具有一个文件或文件夹的所有权的用户或组。以下值有效:

ownder_group_a 仅修改所有者或组,这将让 chown 或 chgrp 操作可如同 UNIX 中那样执行。启


nd_acl 用此设置将修改与新旧所有者或组关联的 ACL 中的任何 ACE。
owner_group_onl 修改所有者或组和 ACL 权限,这将让 NFS chown 或 chgrp 操作可如同
y Windows 中那样运行。通过 Windows 更改文件所有者时,ACL 中的权限保持不
变。
ignore 如果文件具有现有 ACL,将忽略 chown 和 chgrp 操作,这会阻止 NFS 客户端更
改所有者或组。

注: 通过 NFS,chown 或 chgrp 操作将更改权限以及具有所有权的用户或组。例如,归用户 Joe 所


有的文件具有 rwx------ (700) 权限,指示所有者具有 rwx 权限,但其他人都没有权限。如果您运行
chown 命令将文件的所有权更改为用户 Bob,所有者权限仍为 rwx,但它们现在代表 Bob 的权限,

138 OneFS isi 命令 A 至 C


而不是失去其所有权限的 Joe。此设置不影响通过 UNIX 权限对文件执行的 UNIX chown 或 chgrp
操作,并且不影响未更改任何权限的 Windows chown 或 chgrp 操作。

--access {unix | windows}


在 UNIX 环境中,只有文件所有者或超级用户有权对文件运行 chmod 或 chown 操作。在 Windows 环境
中,您可实施此策略设置,以向用户赋予执行 chmod 操作的权限(即更改权限)或执行 chown 操作的
权限(即获得所有权),但不再提供所有权。以下值有效:

unix 仅允许文件所有者更改文件的模式或所有者,这将让 chmod 和 chown 访问权限


检查可按类似于 UNIX 的行为那样运行。
窗口 允许文件所有者和具有 WRITE_DAC 和 WRITE_OWNER 权限的用户更改文件的模
式或所有者,这将让 chmod 和 chown 访问权限检查可按类似于 Windows 的行为
那样运行。

--rwx {retain | full_control}


指定如何处理映射到 windows 权限的 rwx 权限。在 UNIX 环境中,rwx 权限指明用户或组具有读取、写
入和执行权限;并且,用户或组具有最大权限级别。
当您为文件指定 UNIX 权限时,不存储该文件的任何 ACL。由于 Windows 系统仅处理 ACL,因此在
Windows 系统上查看文件的权限时,Isilon 群集必须将 UNIX 权限转换为 ACL。此类 ACL 称为合成
ACL。合成 ACL 不存储在任何地方;而是根据需要动态生成,然后被舍弃。如果一个文件具有 UNIX 权
限,则运行 ls 文件命令以查看文件的 ACL 时,您可能会发现合成 ACL。
当您生成合成 ACL 时,Isilon 群集会将 UNIX 权限映射到 Windows 权限。Windows 支持比 UNIX 粒度更
细的权限模式,并且它指定无法轻松从 UNIX 权限映射的权限。以下值有效:

retain 保留 rwx 权限并生成仅提供读取、写入和执行权限的 ACE。


full_control 将 rwx 权限视为完全控制并生成为用户或组提供最大 Windows 权限的 ACE,方法
是添加“更改权限”权限、“获得所有权”权限和“删除”权限。

--group-owner-inheritance {native | parent | creator}


指定如何处理组所有权和权限的继承。如果您启用的设置使组所有者继承自创建者的主组,则可通过运
行 chmod 命令来设置 set-gid 位,从而逐个文件夹地覆盖此设置。这种继承仅在创建文件时适用。以下
值有效:

native 指定如果 ACL 存在于一个文件上,组所有者将继承自文件创建者的主组。如果没


有 ACL,组所有者将继承自父文件夹。
parent 指定组所有者将继承自文件的父文件夹。
creator 指定组所有者将继承自文件创建者的主组。

--chmod-007 {default | remove}


指定在运行 chmod (007) 命令时是否删除 ACL。以下值有效:

默认 设置 007 UNIX 权限,但不删除现有的 ACL。


删除 通过 UNIX 文件共享 (NFS) 从文件中删除 ACL,并且通过 chmod (007) 命令在
群集上本地删除 ACL。如果您启用此设置,务必在使用 chmod (007) 清除 ACL
后立即对文件运行 chmod 命令。在大多数情况下,您都不会想要保留文件上的
007 权限。

--calcmode-owner {owner_aces | owner_only}


指定如何近似所有者模式位。以下值有效:

owner_aces 使用所有可能的组 ACE 近似所有者模式位。这将使所有者权限比文件上的实际权


限更为广泛。
owner_only 仅使用具有所有者 ID 的 ACE 近似所有者模式位。这将使所有者权限更为准确,因
为您只会看到特定所有者的权限,而不会看到更为广泛的权限集。但是,对于
UNIX 客户端,这可能导致访问被拒绝的问题。

--calcmode-group {group_aces | group_only}


指定如何近似组模式位。以下值有效:

group_aces 使用所有可能的组 ACE 近似组模式位。这将使组权限比文件上的实际权限更为广


泛。

OneFS isi 命令 A 至 C 139


group_only 仅使用具有所有者 ID 的 ACE 近似组模式位。这将使组权限更为准确,因为您只会
看到特定组的权限,而不会看到更为广泛的权限集。但是,对于 UNIX 客户端,这
可能导致访问被拒绝的问题。

--synthetic-denies {none | remove}


指定如何处理合成 ACL。如果任何拒绝 ACE 未遵循规范的 ACL 顺序,Windows ACL 用户界面将无法显
示 ACL。要正确表示 UNIX 权限,拒绝 ACE 可能要不遵循规范的 ACL 顺序。以下值有效:

none 不会修改合成 ACL 和模式位近似值,这将防止修改合成 ACL 生成并允许根据需要


生成“deny”ACE。
小心: 此选项可能导致权限被重新排序,并且在 Windows 用户或应用程序在
Windows 中获取、修改并设置 ACL 时永久拒绝访问。

删除 生成合成 ACL 时删除 deny ACE。此设置可能导致 ACL 具有比等效模式位更为广


泛的权限。

--utimes {only_owner | owner_and_write}


指定可更改文件访问和修改时间 (utime) 的用户。

only_owner 仅允许所有者将 utime 更改为客户端特定时间,这符合 POSIX 标准。


owner_and_write 允许所有者以及具有写入访问权限的用户将 utime 修改为客户端特定时间,这限制
较少。

--dos-attr {deny_smb | deny_smb_and_nfs}


指定如何处理 NFS 和 SMB 的只读 DOS 属性。以下值有效:

deny_smb 拒绝仅通过 SMB 修改具有 DOS 只读属性的文件的权限。


deny_smb_nfs 拒绝通过 NFS 和 SMB 修改具有 DOS 只读属性的文件的权限。

--calcmode {approx | 777}


指定如何显示模式位。以下值有效:

approx 指定使用 ACL 近似模式位。显示基于 ACL 权限的 NFS 模式位的近似值。


777 如果存在 ACL,指定是否始终显示 777。如果近似的 NFS 权限比 ACL 中的权限更
小,您可能想要使用此设置,让 NFS 客户端在执行操作之前停止访问检查。在第
三方应用程序可能由于 ACL 未提供正确访问权限而被阻止的情况下,请使用此设
置。

--calcmode-traverse {ignore | require}


指定是否需要遍历权限才能使用现有 ACL 遍历目录。以下值有效:

ignore 指定不需要遍历权限。
require 指定需要遍历权限。

{--verbose | -v}
显示更多详细信息。

isi auth settings acls view


显示 OneFS 的访问控制列表 (ACL) 设置。

语法
isi auth settings acls view

140 OneFS isi 命令 A 至 C


选项
此命令没有选项。

isi auth settings global modify


修改全局身份认证设置。

语法
isi auth settings global modify
[--send-ntlmv2 {yes | no}]
[--revert-send-ntlmv2]
[--space-replacement <character>]
[--revert-space-replacement]
[--workgroup <string>]
[--revert-workgroup]
[--provider-hostname-lookup {dns-first | nis-first | disabled}]
[--user-object-cache-size <size>]
[--revert-user-object-cache-size]
[--on-disk-identity {native | unix | sid}]
[--revert-on-disk-identity]
[--rpc-block-time <duration>]
[--revert-rpc-block-time]
[--rpc-max-requests <integer>]
[--revert-rpc-max-requests]
[--unknown-gid <integer>]
[--revert-unknown-gid]
[--unknown-uid <integer>]
[--revert-unknown-uid]
[--verbose]

选项
--send-ntlmv2 {yes | no}
指定是否仅向 SMB 客户端发送 NTLMv2 响应。默认值为 no。有效值有 yes、no。默认值为 no。
--revert-send-ntlmv2
将 --send-ntlmv2 设置恢复为系统默认值。
--space-replacement < 字符 >
对于难以解析用户名和组名称中的空格的客户端,指定替代字符。请谨慎选择不使用的字符。
--revert-space-replacement
将 --space-replacement 设置恢复为系统默认值。
--workgroup < 字符串 >
指定 NetBIOS 工作组。默认值为 WORKGROUP。
--revert-workgroup
将 --workgroup 设置恢复为系统默认值。
--provider-hostname-lookup {dns-first | nis-first | disabled}
允许通过身份认证提供程序查找主机名。仅适用于 NIS。默认值为 disabled。
--user-object-cache-size < 大小 >
指定身份认证服务中安全对象缓存的最大大小(以字节为单位)。
--revert-user-object-cache-size
将 --user-object-cache-size 设置恢复为系统默认值。
--on-disk-identity < 字符串 >

OneFS isi 命令 A 至 C 141


控制要存储在磁盘上的首选身份。如果 OneFS 无法将某个身份恢复为首选格式,则将按原样存储。此设
置不影响已经存储在磁盘上的身份。
下面列出了接受的值。

native 允许 OneFS 确定要存储在磁盘上的身份。这是建议设置。


unix 始终在磁盘上存储传入的 UNIX 标识符(UID 和 GID)。
sid 在磁盘上存储传入的 Windows 安全标识符 (SID),除非 SID 是从 UNIX 标识符生
成的。如果 SID 是从 UNIX 标识符生成的,OneFS 会将其恢复为 UNIX 标识符,
并将其存储在磁盘上。

注: 要防止在更改磁盘上的身份后发生权限错误,请运行“Repair Permissions”作业并指定 convert


模式。

--revert-on-disk-identity
将 --on-disk-identity 设置设置为系统默认值。
--rpc-block-time < 整数 >
指定 ID 映射程序请求变为异步之前的时间长度(以毫秒为单位)。
--revert-rpc-block-time
将 --rpc-block-time 设置设置为系统默认值。
--rpc-max-requests < 整数 >
指定允许的并发 ID 映射程序请求的最大数。默认值为 64。
--revert-rpc-max-requests
将 --rpc-max-requests 设置设置为系统默认值。
--unknown-gid < 整数 >
将 GID 指定为用于未知(匿名)组。
--revert-unknown-gid
将 --unknown-gid 设置设置为系统默认值。
--unknown-uid < 整数 >
将 UID 指定为用于未知(匿名)用户。
--revert-unknown-uid
将 --unknown-uid 设置设置为系统默认值。
{--verbose | -v}
显示更多详细信息。

isi auth settings global view


显示全局身份认证设置。

语法
isi auth settings global view

选项
此命令没有选项。

142 OneFS isi 命令 A 至 C


示例
要查看群集中当前的身份认证设置,请运行以下命令:

isi auth settings global view

系统将显示与以下示例类似的输出:

Send NTLMv2: No Space Replacement: Workgroup: WORKGROUP Provider Hostname Lookup:


disabled Alloc Retries: 5 Cache Cred Lifetime: 15m Cache ID Lifetime: 15m On Disk
Identity: native RPC Block Time: 5s RPC Max Requests: 16 RPC Timeout: 30s System GID
Threshold: 80 System UID Threshold: 80 GID Range Enabled: Yes GID Range Min: 1000000 GID
Range Max: 2000000 UID Range Enabled: Yes UID Range Min: 1000000 UID Range Max: 2000000
Min Mapped Rid: 2147483648 Group UID: 4294967292 Null GID: 4294967293 Null UID:
4294967293 Unknown GID: 4294967294 Unknown UID: 4294967294

isi auth settings krb5 modify


修改 MIT Kerberos 身份认证提供程序的全局设置。

语法
isi auth settings krb5 modify
[--allow-weak-crypto <boolean>]
[--revert-allow-weak-crypto
[--always-send-preauth <boolean> | --revert-always-send-preauth]
[--default-realm <string>]
[--dns-lookup-kdc <boolean> | --revert-dns-lookup-kdc]
[--dns-lookup-realm <boolean> | --revert-dns-lookup-realm]
[--verbose]

选项
--allow-weak-crypto < 布尔值 >
启用 DES 加密支持。
--revert-allow-weak-crypto
将值设置为 --allow-weak-crypto 的系统默认值。
--always-send-preauth < 布尔值 >
指定是否发送 preauth。
--revert-always-send-preauth
将 --always-send-preauth 值设置为系统默认值。
--default-realm < 字符串 >
指定默认的 Kerberos 领域名称。
--dns-lookup-kdc < 布尔值 >
允许 DNS 查找密钥分发中心 (KDC)。
--revert-dns-lookup-kdc
将 --dns-lookup-kdc 值设置为系统默认值。
--dns-lookup-realm < 布尔值 >
允许 DNS 查找 Kerberos 领域名称。
--revert-dns-lookup-realm
将 --dns-lookup-realm 值设置为系统默认值。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 143


isi auth settings krb5 view
显示 MIT Kerberos 提供程序身份认证设置。

语法
isi auth settings krb5 view

isi auth settings mapping modify


查看身份映射设置。

语法
isi auth settings mapping modify
[--gid-range-enabled {yes | no}]
[--gid-range-min <integer>]
[--gid-range-max <integer>]
[--gid-range-next <integer>]
[--uid-range-enabled {yes | no}]
[--uid-range-min <integer>]
[--uid-range-max <integer>]
[--uid-range-next <integer>]
[--zone <string>]
[--verbose]

选项
如果未指定选项,将显示内核映射数据库。
--gid-range-enabled {yes | no}
通过 ID 映射服务启用 GID 的自动分配。默认启用此设置。
--gid-range-min < 整数 >
指定可供分配的 GID 范围中的下限值。默认值是 1000000。
--gid-range-max < 整数 >
指定可供分配的 GID 范围的上限值。默认值是 2000000。
--gid-range-next < 整数 >
指定要分配的下一个 GID。
--uid-range-enabled {yes | no}
通过 ID 映射服务启用 UID 的自动分配。默认启用此设置。
--uid-range-min < 整数 >
指定可供分配的 UID 范围中的下限值。默认值是 1000000。
--uid-range-max < 整数 >
指定可供分配的 UID 范围中的上限值。默认值是 2000000。
--uid-range-next < 整数 >
指定要分配的下一个 UID。
--zone < 字符串 >
指定要修改 ID 映射设置的访问分区。若未指定访问分区,将会修改默认 System 分区中的设置。
{--verbose | -v
显示更多详细信息。

144 OneFS isi 命令 A 至 C


isi auth settings mapping view
显示访问分区中的身份映射设置。

语法
isi auth settings mapping view
[--zone <string>]

选项
--zone< 字符串 >
显示指定访问分区中的映射设置。 若未指定访问分区,将显示默认 System 分区中的映射。

isi auth status


显示提供程序状态,包括可用的身份认证提供程序以及哪些提供程序运行正常。

语法
isi auth status
[--zone < 字符串 >]
[--groupnet < 字符串 >]
[--limit < 整数 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--zone < 字符串 >
按名称指定访问分区。
--groupnet < 字符串 >
按名称指定 groupnet。
--limit [ -l | < 整数 >]
指定要显示的提供程序的数量。
--format {table | json | csv | list}
以下列格式显示提供程序:表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列
表。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 145


isi auth users create
创建用户帐户。

语法
isi auth users create <name>
[--enabled {yes | no}]
[--expiry <timestamp>]
[--email <string>]
[--gecos <string>]
[--home-directory <path>]
[--password <string>]
[--password-expires {yes | no}]
[{--primary-group <name> | --primary-group-gid <integer>
| --primary-group-sid <string>}]
[--prompt-password-change {yes | no}]
[--shell <path>]
[--uid <integer>]
[--zone <string>]
[--provider <string>]
[--set-password]
[--verbose]
[--force]

选项
< 名称 >
指定用户名。
--enabled {yes | no}
启用或禁用用户。
{--expiry | -x} < 时间戳 >
指定用户帐户的到期时间,可使用日期格式 <YYYY>-<MM>-<DD> 或日期/时间格式 <YYYY>-<MM>-
<DD>T<hh>:<mm>[:<ss>]。
--email< 字符串 >
指定用户的电子邮件地址。
--gecos< 字符串 >
在用户的密码文件中指定下列 Gecos 字段条目的值:

Full Name:
Office Location:
Office Phone:
Home Phone:
Other information:

必须在逗号分隔列表中输入值,而且必须将包含空格的值放在引号内。 例如,包含这些值的 --
gecos="Jane Doe",Seattle,555-5555,,"Temporary worker" 选项将生成以下条目:

Full Name: Jane Doe


Office Location: Seattle
Office Phone: 555-5555
Home Phone:
Other information: Temporary worker

--home-directory< 路径 >
指定用户的主目录路径。
--password< 字符串 >
将用户密码设置为指定的值。 此选项不能与 --set-password 选项结合使用。

146 OneFS isi 命令 A 至 C


--password-expires {yes | no}
指定是否允许密码到期。
--primary-group< 名称 >
按名称指定用户的主组。
--primary-group-gid< 整数 >
按 GID 指定用户的主组。
--primary-group-sid< 字符串 >
按 SID 指定用户的主组。
--prompt-password-change {yes | no}
提示用户在下次登录时更改密码。
--shell< 路径 >
指定 UNIX 登录 Shell 的路径。
--uid< 整数 >
用指定的值覆盖自动分配的 UNIX 用户标识符 (UID)。 不建议设置此选项。
--zone< 字符串 >
指定在其中创建用户的访问分区。
--provider< 字符串 >
在指定的访问分区指定本地身份认证提供程序。
--set-password
以交互方式设置密码。 此选项不能与 --password 选项结合使用。
{--verbose | -v}
显示运行命令的结果。
{--force | -f}
禁止显示命令行提示符和消息。

isi auth users delete


从系统中删除本地用户。

语法
isi auth users delete {<user> | --uid <integer> | --sid <string>}
[--zone <string>]
[--provider <string>]
[--force]
[--verbose]

选项
此命令需要 < 用户 >、--uid< 整数 > 或 --sid< 字符串 >。
< 用户 >
按名称指定用户。
--uid< 整数 >
按 UID 指定用户。
--sid< 字符串 >
按 SID 指定用户。
--zone< 字符串 >
指定包含该用户的访问分区的名称。

OneFS isi 命令 A 至 C 147


--provider< 字符串 >
指定包含该用户的身份认证提供程序的名称。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示运行命令的结果。

isi auth users flush


刷新缓存用户信息。

语法
isi auth users flush

选项
此命令没有选项。

示例
要刷新所有缓存用户信息,请运行以下命令:

isi auth user flush

isi auth users list


显示用户列表。 如果未指定选项,将显示系统访问分区中的所有用户。

注: 必须指定 --domain 选项才能列出 Active Directory 用户。

语法
isi auth users list
[--domain <string>]
[--zone <string>]
[--provider <string>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--domain< 字符串 >
仅显示指定提供程序域中的用户。
--zone< 字符串 >
指定要列出其用户的访问分区。 默认访问分区为 System。

148 OneFS isi 命令 A 至 C


--provider< 字符串 >
仅显示指定身份认证提供程序中的用户。 指定提供程序的语法为 < 提供程序类型 >:< 提供程序名称 >,其
中务必使用冒号分隔符,例如 isi auth users list --provider="lsa-ldap-
provider:Unix LDAP"。
{--limit | -l} < 整数 >。
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi auth users modify


修改本地用户。

语法
isi auth users modify {<user> | --uid <integer> | --sid <string>}
[--enabled {yes | no}]
[--expiry <timestamp>]
[--unlock]
[--email <string>]
[--gecos <string>]
[--home-directory <path>]
[--password <string>]
[--password-expires {yes | no}]
[{--primary-group <string> | --primary-group-gid <integer>
| --primary-group-sid <string>}]
[--prompt-password-change {yes | no}]
[--shell <path>]
[--new-uid <integer>]
[--zone <string>]
[--add-group <name>]
[--add-gid <id>]
[--remove-group <name>]
[--remove-gid <id>]
[--provider <string>]
[--set-password]
[--verbose]
[--force]

选项
此命令需要 < 用户 >、--uid< 整数 > 或 --sid< 字符串 >。
< 用户 >
按名称指定用户。
--uid< 整数 >
按 UID 指定用户。
--sid< 字符串 >
按 SID 指定用户。
--enabled {yes | no}

OneFS isi 命令 A 至 C 149


启用或禁用用户。
{--expiry | -x} < 时间戳 >
指定用户帐户的到期时间,可使用日期格式 <YYYY>-<MM>-<DD> 或日期/时间格式 <YYYY>-<MM>-
<DD>[T<hh>:<mm>[:<ss>]。
--unlock
解锁用户帐户(如果锁定)。
--email< 字符串 >
指定用户的电子邮件地址。
--gecos< 字符串 >
在用户的密码文件中指定下列 Gecos 字段条目的值:

Full Name: Office Location: Office Phone: Home Phone: Other information:

必须在逗号分隔列表中输入值,而且必须将包含空格的值放在引号内。 例如,包含这些值的 --
gecos="Jane Doe",Seattle,555-5555,,"Temporary worker" 选项将生成以下条目:

Full Name: Jane Doe Office Location: Seattle Office Phone: 555-5555
Home Phone: Other information: Temporary worker

--home-directory< 路径 >
指定用户的主目录路径。
--password< 字符串 >
将用户密码设置为指定的值。 此选项不能与 --set-password 选项结合使用。
--password-expires {yes | no}
指定是否允许密码到期。
--primary-group< 名称 >
按名称指定用户的主组。
--primary-group-gid< 整数 >
按 GID 指定用户的主组。
--primary-group-sid< 字符串 >
按 SID 指定用户的主组。
--prompt-password-change {yes | no}
提示用户在下次登录时更改密码。
--shell< 路径 >
指定 UNIX 登录 Shell 的路径。
--new-uid< 整数 >
为用户指定新的 UID。 不建议设置此选项。
--zone< 字符串 >
指定包含该用户的访问分区的名称。
--add-group< 名称 >
指定要将用户添加到其中的组的名称。 重复此选项可指定多个列表项。
--add-gid< 整数 >
指定要将用户添加到其中的组的 GID。 重复此选项可指定多个列表项。
--remove-group< 名称 >
指定要从中删除用户的组的名称。 重复此选项可指定多个列表项。
--remove-gid< 整数 >
指定要从中删除用户的组的 GID。 重复此选项可指定多个列表项。
--provider< 字符串 >
指定以下格式的身份认证提供程序:< 类型 >:< 实例 >。 有效的提供程序类型包括 ads、ldap、nis、
file 和 local。 例如,可以将名为 auth1 的 LDAP 提供程序指定为 ldap:auth1。
--set-password

150 OneFS isi 命令 A 至 C


以交互方式设置密码。 此选项不能与 --password 选项结合使用。
{--verbose | -v}
显示运行命令的结果。
{--force | -f}
禁止显示命令行提示符和消息。

isi auth users view


显示用户的属性,包括历史安全标识符 (SID) 历史记录。

语法
isi auth users view {<user> | --uid <integer> | --sid <string>}
[--cached]
[--show-groups]
[--resolve-names]
[--show-ssh-keys]
[--zone <string>]
[--provider <string>]

选项
此命令需要 < 用户 >、--uid < 整数 > 或 --sid < 字符串 >。
< 用户 >
按名称指定用户。
--uid < 整数 >
按 UID 指定用户。
--sid < 字符串 >
按 SID 指定用户。
--cached
仅返回缓存信息。
--show-groups
显示将该用户作为成员包括在内的组。
--resolve-names
解析所有相关组和相关身份的名称。
--show-ssh-keys
显示 SSH 公钥信息。
--zone < 字符串 >
指定包含该用户的访问分区的名称。
--provider < 字符串 >
以下列格式指定包含该用户的身份认证提供程序的名称:< 类型 >:< 实例 >。有效的类型值包括 ads、
ldap、nis、file 和 local。例如,可以将名为 auth1 的 LDAP 提供程序指定为 ldap:auth1,或将
Active Directory 提供程序指定为 ads:YORK.east.com。

OneFS isi 命令 A 至 C 151


isi batterystatus list
按节点显示群集中的电池以及每个电池的状态的列表。

语法
isi batterystatus list
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi batterystatus view


显示节点电池的状态。

语法
isi batterystatus view
[--node-lnn <integer>

选项
--node-lnn < 整数 >
指定要查看的节点 LNN。如果省略,将显示本地节点的电池状态。

isi certificate authority delete


删除 TLS 证书颁发机构。

语法
isi certificate authority delete <id>
[--force]
[--verbose]

152 OneFS isi 命令 A 至 C


选项
<ID>
系统 TLS 证书标识符或名称。
{--force | -f}
不会提示您确认是否要删除策略。
{--verbose | -v}
显示确认删除了颁发机构的消息。

isi certificate authority import


导入 TLS 证书颁发机构。

isi certificate authority list


查看 TLS 证书颁发机构的列表。

语法
isi certificate authority list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer}
[--verbose]

选项
{--limit | -l} < 整数 >
要显示的证书颁发机构数。您可以指定一个整数值。
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示证书颁发机构的列表。
{--no-header | -a}
不会以 CSV 或表格输出格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 153


isi certificate authority modify
修改 TLS 证书颁发机构。

语法
isi certificate authority modify <id>
[--name <string>]
[--description <string>]
[--verbose]

选项
<ID>
证书标识符或名称。
--name < 字符串 >
管理员配置的证书标识符。
--description < 字符串 >
为方便管理而提供的描述字段,在其中可以输入有关证书的注释。
{--verbose | -v}
显示更多详细信息。

isi certificate authority view


查看 TLS 证书颁发机构。

语法
isi certificate authority view <id>
[--format {list | json]}

选项
<ID>
证书标识符或名称。
--format {list | json}
以列表或 JSON 格式显示证书颁发机构的列表。
OneFS 显示指定的 TLS 证书颁发机构。

154 OneFS isi 命令 A 至 C


isi certificate server delete
删除传输层安全 (TLS) 服务器证书。

语法
isi certificate server delete <id>
[--force]
[--verbose]

选项
<ID>
证书标识符。
{--force | -f}
跳过此命令的确认提示。
{--verbose | -v}
显示更多详细信息。

isi certificate server import


导入传输层安全 (TLS) 服务器证书和密钥。

语法
isi certificate server import <certificate-path> <certificate-key-path>
[--name <string>]
[--description <string>]
[--certificate-key-password <string>]
[--verbose]

选项
--name < 字符串 >
管理员配置的证书标识符。
<certificate-path>
TLS 证书文件(采用 PEM 格式)的本地路径。证书文件会拷贝到系统证书存储区域中,可以在导入之后
删除。这必须是 OneFS 文件系统内的绝对路径。
<certificate-key-path>
TLS 证书密钥文件(采用 PEM 格式)的本地路径。证书密钥文件会拷贝到系统证书存储区域中,出于安
全原因应在导入之后删除。
--description < 字符串 >
为方便管理而提供的描述字段,在其中可以输入有关证书的注释。
--certificate-key-password < 字符串 >
证书密钥的密码(如果私钥使用密码进行加密)。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 155


isi certificate server list
查看传输层安全 (TLS) 服务器证书的列表。

语法
isi certificate server list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer}
[--verbose]

选项
{--limit | -l}
要显示的证书服务器数。
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示证书服务器的列表。
{--no-header | -a}
不会以 CSV 或表格输出格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

isi certificate server modify


修改传输层安全 (TLS) 服务器证书。

语法
isi certificate server modify <id>
[--name]
[--description <string>]
[--verbose]

选项
<ID>
证书标识符。
--name
指定要用于连接到支持 TLS 的服务的证书的管理员配置名称。
--description < 字符串 >
为方便管理而提供的描述字段,在其中可以输入有关证书的注释。
{--verbose | -v}
显示更多详细信息。

156 OneFS isi 命令 A 至 C


isi certificate server view
查看传输层安全 (TLS) 服务器证书。

语法
isi certificate server view <id>
[--format {list | json]}

选项
<ID>
证书标识符。
--format {list | json}
以列表或 JSON 格式显示证书服务器的列表。

isi certificate settings modify


修改系统范围的 TLS 证书设置。

语法
isi certificate settings modify
[--certificate-monitor-enabled <boolean>]
[--certificate-pre-expiration-threshold <duration>]
[--default-https-certificate <string>]
[--verbose]

选项
-- 启用证书到期监视。
certificate-
monitor-
enabled <布尔值
>
-- 证书到期前的时间量,用于提醒即将到期的证书。
certificate-
pre-
expiration-
threshold <持续
时间>
--default- 指定群集的默认 HTTPS X.509 证书。
https-
certificate <
字符串>
{--verbose | 显示更多详细信息。
-v}

OneFS isi 命令 A 至 C 157


isi certificate settings view
查看系统范围的 TLS 证书设置。

语法
isi certificate settings view

选项
None

OneFS 显示系统范围的 TLS 证书设置。

isi cloud access add


将云写入访问权限添加到群集。

语法
isi cloud access add <guid>
[--expiration-date]<timestamp>
[--force
[--verbose]

选项
<guid>
云帐户的参考号或全局唯一标识符 (GUID)。
--expiration-date < 时间戳 >
将从云中删除未引用(过时)数据的日期和时间。时间戳格式为 MMDDYY:hh:mm。例如,
022016:12:00 将到期日期和时间指定为 2016 年 2 月 20 日中午 12:00。
您可以使用此命令和参数来增加(前移)群集不再看到对象的日期。
{-- force | -f}
请勿要求确认。
{--verbose | -v}
显示更多详细信息。

示例
以下示例通过指定群集 GUID 和到期日期来将云写入访问权限添加到群集:

isi cloud access add 000556bf1e82059801563f1ad44a8c155acf


--expiration-date 022016:12:00

OneFS 将显示一条消息,指明辅助群集可访问的云帐户和文件池策略,并要求确认。键入 yes,然后按 ENTER 键,以完成该过


程。

158 OneFS isi 命令 A 至 C


isi cloud access list
显示网络上具有或符合云数据写入访问权限的群集的列表。可用群集是主群集以及使用 SyncIQ 复制将数据复制到或使用 NDMP
恢复数据的任何其他群集。

语法
isi cloud access list
[--limit]<integer>
[--sort {name | guid | state}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
限制列表中显示的合格群集的数量。
--sort {name | guid | state}
根据指定类别对合格群集进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--descending | -d}
根据指定排序选项按降序输出合格群集的列表。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi cloud access remove


从指定群集中删除云写入访问权限。

语法
isi cloud access remove <guid>
[--force]
[--verbose]

选项
<guid>
要从中删除云写入访问权限的群集的参考号或全局唯一标识符 (GUID)。
{--force | -f}

OneFS isi 命令 A 至 C 159


在不要求确认的情况下执行命令。
{--verbose | -v }
显示更多详细信息。

示例
以下示例将从指定 GUID 标识的群集中删除云写入访问权限:

isi cloud access remove 000556bf1e82059801563f1ad44a8c155acf

OneFS 将显示一条消息,指明群集不再可访问的云帐户和文件池策略,并要求确认。键入 yes,然后按 ENTER 键,以完成该过


程。

isi cloud access view


显示具有或符合云数据写入访问权限的群集的详细信息。

语法
isi cloud access view <guid>

选项
<guid>
群集的参考号或全局唯一标识符 (GUID)。

isi cloud accounts create


创建将 CloudPools 连接到云存储提供商的云存储帐户。

语法
isi cloud accounts create <name> <type> <uri>
[--account-username <string>]
[--key <string>]
[--enabled {yes | no}]
[--account-id <string>]
[--telemetry-bucket <string>]
[--storage-region <string>]
[--skip-ssl-validation {yes | no}]
[--enable-ocsp {yes | no}]
[--ocsp-responder-url-required {yes | no}]
[--proxy <string>]
[--credential-provider-uri <string>]
[--credential-provider-agency <string>]
[--credential-provider-certificate <string>]
[--credential-provider-mission <string>]
[--credential-provider-proxy <string>]
[--credential-provider-role <string>]
[--force]
[--verbose]

160 OneFS isi 命令 A 至 C


选项
< 名称 >
云存储帐户的名称。
< 类型 >
云存储帐户的类型。使用以下值之一:

值 描述
isilon Dell Technologies PowerScale
ecs Dell Technologies ECS 设备
azure Microsoft Azure
s3 Amazon S3
c2s-s3 Amazon 商业云服务 S3
google Google Cloud Platform(使用互操作性访问)
alibaba- 阿里云
cloud

<uri>
云帐户 URI。此 URI 必须与提供给云供应商的 URI 匹配。
{--account-username | -u} < 字符串 >
云帐户的用户名。此名称必须与提供给云供应商的用户名相同。
--key < 字符串 >
云帐户的访问密钥或密码。云供应商会提供此信息。
--enabled {yes | no}
在创建时启用或禁用帐户。默认情况下,在创建时启用云存储帐户。要在创建时禁用帐户,请使用此设
置以及 no 选项。
--account-id < 字符串 >
必填的仅 Amazon S3 设置。首次在供应商处建立帐户时 Amazon 提供的帐户 ID 编号。
--telemetry-bucket < 字符串 >
必填的仅 Amazon S3 设置。首次在供应商处建立帐户时指定的遥测存储区名称。这是使用情况报告的存
储位置。
--storage-region < 字符串 >
Amazon S3 或 Google Storage Platform 云类型的可选参数。区域值必须与首次向云提供商建立帐户时指
定的存储区域匹配。例如,us-west-1。如果未指定区域,则云提供商会选择其默认区域。
--skip-ssl-validation {yes | no}
指定是否在连接到云提供商的存储库时绕开 SSL 证书验证。除非使用 yes 指令指定此设置,否则
OneFS 将尝试在连接时执行 SSL 证书验证。为安全起见,我们建议不启用此设置。如果要连接到企业网
络内的云提供商(例如 PowerScale 或 ECS),并且连接时遇到问题,则可以跳过 SSL 验证。
--enable-ocsp {yes | no}
仅适用于 C2S-S3 云类型。它指示是否使用 OCSP 检查身份认证证书的撤消状态。
--ocsp-responder-url-required {yes | no}
仅适用于 C2S-S3 云类型。它指示是否将没有 OCSP 响应者 URL 的证书视为有效。
--proxy < 字符串 >
应通过其将 CloudPools 流量重定向到公共云提供商以及从公共云提供商重定向这类流量的网络代理。指
定的网络代理必须已使用 isi cloud proxies create 命令创建。
--credential-provider-uri < 字符串 >
仅适用于 C2S-S3 云类型。要连接到凭据提供商的 URI。
--credential-provider-agency < 字符串 >
仅适用于 C2S-S3 云类型。连接到凭据提供商所需的机构名称。

OneFS isi 命令 A 至 C 161


--credential-provider-certificate < 字符串 >
仅适用于 C2S-S3 云类型。要连接到凭据提供商的证书的名称或 id。
--credential-provider-mission < 字符串 >
仅适用于 C2S-S3 云类型。连接到凭据提供商所需的任务名称。
--credential-provider-proxy < 字符串 >
仅适用于 C2S-S3 云类型。要连接到凭据提供商的代理的名称或 id。
--credential-provider-role < 字符串 >
仅适用于 C2S-S3 云类型。连接到凭据提供商所需的角色名称。
{--force | -f }
在不要求确认的情况下执行命令。
{--verbose | -v}
显示更多详细信息。

示例
以下示例将创建 Microsoft Azure 云帐户:

isi cloud accounts create my_azure azure https://myazure.windows.net myuser


dhgXJ9OAIahXvYmL

isi cloud accounts delete


删除云存储帐户。

小心: 删除帐户会导致永久丢失对数据的访问。实际上是在删除数据。

语法
isi cloud accounts delete <id>
[--acknowledge <string>]
[--verbose]

选项
<ID>
云帐户的名称。您可以使用 isi cloud accounts list 命令显示云帐户的名称。
--acknowledge <string>
启用删除帐户以继续操作。此参数是必需的。您必须在参数中包括一个文本字符串,如 yes、proceed
或其他字符串。
{--verbose | -v}
显示更多详细信息。

示例
以下示例将删除 Microsoft Azure 云帐户:

isi cloud accounts delete my_azure --acknowledge yes

运行该命令时,OneFS 将显示以下消息并要求确认:

162 OneFS isi 命令 A 至 C


**********************************************************************
WARNING: Deleting an account is extremely dangerous.
Continuing with this operation will result in a permanent loss of data.
Type 'confirm delete data' to proceed. Press enter to cancel:

要继续执行,请键入 confirm delete data,然后按 ENTER 键。

isi cloud accounts list


列出云帐户。

语法
isi cloud accounts list
[--limit <integer>]
[--sort {id | name | type | account_username | uri | state | bucket}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
限制列表中显示的云帐户的数量。
--sort {id | name | type | account_username | uri | state | bucket}
根据指定类别对云帐户列表进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--descending | -d}
根据指定排序选项按降序输出云帐户的列表。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi cloud accounts modify


修改云帐户。

语法
isi cloud accounts modify <id>
[--name <string>]
[--account-username <string>]
[--key <string>]
[--uri <string>]

OneFS isi 命令 A 至 C 163


[--enabled {yes | no}]
[--account-id <string>]
[--telemetry-bucket <string>]
[--storage-region <string>]
[--skip-ssl-validation {yes | no}]
[--enable-ocsp {yes | no}]
[--ocsp-responder-url-required {yes | no}]
[{--proxy <string> | --clear-proxy}]
[--skip-account-check {yes | no}]
[--credential-provider-uri <string>]
[--credential-provider-agency <string>]
[--credential-provider-certificate <string>]
[--credential-provider-mission <string>]
[--credential-provider-proxy <string>]
[--credential-provider-role <string>]
[--verbose]

选项
<ID>
云帐户的 ID。在这种情况下,ID 与云帐户名称相同。
{--name | -n} < 字符串 >
云帐户的名称。在这种情况下,名称与 ID 相同。
{--account-username | -u} < 字符串 >
云帐户的用户名。此名称必须与提供给云供应商的用户名相同。
--key < 字符串 >
云帐户的访问密钥或密码。云供应商会提供此信息。
--uri < 字符串 >
云帐户 URI。此 URI 必须与提供给云供应商的 URI 匹配。
--enabled {yes | no}
默认情况下,创建云存储帐户时,将启用它。要在创建时禁用帐户,您可以使用此设置以及 no 选项。
--account-id < 字符串 >
这是必填的仅 Amazon S3 设置。首次在供应商处建立帐户时 Amazon 提供的帐户 ID 编号。
--telemetry-bucket < 字符串 >
这是必填的仅 Amazon S3 设置。首次在供应商处建立帐户时指定的遥测存储区名称。
--storage-region < 字符串 >
这是必填的 Amazon S3、Google Cloud Platform、阿里云设置。首次在供应商处建立帐户时指定的存储
区域。例如,us-west-1。
--skip-ssl-validation {yes | no}
指定是否在连接到云提供商的存储库时绕开 SSL 证书验证。除非使用 yes 指令指定此设置,否则
OneFS 将尝试在连接时执行 SSL 证书验证。为安全起见,我们建议不启用此设置。如果要连接到企业网
络内的云提供商(如 RAN 或 ECS),并且连接时遇到问题,可以跳过 SSL 验证。
--enable-ocsp {yes | no}
仅适用于 C2S-S3 云类型。它指示是否使用 OCSP 检查身份认证证书的撤消状态。
--ocsp-responder-url-required {yes | no}
仅适用于 C2S-S3 云类型。它指示是否将没有 OCSP 响应者 URL 的证书视为有效。
{--proxy < 字符串 > | --clear-proxy}
使用 --proxy 可设置或更改用于对流向或流出公共云提供商的 CloudPools 流量进行重定向的网络代
理。指定的网络代理必须已使用 isi cloud proxies create 命令创建。
使用 --clear-proxy 可删除以前设置的代理。删除代理时,CloudPools 流量会直接流向云提供商。
--skip-account-check {yes | no}
如果设置为 yes,则 CloudPools 会跳过用于确定是否仍可以访问云存储帐户的验证步骤。建议不要跳过
此检查。
{--verbose | -v}

164 OneFS isi 命令 A 至 C


显示更多详细信息。

示例
以下示例将修改 Microsoft Azure 云帐户:

isi cloud accounts modify my_azure


--uri https://myazure.windows.net
--account-username myuser --key dhgXJ9OAIahXvYmL

isi cloud accounts view


显示云帐户的详细信息。

语法
isi cloud accounts view <id>

选项
<ID>
指定要查看的云帐户的 ID。您可以使用 isi cloud accounts list 命令获取可用云帐户的 ID。

isi cloud archive


将要归档到云的一个或多个文件排队。对于要归档的文件,它们必须与指定文件池策略匹配,或者与含云目标的任何文件池策略
匹配。

语法
isi cloud archive <files>
[--recursive {yes | no}]
[--policy <string>]
[--verbose]
[--help]

选项
< 文件 >
指定要归档的文件。为要处理的每个额外文件指定 --files。或者,您也可以指定文件匹配模式,如 /
ifs/data/archive/images/*.jpg。
{--recursive | -r} {yes | no}
指定操作是否应以递归方式应用于文件字符串中的嵌套目录。
--policy < 字符串 >
指定要应用于指定文件的文件池策略。如果指定要归档的一个或多个文件且未指定策略,OneFS 会将文
件与每个配置的文件池策略进行比较。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 165


示例
以下示例将根据特定文件池策略将多个文件归档到云:

isi cloud archive /ifs/data/images/big.jpg --file /ifs/data/huge.jpg


--policy my_policy

以下示例会将整个目录归档到云。此操作必须与现有文件池策略匹配才能成功。

isi cloud archive /ifs/data/images/*.* --recursive yes

isi cloud jobs cancel


取消使用 isi cloud archive 或 isi cloud recall 手动启动的 CloudPools 作业。您不能取消 CloudPools 系统作业
(例如高速缓存写回)。

语法

isi cloud jobs cancel <id>


[--verbose]

选项
<ID>
云作业的的 ID。运行 isi cloud jobs list 以查看所有手动和系统作业及其关联 ID 的列表。
{--verbose | -v}
显示更多详细信息。

示例
此以下示例将取消 ID 为 21 的 CloudPools 作业。

isi cloud job cancel 21

isi cloud jobs create


创建 CloudPool 作业以归档或调回文件。

语法
isi cloud jobs create {archive | recall}
[--files <string>]
[--begin-filter] <criteria> [--end-filter]
[--recursive {yes | no}]
[--accounts <string>]
[--expiration-date <timestamp>]
[--policy <string>]
[--verbose]

166 OneFS isi 命令 A 至 C


选项
{archive | recall}
作业的类型。有效条目包括 archive 和 recall。
--files < 字符串 >...
指定要应用作业的一个或多个文件或目录名称。为每个附加规范使用 --files。目录名称仅对归档作业
有效。
--begin-filter < 标准 > --end-filter
一个文件匹配筛选器,用于定义要操作的一组文件。有关 < 标准 > 的说明以及可在筛选器中使用的有效运
算符,请在命令行中输入 man isi-file-matching。
{--recursive | -r} {yes | no}
指定作业是否应以递归方式应用于嵌套目录。
--accounts < 字符串 >
仅可在 Dell EMC 技术支持指导下使用。
--expiration-date < 时间戳 >
孤立对象的到期日期。为 < 时间戳 > 使用以下格式之一:
● 与模式 'YYYY-MM-DD' 匹配的日期字符串
● 与模式 'YYYY-MM-DD[Thh:mm[:ss]]' 匹配的日期/时间字符串
--policy < 字符串 >
要在归档作业中使用的策略。
{--verbose | -v}
显示更多详细信息。

示例
对于 archive 作业,您可以指定一个或多个要归档的目录。以下命令将归档单个目录:

isi cloud jobs create archive --files /ifs/shares/dir1

以下示例归档多个目录:

isi cloud jobs create archive --files /ifs/shares/dir1 --files /ifs/shares/dir2

isi cloud jobs files list


显示指定 CloudPools 作业匹配的文件的列表。

语法

isi cloud jobs files list <job-id>


[--offset <integer>]
[--page <integer>]
[--id <boolean>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

OneFS isi 命令 A 至 C 167


选项
< 作业 ID>
作业的 ID。要在 CloudPools 中查找作业 ID 的列表,请运行 isi cloud jobs list 命令。
--offset < 整数 >
要显示的起始文件 ID 编号。
--page < 整数 >
与 limit 选项一起使用。如果存在,则在通过 limit 指定页面大小的情况下指定要显示的起始页码。此选项
将弃用;请改用 offset 选项。
--id < 布尔值 >
在所显示的每个文件之前添加 ID 编号。
{--limit | -l} < 整数 >
显示不超过指定数量的项目。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下示例将显示与特定云作业关联的文件的列表:

isi cloud jobs files list 21

isi cloud jobs list


列出 CloudPools 作业的状态,其中包括系统、归档和调回作业。

语法
isi cloud jobs list
[--limit <integer>]
[--sort {id | job_state | operation_state |effective_state | type
| state_change_time | completion_time | create_time | description}]
[--descending ]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -d} < 整数 >
显示不超过指定的项目数。

168 OneFS isi 命令 A 至 C


--sort {id | job_state | operation_state | effective_state | type | state_change_time |
completion_time | create_time | description}
按此字段进行结果排序。默认值为 id。请注意,要按 ID、描述、有效状态和类型之外的项目进行排序,
请在命令中使用 --verbose 参数。
{--descending | -d}
按降序来进行数据排序和呈现。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi cloud jobs pause


暂停云作业。可以使用 isi cloud jobs resume 命令恢复暂停的作业。

语法

isi cloud jobs pause {<id> | archive}


[--verbose]

选项
{id | archive}
要暂停的云作业的 ID,或使用 archive 关键字暂停所有云归档作业。archive 关键字将暂停所有正在运
行的归档作业,并暂停所有后续启动的作业。
要查找作业 ID,请使用 isi cloud jobs list 命令查看所有云作业的 ID。尽管有可能,但我们建议
您不要暂停在后台运行且对于正确操作至关重要的任何 CloudPools 系统作业。具体包括:

ID 描述 有效状态 类型
1 将更新的数据写入云 running cache-writeback
2 使 CloudPools 缓存过期 running cache-invalidation
4 清理云中的未引用数据 running cloud-garbage-collection
5 将更新的快照数据写入云 running snapshot-writeback
6 更新 SmartLink 文件格式 running smartlink-upgrade
7 将数据添加到 CloudPools 缓存 running cache-pre-populate

{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 169


示例
以下示例将暂停 ID 为 19 的云作业。

isi cloud jobs pause 19

以下命令将暂停所有云归档作业。

isi cloud jobs pause archive

isi cloud jobs resume


恢复暂停的云作业,或恢复所有暂停的云作业。

语法

isi cloud jobs resume {<id> | archive}


[--verbose]

选项
{<id> | archive}
要恢复的云作业的 ID,或使用 archive 恢复所有云作业。使用 isi cloud jobs list 命令查看所
有作业及其关联 ID 的列表。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将恢复一个 ID 为 26 的暂停作业:

isi cloud jobs resume 26

如果之前已暂停所有云归档作业,则以下命令将恢复所有云归档作业:

isi cloud jobs resume archive

isi cloud jobs view


显示云作业的详细信息。

语法
isi cloud jobs view <id>

选项
<ID>

170 OneFS isi 命令 A 至 C


指定云作业的的 ID。使用 isi cloud jobs list 命令查看所有作业及其关联 ID。

示例
以下命令将显示 ID 为 27 的作业的详细信息:

isi cloud jobs view 27

isi cloud pools create


创建 CloudPool 以在 OneFS 和云存储帐户之间提供连接。

语法
isi cloud pools create <name> <type> <account>
[--description <string>]
[--vendor <string>]
[--verbose]

选项
< 名称 >
CloudPool 的名称。
< 类型 >
帐户的类型。有效值有:isilon(用于 PowerScale)、ecs、azure、s3、c2s-s3、google 或
alibaba-cloud。
< 帐户 >
CloudPool 连接到的云存储帐户的名称。云存储帐户为必填且必须与 CloudPool 类型匹配。只能指定一个
云存储帐户。
--description < 字符串 >
CloudPool 的描述。
--vendor < 字符串 >
托管云存储帐户的供应商的名称。
{--verbose | -v}
显示更多详细信息。

示例
此以下命令将创建包含 Microsoft Azure 云存储帐户的 CloudPool:

isi cloud pools create my_cp azure http://myazure.microsoft.com


--description="Financial records 2013" --vendor=Microsoft

OneFS isi 命令 A 至 C 171


isi cloud pools delete
删除 CloudPool。Proceed with caution.如果您删除 CloudPool,OneFS 将不再能够访问关联云存储帐户。如果某个文件池策略
引用 CloudPool,则 OneFS 不允许删除 CloudPool。

语法
isi cloud pools delete <id>
[--force]
[--verbose]

选项
<ID>
CloudPool 的名称。您可以使用 isi cloud pools list 命令列出现有 CloudPools 及其关联 ID。
{--force | -f}
在不要求确认的情况下删除帐户。
{--verbose | -v}
显示更多详细信息。

示例
以下命令删除一个 CloudPool:

isi cloud pool delete my_azure_pool

按 ENTER 键以运行命令时,OneFS 将要求确认。键入 yes,然后按 ENTER 键。

isi cloud pools list


显示 CloudPools 的列表。

语法
isi cloud pools list
[--limit <integer>]
[--sort {id | name | type | description | vendor}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort {id | name | type | description | vendor}
按此字段进行结果排序。默认值为 id,本例中与 name 相同。除非使用 --verbose 选项,否则只能按
name 或 type 进行排序。

172 OneFS isi 命令 A 至 C


{--descending | -d}
按降序来进行数据排序和呈现。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi cloud pools modify


修改 CloudPool。

语法
isi cloud pools modify <id>
[--name <string>]
[--accounts <string> | --clear-accounts | --add-accounts <string> | --remove-accounts
<string>]
[--description <string>]
[--vendor <string>]
[--verbose]

选项
<ID>
CloudPool 的 ID。运行 isi cloud pools list 以查看所有 CloudPools 的 ID。
{--name | -n} < 字符串 >
指定 CloudPool 的新名称。
{--accounts < 字符串 > | --clear-accounts | --add-accounts < 字符串 > | --remove-accounts < 字符串 >}
添加或删除与此 Cloudpool 关联的帐户。
每个 CloudPool 仅允许一个帐户。要更改与 CloudPool 关联的帐户,我们建议您执行以下操作:
● 使用 isi cloud pools create 命令创建新的 CloudPool,并指定正确的帐户。
● 使用 isi cloud pools delete 命令删除旧 CloudPool。Proceed with caution.如果您删除
CloudPool,OneFS 将不再能够访问关联云存储帐户。
{--description | -d} < 字符串 >
提供此云池的描述。
---vendor < 字符串 >
提供托管云池帐户的供应商的名称。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 A 至 C 173


示例
以下命令会将供应商名称和描述添加到现有 CloudPool:

isi cloud pools modify my_azure --vendor Microsoft


--description "preferred azure account"

以下命令将从 CloudPool 中删除云帐户:

isi cloud pools modify my_s3 --remove-accounts s3_acct_1

isi cloud pools view


查看有关 CloudPool 的详细信息。

语法
isi cloud pools view <id>

选项
<ID>
云池的 ID。运行 isi cloud pool list 命令以查看所有 CloudPools 及其关联 ID。

示例
以下命令将显示名为 my_azure_pool 的 CloudPool 的信息。

isi cloud pools view my_azure_pool

isi cloud proxies create


创建云存储帐户可以通过其连接到云存储提供商的网络代理。

语法
isi cloud proxies create <name> <host> <type> <port>
[--username <string>]
[--password <string>]
[--verbose]

选项
< 名称 >
网络代理的名称。这可以是任何字母数字字符串,但应是简单的可识别名称。
< 主机 >
代理服务器的 DNS 名称或 IP 地址。例如,myproxy1.example.com 或 192.168.107.107。
< 类型 >
代理协议类型(socks_4、socks_5 或 http 之一)。

174 OneFS isi 命令 A 至 C


< 端口 >
要与代理服务器通信的端口号。正确的端口号取决于代理服务器上为与 CloudPools 进行通信而打开的端
口。
{--username | -u} < 字符串 >
要使用 SOCKS v5 或 HTTP 代理服务器进行身份验证的用户名。请注意,SOCKS v4 不支持身份验证。
{--password | -p} < 字符串 >
要使用 SOCKS v5 或 HTTP 代理服务器进行身份验证的密码。
{--verbose | -v}
显示更多详细信息。

示例
以下示例会创建网络代理以便与 CloudPools 结合使用:

isi cloud proxies create myproxy1 myprox1.example.com socks_5 1080


--username mycloudpools --password dhgXJ9OAIahXvYmL

isi cloud proxies delete


删除 CloudPools 中的网络代理。请注意,CloudPools 会阻止删除连接到云存储帐户的代理。

语法
isi cloud proxies delete <name>
[--force]
[--verbose]

选项
< 名称 >
网络代理的唯一 ID 或名称。您可以使用 isi cloud proxies list 命令显示代理的名称。
{--force | -f}
使代理删除可以在不进行确认的情况下继续进行。
{--verbose | -v}
显示更多详细信息。

示例
以下示例删除名为 myproxy1 的网络代理:

isi cloud accounts delete myproxy1

运行该命令时,OneFS 将显示以下消息并要求确认:

Are you sure? (yes/[no]):

要继续操作,请键入 yes,然后按 ENTER 键。如果代理连接到云存储帐户,则 OneFS 会显示以下消息:

Cannot delete proxy while used by accounts

OneFS isi 命令 A 至 C 175


isi cloud proxies list
显示在 CloudPools 中创建的网络代理的列表。

语法
isi cloud proxies list
[--limit <integer>]
[--sort {id | name | host | type | port}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
限制列表中显示的网络代理数。
--sort {id | name | host | type | port}
根据指定类别对云代理列表进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--descending | -d}
根据指定排序选项按降序输出网络代理的列表。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下示例会创建网络代理以便与 CloudPools 结合使用:

isi cloud proxies create myproxy1 myprox1.example.com socks_5 1080


--username mycloudpools --password dhgXJ9OAIahXvYmL

isi cloud proxies modify


修改网络代理的属性。

语法
isi cloud proxies modify <name>
[--name <string>]
[--host <string>]
[--type {socks_4 | socks_5 | http}]

176 OneFS isi 命令 A 至 C


[--port <integer>]
[--username <string>]
[--clear-username]
[--password <string>]
[--clear-password]
[--verbose]

选项
< 名称 >
网络代理的当前名称。
{--name | -n} < 字符串 >
网络代理的新名称。这可以是任何字母数字字符串,但应是简单的可识别名称。
--host < 字符串 >
代理服务器的 DNS 名称或 IP 地址。例如,myproxy1.example.com 或 192.168.107.107。
{--type | -t} {socks_4 | socks_5 | http}
网络代理协议(socks_4、socks_5 或 http 之一)。
--port < 整数 >
要与代理服务器通信的端口号。正确的端口号取决于代理服务器上为与 CloudPools 进行通信而打开的端
口。
{--username | -u} < 字符串 >
要使用 SOCKS v5 或 HTTP 代理服务器进行身份验证的用户名。请注意,SOCKS v4 不支持身份验证。
--clear-username
清除以前为代理服务器身份验证指定的用户名。
{--password | -p} < 字符串 >
要使用 SOCKS v5 或 HTTP 代理服务器进行身份验证的密码。
--clear-password
清除以前为代理服务器身份验证指定的密码。
{--verbose | -v}
显示更多详细信息。

示例
以下示例会修改 CloudPools 中的网络代理:

isi cloud proxies modify myproxy1 --type socks_4 --clear-username --clear-password

isi cloud proxies view


查看为 CloudPools 创建的网络代理的详细信息。

语法
isi cloud proxies view <name>

选项
< 名称 >

OneFS isi 命令 A 至 C 177


指定要查看的网络代理的 ID 或名称。您可以使用 isi cloud proxies list 命令显示可用代理的
列表。

示例
以下示例显示名为 myproxy1 的网络代理的详细信息:

isi cloud proxies view myproxy1

isi cloud recall


从云中调回文件,将完整文件恢复到其原始目录。要确保指定文件在云中存在,OneFS 将先扫描群集是否有 SmartLink 文件,
再执行调回。

语法
isi cloud recall <files>
[--begin-filter] <criteria> [--end-filter]
[--recursive {yes | no}]
[--verbose]

您还可以提供文件匹配筛选器,以指定要操作的一组文件。基本语法见下文。有关文件匹配条件的完整说明,请命令行中运行
man isi-file-matching 命令行。

选项
< 文件 >
要调回的文件。要指定多个文件,请为每个额外的文件名条目使用 --files。
[--begin-filter] < 标准 > [--end-filter]
一个文件匹配筛选器,用于定义要操作的一组文件。有关 < 标准 > 的说明以及可在筛选器中使用的有效运
算符,请在命令行中输入 man isi-file-matching。
{--recursive | -r} {yes | no}
指定调回是否应以递归方式应用于嵌套子目录。
{--verbose | -v}
显示有关操作的详细信息。

使用
isi cloud recall 命令将完整文件恢复到其原始目录,并覆盖关联的 SmartLink 文件。如果最初将文件归档到云的文件池策
略仍生效,SmartPools 作业下次运行时,调回的文件会再次归档到云。如果您不想重新归档调回的文件,则可以将文件移到不
会受文件池策略影响的其他不同目录,也可以修改或删除该策略。

示例
以下示例将从云中调回某个目录及其子目录的所有文件:

isi cloud recall /ifs/data/archives/archives2014/projects/*.*


--recursive yes

此命令将启动一个云作业。如果您使用 --verbose 参数,OneFS 将报告作业编号,如以下示例所示:

Created job [29]

178 OneFS isi 命令 A 至 C


您可以使用 isi cloud jobs view 命令以及作业编号来查看有关作业的信息。

isi cloud restore_coi


恢复群集上的云存储帐户的云对象索引 (COI)。isi cloud access add 命令也会恢复云存储帐户的 COI。

使用
小心: 除非 Dell Technologies 技术支持明确指示,否则不应执行此命令。

云对象索引 (COI) 是云对象、其保留期与使用云对象的文件(可选)之间的持久映射。执行清理(垃圾收集)时,群集使用 COI


确保可正确考虑文件和对象的所有版本。
isi cloud restore coi 命令允许群集完成 COI,以包括所有对象的所有版本。该命令可能会在以下情形中使用:
● 在 COI 条目损坏或删除的情况下处理 COI 损坏。此命令可以还原指定云帐户的 COI。
● 在对指定云帐户中的对象运行命令的群集中增加保留时间。

语法
isi cloud restore_coi
[--accounts <string>]
[--expiration-date <timestamp>]
[--verbose]

选项
--accounts < 字符串 >...
要恢复 COI 的云存储帐户的名称。通过恢复 COI,您可以让 OneFS 不仅从云中读取数据,同时还将数据
写入云。
为每个额外的云帐户使用一个额外的 --accounts 参数。
--expiration-date < 时间戳 >
指定孤立云数据对象的到期日期。
{--verbose | -v}
显示有关操作的详细信息。

示例
以下示例将恢复云存储帐户的 COI:

isi cloud restore_coi --account my_azure_acct

isi cloud settings modify


控制快照文件的归档。默认情况下启用快照的归档。
使用 isi cloud settings view 可查看当前设置。

OneFS isi 命令 A 至 C 179


语法
isi cloud settings modify
[--default-accessibility {cached | no-cache}]
[--default-cache-expiration <duration>]
[--default-compression-enabled {yes | no}]
[--default-data-retention <duration>]
[--default-encryption-enabled {yes | no}]
[--default-full-backup-retention <duration>]
[--default-incremental-backup-retention <duration>]
[--default-read-ahead <string>]
[--default-writeback-frequency <duration>]
[--verbose]

选项
--default-accessibility {cached | no-cache}
指定在没有归档文件的文件池策略的情况下访问 SmartLink(已归档)文件的默认行为。如果有归档文件
的文件池策略,则该策略及其设置优先于 --default-accessibility 设置。指定 cache 以确保只
根据高速缓存保留设置高速缓存和刷新请求的数据块或使其失效。指定 no-cache 以确保不会高速缓存
数据块,并且不会长期使用文件系统数据块。
--default-cache-expiration < 持续时间 >
缓存到期前的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九个小时的持续时间。同
样,设置 2D 将指定两天持续时间。
--default-compression-enabled {yes | no}
指定归档到云时是否要压缩数据。
--default-data-retention < 持续时间 >
从群集中删除 SmartLink 文件后与 SmartLink 文件关联的云对象将在云中保留的最短时间。不接受数字
后跟时间单位。例如,设置 9H 将指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--default-encryption-enabled {yes | no}
指定归档到云时是否要加密数据。
--default-full-backup-retention < 持续时间 >
OneFS 将保留完整 NDMP 备份已备份且后续删除的 SmartLink 文件引用的云数据的时间长度。不接受数
字后跟时间单位。例如,设置 9H 将指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--default-incremental-backup-retention < 持续时间 >
OneFS 将保留增量 NDMP 备份已备份或 SyncIQ 操作已复制且后续删除的 SmartLink 文件引用的云数据
的时间长度。不接受数字后跟时间单位。例如,设置 5Y 将指定五年持续时间。
--default-read-ahead {partial | full}
访问 SmartLink 文件时指定缓存预读策略。部分策略意味着仅缓存用户需要的数据量。完整策略意味着
用户访问 SmartLink 文件时将缓存所有文件数据。
--default-writeback-frequency < 持续时间 >
OneFS 使用本地更改更新云数据前等待的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定
九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
{--verbose | -v}
显示有关操作的信息。

示例
以下示例将修改多个默认 CloudPools 设置:

isi cloud settings modify --default-writeback-frequency 12H


--default-cache-expiration 9H --default-accessability no-cache
--default-encryption-enabled yes

180 OneFS isi 命令 A 至 C


isi cloud settings regenerate-enc ryption-key
为将归档到云的新数据生成新主加密密钥。以前加密的归档数据会继续需要以前生成的加密密钥。所有以前的加密密钥都会保
留,以用于现有归档数据。

语法
isi cloud settings regenerate-encryption-key
[--verbose]

选项
{--verbose | -v}
显示更多详细信息。

isi cloud settings view


显示 CloudPools 中的当前默认设置。您可以运行 isi cloud settings modify 命令以更改默认设置。

语法
isi cloud settings view

选项
此命令没有选项。

示例
以下示例显示了示例输出。isi cloud settings modify 的描述中包含所显示属性的说明。

B248930-PSL-1# isi cloud settings view


Default Accessibility: cached
Default Cache Expiration: 1D
Default Compression Enabled: No
Default Data Retention: 1W
Default Encryption Enabled: No
Default Full Backup Retention: 5Y
Default Incremental Backup Retention: 5Y
Default Read Ahead: partial
Default Writeback Frequency: 9H

OneFS isi 命令 A 至 C 181


isi cluster atime modify
修改群集访问时间宽限期。

语法
isi cluster atime modify
[--enabled <boolean>]
[--precision <integer>]
[--verbose]

选项
--enabled {yes 指定是否启用访问时间宽限期。
| no}
--precision < 文件访问时间更新间隔时间量(以秒为单位)。
整数>
{--verbose | 显示更多详细信息。
-v}

isi cluster atime view


查看文件系统访问时间值。

语法
isi cluster atime view

选项
None

OneFS 显示是否已启用群集访问时间宽限期,以及预测间隔(以秒为单位)。

isi cluster config


导出或导入群集配置

语法
isi cluster config <subcommand>
[--timeout <integer>]

选项
[--timeout < 整数 >]
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

182 OneFS isi 命令 A 至 C


isi cluster config exports
导出群集配置。

语法
isi cluster config exports <action>
[--timeout <integer>]

选项
[--timeout < 整数 >]
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

isi cluster config exports create


创建导出任务。

语法
isi cluster config exports create
[--components <string>]
[{--help | -h}]
[{--verbose | -v]}

选项
--components<string>...
指定要导出的组件。组件可以是 http、配额、快照、nfs、smb、s3 或 ndmp 中的全部或其中一个。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

isi cluster config exports list


列出所有配置导出任务。

语法

isi cluster config exports list


[{--limit | -l} <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[{--verbose]| -v}
[{--help | -h}

OneFS isi 命令 A 至 C 183


选项
{--limit | -l} < 整数 >
显示不超过指定数量的群集配置导出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi cluster config exports view


查看指定导出任务。

语法
isi cluster config exports view name
[{--help | -h}]

选项
名称
指定要查看的导出任务的 id 或名称。
--help | -h
显示此命令的帮助。

isi cluster config imports


导入群集配置。

语法
isi cluster config imports <action>
[--timeout <integer>]

选项
[--timeout < 整数 >]
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

184 OneFS isi 命令 A 至 C


isi cluster config imports create
创建导入任务。

语法
isi cluster config exports create <export-id>
[--components <string>]
[{--help | -h}]
[{--verbose | -v]}

选项
< 导出 id>
指定要导入的配置导出的 id。
--components<string>...
指定要导入的组件。组件可以是 http、配额、快照、nfs、smb、s3 或 ndmp 中的全部或其中一个。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

isi cluster config imports list


列出所有配置导入任务。

语法

isi cluster config imports list


[{--limit | -l} <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[{--verbose]| -v}
[{--help | -h}

选项
{--limit | -l} < 整数 >
显示不超过指定数量的群集配置导出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}

OneFS isi 命令 A 至 C 185


显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi cluster config imports view


查看指定导入任务。

语法
isi cluster config imports view name
[{--help | -h}]

选项
名称
指定要查看的导入任务的 id 或名称。
--help | -h
显示此命令的帮助。

isi cluster contact modify


修改主群集和辅助群集联系人信息。

语法
isi cluster contact modify
[--company <string>]
[--location <string>]
[--primary-name <string>]
[--primary-email <string>]
[--primary-phone1 <string>]
[--primary-phone2 <string>]
[--secondary-name <string>]
[--secondary-email <string>]
[--secondary-phone1 <string>]
[--secondary-phone2 <string>]
[--verbose]

选项
{--company | 群集联系人信息中的公司名称。
-c}
{--location | 群集联系人信息中的公司位置。
-o}
{--primary- 主群集管理联系人的姓名。
name | -n}
{--primary- 主群集管理联系人的电子邮件地址。
email | -e}

186 OneFS isi 命令 A 至 C


{--primary- 主群集管理联系人的主要电话号码。
phone1 | -p}
{--primary- 主群集管理联系人的备用电话号码。
phone2 | -P}
{--secondary- 辅助群集管理联系人的姓名。
name | -N}
{--secondary- 辅助群集管理联系人的电子邮件地址。
email | -E}
{--secondary- 辅助群集管理联系人的主要电话号码。
phone1 | -s}
{--secondary- 辅助群集管理联系人的备用电话号码。
phone2 | -S}
{--verbose | 显示更多详细信息。
-v}

isi cluster contact view


查看主群集和辅助群集管理联系人信息。

语法
isi cluster contact view
[--format (list | json]

选项
--format (list 以列表或 JSON 格式显示群集联系人信息。
| json)

OneFS 显示主群集和辅助群集联系人管理信息。

isi cluster encoding list


列出 OneFS 支持的文件系统字符编码格式。

语法
isi cluster encoding list

选项
None

OneFS 显示支持的文件系统字符编码格式的列表。

OneFS isi 命令 A 至 C 187


isi cluster encoding modify
修改当前文件系统字符编码选择。

语法
isi cluster encoding modify <current-encoding>
[--verbose]

选项
<当前编码> 输入支持的字符编码选择
{--verbose | 显示更多详细信息。
-v}

isi cluster encoding view


查看所选文件系统字符编码类型。

语法
isi cluster encoding view

选项
None

OneFS 显示所选文件系统字符编码类型。

isi cluster identity modify


修改群集的名称、描述和每日消息 (MOTD)。

语法
isi cluster identity modify
[--description <string>]
[--motd <string>]
[--motd-header <string>]
[--name <string>]
[--verbose]

选项
{--description 群集的文本说明。
| -d}
{--motd | -m} 每日群集消息。

188 OneFS isi 命令 A 至 C


{--motd-header 每日群集消息标题文本。
| -M}
{--name | -n} 安装时指定的群集名称。
{--verbose | 显示更多详细信息。
-v}

isi cluster identity view


查看群集名称、描述和每日消息 (MOTD)。

语法
isi cluster identity view
[--format (list | json]

选项
--format (list 以列表或 JSON 格式显示群集联系人信息。
| json)

OneFS 显示群集名称、描述和每日消息。

isi cluster internal-networks modify


修改群集的内部网络接口连接。

语法
isi cluster internal-networks modify
[--int-a-ip-addresses <ip_address_range>]
[--int-b-ip-addresses <ip_address_range>]
[--failover-ip-addresses <ip_address_range>]
[--failover-status <boolean>]
[--int-a-prefix-length <integer>]
[--int-b-prefix-length <integer>]

选项
--int-a-ip- Int-a 网络接口的 IP 地址范围。要指定 IP 地址范围,请输入两个用连字符 (-) 进行分隔的 IP 地址,如
addresses <IP 10.7.0.0-10.7.255.255。
地址范围>
--int-b-ip- Int-b 网络接口的 IP 地址范围。要指定 IP 地址范围,请输入两个用连字符 (-) 进行分隔的 IP 地址,如
addresses <IP 10.7.0.0-10.7.255.255。
地址范围>
--failover- 故障切换网络接口的 IP 地址范围。要指定 IP 地址范围,请输入两个用连字符 (-) 进行分隔的 IP 地址,
ip-addresses 如 10.7.0.0-10.7.255.255。
<IP 地址范围>
--failover- Int-b 网络接口的状态。
status

OneFS isi 命令 A 至 C 189


(enabled |
disabled)
--int-a- Int-a 网络接口的前缀长度。
prefix-length
<整数>
--int-b- Int-b 网络接口的前缀长度。
prefix-length
<整数>

isi cluster internal-networks view


查看群集的内部网络配置设置。

语法
isi cluster internal-networks view

选项
None

OneFS 显示群集内部网络配置设置。

isi cluster join-mode modify


修改群集加入模式安全设置。

语法
isi cluster join-mode modify <mode>

选项
<模式> (secure | 将群集加入模式设置为“secure”或“manual”。
manual)

isi cluster join-mode view


查看群集加入模式的安全设置。

语法
isi cluster join-mode view

190 OneFS isi 命令 A 至 C


选项
None

OneFS 显示群集加入模式的安全设置。

isi cluster lnnset modify


修改群集的逻辑节点名称 (LNN)

语法
isi cluster lnnset modify <lnns>

选项
<LNN> 要修改的逻辑节点名称 (LNN)。指定当前 LNN,然后指定所需的新 LNN,用连字符 (-) 分隔。新 LNN 当
前不得使用。例如,要重命名节点,将当前 LNN 从 1 更改为 9,请输入:

isi cluster lnnset modify 1-9

isi cluster lnnset view


查看所有群集逻辑节点名称 (LNN) 及其关联的设备 ID 和 IP 地址,或者查看特定 LNN 的信息。

语法
isi cluster lnnset view
[--lnn <integer>]

选项
--lnn <整数> 指定 LNN 以仅查看有关该 LNN 的信息。

OneFS 显示 LNN 名称及其关联的设备 ID 和 IP 地址。

isi cluster reboot


重启群集中的一个或所有节点。

注: 要执行滚动重启,请运行 isi upgrade rolling-reboot 命令。

语法
isi cluster reboot
[--node-lnn <string>

OneFS isi 命令 A 至 C 191


选项
--node-lnn <字 要重启的节点的 LNN,或使用 all 选项以重启所有节点。如果省略,则 OneFS 会选择本地节点。
符串>

isi cluster shutdown


关闭群集的一个或所有节点。

语法
isi cluster shutdown
[--node-lnn <string>

选项
--node-lnn <字 要关闭的节点的 LNN,或使用 all 选项以关闭所有节点。如果省略,则 OneFS 会选择本地节点。
符串>

isi cluster time modify


修改群集的日期和时间。

语法
isi cluster time modify <time>

选项
<时间> yyyy-mm-ddThh:mm:ss 格式的日期和时间。

isi cluster time view


查看当前群集的日期和时间。

语法
isi cluster time view

选项
None

OneFS 以 yyyy-mm-ddThh:mm:ss 格式显示日期和时间。

192 OneFS isi 命令 A 至 C


isi cluster time timezone modify
修改群集时区。

语法
isi cluster time timezone modify
[--abbreviation <string>]
[--path <string>]
[--force]
[--verbose]

选项
注: 如果您想要使用交互式时区选择工具,请勿为 --abbreviation 或 --path 输入值。

{-- 群集时区的缩写,例如 PDT 表示美国太平洋夏令时。如果您想要使用交互式时区选择器,请勿输入值。


abbreviation |
-a} <字符串>
{--path | -p} < 时区分层路径,如 America/Los_Angeles 表示美国太平洋夏令时 (PDT)。如果您想要使用交互式时区
字符串> 选择器,请勿输入值。
{--force | -f} 不提示确认任何修改。
{--verbose | 显示更多详细信息。
-v}

isi cluster time timezone view


查看群集时区。

语法
isi cluster time timezone view

选项
None

OneFS 显示群集时区缩写和路径。

isi compression stats list


从运行命令时候开始,按历史五分钟间隔列表查看与数据压缩相关的统计信息。

语法
isi compression stats list
[--begin <integer>]
[--end <integer>]

OneFS isi 命令 A 至 C 193


[--resolution <integer>]
[--pretty-time]
[--local]
[{--limit | -l} <integer>]
[--format (table | json | csv | list)]
[{--no-header | -a}]
[{--help | -h}]

选项
--begin < 时间 >
以 UNIX 纪元时间戳格式指定开始时间。
--end < 时间 >
以 UNIX 纪元时间戳格式指定结束时间。
--resolution < 整数 >
以秒为单位指定系列数据点之间的最小间隔。
--pretty-time
将时间戳显示为可读字符串。
--local
仅显示本地节点的统计信息。
{--limit | -l} < 整数 >
限制要显示的压缩统计信息数量。
--format (table | json | csv | list )
以表、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--noheader | -a}
显示不带页眉的数据。
{--help | -h}
显示此命令的帮助。

isi compression stats view


查看与过去五分钟内记录的数据压缩相关的统计信息。

语法
isi compression stats view
[--resolution <integer>]
[--local]
[{--help | -h}]

选项
--resolution < 整数 >
以秒为单位指定系列数据点之间的最小间隔。
--local
仅显示本地节点的统计信息。
{--help | -h}
显示此命令的帮助。

194 OneFS isi 命令 A 至 C


isi compression settings modify
修改数据压缩的全局配置设置。

语法
isi compression settings modify
[--enabled <boolean>]
[{--verbose | -v}]
[{--help | -h}]

选项
--enabled <布尔>
确定是启用还是禁用数据压缩。
此设置仅适用于驻留在兼容硬件(如 F810)上的数据。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi compression settings view


显示数据压缩的全局配置设置。输出将是 Enabled: Yes 或 Enabled: No.

语法
isi compression settings view

isi config
打开可以用于更改节点和群集设置的新提示符。
命令行提示将发生更改以显示您处于 isi config 子系统中。 当您处于 isi config 子系统中时,其他 OneFS 命令不可
用,仅 isi config 命令是有效命令。

语法
isi config

注:
● 除非您当前处于 isi config 命令提示符处,否则无法识别以下命令。
● 所做更改要等到您运行 commit 命令之后才会应用。
● 某些命令要求您重启群集。

OneFS isi 命令 A 至 C 195


命令
changes
显示未提交的配置更改的列表。
commit
提交配置设置,然后退出 isi config。
date< 时间和日期 >
显示或设置群集上的当前日期和时间。

<时间和日期> 将群集时间设置为指定时间。
采用以下格式指定 < 时间和日期 >:

<YYYY>-<MM>-<DD>[T<hh>:<mm>[:<ss>]]

将 < 时间 > 指定为以下值之一。

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
h 指定小时数
s 指定秒数

deliprange [< 接口名称 > [<ip 范围 >]]


显示可以分配给节点的内部网络 IP 地址的列表,或从该列表中删除指定地址。

<接口名称> 将接口名称指定为以下值之一:
int-a
int-b
failover
<IP 范围> 指定无法再分配给节点的 IP 地址的范围。 以 < 最低 IP>-< 最高 IP> 的形式指定。

encoding [list] [< 编码 >]


为群集设置默认编码字符集。
小心: 通常在群集安装过程中建立字符编码。 不正确地修改字符编码设置可能会导致文件不可读。
仅当需要时并且在咨询 Isilon 技术支持之后才修改设置。

list 显示支持的字符集的列表。

exit
退出 isi config 子系统。
help
显示所有 isi config 命令的列表。 对于有关特定命令的信息,语法为 help [<command>]。
interface < 接口名称 > {enable | disable}
接口命令显示 IP 范围、网络掩码和 MTU,并启用或禁用内部接口。 在不使用任何参数的情况下发出
时,此命令显示所有接口的 IP 范围、网络掩码和 MTU。 在使用 < 接口名称 > 参数的情况下发出时,此
命令仅显示指定接口的 IP 范围、网络掩码和 MTU。

{enable | 启用或禁用指定接口。
disable}
<接口名称> 将接口名称指定为 int-a 或 int-b。

iprange [< 接口名称 > [< 最低 IP>-< 最高 IP>]]


显示可以分配给节点的内部 IP 地址的列表,或向该列表中添加地址。

<接口名称> 将接口名称指定为 int-a、int-b 或 failover。

196 OneFS isi 命令 A 至 C


<最低 IP> - <最高 指定可以分配给节点的 IP 地址的范围。
IP>

ipset
过时。 使用 lnnset 对群集节点重新编号。 无法手动设置 IP 地址。
joinmode [< 模式 >]
显示向当前群集添加节点的方式的设置。 选项 < 模式 > 将群集和节点设置指定为以下值之一。

manual 配置群集,以便可以通过节点或群集发起加入。
secure 配置群集,以便只能通过群集发起加入。

lnnset [< 旧 LNN>< 新 LNN>]


在不使用参数的情况下运行时,显示群集中每个节点的逻辑节点编号 (LNN)、设备 ID 和内部 IP 地址的
表。 指定时更改 LNN。

<旧 LNN> 指定要更改的旧 LNN。


<新 LNN> 指定要替换该节点的旧 LNN 值的新 LNN。
注: 新 LNN 当前不得分配给其他节点。 如果用户已经登录更改 LNN 的节点的
Shell 或 Web 管理界面,则必须再次登录才能查看新的 LNN。

migrate [< 接口名称 > [[< 旧 IP 范围 >] {< 新 IP 范围 > [-n< 网络掩码 >]}]]
显示可以分配给节点的 IP 地址的列表,或在该列表中添加和删除 IP 范围。

<接口名称> 将接口名称指定为 int-a、int-b 和 failover。


<旧 IP 范围> 指定无法再分配给节点的 IP 地址的范围。 如果未指定,则在添加新 IP 范围之前
删除所有现有 IP 范围。 以 < 最低 IP>-< 最高 IP> 的形式指定。
<新 IP 范围> 指定可以分配给节点的 IP 地址的范围。 以 < 最低 IP>-< 最高 IP> 的形式指定。
-n <网络掩码> 指定接口的新网络掩码。

注: 如果向多个节点提供新 IP 地址,则群集会在提交更改时重启。 如果仅向一个节点提供新 IP 地


址,则仅重启该节点。

mtu [< 值 >]


在不使用参数的情况下运行时,显示群集用于内部网络通信的最大传输单位 (MTU) 的大小。 指定时,
设置 MTU 值的新大小。 此命令仅用于内部网络。
注: 此命令对具有 InfiniBand 后端的群集无效。

<值> 指定 MTU 值的新大小。 任何值都有效,但是并非所有值都可以与您的网络兼


容。 最常用的设置是 1500(用于标准帧)和 9000(用于巨型帧)。

name [< 新名称 >]


在不使用参数的情况下运行时,显示当前分配给群集的名称。 指定时,向群集分配新名称。

<新名称> 指定群集的新名称。

netmask [< 接口名称 > [<IP 掩码 >]]


显示群集当前使用的子网 IP 掩码,或在指定时设置新子网 IP 掩码。 将接口名称指定为 int-a 和 int-
b。

<接口名称> 指定接口的名称。 有效名称是 int-a 和 int-b。


<IP 掩码> 指定接口的新 IP 掩码。

quit
退出 isi config 子系统。
reboot [{< 节点 LNN> | all}]
重启一个或多个节点(通过 LNN 指定)。 如果未指定任何节点,则重启运行命令的节点。 要重启群
集,请指定 all。
注: 如果对未配置的节点运行,则此命令不接受任何参数。

OneFS isi 命令 A 至 C 197


remove
已弃用。 而是运行 isi devices -a smartfail 命令。
shutdown [{< 节点 LNN> | all}]
关闭一个或多个节点(通过 LNN 指定)。 如果未指定任何节点,则关闭运行命令的节点。 要关闭群
集,请指定 all。
注: 如果对未配置的节点运行,则此命令不接受任何参数。

status [advanced]
显示有关群集状态的当前信息。 要显示其他信息(包括设备运行状况),请指定 advanced。
timezone [< 时区标识符 >]
显示当前时区或指定新时区。 将群集的新时区指定为以下值之一:

<时区标识符> 将群集的新时区指定为以下值之一:
Greenwich Mean Time
Eastern Time Zone
Central Time Zone
Mountain Time Zone
Pacific Time Zone
Arizona
Alaska
Hawaii
Japan
Advanced。打开具有更多时区选项的提示符。

version
显示有关当前 OneFS 版本的信息。
wizard
在未配置节点上激活一个向导;如果您在初始节点配置过程中退出,则重新激活该向导。 该向导提示您
完成节点配置步骤。

198 OneFS isi 命令 A 至 C


3
OneFS isi 命令 D 至 L
本章包含 OneFS CLI 命令文档 isi dedupe reports list 至 isi license view。

主简:
• isi dedupe inline settings modify
• isi dedupe inline settings view
• isi dedupe reports list
• isi dedupe reports view
• isi dedupe settings modify
• isi dedupe settings view
• isi dedupe stats
• isi devices add
• isi devices config modify
• isi devices config view
• isi devices drive add
• isi devices drive firmware list
• isi devices drive firmware update list
• isi devices drive firmware update start
• isi devices drive firmware update view
• isi devices drive firmware view
• isi devices format
• isi devices list
• isi devices node add
• isi devices node list
• isi devices node smartfail
• isi devices node stopfail
• isi devices purpose
• isi devices purposelist
• isi devices smartfail
• isi devices stopfail
• isi devices suspend
• isi devices view
• isi diagnostics gather settings modify
• isi diagnostics gather settings view
• isi diagnostics gather start
• isi diagnostics gather status
• isi diagnostics gather stop
• isi diagnostics netlogger settings modify
• isi diagnostics netlogger settings view
• isi diagnostics netlogger start
• isi diagnostics netlogger status
• isi diagnostics netlogger stop
• isi email settings modify
• isi email settings view
• isi esrs modify
• isi esrs view
• isi esrs dataitems list
• isi esrs dataitems modify
• isi esrs download list
• isi esrs download start

OneFS isi 命令 D 至 L 199


• isi esrs download view
• isi esrs telemetry modify
• isi esrs telemetry view
• isi event alerts create
• isi event alerts delete
• isi event alerts list
• isi event alerts modify
• isi event alerts view
• isi event channels create
• isi event channels delete
• isi event channels list
• isi event channels modify
• isi event channels view
• isi event events list
• isi event events view
• isi event groups bulk
• isi event groups list
• isi event groups modify
• isi event groups view
• isi event maintenance list
• isi event maintenance modify
• isi event maintenance view
• isi event settings modify
• isi event settings view
• isi event test create
• isi event thresholds list
• isi event thresholds modify
• isi event thresholds reset
• isi event thresholds view
• isi event types list
• isi fc settings list
• isi fc settings modify
• isi fc settings view
• isi file-filter settings modify
• isi file-filter settings view
• isi filepool apply
• isi filepool default-policy modify
• isi filepool default-policy view
• isi filepool policies create
• isi filepool policies delete
• isi filepool policies list
• isi filepool policies modify
• isi filepool policies view
• isi filepool templates list
• isi filepool templates view
• isi_for_array
• isi ftp settings modify
• isi ftp settings view
• isi_gather_info
• isi get
• isi hardening apply
• isi hardening revert
• isi hardening status
• isi hdfs crypto encryption-zones create
• isi hdfs crypto settings modify
• isi hdfs crypto encryption-zones list

200 OneFS isi 命令 D 至 L


• isi hdfs crypto settings view
• isi hdfs fsimage job settings modify
• isi hdfs fsimage job settings view
• isi hdfs fsimage job view
• isi hdfs fsimage latest delete
• isi hdfs fsimage latest view
• isi hdfs fsimage settings modify
• isi hdfs fsimage settings view
• isi hdfs inotify settings modify
• isi hdfs inotify settings view
• isi hdfs inotify stream reset
• isi hdfs inotify stream view
• isi hdfs log-level modify
• isi hdfs log-level view
• isi hdfs proxyusers create
• isi hdfs proxyusers delete
• isi hdfs proxyusers list
• isi hdfs proxyusers members list
• isi hdfs proxyusers modify
• isi hdfs proxyusers view
• isi hdfs racks create
• isi hdfs racks delete
• isi hdfs racks list
• isi hdfs racks modify
• isi hdfs racks view
• isi hdfs ranger-plugin settings modify
• isi hdfs ranger-plugin settings view
• isi hdfs settings modify
• isi hdfs settings view
• isi http settings modify
• isi http settings view
• isi ipmi features list
• isi ipmi features modify
• isi ipmi features view
• isi ipmi network modify
• isi ipmi network view
• isi ipmi nodes list
• isi ipmi nodes view
• isi ipmi settings modify
• isi ipmi settings view
• isi ipmi user modify
• isi ipmi user view
• isi 作业事件列表
• isi job jobs cancel
• isi job jobs list
• isi job jobs modify
• isi job jobs pause
• isi job jobs resume
• isi job jobs start
• isi job jobs view
• isi job policies create
• isi job policies delete
• isi job policies list
• isi job policies modify
• isi job policies view
• isi job reports list

OneFS isi 命令 D 至 L 201


• isi job reports view
• isi job statistics view
• isi job status
• isi job types list
• isi job types modify
• isi job types view
• isi keymanager kmip servers create
• isi keymanager kmip servers delete
• isi keymanager kmip servers modify
• isi keymanager kmip servers list
• isi keymanager kmip servers view
• isi keymanager sed migrate local
• isi keymanager sed migrate retry
• isi keymanager sed migrate server
• isi keymanager sed settings modify
• isi keymanager sed settings view
• isi keymanager sed status
• isi license activation start
• isi license activation view
• isi license add
• isi license generate
• isi license list
• isi license view
• isi keymanager sed migrate local

isi dedupe inline settings modify


全局控制线内重复数据消除。此设置仅适用于驻留在兼容硬件(如 F810 节点)上的数据。

语法
isi dedupe inline settings modify
[--mode ] enabled | assess | paused | disabled]
[{--verbose | --v}]

选项
mode
设置指定的线内重复数据消除模式。模式设置适用于整个群集。
● enabled 打开线内重复数据消除。
● assess 允许您评估线内重复数据消除的潜在空间节省。
● paused 停用线内重复数据消除,但索引表保持原样。
● disabled 停用线内重复数据消除并取消分配索引表。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将在评估模式下启用线内重复数据消除:

isi dedupe inline settings modify --assess

202 OneFS isi 命令 D 至 L


以下命令将启用线内重复数据消除:

isi dedupe inline settings modify --mode enabled

isi dedupe inline settings view


显示当前线内重复数据消除设置。

语法
isi dedupe settings view

选项
此命令没有选项。

isi dedupe reports list


显示重复数据消除报告的列表。

语法
isi dedupe reports list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表输出。
{--no-footer | -z}
显示不带页脚的表输出。 页脚显示快照总数,例如快照使用的总存储空间。
{--verbose | -v}
显示更多详细信息。

示例
要查看重复数据消除报告的列表,请运行以下命令:

isi dedupe reports list

OneFS isi 命令 D 至 L 203


系统将显示与以下示例类似的输出:

Time Job ID Job Type --------------------------------------- 2013-05-09T11:03:37 4


Dedupe 2013-05-10T00:02:27 8 Dedupe 2013-05-15T13:03:47 12 Dedupe 2013-05-16T00:02:32 16
Dedupe 2013-05-17T00:02:32 19 Dedupe 2013-05-09T16:14:04 5 DedupeAssessment
--------------------------------------- Total: 6

isi dedupe reports view


显示重复数据消除报告。

语法
isi dedupe reports view <job-id>

选项
<job-id>
显示指定 ID 的重复数据消除作业的重复数据消除报告。

示例
以下命令将显示重复数据消除作业:

isi dedupe reports view 12

系统将显示与以下示例类似的输出:

Time: 2013-10-14T09:39:22 Job ID: 52 Job Type: Dedupe Reports Time :


2013-10-14T09:39:22 Results : Dedupe job report:{ Start time = 2013-Oct-14:09:33:34 End
time = 2013-Oct-14:09:39:22 Iteration count = 1 Scanned blocks = 1716 Sampled blocks =
78 Deduped blocks = 1425 Dedupe percent = 83.042 Created dedupe requests = 65 Successful
dedupe requests = 65 Failed dedupe requests = 0 Skipped files = 0 Index entries = 38
Index lookup attempts = 38 Index lookup hits = 0 } Elapsed time: 347 seconds Aborts: 0
Errors: 0 Scanned files: 6 Directories: 2 2 paths: /ifs/data/dir2, /ifs/data/dir1 CPU
usage: max 29% (dev 2), min 0% (dev 1), avg 6% Virtual memory size: max 128388K (dev 1),
min 106628K (dev 1), avg 107617K Resident memory size: max 27396K (dev 1), min 9980K
(dev 2), avg 11585K Read: 2160 ops, 124437504 bytes (118.7M) Write: 30570 ops, 222851584
bytes (212.5M)

isi dedupe settings modify


修改重复数据消除作业的设置。

语法
isi dedupe settings modify
[{[--paths <path>]... | --clear-paths}]
[--add-paths <path>]...
[--remove-paths <path>]...
[{[--assess-paths <path>]... | --clear-assess-paths]
[--add-assess-paths <path>]...
[--remove-assess-paths <path>]...
[--verbose]

204 OneFS isi 命令 D 至 L


选项
--paths< 路径 >
对位于指定根目录下的文件执行重复数据消除操作。
--clear-paths
对先前指定的所有根目录停止重复数据消除操作。 如果在包含此选项的情况下运行此 isi dedupe
settings modify 命令,则必须使用 --paths 或 --add-path 再次运行该命令以恢复重复数据消
除。
--add-paths< 路径 >
除了已经在进行重复数据消除的目录外,还对位于指定根目录下的文件进行重复数据消除。
--remove-paths< 路径 >
停止对指定根目录进行重复数据消除。
--assess-paths< 路径 >
评估对位于指定根目录下的文件进行重复数据消除将节省多少空间。
--clear-assess-paths
停止评估对先前指定的根目录进行重复数据消除将节省多少空间。 如果在包含此选项的情况下运行此
isi dedupe settings modify 命令,则必须使用 --paths 或 --add-path 再次运行该命令以恢
复重复数据消除。
--add-assess-paths< 路径 >
评估除了已在进行评估的目录外再对指定根目录进行重复数据消除将节省多少空间。
--remove-assess-paths< 路径 >
停止评估对指定的根目录进行重复数据消除将节省多少空间。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将启动对 /ifs/data/active 和 /ifs/data/media 的重复数据消除:

isi dedupe settings modify --add-paths /ifs/data/active,/ifs/data/media

以下命令将停止对 /ifs/data/active 和 /ifs/data/media 的重复数据消除:

isi dedupe settings modify --remove-paths /ifs/data/active,/ifs/data/media

isi dedupe settings view


显示当前的重复数据消除设置。

语法
isi dedupe settings view

选项
此命令没有选项。

OneFS isi 命令 D 至 L 205


isi dedupe stats
显示有关重复数据消除可节省多少数据的信息。

语法
isi dedupe stats
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表输出。
{--no-footer | -z}
显示不带页脚的表输出。页脚显示快照总数,例如快照使用的总存储空间。
{--verbose | -v}
显示更多详细信息。

示例
要查看有关重复数据消除空间节省的信息,请运行以下命令:

isi dedupe stats

系统将显示与以下示例类似的输出:

Cluster Physical Size: 17.019G


Cluster Used Size: 4.994G
Logical Size Deduplicated: 13.36M
Logical Saving: 11.13M
Estimated Size Deduplicated: 30.28M
Estimated Physical Saving: 25.23M

isi devices add


默认为 isi devices drive add。扫描可用驱动器并将驱动器添加到节点。

注: 通过运行命令 isi devices node add,可以将可用节点添加到群集。

206 OneFS isi 命令 D 至 L


语法
isi devices add {<bay> | all}
[--sled <string>
[--node-lnn <integer>]
[--force]
[--verbose]

选项
{< 托架 > | all }
指定包含要添加到节点的驱动器的托架编号。您可以指定 all 以扫描整个节点。
--sled < 字符串 >
指定要在其上运行的驱动器底座的位置的前缀。必须为 [A | B | C | D | E] 中的一个。
--node-lnn < 整数 >
指定要扫描新驱动器的节点编号。如果省略,将扫描本地节点。
{--force | -f}
在不要求确认的情况下添加驱动器。
{--verbose | -v}
显示更多详细信息。

isi devices config modify


修改节点的自动更换识别 (ARR) 状态。

语法
isi devices config modify
[--automatic-replacement-recognition {yes | no}]
[--instant-secure-erase {yes | no}]
[--node-lnn {all | <string>}]
[--verbose]

选项
--automatic-replacement-recognition {yes | no}
更改群集或特定节点的 ARR 状态。值 yes 将启用 ARR,值 no 将禁用 ARR。
--instant-secure-erase {yes | no}
在设备上启用或禁用即时安全擦除 (ISE) 功能。值 yes 将启用 ISE,值 no 将禁用 ISE。
--node-lnn {all | <string>}
指定要修改设备配置的节点 LNN。您可以指定 all 修改所有节点的配置。如果省略,将修改所有节点。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 207


isi devices config view
显示节点的自动更换识别 (ARR) 状态。

语法
isi devices config view
[--node-lnn {all | <string>}]

选项
--node-lnn {all | < 字符串 >}
指定要查看的节点。您可以指定所有节点。如果省略,将显示本地节点的 ARR 状态。

isi devices drive add


扫描可用驱动器的一个或多个托架并将驱动器添加到节点。

语法
isi devices drive add {<bay> | --sled <string>}
[--node-lnn <integer>]
[--force]
[--verbose]

选项
{<bay> | all}
指定包含要添加到节点的驱动器的托架编号。您可以指定 all 以扫描整个节点。
--sled < 字符串 >
指定要在其上运行的驱动器底座的位置的前缀。必须为 [A | B | C | D | E] 中的一个。
--node-lnn<integer>
指定要扫描新驱动器的节点编号。如果省略,将扫描本地节点。
{--force | -f}
在不要求确认的情况下添加驱动器。
{--verbose | -v}
显示更多详细信息。

isi devices drive firmware list


显示某个节点中数据驱动器的固件详细信息的列表。

语法
isi devices drive firmware list
[--node-lnn <string>]
[--sled <string> ]
[{--summary | -s}]

208 OneFS isi 命令 D 至 L


[{--override | -v}]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--node-lnn {all | <integer>}
指定要显示固件信息的驱动器的节点编号。您可以指定所有节点。如果省略,仅显示本地节点的驱动器
固件信息。
--sled < 字符串 >
指定要在其上运行的驱动器底座的位置的前缀。必须为 [A | B | C | D | E] 中的一个。
{--override | -v}
使用传统节点名称,而不是网格 XY 值。
{ --summary | -s}
按型号和版本显示驱动器固件计数的摘要。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi devices drive firmware update list


显示群集上固件更新的状态。

语法
isi devices drive firmware update list
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 209


isi devices drive firmware update start
更新节点中一个或多个驱动器上的固件。

语法
isi devices drive firmware update start <托架>
[--node-lnn <整数>]
[--force]
[--verbose]

选项
{<bay> | all}
指定包含要更新的驱动器的托架编号。您可以指定 all 以更新节点中的每个驱动器。
--node-lnn<integer>
指定要更新驱动器的节点编号。如果省略,将更新本地节点中的驱动器。
{--force | -f}
在不要求确认的情况下更新驱动器。
{--verbose | -v}
显示更多详细信息。

isi devices drive firmware update view


显示有关节点驱动器固件更新的信息。

语法
isi devices drive firmware update view
[--node-lnn <整数>]

选项
--node-lnn<integer>
指定正在运行要查看的固件更新的节点的 LNN(逻辑节点编号)。如果省略,将显示本地节点的固件更
新状态。

isi devices drive firmware view


显示有关单个驱动器上固件的信息。

语法
isi devices drive firmware view {<托架> | --lnum <整数>}
[--node-lnn <整数>]

210 OneFS isi 命令 D 至 L


选项
{<bay> | --lnum<integer>}
指定要查看的驱动器的托架编号或 LNUM(逻辑驱动器编号)。
--node-lnn<integer>
指定包含要查看的驱动器的节点的 LNN(逻辑节点编号)。如果省略,将显示本地节点中的驱动器。

isi devices format


默认为 isi devices drive format。格式化驱动器,以便可以将其添加到节点。

语法
isi devices format {<bay> | --sled <string>}
[--node-lnn <integer>]
[--purpose <string>]
[--force | -f]

选项
<bay>
指定包含要格式化的驱动器的托架编号。
--sled < 字符串 >
指定要在其上运行的驱动器底座的位置的前缀。必须为 [A | B | C | D | E] 中的一个。
--node-lnn<integer>
指定包含要格式化的驱动器的节点的 LNN(逻辑节点编号)。如果省略,将格式化在本地节点中的指定
驱动器。
--purpose<string>
指定要分配给新驱动器的用途。通过运行 isi devices drive purposelist,可以查看可能驱动
器用途的列表。如果省略,OneFS 将自动分配驱动器用途。
{--force | -f}
在不要求确认的情况下格式化驱动器。

isi devices list


默认为 isi devices drive list。显示某个节点中的数据驱动器的列表。

注: 通过运行命令 isi devices node list,可以显示可用于加入群集的节点。

语法
isi devices list
[--node-lnn <string>]
[--sled <string>]
[--override]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

OneFS isi 命令 D 至 L 211


选项
--node-lnn {all | <integer>}
指定要显示的驱动器的节点编号。您可以指定所有节点。如果省略,仅显示本地节点中的驱动器。
--sled < 字符串 >
指定要在其上运行的驱动器底座的位置的前缀。必须为 [A | B | C | D | E] 中的一个。
{ --override | -V}
显示传统托架编号而非网格值。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi devices node add


将可用节点加入群集。

语法
isi devices node add <serial-number>
[--force]

选项
<serial-number>
指定要添加到群集的节点的序列号。
{--force | -f}
在不要求确认的情况下将加点添加到群集。

isi devices node list


显示可用于加入群集的节点的列表。

语法
isi devices node list
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--format {table | json | csv | list}

212 OneFS isi 命令 D 至 L


以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi devices node smartfail


对节点执行 smartfail 操作并将其从群集中删除。

语法
isi devices node smartfail
[--node-lnn <整数>]
[--force]
[--verbose]

选项
--node-lnn<integer>
指定要执行 smartfail 操作的节点的 LNN(逻辑节点编号)。如果省略,将对本地节点执行 smartfail 操
作。
{--force | -f}
在不要求确认的情况下对驱动器执行 smartfail 操作。
{--verbose | -v}
显示更多详细信息。

isi devices node stopfail


中断节点上的 smartfail 进程。

语法
isi devices node stopfail
[--node-lnn <整数>]
[--force]
[--verbose]

选项
--node-lnn<integer>
指定要中断 smartfail 操作的节点的 LNN(逻辑节点编号)。如果省略,将对本地节点中断 smartfail 操
作。
{--force | -f}
在不要求确认的情况下对驱动器中断 smartfail 操作。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 213


isi devices purpose
默认为 isi devices drive purpose。将使用情形分配给驱动器。例如,您可以将驱动器指定用于正常数据存储操作,也
可以将驱动器指定用于 L3 缓存而非存储。

语法
isi devices purpose {<bay> | --lnum <integer>}
[--node-lnn <integer>]
[--purpose <string>]
[--force | -f]
[--verbose | -v]

选项
{<bay> | --lnum<integer>}
指定要分配的驱动器的托架编号或 LNUM(逻辑驱动器编号)。
--purpose<string>
指定要分配给驱动器的用途。通过运行 isi devices drive purposelist,可以查看可能驱动器
用途的列表。
--node-lnn<integer>
指定包含要分配的驱动器的节点的 LNN(逻辑节点编号)。如果省略,将分配本地节点中的指定驱动
器。
{--force | -f}
在不要求确认的情况下格式化驱动器。
{--verbose | -v}
显示更多详细信息。

isi devices purposelist


默认为 isi devices drive purposelist。显示驱动器的可能使用情形的列表。例如,您可能能够将驱动器指定用于正常
数据存储操作,也可以将驱动器指定用于 L3 缓存而非存储。

语法
isi devices purposelist
[--node-lnn <整数>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
--node-lnn<integer>
指定要查看用途列表的节点的 LNN(逻辑节点编号)。如果省略,将显示本地节点的用途列表。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}

214 OneFS isi 命令 D 至 L


显示不带页脚的表输出。

isi devices smartfail


默认为 isi devices drive smartfail。对驱动器执行 smartfail 操作,以便可将其从节点中删除。

注: 通过运行命令 isi devices node smartfail,可对节点执行 smartfail 操作。

语法
isi devices smartfail {<bay> | --lnum <integer> | --sled <string>}
[--node-lnn <integer>]
[{--force | -f}]
[{--verbose | -v}]

选项
{<bay> | --lnum<integer>}
指定要执行 smartfail 操作的驱动器的托架编号或 LNUM(逻辑驱动器编号)。
--node-lnn<integer>
指定包含要执行 smartfail 操作的驱动器的节点的 LNN(逻辑节点编号)。如果省略,将对本地节点中的
指定驱动器执行 smartfail 操作。
--sled < 字符串 >
指定要在其上运行的驱动器底座的位置的前缀。必须为 [A | B | C | D | E] 中的一个。
{--force | -f}
在不要求确认的情况下对驱动器执行 smartfail 操作。
{--verbose | -v}
显示更多详细信息。

isi devices stopfail


默认为 isi devices drive stopfail。中断驱动器上的 smartfail 进程。

注: 通过运行命令 isi devices node stopfail,可中断节点上的 smartfail 进程。

语法
isi devices stopfail {<bay> | --lnum <integer> | --sled <string>}
[--node-lnn <integer>]
[{--force | -f}]
[{--verbose | -v}]

选项
{<bay> | --lnum<integer>}
指定要中断 smartfail 操作的驱动器的托架编号或 LNUM(逻辑驱动器编号)。
--sled < 字符串 >
指定要在其上运行的驱动器底座的位置的前缀。必须为 [A | B | C | D | E] 中的一个。
--node-lnn<integer>

OneFS isi 命令 D 至 L 215


指定包含要中断 smartfail 操作的驱动器的节点的 LNN(逻辑节点编号)。如果省略,将对本地节点中的
指定驱动器中断 smartfail 操作。
{--force | -f}
在不要求确认的情况下对驱动器中断 smartfail 操作。
{--verbose | -v}
显示更多详细信息。

isi devices suspend


默认为 isi devices drive suspend。临时暂停驱动器的所有活动。

语法
isi devices suspend {<bay> | --lnum <integer> | --sled <string>}
[--node-lnn <integer>]
[{--force | -f}]
[{--verbose | -v}]

选项
{<bay> | --lnum<integer> | --sled<string>}
指定要暂停的底座驱动器的托架编号或 LNUM(逻辑驱动器编号)或位置前缀。--sled<string> 必
须为 [A | B | C | D | E] 中的一个。
--node-lnn<integer>
指定包含要暂停的驱动器的节点的 LNN(逻辑节点编号)。如果省略,将暂停本地节点中的指定驱动
器。
{--force | -f}
在不要求确认的情况下对驱动器执行 smartfail 操作。
{--verbose | -v}
显示更多详细信息。

isi devices view


默认为 isi devices drive view。显示有关单个驱动器的信息。

语法
isi devices view {<托架> | --lnum <整数>}
[--node-lnn <整数>]

选项
{<bay> | --lnum<integer>}
指定要查看的驱动器的托架编号或 LNUM(逻辑驱动器编号)。
--node-lnn<integer>
指定包含要查看的驱动器的节点的 LNN(逻辑节点编号)。如果省略,将显示本地节点中的驱动器。

216 OneFS isi 命令 D 至 L


isi diagnostics gather settings modify
修改群集日志信息的收集和上载设置。

语法
isi diagnostics gather settings modify
[--upload {enable | disable}]
[--esrs {enable | disable}]
[--gather-mode {incremental | full}]
[--http-upload {enable | disable}]
[--http-upload-host <host>]
[--http-upload-path <path>]
[--http-upload-proxy <host>]
[--http-upload-proxy-port <port>]
[--ftp-upload {enable | disable}]
[--ftp-upload-host <host>]
[--ftp-upload-path <path>]
[--ftp-upload-proxy <host>]
[--ftp-upload-proxy-port <port>]
[--ftp-upload-user <username>]
[--ftp-upload-pass <password>]
[--set-ftp-upload-pass]
[--verbose]

选项
--upload {enable | disable}
启用所收集日志的上载
--esrs {enable | disable}
指定 EMC Secure Remote Services (ESRS) 以便进行日志上载。
--gather-mode {incremental | full}
指定是启动日志的增量还是完整收集。
--http-upload {enable | disable}
指定 HTTP 以便进行日志上载。
--http-upload-host< 主机 >
指定 HTTP 站点以便进行上载。
--http-upload-path< 路径 >
指定 HTTP 上载目录。
--http-upload-proxy< 主机 >
指定 HTTP 代理服务器。
--http-upload-proxy-port< 端口 >
指定 HTTP 代理服务器端口。
--ftp-upload {enable | disable}
指定 FTP 以便进行日志上载。
--ftp-upload-host< 主机 >
指定 FTP 站点以便进行上载。
--ftp-upload-path< 路径 >
指定 FTP 上载目录。
--ftp-upload-proxy< 主机 >
指定 FTP 代理服务器。
--ftp-upload-proxy-port< 端口 >
指定 FTP 代理服务器端口。

OneFS isi 命令 D 至 L 217


--ftp-upload-user< 用户名 >
指定 FTP 站点用户名。默认用户是 anonymous。
--ftp-upload-pass< 密码 >
指定 FTP 站点密码。
--set-ftp-upload-pass< 密码 >
设置 FTP 站点密码。
{--verbose | -v}
显示更多详细信息。

isi diagnostics gather settings view


显示日志收集的设置。

语法
isi diagnostics gather settings view

选项
此命令没有选项。

isi diagnostics gather start


启动用于收集并上载最新群集日志信息的进程。
收集的群集日志会保存在 /ifs/data/Isilon_Support/pkg 下。

语法
isi diagnostics gather start
[--upload {enable | disable}]
[--esrs {enable | disable}]
[--gather-mode {incremental | full}]
[--http-upload {enable | disable}]
[--http-upload-host <host>]
[--http-upload-path <path>]
[--http-upload-proxy <host>]
[--http-upload-proxy-port <port>]
[--ftp-upload {enable | disable}]
[--ftp-upload-host <host>]
[--ftp-upload-path <path>]
[--ftp-upload-proxy <host>]
[--ftp-upload-proxy-port <port>]
[--ftp-upload-user <username>]
[--ftp-upload-pass <password>]
[--set-ftp-upload-pass]

选项
--upload {enable | disable}
启用所收集日志的上载
--esrs {enable | disable}

218 OneFS isi 命令 D 至 L


指定 EMC Secure Remote Services (ESRS) 以便进行日志上载。
--gather-mode {incremental | full}
指定是启动日志的增量还是完整收集。
--http-upload {enable | disable}
指定 HTTP 以便进行日志上载。
--http-upload-host< 主机 >
指定 HTTP 站点以便进行上载。
--http-upload-path< 路径 >
指定 HTTP 上载目录。
--http-upload-proxy< 主机 >
指定 HTTP 代理服务器。
--http-upload-proxy-port< 端口 >
指定 HTTP 代理服务器端口。
--ftp-upload {enable | disable}
指定 FTP 以便进行日志上载。
--ftp-upload-host< 主机 >
指定 FTP 站点以便进行上载。
--ftp-upload-path< 路径 >
指定 FTP 上载目录。
--ftp-upload-proxy< 主机 >
指定 FTP 代理服务器。
--ftp-upload-proxy-port< 端口 >
指定 FTP 代理服务器端口。
--ftp-upload-user< 用户名 >
指定 FTP 站点用户名。默认用户是 anonymous。
--ftp-upload-pass< 密码 >
指定 FTP 站点密码。
--set-ftp-upload-pass< 密码 >
设置 FTP 站点密码。

isi diagnostics gather status


显示日志收集操作的当前状态。

语法
isi diagnostics gather status

选项
此命令没有选项。

OneFS isi 命令 D 至 L 219


isi diagnostics gather stop
停止活动日志收集操作。

语法
isi diagnostics gather stop

选项
此命令没有选项。

isi diagnostics netlogger settings modify


修改 IP 流量信息的收集设置。

语法
isi diagnostics netlogger settings modify
[--interfaces <interface>]
[--count <integer>]
[--duration <duration>]
[--snaplength <bytes>]
[--nodelist <LNN>]
[--clients <IP>]
[--ports <string>]
[--protocols {ip | ip6 | arp | tcp | udp}]
[--verbose]

选项
--interfaces<interface>
指定要用于捕获流量的网络接口。
--count< 整数 >
指定在捕获完成之后将保留的捕获文件数。默认值是三个文件。
--duration< 持续时间 >
指定为每个捕获文件捕获 IP 流量的时间长度,格式为 <integer>{Y|M|W|D|H|m|s}
--snaplength<bytes>
捕获的快照长度。默认为 320 字节。此值的有效范围是 64-9100。
--nodelist< 节点 >
指定要报告其统计信息的节点。按逻辑节点编号 (LNN) 指定节点。可以在逗号分隔列表中指定多个值,
例如 --nodes 1,2。默认值是 all。

--clients<clients>
指定要报告其统计信息的客户端 IP。可以在逗号分隔列表中指定多个 IP 地址。默认值为 all。
--ports< 端口 >
指定要报告其统计信息的 TCP 或 UDP 端口。可以在逗号分隔列表中指定多个端口。默认值为 all。
--protocols {ip | ip6 | arp | tcp | udp}
指定要报告其统计信息的协议。

220 OneFS isi 命令 D 至 L


{--verbose | -v}
显示更多详细信息。

isi diagnostics netlogger settings view


显示 IP 流量日志捕获的设置。

语法
isi diagnostics netlogger settings view

选项
此命令没有选项。

isi diagnostics netlogger start


启动用于收集并上载最新 IP 流量日志信息的进程。
收集的群集日志会保存在 /ifs/data/Isilon_Support/pkg 下。

语法
isi diagnostics netlogger start
[--interfaces <interface>]
[--count <integer>]
[--duration <duration>]
[--snaplength <bytes>]
[--nodelist <LNN>]
[--clients <IP>]
[--ports <string>]
[--protocols {ip | ip6 | arp | tcp | udp}]

选项
--interfaces<interface>
指定要用于捕获流量的网络接口。
--count< 整数 >
指定在捕获完成之后将保留的捕获文件数。默认值是三个文件。
--duration< 持续时间 >
指定为每个捕获文件捕获 IP 流量的时间长度,格式为 <integer>{Y|M|W|D|H|m|s}
--snaplength<bytes>
捕获的快照长度。默认为 320 字节。此值的有效范围是 64-9100。
--nodelist< 节点 >
指定要报告其统计信息的节点。按逻辑节点编号 (LNN) 指定节点。可以在逗号分隔列表中指定多个值,
例如 --nodes 1,2。默认值是 all。

--clients<clients>
指定要报告其统计信息的客户端 IP。可以在逗号分隔列表中指定多个 IP 地址。默认值为 all。
--ports< 端口 >

OneFS isi 命令 D 至 L 221


指定要报告其统计信息的 TCP 或 UDP 端口。可以在逗号分隔列表中指定多个端口。默认值为 all。
--protocols {ip | ip6 | arp | tcp | udp}
指定要报告其统计信息的协议。

isi diagnostics netlogger status


显示 IP 流量捕获操作的当前状态。

语法
isi diagnostics netlogger status

选项
此命令没有选项。

isi diagnostics netlogger stop


停止活动 IP 流量捕获操作。

语法
isi diagnostics netlogger stop

选项
此命令没有选项。

isi email settings modify


修改群集的电子邮件设置。

语法
isi email settings modify
[--mail-relay < 字符串 >]
[--smtp-port < 整数 >]
[--mail-sender < 字符串 >]
[--mail-subject < 字符串 >]
[--use-smtp-auth {yes | no}]
[--smtp-auth-username < 字符串 >]
[--use-encryption {yes | no}]
[--batch-mode {全部 | severity | category | none}]
[--user-template < 字符串 >]
[--clear-user-template]
[--smtp-auth-passwd < 字符串 >]
[--clear-smtp-auth-passwd]
[--set-smtp-auth-passwd]
[--verbose]

222 OneFS isi 命令 D 至 L


选项
--mail-relay< 字符串 >
设置 SMTP 中继地址。
--smtp-port< 整数 >
指定 SMTP 端口。默认值为 25。
--mail-sender< 字符串 >
设置发起方电子邮件地址。
mail-subject< 字符串 >
设置电子邮件主题的前缀字符串。
--use-smtp-auth {yes | no}
使用 SMTP 身份认证。
{--smtp-auth-username | -u} < 字符串 >
设置 SMTP 用户名。
--use-encryption {yes | no}
将加密 (TLS) 用于 SMTP 身份认证。
--batch-mode {all | severity | category | none}
设置要通过发送电子邮件来一起批处理通知的方法。
--user-template< 字符串 >
指定要访问自定义电子邮件模板的路径。
--clear-user-template
清除指定要访问自定义电子邮件模板的路径。
{--smtp-auth-passwd | -p} < 字符串 >
设置 SMTP 身份认证密码。
--clear-smtp-auth-passwd
清除指定的 SMTP 身份认证密码。
--set-smtp-auth-passwd
以交互方式指定 --smtp-auth-passwd。
{--verbose | -v}
显示更多详细信息。

isi email settings view


查看群集电子邮件设置。

语法
isi email settings view

示例
要查看当前配置的电子邮件设置,请运行以下命令:

isi email settings view

系统将显示与以下示例类似的输出:

Mail Relay: -
SMTP Port: 25

OneFS isi 命令 D 至 L 223


Mail Sender: -
Mail Subject: -
Use SMTP Auth: No
SMTP Auth Username: -
Use Encryption: No
Batch Mode: none
User Template: -
SMTP Auth Password Set: False

isi esrs modify


启用/禁用安全远程服务 (ESRS) 并修改配置设置。您必须具有有效的 Dell EMC 支持合同才能使用 ESRS。

语法
isi esrs modify
[--enabled <boolean>]
[--username <string>]
[--password <string>]
[--force]
[--primary-esrs-gateway <string>]
[--secondary-esrs-gateway <string>]
[--alert-on-disconnect <boolean>]
[--gateway-access-pools <string> (--clear-gateway-access-pools | --add-gateway-access-
pools <string> | --remove-gateway-access-pools <string>)]
[--connectivity-check-period <integer>]
[--ui-reporting-period <integer>]
[--download-enabled <boolean>]
[--download-timeout-period <integer>]
[--download-error-retries <integer>]
[--download-chunk-size <integer>]
[--download-filesystem-limit <integer>

选项
--enabled (yes 启用或禁用 ESRS。默认为否。
| no)
--username <字 用于技术帮助的 Dell EMC 用户名。
符串>
--password <字 与该 Dell EMC 用户名关联的密码。
符串>
--force 当与 ESRS 或 ESRS 网关的通信不可用时强制 ESRS 取消资源调配。
--primary- 主 ESRS 网关的主机名或 IP 地址。
esrs-gateway <
字符串>
--secondary- 辅助 ESRS 网关的主机名或 IP 地址。
esrs-gateway <
字符串>
--alert-on- 在群集 ESRS 与 ESRS 网关断开连接时生成 CELOG 警报。
disconnect
(yes | no)
--gateway- 可用于访问 ESRS 网关的池列表。
access-pools <
字符串> (-- --clear- 清除池 ID 列表。
clear- gateway-
gateway- access-pools
access-pools |

224 OneFS isi 命令 D 至 L


--add-
--add- 将项目添加至池标识符列表。为其他池多次使用此选项。
gateway-
gateway-
access-pools <
access-pools <
字符串> | --
字符串>
remove-
gateway- --remove- 从池标识符列表中删除项目。为其他池多次使用此选项。
access-pools < gateway-
字符串> ) access-pools <
字符串>

-- 指定重新检查 ESRS 网关是否连接的频率(以秒为单位)。


connectivity-
check-period <
整数>
--ui- 指定显示许可证使用信息报告的频率(以秒为单位)。
reporting-
period <整数>
--download- 启用或禁用 ESRS 文件下载功能。
enabled (yes |
no)
--download- 指定 ESRS 文件下载的超时期限(以秒为单位)。默认值为每个区块 50 秒。
timeout-
period <整数>
--download- 指定在下载过程中遇到错误或超时后重新尝试的次数。默认值为每个区块 3 次请求。
error-retries
<整数>
--download- 为下载请求指定每个区块的最大字节数。默认值为 100 万 (1000000)。
chunk-size <整
数>
--download- 根据正在使用的文件系统资源百分比设置不允许下载的阈值。默认阈值为 80(总文件系统资源的
filesystem- 80%)。
limit <整数>

isi esrs view


查看安全远程服务 (ESRS) 配置和网关设置。

语法
isi esrs view

选项
None

OneFS 显示群集的 ESRS 配置和网关设置信息。

OneFS isi 命令 D 至 L 225


isi esrs dataitems list
列出安全远程服务 (ESRS) 数据项目的配置信息。

语法
isi esrs dataitems list
[--limit <integer>]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 要显示的 ESRS 数据项的数量。
整数>
--format 以表格、JSON、CSV 或列表格式显示 ESRS 数据项。
(table | json |
csv | list)
{--no-header | 不会以表格或 CSV 格式显示标头。
-a}
{--no-footer | 不显示表格摘要页脚信息。
-z}
{--verbose | 显示更多详细信息。
-v}

OneFS 显示 ESRS 数据项的列表、是否启用了项目、生成的频率项目以及最近的时间戳。

isi esrs dataitems modify


修改安全远程服务 (ESRS) 数据项设置并配置各个项目。

语法
isi esrs dataitems modify
[--dataitems-enabled <boolean>]
[--name <string>]
[--enabled <boolean>]
[--frequency <duration>]
[--timestamp-delete]

选项
--dataitems- 启用或禁用 ESRS 数据项。默认处于启用状态。
enabled <布尔值
>
--name <字符串> ESRS 数据项的名称。
--enabled <布尔 启用或禁用 ESRS 数据项。
值>

226 OneFS isi 命令 D 至 L


--frequency < 确定生成 ESRS 数据项的频率。
持续时间>
--timestamp- 将所选 ESRS 数据项的上次运行时间戳重置为零。
delete

isi esrs download list


列出安全远程服务 (ESRS) 文件保险箱中可用的文件。

语法
isi esrs download list
[--limit <integer>]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 要显示的 ESRS 下载数。
整数>
--format 以表格、JSON、CSV 或列表格式显示 ESRS 数据项。
(table | json |
csv | list)
{--no-header | 不会以表格或 CSV 格式显示标头。
-a}
{--no-footer | 不显示表格摘要页脚信息。
-z}
{--verbose | 显示更多详细信息。
-v}

OneFS 显示 ESRS 文件保险箱下载的列表。

isi esrs download start


计划 OneFS 作业引擎作业以从安全远程服务 (ESRS) 文件保险箱下载文件。

语法
isi esrs download start <file> <path>

选项
<文件> 在 ESRS 文件保险箱中显示的文件名。
<路径> 下载成功后将在其中放置文件的路径。

OneFS isi 命令 D 至 L 227


isi esrs download view
查看有关特定安全远程服务 (ESRS) 可下载文件的详细信息。

语法
isi esrs download view <file>

选项
<文件> 在 ESRS 文件保险箱中显示的文件名。

OneFS 显示有关指定 ESRS 可下载文件的信息。

isi esrs telemetry modify


启用或禁用安全远程服务 (ESRS) 遥测数据上传。

语法
isi esrs telemetry modify
[--enabled (yes | no)]

选项
--enabled (yes 启用或禁用 ESRS 遥测上传功能。默认情况下,此选项处于启用状态。
| no)

isi esrs telemetry view


查看安全远程服务 (ESRS) 遥测设置。

语法
isi esrs telemetry view

选项
None

OneFS 显示是否已启用 ESRS 遥测和挂起上传的数量。

228 OneFS isi 命令 D 至 L


isi event alerts create
创建新警报。

语法
isi event alerts create <name> <condition> channel
[--category <string>]
[--eventgroup <string>]
[--severity {emergency | critical | warning | information}]
[--limit <integer>]
[--interval <duration>]
[--transient <duration>]
[--verbose]

选项
<name>
指定警报名称。
<condition>
指定将发送警报的条件。
条件值区分大小写。以下值有效:

NEW 报告之前从未报告的事件组实例。
NEW_EVENTS 报告自上次报告事件组以来的新事件组实例。
ONGOING 提供未解决的事件组实例的定期报告。
SEVERITY_INCR 报告自上次报告事件组以来严重性已增加的事件组实例。
EASE
SEVERITY_DECR 报告自上次报告事件组以来严重性已减少的事件组实例。
EASE
RESOLVED 报告自上次报告事件组以来的已解决事件组实例。

<channel> ...
指定要用于传送警报的通道。使用 --channel 参数可指定其他通道。
--category<string>...
指定要发出警报的一个或多个事件组类别的名称。指定 --category 参数可指定其他类别。
--eventgroup<string>...
指定要发出警报的一个或多个事件组的名称。指定 --eventgroup 参数可指定其他事件组。
--severity {emergency | critical | warning | information}
指定将对其报告警报的事件严重性。严重性值区分大小写。重复 --severity 可对其他严重性级别创建
警报报告。
--limit<integer>
设置可发送的警报的最大数量。仅应用于 NEW_EVENTS 警报条件。
--interval<duration>
设置持续警报报告之间的时间段。仅应用于 ONGOING 警报条件。
以下 < 时间 > 值有效:

支持 指定年数
M 指定月数
W 指定周数
D 指定天数

OneFS isi 命令 D 至 L 229


H 指定小时数
m 指定分钟数
s 指定秒数

--transient<duration>
设置报告之前事件组实例必须存在的最短时间。持续时间不超过该时间段的任何实例都将被视为瞬时,
因此不会被报告。
以下 < 时间 > 值有效:

支持 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

{--verbose | -v}
显示更多详细信息。

isi event alerts delete


删除警报。

语法
isi event alerts delete <name>
[--force | -f]
[--verbose | -v]

选项
<名称>
指定要删除的警报的名称。
{--force | -f}
在不要求确认的情况下删除警报。
{--verbose | -v}
显示更多详细信息。

isi event alerts list


显示警报的列表。

语法
isi event alerts list
[--channel | -c <string>]
[--limit | -l <integer>]
[--sort {name | eventgroup | category | channel | condition | limit |

230 OneFS isi 命令 D 至 L


interval | transient}]
[--descending | -d]
[--format {table | json | csv | list}]
[--no-header | -a]
[--no-footer | -z]
[--verbose | -v]

选项
{--channel | -c} <string>...
仅显示指定通道的警报。
{--limit | -l} <integer>
设置要显示的警报的最大数量。
--sort {name | eventgroup | category | channel | condition | limit | interval | transient}
指定作为项目排序依据的字段。
{--descending | -d}
按降序对数据进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi event alerts modify


修改警报。

语法
isi event alerts modify <name>
[--eventgroup <string>]
[--clear-eventgroup]
[--add-eventgroup <string>]
[--remove-eventgroup <string>]
[--category <string>]
[--clear-category]
[--add-category <string>]
[--remove-category <string>]
[--channel | -c <string>]
[--clear-channel]
[--add-channel <string>]
[--remove-channel <string>]
[--severity {emergency | critical | warning | information}]
[--clear-severity]
[--add-severity {emergency | critical | warning | information}]
[--remove-severity {emergency | critical | warning | information}]
[--condition {NEW | NEW_EVENTS | ONGOING | SEVERITY_INCREASE
| SEVERITY_DECREASE | RESOLVED}]
[--limit <integer>]
[--interval <integer> <time>]
[--transient <integer> <time>]
[--verbose]

OneFS isi 命令 D 至 L 231


选项
<name>
指定要修改的警报的名称。
--eventgroup<string>...
指定要发出警报的一个或多个事件组的名称。
--clear-eventgroup
清除要发出警报的事件组的值。
--add-eventgroup<string>...
添加要发出警报的一个或多个事件组的名称。
--remove-eventgroup<string>...
删除要发出警报的一个或多个事件组的名称。
--category<string>...
指定要发出警报的一个或多个事件组类别的名称。
--clear-category
清除要发出警报的事件组类别的值。
--add-category<string>...
添加要发出警报的一个或多个事件组类别的名称。
--remove-category<string>...
删除要发出警报的一个或多个事件组类别的名称。
{--channel | -c} <string>...
指定要用于传送警报的一个或多个通道的名称。
--clear-channel
清除要用于传送警报的通道的值。
--add-channel<string>...
添加要用于传送警报的一个或多个通道的名称。
--remove-channel<string>...
删除要用于传送警报的一个或多个通道的名称。
--severity {emergency | critical | warning | information}
指定将对其报告警报的事件严重性。严重性值区分大小写。重复 --severity 可对其他严重度创建警报
报告。
--clear-severity
清除警报的所有严重性筛选器。
--add-severity {emergency | critical | warning | information}
添加其他严重性值以便对其报告警报。重复 --add-severity 可对其他严重度创建警报报告。
--remove-severity {emergency | critical | warning | information}
删除对其报告警告的严重性值。重复 --remove-severity 可删除对其报告警报的其他严重度。
--condition {NEW | NEW_EVENTS | ONGOING | SEVERITY_INCREASE | SEVERITY_DECREASE | RESOLVED}
指定将发送警报的条件。
条件值区分大小写。以下值有效:

NEW 报告之前从未报告的事件组实例。
NEW_EVENTS 报告自上次报告事件组以来的新事件组实例。
ONGOING 提供未解决的事件组实例的定期报告。
SEVERITY_INCR 报告自上次报告事件组以来严重性已增加的事件组实例。
EASE

SEVERITY_DECR 报告自上次报告事件组以来严重性已减少的事件组实例。
EASE

232 OneFS isi 命令 D 至 L


RESOLVED 报告自上次报告事件组以来的已解决事件组实例。

--limit<integer>
设置可发送的警报的最大数量。仅应用于 NEW_EVENTS 警报条件。
--interval<integer><time>
设置持续警报报告之间的时间段。仅应用于 ONGOING 警报条件。
以下 < 时间 > 值有效:

支持 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

--transient<integer><time>
设置报告之前事件组实例必须存在的最短时间。持续时间不超过该时间段的任何实例都将被视为瞬时,
因此不会被报告。
以下 < 时间 > 值有效:

支持 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

{--verbose | -v}
显示更多详细信息。

isi event alerts view


显示警报的详细信息。

语法
isi event alerts view <name>

选项
<name>
指定警报条件的名称。严重性情况显示为单字母缩写,如下所示:
● I — 信息
● W — 警告
● C — 严重
● E — 紧急
● * — 任何

OneFS isi 命令 D 至 L 233


isi event channels create
创建新通道。

语法
isi event channels create <name> <type>
[--enabled {true | false}]
[--allowed-nodes <integer>]
[--excluded-nodes <integer>]
[--address <string>]
[--send-as <string>]
[--subject <string>]
[--smtp-host <string>]
[--smtp-port <integer>]
[--smtp-use-auth <boolean>]
[--smtp-username <string>]
[--smtp-password <string>]
[--smtp-security {STARTTLS | NONE}]
[--batch {NONE | ALL | CATEGORY | SEVERITY}]
[--batch-period <integer> <time>]
[--host <string>]
[--community <string>]
[--use-snmp-trap {true | false}]
[--snmp-use-v3 {true | false}]
[--snmp-security-name <string>]
[--snmp-security-level {noAuthNoPriv | authNoPriv | authPriv}]
[--snmp-auth-protocol {MD5 | SHA}]
[--snmp-auth-password <string>]
[--snmp-priv-protocol {AES | DES}]
[--snmp-priv-password <string>]
[--snmp-engine-id <string>]
[--verbose]

选项
<name>
指定通道名称。
<type>
指定据以发送警报的机制。
类型值区分大小写。以下值有效:

smtp 通过 SMTP 服务器作为电子邮件发送警报。


snmp 通过 SNMP 发送警报。
connectemc 通过 ConnectEMC 发送警报。

--enabled {true | false}


指定是否启用通道。
--allowed-nodes<integer>...
指定允许通过通道发送警报的一个或多个节点。如果未指定任何允许的节点,将允许群集中的所有节点
发送警报。<integer> 的值是要允许的节点编号。
--excluded-nodes<integer>...
指定不允许通过通道发送警报的一个或多个节点。<integer> 的值是要排除的节点编号。
--address<string>...
仅限 SMTP 通道。指定要在此通道上接收警报的一个或多个电子邮件地址。<string> 的值是一个电子
邮件地址。
--send-as<string>

234 OneFS isi 命令 D 至 L


仅限 SMTP 通道。指定要从此通道上发送警报的电子邮件地址。<string> 的值是一个电子邮件地址。
--subject<string>
仅限 SMTP 通道。指定在此通道上发送的电子邮件的主题行。
--smtp-host<string>
仅限 SMTP 通道。指定 SMTP 中继主机。
--smtp-port<integer>
仅限 SMTP 通道。指定 SMTP 中继端口。
--smtp-use-auth {true | false}
仅限 SMTP 通道。启用或禁用 SMTP 身份认证。
--smtp-username<string>
仅限 SMTP 通道。指定用于 SMTP 身份认证的用户名。
--smtp-password<string>
仅限 SMTP 通道。指定用于 SMTP 身份认证的密码。
--smtp-security {STARTTLS | NONE}
仅限 SMTP 通道。启用或禁用 SMTP 加密。
--batch {NONE | ALL | CATEGORY | SEVERITY}
仅限 SMTP 通道。指定将如何批处理 SMTP 警报。
--batch-period <integer> <time>
仅限 SMTP 通道。指定批处理警报之间的间隔。
以下 < 时间 > 值有效:

支持 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

--host<string>
仅限 SNMP 通道。指定主机名或地址
--community<string>
仅限 SNMP 通道。指定社区字符串。
--use-snmp-trap {true | false}
对于此通道指定使用 snmptrap 而非 snmpinform。
--snmp-use-v3 {true | false}
对于此通道指定使用版本 3 陷阱。
--snmp-security-name<string>
指定版本 3 用户的名称。
--snmp-security-level {noAuthNoPriv | authNoPriv | authPriv}
对于此通道指定 SNMPv3 安全级别。
--snmp-auth-protocol {MD5 | SHA}
指定要用于此通道的 SNMPv3 身份验证算法。
--snmp-auth-password<string>
指定 SNMPv3 身份验证密码。
--snmp-priv-protocol {AES | DES}
指定要用于此通道的 SNMPv3 加密算法。
--snmp-priv-password<string>
指定 SNMPv3 加密密码。

OneFS isi 命令 D 至 L 235


--snmp-engine-id<string>
指定接收陷阱守护程序的 SNMPv3 引擎 ID。
{--verbose | -v}
显示更多详细信息。

isi event channels delete


删除通道。

语法
isi event channels delete <名称>
[--force]
[--verbose]

选项
<名称>
指定要删除的通道的名称。
{--force | -f}
在不要求确认的情况下删除通道。
{--verbose | -v}
显示更多详细信息。

isi event channels list


显示通道的列表。

语法
isi event channels list
[--limit <integer>]
[--sort {id | name | type | enabled | allowed_nodes | excluded_nodes |
address | send_as | subject | smtp_host | smtp_port |
smtp_use_auth | smtp_username | smtp_password | smtp_security |
batch | batch_period | host | community}
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} <integer>
设置要显示的通道的最大数量。
--sort {id | name | type | enabled | allowed_nodes | excluded_nodes | address | send_as | subject |
smtp_host | smtp_port | smtp_use_auth | smtp_username | smtp_password | smtp_security | batch |
batch_period | host | community}
指定作为项目排序依据的字段。
{--descending | -d}

236 OneFS isi 命令 D 至 L


按降序对数据进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi event channels modify


修改通道。

语法
isi event channels <名称>
[--type {smtp | snmp | connectemc}]
[--enabled {true | false}]
[--allowed-nodes <整数>]
[--clear-allowed-nodes]
[--add-allowed-nodes <整数>]
[--remove-allowed-nodes <整数>]
[--excluded-nodes <整数>]
[--clear-excluded-nodes]
[--add-excluded-nodes <整数>]
[--remove-excluded-nodes <整数>]
[--address <字符串>]
[--clear-address]
[--add-address <字符串>]
[--remove-address <字符串>]
[--send-as <字符串>]
[--subject <字符串>]
[--smtp-host <字符串>]
[--smtp-port <整数>]
[--smtp-use-auth <布尔值>]
[--smtp-username <字符串>]
[--smtp-password <字符串>]
[--smtp-security {STARTTLS | NONE}]
[--batch {NONE | 全部 | CATEGORY | SEVERITY}]
[--batch-period <整数> <时间>]
[--host <字符串>]
[--community <string>]
[--verbose]

选项
<name>
指定要修改的通道的名称。
<type>
指定据以发送警报的机制。
类型值区分大小写。以下值有效:

smtp 通过 SMTP 服务器作为电子邮件发送警报。


snmp 通过 SNMP 发送警报。
connectemc 通过 ConnectEMC 发送警报。

OneFS isi 命令 D 至 L 237


--enabled {true | false}
指定是否启用通道。
--allowed-nodes<integer>...
指定允许通过通道发送警报的一个或多个节点。如果未指定任何允许的节点,将允许群集中的所有节点
发送警报。<integer> 的值是要允许的节点编号。
--clear-allowed-nodes
清除允许节点的所有值。
--add-allowed-nodes<integer>...
将一个或多个节点添加到允许节点列表。<integer> 的值是要允许的节点编号。
--remove-allowed-nodes<integer>...
从允许节点列表中删除一个或多个节点。<integer> 的值是要删除的节点编号。
--excluded-nodes<integer>...
指定不允许通过通道发送警报的一个或多个节点。<integer> 的值是要排除的节点编号。
--clear-excluded-nodes
清除排除节点的所有值。
--add-excluded-nodes<integer>...
将一个或多个节点添加到排除节点列表。<integer> 的值是要排除的节点编号。
--remove-excluded-nodes<integer>...
从排除节点列表中删除一个或多个节点。<integer> 的值是要删除的节点编号。
--address<string>...
仅限 SMTP 通道。指定要在此通道上接收警报的一个或多个电子邮件地址。<string> 的值是一个电子
邮件地址。
--clear-address
仅限 SMTP 通道。清除电子邮件地址的所有值。
--add-address<string>...
仅限 SMTP 通道。指定要添加到此通道的警报分发列表的一个或多个电子邮件地址。<string> 的值是
一个电子邮件地址。
--remove-address<string>...
仅限 SMTP 通道。指定要从此通道的警报分发列表中删除的一个或多个电子邮件地址。<string> 的值
是一个电子邮件地址。
--send-as<string>
仅限 SMTP 通道。指定要从此通道上发送警报的电子邮件地址。<string> 的值是一个电子邮件地址。
--subject<string>
仅限 SMTP 通道。指定在此通道上发送的电子邮件的主题行。
--smtp-host<string>
仅限 SMTP 通道。指定 SMTP 中继主机。
--smtp-port<integer>
仅限 SMTP 通道。指定 SMTP 中继端口。
--smtp-use-auth {true | false}
仅限 SMTP 通道。启用或禁用 SMTP 身份认证。
--smtp-username<string>
仅限 SMTP 通道。指定用于 SMTP 身份认证的用户名。
--smtp-password<string>
仅限 SMTP 通道。指定用于 SMTP 身份认证的密码。
--smtp-security {STARTTLS | NONE}
仅限 SMTP 通道。启用或禁用 SMTP 加密。
--batch {NONE | ALL | CATEGORY | SEVERITY}
仅限 SMTP 通道。指定将如何批处理 SMTP 警报。
--batch-period <integer> <time>

238 OneFS isi 命令 D 至 L


仅限 SMTP 通道。指定批处理警报之间的间隔。
以下 < 时间 > 值有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

--host<string>
仅限 SNMP 通道。指定主机名或地址
--community<string>
仅限 SNMP 通道。指定社区字符串。
{--verbose | -v}
显示更多详细信息。

isi event channels view


显示通道的详细信息。

语法
isi event channels view <名称>

选项
<名称>
指定要查看的通道的名称。

isi event events list


显示所有事件。

语法
isi event events list
[--eventgroup-id <name>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--eventgroup-id<name>
显示指定事件组中包含的事件。

OneFS isi 命令 D 至 L 239


--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi event events view


显示事件的详细信息。

语法
isi event events view <ID>

选项
<ID>
指定要查看的事件的实例 ID。

isi event groups bulk


更改所有事件组的状态。

语法
isi event groups bulk
[--ignore {true | false}]
[--resolved {true | false}]
[--verbose]

选项
--ignore {true | false}
指定所有事件组的状态是否都为 ignored。
--resolved {true | false}
指定所有事件组的状态是否都为 resolved。
解决事件组之后,就无法反向该操作。添加到已解决事件组的任何新事件都将添加到新事件组。
{--verbose | -v}
显示更多详细信息。

240 OneFS isi 命令 D 至 L


isi event groups list
显示所有事件组的列表。

语法
isi event groups list
[--begin <时间戳>]
[--end <时间戳>]
[--resolved {true | false}]
[--ignore {true | false}]
[--events <整数>]
[--cause <字符串>]
[--limit <整数>]
[--sort {id | started | causes_long | last_event | ignore |
ignore_time | resolved | ended | 事件 | severity}
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--begin | -b} <timestamp>
筛选列表以仅显示指定日期和时间之后创建的事件组。
采用以下格式指定 < 时间戳 >:
{--end | -e} <timestamp>

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

筛选列表以仅显示指定日期和时间之前创建的事件组。
采用以下格式指定 < 时间戳 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

--resolved {true | false}


指定是否此列表仅将显示已解决或未解决的事件组。
--ignore {true | false}
指定是否此列表仅将显示已忽略或未忽略的事件组。
--events<integer>
筛选列表以仅显示针对事件组记录指定数量的事件的事件组。
--cause<string>
筛选列表以仅显示含指定原因的事件组。
{--limit | -l} <integer>
设置要显示的事件组的最大数量。
--sort {id | started | causes_long | last_event | ignore | ignore_time | resolved | ended | events |
severity}
指定作为项目排序依据的字段。
{--descending | -d}
按降序对数据进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}

OneFS isi 命令 D 至 L 241


显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi event groups modify


更改事件组的状态。

语法
isi event <ID>
[--ignore {true | false}]
[--resolved {true | false}]
[--verbose]

选项
<ID>
指定要修改的事件组的 ID 编号。
--ignore {true | false}
指定事件组的状态是否为 ignored。
--resolved {true | false}
指定事件组的状态是否为 resolved。
解决事件组之后,就无法反向该操作。添加到已解决事件组的任何新事件都将添加到新事件组。
{--verbose | -v}
显示更多详细信息。

isi event groups view


查看事件组的详细信息。

语法
isi event groups view <ID>

选项
<ID>
指定要查看的事件组的 ID 编号。

242 OneFS isi 命令 D 至 L


isi event maintenance list
列出设置保留时间中包含的所有维护模式期间。

语法

isi event maintenance list


[{--limit | -l} <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[{--verbose]| -v}
[{--help | -h}

选项
{--limit | -l} < 整数 >
显示不超过指定数量的事件维护模式。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi event maintenance modify


在群集上启用或禁用维护模式。

语法
isi event maintenance modify [--enable={true | false}]
[{--help | -h }]
[{--verbose] | -v }

选项
--enable={true | false}
指定在群集上是启用 (true) 还是禁用 (false) 维护模式。
--help | -h
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 243


isi event maintenance view
显示当前维护模式状态。

语法
isi event maintenance view
[{--help | -h}]

选项
--help | -h
显示此命令的帮助。

isi event settings modify


配置事件存储设置。

语法
isi event settings modify
[--retention-days <整数>]
[--storage-limit <整数>]
[--maintenance-start <时间戳>]
[--clear-maintenance-start]
[--maintenance-duration <持续时间>]
[--heartbeat-interval <字符串>]
[--verbose]

选项
{--retention-days | -r} <integer>
已解决事件组数据的保留(天)。
{--storage-limit | -s} <integer>
设置事件数据都可以在群集上占用的内存量。您可以将此限制设置为介于 1 到 100 MB 的内存。对于较
小群集,将保留的最低内存量为 1 GB。
--maintenance-start<timestamp>
设置维护窗口的开始日期和时间。
采用以下格式指定 < 时间戳 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

--clear-maintenance-start
清除维护窗口的开始日期和时间值。
--maintenance-duration<integer><time>
设置维护窗口的持续时间。
以下 < 时间 > 值有效:

Y 指定年数
M 指定月数

244 OneFS isi 命令 D 至 L


W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

--heartbeat-interval<string>
设置心跳事件之间的间隔。
以下 < 时间 > 值有效:
● 每天
● 每周
● monthly
{--verbose | -v}
显示更多详细信息。

isi event settings view


显示事件存储设置。

语法
isi event settings view

isi event test create


创建测试警报。

语法
isi event test create <消息>
[--verbose]

选项
<message>
指定测试警报的消息文本。
{--verbose | -v}
显示更多详细信息。

isi event thresholds list


显示可配置事件阈值的列表及其当前值和默认值。

语法
严重级别以缩写进行显示,如下所示:

OneFS isi 命令 D 至 L 245


● info — 信息
● warn — 警告
● crit — 关键
● emerg — 紧急

isi event thresholds list


[--limit | -l <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} <integer>
设置要显示的警报的最大数量。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi event thresholds modify


调整事件的警报阈值。

语法
isi event thresholds modify [id]
[{--info | -i} <integer>] |
[{--warn | -w} <integer> ] |
[{--crit | -c} <integer> ] |
[{--emerg | -e} <integer> ] |
[--verbose | -v]
[--help | -h]

选项
<id>
要修改的事件的标识符。
{--info | -i} <integer>
info 报告级别的阈值百分比:0 至 100。
{--warn | -w} <integer>
--warn 报告级别的阈值百分比:0 至 100。
{--crit | -c} <integer>
--crit 报告级别的阈值百分比:0 至 100。
{--emerg | -e} <integer>
--emerg 报告级别的阈值百分比:0 至 100。

246 OneFS isi 命令 D 至 L


{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。
示例
以下命令调整磁盘池空间事件的关键报告级别,以便在使用率达到 70% 时引发警报。使用 isi event thresholds list
命令获取事件 ID。

isi event thresholds modify 100010015 -c 70

isi event thresholds reset


将指定事件的阈值重置为其默认值。如果未指定任何阈值级别,则会将所有级别都重置为其默认值。

语法
isi event thresholds reset <id>
[--all | -a]
[{--info | -i} | {--warn | -w} | {--crit | -c} | {--emerg | -e}]
[{--help | -h}]
[{--verbose | -v}]

选项
<id>
要重置的事件的标识符。
{--all | -a}
将所有阈值级别重置为其默认值。
{-- info | -i}
将 --info 阈值级别重置为其默认值。
{--warn | -w}
将 --warn 阈值级别重置为其默认值。
{--crit | -c}
将 --crit 阈值级别重置为其默认值。
{--emerg | -e}
将 --emerg 阈值级别重置为其默认值。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 247


isi event thresholds view
查看事件阈值的详细属性。

语法
isi event thresholds view <id>
[{--help | -h}]

选项
<id>
事件标识符。要获取事件 ID,请运行命令 isi event thresholds list。
{--help | -h}
显示此命令的帮助。

isi event types list


查看 OneFS 事件类别的列表。

语法
isi event types list
[--category <string>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--category < 字符串 >
输入 OneFS 事件类别。如果不输入类别,则 OneFS 会显示所有类别。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

248 OneFS isi 命令 D 至 L


isi fc settings list
列出光纤通道端口设置。

语法
isi fc settings list
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示光纤通道端口设置。
{--no-header | -a}]
不会以表格或 CSV 格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。

示例
以下命令将显示节点 5 上的所有端口:

isi fc settings list

系统将显示与以下示例类似的输出:

Port WWNN WWPN State Topology Rate


5:1 2000001b3214ccc3 2100001b3214ccc3 enabled auto auto
5:2 2000001b3234ccc3 2101001b3234ccc3 enabled auto auto
5:3 2000001b3254ccc3 2100001b3254ccc3 enabled auto auto
5:4 2000001b3234ccc3 2103001b3274ccc3 enabled auto auto

isi fc settings modify


修改特定端口的光纤通道设置。

语法
isi fc settings modify --port <port>
[--wwnn <string>]
[--wwpn <string>]
[--state {enable | disable}]
[--topology {auto | loop | ptp}]
[--rate {auto | 1 | 2 | 4 | 8}]

选项
--wwnn < 字符串 >
以 16 个十六进制数字的字符串形式指定端口的全球通用节点名称 (WWNN)。

OneFS isi 命令 D 至 L 249


--wwpn < 字符串 >
以 16 个十六进制数字的字符串形式指定端口的全球通用端口名称 (WWPN)。
--state {enable | disable}
指定端口是已启用还是已禁用。
--topology {auto | loop | ptp}
指定端口需要的光纤通道拓扑的类型。以下设置有效:

auto 使端口自动检测拓扑。这是建议设置。如果使用的是连接结构拓扑,则指定此设
置。
loop 导致端口需要仲裁环路拓扑,且有多个备份设备以循环方式连接至单个端口。
ptp 导致端口需要点到点拓扑,且有一个备份设备或光纤通道交换机直接连接至端口。

--rate {auto | 1 | 2 | 4 | 8}
指定 OneFS 尝试通过端口发送数据的速率。以下速率有效:

auto OneFS 自动与 DMA 协商以确定速率。这是建议设置。


1 尝试通过端口以每秒 1 Gb 的速度发送数据。
2 尝试通过端口以每秒 2 Gb 的速度发送数据。
4 尝试通过端口以每秒 4 Gb 的速度发送数据。
8 尝试通过端口以每秒 8 Gb 的速度发送数据。

isi fc settings view


显示特定光纤通道端口的设置。

语法
isi fc settings view port
[--format {list | json}]

选项
<port>
采用 <lnn>.<fc port> 格式的光纤通道端口 ID。
--format {list | json}
以列表或 JSON 格式显示光纤通道端口设置。

isi file-filter settings modify


修改访问分区中的文件筛选设置。

语法
isi file-filter settings modify
[--file-filtering-enabled {yes | no}]
[--revert-file-filtering-enabled]
[--file-filter-extensions < 字符串 >...]
[--clear-file-filter-extensions]
[--add-file-filter-extensions < 字符串 >]
[--remove-file-filter-extensions < 字符串 >]
[--revert-file-filter-extensions]

250 OneFS isi 命令 D 至 L


[--file-filter-type {allow | deny}]
[--revert-file-filter-type
[--zone < 字符串 >]
[--verbose]

选项
--file-filtering-enabled {yes | no}
启用或禁用访问分区中的文件筛选。默认情况下,禁用文件筛选。
--revert-file-filtering-enabled
将 --file-filtering-enabled 的值设置为系统默认值。
--file-filter-extensions< 字符串 >...
按扩展名指定文件类型的列表。每个扩展名都应该以“.”开头,如 .txt。您可在逗号分隔列表中指定多
个扩展名,也可以为每个扩展名运行 --file-filter-extensions。
--clear-file-filter-extensions
删除文件筛选器扩展名的整个列表。
--add-file-filter-extensions< 字符串 >
向列表添加一个或多个文件筛选器扩展名。每个扩展名都应该以“.”开头,如 .txt。您可在逗号分隔列
表中指定多个扩展名,也可以为每个扩展名运行 --add-file-filter-extensions。
--remove-file-filter-extensions< 字符串 >
从列表中删除一个或多个文件筛选器扩展名。每个扩展名都应该以“.”开头,如 .txt。您可在逗号分隔
列表中指定多个扩展名,也可以为每个扩展名运行 --remove-file-filter-extensions。
--revert-file-filter-extensions
将 --file-filter-extensions 的值设置为系统默认值。
--file-filter-type {allow | deny}
指定是允许还是拒绝扩展名列表中的文件类型的写入访问权限。默认筛选器类型是 deny。
--revert-file-filter-type
将 --revert-file-filter-type 的值设置为系统默认值。
--zone< 字符串 >
指定要应用设置的访问分区。如果未指定分区,设置将应用于系统分区。
{--verbose | -v}
显示更多详细信息。

isi file-filter settings view


显示访问分区的文件筛选设置。

语法
isi file-filter settings view
[--zone < 字符串 >]
[--format {list | json}]

选项
--zone
指定访问分区的名称。如果未指定访问分区,系统将显示系统分区的文件筛选设置。
--format {list | json}
指定是将输出显示为列表(默认值)还是以 JavaScript Object Notation (JSON) 显示。

OneFS isi 命令 D 至 L 251


isi filepool apply
将所有文件池策略应用到指定的文件或目录路径。如果没有与文件或目录路径匹配的策略,OneFS 将应用默认的文件池策略。

语法

isi filepool apply < 路径 >


[--path]< 路径 >
[--dont-restripe]
[--nop]
[--stats]
[--quiet]
[--recurse]
[--verbose]

选项
--path< 路径 >
指定要处理的文件的路径。此参数是必需的。
--dont-restripe
在不重新分条文件的情况下更改按文件策略。
--nop
计算指定的设置而不实际应用这些设置。此选项最好与 –-verbose 或 --stats 结合使用。
--stats
显示有关处理的文件的统计信息。
--quiet
禁止警告消息。
--recurse
指定通过目录的递归。
--verbose
显示要应用的配置设置。我们建议使用详细模式。否则,除了错误消息之外,此命令不会显示其他任何
屏幕输出。

示例
这些示例显示以详细模式运行 isi filepool apply 的结果。在这些示例中,输出显示指定路径与每个文件池策略的对比结
果。设置 recurse 选项,以便 /ifs/data/projects 路径中的所有文件均与所有文件池策略匹配。列出的第一个策略始终
是系统默认策略。在此示例中,第二个匹配项是 Technical Data 文件池策略。

isi filepool apply --path=/ifs/data/projects --verbose --recurse

Processing file /ifs/data/projects


Protection Level is DiskPool minimum
Layout policy is concurrent access
coalescer_enabled is true
data_disk_pool_policy_id is any pool group ID
data SSD strategy is metadata
snapshot_disk_pool_policy_id is any pool group ID
snapshot SSD strategy is metadata
cloud provider id is 0
New File Attributes
Protection Level is DiskPool minimum

252 OneFS isi 命令 D 至 L


Layout policy is concurrent access
coalescer_enabled is true
data_disk_pool_policy_id is any pool group ID
data SSD strategy is metadata
snapshot_disk_pool_policy_id is any pool group ID
snapshot SSD strategy is metadata
cloud provider id is 0

{'default' :
{'Policy Number': -2,
'Files matched': {'head':0, 'snapshot': 0},
'Directories matched': {'head':1, 'snapshot': 0},
'ADS containers matched': {'head':0, 'snapshot': 0},
'ADS streams matched': {'head':0, 'snapshot': 0},
'Access changes skipped': 0,
'Protection changes skipped': 0,
'File creation templates matched': 1,
'File data placed on HDDs': {'head':0, 'snapshot': 0},
'File data placed on SSDs': {'head':0, 'snapshot': 0},
},
'system':

'Technical Data':
{'Policy Number': 0,
'Files matched': {'head':0, 'snapshot': 0},
'Directories matched': {'head':0, 'snapshot': 0},
'ADS containers matched': {'head':0, 'snapshot': 0},
'ADS streams matched': {'head':0, 'snapshot': 0},
'Access changes skipped': 0,
'Protection changes skipped': 0,
'File creation templates matched': 0,
'File data placed on HDDs': {'head':0, 'snapshot': 0},
'File data placed on SSDs': {'head':0, 'snapshot': 0},

此示例显示使用 --nop 选项进行以下操作的结果:计算应用文件池策略可能产生的结果。

isi filepool apply --path=/ifs/data/projects --nop --verbose

Processing file /ifs/data/projects


Protection Level is DiskPool minimum
Layout policy is concurrent access
coalescer_enabled is true
data_disk_pool_policy_id is any pool group ID
data SSD strategy is metadata
snapshot_disk_pool_policy_id is any pool group ID
snapshot SSD strategy is metadata
cloud provider id is 0
New File Attributes
Protection Level is DiskPool minimum
Layout policy is concurrent access
coalescer_enabled is true
data_disk_pool_policy_id is any pool group ID
data SSD strategy is metadata
snapshot_disk_pool_policy_id is any pool group ID
snapshot SSD strategy is metadata
cloud provider id is 0

{'default' :
{'Policy Number': -2,
'Files matched': {'head':0, 'snapshot': 0},
'Directories matched': {'head':1, 'snapshot': 0},
'ADS containers matched': {'head':0, 'snapshot': 0},
'ADS streams matched': {'head':0, 'snapshot': 0},
'Access changes skipped': 0,
'Protection changes skipped': 0,
'File creation templates matched': 1,
'File data placed on HDDs': {'head':0, 'snapshot': 0},
'File data placed on SSDs': {'head':0, 'snapshot': 0},
},
'system':
{'Policy Number': -1,
'Files matched': {'head':0, 'snapshot': 0},

OneFS isi 命令 D 至 L 253


'Directories matched': {'head':0, 'snapshot': 0},
'ADS containers matched': {'head':0, 'snapshot': 0},
'ADS streams matched': {'head':0, 'snapshot': 0},
'Access changes skipped': 0,
'Protection changes skipped': 0,
'File creation templates matched': 0,
'File data placed on HDDs': {'head':0, 'snapshot': 0},
'File data placed on SSDs': {'head':0, 'snapshot': 0},
},

isi filepool default-policy modify


修改默认文件池策略设置。默认文件池策略为不适合采用更高优先级文件池策略的所有文件指定存储设置。

语法

isi filepool default-policy modify


[--data-access-pattern {random | concurrency | streaming}]
[--set-requested-protection {default | +1 | +2:1 | +2 | +3:1 |
+3 | +4 | 2x | 3x | 4x | 5x | 6x |
7x | 8x}]
[--data-storage-target <string>]
[--data-ssd-strategy {metadata | metadata-write | data | avoid}]
[--snapshot-storage-target <string>]
[--snapshot-ssd-strategy {metadata | metadata-write | data | avoid}]
[--enable-coalescer {yes | no}]
[--cloud-pool <string>]
[--cloud-accessibility {cached | no-cache}]
[--cloud-cache-expiration <duration>]
[--cloud-compression-enabled {yes | no}]
[--cloud-data-retention <duration>]
[--cloud-encryption-enabled {yes | no}]
[--cloud-full-backup-retention <duration>]
[--cloud-incremental-backup-retention <duration>]
[--cloud-read-ahead <string>]
[--cloud-writeback-frequency <duration>]
[--cloud-archive-snapshot-files {yes | no}]
[--verbose]

选项
--data-access-pattern < 字符串 >
指定首选数据访问模式,random、streaming 或 concurrent 之一。
--set-requested-protection < 字符串 >
为匹配此文件池策略的文件指定请求的保护(例如 +2:1)。
--data-storage-target< 字符串 >
指定策略要将本地群集上的文件移入其中的节点池或层。
--data-ssd-strategy < 字符串 >
指定如何使用 SSD 存储本地数据。

avoid 仅将所有关联文件数据和元数据写入 HDD。


元数据 将文件数据和元数据均写入 HDD。这是默认设置。如果 SSD 可用,则将文件元数
据的一份额外镜像写入 SSD。SSD 镜像是满足请求的保护所需的数量以外的
SSD。启用全局命名空间加速 (GNA) 使读取加速对不包含 SSD 的节点池中的文件
可用。

254 OneFS isi 命令 D 至 L


metadata-write 将文件数据写入 HDD,将元数据写入 SSD(可用时)。此战略除了加速读取外,
还可加速元数据的写入,但比 Metadata 设置所需的 SSD 存储空间要多大约 4-5
倍。启用 GNA 不会影响读/写加速。
数据 对数据和元数据均使用 SSD 节点池,无论是否启用了全局命名空间加速。此 SSD
策略不会创建正常请求保护以外的额外镜像,但较之其他 SSD 策略选项会需要明
显更多的存储空间。

--snapshot-storage-target < 整数 >


为存储快照选择的节点池或层的 ID。
--snapshot-ssd-strategy < 字符串 >
指定如何使用 SSD 存储快照。有效选项包括 metadata、metadata-write、data、avoid。默认值
为 metadata。
--enable-coalescer {yes | no}
启用或禁用 coalescer,也称为 SmartCache。合并器结合使用 RAM 和稳定存储来保护回写数据。合并
器是默认启用的,而且仅应在 EMC Isilon 客户支持的帮助下禁用。
--cloud-pool < 字符串 >
指定默认 CloudPool 以及要归档云数据的云存储帐户。
--cloud-accessibility {cached | no-cache}
指定访问 SmartLink 文件时云数据是将根据需要以增量方式下载(缓存)还是完全下载(未缓存)。
--cloud-cache-expiration < 持续时间 >
指定缓存到期前的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九个小时的持续时间。
同样,设置 2D 将指定两天持续时间。
--cloud-compression-enabled {yes | no}
指定归档到云时是否要压缩数据。
--cloud-data-retention < 持续时间 >
指定从群集中删除 SmartLink 文件后归档数据将在云中保留的最短时间。不接受数字后跟时间单位。例
如,设置 9H 将指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-encryption-enabled {yes | no}
指定归档到云时是否要加密数据。
--cloud-full-backup-retention < 持续时间 >
指定创建完整备份之后云文件将保留的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九
个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-incremental-backup-retention < 持续时间 >
指定创建增量备份之后云文件将保留的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九
个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-read-ahead {partial | full}
访问 SmartLink 文件时指定缓存预读策略。部分策略意味着仅缓存用户需要的数据量。完整策略意味着
用户访问 SmartLink 文件时将缓存所有文件数据。
--cloud-writeback-frequency < 持续时间 >
指定 OneFS 使用本地更改更新云数据前等待的最短时间。不接受数字后跟时间单位。例如,设置 9H 将
指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-archive-snapshot-files {yes | no}
策略是否应归档带快照的文件。
--verbose
显示更多详细信息。

OneFS isi 命令 D 至 L 255


示例
以下示例中显示的命令将以多种方式修改默认文件池策略。该命令将 requested-protection-level 设置为 +2:1,将
data-storage-target 设置为 anywhere(系统默认值),并且将 data--ssd-strategy 更改为 metadata-write。

isi filepool default-policy modify --set-requested-protection=+2:1 --data-storage-


target=anywhere
--data-ssd-strategy=metadata-write

isi filepool default-policy view


查看默认文件池策略设置。默认文件池策略为不适合采用更高优先级文件池策略的所有文件指定存储设置。

语法
isi filepool default-policy view

以下显示内容显示了命令的示例输出:

Apply Order: -
File Matching Pattern: -
Set Requested Protection: default
Data Access Pattern: concurrency
Enable Coalescer: True
Data Storage Target: anywhere
Data SSD Strategy: metadata
Snapshot Storage Target: anywhere
Snapshot SSD Strategy: metadata
Cloud Pool: -
Cloud Compression Enabled: -
Cloud Encryption Enabled: -
Cloud Data Retention: -
Cloud Incremental Backup Retention: -
Cloud Full Backup Retention: -
Cloud Accessibility: -
Cloud Read Ahead: -
Cloud Cache Expiration: -
Cloud Writeback Frequency: -
Cloud Archive Snapshot Files: -

isi filepool policies create


创建自定义文件池策略,以标识特定存储目标并在匹配的文件和目录上执行其他操作。

语法

isi filepool policies create <name>


[--description <string>]
[--begin-filter{<predicate> <operator> <link>}...--end-filter]
[--apply-order <integer>]
[--data-access-pattern {random | concurrency | streaming}]
[--set-requested-protection {default | +1 | +2:1 | +2 | +3:1 | +3 | +4 | 2x | 3x | 4x |
5x | 6x | 7x | 8x}]
[--data-storage-target <string>]
[--data-ssd-strategy {metadata | metadata-write | data | avoid}]
[--snapshot-storage-target <string>]

256 OneFS isi 命令 D 至 L


[--snapshot-ssd-strategy {metadata | metadata-write | data | avoid}]
[--enable-coalescer {Yes | No}]
[--enable-packing {Yes | No}]
[--cloud-pool <string>]
[--cloud-accessibility {cached | no-cache}]
[--cloud-cache-expiration <duration>]
[--cloud-compression-enabled {yes | no}]
[--cloud-data-retention <duration>]
[--cloud-encryption-enabled {yes | no}]
[--cloud-full-backup-retention <duration>]
[--cloud-incremental-backup-retention <duration>]
[--cloud-read-ahead <string>]
[--cloud-writeback-frequency <duration>]
[--cloud-archive-snapshot-files {yes | no}]
[{--verbose | -v}]

选项
<name>
指定要创建的文件池策略的名称。
--begin-filter {< 谓词 > < 运算符 > < 链接 >}... --end-filter
指定用于确定要通过文件池策略进行管理的文件的文件匹配条件。
每个文件匹配条件由三部分组成:
● 谓词。指定用作筛选条件的属性。您可以按路径、名称、文件类型、时间戳或自定义属性进行筛选,
也可以使用这些属性的组合进行筛选。
● 运算符。确定一个属性(例如出生日期)来描述与该属性的关系(例如之前)。
● 链接 — 使用 AND 和 OR 语句合并属性。
以下谓词有效:
--size=<nn>[{B | KB | MB | GB | TB | PB}]
根据指定大小选择文件。
--path=< 路径名 >
选择与指定路径名相关的文件。
--file-type= < 值 >
仅选择指定的文件系统对象类型。
以下值有效:

file 指定常规文件。

directory 指定目录。

other 指定链接。

--name= < 值 > [--case-sensitive= {true | false}]


仅选择名称与指定字符串匹配的文件。使用 --case-sensitive=true 可启用区分大小写。
构成名称时,可以包括以下通配符:
● *
● [ ]
● ?

--birth-time=< 时间戳 >


选择相对于指定日期和时间创建的文件。时间戳参数的格式为 YYYY-MM-DDTHH:MM:SS。例
如,2013-09-01T08:00:00 指定 2013 年 9 月 1 日早上 8:00 的时间戳。您可以将 --
operator= 与 gt 的参数结合使用,以表示在时间戳之后,或者与 lt 的参数结合使用,以表
示在时间戳之前。

OneFS isi 命令 D 至 L 257


--changed-time=< 时间戳 >
选择相对于指定日期和时间修改的文件。
--metadata-changed-time=< 时间戳 >
选择相对于指定日期和时间修改了其元数据的文件。
--accessed-time=< 时间戳 >
选择以指定时间间隔访问的文件。
--custom-attribute=< 值 >
根据自定义属性选择文件。
您可以使用 operator= 选项为文件匹配条件指定限定符。采用以下格式指定运算符:

--operator=<value>

以下运算符值有效:

Value 描述

eq 等于。这是默认值。

ne 不等于

lt 小于

le 小于或等于

gt 大于

ge 大于或等于

not 非

可以使用链接参数指定多个文件匹配条件。以下链接有效:
--and
连接两个文件匹配条件,其中的文件必须同时满足两个条件。
--or
连接两个文件匹配条件,其中的文件必须满足其中一个条件。
--description < 字符串 >
指定文件池策略的描述。
--apply-order < 整数 >
指定执行此策略的顺序索引。
--data-access-pattern < 字符串 >
数据访问模式随机,流或并发。
--set-requested-protection< 字符串 >
指定匹配此文件池策略的文件的保护级别(例如 +3、+2:3、8x)。
--data-storage-target< 字符串 >
策略要将本地群集上的文件移入其中的节点池或层的名称。如果您不指定数据存储目标,默认值为
anywhere。
--data-ssd-strategy < 字符串 >
指定如何使用 SSD 存储本地数据。

avoid 仅将所有关联文件数据和元数据写入 HDD。

258 OneFS isi 命令 D 至 L


元数据 将文件数据和元数据均写入 HDD。这是默认设置。如果 SSD 可用,则将文件元数
据的一份额外镜像写入 SSD。SSD 镜像是满足请求的保护所需的数量以外的
SSD。启用 GNA 使读取加速对不包含 SSD 的节点池中的文件可用。
metadata-write 将文件数据写入 HDD,将元数据写入 SSD(可用时)。此战略除了加速读取外,
还可加速元数据的写入,但比 Metadata 设置所需的 SSD 存储空间要多大约 4-5
倍。启用 GNA 不会影响读/写加速。
数据 对数据和元数据均使用 SSD 节点池,无论是否启用了全局命名空间加速。此 SSD
战略不会导致创建正常请求保护以外的额外镜像,但与其他 SSD 战略选项相比,
需要显著增加存储要求。

--snapshot-storage-target < 字符串 >


为存储快照选择的节点池或层的名称。如果您不指定快照存储目标,默认值为 anywhere。
--snapshot-ssd-strategy < 字符串 >
指定如何使用 SSD 存储快照。有效选项包括 metadata、metadata-write、data、avoid。默认值
为 metadata。
--enable-coalescer {Yes | No}
启用 coalescer。
--enable-packing {Yes | No}
启用打包。
--cloud-pool <string>
指定默认 CloudPool 以及要归档云数据的云存储帐户。
--cloud-accessibility {cached | no-cache}
指定在没有归档文件的文件池策略的情况下访问 SmartLink(已归档)文件的默认行为。如果有归档文件
的文件池策略,则该策略及其设置优先于 --cloud-accessibility 设置。指定 cache 以确保只根
据高速缓存保留设置高速缓存和刷新请求的数据块或使其失效。指定 no-cache 以确保不会高速缓存数
据块,并且不会长期使用文件系统数据块。
--cloud-cache-expiration < 持续时间 >
指定缓存到期前的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九个小时的持续时间。
同样,设置 2D 将指定两天持续时间。
--cloud-compression-enabled {yes | no}
指定归档到云时是否要压缩数据。
--cloud-data-retention < 持续时间 >
指定从群集中删除 SmartLink 文件后归档数据将在云中保留的最短时间。不接受数字后跟时间单位。例
如,设置 9H 将指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-encryption-enabled {yes | no}
指定归档到云时是否要加密数据。
--cloud-full-backup-retention < 持续时间 >
指定创建完整备份之后云文件将保留的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九
个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-incremental-backup-retention < 持续时间 >
指定创建增量备份之后云文件将保留的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九
个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-read-ahead {partial | full}
访问 SmartLink 文件时指定缓存预读策略。部分策略意味着仅缓存用户需要的数据量。完整策略意味着
用户访问 SmartLink 文件时将缓存所有文件数据。
--cloud-writeback-frequency < 持续时间 >
指定 OneFS 使用本地更改更新云数据前等待的最短时间。不接受数字后跟时间单位。例如,设置 9H 将
指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--verbose
显示更多详细信息。

OneFS isi 命令 D 至 L 259


示例
以下示例创建的文件池策略会将 /ifs/data/chemical/arco/finance 目录中的所有文件移至名为 Archive_2 的本地存
储目标。

isi filepool policies create Save_Fin_Data --begin-filter


--path=/ifs/data/chemical/arco/finance --end-filter
--data-storage-target Archive_2 --data-ssd-strategy=metadata

以下示例将匹配在指定日期内未访问或未修改过的较旧文件,并将这些文件移至归档存储层。

isi filepool policies create archive_old


--data-storage-target ARCHIVE_1 --data-ssd-strategy avoid
--begin-filter --file-type=file --and --birth-time=2013-09-01
--operator=lt --and --accessed-time=2013-12-01 --operator=lt
--and --changed-time=2013-12-01 --operator=lt --end-filter

isi filepool policies delete


删除自定义文件池策略。不能删除默认文件池策略。
要列出所有文件池策略,请运行 isi filepool policies list 命令。

语法
isi filepool policies delete < 名称 >
[--force]
[--verbose]

选项
< 名称 >
指定要删除的文件池策略的名称。
--force
删除文件池策略而不要求确认。
--verbose
显示更多详细信息。

示例
以下命令将名为 ARCHIVE_OLD 的文件池策略。--force 选项将绕过确认删除的要求。

isi filepool policies delete ARCHIVE_OLD --force

isi filepool policies list


列出系统上配置的所有自定义文件池策略。

语法
isi filepool policies list
[--limit <integer>]

260 OneFS isi 命令 D 至 L


[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--limit < 整数 >
指定所显示策略数量的限制。
--format
以多种格式输出文件池策略列表。以下选项有效:table 、json 、csv 和 list 。
--no-header
显示不带页眉的表和 CSV 输出。
--no-footer
显示不带页脚的表输出。
--verbose
显示更多详细信息。

示例
以下示例以 .csv 格式列出自定义文件池策略,并将该列表输出到 OneFS 文件系统的文件中。

isi filepool policies list --format csv > /ifs/data/policy.csv

isi filepool policies modify


修改自定义文件池策略。

语法

isi filepool policies modify <id>


[--name <string>]
[--description <string>]
[--begin-filter{<predicate> <operator> <link>}...--end-filter]
[--apply-order <integer>]
[--data-access-pattern {random | concurrency | streaming }]
[--clear-data-access-pattern ]
[--set-requested-protection {{default | +1 | +2:1 | +2 | +3:1 | +3 | +4 | 2x | 3x | 4x
| 5x | 6x | 7x | 8x} | --clear-set-requested-protection}]
[--clear-set-requested-protection ]
[--data-storage-target <string>]
[--clear-data-storage-target]
[--data-ssd-strategy {metadata | metadata-write | data | avoid}]
[--snapshot-storage-target <string>]
[--clear-snapshot-storage-target]
[--snapshot-ssd-strategy {metadata | metadata-write | data | avoid}]
[--enable-coalescer {Yes | No}]
[--clear-enable-coalescer]
[--enable-packing Yes | No}]
[--clear-enable-packing]
[--cloud-pool <string>]
[--clear-cloud-pool]
[--cloud-accessibility {cached | no-cache}]
[--cloud-cache-expiration <duration>]
[--cloud-compression-enabled {yes | no}]

OneFS isi 命令 D 至 L 261


[--cloud-data-retention <duration>]
[--cloud-encryption-enabled {yes | no}]
[--cloud-full-backup-retention <duration>]
[--cloud-incremental-backup-retention <duration>]
[--cloud-read-ahead <string>]
[--cloud-writeback-frequency <duration>]
[--cloud-archive-snapshot-files {yes | no}]
[--verbose]

选项
<id>
指定文件池策略的 ID。
< 名称 >
指定要创建的文件池策略的名称。
--begin-filter {< 谓词 > < 运算符 > < 链接 >}... --end-filter
指定用于确定要通过文件池策略进行管理的文件的文件匹配条件。
每个文件匹配条件由三部分组成:
● 谓词。指定用作筛选条件的属性。您可以按路径、名称、文件类型、时间戳或自定义属性进行筛选,
也可以使用这些属性的组合进行筛选。
● 运算符。确定一个属性(例如出生日期)来描述与该属性的关系(例如之前)。
● 链接 — 使用 AND 和 OR 语句合并属性。
以下谓词有效:
--size=<nn>[{B | KB | MB | GB | TB | PB}]
根据指定大小选择文件。
--path=< 路径名 >
选择与指定路径名相关的文件。
--file-type= < 值 >
仅选择指定的文件系统对象类型。
以下值有效:

file 指定常规文件。

directory 指定目录。

other 指定链接。

--name= < 值 > [--case-sensitive= {true | false}]


仅选择名称与指定字符串匹配的文件。使用 --case-sensitive=true 可启用区分大小写。
构成名称时,可以包括以下通配符:
● *
● [ ]
● ?

--birth-time=< 时间戳 >


选择相对于指定日期和时间创建的文件。时间戳参数的格式为 YYYY-MM-DDTHH:MM:SS。例
如,2013-09-01T08:00:00 指定 2013 年 9 月 1 日早上 8:00 的时间戳。您可以将 --
operator= 与 gt 的参数结合使用,以表示在时间戳之后,或者与 lt 的参数结合使用,以表
示在时间戳之前。
--changed-time=< 时间戳 >
选择相对于指定日期和时间修改的文件。
--metadata-changed-time=< 时间戳 >

262 OneFS isi 命令 D 至 L


选择相对于指定日期和时间修改了其元数据的文件。
--accessed-time=< 时间戳 >
选择以指定时间间隔访问的文件。
--custom-attribute=< 值 >
根据自定义属性选择文件。
您可以使用 operator= 选项为文件匹配条件指定限定符。采用以下格式指定运算符:

--operator=<value>

以下运算符值有效:

Value 描述

eq 等于。这是默认值。

ne 不等于

lt 小于

le 小于或等于

gt 大于

ge 大于或等于

not 非

可以使用链接参数指定多个文件匹配条件。以下链接有效:
--and
连接两个文件匹配条件,其中的文件必须同时满足两个条件。
--or
连接两个文件匹配条件,其中的文件必须满足其中一个条件。
--description < 字符串 >
指定文件池策略的描述。
--apply-order < 整数 >
指定执行此策略的顺序索引。
--data-access-pattern < 字符串 >
将数据访问模式指定为随机、流或并发。
--clear-data-access-pattern
删除在匹配文件上设置数据访问模式的操作。
--set-requested-protection< 字符串 >
指定匹配此文件池策略的文件的保护级别(例如 +3、+2:3、8x)。
--clear-set-requested-protection
删除在匹配文件上设置请求的保护的操作。
--data-storage-target< 字符串 >
策略要将本地群集上的文件移入其中的节点池或层的名称。
--clear-data-storage-target
删除在匹配文件上设置数据存储目标的操作。
--data-ssd-strategy < 字符串 >
指定如何使用 SSD 存储本地数据。

avoid 仅将所有关联文件数据和元数据写入 HDD。

OneFS isi 命令 D 至 L 263


元数据 将文件数据和元数据均写入 HDD。这是默认设置。如果 SSD 可用,则将文件元数
据的一份额外镜像写入 SSD。SSD 镜像是满足请求的保护所需的数量以外的
SSD。启用 GNA 使读取加速对不包含 SSD 的节点池中的文件可用。
metadata-write 将文件数据写入 HDD,将元数据写入 SSD(可用时)。此战略除了加速读取外,
还可加速元数据的写入,但比 Metadata 设置所需的 SSD 存储空间要多大约 4-5
倍。启用 GNA 不会影响读/写加速。
数据 对数据和元数据均使用 SSD 节点池,无论是否启用了全局命名空间加速。此 SSD
战略不会导致创建正常请求保护以外的额外镜像,但与其他 SSD 战略选项相比,
需要显著增加存储要求。

--snapshot-storage-target < 字符串 >


为存储快照选择的节点池或层的名称。
--clear-snapshot-storage-target
删除在匹配文件上设置快照存储目标的操作。
--snapshot-ssd-strategy < 字符串 >
指定如何使用 SSD 存储快照。有效选项包括 metadata、metadata-write、data、avoid。默认值
为 metadata。
--enable-coalescer {Yes | No}
启用 coalescer。
--clear-enable-coalescer
删除在匹配文件上更改 coalescer 设置的操作。
--enable-packing
启用打包。
--clear-enable-packing
删除在匹配文件上更改打包设置的操作。
--cloud-pool <string>
指定默认 CloudPool 以及要归档云数据的云存储帐户。
--clear-cloud-pool
删除在匹配文件上设置云存储目标的操作。
--cloud-accessibility {cached | no-cache}
指定在没有归档文件的文件池策略的情况下访问 SmartLink(已归档)文件的默认行为。如果有归档文件
的文件池策略,则该策略及其设置优先于 --cloud-accessibility 设置。指定 cache 以确保只根
据高速缓存保留设置高速缓存和刷新请求的数据块或使其失效。指定 no-cache 以确保不会高速缓存数
据块,并且不会长期使用文件系统数据块。
--cloud-cache-expiration < 持续时间 >
指定缓存到期前的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九个小时的持续时间。
同样,设置 2D 将指定两天持续时间。
--cloud-compression-enabled {yes | no}
指定归档到云时是否要压缩数据。
--cloud-data-retention < 持续时间 >
指定从群集中删除 SmartLink 文件后归档数据将在云中保留的最短时间。不接受数字后跟时间单位。例
如,设置 9H 将指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-encryption-enabled {yes | no}
指定归档到云时是否要加密数据。
--cloud-full-backup-retention < 持续时间 >
指定创建完整备份之后云文件将保留的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九
个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-incremental-backup-retention < 持续时间 >
指定创建增量备份之后云文件将保留的最短时间。不接受数字后跟时间单位。例如,设置 9H 将指定九
个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--cloud-read-ahead {partial | full}

264 OneFS isi 命令 D 至 L


访问 SmartLink 文件时指定缓存预读策略。部分策略意味着仅缓存用户需要的数据量。完整策略意味着
用户访问 SmartLink 文件时将缓存所有文件数据。
--cloud-writeback-frequency < 持续时间 >
指定 OneFS 使用本地更改更新云数据前等待的最短时间。不接受数字后跟时间单位。例如,设置 9H 将
指定九个小时的持续时间。同样,设置 2D 将指定两天持续时间。
--verbose
显示更多详细信息。

示例
以下示例将修改文件池策略,以将匹配的文件移至名为 Archive_4 的另一个本地存储目标。下次运行 SmartPools 作业时,匹
配的文件将移至新存储目标。

isi filepool policies modify Save_Fin_Data --begin-filter


--path=/ifs/data/chemical/arco/finance --end-filter
--data-storage-target Archive_4 --data-ssd-strategy=metadata

以下示例将匹配在指定日期内未访问或未修改过的较旧文件,并将这些文件移至归档存储层。

isi filepool policies modify archive_old


--data-storage-target ARCHIVE_1 --data-ssd-strategy avoid
--begin-filter --file-type=file --and --birth-time=2013-06-01
--operator=lt --and --accessed-time=2013-09-01 --operator=lt
--and --changed-time=2013-09-01 --operator=lt --end-filter

isi filepool policies view


显示有关自定义文件池策略的详细信息。

语法
isi filepool policies view < 名称 >

选项
< 名称 >
指定要查看的文件池策略的名称。运行 isi filepool policies list 命令,以列出所有自定义
文件池策略的名称。

示例
以下示例显示有关名为 my_policy 的文件池策略的详细信息:

isi filepool policies view my_policy

此命令的输出如下:

Name: my_policy
Description: Archive older files to the cloud
State: OK
State Details:
Apply Order: 1
File Matching Pattern: Path == data/old_files (begins with) AND Name == *.*
Set Requested Protection: -
Data Access Pattern: -

OneFS isi 命令 D 至 L 265


Enable Coalescer: -
Data Storage Target: -
Data SSD Strategy: -
Snapshot Storage Target: -
Snapshot SSD Strategy: -
Cloud Pool: my_s3_pool
Cloud Compression Enabled: False
Cloud Encryption Enabled: False
Cloud Data Retention: 604800
Cloud Incremental Backup Retention: 604800
Cloud Full Backup Retention: 157680000
Cloud Accessibility: cached
Cloud Read Ahead: partial
Cloud Cache Expiration: 86400
Cloud Writeback Frequency: 14400
Cloud Archive Snapshot Files: False

isi filepool templates list


列出可用的文件池策略模板。

语法

isi filepool templates list


[--limit <integer>
[--sort <string>]
[--descending <string>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
指定要显示的模板数。
--sort < 字符串 >
按指定字段对数据进行排序。
--descending | -d
按降序对数据进行排序。
--format
以指定格式显示文件池模板。以下值有效:
table
json
csv
list
--no-header | -a
显示不带页眉的表和 CSV 输出。
--no-footer | -z
显示不带页脚的表输出。
--verbose | -v
显示更多详细信息。

266 OneFS isi 命令 D 至 L


isi filepool templates view
查看文件池策略模板中的详细设置。

语法

isi filepool templates view <name>

选项
<name>
要查看的模板的名称。

isi_for_array
对阵列中的多个节点运行命令(并行或串行)。
选项冲突时,最后指定的选项占优。

注: -k、-u、-p 和 -q 选项仅对 SSH 传输有效。

语法
isi_for_array
[--array-name <array>]
[--array-file <filename>]
[--directory <directory>]
[--diskless]
[--ignore-errors]
[--known-hosts-file <filename>]
[--user <user>]
[--nodes <nodes>]
[--password <password>]
[--pre-command <command>]
[--query-password]
[--quiet]
[--serial]
[--storage]
[--transport <transport-type>]
[--throttle <count>]
[--exclude-nodes <nodes>]
[--exclude-down-nodes]

选项
{--array-name | -a} < 阵列 >
使用 < 阵列 >。
{--array-file | -A} < 文件名 >
从 < 文件名 > 读取阵列信息。首先默认查找 $HOME/.array.xml,然后查找 /etc/ifs/
array.xml。
{--directory | -d} < 目录 >
从远程计算机上的指定目录运行命令。当前工作目录是默认目录。空 < 目录 > 会导致命令在远程计算机上
的用户主目录中运行。

OneFS isi 命令 D 至 L 267


{--diskless | -D}
从无磁盘节点运行命令。
{--ignore-errors | -I}
禁止返回非零退出状态的节点打印错误消息。从所有节点返回最大退出状态。
{--known-hosts-file | -k} < 文件名 >
将 < 文件名 > 用于 SSH 已知主机文件(而不是默认 /dev/null 目录)。
{--user | -u | -l} < 用户 >
以 < 用户 > 身份(而不是默认的 root 用户身份)登录。
{--nodes | -n} < 节点 >
对指定节点(可以多次指定)运行命令。必须是节点名称列表或节点 ID 范围;例如,
1,3-5,neal8,10。如果未显式列出任何节点,则使用整个阵列。
{--password | -p | --pw} < 密码 >
使用指定密码而不是默认密码。
{--pre-command | -P} < 命令 >
在任何其他命令之前运行指定命令。这可用于设置环境,并且可以多次指定。您可以指定 - 以重置预处
理命令的列表。
{--query-password | -q}
提示用户输入密码。
{--quiet | -Q}
禁止对每个输出行打印主机前缀。
{--serial | -s}
以串行(而不是并行)方式运行命令。
{--storage | -S}
从存储节点运行命令。
{--transport | -t} < 传输类型 >
指定网络传输类型。默认值为 rpc。有效值有 rpc 或 ssh。
{--throttle | -T} < 计数 >
调整限制。要禁用限制,请指定 0。默认值为 80(表示多任务)和 35(表示分叉)。
{--exclude-nodes | -x} < 节点 >
从命令中排除指定节点。此参数的指定方式与 -n 选项相同。
{--exclude-down-nodes | -X}
从命令中排除离线节点。此命令仅限于群集本地使用。

示例
在 SmartLock 法规遵从性模式下,要对需要 root 用户权限的命令运行 isi_for_array,您必须指定 sudo 两次。例如,以下
命令将对法规遵从性群集中的每个节点运行 isi statistics client list。

sudo isi_for_array -u compadmin sudo isi statistics client list

isi ftp settings modify


修改群集 FTP 设置。

语法
isi ftp settings modify
[--accept-timeout < 持续时间 >]
[--revert-accept-timeout]

268 OneFS isi 命令 D 至 L


[--allow-anon-access {yes | no}]
[--revert-allow-anon-access]
[--allow-anon-upload {yes | no}]
[--revert-allow-anon-upload
[--allow-dirlists {yes | no}]
[--revert-allow-dirlists]
[--allow-downloads {yes | no}]
[--revert-allow-downloads]
[--allow-local-access {yes | no}]
[--revert-allow-local-access]
[--allow-writes {yes | no}]
[--revert-allow-writes]
[--always-chdir-homedir {yes | no}]
[--revert-always-chdir-homedir]
[--anon-chown-username < 字符串 >]
[--revert-anon-chown-username]
[--anon-password-list < 字符串 >...]
[--clear-anon-password-list]
[--add-anon-password-list < 字符串 >...]
[--remove-anon-password-list < 字符串 >...]
[--revert-anon-password-list]
[--anon-root-path < 路径 >]
[--revert-anon-root-path]
[--anon-umask < 八进制整数 >]
[--revert-anon-umask]
[--ascii-mode {off | 上载 | 下载 | both}]
[--revert-ascii-mode]
[--chroot-exception-list < 字符串 >...]
[--clear-chroot-exception-list]
[--add-chroot-exception-list < 字符串 >...]
[--remove-chroot-exception-list < 字符串 >...]
[--revert-chroot-exception-list]
[--chroot-local-mode {全部 | none | all-with-exceptions | none-with-exceptions}]
[--revert-chroot-local-mode
[--connect-timeout < 持续时间 >]
[--revert-connect-timeout]
[--data-timeout < 持续时间 >]
[--revert-data-timeout]
[--denied-user-list < 字符串 >...]
[--clear-denied-user-list]
[--add-denied-user-list < 字符串 >...]
[--remove-denied-user-list < 字符串 >...]
[--revert-denied-user-list]
[--dirlist-localtime {yes | no}]
[--revert-dirlist-localtime]
[--dirlist-names {数字 | textual | hide}]
[--revert-dirlist-names]
[--file-create-perm < 八进制整数 >]
[--revert-file-create-perm]
[--limit-anon-passwords {yes | no}]
[--revert-limit-anon-passwords]
[--local-root-path < 路径 >]
[--revert-local-root-path]
[--local-umask < 八进制整数 >]
[--revert-local-umask]
[--server-to-server {yes | no}]
[--revert-server-to-server]
[--session-support {yes | no}]
[--revert-session-support]
[--session-timeout < 持续时间 >]
[--revert-session-timeout
[--user-config-dir < 路径 >]
[--revert-user-config-dir]
[--service {yes | no}]

选项
--accept-timeout< 持续时间 >
指定远程客户端在超时前可以建立 PASV 样式数据连接的时间(以秒为单位)。有效值为 30 到 600 之
间的整数。默认值为 60。

OneFS isi 命令 D 至 L 269


--revert-accept-timeout
将值设置为 --accept-timeout 的系统默认值。
--allow-anon-access {yes | no}
控制是否允许匿名登录。如果启用,则用户名 ftp 和匿名均将被识别为匿名登录。默认值为 No。
--revert-allow-anon-access
将值设置为 --allow-anon-access 的系统默认值。
--allow-anon-upload {yes | no}
控制在特定条件下匿名用户是否能够上载文件。要使匿名用户能够上载,必须将 --allow-writes 命
令设置为 Yes,并且匿名用户必须在所需的上载位置具有写入权限。默认值为 Yes。
--revert-allow-anon-upload
将值设置为 --allow-anon-upload 的系统默认值。
--allow-dirlists {yes | no}
控制是否启用目录列出命令。默认值为 Yes。
--revert-allow-dirlists
将值设置为 --allow-dirlists 的系统默认值。
--allow-downloads {yes | no}
控制是否可以下载文件。默认值为 Yes。
--revert-allow-downloads
将值设置为 --allow-downloads 的系统默认值。
--allow-local-access {yes | no}
控制是否允许本地登录。如果设置为 Yes,可以使用普通用户帐户登录。默认值为 Yes。
--revert-allow-local-access
将值设置为 --allow-local-access 的系统默认值。
--allow-writes {yes | no}
设置并显示是否允许更改文件系统的命令。控制是否允许下列任一命令:
● STOR
● DELE
● RNFR
● RNTO
● MKD
● RMD
● APPE
● SITE
默认值为 yes。
--revert-allow-writes
将值设置为 --allow-writes 的系统默认值。
--always-chdir-homedir {yes | no}
控制 FTP 是否始终初始将目录更改为用户的主目录。如果设置为 No,则可以在没有针对该用户的主目
录的情况下在 FTP 中设置一个 chroot 区域。默认值为 Yes。
--revert-always-chdir-homedir
将值设置为 --always-chdir-homedir 的系统默认值。
--anon-chown-username< 字符串 >
为指定用户授予匿名加载的文件的所有权。该值必须是本地用户名。默认值为 root。
--revert-anon-chown-username
将值设置为 --anon-chown-username 的系统默认值。
--anon-password-list< 字符串 >...
显示匿名用户密码列表。
--clear-anon-password-list
清除匿名用户的密码列表。
--add-anon-password-list< 字符串 >...

270 OneFS isi 命令 D 至 L


将项目添加到匿名用户的密码列表。为要添加的每个额外密码指定 --add-anon-password-list。
--remove-anon-password-list< 字符串 >...
从匿名用户的密码列表中删除项目。为要删除的每个额外密码指定 --remove-anon-password-
list。
--revert-anon-password-list
将值设置为 --anon-password-list 的系统默认值。
--anon-root-path< 路径 >
显示并指定匿名用户的根路径,这是 Very Secure FTP Daemon (VSFTPD) 将尝试在匿名登录后更改为
的 /ifs 中的目录。有效路径在 /ifs 中。默认值为 /ifs/home/ftp。
--revert-anon-root-path
将值设置为 --anon-root-path 的系统默认值。
--anon-umask< 八进制整数 >
指定由匿名用户创建的文件的取消掩蔽。有效值为以八进制表示的取消掩蔽数字。默认值为 077。
注: 该值必须包含 0 前缀;否则将解释为以 10 为底的整数。

--revert-anon-umask
将值设置为 --anon-umask 的系统默认值。
--ascii-mode {off | upload | download | both}
启用 ASCII 下载、上载或两者。
--revert-ascii-mode
将值设置为 --ascii-mode 的系统默认值。
--chroot-exception-list< 字符串 >
显示本地用户 chroot 例外的列表。
--clear-chroot-exception-list
清除本地用户 chroot 例外的列表。
--add-chroot-exception-list< 字符串 >
将用户添加到 chroot 例外列表。
--remove-chroot-exception-list< 字符串 >
从 chroot 例外列表中删除用户。
--revert-chroot-exception-list
将值设置为 --chroot-exception-list 的系统默认值。
--chroot-local-mode {all | none | all-with-exceptions | none-with-exceptions}
指定将哪些登录后的用户放入其主目录的 chroot 监狱中。
--revert-chroot-local-mode
将值设置为 --chroot-local-mode 的系统默认值。
--connect-timeout< 持续时间 >
指定远程客户端响应 PORT 样式数据连接的超时(以秒为单位)。有效持续时间为 30 到 600 之间的整
数。默认值为 60(一分钟)。
--revert-connect-timeout
将值设置为 --connect-timeout 的系统默认值。
--data-timeout< 持续时间 >
指定在删除远程客户端之前允许没有进展的数据传输延迟的最长时间(以秒为单位)。有效持续时间为
30 到 600 之间的整数。默认值为 300(五分钟)。
--revert-data-timeout
将值设置为 --data-timeout 的系统默认值。
--denied-user-list< 字符串 >
显示被拒用户的列表。
--clear-denied-user-list
清除被拒用户的列表。
--add-denied-user-list< 字符串 >

OneFS isi 命令 D 至 L 271


将用户添加到被拒绝用户的列表。
--remove-denied-user-list< 字符串 >
从拒绝用户列表中删除用户。
--revert-denied-user-list
将值设置为 --denied-user-list 的系统默认值(空)。
--dirlist-localtime {yes | no}
指定目录列表中显示的时间是否在您的本地时区内。有效值为 Yes 和 No。如果 No,将显示 GMT 时
间。如果 Yes,则以您的本地时区显示时间。默认值为 No。
由 FTP Shell 内发出的命令返回的上次修改时间也受此参数影响。
--revert-dirlist-localtime
将值设置为 --dirlist-localtime 的系统默认值。
--dirlist-names {numeric | textual | hide}
确定显示有关目录列表中的用户和组的哪些信息。以下是有效项:

numeric 目录列表的用户和组字段中显示数字 ID。


textual 目录列表的用户和组字段中以文本格式显示名称。
hide 目录列表中的所有用户和组信息均显示为 ftp。这是默认设置。

--revert-dirlist-names
将值设置为 --dirlist-names 的系统默认值。
--file-create-perm< 八进制整数 >
指定用于创建已加载文件的权限。有效值为以八进制表示的权限数字。默认值为 0666。
注: 要让上载的文件成为可执行文件,请将权限设置为 0777。

--revert-file-create-perm
将值设置为 --file-create-perm 的系统默认值。
--limit-anon-passwords {yes | no}
限制匿名密码。
--revert-limit-anon-passwords
将值设置为 --limit-anon-passwords 的系统默认值。
--local-root-path< 路径 >
在 /ifs 中指定本地登录的初始目录。有效路径在 /ifs 中。默认路径是本地用户主目录。
--revert-local-root-path
将值设置为 --local-root-path 的系统默认值。
--local-umask< 八进制整数 >
指定由本地用户创建的文件的取消掩蔽。有效值为以八进制表示的取消掩蔽数字。默认值为 077。
注: 该值必须包含 0 前缀;否则将解释为以 10 为底的整数。

--revert-local-umask
将值设置为 --local-umask 的系统默认值。
--server-to-server {yes | no}
指定是否允许服务器到服务器 (FXP) 传输。有效值为 Yes 和 No。默认值为 No。
--revert-server-to-server
将值设置为 --server-to-server 的系统默认值。
--session-support {yes | no}
启用或禁用 FTP 会话支持 如果设置为 YES,该命令将通过可插拔身份认证模块 (PAM) 维护每个用户的
登录会话。如果设置为 NO,该命令将阻止自动创建主目录(如果该功能已通过其他方式可用)。默认值
为 YES。
--revert-session-support
将值设置为 --session-support 的系统默认值。
--session-timeout< 持续时间 >

272 OneFS isi 命令 D 至 L


指定在踢开远程客户端之前该远程客户端在两个 FTP 命令之间可以使用的最长时间(以秒为单位)。有
效值为 30 到 600 之间的整数。默认值为 300(五分钟)。
--revert-session-timeout
将值设置为 --session-timeout 的系统默认值。
--user-config-dir< 路径 >
指定可在其中找到覆盖全局配置的用户特定配置的目录。默认值为本地用户主目录。
--revert-user-config-dir
将值设置为 --user-config-dir 的系统默认值。
--service {yes | no}
指定是否启用 FTP 服务。

isi ftp settings view


显示群集的 FTP 设置。

语法
isi ftp settings view

选项
此命令没有选项。

示例
下面是使用此命令生成的输出示例:

Accept Timeout: 1m
Allow Anon Access: No
Allow Anon Upload: Yes
Allow Dirlists: Yes
Allow Downloads: Yes
Allow Local Access: Yes
Allow Writes: Yes
Always Chdir Homedir: Yes
Anon Chown Username: root
Anon Password List: -
Anon Root Path: /ifs/home/ftp
Anon Umask: 0077
Ascii Mode: off
Chroot Exception List: -
Chroot Local Mode: none
Connect Timeout: 1m
Data Timeout: 5m
Denied User List: -
Dirlist Localtime: No
Dirlist Names: hide
File Create Perm: 0666
Limit Anon Passwords: Yes
Local Root Path: -
Local Umask: 0077
Server To Server: No
Session Support: Yes
Session Timeout: 5m
User Config Dir: -
FTP Service Enabled: No

OneFS isi 命令 D 至 L 273


isi_gather_info
收集最新群集日志信息并将其上载到 EMC Secure Remote Services (ESRS)。
允许存在 -i、-f、-s、-S 和 -1 的多个实例。
gather_expr 和 analysis_expr 可以引用。
默认临时目录是 /ifs/data/Isilon_Support/(使用 -L 或 -T 进行更改)。

语法

isi_gather_info
[-h]
[-v]
[-u <user>]
[-p <password>]
[-i]
[--incremental]
[-l]
[-f <filename>]
[-n <nodes>]
[--local-only]
[--skip-node-check]
[-s gather-script]
[-S gather-expr]
[-1 gather-expr]
[-a analysis-script]
[-A analysis-expr]
[-t <tarfile>]
[-x exclude_tool]
[-I]
[-L]
[-T <temp-dir>]
[--tardir <dir>]
[--symlinkdir <dir>]
[--varlog_recent]
[--varlog_all]
[--nologs]
[--group <name>]
[--clean-cores]
[--clean-all]
[--no-dumps]
[--dumps]
[--no-cores]
[--cores]
[--upgrade-archive]
[--debug]
[--verbose]
[--noconfig]
[--save-only]
[--save]
[--upload]
[--noupload]
[--re-upload <filename>]
[--verify-upload]
[--http]
[--nohttp]
[--http-host <host>]
[--http-path <dir>]
[--http-proxy <host>]
[--http-proxy-port <port>]
[--ftp]
[--noftp]
[--ftp-user <user>]
[--ftp-pass <password>]
[--ftp-host <host>]
[--ftp-path <dir>]
[--ftp-port <alt-port>]

274 OneFS isi 命令 D 至 L


[--ftp-proxy <host>]
[--ftp-proxy-port <port>]
[--ftp-mode <mode>]
[--esrs]
[--email]
[--noemail]
[--email-addresses]
[--email-from]
[--email-subject]
[--email-body]
[--skip-size-check]

选项
-h
打印此消息并退出。
-v
打印版本信息并退出。
-u < 用户 >
将登录名指定为 < 用户 >(而不是默认的 root 用户)。
-p < 密码 >
使用 < 密码 >。
-i
仅包含列出的应用工具。有关要包含的应用工具的列表,另请参见 -l 选项。特殊值 all 可以用于包含
每个已知应用工具。
--incremental
仅收集自上次日志上载以来更改的日志。
-l
列出可以包含的应用工具和组。请参见 -i 和 --group。
-f < 文件名 >
从每个节点收集 < 文件名 >。此值必须为绝对路径。
-n < 节点 >
仅从指定节点收集信息。节点必须是 LNN 的列表或范围,例如 1,4-10,12,14。如果未不指定任何节
点,则使用整个阵列。请注意,如果节点断开,则会自动排除它们。
--local-only
仅从本地节点收集信息。在从 /ifs 文件系统收集文件时运行此选项。
--skip-node-check
跳过节点可用性检查。
-s gather-script
对每个节点运行 < 收集脚本 >。
-S gather-expr
对每个节点运行 < 收集表达式 >。
-1 gather-expr
对本地节点运行 < 收集表达式 >。
-a analysis-script
对结果运行 < 分析脚本 >。
-A analysis-expr
对每个节点运行 < 分析表达式 >。

OneFS isi 命令 D 至 L 275


-t <tar 文件 >
将所有结果保存到指定 <tar 文件 > 而不是默认 tar 文件。
-x exclude_tool
从每个节点的收集中排除指定工具。多个工具可以列为逗号分隔值。
-I
将结果保存到 /ifs。这是默认设置。
-L
将所有结果保存到本地存储 /var/crash/support/。
-T < 临时目录 >
将所有结果保存到 < 临时目录 > 而不是默认目录。 -T 覆盖 -L 和 -l。
--tardir < 目录 >
将最终程序包直接置于指定目录中。
--symlinkdir < 目录 >
创建指向指定目录中的最终程序包的符号链接。
--varlog_recent
在 /var/log 中收集所有日志(压缩和循环的旧日志除外)。默认设置为所有日志。
--varlog_all
在 /var/log 中收集所有日志(包括压缩和循环的旧日志)。这是默认设置。
--nologs
不收集所需最小数量的日志。
--group < 名称 >
将一组特定应用工具添加到 tar 文件。
--clean-cores
成功压缩程序后后从 /var/crash 中删除核心。
--clean-dumps
成功压缩程序后后从 /var/crash 中删除转储。
--clean-all
成功压缩程序后后从 /var/crash 中删除核心和转储。
--no-dumps
不会收集程序包的挂起转储。
--dumps
将核心添加到程序包。
--no-cores
不会收集程序包的核心。
--cores
将转储添加到程序包。
--upgrade-archive
将升级归档添加到程序包。
--debug
显示调试消息。
--verbose
显示更多详细信息。
--noconfig
使用内置默认值并绕过配置文件。
--save-only

276 OneFS isi 命令 D 至 L


将 CLI 指定的配置保存到文件并退出。
--save
将 CLI 指定的配置保存到文件并运行。
--upload
自动将日志上载到 Isilon 技术支持。这是默认设置。
--noupload
指定不自动上载到 Isilon 技术支持。
--re-upload < 文件名 >
重新上载指定的 < 文件名 >。
--verify-upload
创建 tar 文件,上载到测试连接,并验证上载的 tar 文件的大小是否与本地 tar 文件相同。此过程包括完
整日志收集。要验证连接,而不执行完整日志收集,请使用 --nologs 选项。
--http
尝试 HTTP 上载。这是默认设置。
--nohttp
指定不尝试 HTTP 上载。
--http-host < 主机 >
指定备用 HTTP 站点进行上载。
--http-path < 目录 >
指定备用 HTTP 上载目录。
--http-proxy < 主机 >
指定要使用的代理服务器。
--http-proxy-port < 端口 >
指定要使用的代理端口。
--ftp
尝试 FTP 上载。此设置是默认值。
--noftp
指定不尝试 FTP 上载。
--ftp-user < 用户 >
指定 FTP 的备用用户(默认值:anonymous)。
--ftp-pass < 密码 >
指定 FTP 的备用密码。
--ftp-host < 主机 >
指定备用 FTP 站点进行上载。
--ftp-path DIR
指定备用 FTP 上载目录。
--ftp-port < 备用端口 >
指定备用 FTP 端口进行上载。
--ftp-proxy < 主机 >
指定要使用的代理服务器。
--ftp-proxy-port < 端口 >
指定要使用的代理端口。
--ftp-mode < 模式 >

OneFS isi 命令 D 至 L 277


指定 FTP 文件传输的模式。以下值有效:both、active、passive。默认值为 both。
--esrs
尝试 ESRS 上载。
--email
尝试 SMTP 上载。如果设置,则首先尝试 SMTP。
--noemail
指定不尝试 SMTP 上载。这是默认值。
--email-addresses
以逗号分隔字符串形式指定电子邮件地址。
--email-from
指定发件人的电子邮件地址。
--email-subject
指定备用电子邮件主题。
--email-body
指定在正文头中显示的备用电子邮件文本。
--skip-size-check
不检查收集的文件的大小。

isi get
显示有关一组文件的信息,包括请求的保护、当前实际保护以及是否启用写合并。
请求的保护以三种颜色之一显示:绿色、黄色或红色。绿色指示完整保护。黄色指示镜像策略下的降级保护。红色指示奇偶校验
策略下丢失一个或多个数据库。

语法

isi get {{[-a] [-d] [-g] [-s] [{-D | -DD | -DDC}] [-R] <path>}
| {[-g] [-s] [{-D | -DDO | -DDC}] [-R] -L <lin>}}

选项
-a
显示每个目录的隐藏“.”和“..”条目。
-d
显示目录的属性而不是内容。
-g
显示详细信息,包括快照治理列表。
-s
使用词语而不是颜色显示保护状态。
-D
显示更多详细信息。
-DDO
包含有关保护组以及安全描述符所有者和组的信息。
-DDC

278 OneFS isi 命令 D 至 L


包含循环冗余检验 (CRC) 信息。
-R
显示有关指定目录的子目录和文件的信息。
<路径>
显示有关指定文件或目录的信息。
指定为文件或目录路径。
-L <LIN>
显示有关指定文件或目录的信息。
指定为文件或目录 LIN。

示例
以下命令显示有关 ifs/home/ 及其所有子目录的信息:

isi get -R /ifs/home

系统将显示与以下示例类似的输出:

POLICY LEVEL PERFORMANCE COAL FILE


default 4x/2 concurrency on ./
default 8x/3 concurrency on ../
default 4x/2 concurrency on admin/
default 4x/2 concurrency on ftp/

/ifs/home/admin:
default 4+2/2 concurrency on .zshrc

/ifs/home/ftp:
default 4x/2 concurrency on incoming/
default 4x/2 concurrency on pub/

/ifs/home/ftp/incoming:

/ifs/home/ftp/pub:

isi hardening apply


对群集应用安全强化。

语法
isi hardening apply <profile>
[--report {yes | no}]
[--verbose]

选项
< 配置文件 >
指定对 Isilon 群集应用的强化配置文件。目前,OneFS 仅支持使用 DISA(国防信息系统局)STIG(安全
技术实施指南)配置文件来进行群集上的安全强化。
--report {yes | no}
指定是否检查 Isilon 群集的状态,并且在不实际应用强化配置文件的情况下报告结果。系统将显示任何发
现的问题,这些问题可通过强化引擎来解决,或推迟以手动修复。
{--verbose | -v}

OneFS isi 命令 D 至 L 279


显示更多详细信息。

isi hardening revert


恢复所有已对群集应用的安全强化。

语法
isi hardening revert
[--verbose]
[--force]

选项
{--verbose | -v}
显示更多详细信息。
{--force | -f}
禁止命令行提示和消息以恢复强化。

isi hardening status


针对群集及每个群集节点显示安全强化状态,并且指明对群集应用的强化配置文件。

语法
isi hardening status

选项
此命令没有选项。

isi hdfs crypto encryption-zones create


为透明数据加密创建并命名 HDFS 加密分区。

语法
isi hdfs crypto encryption-zones create <path><keyname>

选项
<path> <keyname>
指定加密分区的目录和密钥名称。
加密分区必须位于该分区的 HDFS 根目录内的某个位置。

280 OneFS isi 命令 D 至 L


isi hdfs crypto settings modify
配置 HDFS 以进行透明数据加密。

语法
isi hdfs crypto settings modify
[--kms-url <string>]

选项
--kms-url < 字符串 >
指定密钥管理服务器的 URL。

isi hdfs crypto encryption-zones list


列出 HDFS 加密区域。

语法
isi hdfs crypto encryption-zones list

选项

此命令没有选项。

isi hdfs crypto settings view


查看 HDFS 透明数据加密的设置。

语法
isi hdfs crypto settings view

选项

此命令没有选项。

OneFS isi 命令 D 至 L 281


isi hdfs fsimage job settings modify
更改连续 FSImages 之间的间隔。

语法
isi hdfs fsimage job settings modify
[--generation-interval <string>]
[--help <string>]
[--verbose | -v]
[--zone <string>]

选项
--generation-interval <string>
连续 FSImages 之间的间隔。
--help <string>
显示此命令的帮助。
--verbose | -v
显示更多详细信息。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs fsimage job settings view


查看 FSImage 作业的频率。

语法
isi hdfs fsimage job settings view
[--help <string>]
[--zone <string>]

选项
--help <string>
显示此命令的帮助。
--zone <string>
要应用 HDFS 设置的访问分区。

282 OneFS isi 命令 D 至 L


isi hdfs fsimage job view
查看 FSImage 作业的状态。

语法
isi hdfs fsimage job view
[--help <string>]
[--zone <string>]

选项
--help <string>
显示此命令的帮助。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs fsimage latest delete


删除最新的 FSImage。

语法
isi hdfs fsimage latest delete
[--force | -f]
[--verbose | -v]
[--zone <string>]

选项
--force | -f
不提示确认。
--verbose | -v
显示更多详细信息。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs fsimage latest view


查看最新的 FSImage。

语法
isi hdfs fsimage latest view
[--help <string>]
[--zone <string>]

OneFS isi 命令 D 至 L 283


选项
--help <string>
显示此命令的帮助。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs fsimage settings modify


在 HDFS 访问分区上启用 FSImage。

语法
isi hdfs fsimage settings modify
[--enabled {yes | no}]
[--help <string>]
[--verbose | -v]
[--zone <string>]

选项
--enabled {yes | no}
启用或禁用 HDFS FSImage 服务。允许访问 FSImage 并启动 FSImage 生成。默认情况下,HDFS
FSImage 服务处于禁用状态。仅应在将使用 Cloudera Navigator 的支持 Hadoop 的访问分区上启用此服
务。
--help <string>
显示此命令的帮助。
--verbose | -v
显示更多详细信息。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs fsimage settings view


检查 FSImage 的状态。

语法
isi hdfs fsimage settings view
[--help <string>]
[--zone <string>]

选项
--help <string>
显示此命令的帮助。
--zone <string>
要应用 HDFS 设置的访问分区。

284 OneFS isi 命令 D 至 L


isi hdfs inotify settings modify
在 HDFS 访问分区上启用 INotify。

语法
isi hdfs inotify settings modify
[--enabled {yes | no}]
[--help <string>]
[--maximum-delay <string>]
[--retention <string>]
[--verbose | -v]
[--zone <string>]

选项
--enabled {yes | no}
允许访问 FSImage 并启动 FSImage 生成。默认情况下,HDFS FSImage 服务处于禁用状态。仅应在将使
用 Cloudera Navigator 的支持 Hadoop 的访问分区上启用此服务。
--help <string>
显示此命令的帮助。
--maximum-delay <string>
在 INotify 中报告编辑事件前的最长持续时间。
--retention <string>
将保留最短持续时间编辑。
--verbose | -v
显示更多详细信息。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs inotify settings view


查看 INotify 流的配置。

语法
isi hdfs inotify settings view
[--help <string>]
[--zone <string>]

选项
--help <string>
显示此命令的帮助。
--zone <string>
要应用 HDFS 设置的访问分区。

OneFS isi 命令 D 至 L 285


isi hdfs inotify stream reset
通过删除收集的事件重置 INotify 流。

语法
isi hdfs inotify stream reset
[--force | -f]
[--verbose | -v]
[--zone <string>]

选项
--force | -f
不提示确认。
--verbose | -v
显示更多详细信息。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs inotify stream view


查看 INotify 流。

语法
isi hdfs inotify stream view
[--help <string>]
[--zone <string>]

选项
--help <string>
显示此命令的帮助。
--zone <string>
要应用 HDFS 设置的访问分区。

isi hdfs log-level modify


修改节点上 HDFS 服务的日志级别。

语法
isi hdfs log-level modify
[--set {always|error|warning|info|verbose|debug|trace|default}]
[--verbose|-v]

286 OneFS isi 命令 D 至 L


选项
--set {always | error | warning | info | verbose | debug | trace | default}
设置群集中 HDFS 服务的默认日志记录级别。默认值为 default。
--verbose | -v
显示更多详细信息。

isi hdfs log-level view


显示节点上 HDFS 服务的当前日志级别。

语法
isi hdfs log-level view

选项
此命令没有选项。

isi hdfs proxyusers create


创建可安全模拟其他用户或组的代理用户。

语法
isi hdfs proxyusers create <proxyuser-name>
[--add-gid <group-identifier>...]
[--add-group <group-name>...]
[--add-sid <security-identifier>...]
[--add-uid <user-identifier>...]
[--add-user <user-name>...]
[--add-wellknown <well-known-name>...]
[--verbose | -v]
[--zone <zone-name>]

选项
< 代理用户名称 >
指定群集上当前配置的、要作为代理用户的用户的用户名。
--add-gid < 组标识符 >...
将 UNIX GID 指定的组添加到代理用户成员列表。代理用户可以模拟组中的任何用户。组中的用户必须通
过与代理用户相同的访问分区进行身份认证。您可以在逗号分隔列表中指定多个 UNIX GID。
--add-group < 组名称 >...
将名称指定的组添加到代理用户成员列表。代理用户可以模拟组中的任何用户。组中的用户必须通过与
代理用户相同的访问分区进行身份认证。您可以在逗号分隔列表中指定多个组名称。
--add-sid < 安全标识符 >...
将 Windows SID 指定的用户、用户组、计算机或帐户添加到代理用户成员列表。对象必须通过与代理用
户相同的访问分区进行身份认证。您可以在逗号分隔列表中指定多个 Windows SID。
--add-uid < 用户标识符 >...

OneFS isi 命令 D 至 L 287


将 UNIX UID 指定的用户添加到代理用户可模拟的成员列表。用户必须通过与代理用户相同的访问分区进
行身份认证。您可以在逗号分隔列表中指定多个 UNIX UID。
--add-user < 用户名 >...
将名称指定的用户添加到代理用户可模拟的成员列表。用户必须通过与代理用户相同的访问分区进行身
份认证。您可以在逗号分隔列表中指定多个用户名。
--add-wellknown < 已知名称 >...
将名称指定的已知用户添加到代理用户可模拟的成员列表。已知用户必须通过与代理用户相同的访问分
区进行身份认证。您可以在逗号分隔列表中指定多个已知用户名。
--verbose | -v
显示更多详细信息。
--zone < 分区名称 >
指定用户身份认证所使用的访问分区。

示例
以下命令将指定 zone1 中的 hadoop-user23 作为新代理用户:

isi hdfs proxyusers create hadoop-user23 --zone=zone1

以下命令将指定 zone1 中的 hadoop-user23 作为新代理用户,并且将用户组 hadoop-users 添加到代理用户可模拟的成员列表:

isi hdfs proxyusers create hadoop-user23 --zone=zone1 \


--add-group=hadoop-users

以下命令将指定 zone1 中的 hadoop-user23 作为新代理用户,并且将 UID 2155 添加到代理用户可模拟的成员列表:

isi hdfs proxyusers create hadoop-user23 --zone=zone1 --add-UID=2155

isi hdfs proxyusers delete


删除代理用户。

语法
isi hdfs proxyusers delete <proxyuser-name>
[--force | -f]
[--verbose | -v]
[--zone <zone-name>]

选项
< 代理用户名称 >
指定要删除的代理用户的用户名。
--force | -f
删除指定的代理用户,不请求确认。
--verbose | -v
显示更多详细信息。
--zone < 分区名称 >
指定代理用户身份认证所使用的访问分区。

288 OneFS isi 命令 D 至 L


示例
以下命令将从代理用户列表中删除 zone1 中的 hadoop-user23:

isi hdfs proxyusers delete hadoop-user23 --zone=zone1

isi hdfs proxyusers list


显示访问分区中配置的所有代理用户。

语法
isi hdfs proxyusers list
[--format {table | json | csv | list}]
[--no-footer ]
[--no-header ]
[--verbose | -v]
[--zone <zone-name>]

选项
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
--no-footer
显示不带页脚的表输出。
--no-header
显示不带页眉的表和 CSV 输出。
--verbose | -v
显示更多详细信息。
--zone < 分区名称 >
指定访问分区的名称。

示例
以下命令显示 zone1 中配置的所有代理用户的列表:

isi hdfs proxyusers list --zone=zone1

系统将显示与以下示例类似的输出:

Name
-------------
hadoop-user23
hadoop-user25
hadoop-user28
-------------
Total: 3

OneFS isi 命令 D 至 L 289


isi hdfs proxyusers members list
显示代理用户可模拟的成员用户和用户组。

语法
isi hdfs proxyusers members list <proxyuser-name>
[--format {table | json | csv | list}]
[--no-footer]
[--no-header]
[--verbose | -v]
[--zone <zone-name>]

选项
< 代理用户名称 >
指定代理用户的名称。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
--no-footer
显示不带页脚的表输出。
--no-header
显示不带页眉的表和 CSV 输出。
--verbose | -v
显示更多详细信息。
--zone < 分区名称 >
指定代理用户身份认证所使用的访问分区。

示例
以下命令显示 zone1 中代理用户 hadoop-user23 的成员用户和用户组的详细列表。

isi hdfs proxyusers members list hadoop-user23 --zone=zone1 -v

系统将显示与以下示例类似的输出:

Type: user
Name: krb_user_005
ID: UID:1004
--------------------------------------------------------------------------------
Type: group
Name: krb_users
ID: SID:S-1-22-2-1003
--------------------------------------------------------------------------------
Type: wellknown
Name: LOCAL
ID: SID:S-1-2-0

290 OneFS isi 命令 D 至 L


isi hdfs proxyusers modify
修改可安全模拟其他用户或组的代理用户。

语法
isi hdfs proxyusers modify <proxyuser-name>

[--add-group <group-name>...]
[--add-gid <group-identifier>...]
[--add-user <user-name>...]
[--add-uid <user-identifier>...]
[--add-sid <security-identifier>...]
[--add-wellknown <well-known-name>...]
[--remove-group <group-name>...]
[--remove-gid <group-identifier>...]
[--remove-user <user-name>...]
[--remove-uid <user-identifier>...]
[--remove-sid <security-identifier>...]
[--remove-wellknown <well-known-name>...]
[--verbose | -v]
[--zone <zone-name>]

选项
< 代理用户名称 >
指定要修改的代理用户的用户名。
--add-group < 组名称 >...
将名称指定的组添加到代理用户成员列表。代理用户可以模拟组中的任何用户。组中的用户必须通过与
代理用户相同的访问分区进行身份认证。您可以在逗号分隔列表中指定多个组名称。
--add-gid < 组标识符 >...
将 UNIX GID 指定的组添加到代理用户成员列表。代理用户可以模拟组中的任何用户。组中的用户必须通
过与代理用户相同的访问分区进行身份认证。您可以在逗号分隔列表中指定多个 UNIX GID。
--add-user < 用户名 >...
将名称指定的用户添加到代理用户可模拟的成员列表。用户必须通过与代理用户相同的访问分区进行身
份认证。您可以在逗号分隔列表中指定多个用户名。
--add-uid < 用户标识符 >...
将 UNIX UID 指定的用户添加到代理用户可模拟的成员列表。用户必须通过与代理用户相同的访问分区进
行身份认证。您可以在逗号分隔列表中指定多个 UNIX UID。
--add-sid < 安全标识符 >...
将 Windows SID 指定的用户、用户组、计算机或帐户添加到代理用户成员列表。对象必须通过与代理用
户相同的访问分区进行身份认证。您可以在逗号分隔列表中指定多个 Windows SID。
--add-wellknown < 已知名称 >...
将名称指定的已知用户添加到代理用户可模拟的成员列表。已知用户必须通过与代理用户相同的访问分
区进行身份认证。您可以在逗号分隔列表中指定多个已知用户名。
--remove-group < 组名称 >...
从代理用户成员列表中删除名称指定的组,让代理用户不再能模拟该组中的任何用户。您可以在逗号分
隔列表中指定多个组名称。
--remove-gid < 组标识符 >...
从代理用户成员列表中删除 UNIX GID 指定的组,让代理用户不再能模拟该组中的任何用户。您可以在逗
号分隔列表中指定多个 UNIX GID。
--remove-user < 用户名 >...
从代理用户可模拟的成员列表中删除名称指定的用户。您可以在逗号分隔列表中指定多个用户名。
--remove-uid < 用户标识符 >...

OneFS isi 命令 D 至 L 291


从代理用户可模拟的成员列表中删除 UNIX UID 指定的用户。您可以在逗号分隔列表中指定多个 UNIX
UID。
--remove-sid < 安全标识符 >...
从代理用户可模拟的成员列表中删除 Windows SID 指定的用户、用户组、计算机或帐户。您可以在逗号
分隔列表中指定多个 Windows SID。
--remove-wellknown < 已知名称 >...
从代理用户可模拟的成员列表中删除名称指定的已知用户。您可以在逗号分隔列表中指定多个已知用户
名。
--verbose | -v
显示更多详细信息。
--zone < 分区名称 >
指定代理用户身份认证所使用的访问分区。

示例
以下命令将已知本地用户添加到 zone1 中代理用户 hadoop-user23 的成员列表,并且从中删除 UID 为 2155 的用户:

isi hdfs proxyusers modify hadoop-user23 --zone=zone1 \


--add-wellknown=local --remove-uid=2155

isi hdfs proxyusers view


显示特定代理用户的配置详细信息。

语法
isi hdfs proxyusers view <proxyuser-name>
[--zone <zone-name>]

选项
< 代理用户名称 >
指定代理用户的用户名。
--zone< 分区名称 >
指定代理用户身份认证所使用的访问分区。

示例
以下命令将显示 zone1 中代理用户 hadoop-user23 的配置详细信息:

isi hdfs proxyusers view hadoop-user23 --zone=zone1

系统将显示与以下示例类似的输出:

名称: hadoop-user23
Members: krb_users
LOCAL
krb_user_004

292 OneFS isi 命令 D 至 L


isi hdfs racks create
创建新的虚拟 HDFS 机架。

语法
isi hdfs racks create <rack-name>
[--client-ip-ranges <low-ip-address>-<high-ip-address>]...
[--ip-pools <subnet>:<pool>]...
[--verbose | -v]
[--zone <string>]

选项
< 机架名称 >
指定虚拟 HDFS 机架的名称。机架名称以正斜线开头,例如 /example-name。
--client-ip-ranges < 低 IP 地址 >-< 高 IP 地址 >...
指定分配给虚拟机架的外部 Hadoop 计算客户端的 IP 地址范围。
--ip-pools < 子网 >:< 池 >...
为虚拟机架分配 OneFS 群集 IP 地址池。
--verbose | -v
显示更多详细信息。
--zone <string>
指定将包含虚拟机架的访问分区。

isi hdfs racks delete


删除虚拟 HDFS 机架。

语法
isi hdfs racks delete <rack-name>
[--force | -f]
[--verbose | -v]
[--zone <string>]

选项
< 机架名称 >
删除指定的虚拟 HDFS 机架。每个机架名称以正斜线开头,例如 /example-name。
--force | -f
禁止显示命令行提示符和消息。
--verbose | -v
显示更多详细信息。
--zone <string>
指定包含要删除的虚拟机架的访问分区。

OneFS isi 命令 D 至 L 293


isi hdfs racks list
列出访问分区中的 HDFS 机架。

语法

isi hdfs racks list


[--format {table | json | csv | list}]
[--no-footer]
[--no-header]
[--verbose]
[--zone <string>]

选项
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示 HDFS 机架。
--no-footer | -z
不显示表格摘要页脚信息。
--no-header | -a
不会以 CSV 或表格输出格式显示标头。
--verbose | -v
显示更多详细信息。
--zone <string>
指定访问分区。系统将显示指定分区中的所有虚拟机架。

isi hdfs racks modify


修改虚拟 HDFS 机架。

语法
isi hdfs racks modify <rack-name>
[--add-client-ip-ranges <low-ip-address>-<high-ip-address>]...
[--add-ip-pools <subnet>:<pool>]...
[--clear-client-ip-ranges]
[--clear-ip-pools]
[--client-ip-ranges <low-ip-address>-<high-ip-address>]...
[--ip-pools <subnet>:<pool>]...
[--name <rack-name>]
[--remove-client-ip-ranges <low-ip-address>-<high-ip-address>]...
[--remove-ip-pools <subnet>:<pool>]...
[--verbose | -v]
[--zone <string>]

选项
< 机架名称 >
指定要修改的虚拟 HDFS 机架。每个机架名称以正斜线开头,例如 /example-name。
--add-client-ip-ranges < 低 IP 地址 >-< 高 IP 地址 >...
将外部 Hadoop 计算客户端的指定 IP 地址范围添加到虚拟机架。

294 OneFS isi 命令 D 至 L


--add-ip-pools < 子网 >:< 池 >...
将指定的 OneFS 群集 IP 地址池添加到虚拟机架。
--clear-client-ip-ranges
从虚拟机架中删除外部 Hadoop 计算客户端的所有 IP 地址范围。
--clear-ip-pools
从虚拟机架中删除所有 OneFS 群集 IP 地址池。
--client-ip-ranges < 低 IP 地址 >-< 高 IP 地址 >...
指定分配给虚拟机架的外部 Hadoop 计算客户端的 IP 地址范围。通过此选项指定的值将覆盖所有现有 IP
地址范围。可以通过 --add-client-ip-ranges 选项添加新范围。
--ip-pools < 子网 >:< 池 >...
为虚拟机架分配 OneFS 节点 IP 地址池。通过此选项指定的值将覆盖所有现有 IP 地址池。可以通过 --
add-ip-pools 选项添加新池。
--name < 机架名称 >
向指定虚拟机架分配新名称。机架名称必须以正斜线开头,例如 /example-name。
--remove-client-ip-ranges < 低 IP 地址 >-< 高 IP 地址 >...
从虚拟机架中删除外部 Hadoop 计算客户端的指定 IP 地址范围。只能删除整个范围;不能删除范围的子
集。
--remove-ip-pools < 子网 >:< 池 >...
从虚拟机架中删除指定的 OneFS 群集 IP 地址池。
--verbose | -v
显示更多详细信息。
--zone <string>
指定包含要修改的虚拟机架的访问分区。

isi hdfs racks view


显示特定虚拟 HDFS 机架的信息。

语法
isi hdfs racks view < 机架名称 >
[--zone < 字符串 >]

选项
< 机架名称 >
指定要查看的虚拟 HDFS 机架的名称。每个机架名称以正斜线开头,例如 /example-name。
--zone< 字符串 >
指定包含要查看的虚拟机架的访问分区。

isi hdfs ranger-plugin settings modify


修改 HDFS 的 Apache Ranger 插件设置。

语法
isi hdfs ranger-plugin settings modify
[--enabled <boolean>]

OneFS isi 命令 D 至 L 295


[--policy-manager-url <string>]
[--repository-name <string>]
[--verbose | -v]
[--zone <string>]

选项
--enabled <boolean>
启用 HDFS Ranger 插件。
--policy-manager-url <string>
Apache Ranger 服务器的方案、主机名和端口。例如:
http://ranger.com:6080 或:
https://ranger.com/6182
--repository-name <string>
Apache Ranger 服务器上承载的 HDFS 存储库名称。
--verbose | -v
显示更多详细信息。
--zone <string>
包含 HDFS 存储库的访问分区。

isi hdfs ranger-plugin settings view


查看 HDFS 的 Apache Ranger 插件设置。

语法
isi hdfs ranger-plugin settings view
[--zone <string>]

选项
--zone< 字符串 >
包含 HDFS 存储库的访问分区。

isi hdfs settings modify


修改访问分区的 HDFS 设置。

语法
isi hdfs settings modify
[--ambari-metrics-collector <string>]
[--ambari-namenode <string>]
[--ambari-server <string>]
[--authentication-mode {simple_only | kerberos_only}]
[--data-transfer-cipher {none | aes_128_ctr | aes_192_ctr | aes_256_ctr}]
[--default-block-size <size>]
[--default-checksum-type {none | crc32 | crc32c}]
[--hadoop-version-3-or-later {true | false}]
[--hdfs-acl-enabled {true | false}]
[--odp-version <string>]

296 OneFS isi 命令 D 至 L


[--root-directory <path>]
[--service {yes | no}]
[--verbose | -v]
[--webhdfs-enabled {yes | no]
[--zone <string>]

选项
--ambari-metrics-collector <string>
指标收集器的主机名称。此值必须是可解析的主机名、FQDN、IPv4 或 IPv6 地址。
--ambari-namenode <string>
访问分区中的连接点,通过 Ambari 界面管理的 Hadoop 服务应借此来连接。此值必须是可解析的 IPv4
地址或 SmartConnect 分区名称。
--ambari-server <string>
从 Ambari 代理接收通信的 Ambari 服务器。此值必须是可解析的主机名、FQDN、IPv4 或 IPv6 地址。
--authentication-mode {simple_only | kerberos_only}
用于通过指定访问分区的 HDFS 连接的身份验证方法。对于 OneFS 8.2.1 和更高版本,身份验证模式的
默认值是 simple_only。
--data-transfer-cipher {none | aes_128_ctr | aes_192_ctr | aes_256_ctr}
要用于线路加密的高级加密标准 (AES) 密码。
--default-block-size < 大小 >
HDFS 服务报告的数据块大小(以字节为单位)。K、M 和 G;例如 64M、512K、1G 均为有效后缀。默
认值是 128 MB。
--default-checksum-type {none | crc32 | crc32c}
HDFS 服务报告的校验和类型。默认值为 none
--hadoop-version-3-or-later {true | false}
如果使用的是 Hadoop 版本 3 或更高版本,则将 Hadoop 客户端版本设置为 true。
--hdfs-acl-enabled {true | false}
启用或禁用 HDFS ACL。
--odp-version <string>
Ambari 服务器安装的开放数据平台 (ODP) 堆栈存储库的版本,包括内部版本号(如果有)。需要此项才
能在属于 Hadoop 群集的其他系统上支持 ODP 升级。
--root-directory <path>
包含可通过 Hadoop 计算客户端连接访问的访问分区中的 HDFS 数据的根路径。根目录必须在访问分区
基本目录内。
--service {yes | no}
在指定访问分区中启用或禁用 HDFS 服务。HDFS 服务是默认启用的。
--verbose | -v
显示更多详细信息。
--webhdfs-enabled {yes | no}
在指定访问分区中启用或禁用 WebHDFS。默认情况下启用 WebHDFS。
--zone <string>
要应用 HDFS 设置的访问分区。

OneFS isi 命令 D 至 L 297


isi hdfs settings view
显示访问分区中的 HDFS 设置。

语法
isi hdfs settings view
[--zone <string>]

选项
--zone< 字符串 >
指定访问分区。系统将显示指定分区的 HDFS 设置。

isi http settings modify


修改 HTTP 全局设置。

语法
isi http settings modify
[--access control {yes | no}]
[--basic-authentication {yes | no}]
[--dav {yes | no}]
[--enable-access-log {yes | no}]
[--integrated-authentication {yes | no}]
[--server-root < 路径 >]
[--service {enabled | 已禁用 | redirect}]
[--verbose]

选项
--access control {yes | no}
启用访问控制身份认证,从而允许 Apache Web 服务器执行访问权限检查。访问控制身份认证至少需要
启用一种类型的身份认证。
--basic-authentication {yes | no}
启用 HTTP 基本身份认证。以纯文本格式发送用户凭据。
--dav {yes | no}
让多个用户可跨远程 Web 服务器以协作方式管理并修改文件。
注: 所有 DAV 客户端都必须经过单个节点。如果经过 SmartConnect 或者经过两个或多个节点 IP 地
址,则不满足 DAV 法规遵从性。

--enable-access-log {yes | no}


启用访问 HTTP 服务器时写入日志。
--integrated-authentication {yes | no}
通过 NTLM 和/或 Kerberos 启用集成身份认证。
--server-root< 路径 >
指定根文档目录。这必须是 /ifs 内的有效目录路径。
--service {enabled | disabled | redirect}
启用或禁用 HTTP 服务,或重定向到 OneFS Web UI。

298 OneFS isi 命令 D 至 L


{--verbose | -v}
显示更多详细信息。

isi http settings view


显示 HTTP 全局设置。

语法
isi http settings view

选项
此命令没有选项。

示例
以下示例显示此命令生成的输出:

Access Control: No
Basic Authentication: No
Dav: No
Enable Access Log: Yes
Integrated Authentication: No
Server Root: /ifs
Service: redirect

isi ipmi features list


列出可用 IPMI 功能。

语法
isi ipmi features list
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示有关作业事件的详细信息。

OneFS isi 命令 D 至 L 299


isi ipmi features modify
修改 IPMI 功能设置。

语法
isi ipmi features modify feature-ID
[--enabled {yes | no}]
[--force | -f]
[--help | -h ]
[--verbose | -v]

选项
feature-id
标识功能名称的字符串。此字符串与 isi ipmi feature list 输出中使用的名称相匹配。
--enabled {yes | no}
启用或禁用功能。指定 yes 可启用。指定 no 可禁用。
{--force | -f}
运行此命令之前,请勿要求确认。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

isi ipmi features view


查看有关指定功能的信息。

语法
isi ipmi features view feature-ID
[--help | -h ]

选项
feature-id
标识功能名称的字符串。此字符串与 isi ipmi feature list 输出中使用的名称相匹配。
{--help | -h}
显示此命令的帮助。

300 OneFS isi 命令 D 至 L


isi ipmi network modify
修改 IPMI 网络配置。

语法
isi ipmi network modify
[--gateway <ip address> ]
[--prefixlen <prefixlen>]
[--ranges <ip_address_range>]
[--clear-ranges ]
[--add-ranges <ip_address_range>]
[--remove-ranges <ip_address_range>]
[--delete-config]
[--force | -f]
[--help | -h ]
[--verbose | -v]

选项
使用由连字符 (-) 分隔的两个 IP 地址来指定 IP 地址范围。指定地址包含在范围内。例如:

92.168.0.100-192.168.100.100, 10.7.0.0-10.7.255.255

--gateway <IP address>


指定子网网关的 IP 地址。
--prefixlen <prefix length>
指定此子网的前缀长度。
--ranges <IP address range>
池中的 IP 地址范围的列表。为每个额外 IP 地址范围指定 --ranges。
--clear-ranges
清除 IP 地址范围的列表。
--add-ranges <IP address range>
添加到 IP 地址范围的列表。为要添加的每个额外 IP 地址范围指定 --add-ranges。
--remove-ranges <IP address range>
从 IP 地址范围的列表中删除项目。为要删除的每个额外 IP 地址范围指定 --remove-ranges。
--delete-config
删除远程 IPMI 静态网络配置。
{--force | -f}
运行此命令之前,请勿要求确认。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 301


isi ipmi network view
查看网络配置设置。

语法
isi ipmi network view
[--help | -h ]

选项
{--help | -h}
显示此命令的帮助。

isi ipmi nodes list


列出节点配置信息。

语法
isi ipmi nodes list
[--format {table | json | csv | list}]
[{--no-header | -a}]
[{--no-footer | -z}]
[--help | -h ]
[--verbose | -v]

选项
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header}
显示不带页眉的表和 CSV 输出。
{--no-footer}
显示不带页脚的表输出。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示有关活动作业的更多详细信息。

302 OneFS isi 命令 D 至 L


isi ipmi nodes view
查看节点配置信息。

语法
isi ipmi nodes view
[--node-lnn <integer>]
[{--help | -h}]

选项
--node-lnn < 整数 >
指定要查看的节点 LNN。如果未指定 LNN,则会显示本地节点信息。
{--help | -h}
显示此命令的帮助。

isi ipmi settings modify


更改远程 IPMI 管理配置。

语法
isi ipmi settings modify
[--enabled {yes | no}]
[--allocation-type {static | dhcp}]
[--force | -f]
[--help | -h ]
[--verbose | -v]

选项
--enabled {yes | no}
启用或禁用远程 IPMI 管理。启用远程 IPMI 管理时,OneFS 会尝试在 IPMI 支持的节点上启用用于远程
IPMI 命令验证的 BMC 用户帐户。禁用远程 IPMI 管理时,OneFS 会在 IPMI 支持的节点上禁用用于远程
IPMI 命令验证的 BMC 用户帐户。
--allocation-type {static | dhcp}
指定网络分配类型:静态网络配置或 DHCP。如果将 --allocation-type 设置为 DHCP,则群集中
的 BMC LAN 接口会尝试获取 DHCP 地址(如果有)。如果将 --allocation-type 设置为静态,则
每个 BMC LAN 接口都会获取以前使用 isi ipmi network 配置的地址。
{--force | -f}
运行此命令之前,请勿要求确认。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 303


isi ipmi settings view
查看远程 IPMI 管理配置设置。

语法
isi ipmi settings view
[{--help | {-h}]

选项
{--help | -h}
显示此命令的帮助。

isi ipmi user modify


修改指定 IPMI 用户。

语法
isi ipmi user modify
[--username <string>]
[--password <string>]
[--set-password]
[--force | -f]
[--help | -h ]
[--verbose | -v]

选项
--username < 字符串 >
设置远程 IPMI 用户的用户名。
--password < 字符串 >
设置远程 IPMI 用户的密码。密码长度必须为 17-20 个字符。
--set-password
以交互方式指定密码。
{--force | -f}
运行此命令之前,请勿要求确认。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多详细信息。

304 OneFS isi 命令 D 至 L


isi ipmi user view
查看 IPMI 用户帐户用户名。

语法
isi ipmi user view
[{--help | -h}]

选项
{--help | -h}
显示此命令的帮助。

isi 作业事件列表
列出最近的作业事件。

语法

isi job events list


[--job-type <string>]
[--job-id <integer>]
[{--begin} <timestamp>]
[--end <timestamp>]
[--state {failed | running | cancelled_user | succeeded | paused_user | unknown |
paused_priority | cancelled_system | paused_policy | paused_system}]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--job-type< 字符串 >
显示特定作业类型(例如 SmartPools)的所有实例的所有事件。
--job-id< 整数 >
显示特定作业实例的所有事件。
--begin< 时间戳 >
指定应列出作业事件的时间段的开始时间。 例如: --begin "2013-09-17T00:00". 这表示应列出
自 2013 年 9 月 17 日开始的作业事件。
--end< 时间戳 >
指定应列出作业事件的时间段的结束时间。 例如,--end "2013-09-17T23:59" 表示应列出截至
2013 年 9 月 17 日结束的作业事件。
--state {failed | running | cancelled_user | succeeded | paused_user | unknown | paused_priority |
cancelled_system | paused_policy |paused_system}
指定应列出指定状态的事件。
{--limit | -l} < 整数 >

OneFS isi 命令 D 至 L 305


显示不超过指定数量的作业事件。 如果未指定 时间戳 参数,则将列出指定数量的最近作业事件。
--format {table | json | csv | list}
以表(默认值)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示有关作业事件的详细信息。

示例
以下命令列出了 9 月份发生的所有 FSAnalyze 事件:

isi job events list --job-type fsanalyze --begin "2013-09-01" --end "2013-09-30"

系统将显示与以下示例类似的输出:

Time Message
-----------------------------------------------------
2013-09-16T22:00:21 FSAnalyze[7] Waiting
2013-09-16T22:00:23 FSAnalyze[7] Running
2013-09-16T22:00:25 FSAnalyze[7] Phase 1: begin scan
2013-09-16T22:01:45 FSAnalyze[7] Phase 1: end scan
2013-09-16T22:01:46 FSAnalyze[7] Phase 2: begin merge
2013-09-16T22:02:30 FSAnalyze[7] Phase 2: end merge
2013-09-16T22:02:31 FSAnalyze[7] Succeeded
2013-09-17T22:00:05 FSAnalyze[9] Waiting
2013-09-17T22:00:08 FSAnalyze[9] Running
2013-09-17T22:00:11 FSAnalyze[9] Phase 1: begin scan
2013-09-17T22:01:37 FSAnalyze[9] Phase 1: end scan
2013-09-17T22:01:38 FSAnalyze[9] Phase 2: begin merge
2013-09-17T22:02:24 FSAnalyze[9] Phase 2: end merge
2013-09-17T22:02:26 FSAnalyze[9] Succeeded
-----------------------------------------------------
Total: 14

以下命令列出了在特定日期发生的所有作业事件。

isi job events list --begin "2013-09-17T00:00" --end "2013-09-17T23:59"

系统将显示与以下示例类似的输出:

Time Message
------------------------------------------------------------------
2013-09-17T22:00:04 SmartPools[8] Waiting
2013-09-17T22:00:05 FSAnalyze[9] Waiting
2013-09-17T22:00:06 SmartPools[8] Running
2013-09-17T22:00:07 SmartPools[8] Phase 1: begin lin policy update
2013-09-17T22:00:08 FSAnalyze[9] Running
2013-09-17T22:00:11 FSAnalyze[9] Phase 1: begin scan
2013-09-17T22:01:01 SmartPools[8] Phase 1: end lin policy update
2013-09-17T22:01:03 SmartPools[8] Phase 2: begin sin policy update
2013-09-17T22:01:06 SmartPools[8] Phase 2: end sin policy update
2013-09-17T22:01:09 SmartPools[8] Succeeded
2013-09-17T22:01:37 FSAnalyze[9] Phase 1: end scan
2013-09-17T22:01:38 FSAnalyze[9] Phase 2: begin merge
2013-09-17T22:02:24 FSAnalyze[9] Phase 2: end merge
2013-09-17T22:02:26 FSAnalyze[9] Succeeded
------------------------------------------------------------------
Total: 14

306 OneFS isi 命令 D 至 L


isi job jobs cancel
取消活动作业。

语法

isi job jobs cancel <job>

选项
<job>
指定要取消的作业。 您可以按作业 ID 或作业类型指定作业。 仅当某种作业类型只有一个实例处于活动
状态时,才指定该作业类型。

示例
以下命令取消活动 MultiScan 作业。

isi job jobs cancel multiscan

以下命令取消一个实例 ID 为 14 的活动作业。

isi job jobs cancel 14

在包含 isi job jobs 命令的所有指令中,都可以忽略 jobs 条目。

isi job cancel 14

isi job jobs list


显示有关活动作业的信息。

语法

isi job jobs list


[--state {running | paused_user | paused_priority | paused_policy | paused_system}]
[--limit <integer>]
[--sort {id | type | state | impact | policy | priority | start_time | running_time}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--state {running | paused_user | paused_priority | paused_policy | paused_system}
根据状态控制列出的作业。
{--limit | -l} < 整数 >

OneFS isi 命令 D 至 L 307


显示不超过指定的项目数。 如果未指定其他参数,则显示最多为指定数量的最近激活的作业。
--sort {id | type | state | impact | policy | priority | start_time | running_time}
按指定属性对输出排序。
--descending
以激活时间的降序对输出排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header}
显示不带页眉的表和 CSV 输出。
{--no-footer}
显示不带页脚的表输出。
{--verbose}
显示有关活动作业的更多详细信息。

示例
以下示例列出已手动暂停的作业。

isi job jobs list --state paused_user

系统将显示与以下示例类似的输出。

ID Type State Impact Pri Phase Running Time


---------------------------------------------------------------- 12 Collect Paused by
user Low 4 1/2 11s 23 SmartPools Paused by user Low 6 1/8 40s
---------------------------------------------------------------- Total: 2

以下示例将 CSV 格式的作业列表输出到 /ifs/data 路径中的文件。

isi job jobs list --format csv > /ifs/data/joblist.csv

在包含 isi job jobs 命令的所有指令中,都可以忽略 jobs 条目。

isi job list --format csv > /ifs/data/joblist.csv

isi job jobs modify


更改排队、正在运行或暂停的作业的优先级或影响策略。

语法

isi job jobs modify <job>


[--priority <integer>]
[--policy <string>]

选项
<job>
指定要修改的作业 ID 或作业类型。 如果您指定作业类型(例如 FlexProtect),则该类型只能有一个实
例处于活动状态。

308 OneFS isi 命令 D 至 L


{--priority | -p} < 整数 >
为指定作业设置优先级。
{--policy | -o} < 字符串 >
为指定作业设置影响策略。

示例
以下命令更改活动 MultiScan 作业的影响策略。 此命令示例(该示例指定作业类型)仅在 MultiScan 的单个实例处于活动状态时
才有效。

isi job jobs modify multiscan --policy high

如果某种作业类型有多个实例处于活动状态,则可以指定作业 ID 号而不是作业类型。 以下命令更改一个 ID 为 7 的活动作业的


优先级。

isi job jobs modify 7 --priority 2

在包含 isi job jobs 命令的所有指令中,都可以忽略 jobs 条目。

isi job modify 7 --priority 2

isi job jobs pause


暂停活动作业。

语法

isi job jobs pause <job>

选项
<job>
指定要暂停的作业。 您可以按作业类型或作业 ID 指定作业。 如果您使用作业类型,则该作业类型只能
有一个实例处于活动状态。

示例
以下命令暂停活动 AutoBalance 作业。

isi job jobs pause autobalance

以下命令暂停一个 ID 为 18 的活动作业。

isi job jobs pause 18

在包含 isi job jobs 命令的所有指令中,都可以忽略 jobs 条目。

isi job pause 18

要恢复暂停的作业,请使用 isi job resume 命令。

OneFS isi 命令 D 至 L 309


isi job jobs resume
恢复暂停的作业。
您可以使用 isi job jobs list 命令确认作业已恢复。 根据作业引擎队列中的其他活动,作业的实际恢复可能需要一段时
间。

语法

isi job jobs resume <job>

选项
<job>
指定要恢复的作业。 您可以按作业类型或作业 ID 指定作业。 如果您使用作业类型参数,则此作业类型
只能有一个实例处于作业引擎队列中。

示例
以下命令恢复暂停的 AutoBalance 作业。

isi job jobs resume autobalance

以下命令恢复一个 ID 为 16 的暂停作业。

isi job jobs resume 16

在包含 isi job jobs 命令的所有指令中,都可以忽略 jobs 条目。

isi job resume 16

isi job jobs start


启动新作业。
isi job jobs start 命令不控制已在进行的作业。如果某个活动作业已暂停,则您可以使用 isi job jobs resume 命
令从暂停点启动它。

语法

isi job jobs start <type>


[--policy <string>]
[--priority <integer>]
[--no-dup]
[--paths <path>]
[--delete]
[--delete-quotas]
[--root <path>]
[--dm-type {snaprevert | synciq}]
[--mapping-type {clone | sid | unix | native}]
[--mode {clone | inherit | convert}]
[--template <path>]
[--zone <string>]

310 OneFS isi 命令 D 至 L


[--snapid <integer>]
[--verbose]

选项
<type>
指定要添加到作业队列的作业的类型(例如 MediaScan)。
{--priority} < 整数 >
为指定作业设置优先级,其中 1 是最高优先级,10 是最低优先级。
{--policy} < 字符串 >
为指定作业设置影响策略。
{--no-dup}
禁用重复作业。如果指定作业的实例已在队列中,则新作业不会启动。
--paths < 路径 >
指定作业的路径(必须处于 /ifs 中)。此选项仅对 TreeDelete 和 PermissionRepair 作业才有效。
--delete
仅对 DomainMark 作业有效。删除域标记。
--delete-quotas
仅对 TreeDelete 作业有效。自动删除已删除数据集上的配额。
当尝试删除具有配额的目录时,此选项可能会生成以下日志消息。

Attempt to remove directory <lin> with quota domains still defined on


it, operation not permitted.

忽略此日志消息。--delete-quotas 选项首先删除该配额,然后删除该目录。
--root < 路径 >
仅对 DomainMark 作业有效。为 DomainMark 作业指定根路径位置。
--dm-type {snaprevert | synciq}
仅对 DomainMark 作业有效。为 DomainMark 作业指定域类型。
--mapping-type {global | sid | unix | native}
仅对 PermissionRepair 作业有效,并且仅与 --modeconvert 选项一起使用。为 PermissionRepair 指定
类型。
--mode {clone | inherit | convert}
仅对 PermissionRepair 作业有效。为 PermissionRepair 指定模式。
--template < 路径 >
仅对 PermissionRepair 作业有效。为 PermissionRepair 作业指定要用作模型的模板文件的路径名。必须
处于 /ifs 路径中。
--zone < 字符串 >
仅对 PermissionRepair 作业有效。为 PermissionRepair 指定访问分区。
--snapid < 整数 >
仅对 SnapRevert 作业有效。为 SnapRevert 作业指定快照 ID。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 311


示例
以下命令启动 AutoBalance 作业。

isi job jobs start autobalance

以下命令启动具有优先级 8 和高影响策略的 MultiScan 作业。

isi job jobs start multiscan --priority 8 --policy high

以下命令启动具有优先级 10 和低影响策略并删除 /ifs/data/old 目录的 TreeDelete 作业。

isi job jobs start treedelete --path /ifs/data/old --priority 10 --policy low

在包含 isi job jobs 命令的所有指令中,都可以忽略 jobs 条目。

isi job start autobalance

isi job jobs view


显示有关正在运行或排队的作业的信息,包括状态、影响策略、优先级和计划。

语法

isi job jobs view <job>

选项
<job>
指定要查看的作业。 您可以按作业类型或作业 ID 指定作业。 如果您指定作业类型,则此作业只能有一
个实例处于活动状态。

示例
以下命令显示有关作业 ID 为 15 的 AutoBalance 作业的信息。

isi job jobs view 15

系统将显示与以下示例类似的信息。

ID: 15 Type: AutoBalance State: Paused by user Impact: Low Policy: LOW Pri: 4 Phase:
1/5 Start Time: 2013-09-19T09:08:28 Running Time: 24s Participants: 1, 2, 3 Progress: 磁带
机: 6 done, 0 in progress; last updated 3:0; Processed 4624 LINs and 918669 KB; 0 ECCs
and 0 errors Waiting on job ID: - Description:

在包含 isi job jobs 命令的所有指令中,都可以忽略 jobs 条目。

isi job view 15

312 OneFS isi 命令 D 至 L


isi job policies create
创建自定义作业影响策略。
默认情况下,会向新影响策略分配低影响级别。 您可以指定作业可以按较高影响级别运行或可以暂停的多个时间段(间隔)。

语法

isi job policies create <name>


[--description <string>]
[--impact {Low | Medium |High |Paused }]
[--begin <interval_time>]
[--end <interval_time>]

选项
<name>
指定新影响策略的名称。 以下名称保留,无法使用: LOW、MEDIUM、HIGH 和 OFF_HOURS。
--description< 字符串 >
描述作业策略。
--impact {Low | MediumHigh | Paused}
指定策略的影响级别: Low、Medium、High 或 Paused。 您可以为定义的每个影响间隔指定 --
impact 参数。
--begin< 间隔时间 >
按 24 小时制指定作业可以运行的时间段的开始时间。 例如: --begin "Friday 20:00"。
--end< 间隔时间 >
按 24 小时制指定作业可以运行的时间段的结束时间。 例如: --end "Sunday 11:59"。

示例
以下命令创建一个名为 HIGH-WKEND 的新影响策略。

isi job policies create HIGH-WKEND --impact high --begin "Saturday 00:01" --end "Sunday
23:59"

以下命令创建一个名为 HI-MED-WKEND 的更复杂影响策略。 此策略包含多个影响级别和时间间隔。 指定间隔结束时,使用此


策略运行的作业会自动返回 LOW 影响。

isi job policies create HI-MED-WKEND --description "High to medium impact when run on
the weekend" --impact high --begin "Friday 20:00" --end "Monday 03:00" --impact medium --
begin "Monday 03:01" --end "Monday 08:00"

isi job policies delete


删除作业影响策略。
以下策略保留,无法删除: LOW、MEDIUM、HIGH 和 OFF_HOURS。

OneFS isi 命令 D 至 L 313


语法

isi job policies delete <id>


[--force]

选项
<id>
指定要删除的影响策略的名称。 如果您不确定名称,则可以使用 isi job policies list 命令。
--force
在系统不要求确认的情况下强制删除影响策略。

示例
以下命令删除一个名为 HIGH-MED 的自定义影响策略。

isi job policies delete HIGH-MED

按 ENTER 键时,OneFS 会显示确认消息: Are you sure you want to delete the policy HIGH-MED? (yes/
[no]):
键入 yes,然后按 ENTER 键。
以下命令删除一个名为 HIGH-WKEND 的自定义影响策略而不显示确认消息。

isi job policies delete HIGH-WKEND --force

isi job policies list


显示作业影响策略的名称和描述。

语法

isi job policies list


[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}

314 OneFS isi 命令 D 至 L


显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下命令显示可用影响策略的列表。

isi job policies list

系统将显示与以下示例类似的输出:

ID Description ------------------------------------------------------ HIGH Isilon


template: high impact at all times LOW Isilon template: low impact at all times MEDIUM
Isilon template: medium impact at all times OFF_HOURS Isilon template: paused M-F 9-5,
low-impact at other times HI-MED High to medium to low HI-WKEND High impact when run on
weekends MED-WKEND Medium impact when run on weekends
------------------------------------------------------ Total: 7

以下命令显示有关可用策略的更多信息。

isi job policies list --verbose

系统会以列表格式显示详细输出,如以下部分示例所示:

ID: HIGH Description: Isilon template: high impact at all times System: True Impact
Intervals Impact : High Begin : Sunday 00:00 End : Sunday 00:00
---------------------------------------------------------- ID: LOW Description: Isilon
template: low impact at all times System: True Impact Intervals Impact : Low Begin :
Sunday 00:00 End : Sunday 00:00
----------------------------------------------------------

isi job policies modify


更改自定义影响策略的描述、影响级别和时间间隔。
要确认自定义策略可反映您的更改,可以使用 isi job policy view 命令。

语法

isi job policy modify <ID>


[--description<string>
[--impact {Low | Medium | High | Paused}]
[--begin <interval_time>]
[--end <interval_time>]
[--reset_intervals]

选项
<ID>
指定要修改的策略的名称。
--description< 字符串 >
指定策略的描述。 如果有一个较旧描述存在,则替换它。
--impact {Low | MediumHigh | Paused}

OneFS isi 命令 D 至 L 315


指定策略的影响级别: Low、Medium、High 或 Paused。 为定义的每个附加影响间隔指定 --
impact 参数。
--begin< 间隔时间 >
按 24 小时制指定作业可以运行的时间段的开始时间。 例如: --begin "Friday 20:00"。
--end< 间隔时间 >
按 24 小时制指定作业可以运行的时间段的结束时间。 例如: --end "Sunday 11:59"。
--reset-intervals
清除所有作业策略间隔并恢复默认值。

示例
以下命令从一个名为 MY_POLICY 的自定义策略中清除自定义间隔,以此作为添加新间隔的第一个步骤。

isi job policies modify MY_POLICY --reset-intervals

以下命令向自定义策略添加新间隔。

isi job policies modify MY_POLICY --impact high --begin "Friday 20:00" --end "Sunday
11:59"

isi job policies view


显示特定作业引擎作业策略的详细信息。

语法
isi job policies view
[<id> <string>]

选项
<id>< 字符串 >
按策略 ID 指定要显示的作业策略。

示例
以下命令显示默认作业策略 HIGH 的详细信息。

isi job policies view HIGH

系统将显示以下策略详细信息:

ID: HIGH
Description: Isilon template: high impact at all times
System: True
Impact Intervals
Impact : High
Begin : Sunday 00:00
End : Sunday 00:00

316 OneFS isi 命令 D 至 L


isi job reports list
显示有关成功作业操作的信息,包括日期和时间、作业 ID、作业类型和完全完成的作业阶段。

语法

isi job reports list


[--job-type <string>]
[--job-id <integer>]
[{--begin} <timestamp>]
[{--end} <timestamp>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
--job-type< 字符串 >
显示具有指定作业类型的所有实例的报告。
--job-id< 整数 >
显示具有指定作业 ID 的作业的报告。 如果作业具有多个阶段,则作业引擎显示具有指定 ID 的每个阶段
的报告。
{--begin | -b} < 间隔时间 >
指定作业报告列表的时间段的开始。 例如: --begin "2013-09-19"。
{--end | -e} < 间隔时间 >
指定作业报告列表的时间段的结束。 例如: --end "2013-09-20"。
{--limit | -l} < 整数 >
显示不超过指定的报告数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。

示例
以下命令显示指定时间段内所有 MultiScan 作业的报告。

isi job reports list --job-type multiscan --begin "2013-9-19" --end "2013-9-20"

系统将显示与以下示例类似的输出。

Time Job ID Job Type Phase --------------------------------------------


2013-09-19T10:00:08 1 MultiScan 1 2013-09-19T10:00:20 1 MultiScan 2 2013-09-19T10:00:21
1 MultiScan 3 2013-09-19T10:00:34 1 MultiScan 4 2013-09-19T10:02:50 2 MultiScan 1
2013-09-19T10:03:06 2 MultiScan 2 2013-09-19T10:03:09 2 MultiScan 3 2013-09-19T10:03:12
2 MultiScan 4 2013-09-20T10:04:53 4 MultiScan 1 2013-09-20T10:05:11 4 MultiScan 2

OneFS isi 命令 D 至 L 317


2013-09-20T10:05:15 4 MultiScan 3 2013-09-20T10:05:20 4 MultiScan 4
-------------------------------------------- Total: 12

isi job reports view


显示特定作业的详细报告。 只能为成功作业或作业的成功阶段显示报告。

语法
isi job reports view <id>

选项
<id>
指定要查看的报告的作业 ID。

示例
以下命令请求 ID 为 7 的 FSAnalyze 作业的报告。

isi job reports view 7

系统将显示与以下示例类似的输出。 请注意,当作业具有多个阶段时,会提供每个阶段的报告。

FSAnalyze[7] phase 1 (2013-09-19T22:01:58) ------------------------------------------


FSA JOB QUERY PHASE Elapsed time: 83 seconds LINS traversed: 433 Errors: 0 CPU usage:
max 30% (dev 2), min 0% (dev 1), avg 10% Virtual memory size: max 111772K (dev 1), min
104444K (dev 2), avg 109423K Resident memory size: max 14348K (dev 1), min 9804K (dev
3), avg 12706K Read: 9 ops, 73728 bytes (0.1M) Write: 3035 ops, 24517120 bytes (23.4M)
FSAnalyze[7] phase 2 (2013-09-19T22:02:47) ------------------------------------------
FSA JOB MERGE PHASE Elapsed time: 47 seconds Errors: 0 CPU usage: max 33% (dev 1), min
0% (dev 1), avg 8% Virtual memory size: max 113052K (dev 1), min 110748K (dev 2), avg
111558K Resident memory size: max 16412K (dev 1), min 13424K (dev 3), avg 14268K Read: 2
ops, 16384 bytes (0.0M) Write: 2157 ops, 16871424 bytes (16.1M)

isi job statistics view


显示整个群集或特定节点上活动作业的统计信息。

语法
isi job statistics view
[--job-id <integer>]
[--devid <integer>]
[--verbose]
[--format {table | json | csv | list}]

选项
--job-id< 整数 >
显示特定作业 ID 的统计信息。

318 OneFS isi 命令 D 至 L


--devid< 整数 >
显示群集中特定节点(设备)的统计信息。
{--verbose | -v}
显示活动作业的更多详细统计信息。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。

示例
以下命令请求 ID 为 6 的 AutoBalance 作业的统计信息。

isi job statistics view --job-id 6

系统将显示与以下示例类似的输出。 在该示例中,PID 是进程 ID,CPU 指示作业的 CPU 利用率。 其中还指示了每个节点上针


对作业存在的工作线程数以及每个线程的休眠与工作 (STW) 比率。 统计信息表示系统如何根据影响策略限制作业。

Job ID: 6 Phase: 2 Nodes Node : 1 PID : 17006 CPU : 0.00% (0.00% min, 7.91% max, 4.50%
avg) Memory Virtual : 104.62M (104.37M min, 104.62M max, 104.59M avg) Physical : 10.08M
(10.01M min, 10.11M max, 10.09M avg) I/O Read : 4141 ops, 45.33M Write : 5035 ops,
35.28M Workers : 2 (0.60 STW avg.) Node : 2 PID : 16352 CPU : 13.96% (1.95% min, 13.96%
max, 9.61% avg) Memory Virtual : 104.62M (104.37M min, 104.62M max, 104.59M avg)
Physical : 10.01M (9.90M min, 10.01M max, 10.00M avg) I/O Read : 3925 ops, 43.39M
Write : 4890 ops, 34.13M Workers : 2 (0.60 STW avg.) Node : 3 PID : 15929 CPU : 0.98%
(0.98% min, 12.89% max, 6.82% avg) Memory Virtual : 104.62M (104.37M min, 104.62M max,
104.57M avg) Physical : 9.86M (9.84M min, 9.94M max, 9.92M avg) I/O Read : 3354 ops,
36.77M Write : 772 ops, 2.12M Workers : 2 (0.60 STW avg.)

isi job status


显示活动、已完成和失败作业的摘要。

语法

isi job status


[--verbose]

选项
{--verbose | -v}
显示更多详细作业状态信息,包括有关群集和节点的信息。

示例
以下命令提供基本作业状态。

isi job status

系统将显示与以下示例类似的输出。

The job engine is running.

No running or queued jobs.

OneFS isi 命令 D 至 L 319


Recent finished jobs:
ID Type State Time
-----------------------------------------------------------
1 MultiScan System Cancelled 2021-09-24T08:23:44
3 MultiScan Succeeded 2021-09-24T08:26:37
2 SetProtectPlus Succeeded 2021-09-24T08:27:16
4 FlexProtect Succeeded 2021-09-24T09:14:27
5 ShadowStoreDelete Succeeded 2021-09-24T00:03:24
6 WormQueue Succeeded 2021-09-24T02:00:52
-----------------------------------------------------------
Total: 6

以下命令提供更多详细作业状态信息。

isi job status --verbose

系统显示包含群集和节点信息的其他输出。

The job engine is running.


Coordinator LNN: 1
Connected: True
Disconnected Nodes: -
Non-Responding Nodes: -
Down or Read-Only Nodes: False
Statistics Ready: True
Cluster Is Degraded: False
Run Jobs When Degraded: False

No running or queued jobs.

Recent finished jobs:


ID Type State Time
-----------------------------------------------------------
1 MultiScan System Cancelled 2021-09-24T08:23:44
3 MultiScan Succeeded 2021-09-24T08:26:37
2 SetProtectPlus Succeeded 2021-09-24T08:27:16
4 FlexProtect Succeeded 2021-09-24T09:14:27
5 ShadowStoreDelete Succeeded 2021-09-24T00:03:24
6 WormQueue Succeeded 2021-09-24T02:00:52
-----------------------------------------------------------
Total: 6

isi job types list


显示作业类型和默认设置的列表。

语法
isi job types list
[--all]
[--sort {id | policy | exclusion_set | priority}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--all
显示作业引擎中可用的所有作业类型。
--sort {id | policy | exclusion_set | priority}

320 OneFS isi 命令 D 至 L


按指定参数对输出排序。
--descending
与 --sort 选项相结合,指定输出按降序排序。 默认情况下,输出按升序排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示有关特定作业类型或所有作业类型的更多详细信息。

示例
以下命令提供有关作业类型的详细信息。

isi job types list --sort id --verbose

系统将显示与以下示例类似的输出。

ID: AVScan Description: Perform an antivirus scan on all files. 已启用: Yes Policy: LOW
Schedule: Exclusion Set: None Priority: 6
------------------------------------------------------------------- ID: AutoBalance
Description: Balance free space in a cluster. AutoBalance is most efficient in clusters
that contain only HDDs. 已启用: Yes Policy: LOW Schedule: Exclusion Set: Restripe
Priority: 4 ------------------------------------------------------------------- ID:
AutoBalanceLin Description: Balance free space in a cluster. AutoBalanceLin is most
efficient if file system metadata is stored on SSDs. 已启用: Yes Policy: LOW Schedule:
Exclusion Set: Restripe Priority: 4

isi job types modify


修改指定作业类型的参数。
您可以使用 isi job types view 命令查看任何作业类型的当前参数。

语法
isi job types modify <id>
[--enabled <boolean>]
[--policy <string>]
[--schedule<string>]
[--priority <integer>]
[--clear-schedule]

选项
<id>
指定要修改的作业类型。
--enabled< 布尔值 >
指定作业类型是已启用还是已禁用。
--policy< 字符串 >

OneFS isi 命令 D 至 L 321


为指定作业类型设置策略。
--schedule< 字符串 >
设置重复日期模式以运行指定作业类型。
--priority< 整数 >
为指定作业类型设置优先级。 作业类型的优先级值介于 1 与 10 之间,其中 1 是最高优先级,10 是最低
优先级。
--clear-schedule
清除与指定作业类型关联的任何计划。
--force
强制修改而不显示确认消息。

示例
以下命令向 MultiScan 命令添加重复计划。

isi job types modify multiscan --schedule "Every Friday at 22:00"

运行此命令时,系统会提示您确认更改。 键入 yes 或 no,然后按 ENTER 键。

isi job types view


显示特定作业类型的参数,包括描述、计划、策略、优先级以及作业类型是否为排除集的成员。

语法

isi job types view <id>

选项
<id>
指定要查看的作业类型。

示例
以下命令显示作业类型 MultiScan 的参数。

isi job types view multiscan

系统将显示与以下示例类似的输出。

ID: MultiScan Description: Perform the work of the AutoBalance and Collect jobs
simultaneously. 已启用: Yes Policy: LOW Schedule: Exclusion Set: Restripe, Mark
Priority: 4

322 OneFS isi 命令 D 至 L


isi keymanager kmip servers create
配置新的外部 KMIP 服务器。

语法

isi keymanager kmip servers create


<name>
<host>
<ca-cert-path>
<client-cert-path>
[[{--port | -p} <integer>]
[--minimum-tls-version <string>]
[--client-cert-password <string>]
[--set-client-cert-password]
[{--verbose | -v}]
[{--help | -h}]

选项
<name>
指定唯一的 KMIP 服务器标识符。
<host>
指定 KMIP 服务器主机名称。
<ca-cert-path>
指定在与外部 KMIP 服务器进行 TLS 相互验证期间用于验证服务器连接的证书颁发机构 (CA) 证书。
<ca-cert-path> 必须是 /ifs 文件系统中的绝对路径。
<client-cert-path>
指定在与外部 KMIP 服务器进行 TLS 相互验证期间用于对群集进行验证的客户端证书和私钥。
[{--port | -p} <integer>
指定 KMIP 服务器主机端口。
--minimum-tls-version<string>
指定密钥信任平台 (KTP) 的最低 TLS 版本号。KTP 可实现支持符合 KMIP 的服务器,从而提供安全的外
部密钥管理。默认版本为 1.2。可接受的值为 1.0、1.1 或 1.2。
--client-cert-password<string>
指定可选群集客户端私钥密码。
--set-client-cert-password
允许以交互方式指定群集客户端私钥密码。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

OneFS isi 命令 D 至 L 323


isi keymanager kmip servers delete
删除外部 KMIP 服务器。

语法

isi keymanager kmip servers delete


<name>
[{--force | -f}]
[{--verbose | -v}]
[{--help | -h}]

选项
<name>
指定唯一的 KMIP 服务器标识符。
[{--force | -f}
在不要求确认的情况下删除 KMIP 服务器。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi keymanager kmip servers modify


修改外部 KMIP 服务器。

语法

isi keymanager kmip servers modify


<name>
<host>
<ca-cert-path>
<client-cert-path>
[[{--port | -p} <integer>]
[--minimum-tls-version <string>]
[--client-cert-password <string>]
[--set-client-cert-password]
[{--verbose | -v}]
[{--help | -h}]

选项
<name>
指定唯一的 KMIP 服务器标识符。
<host>
指定 KMIP 服务器主机名称。
<ca-cert-path>

324 OneFS isi 命令 D 至 L


指定在与外部 KMIP 服务器进行 TLS 相互验证期间用于验证服务器连接的证书颁发机构 (CA) 证书。
<ca-cert-path> 必须是 /ifs 文件系统中的绝对路径。
<client-cert-path>
指定在与外部 KMIP 服务器进行 TLS 相互验证期间用于对群集进行验证的客户端证书和私钥。
[{--port | -p} <integer>
指定 KMIP 服务器主机端口。
--minimum-tls-version<string>
指定密钥信任平台 (KTP) 的最低 TLS 版本号。KTP 可实现支持符合 KMIP 的服务器,从而提供安全的外
部密钥管理。默认版本为 1.2。可接受的值为 1.0、1.1 或 1.2。
--client-cert-password<string>
指定可选群集客户端私钥密码。
--set-client-cert-password
允许以交互方式指定群集客户端私钥密码。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi keymanager kmip servers list


显示配置的外部 KMIP 服务器的名称和描述。

语法

isi keymanager kmip servers list


[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定数量的 KMIP 服务器。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 D 至 L 325


isi keymanager kmip servers view
查看有关指定外部 KMIP 服务器的信息。

语法

isi keymanager kmip servers view


[<name>]
[--format {list | json}]
[{--help | -h}]

选项
--format {list | json}
以 JavaScript Object Notation (JSON) 或列表格式显示 KMIP 服务器信息。
{--help | -h}
显示此命令的帮助信息。

isi keymanager sed migrate local


开始在群集范围内将密钥还原回本地。

语法

isi keymanager sed migrate local


[{--help | -h}]

选项
{--help | -h}
显示此命令的帮助信息。

isi keymanager sed migrate retry


重试 KMIP 迁移。如果在运行 isi keymanager sed migrate local 或 isi keymanager sed migrate server 时
发生错误,则可使用此命令重试迁移。

语法

isi keymanager sed migrate retry


[{--help | -h}]

326 OneFS isi 命令 D 至 L


选项
{--help | -h}
显示此命令的帮助信息。

isi keymanager sed migrate server


开始在群集范围内将密钥迁移到远程 KMIP 服务器。

语法

isi keymanager sed migrate server


[{--help | -h}]

选项
{--help | -h}
显示此命令的帮助信息。

isi keymanager sed settings modify


启用或禁用 KMIP 功能。

语法

isi keymanager sed settings modify


[--kmip-enabled {true | false} ]
[{--help | -h}]

选项
--kmip-enabled {true | false}
设置为 true 可启用 KMIP 功能。设置为 false 可禁用 KMIP 功能。启用 KMIP 会允许迁移 SED。启用
KMIP 功能后无法删除 KMIP 服务器,如果有任何节点未处于“LOCAL”状态,则无法禁用 KMIP 功能。
{--help | -h}
显示此命令的帮助。

OneFS isi 命令 D 至 L 327


isi keymanager sed settings view
查看当前 KMIP 功能设置。

语法

isi keymanager sed settings view


[{--help | -h}]

选项
{--help | -h}
显示此命令的帮助信息。
示例
该命令会显示与以下示例类似的输出。

isi keymanager sed settings view


KMIP Enabled: Yes
KMIP Server: <KMIP server ID>
Supported: Yes

如果 KMIP 功能已禁用或 KMIP 服务器未配置,则 KMIP Server 字段为空。

isi keymanager sed status


显示自加密驱动器 (SED) 密钥库的状态。如果没有 SED 可用并且不支持 KMIP,则状态会显示为脱机。

语法

isi keymanager sed status


[view]
[{--node | -n} <integer>]
[--limit <integer>]
[--format {table | json | csv | list}]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--help | -h}]
[{--verbose | -v}]

选项
查看
显示节点的 SED 状态。指定 view 是可选操作:无论您是否指定 view,命令都会显示状态。
{--node | -n} <integer>
显示指定节点 ID 的状态。
{--limit | -l} < 整数 >
显示不超过指定数量的密钥管理器 SED。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。

328 OneFS isi 命令 D 至 L


{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。
示例

isi keymanager sed status


Node Status Location Remote Key ID Error Info(if any)
----------------------------------------------------------
1 LOCAL Local
2 LOCAL Local
3 LOCAL Local
----------------------------------------------------------

isi license activation start


启动产品内许可证激活过程。

语法
isi license activation start
[--timeout integer]
[{--help | -h]}

选项
--timeout <integer>
显示命令超时秒数(指定为 isi --timeout NNN <command>)。
{--help | -h}
显示此命令的帮助。

isi license activation view


查看产品内许可证激活状态。

语法
isi license activation view
[{--help | -h]}

选项
{--help | -h}
显示此命令的帮助。

OneFS isi 命令 D 至 L 329


isi license add
使用新的或更新的 ELMS 许可证文件激活可授权产品。

语法
isi license add
[--path <string>]
[--evaluation <string>]
[--verbose]

选项
--path < 字符串 >
许可证文件在群集上的位置。
--evaluation < 字符串 >
在有限评估期内要激活的许可证名称。针对您想要激活以进行评估的每个许可证重复此选项。
{--verbose | -v}
显示更多详细信息。

isi license generate


生成许可证激活文件。

语法
isi license generate
[--include <module>]
[--exclude <module>]
[--only <module>...]
[--action (license_list_only | generate_activation)]
[--file <path>]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
--include < 模块 >
将软件模块许可证添加至激活文件。为要包括在激活文件中的每个许可证指定 --include。
--exclude < 模块 >
从激活文件中删除软件模块许可证。为要从激活文件中删除的每个许可证指定 --exclude。
--only < 模块 >
将软件模块许可证添加至激活文件。为要包括在激活文件中的每个许可证指定 --only。
--action (license_list_only | generate_activation)
指定希望命令执行的操作。您可以生成激活文件,或者您可以在不生成激活文件的情况下返回已激活的
许可证列表。
--file < 路径 >
设置要在其中保存新激活文件的群集上的位置。

330 OneFS isi 命令 D 至 L


--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示许可证。
{--no-header | -a}
不会以表格或 CSV 格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{verbose |-v}
显示更多详细信息。

isi license list


检索所有可许可产品的许可证信息。

语法
isi license list
[--limit <integer>]
[--sort {name | module | status | expiration}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
要显示的许可证数。
--sort {name | module | status | expiration}
按指定字段对数据进行排序。
{--descending | -d}
按降序对数据进行排序。
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示许可证。
{--no-header | -a}
不会以表格或 CSV 格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

isi license view


检索任何可许可产品的许可证信息。

语法
isi license view <name>
[--format (list | json)]

OneFS isi 命令 D 至 L 331


选项
< 名称 >
要查看的许可证的产品名称。
{--format | -f} (list | json)
以列表或 JSON 格式显示许可证。
OneFS 显示许可证的许可证名称、状态和到期时间。

isi keymanager sed migrate local


开始在群集范围内将密钥还原回本地。

语法

isi keymanager sed migrate local


[{--help | -h}]

选项
{--help | -h}
显示此命令的帮助信息。

332 OneFS isi 命令 D 至 L


4
OneFS isi 命令 N 到 R
本章包含 OneFS CLI 命令 isi ndmp contexts delete 到 isi readonly view 的文档。

主简:
• isi namelength
• isi namelength create
• isi namelength delete
• isi namelength list
• isi namelength modify
• isi namelength view
• isi ndmp contexts delete
• isi ndmp contexts list
• isi ndmp contexts view
• isi ndmp dumpdates delete
• isi ndmp dumpdates list
• isi ndmp sessions delete
• isi ndmp sessions list
• isi ndmp sessions view
• isi ndmp settings diagnostics modify
• isi ndmp settings diagnostics view
• isi ndmp settings global modify
• isi ndmp settings global view
• isi ndmp settings preferred-ips create
• isi ndmp settings preferred-ips delete
• isi ndmp settings preferred-ips list
• isi ndmp settings preferred-ips modify
• isi ndmp settings preferred-ips view
• isi ndmp settings variables create
• isi ndmp settings variables delete
• isi ndmp settings variables list
• isi ndmp settings variables modify
• isi ndmp users create
• isi ndmp users delete
• isi ndmp users list
• isi ndmp users modify
• isi ndmp users view
• isi network dnscache flush
• isi network dnscache modify
• isi network dnscache view
• isi network external modify
• isi network external view
• isi network groupnets create
• isi network groupnets delete
• isi network groupnets list
• isi network groupnets modify
• isi network groupnets view
• isi network interfaces list
• isi network pools create
• isi network pools delete
• isi network pools list

OneFS isi 命令 N 到 R 333


• isi network pools modify
• isi network pools rebalance-ips
• isi network pools sc-resume-nodes
• isi network pools sc-suspend-nodes
• isi network pools view
• isi network rules create
• isi network rules delete
• isi network rules list
• isi network rules modify
• isi network rules view
• isi network sc-rebalance-all
• isi network subnets create
• isi network subnets delete
• isi network subnets list
• isi network subnets modify
• isi network subnets view
• isi nfs aliases create
• isi nfs aliases delete
• isi nfs aliases list
• isi nfs aliases modify
• isi nfs aliases view
• isi nfs exports check
• isi nfs exports create
• isi nfs exports delete
• isi nfs exports list
• isi nfs exports modify
• isi nfs exports reload
• isi nfs exports view
• isi nfs log-level modify
• isi nfs log-level view
• isi nfs netgroup check
• isi nfs netgroup flush
• isi nfs netgroup modify
• isi nfs nlm locks list
• isi nfs nlm locks waiters
• isi nfs nlm sessions check
• isi nfs nlm sessions delete
• isi nfs nlm sessions list
• isi nfs nlm sessions refresh
• isi nfs nlm sessions view
• isi nfs settings export modify
• isi nfs settings export view
• isi nfs settings global modify
• isi nfs settings global view
• isi nfs settings zone modify
• isi nfs settings zone view
• isi ntp servers create
• isi ntp servers delete
• isi ntp servers list
• isi ntp servers modify
• isi ntp servers view
• isi ntp settings modify
• isi ntp settings view
• isi performance datasets create
• isi performance datasets delete
• isi performance datasets list

334 OneFS isi 命令 N 到 R


• isi peformance datasets modify
• isi performance datasets view
• isi performance filters apply
• isi performance filters list
• isi performance filters modify
• isi performance filters remove
• isi performance filters view
• isi performance metrics list
• isi performance metrics view
• isi performance settings modify
• isi performance settings view
• isi performance workloads list
• isi performance workloads modify
• isi performance workloads pin
• isi performance workloads unpin
• isi performance workloads view
• isi quota quotas create
• isi quota quotas delete
• isi quota quotas list
• isi quota quotas modify
• isi quota quotas notifications clear
• isi quota quotas notifications create
• isi quota quotas notifications delete
• isi quota quotas notifications disable
• isi quota quotas notifications list
• isi quota quotas notifications modify
• isi quota quotas notifications view
• isi quota quotas view
• isi quota reports create
• isi quota reports delete
• isi quota reports list
• isi quota settings mappings create
• isi quota settings mappings delete
• isi quota settings mappings list
• isi quota settings mappings modify
• isi quota settings mappings view
• isi quota settings notifications clear
• isi quota settings notifications create
• isi quota settings notifications delete
• isi quota settings notifications list
• isi quota settings notifications modify
• isi quota settings notifications view
• isi quota settings reports modify
• isi quota settings reports view
• isi readonly list
• isi readonly modify
• isi readonly view

OneFS isi 命令 N 到 R 335


isi namelength
管理文件名配置。

语法

isi namelength <action>


[--timeout <integer>]

选项
[--timeout <integer>]
显示命令超时的秒数(指定为“isi --timeout NNN <command>”)。

isi namelength create


创建文件名长度配置域。

语法

isi namelength create <path>


[{--policy | -p} (restricted | full | custom)]
[{--max-bytes | -B} <integer>]
[{--max-chars | -C} <integer>]
[{--verbose | -v}]

选项
<path>
指定文件名长度配置域的路径。必须在 /ifs/ 中。
[{--policy | -p} (restricted | full | custom)]
指定文件长度策略的类型。
[{--max-bytes | -B} < 整数 >]
指定新 UTF-8 文件名的最大字节数。
[{--max-chars | -C} < 整数 >]
指定新 UTF-8 文件名的最大字符数。
{--verbose | -v}
显示更多详细信息。

336 OneFS isi 命令 N 到 R


isi namelength delete
删除文件名长度配置或所有配置。

语法

isi namelength delete { <path> | --all }


[{--force | -f}]
[{--verbose | -v}]

选项
<path>
指定文件名长度配置域的路径。必须在 /ifs/ 中。
--all
删除所有文件名长度配置域。
{--force | -f}
不要求确认。
{--verbose | -v}
显示更多详细信息。

isi namelength list


显示文件名长度配置域的列表。

语法
isi namelength list
[{--limit | -l} <integer>]
[--format (table | json | csv | list)]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]

选项
[{--limit | -l} < 整数 >]
指定要显示的名称长度数。
[--format (table | json | csv | list)]
以表格、JSON、CSV 或列表格式显示名称长度。
{--no-header | -a}
不会以 CSV 或表格格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 N 到 R 337


isi namelength modify
修改文件名长度配置域。

语法

isi namelength modify <path>


[{--policy | -p} (restricted | full | custom)]
[{--max-bytes | -B} <integer>]
[{--max-chars | -C} <integer>]
[{--verbose | -v}]

选项
<path>
指定文件名长度配置域的路径。必须在 /ifs/ 中。
[{--policy | -p} (restricted | full | custom)]
指定文件长度策略的类型。
[{--max-bytes | -B} < 整数 >]
指定新 UTF-8 文件名的最大字节数。
[{--max-chars | -C} < 整数 >]
指定新 UTF-8 文件名的最大字符数。
{--verbose | -v}
显示更多详细信息。

isi namelength view


显示文件名长度配置域的详细属性。

语法

isi namelength modify <path>

选项
<path>
指定文件名长度配置域的路径。必须在 /ifs/ 中。

338 OneFS isi 命令 N 到 R


isi ndmp contexts delete
删除 NDMP 上下文。

语法
isi ndmp contexts delete --id <id>
[--force]
[--verbose]

选项
--id <ID>
上下文 ID 字符串。
{--force | -f}
跳过确认提示。
{verbose | -v}
显示更多详细信息。

isi ndmp contexts list


列出 NDMP 上下文。

语法
isi ndmp contexts list
[--type {bre | 备份 | 恢复}]
[--format {table | json | csv | list}]

选项
{--type | -t} {bre | backup | restore}
显示指定级别条目:备份可重启扩展 (BRE)、备份或恢复。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。

isi ndmp contexts view


显示 NDMP 上下文的详细信息。

语法
isi ndmp contexts view --id <id>
[--format {list | json}

OneFS isi 命令 N 到 R 339


选项
--id <ID>
上下文 ID 字符串。
--format {list | json}
以指定格式列出 NDMP 上下文。

isi ndmp dumpdates delete


删除为基于快照的 NDMP 增量备份创建的快照。

语法
isi ndmp dumpdates delete --path <path>
[--level <integer>]
[--force]
[--verbose]

选项
--path < 路径 >
NDMP 转储日期的路径。必须在 /ifs 目录结构中。
--level < 整数 >
删除指定目录的指定级别备份的转储日期条目。如果未指定此选项,将删除给定目录的所有转储日期条
目。

示例
以下命令将删除 /ifs/data/media 的 0 级别备份的转储日期条目。

isi ndmp dumpdates delete /ifs/data/media --level=0

isi ndmp dumpdates list


显示为基于快照的 NDMP 增量备份创建的快照。

语法
isi ndmp dumpdates list
[--path < 路径 >]
[--level < 整数 >]
[--limit < 整数 >]
[--sort {path | 级别}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

340 OneFS isi 命令 N 到 R


选项
--path< 路径 >
NDMP 转储日期的路径。必须在 /ifs 目录结构中。
--level< 整数 >
显示给定目录路径的指定级别备份的转储日期条目。
{--limit | -l}< 整数 >
要显示的 NDMP 转储日期数。
--sort {path | level}
按指定字段对数据进行排序。
{--descending | -d}
按降序对数据进行排序。
--format {table | json | csv | list}
以表格(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示 NDMP 转储
日期。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
要查看 NDMP 转储日期条目,请运行以下命令:

isi ndmp dumpdates list

系统将显示与以下示例类似的输出:

Date Level SnapID Path


----------------------------------------------------------------------
Fri May 29 12:06:26 2015 0 18028 /ifs/tmp/backup
Fri May 29 12:20:56 2015 1 18030 /ifs/tmp/backup

如果快照是针对非基于快照的增量备份创建的,则快照 ID 为 0。

isi ndmp sessions delete


停止 NDMP 会话。

语法
isi ndmp sessions delete --session <session>
[--force]
[--level
[--path]
[--session]
[--verbose]

OneFS isi 命令 N 到 R 341


选项
{--force | -f}
跳过确认提示。
--level
停止指定级别的 NDMP 会话。
--path
停止正在指定路径运行的 NDMP 会话。
--session < 会话 >
NDMP 会话标识符。会话 ID 包含逻辑节点编号 (LNN),后跟小数点,接着是进程 ID (PID),如
<lnn>.<pid>。
{verbose | -v}
显示更多详细信息。
--session 选项示例
以下命令将结束会话 ID 为 4.36339 的 NDMP 会话:

isi ndmp sessions delete --session=4.36339

isi ndmp sessions list


列出所有或指定的 NDMP 会话。

语法
isi ndmp sessions list
[--node <integer>]
[--session <string>]
[--consolidate}
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--node | -n} < 整数 >
仅显示指定节点的会话。
{--session | -s} < 字符串 >
NDMP 会话标识符。会话 ID 包含逻辑节点编号 (LNN),后跟小数点,接着是进程 ID (PID),如
<lnn>.<pid>。
{--consolidate | -c}
整合多流上下文的会话。
{--limit | -l} < 整数 >
要显示的 NDMP 会话数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}

342 OneFS isi 命令 N 到 R


显示不带页脚的表输出。
{verbose | -v}
显示更多详细信息。

isi ndmp sessions view


显示有关 NDMP 会话的详细信息。

语法
isi ndmp sessions view --session <session>
[--probe]
[--format {list | json}]

选项
--session < 会话 >
NDMP 会话标识符。会话 ID 包含逻辑节点编号 (LNN),后跟小数点,接着是进程 ID (PID),如
<lnn>.<pid>。
--probe
显示有关 NDMP 会话的探测信息。
--format {list | json}
以列表或 JSON 格式显示 NDMP 会话信息。

isi ndmp settings diagnostics modify


修改 NDMP 诊断设置。

语法
isi ndmp settings diagnostics modify
[--diag-level < 整数 >]
[--protocol-version < 整数 >]
[--trace-level {none | standard | include-file-history | log-file-history}]

选项
--diag-level< 整数 >
NDMP 的诊断级别。
--protocol-version< 整数 >
NDMP 协议版本(3 或 4)。
--trace-level {none | standard | include-file-history | log-file-history}
NDMP 跟踪日志级别。选择 none 表示没有日志,standard 表示 NDMP 协议跟踪,include-
file-history 可将文件历史记录信息记录到跟踪文件中,或者 log-file-history 可将文件历史
记录记录到文件历史记录日志中。

OneFS isi 命令 N 到 R 343


isi ndmp settings diagnostics view
显示 NDMP 诊断设置。

语法
isi ndmp settings diagnostics view
[--format {list | json}]

选项
--format {list | json}
以列表或 JSON 格式显示 NDMP 诊断设置信息。

isi ndmp settings global modify


修改 NDMP 全局设置。

语法
isi ndmp settings global modify
[--service {true | false}]
[--dma {generic | atempo | bakbone | commvault | emc | symantec | tivoli | symantec-
netbackup | symantec-backupexec}]
[--port <integer>]
[--bre-max-num-contexts <integer>]
[--msb-context-retention-duration <integer>]
[--msr-context-retention-duration <integer>]

选项
{--service | -s} {true | false}
启用或禁用 NDMP 服务。
{--dma | -d} {generic | atempo | bakbone | commvault | emc | symantec | tivoli | symantec-netbackup |
symantec-backupexec}
控制 NDMP 会话的数据管理应用程序 (DMA)。
{--port | -p} < 整数 >
设置 NDMP 守护程序在其上侦听传入连接的 TCP/IP 端口号。默认端口为 10000。
--bre-max-num-contexts < 整数 >
设置可重启备份环境的最大数量。系统最大限制为 1024,默认值为 64。将此选项设置为零 (0) 可禁用
可重启备份。
--msb-context-retention-duration < 整数 >
设置多流备份上下文保留的持续时间。采用 YMWDHms 整数格式表示持续时间。默认持续时间为 5m(五
分钟)。
--msr-context-retention-duration < 整数 >
设置多流恢复上下文保留的持续时间。采用 YMWDHms 整数格式表示持续时间。默认持续时间为 10m
(十分钟)。
--stub-file-open-timeout
在备份或恢复期间,由于活动操作,可能无法打开 SmartLink 文件。NDMP 将重试,但在此超时后将失
败。默认值为 15(15 秒)。最大超时值为 120 秒(2 分钟)。

344 OneFS isi 命令 N 到 R


--enable-redirector
启用或禁用加载 NDMP 备份和恢复操作分配的 NDMP 重定向器。
--throttler-cpu-threshold
启用或禁用 NDMP 限制工具,这将限制每个节点上的 NDMP 备份和恢复操作的 CPU 使用情况。
--enable-throttler
启用 NDMP 限制工具后,NDMP 会确保 NDMP 备份或恢复操作不会超过此 CPU 阈值。该值以百分比形
式表示,范围为 1 至 100。默认值为 50。

isi ndmp settings global view


显示 NDMP 全局设置。

语法
isi ndmp settings global view
[--format {list | json}]

选项
--format {list | json}
以列表或 JSON 格式显示 NDMP 全局设置。

示例
下面是使用此命令生成的输出示例:

Service: True
Port: 10000
Dma: emc
Bre Max Num Contexts: 64
Msb Context Retention Duration: 300
Msr Context Retention Duration: 600

isi ndmp settings preferred-ips create


对于使用 Avamar 执行的 NDMP 三向操作,创建 NDMP 首选 IP 设置。

语法
isi ndmp settings preferred-ips create --scope <scope> --data-subnets <subnets>
[{verbose | -v}]

选项
--scope < 范围 >
指定首选 IP 设置的范围。该范围确定在三向 NDMP 备份或恢复操作过程中将数据子网下列出的 IP 作为
首选的条件。该范围可以是接收传入 NDMP 请求的子网,也可以在群集范围首选项情况下是群集。最多
有一个首选项设置用于每个子网范围,并且最多有一个首选项设置用于 cluster 范围。
--data-subnets < 子网 >

OneFS isi 命令 N 到 R 345


指定 flexnet 子网名称的逗号分隔列表,其中子网中的 IP 是用于传出数据(在备份过程中)或传入数据
(在恢复过程中)的首选。根据 data-subnets 下面列出的子网顺序重新排列 IP 列表。如果 IP 位于
列出的数据子网中,则该 IP 位于列表顶部。如果列表中没有任何 IP 属于数据子网中的某个子网,则该
子网不起作用。仅在 scope 参数指定的条件下才应用首选项。scope 和 data-subnets 值可以设置
为相同子网。在这种情况下,会将相同子网用于 NDMP 传出数据,即便传入数据会进入该子网。例如,
如果范围是 groupnet0.subnet0,,data-subnets 值是
10gnet.subnet0,globalnet0.subnet0,并且备份操作的 NDMP 数据会通过
groupnet0.subnet0 传入,则 10gnet.subnet0 的 IP 位于列表顶部,但是,如果该 IP 不可用,则
globalnet0.subnet0 的 IP 位于列表顶部。子网名称必须始终用逗号分隔。
--verbose | -v
显示其他详细信息。

isi ndmp settings preferred-ips delete


对于使用 Avamar 执行的 NDMP 三向操作,删除 NDMP 首选 IP 设置。

语法
isi ndmp settings preferred-ips delete --scope <scope>
[{--verbose | -v}]
[{--help | -h}]

选项
--scope < 范围 >
首选 IP 设置的范围。您可以通过对群集指定值来将首选 IP 设置为具有整个群集范围,也可以选择
OneFS 配置的子网,例如,groupnet0.mysubnet1。
--verbose | -v
显示其他详细信息。
--help | -h
显示此命令的帮助。

isi ndmp settings preferred-ips list


对于使用 Avamar 执行的 NDMP 三向操作,列出所有 NDMP 首选 IP 设置。

语法
isi ndmp settings preferred-ips list
[{--limit | -l} <integer>]
[--format (table | json | csv | list)]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]
[{--help | -h}]

选项
--limit | -l <integer>
要显示的 NDMP 首选 IP 设置数。

346 OneFS isi 命令 N 到 R


--format (table | json | csv | list)
以表格、JSON、CSV 或列表格式显示 NDMP 首选 IP 设置。
--no-header | -a
不会以 CSV 或表格格式显示标头。
--no-footer | -z
不显示表格摘要页脚信息。
--verbose | -v
显示其他详细信息。

isi ndmp settings preferred-ips modify


对于使用 Avamar 执行的 NDMP 三向操作,修改现有 NDMP 首选 IP 设置。

语法
isi ndmp settings preferred-ips modify --scope <scope>
[--data-subnets <subnet> | --add-data-subnets <subnet> |
--remove-data-subnets <subnet>]
[{--verbose | -v}]
[{--help | -h}]

选项
--scope < 范围 >
NDMP 首选 IP 设置的范围。您可以通过对群集指定值来将首选 IP 设置为具有整个群集范围,也可以选
择 OneFS 配置的子网,例如,groupnet0.mysubnet1。
--data-subnets < 子网 >
网络子网值。对要指定的每个其他网络子网指定 --data-subnets 值。子网名称必须用逗号分隔。
--add-data-subnets < 子网 >
添加网络子网。对要添加的每个网络子网指定 --add-data-subnets。子网名称必须用逗号分隔。
--remove-data-subnets < 子网 >
删除网络子网。对要删除的每个网络子网指定 --remove-data-subnets。子网名称必须用逗号分
隔。
--verbose | -v
显示其他详细信息。
--help | -h
显示此命令的帮助。

isi ndmp settings preferred-ips view


对于使用 Avamar 执行的 NDMP 三向操作,显示 NDMP 首选 IP 设置的详细信息。

语法
isi ndmp settings preferred-ips view --scope <scope>
[--format (list | json)]
[{--help | -h}]

OneFS isi 命令 N 到 R 347


选项
--scope < 范围 >
NDMP 首选 IP 设置的范围。您可以通过将 cluster 指定为值以将首选 IP 设置为具有整个群集范围,
也可以选择 OneFS 配置的子网,例如,groupnet0.mysubnet1。
--format (list | json)
以列表或 JSON 格式显示 NDMP 首选 IP 设置。

isi ndmp settings variables create


为给定路径的 NDMP 环境变量设置默认值。

语法
isi ndmp settings variables create --path <path> --name <name> --value <value>

有关可用的环境变量列表,请参见相应版本的 OneFS 备份和恢复指南 中的 NDMP 环境变量 部分。

选项
--path < 路径 >
将默认 NDMP 环境变量值应用到指定路径。此目录路径必须在 /ifs 中。
--name < 名称 >
指定要定义的 NDMP 环境变量。
--value < 值 >
指定要应用到 NDMP 环境变量的值。

示例
以下命令会导致在默认情况下针对 /ifs/data/media 执行基于快照的增量备份。

isi ndmp settings variables create --path=/ifs/data/media BACKUP_MODE SNAPSHOT

isi ndmp settings variables delete


删除给定路径的 NDMP 环境变量的默认值。

语法
isi ndmp settings variables delete
[--path <path>
[--name <name>
[--force]
[--verbose]

选项
有关可用的环境变量列表,请参见相应版本的 OneFS 备份和恢复指南 中的 NDMP 环境变量 部分。

348 OneFS isi 命令 N 到 R


< 路径 >
将默认 NDMP 环境变量值应用到指定路径。这必须是 /ifs 内的有效目录路径。
< 名称 >
要删除的变量的名称。如果未指定变量名称,将删除指定路径的所有环境变量。
如果未指定此选项,将删除给定路径的所有 NDMP 环境变量的默认值。
{--force | -f}
跳过确认提示。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将删除 /ifs/data/media 的所有默认 NDMP 设置:

isi ndmp settings variables delete --path=/ifs/data/media

以下命令将删除备份 /ifs/data/media 的默认文件历史记录设置:

isi ndmp settings variables delete --path=/ifs/data/media --name=HIST

isi ndmp settings variables list


列出所有首选 NDMP 环境变量。

语法
isi ndmp settings variables list
[--path < 路径 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
--path< 路径 >
将默认 NDMP 环境变量值应用到指定路径。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。

OneFS isi 命令 N 到 R 349


isi ndmp settings variables modify
修改给定路径的 NDMP 环境变量的默认值。

语法
isi ndmp settings variables modify --path <path> --name <name> --value <value>

选项
有关可用的环境变量列表,请参见相应版本的 OneFS 备份和恢复指南 中的 NDMP 环境变量 部分。
< 路径 >
将默认 NDMP 环境变量值应用到指定路径。这必须是 /ifs 内的有效目录路径。
< 名称 >
指定要定义的 NDMP 环境变量。
<值>
指定要应用到 NDMP 环境变量的值。

isi ndmp users create


创建新 NDMP 用户。

语法
isi ndmp users create --name <name>
[--password <string>]

选项
--name < 名称 >
用户的名称。
--password < 字符串 >
新 NDMP 用户的密码。如果未指定密码,系统将会提示新用户输入密码,并将提示通过再次输入来确认
密码。如果指定用户已存在,此命令会失败。

示例
以下命令将创建名为 ndmp_user 且密码为 1234 的 NDMP 用户帐户:

isi ndmp users create --name=ndmp_user --password=1234

350 OneFS isi 命令 N 到 R


isi ndmp users delete
删除指定 NDMP 用户。

语法
isi ndmp users delete --name <name>
[--force]
[--verbose]

选项
--name < 名称 >
要删除的 NDMP 用户的名称。
{--force | -f}
跳过确认提示。
{verbose | -v}
显示更多详细信息。

isi ndmp users list


列出所有 NDMP 用户。

语法
isi ndmp users list
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。

示例
这是此命令创建的输出示例:

Name
----------
ndmp_nick
ndmp_lisa
ndmp_jason
----------
Total: 3

OneFS isi 命令 N 到 R 351


isi ndmp users modify
更改指定 NDMP 用户的密码。

语法
isi ndmp users delete --name <name>

选项
--name < 名称 >
要修改的 NDMP 用户的名称。

isi ndmp users view


查看特定 NDMP 用户。

语法
isi ndmp users view --name <name>
[--format {list | json}]

输出
--name < 名称 >
NDMP 用户的名称。
--format {list | json}
以指定格式列出 NDMP 用户。

示例
以下是此命令针对名为 ndmp_lisa 的 NDMP 用户创建且采用指定的 JSON 格式的输出示例:

[{"id": "ndmp_lisa", "name": "ndmp_lisa"}]

isi network dnscache flush


同时刷新启用 DNS 缓存的每个 groupnet 的 DNS 缓存。

语法

isi network dnscache flush


[--verbose]

352 OneFS isi 命令 N 到 R


选项
{ --verbose | -v}
显示更多详细信息。

isi network dnscache modify


修改按 groupnet 启用的每个 DNS 缓存的全局 DNS 缓存设置。

语法

isi network dnscache modify


[--cache-entry-limit <integer>]
[--revert-cache-entry-limit]
[--cluster-timeout <integer>]
[--revert-cluster-timeout]
[--dns-timeout <integer>]
[--revert-dns-timeout]
[--eager-refresh <integer>]
[--revert-eager-refresh]
[--testping-delta <integer>]
[--revert-testping-delta]
[--ttl-max-noerror <integer>]
[--revert-ttl-max-noerror]
[--ttl-min-noerror <integer>]
[--revert-ttl-min-noerror]
[--ttl-max-nxdomain <integer>]
[--revert-ttl-max-nxdomain]
[--ttl-min-nxdomain <integer>]
[--revert-ttl-min-nxdomain]
[--ttl-max-other <integer>]
[--revert-ttl-max-other]
[--ttl-min-other <integer>]
[--revert-ttl-min-other]
[--ttl-max-servfail <integer>]
[--revert-ttl-max-servfail]
[--ttl-min-servfail <integer>]
[--revert-ttl-min-servfail]
[--verbose]

选项
--cache-entry-limit < 整数 >
指定 DNS 缓存可包含的条目的最大数量。限制必须是介于 1024 和 1048576 之间的值。默认值为 65536
个条目。
--revert-cache-entry-limit
将 --cache-entry-limit 的值设置为默认系统值。
--cluster-timeout < 整数 >
指定调用群集中的其他节点的超时限制(以秒为单位)。限制必须是介于 0 和 60 之间的值。默认值为
5。
--revert-cluster-timeout
将 --cluster-timeout 的值设置为默认系统值。
--dns-timeout < 整数 >
指定调用 DNS 解析程序的超时限制(以秒为单位)。限制必须是介于 0 和 60 之间的值。默认值为 5。
--revert-dns-timeout
将 --dns-timeout 的值设置为默认系统值。

OneFS isi 命令 N 到 R 353


--eager-refresh < 整数 >
指定刷新接近到期的缓存条目的前导时间(以秒为单位)。前导时间必须是介于 0 和 60 之间的值。默
认值为 0。
--revert-eager-refresh
将 --eager-refresh 的值设置为默认系统值。
--testping-delta < 整数 >
指定检查 cbind 群集运行状况的增量(以秒为单位)。增量必须是介于 0 和 60 之间的值。默认值为
30。
--revert-testping-delta
将 --testping-delta 的值设置为默认系统值。
--ttl-max-noerror < 整数 >
指定缓存命中的生存时间上限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为 3600。
--revert-ttl-max-noerror
将 --ttl-max-noerror 的值设置为默认系统值。
--ttl-min-noerror < 整数 >
指定缓存命中的生存时间下限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为 30。
--revert-ttl-min-noerror
将 --ttl-min-noerror 的值设置为默认系统值。
--ttl-max-nxdomain < 整数 >
指定 nxdomain 故障生存时间的上限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为
3600
--revert-ttl-max-nxdomain
将 --ttl-max-nxdomain 的值设置为默认系统值。
--ttl-min-nxdomain < 整数 >
指定 nxdomain 故障生存时间的下限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为
15。
--revert-ttl-min-nxdomain
将 --ttl-min-nxdomain 的值设置为默认系统值。
--ttl-max-other < 整数 >
指定非 nxdomain 故障生存时间的上限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为
60。
--revert-ttl-max-other
将 --ttl-max-other 的值设置为默认系统值。
--ttl-min-other < 整数 >
指定非 nxdomain 故障生存时间的下限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为
0。
--revert-ttl-min-other
将 --ttl-min-other 的值设置为默认系统值。
--ttl-max-servfail < 整数 >
指定 DNS 服务器故障生存时间的上限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为
3600。
--revert-ttl-max-servfail
将 --ttl-max-servfail 的值设置为默认系统值。
--ttl-min-servfail < 整数 >
指定 DNS 服务器故障生存时间的下限(以秒为单位)。边界必须是介于 0 和 3600 之间的值。默认值为
300。
--revert-ttl-min-servfail
将 --ttl-min-servfail 的值设置为默认系统值。
{--verbose | -v}
显示更多详细信息。

354 OneFS isi 命令 N 到 R


isi network dnscache view
显示 DNS 缓存设置。

语法
isi network dnscache view

选项
此命令没有选项。

isi network external modify


修改群集上的全局外部网络设置。

语法

isi network external modify


[--sbr {true | false}]
[--revert-sbr]
[--sc-rebalance-delay <integer>]
[--revert-sc-rebalance-delay]
[--tcp-ports <integer>]
[--clear-tcp-ports]
[--add-tcp-ports <integer>]
[--remove-tcp-ports <integer>]
[--revert-tcp-ports]
[--verbose]

选项
--sbr {true | false}
在群集上启用或禁用基于源的路由。默认情况下禁用基于源的路由。
--revert-sbr
将 --sbr 的值设置为默认系统值。
--sc-rebalance-delay < 整数 >
指定在确定事件之后、执行自动重新平衡之前应经过的时间(以秒为单位)。默认值为 0 秒。
--revert-sc-rebalance-delay
将 --sc-rebalance-delay 的值设置为默认系统值。
--tcp-ports < 整数 >
设置已识别客户端 TCP 端口的列表。65535 是支持的最大端口号。您可以指定以逗号分隔的多个 TCP
端口,也可以为每个额外 TCP 端口指定此选项。
--clear-tcp-ports
删除所有客户端 TCP 端口。
--add-tcp-ports < 整数 >
将一个或多个以逗号分隔的已识别客户端 TCP 端口添加到现有列表。65535 是支持的最大端口号。
--remove-tcp-ports < 整数 >
删除一个或多个以逗号分隔的已识别客户端 TCP 端口。

OneFS isi 命令 N 到 R 355


--revert-tcp-ports
将 --tcp-ports 的值设置为默认系统值。
{ --verbose | -v}
显示更多详细信息。

isi network external view


显示外部网络的配置设置。

语法

isi network external view

选项
此命令没有选项。

isi network groupnets create


创建定义应用于通过 groupnet 连接的服务的客户端 DNS 设置的 groupnet。

语法

isi network groupnets create <ID>


[--description < 字符串 >]
[--dns-cache-enabled {true | false}]
[--dns-search < 域名 >]
[--dns-servers <IP 地址 >]
[--dns-options < 字符串 >]
[--server-side-dns-search {true | false}]
[--verbose]

选项
<id>
指定 groupnet 的唯一 ID。此 ID 的最大长度为 32 个字母数字字符,可以包含下划线或连字符,但不能
包含空格或其他标点符号。ID 不能超过 32 个字符。
--description< 字符串 >
指定 groupnet 的可选描述。描述不能超过 128 个字节。
--dns-cache-enabled {true | false}
指定是否为 groupnet 启用 DNS 缓存。默认情况下启用 DNS 缓存。
--dns-search< 域名 >
设置 DNS 搜索后缀列表。为非完全限定的域名附加后缀。该列表最多只能包含 6 个后缀。
注: 后缀不要使用前导圆点开始;系统会自动添加前导圆点。

--dns-servers<IP 地址 >
设置 DNS IP 地址列表。节点向这些 IP 地址发送 DNS 请求。该列表最多只能包含 3 个 IP 地址。
--dns-options< 字符串 >

356 OneFS isi 命令 N 到 R


设置 DNS 解析程序选项。此选项的唯一有效值为 rotate。
--server-side-dns-search {true | false}
指定是否启用服务器端 DNS 搜索,这会将 DNS 搜索列表附加到 SmartConnect 服务 IP 地址处理的客户
端 DNS 查询。默认情况下启用服务器端搜索。
{--verbose | -v}
显示更多详细信息。

isi network groupnets delete


从群集中删除 groupnet。您不能从系统中删除默认 groupnet。
如果 groupnet 与某个访问分区或身份认证提供程序关联,从系统中删除 groupnet 可能会影响 OneFS 的多个其他方面,应谨慎
执行。删除 groupnet 时,将丢失 groupnet 中到每个子网池关联的客户端连接。删除使用中的 groupnet 可能会阻止访问群集。
将终止客户端通过属于已删除 groupnet 的 任何子网池到群集的连接。

语法

isi network groupnets delete <id>


[--force]
[--verbose]

选项
< id>
指定要删除的 groupnet 的 ID。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

isi network groupnets list


检索群集上存在的 groupnet 的列表。

语法
isi network groupnets list
[{--limit | -l} <integer>]
[--sort {description | dns_cache_enabled | id | name | server_side_dns_search}]
[{--descending | -d}]
[--format {true | table | json | csv | list}]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]

选项
{ --limit | -l} < 整数 >
显示不超过指定的数量。
--sort {description | dns_cache_enabled | id | name | server_side_dns_search}

OneFS isi 命令 N 到 R 357


按照指定的属性对显示的输出进行排序。
{ --descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi network groupnets modify


修改定义应用于通过 groupnet 连接的服务的 DNS 设置的 groupnet。

语法

isi network groupnets modify <ID>


[--description < 字符串 >]
[--clear description]
[--dns-cache-enabled {true | false}]
[--revert-dns-cache-enabled]
[--dns-search < 域名 >]
[--clear-dns-search]
[--add-dns-search < 域名 >]
[--remove-dns-search < 域名 >]
[--dns-servers <IP 地址 >]
[--clear-dns-servers]
[--add-dns-servers <IP 地址 >]
[--remove-dns-servers <IP 地址 >]
[--dns-options < 字符串 >]
[--clear-dns-options]
[--add-dns-options < 字符串 >]
[--remove-dns-options < 字符串 >]
[--name < 字符串 >]
[--server-side-dns-search {true | false}]
[--revert server-side-dns-search]
[--verbose]

选项
<id>
指定要修改的 groupnet 的 ID。
--description< 字符串 >
指定 groupnet 的可选描述。此选项会覆盖现有描述。描述不能超过 128 个字节。
--clear-description
清除当前描述。
--dns-cache-enabled {true | false}
指定是否为 groupnet 启用 DNS 缓存。默认情况下启用 DNS 缓存。
--revert-dns-cache-enabled
将 --dns-cache-enabled 的值设置为系统默认值。
--dns-search< 域名 >

358 OneFS isi 命令 N 到 R


设置 DNS 搜索后缀列表。为非完全限定的域名附加后缀。该列表最多只能包含 6 个后缀。此选项将覆盖
当前的 DNS 搜索后缀列表。
注: 后缀不要使用前导圆点开始;系统会自动添加前导圆点。

--clear-dns-search
删除 DNS 搜索后缀的当前列表。
--add-dns-search< 域名 >
将一个或多个 DNS 搜索后缀添加到当前列表。
--remove-dns-search< 域名 >
从当前列表中删除一个或多个 DNS 搜索后缀。
--dns-servers<IP 地址 >
设置 DNS IP 地址列表。节点向这些 IP 地址发送 DNS 请求。该列表最多只能包含 3 个 IP 地址。此选项
将覆盖当前的 DNS IP 地址列表。
--clear-dns-servers
删除 DNS 服务器的当前列表。
--add-dns-servers<IP 地址 >
将一个或多个 DNS 服务器添加到当前列表。
--remove-dns-servers<IP 地址 >
从当前列表中删除一个或多个 DNS 服务器。
--dns-options< 字符串 >
设置 DNS 解析程序选项。此选项的唯一有效值为 rotate。
--clear-dns-options
删除 DNS 解析程序选项的当前列表。
--add-dns-options< 字符串 >
将一个或多个 DNS 解析程序选项添加到当前列表。
--remove-dns-options< 字符串 >
从当前列表中删除一个或多个 DNS 解析程序选项。
--name< 字符串 >
指定 groupnet 的新名称。此 ID 的最大长度为 32 个字母数字字符,可以包含下划线或连字符,但不能包
含空格或其他标点符号。名称不能超过 32 个字符。
--server-side-dns-search {true | false}
指定是否启用服务器端 DNS 搜索,这会将 DNS 搜索列表附加到 SmartConnect 服务 IP 地址处理的客户
端 DNS 查询。默认情况下启用服务器端搜索。
--revert-server-side-dns-search
将 --server-side-dns-search 的值设置为系统默认值。
{--verbose | -v}
显示更多详细信息。

isi network groupnets view


显示群集上特定 groupnet 的配置详细信息。

语法
isi network groupnets view <id>

选项
<id>

OneFS isi 命令 N 到 R 359


指定要查看的 groupnet 的 ID。

isi network interfaces list


显示群集上的网络接口列表。

语法

isi network interfaces list


[--nodes <integer>]
[--show-inactive]
[--limit <integer>]
[--sort {lnn |
name} | status]
[--descending]
[--format {table |
json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
如果未指定任何选项,该命令将显示群集上的所有网络接口的列表。
--nodes <LNN>
仅列出指定节点中的接口。按逻辑节点编号指定节点。用逗号分隔多个节点。
--show-inactive
在输出中包括非活动接口。
{ --limit | -l} < 整数 >
显示不超过指定数量的接口。
--sort {lnn | name | status}
按照指定的属性对显示的输出进行排序。
{ --descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将列出在节点 1 上的网络接口:

isi network interfaces list --nodes=1

系统将显示与以下示例类似的输出:

360 OneFS isi 命令 N 到 R


LNN Name Status Owners IP Addresses
-------------------------------------------------------------------
1 10gige-1 Up -
1 10gige-2 No Carrier - -
1 10gige-agg-1 Not Available - -
1 ext-1 Up groupnet0.subnet0.pool0 198.51.100.0
1 ext-2 Up - -
1 ext-agg Not Available - -
-------------------------------------------------------------------
Total: 6

isi network pools create


在子网内创建 IP 地址池。需要 SmartConnect Advanced 许可证才能在子网内创建多个池。

语法
isi network pools create <id>
[--access-zone <string]
[--aggregation-mode {roundrobin | failover | lacp | fec}]
[--alloc-method {dynamic | static}]
[--description <string>]
[--ifaces <node-interface-range>]
[--ranges <ip-address-range>]
[--rebalance-policy{manual | auto}]
[--sc-auto-unsuspend-delay <integer>]
[--sc-connect-policy {roundrobin | conn_count | throughput | cpu_usage}]
[--sc-dns-zone <domain-name>]
[--sc-dns-zone-aliases <domain-name>]
[--sc-failover-policy {roundrobin | conn_count | throughput | cpu_usage}]
[--sc-subnet <string>]
[--sc-ttl <integer>]
[--static-routes <route>]
[--nfsv3-rroce-only <boolean>]
[--force]
[--verbose]

选项
<ID>
指定要创建的新池的 ID。该池必须添加到现有 groupnet 和子网。此 ID 的最大长度为 32 个字母数字字
符,可以包含下划线或连字符,但不能包含空格或其他标点符号。采用以下格式指定池 ID:

<groupnet_name>.<subnet_name>.<pool_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0。池名称在子网中必须唯一。
--access-zone < 分区名称 >
将访问分区与池关联。仅允许客户端通过池中的 IP 地址连接到指定访问分区。访问分区必须属于与 IP
地址池相同的 groupnet。
--aggregation-mode {roundrobin | failover | lacp | fec}
指定如何跨聚合网络接口分发传出流量。仅当有至少一个聚合网络接口是 IP 地址池成员时才应用聚合模
式。
以下值有效:

roundrobin 按先进先出的顺序通过节点循环连接,不分优先级地处理所有进程。平衡聚合链路
中所有活动端口间的出站流量,并接受任何端口上的入站流量。

OneFS isi 命令 N 到 R 361


failover 当主接口变得不可用时切换到下一个活动的接口。仅通过主要接口管理流量。只要
检测到通信中断,第二个接口就会立即接管第一个接口的工作。
lacp 支持 IEEE 802.3ad 链路聚合控制协议 (LACP)。基于经哈希处理的协议头信息跨接
口平衡传出流量,此信息包括源和目标地址以及 VLAN 标记(如果有)。另外,
将同速接口组合到链路聚合组 (LAG),并且跨最快的 LAG 平衡流量。此选项是新
池的默认模式。
fec 通过 Cisco Fast EtherChannel (FEC) 驱动程序(可在旧式 Cisco 交换机上找到)
提供聚合接口的静态平衡。支持跨快速以太网链路的流量负载平衡。支持多个物理
快速以太网链路组合为一个逻辑通道。

--alloc-method {dynamic | static}


指定将 IP 地址分配给是池成员的网络接口的方法。
以下值有效:

static 为 IP 地址池中的每个网络接口分配此池中的一个永久 IP 地址。根据可用的 IP 地


址的数量,可能不会用到某些 IP 地址。静态选项为默认设置。
dynamic 指定所有池 IP 地址必须始终分配到网络接口。支持将多个 IP 地址分配给某一个接
口。如果一个网络接口变得不可用,此选项可帮助确保已分配的 IP 地址重新分发
到另一个接口。
注: 仅当群集中有活动状态的 SmartConnect Advanced 许可证时,此选项才可
用。

--description <string>
指定 IP 地址池的可选描述。描述不能超过 128 个字节。
--ifaces < 节点接口范围 >...
指定哪些网络接口应是 IP 地址池的成员。采用以下格式指定网络接口:

<node>:<interface>

要指定节点范围,请用连字符 (-) 隔开节点 ID 上限和下限。要指定多个网络接口,请用逗号分隔每个接


口。以下示例将从节点 1、2 和 3 添加接口:

--ifaces 1-2:ext-1,3:ext-2,1:10gige-agg-1,3:10gige-1

注: 如果尝试添加已添加作为聚合接口的一部分的接口,您将收到一条错误消息。

--ranges <IP 地址范围 >...


为池指定一个或多个 IP 地址范围。这些范围内的 IP 地址将分配给池成员网络接口。
按以下格式指定 IP 地址范围:

<low-ip-address>-<high-ip-address>

--rebalance-policy{manual | auto}
指定如果以前不可用网络接口变为可用状态,何时重新分发池 IP 地址。

manual 需要在网络接口回切后手动执行连接重新平衡。
要手动重新平衡特定池中的所有 IP 地址,请运行以下命令:

isi network pools rebalance-ips

要跨群集手动重新平衡所有 IP 地址,请运行以下命令:

isi network sc-rebalance-all

auto 导致网络接口回切后自动重新平衡连接。这是默认值。

--sc-auto-unsuspend-delay <integer>
指定自动恢复的接口恢复响应节点的 SmartConnect DNS 查询之前的时间延迟(以秒为单位)。在某些
群集操作期间(如滚动升级、通用节点拆分或节点重启),节点会自动挂起,随后由系统恢复。

362 OneFS isi 命令 N 到 R


--sc-connect-policy {roundrobin | conn_count | throughput | cpu_usage}
指定如何在 IP 地址之间平衡款客户端连接的传入 DNS 查询。
以下值有效:

round-robin 通过节点均等循环连接。此值为默认策略。
conn-count 将连接分配给连接最少的节点。
throughput 将连接分配给吞吐量最低的节点。
cpu-usage 将连接分配给 CPU 使用率最低的节点。

--sc-dns-zone < 域名 >


为该池指定 SmartConnect DNS 分区名称。作为 DNS 查询对此 SmartConnect 分区的响应,将返回 IP
地址。
--sc-dns-zone-aliases < 域名 >
指定池的备用 SmartConnect DNS 分区名称的列表。可以在逗号分隔列表中指定多个别名。
--sc-failover-policy {roundrobin | conn_count | throughput | cpu_usage}
指定属于不可用接口的 IP 地址如何跨其余的网络接口重新平衡。
以下值有效:

round-robin 跨节点均匀分配 IP 地址。此为默认策略。


conn-count 将 IP 地址分配给连接最少的节点。
throughput 将 IP 地址分配给吞吐量最低的节点。
cpu-usage 将 IP 地址分配给 CPU 使用率最低的节点。

--sc-subnet <string>
指定负责处理 SmartConnect 分区的 DNS 请求的服务子网名称。
--sc-ttl <integer>
为 SmartConnect DNS 查询响应指定生存时间值(以秒为单位)。DNS 响应仅在指定的时间内有效。默
认值为 0 秒。
--static-routes < 路由 >
将某个 IP 地址指定为静态路由,然后指定目标网关。如果客户端通过静态路由 IP 地址连接,传出客户
端流量将通过指定的网关进行路由。可在逗号分隔列表中指定多个路由。
按以下无类域间路由 (CIDR) 符号格式指定静态路由:

<network-address>/<subnet-mask>-<gateway-ip-address>

[--nfsv3-rroce-only < 布尔值 >]


仅限 NFSv3 RDMA RRoCE。
{--verbose | -v}
显示更多详细信息。
{--force | -f}
强制执行命令而不显示警告。

示例
以下命令将在 groupnet0.subnet0 下创建一个名为 pool1 的新 IP 地址池,并将 IP 地址 198.51.100.10-198.51.100.20 分配给节点
1、2 和 3 上的 ext-1 网络。此池的 SmartConnect 分区名称为 storage.company.com,但它接受别名 storage.company:

isi network pools create groupnet0.subnet0.pool1 \


--ranges=192.168.8.10-192.168.8.15 --ifaces=1-3:ext-1 \
--sc-dns-zone=storage.company.com --sc-dns-zone-aliases=storage.company

OneFS isi 命令 N 到 R 363


以下命令将在 groupnet0.subnet0 下创建一个名为 pool1 的新 IP 地址池,并将 IP 地址 198.51.100.10-198.51.100.20 分配给池。此
命令还包括节点 1-3 中的聚合接口并指定 FEC 作为聚合模式:

isi network pools create groupnet0.subnet0.pool1 \


--ranges=192.168.8.10-192.168.8.15 --ifaces=1-3:10gige-agg-1 \
--aggregation-mode=fec

以下命令将在 groupnet0.subnet0 下创建一个名为 pool1 的新 IP 地址池,将 IP 地址 198.51.100.10-198.51.100.20 分配给池,并且


指定必须手动执行连接重新平衡:

isi network pools create groupnet0.subnet0.pool1 \


--ranges=192.168.8.10-192.168.8.15 --alloc-method=dynamic \
--rebalance-policy=manual

isi network pools delete


删除 IP 地址池。
删除使用中的 IP 地址池可能会阻止访问群集。将终止客户端通过已删除池中的任何 IP 地址到群集的连接。

语法
isi network pools delete <id>
[--force]
[--verbose]

选项
<id>...
指定要删除的 IP 地址池的 ID。采用以下格式指定池 ID:

<groupnet_name>.<subnet_name>.<pool_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

isi network pools list


检索群集上存在的 IP 地址池的列表。

语法
isi network pools list
[--subnet-id <string>...]
[--groupnet <string>...]
[--subnet <string>...]
[{--limit | -l} <integer>]
[--sort {aggregation_mode | alloc_method | description | id | name | rebalance_policy
| sc_auto_suspend_dealy | sc_connect_policy | sc_dns_zone | sc_failover_policy |
sc_subnet | sc_ttl}]
[{--descending | -d}]

364 OneFS isi 命令 N 到 R


[--format {table | json | csv | list}]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]

选项
如果未指定任何选项,该命令将显示群集上的所有 IP 地址池的列表。
--subnet-id < 字符串 >...
仅显示指定子网 ID 中的 IP 地址池。采用以下格式指定子网 ID:

<groupnet_name>.<subnet_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0。
--groupnet < 字符串 >...
仅显示指定 groupnet 名称中的 IP 地址池。
--subnet < 字符串 >...
仅显示含指定名称的子网中的 IP 地址池。
{ --limit | -l} < 整数 >
显示不超过指定的数量。
--sort {aggregation_mode | alloc_method | description | id | name | rebalance_policy |
sc_auto_suspend_dealy | sc_connect_policy | sc_dns_zone | sc_failover_policy | sc_subnet |
sc_ttl}
按照指定的属性对显示的输出进行排序。
{ --descending | -d}
以相反的顺序显示输出。
--format {true | table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi network pools modify


修改 IP 地址地址池设置。

语法
isi network pools modify <id>
[--access-zone <zone-name>]
[--revert-access-zone]
[--aggregation-mode {roundrobin | failover | lacp | fec}]
[--revert-aggregation-mode]
[--alloc-method {dynamic | static}]
[--revert-alloc-method]
[--description <string>]
[--clear-description]
[--ifaces <node-interface-range>]...
[--clear-ifaces]
[--add-ifaces <node-interface-range>]...

OneFS isi 命令 N 到 R 365


[--remove-ifaces <node-interface-range>]...
[--name <string>
[--ranges <ip-address-range>]...
[--clear-ranges]
[--add-ranges <ip-address-range>]...
[--remove-ranges <ip-address-range>]...
[--rebalance-policy{manual | auto}]
[--revert-rebalance-policy]
[--sc-auto-unsuspend-delay <integer>]
[--revert-sc-auto-unsuspend-delay]
[--sc-connect-policy {roundrobin | conn_count | throughput | cpu_usage}]
[--revert-sc-connect-policy]
[--sc-dns-zone <domain-name>]
[--sc-dns-zone-aliases <domain-name>]...
[--clear-sc-dns-zone-aliases]
[--add-sc-dns-zone-aliases <domain-name>]...
[--remove-sc-dns-zone-aliases <domain-name>]...
[--sc-failover-policy {roundrobin | conn_count | throughput | cpu_usage}]
[--revert-sc-failover-policy]
[--sc-subnet <string>]
[--sc-ttl <integer>]
[--revert-sc-ttl]
[--static-routes <route>]...
[--clear-static-routes]
[--add-static-routes <route>]...
[--remove-static-routes <route>]...
[--nfsv3-rroce-only <boolean>]
[--force]
[--verbose]

选项
<ID>
指定要修改的 IP 地址池的 ID。采用以下格式指定 ID:

<groupnet_name>.<subnet_name>.<pool_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0。池名称在子网中必须唯一。
--access-zone < 分区名称 >
将访问分区与池关联。仅允许客户端通过池中的 IP 地址连接到指定访问分区。访问分区必须属于与 IP
地址池相同的 groupnet。
--revert-access-zone
将 --access-zone 的值设置为系统默认值。
--aggregation-mode {roundrobin | failover | lacp | fec}
指定如何跨聚合网络接口分发传出流量。仅当有至少一个聚合网络接口是 IP 地址池成员时才应用聚合模
式。
以下值有效:

roundrobin 按先进先出的顺序通过节点循环连接,不分优先级地处理所有进程。平衡聚合链路
中所有活动端口间的出站流量,并接受任何端口上的入站流量。
failover 当主接口变得不可用时切换到下一个活动的接口。仅通过主要接口管理流量。只要
检测到通信中断,第二个接口就会立即接管第一个接口的工作。
lacp 支持 IEEE 802.3ad 链路聚合控制协议 (LACP)。基于经哈希处理的协议头信息跨接
口平衡传出流量,此信息包括源和目标地址以及 VLAN 标记(如果有)。另外,
将同速接口组合到链路聚合组 (LAG),并且跨最快的 LAG 平衡流量。此选项是新
池的默认模式。
fec 通过 Cisco Fast EtherChannel (FEC) 驱动程序(可在旧式 Cisco 交换机上找到)
提供聚合接口的静态平衡。支持跨快速以太网链路的流量负载平衡。支持多个物理
快速以太网链路组合为一个逻辑通道。

--revert-aggregation-mode

366 OneFS isi 命令 N 到 R


将 --aggregation-mode 的值设置为系统默认值。
--alloc-method {dynamic | static}
指定将 IP 地址分配给是池成员的网络接口的方法。
以下值有效:

static 为 IP 地址池中的每个网络接口分配此池中的一个永久 IP 地址。根据可用的 IP 地


址的数量,可能不会用到某些 IP 地址。静态选项为默认设置。
dynamic 指定所有池 IP 地址必须始终分配到网络接口。支持将多个 IP 地址分配给某一个接
口。如果一个网络接口变得不可用,此选项可帮助确保已分配的 IP 地址重新分发
到另一个接口。
注: 仅当群集中有活动状态的 SmartConnect Advanced 许可证时,此选项才可
用。

--revert-alloc-method
将 --alloc-method 的值设置为系统默认值。
--description <string>
指定 IP 地址池的可选描述。此选项会覆盖现有描述。描述不能超过 128 个字节。
--clear-description
清除 IP 地址池的描述。
--ifaces < 节点接口范围 >...
将网络接口添加到 IP 地址池。采用以下格式指定网络接口:

<node>:<interface>

要指定节点范围,请用连字符 (-) 隔开节点 ID 上限和下限。要指定多个网络接口,请用逗号分隔每个接


口。以下示例将从节点 1、2 和 3 添加接口:

--ifaces 1-2:ext-1,3:ext-2,1:10gige-agg-1,3:10gige-1

--clear-ifaces
从 IP 地址池中删除网络接口。
--add-ifaces < 节点接口范围 >...
将一个或多个网络接口添加到 IP 地址池。
--remove-ifaces < 节点接口范围 >...
从 IP 地址池中删除一个或多个网络接口。
--name <string>
指定 IP 地址池的新名称。此名称的最大长度为 32 个字母数字字符,可以包含下划线或连字符,但不能
包含空格或其他标点符号。新池名称在子网中必须唯一。
--ranges <IP 地址范围 >...
为池指定一个或多个 IP 地址范围。这些范围内的 IP 地址将分配给池成员网络接口。
按以下格式指定 IP 地址范围:

<low-ip-address>-<high-ip-address>

此选项会覆盖 IP 地址范围的现有列表。使用 --add-ranges 和 --remove-ranges 选项可修改现有


列表。
--clear-ranges
从池中删除所有 IP 地址范围。
--add-ranges
将一个或多个 IP 地址范围添加到池。
--remove-ranges
从池中删除一个或多个 IP 地址范围。
--rebalance-policy{manual | auto}
指定如果以前不可用网络接口变为可用状态,何时重新分发池 IP 地址。

OneFS isi 命令 N 到 R 367


manual 需要在网络接口回切后手动执行连接重新平衡。
要手动重新平衡特定池中的所有 IP 地址,请运行以下命令:

isi network pools rebalance-ips

要跨群集手动重新平衡所有 IP 地址,请运行以下命令:

isi network sc-rebalance-all

auto 导致网络接口回切后自动重新平衡连接。这是默认值。

--revert-rebalance-policy
将 --rebalance-policy 的值设置为系统默认值。
--sc-auto-unsuspend-delay <integer>
指定自动恢复的接口恢复响应节点的 SmartConnect DNS 查询之前的时间延迟(以秒为单位)。在某些
群集操作期间(如滚动升级、通用节点拆分或节点重启),节点会自动挂起,随后由系统恢复。
--revert-sc-auto-unsuspend-delay
将 --sc-auto-unsuspend-delay 的值设置为系统默认值。
--sc-connect-policy {roundrobin | conn_count | throughput | cpu_usage}
指定如何在 IP 地址之间平衡款客户端连接的传入 DNS 请求。
以下值有效:

roundrobin 通过节点均等循环连接。此值为默认策略。
conn_count 将连接分配给连接最少的节点。
throughput 将连接分配给吞吐量最低的节点。
cpu_usage 将连接分配给 CPU 使用率最低的节点。

--revert-sc-connect-policy
将 --sc-connect-policy 的值设置为系统默认值。
--sc-dns-zone < 域名 >
为该池指定 SmartConnect DNS 分区名称。作为 DNS 查询对此 SmartConnect 分区的响应,将返回 IP
地址。
--sc-dns-zone-aliases < 域名 >...
指定池的备用 SmartConnect DNS 分区名称的列表。可以在逗号分隔列表中指定多个别名。此选项会覆
盖 SmartConnect DNS 分区别名的现有列表。使用 --add-sc-dns-zone-aliases 和 --remove-
sc-dns-zone-aliases 选项可修改现有列表。
--clear-sc-dns-zone-aliases
从池中删除所有 SmartConnect 分区别名。
--add-sc-dns-zone-aliases < 域名 >...
将一个或多个 SmartConnect DNS 分区别名添加到池。
--remove-sc-dns-zone-aliases < 域名 >...
从池中删除一个或多个 SmartConnect 分区别名。
--sc-failover-policy {roundrobin | conn_count | throughput | cpu_usage}
指定属于不可用接口的 IP 地址如何跨其余的网络接口重新平衡。
以下值有效:

roundrobin 跨节点均匀分配 IP 地址。此为默认策略。


conn_count 将 IP 地址分配给连接最少的节点。
throughput 将 IP 地址分配给吞吐量最低的节点。
cpu_usage 将 IP 地址分配给 CPU 使用率最低的节点。

--revert-failover-policy
将 --sc-failover-policy 的值设置为系统默认值。

368 OneFS isi 命令 N 到 R


--sc-subnet <string>
指定负责处理 SmartConnect 分区的 DNS 请求的服务子网名称。
--sc-ttl <integer>
为 SmartConnect DNS 查询响应指定生存时间值(以秒为单位)。DNS 响应仅在指定的时间内有效。默
认值为 0 秒。
--static-routes < 路由 >...
将某个 IP 地址指定为静态路由,然后指定目标网关。如果客户端通过静态路由 IP 地址连接,传出客户
端流量将通过指定的网关进行路由。可在逗号分隔列表中指定多个路由。
按以下无类域间路由 (CIDR) 符号格式指定静态路由:

<network-address>/<subnet-mask>-<gateway-ip-address>

此选项会覆盖静态路由的现有列表。使用 --add-static-routes 和 --remove-static-routes


选项可修改现有列表。
--clear-static-routes
从池中删除静态路由。
--add-static-routes < 路由 >...
将一个或多个静态路由添加到池。
--remove-static-routes < 路由 >...
从池中删除一个或多个静态路由。
[--nfsv3-rroce-only < 布尔值 >]
仅限 NFSv3 RDMA RRoCE。
{--verbose | -v}
显示更多详细信息。
{--force | -f}
强制执行命令而不显示警告。

isi network pools rebalance-ips


跨网络接口成员重新分发指定池中的 IP 地址。针对指定手动重新平衡策略的池运行此命令。

语法
isi network pools rebalance-ips <ID>...
[--force]
[--verbose]

选项
<id>...
指定要重新平衡的 IP 地址池的名称。请采用以下格式指定池名称:

<groupnet_name>.<subnet_name>.<pool_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 N 到 R 369


isi network pools sc-resume-nodes
恢复节点上的 SmartConnect DNS 查询响应。

语法
isi network pools sc-resume-nodes <ID> <LNN>...
[--force]
[--verbose]

选项
<id>...
指定应恢复 SmartConnect DNS 查询响应的 IP 地址池的名称。请采用以下格式指定池名称:

<groupnet_id>.<subnet_name>.<pool_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0。
<lnn>...
指定应恢复 SmartConnect DNS 查询响应的节点的逻辑节点编号。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

isi network pools sc-suspend-nodes


暂停节点上的 SmartConnect DNS 查询响应。

语法
isi network pools sc-suspend-nodes <ID> <LNN>...
[--force]
[--verbose]

选项
<id>...
指定应暂停 SmartConnect DNS 查询响应的 IP 地址池的名称。请采用以下格式指定池名称:

<groupnet_name>.<subnet_name>.<pool_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为分隔符 — 例如,


groupnet0:subnet1:pool0。
<lnn>...
指定应暂停 SmartConnect DNS 查询响应的节点的逻辑节点编号。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}

370 OneFS isi 命令 N 到 R


显示更多详细信息。

isi network pools view


显示群集上特定 IP 地址池的配置详细信息。

语法
isi network pools view <id>

选项
<id>
指定要查看的 IP 地址池的 ID。采用以下格式指定池 ID:

<groupnet_name>.<subnet_name>.<pool_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0。

isi network rules create


创建资源调配规则以自动配置将添加至群集的新网络接口。

语法
isi network rules create <id> <iface>
[--desc <string>]
[--node-type {any | storage | accelerator | backup-accelerator}]
[--verbose]

选项
<ID>
指定新资源调配规则的 ID 和位置。满足规则条件的新网络接口将分配给包含规则的 IP 地址池。有效 ID
包括 groupnet、子网、池和规则名称。规则名称在整个给定 IP 地址池中必须是唯一的。采用以下格式指
定规则 ID:

<groupnet_name>.<subnet_name>.<pool_name>.<rule_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0:rule3。规则名称在池中必须唯一。
< 接口 >
指定规则适用的网络接口名称。要查看系统上的接口列表,请运行 isi network interfaces
list 命令。
--description < 字符串 >
指定资源调配规则的可选描述。描述不能超过 128 个字节。
--node-type {any | storage | accelerator | backup-accelerator}
设置要应用到指定类型的一个或多个节点的资源调配规则。默认设置为 any。
{--verbose | -v}

OneFS isi 命令 N 到 R 371


显示更多详细信息。

isi network rules delete


删除资源调配规则。

语法
isi network rules delete <ID>

选项
<id>...
指定要删除的资源调配规则的 ID。采用以下格式指定规则 ID:

<groupnet_name>.<subnet_name>.<pool_name>.<rule_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0:rule3。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

isi network rules list


检索群集上的资源调配规则列表。

语法
isi network rules list
[--pool-id <string>]
[--groupnet <string>]
[--subnet <string>]
[--pool <string>]
[{--limit | -l} <integer>]
[--sort {id | description | iface | node_type | name}]
[{--descending | -d}]
[--format {true | table | json | csv | list}]
[{--no-header | -a}]
[{--no-footer | -z}]
[--verbose]

选项
如果未指定选项,则命令将显示群集上所有资源调配规则的列表。
--pool-id < 字符串 >
仅显示指定池 ID 中的资源调配规则。采用以下格式指定池 ID:

<groupnet_name>.<subnet_name>.<pool_name>

372 OneFS isi 命令 N 到 R


如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,
groupnet0:subnet1:pool0:rule3。
--groupnet < 字符串 >
仅显示指定池 groupnet 名称中的资源调配规则。
--subnet < 字符串 >
仅显示含指定名称的子网中的资源调配规则。
--pool < 字符串 >
仅显示含指定名称的 IP 地址池中的资源调配规则。
{ --limit | -l} < 整数 >
显示不超过指定的数量。
--sort {id | description | iface | node_type | name}
按照指定的属性对显示的输出进行排序。
{ --descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下示例将显示节点上的资源调配规则列表:

isi networks list rules

系统将在输出中显示与以下示例类似的规则列表:

ID Node Type Interface


---------------------------------------------------
groupnet0.subnet0.pool0.rule0 any ext-1
groupnet3.subnet3.pool3.rule3 any ext-4
---------------------------------------------------
Total: 2

isi network rules modify


修改网络资源调配规则设置。

语法
isi network rules modify <ID>
[--description < 字符串 >]
[--clear-description ]
[--iface < 节点接口 >]
[--name < 字符串 >]
[--node-type {any | 存储 | accelerator | backup-accelerator}]
[--revert-node-type ]
[--verbose]

OneFS isi 命令 N 到 R 373


选项
<ID>
指定要修改的资源调配规则的 ID。采用以下格式指定规则 ID:

<groupnet_name>.<subnet_name>.<pool_name>.<rule_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0:rule3。
--description< 字符串 >
指定资源调配规则的可选描述。此选项会覆盖现有描述。描述不能超过 128 个字节。
--clear-description
清除资源调配规则的描述。
--iface< 节点接口 >
指定规则适用的网络接口名称。此选项会覆盖现有接口名称。
--name< 字符串 >
指定规则的新名称。新规则名称在池中必须唯一。
--node-type {any | storage | accelerator | backup-accelerator}
设置要应用到指定类型的一个或多个节点的资源调配规则。默认节点类型为 any。
--revert-node-type
将 --node-type 的值设置为系统默认值。
{--verbose | -v}
显示更多详细信息。

isi network rules view


显示群集上特定资源调配规则的配置详细信息。

语法
isi network rules view <id>

选项
<id>
指定要查看的资源调配规则的 ID。采用以下格式指定规则 ID:

<groupnet_name>.<subnet_name>.<pool_name>.<rule_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1:pool0:rule3。

isi network sc-rebalance-all


重新分发群集上所有池中的 IP 地址。
要重新分发特定池中的 IP 地址,请运行 isi network pools rebalance-ips 命令。

374 OneFS isi 命令 N 到 R


语法
isi network sc-rebalance-all
[--force]
[--verbose]

选项
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

isi network subnets create


创建网络子网。

语法
isi networks create subnet <ID> < 地址系列 > {ipv4 | ipv6} < 前缀长度 >
[--description < 字符串 >]
[--dsr-addrs <IP 地址 >]...
[--gateway <IP 地址 >]
[--gateway-priority < 整数 >]
[--mtu < 整数 >]
[--sc-service-addr <IP 地址 >]
[--vlan-enabled {true | false}]
[--vlan-id < 整数 >]
[--verbose]

选项
<ID>
指定要创建的新子网的 ID。必须将子网添加到现有 groupnet。此 ID 的最大长度为 32 个字母数字字符,
可以包含下划线或连字符,但不能包含空格或其他标点符号。采用以下格式指定子网 ID:

<groupnet_name>.<subnet_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1。子网名称在 groupnet 中必须唯一。
< 地址系列 > {ipv4 | ipv6}
指定要应用于子网的 IP 地址格式。所有子网设置和添加到子网的 IP 地址池都必须使用指定的地址格
式。创建子网后,无法修改地址系列。
< 前缀长度 >
设置子网的前缀长度。指定适用于选定地址系列的前缀长度。
--description< 字符串 >
指定子网的可选描述。描述不能超过 128 个字节。
--dsr-addrs<IP 地址 >...
为子网设置一个或多个直接服务器返回地址。如果使用将使用 DSR 地址的外部硬件负载平衡器,则需要
此参数。
--gateway<IP 地址 >
指定子网使用的网关 IP 地址。

OneFS isi 命令 N 到 R 375


注: IP 地址必须属于相应的网关。如果未分配网关或指定的 IP 地址不正确,可能会禁用与群集的通
信。

--gateway-priority< 整数 >
为子网指定网关优先级。有效值从 1 开始。较低的值具有更高的优先级。例如,优先级为 3 的网关优先
于优先级为 7 的网关。在系统上配置新网关时,将其提供当前最低优先级加 10 的默认优先级,以确保它
不优先于现有网关,直至修改优先级。
--mtu< 整数 >
设置子网的最大传输单位 (MTU)。常见值为 1500 和 9000。
注: 对网络流量使用更大的帧大小可以在客户端与群集节点之间的外部网络上实现更高效的通信。例
如,如果子网是通过 10 GbE 接口连接的,我们建议您将 MTU 设置为 9000。要获益于使用巨型
帧,网络路径中的所有设备都必须配置为使用巨型帧。

--sc-service-addr<IP 地址 >
指定 SmartConnect 模块在其上侦听此子网上的域名服务器 (DNS) 请求的 IP 地址。
--vlan-enabled {true | false}
在子网上启用或禁用 VLAN 标记。
--vlan-id< 整数 >
为子网中的所有接口指定 VLAN ID。
{--verbose | -v}
显示更多详细信息。

isi network subnets delete


删除子网。删除子网时,通过子网中的池连接到群集的客户端可能会丢失其连接。
删除使用中的子网可能会阻止访问群集。将终止客户端通过已删除子网中的 IP 地址池到群集的连接。

语法
isi network subnets delete <id>

选项
<id>...
指定要删除的子网的 ID。采用以下格式指定子网 ID:

<groupnet_name>.<subnet_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

376 OneFS isi 命令 N 到 R


isi network subnets list
显示可用子网。

语法
isi network subnets list
[--groupnet-id < 字符串 >]
[--groupnet < 字符串 >]
[{--limit | -l} < 整数 >]
[--sort {id | 名称 | addr_family | base_addr | 描述 | gateway | gateway_priority | mtu
| prefixlen | sc_service_addr | vlan_enabled | vlan_id}]
[{--descending | -d}]
[--format {true | table | json | csv | list}]
[{--no-header | -a}]
[{--no-footer | -z}]
[--verbose]

选项
如果未指定任何选项,该命令将显示群集上的所有子网的列表。
--groupnet-id< 字符串 >
仅显示指定 groupnet ID 中的子网。
--groupnet< 字符串 >
仅显示指定 groupnet ID 中的子网。
{ --limit | -l} < 整数 >
显示不超过指定的数量。
--sort {id | description | iface | node_type | name}
按照指定的属性对显示的输出进行排序。
{ --descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将显示所有子网的列表:

isi networks list subnets

系统将显示与以下示例类似的输出:

ID Subnet Gateway|Prio Pools SC Service


--------------------------------------------------------------
groupnet0.subnet0 10.7.135.0/24 10.7.135.1|10 pool0 0.0.0.0
groupnet3.subnet3 10.7.136.0/24 0.0.0.0|20 pool3 0.0.0.0

OneFS isi 命令 N 到 R 377


--------------------------------------------------------------
Total: 2

isi network subnets modify


修改网络子网设置。

语法

isi network subnets modify <id>


[--description <string>|--clear-description]
[--dsr-addrs <ip_address>|--clear-dsr-addrs
| --add-dsr-addrs <ip_address>|--remove-dsr-addrs
<ip_address>]
[--revert-dsr-address]
[--gateway <ip-address>]
[--gateway-priority <integer>]
[--mtu <integer>]
[--revert-mtu]
[--prefixlen <prefixlen>]
[--name <string>]
[--sc-service-addr <ip_address_range>
| --clear-sc-service-addrs|--add-sc-service-addrs
<ip_address_range> | --remove-sc-service-addrs <ip_address_range>]
[--sc-service-name <domain_name>]
[--vlan-enabled <boolean>
[--revert-vlan-enabled]
[--vlan-id <integer>]
[{--force | -f}]
[{--verbose | -v}]
[{--help| -h}]

选项
<ID>
指定要修改的子网的 ID。子网 ID 由 <groupnet_id>,后跟一个“:”,后跟子网名称组成。子网名称在整个
群集中必须唯一,并且最长可为 32 个字符。支持的字符为 [a-zA-Z0-9-_]。如果子网处于默认 groupnet
中,则 <groupnet_id> 和“:”可能会被省略。

A subnet in a groupnet: "example_groupnet:example_subnet"


A subnet in the default groupnet: "example_subnet"

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1。
--description < 字符串 >
指定子网的可选描述。描述不能超过 128 个字节。
--clear-description
清除子网的描述。
--dsr-addrs <IP 地址 >...
指定使用直接服务器返回 (DSR) 的 IP 地址列表。您需要为每个额外 IP 地址指定 --dsr-addrs。
--clear-dsr-addrs
清除使用直接服务器返回的 IP 地址列表。
--add-dsr-addrs <IP 地址 >...
将项目添加至使用直接服务器返回的 IP 地址列表。您需要为要添加的每个额外的 IP 地址指定 --add-
dsr-addrs。

378 OneFS isi 命令 N 到 R


--remove-dsr-addrs <IP 地址 >...
从使用直接服务器返回的 IP 地址列表中删除项目。您需要为要删除的每个额外的 IP 地址指定 --
remove-dsr-addrs。
--revert-dsr-addrs
将 --dsr-addrs 的值设置为系统默认值。
--gateway <IP 地址 >
指定子网使用的网关 IP 地址。
--gateway-priority < 整数 >
指定子网网关的优先级,其中最低编号为最高优先级。
--mtu < 整数 >
设置群集在网络通信中使用的子网的最大传输单元 (MTU) 的大小。
--revert-mtu
将 --mtu 的值设置为系统默认值。
--prefixlen <iprefixlen>
设置子网的前缀长度。
--name < 字符串 >
指定子网的名称。
--sc-service-addrs <IP 地址范围 >...
指定子网中将接收传入 DNS 请求的 IP 地址范围。您需要为每个额外 IP 地址指定 --sc-service-
addrs。
--clear-sc-service-addrs
清除 SmartConnect 服务 IP 地址列表。
--add-sc-service-addrs <IP 地址范围 >...
将项目添加至 SmartConnect 服务 IP 地址列表。您需要为要添加的每个额外的 IP 地址指定 --add-sc-
service-addrs。
--remove-sc-service-addrs <IP 地址范围 >...
从 SmartConnect 服务 IP 地址列表中删除项目。您需要为要删除的每个额外的 IP 地址指定 --remove-
sc-service-addrs。
--sc-service-name < 域名 >
指定与 SmartConnect 服务 IP 地址对应的域名。
--vlan-enabled < 布尔值 >
启用子网上的 VLAN 标记。
--revert-vlan-enabled
将 --vlan-enabled 的值设置为系统默认值。
--vlan-id < 整数 >
为此子网上的所有接口指定 VLAN ID。
{--force | -f }
禁止显示可能会在子网修改操作之前或修改期间显示的任何提示或警告消息。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

OneFS isi 命令 N 到 R 379


isi network subnets view
显示群集上特定子网的配置详细信息。

语法
isi network subnets view <id>

选项
<id>
指定要查看的子网的 ID。采用以下格式指定子网 ID:

<groupnet_name>.<subnet_name>

如果引用默认 groupnet0,groupnet 名称为可选。冒号也可接受作为组件名称之间的分隔符 — 例如,


groupnet0:subnet1。

isi nfs aliases create


创建 NFS 别名。

语法
isi nfs aliases create < 名称 > < 路径 >
[--zone < 字符串 >]
[--force]
[--verbose]

选项
< 名称 >
别名的名称。别名格式必须是 Unix 根目录,单个正斜杠后跟名称。例如,/home。
< 路径 >
别名链接到的 OneFS 目录路径名称。路径名称必须是访问分区根目录下的绝对路径。例如,/ifs/
data/ugroup1/home。
--zone
别名有效的访问分区。
{--force | -f}
强制创建别名,不要求确认。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将在 ugroup1 分区中创建别名:

isi nfs aliases create /home /ifs/data/ugroup1/home


--zone ugroup1

380 OneFS isi 命令 N 到 R


isi nfs aliases delete
删除 NFS 别名。

语法
isi nfs aliases delete < 名称 >
[--zone < 字符串 >]
[--force]
[--verbose]

选项
< 名称 >
要删除的别名的名称。
--zone< 字符串 >
别名有效的访问分区。
{--force | -f}
强制删除别名,不要求确认。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将从 ugroup1 分区中删除别名。

isi nfs aliases delete /projects --zone ugroup1

isi nfs aliases list


列出当前访问分区中可用的 NFS 别名。

语法
isi nfs aliases list
[--check]
[--zone < 字符串 >]
[--limit < 整数 >]
[--sort {zone | 名称 | path | health]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

选项
--check
对于当前分区,将显示别名及其运行状况的列表。
--zone< 字符串 >

OneFS isi 命令 N 到 R 381


别名有效的访问分区。
{--limit | -l} < 整数 >
显示不超过指定数量的 NFS 别名。
--sort {zone | name | path | health}
指定作为排序依据的字段。
{--descending | -d}
指定按降序排列数据。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。

示例
以下命令将显示 ugroup1 分区中的别名表,其中包括其运行状况。

isi nfs aliases list --zone ugroup1 --check

此命令的输出与以下示例类似:

Zone Name Path Health


--------------------------------------------------------
ugroup1 /home /ifs/data/offices/newyork good
ugroup1 /root_alias /ifs/data/offices good
ugroup1 /project /ifs/data/offices/project good
--------------------------------------------------------
Total: 3

isi nfs aliases modify


修改别名的名称、分区或绝对路径。

语法
isi nfs aliases modify < 别名 >
[--zone < 字符串 >]
[--new-zone < 字符串 >]
[--name < 字符串 >]
[--path < 路径 >]
[--force]
[--verbose]

选项
< 别名 >
别名的当前名称,例如 /home。
--zone< 字符串 >
别名当前有效的访问分区。
--new-zone< 字符串 >

382 OneFS isi 命令 N 到 R


别名将会有效的新访问分区。
--name< 字符串 >
别名的新名称。
--path< 路径 >
别名应链接到的新 OneFS 目录路径名称。路径名称必须是访问分区根目录下的绝对路径。例如,/ifs/
data/ugroup2/home。
{--force | -f}
强制修改别名,不要求确认。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将修改现有别名的分区、名称和路径:

isi nfs aliases modify /home --name /users --zone ugroup1 --new-zone ugroup2
--path /ifs/data/ugroup2/users

isi nfs aliases view


显示有关当前分区中别名的信息。

语法
isi nfs aliases view < 名称 >
[--zone < 字符串 >]
[--check]

选项
< 名称 >
别名的名称。
--zone< 字符串 >
别名有效的访问分区。
--check
包括别名的运行状况。

示例
以下命令将显示当前分区中别名 /projects 的信息表,其中包括运行状况。

isi nfs aliases view /projects --check

OneFS isi 命令 N 到 R 383


isi nfs exports check
检查 NFS 导出是否存在配置错误,包括有冲突的导出规则、故障路径、无法解析的主机名和无法解析的网络组。

语法

isi nfs exports check


[--limit < 整数 >]
[--zone < 字符串 >
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--ignore-unresolvable-hosts]
[--ignore-bad-paths]
[--ignore-bad-auth]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定数量的 NFS 导出。
--zone< 字符串 >
指定创建导出时所在的访问分区。
[--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
--ignore-unresolvale-hosts
创建或修改导出时不会呈现无法解析的主机上的错误状况。
--ignore-bad-paths
创建或修改导出时不会呈现错误路径上的错误状况。
--ignore-bad-auth
创建或修改导出时将忽略映射选项的错误身份认证。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将检查 Zone-1 分区中的导出:

isi nfs exports check --zone Zone-1

如果检查表明无问题,将返回空表。但只要找到问题,即返回与下面类似的显示内容:

ID Message
---------------------------------------
3 '/ifs/data/project' does not exist
---------------------------------------
Total: 1

384 OneFS isi 命令 N 到 R


isi nfs exports create
创建 NFS 导出。

注: 要查看创建导出时要应用的默认 NFS 导出设置,请运行 isi nfs settings export view 命令。

语法
isi nfs exports create <paths>
[--block-size <size>]
[--can-set-time {yes | no}]
[--case-insensitive {yes | no}]
[--case-preserving {yes | no}]
[--chown-restricted {yes | no}]
[--directory-transfer-size <size>]
[--link-max <integer>]
[--max-file-size <size>]
[--name-max-size <integer>]
[--no-truncate {yes | no}]
[--return-32bit-file-ids {yes | no}]
[--symlinks {yes | no}]
[--zone <string>]
[--clients <client>]
[--description <string>]
[--root-clients <client>]
[--read-write-clients <client>]
[--read-only-clients <client>]
[--all-dirs {yes | no}]
[--encoding <string>]
[--security-flavors {unix | krb5 | krb5i | krb5p}]
[--snapshot <snapshot>]
[--map-lookup-uid {yes | no}]
[--map-retry {yes | no}]
[--map-root-enabled {yes | no}]
[--map-non-root-enabled {yes | no}]
[--map-failure-enabled {yes | no}]
[--map-all <identity>]
[--map-root <identity>]
[--map-non-root <identity>]
[--map-failure <identity>]
[--map-full {yes | no}]
[--commit-asynchronous {yes | no}]
[--read-only {yes | no}]
[--readdirplus {yes | no}]
[--read-transfer-max-size <size>]
[--read-transfer-multiple <integer>]
[--read-transfer-size <size>]
[--setattr-asynchronous {yes | no}]
[--time-delta <time delta>]
[--write-datasync-action {datasync | filesync |unstable}]
[--write-datasync-reply {datasync | filesync}]
[--write-filesync-action {datasync | filesync |unstable}]
[--write-filesync-reply filesync]
[--write-unstable-action {datasync | filesync |unstable}]
[--write-unstable-reply {datasync | filesync |unstable}]
[--write-transfer-max-size <size>]
[--write-transfer-multiple <integer>]
[--write-transfer-size <size>]
[--ignore-unresolvable-hosts]
[--ignore-bad-paths]
[--ignore-bad-auth]
[--ignore-conflicts]
[--force]
[--verbose]

OneFS isi 命令 N 到 R 385


选项
< 路径 > ...
必需。从 /ifs 开头,指定要导出的路径。通过重复此选项,可以指定多个路径。
--block-size< 大小 >
指定数据块大小(以字节为单位)。
--can-set-time {yes | no}
如果设置为 yes,将支持导出设置时间。默认设置为 no。
--case-insensitive {yes | no}
如果设置为 yes,服务器将报告它会忽略文件名的大小写。默认设置为 no。
--case-preserving {yes | no}
如果设置为 yes,服务器将报告它始终会保留文件名的大小写。默认设置为 no。
--chown-restricted {yes | no}
如果设置为 yes,服务器将报告仅超级用户可更改文件所有权。默认设置为 no。
--directory-transfer-size< 大小 >
指定首选目录传输大小。有效值是后面跟区分大小写的测量单位的数字:b 表示字节;K 表示 KB;M 表
示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字节。最大值为 4294967295b。初始默
认值为 128K。
--link-max< 整数 >
已报告的到某文件的最大链接数。
--max-file-size< 大小 >
指定服务器上允许的最大文件大小(以字节为单位)。如果文件大于指定值,将返回错误。
--name-max-size< 整数 >
已报告的文件名最大字符长度。
--no-truncate {yes | no}
如果设置为 yes,文件名称太长将导致错误,而不是被截断。
--return-32bit-file-ids {yes | no}
适用于 NFSv3 和 NFSv4。如果设置为 yes,会将从 readdir 返回的文件标识符的大小限制为 32 位值。
默认值为 no。
注: 提供此设置的目的是确保与早期 NFS 客户端的向后兼容性,仅应在必要时启用。

--symlinks {yes | no}


如果设置为 yes,则建议支持符号链接。默认设置为 no。
--zone< 字符串 >
应该应用导出的访问分区。默认分区为 system。
--clients< 客户端 >
指定允许通过该导出进行访问的客户端。以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户
端。可以通过重复此选项来添加多个客户端。
注: 此选项将代替整个客户端列表。要向列表添加客户端或从中删除客户端,请指定 --add-
clients 或 --remove-clients。

--description< 字符串 >


此 NFS 导出的描述。
--root-clients< 客户端 >
允许指定客户端的 root 用户以群集的 root 用户身份执行操作。此选项将覆盖指定客户端的 --map-all
和 --map-root 选项。
以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户端。您可以在逗号分隔列表中指定多个客
户端。
--read-write-clients< 客户端 >
针对此导出授予对指定客户端的读/写权限。此选项将覆盖指定客户端的 --read-only 选项。

386 OneFS isi 命令 N 到 R


以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户端。您可以在逗号分隔列表中指定多个客
户端。
--read-only-clients< 客户端 >
针对此导出使指定客户端成为只读客户端。此选项将覆盖指定客户端的 --read-only 选项。
以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户端。您可以在逗号分隔列表中指定多个客
户端。
--all-dirs {yes | no}
如果设置为 yes,此导出将涵盖所有目录。默认设置为 no。
--encoding< 字符串 >
指定通过此 NFS 导出连接的客户端的字符编码。
下表提供了有效值及其对应的字符编码。这些值取自节点的 /etc/encodings.xml 文件,不区分大小
写。

值 编码
cp932 Windows-SJIS
cp949 Windows-949
cp1252 Windows-1252
euc-kr EUC-KR
euc-jp EUC-JP
euc-jp-ms EUC-JP-MS
utf-8-mac UTF-8-MAC
utf-8 UTF-8
iso-8859-1 ISO-8859-1 (Latin-1)
iso-8859-2 ISO-8859-2 (Latin-2)
iso-8859-3 ISO-8859-3 (Latin-3)
iso-8859-4 ISO-8859-4 (Latin-4)
iso-8859-5 ISO-8859-5 (Cyrillic)
iso-8859-6 ISO-8859-6 (Arabic)
iso-8859-7 ISO-8859-7 (Greek)
iso-8859-8 ISO-8859-8 (Hebrew)
iso-8859-9 ISO-8859-9 (Latin-5)
iso-8859-10 ISO-8859-10 (Latin-6)
iso-8859-13 ISO-8859-13 (Latin-7)
iso-8859- 14 ISO-8859-14 (Latin-8)
iso-8859-15 ISO-8859-15 (Latin-9)
iso-8859-16 ISO-8859-16 (Latin-10)

--security-flavors {unix | krb5 | krb5i | krb5p}


指定支持的安全方式。要支持多种安全方式,请针对每个额外的条目重复此选项。以下值有效:

unix UNIX(系统)身份认证。
krb5 Kerberos V5 身份认证。
krb5i Kerberos V5 完整性身份认证。
krb5p Kerberos V5 隐私身份认证。

--snapshot {< 快照 > | < 快照别名 >}

OneFS isi 命令 N 到 R 387


指定要导出的快照或快照别名的 ID。如果指定此选项,将在指定的快照或由指定的快照别名引用的快照
中捕获的状态下导出目录。如果快照未捕获导出路径,用户将无法访问导出。
如果指定了快照别名,然后将该别名修改为引用新的快照,新快照将自动应用到导出。
由于快照是只读的,客户端将无法通过导出修改数据,除非指定引用文件系统的实时版本的快照别名
ID。
指定 < 快照 > 或 < 快照别名 > 作为快照或快照别名的 ID 或名称。
--map-lookup-uid {yes | no}
如果设置为 yes,则将从本地查找传入的 UNIX 用户标识符 (UID)。默认设置为 no。
--map-retry {yes | no}
如果设置为 yes,系统将重试失败的用户映射查找。默认设置为 no。
--map-root-enabled {yes | no}
启用/禁用将传入的 Root 用户映射到特定帐户。
--map-non-root-enabled {yes | no}
启用/禁用将传入的非 Root 用户映射到特定帐户。
--map-failure-enabled {yes | no}
启用/禁用在身份查找失败后将用户映射到特定帐户。
--map-all< 身份 >
指定将由任意用户执行的操作的默认身份。如果未将此选项设置为 root,则可以允许特定客户端的
root 用户作为群集的 root 用户执行操作,方法是将该客户端包括在 --root-clients 列表中。
--map-root< 身份 >
将传入的 Root 用户映射到特定用户和/或组 ID。
--map-non-root< 身份 >
将非 Root 用户映射到特定用户和/或组 ID。
--map-failure< 身份 >
在身份尝试失败后将用户映射到特定用户和/或组 ID。
--map-full {yes | no}
确定在导出选项(如 --map-root 或 --map-all)中指定用户的情况下如何完成用户映射。启用时,
用户映射将查询 OneFS 用户数据库并且从适用的身份认证子系统(如本地身份认证或 Active
Directory)中检索用户。禁用时,只查询本地身份认证。
默认设置为 yes。
--commit-asynchronous {yes | no}
如果设置为 yes,将支持异步执行提交数据操作。默认设置为 no
--read-only {yes | no}
确定访问导出的所有客户端的默认权限。
如果设置为 yes,则可以通过将该客户端包括在 --read-write-clients 列表中来授予对特定客户
端的读/写权限。
如果设置为 no,则可以通过将该客户端包括在 --read-only-clients 列表中来使特定客户端成为只
读客户端。默认设置为 no。
--readdirplus {yes | no}
仅适用于 NFSv3。如果设置为 yes,将支持处理 readdir-plus 请求。默认设置为 yes。
--read-transfer-max-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的最大读取传输大小。有效值是后面跟区分大小写的测量单位的
数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字
节。最大值为 4294967295b。初始默认值为 1M。
--read-transfer-multiple< 整数 >
指定要向 NFSv3 和 NFSv4 客户端报告的建议多读大小。有效值为 0-4294967295。初始默认值为
512。
--read-transfer-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选读取传输大小。有效值是后面跟区分大小写的测量单位的
数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字

388 OneFS isi 命令 N 到 R


节。最大值是 4294967295b;如果 --read-transfer-max-size 设置为更小的值,最大值也会更
小。初始默认值为 128K。
--setattr-asynchronous {yes | no}
如果设置为 yes,将异步执行设置属性操作。默认设置为 no。
--time-delta< 浮点数 >
指定服务器时间粒度(以秒为单位)。
--write-datasync-action {datasync | filesync | unstable}
仅适用于 NFSv3 和 NFSv4。指定备选数据同步写入方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 datasync,将执行指定的请求。
--write-datasync-reply {datasync | filesync}
仅适用于 NFSv3 和 NFSv4。指定备选数据同步回复方法。以下值有效:
● datasync
● filesync
默认值为 datasync(不会单独响应)。
--write-filesync-action {datasync | filesync | unstable}
仅适用于 NFSv3 和 NFSv4。指定备选文件同步写入方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 filesync,将执行指定的请求。
--write-filesync-reply {filesync}
仅适用于 NFSv3 和 NFSv4。指定备选文件同步回复方法。唯一有效值为 filesync(不会单独响
应)。
--write-unstable-action {datasync | filesync | unstable}
指定备选不稳定写入方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 unstable,将执行指定的请求。
--write-unstable-reply {datasync | filesync | unstable}
指定备选不稳定回复方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 unstable(不会单独响应)。
--write-transfer-max-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选最大写入传输大小。有效值是后面跟区分大小写的测量单
位的数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使
用字节。最大值为 4294967295b。初始默认值为 1M。
--write-transfer-multiple< 整数 >
指定要向 NFSv3 和 NFSv4 客户端报告的建议写入传输乘数。有效值为 0-4294967295。初始默认值为
512。
--write-transfer-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选写入传输大小。有效值是后面跟区分大小写的测量单位的
数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字
节。最大值是 4294967295b;如果 --write-transfer-max-size 设置为更小的值,最大值也会
更小。初始默认值为 512K。
--ignore-unresolvale-hosts
创建或修改导出时不会呈现无法解析的主机上的错误状况。

OneFS isi 命令 N 到 R 389


--ignore-bad-paths
创建或修改导出时不会呈现错误路径上的错误状况。
--ignore-bad-auth
创建或修改导出时将忽略映射选项的错误身份认证。
--ignore-conflicts
将忽略新的或修改过的导出和现有配置之间的冲突。
{--force | -f}
如果设置为 no(默认值),运行命令时将显示确认提示。如果设置为 yes,命令执行时不会显示确认提
示。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将创建特定分区和客户端组的 NFS 导出:

isi nfs exports create /ifs/data/ugroup1/home


--description 'Access to home dirs for user group 1'
--zone ugroup1 --clients 10.1.28.1 --clients 10.1.28.2

以下命令将创建具有多个目录路径和自定义安全性类型 (Kerberos 5) 的 NFS 导出:

isi nfs exports create /ifs/data/projects /ifs/data/templates


--security-flavors krb5

isi nfs exports delete


删除 NFS 导出。

语法
isi nfs exports delete <ID>
[--zone < 字符串 >]
[--force]
[--verbose]

选项
<ID>
指定要删除的 NFS 导出的 ID。您可以使用 isi nfs exports list 命令查看当前分区中的导出及其
ID 的列表。
--zone< 字符串 >
指定创建导出时所在的访问分区。默认值为当前分区。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示更多详细信息。

390 OneFS isi 命令 N 到 R


isi nfs exports list
显示 NFS 导出列表。

语法

isi nfs exports list


[--zone < 字符串 >
[--limit < 整数 >]
[--sort < 字段 >]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--zone< 字符串 >
指定创建导出时所在的访问分区的名称。
{--limit | -l} < 整数 >
显示不超过指定数量的 NFS 导出。
--sort< 字段 >
指定作为排序依据的字段。有效值如下:
● id
● zone
● paths
● description
● clients
● root_clients
● read_only_clients
● read_write_clients
● unresolved_clients
● all_dirs
● block_size
● can_set_time
● commit_asynchronous
● directory_transfer_size
● encoding
● map_lookup_uid
● map_retry
● map_all
● map_root
● map_full

OneFS isi 命令 N 到 R 391


● max_file_size
● read_only
● readdirplus
● return_32bit_file_ids
● read_transfer_max_size
● read_transfer_multiple
● read_transfer_size
● security_flavors
● setattr_asynchronous
● symlinks
● time_delta
● write_datasync_action
● write_datasync_reply
● write_filesync_action
● write_filesync_reply
● write_unstable_action
● write_unstable_reply
● write_transfer_max_size
● write_transfer_multiple
● write_transfer_size

--descending
指定按降序排列数据。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下命令默认列出当前分区中的 NFS 导出:

isi nfs exports list

以下命令会列出特定分区中的 NFS 导出:

isi nfs exports list --zone hq-home

392 OneFS isi 命令 N 到 R


isi nfs exports modify
修改 NFS 导出。

注: 您可运行 isi nfs settings export view 命令查看导出的完整默认设置列表。

语法
isi nfs exports modify <id>
[--block-size <size>]
[--revert-block-size]
[--can-set-time {yes | no}]
[--revert-can-set-time]
[--case-insensitive {yes | no}]
[--revert-case-insensitive]
[--case-preserving {yes | no}]
[--revert-case-preserving]
[--chown-restricted {yes | no}]
[--revert-chown-restricted]
[--directory-transfer-size <size>]
[--revert-directory-transfer-size]
[--link-max <integer>]
[--revert-link-max]
[--max-file-size <size>]
[--revert-max-file-size]
[--name-max-size <integer>]
[--revert-name-max-size]
[--no-truncate {yes | no}]
[--revert-no-truncate]
[--return-32bit-file-ids {yes | no}]
[--revert-return-32bit-file-ids]
[--symlinks {yes | no}]
[--revert-symlinks]
[--new-zone <string>]
[--description <string>]
[--paths <path>]
[--clear-paths]
[--add-paths <string>]
[--remove-paths <string>]
[--clients <string>]
[--clear-clients]
[--add-clients <string>]
[--remove-clients <string>]
[--root-clients <string>]
[--clear-root-clients]
[--add-root-clients <string>]
[--remove-root-clients <string>]
[--read-write-clients <string>]
[--clear-read-write-clients]
[--add-read-write-clients <string>]
[--remove-read-write-clients <string>]
[--read-only-clients <string>]
[--clear-read-only-clients]
[--add-read-only-clients <string>]
[--remove-read-only-clients <string>]
[--all-dirs {yes | no}]
[--revert-all-dirs]
[--encoding <string>]
[--revert-encoding]
[--security-flavors {unix | krb5 | krb5i | krb5p}]
[--revert-security-flavors]
[--clear-security-flavors]
[--add-security-flavors {unix | krb5 | krb5i | krb5p}]
[--remove-security-flavors <string>]
[--snapshot <snapshot>]
[--revert-snapshot]
[--map-lookup-uid {yes | no}]
[--revert-map-lookup-uid]

OneFS isi 命令 N 到 R 393


[--map-retry {yes | no}]
[--revert-map-retry]
[--map-root-enabled {yes | no}]
[--revert-map-root-enabled]
[--map-non-root-enabled {yes | no}]
[--revert-map-non-root-enabled]
[--map-failure-enabled {yes | no}]
[--revert-map-failure-enabled]
[--map-all <identity>]
[--revert-map-all]
[--map-root <identity>]
[--revert-map-root]
[--map-non-root <identity>]
[--revert-map-non-root]
[--map-failure <identity>]
[--revert-map-failure]
[--map-full {yes | no}]
[--revert-map-full]
[--commit-asynchronous {yes | no}]
[--revert-commit-asynchronous]
[--read-only {yes | no}]
[--revert-read-only]
[--readdirplus {yes | no}]
[--revert-readdirplus]
[--read-transfer-max-size <size>]
[--revert-read-transfer-max-size]
[--read-transfer-multiple <integer>]
[--revert-read-transfer-multiple]
[--read-transfer-size <size>]
[--revert-read-transfer-size]
[--setattr-asynchronous {yes | no}]
[--revert-setattr-asynchronous]
[--time-delta <time delta>]
[--revert-time-delta]
[--write-datasync-action {datasync | filesync |unstable}]
[--revert-write-datasync-action]
[--write-datasync-reply {datasync | filesync}]
[--revert-write-datasync-reply]
[--write-filesync-action {datasync | filesync |unstable}]
[--revert-write-filesync-action]
[--write-filesync-reply filesync]
[--write-unstable-action {datasync | filesync |unstable}]
[--revert-write-unstable-action]
[--write-unstable-reply {datasync | filesync |unstable}]
[--revert-write-unstable-reply]
[--write-transfer-max-size <size>]
[--revert-write-transfer-max-size]
[--write-transfer-multiple <integer>]
[--revert-write-transfer-multiple]
[--write-transfer-size <size>]
[--revert-write-transfer-size]
[--zone <string>]
[--ignore-unresolvable-hosts]
[--ignore-bad-paths]
[--ignore-bad-auth]
[--ignore-conflicts]
[--force]
[--verbose]

选项
<ID>
导出 ID 号。您可以使用 isi nfs exports list 命令查看当前访问分区中的所有导出及其 ID 号。
--block-size< 大小 >
指定数据块大小(以字节为单位)。
--revert-block-size
将此设置还原为系统默认值。

394 OneFS isi 命令 N 到 R


--can-set-time {yes | no}
如果设置为 yes,将支持导出设置时间。默认设置为 no。
--revert-can-set-time
将此设置还原为系统默认值。
--case-insensitive {yes | no}
如果设置为 yes,服务器将报告它会忽略文件名的大小写。默认设置为 no。
--revert-case-insensitive
将此设置还原为系统默认值。
--case-preserving {yes | no}
如果设置为 yes,服务器将报告它始终会保留文件名的大小写。默认设置为 no。
--revert-case-preserving
将此设置还原为系统默认值。
--chown-restricted {yes | no}
如果设置为 yes,服务器将报告仅超级用户可更改文件所有权。默认设置为 no。
--revert-chown-restricted
将此设置还原为系统默认值。
--directory-transfer-size< 大小 >
指定首选目录传输大小。有效值是后面跟区分大小写的测量单位的数字:b 表示字节;K 表示 KB;M 表
示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字节。最大值为 4294967295b。初始默
认值为 128K。
--revert-directory-transfer-size
将此设置还原为系统默认值。
--link-max< 整数 >
已报告的到某文件的最大链接数。
--revert-link-max
将此设置还原为系统默认值。
--max-file-size< 大小 >
指定服务器上允许的最大文件大小(以字节为单位)。如果文件大于指定值,将返回错误。
--revert-max-file-size
将此设置还原为系统默认值。
--name-max-size< 整数 >
已报告的文件名最大字符长度。
--revert-name-max-size
将此设置还原为系统默认值。
--no-truncate {yes | no}
如果设置为 yes,文件名称太长将导致错误,而不是被截断。
--revert-no-truncate
将此设置还原为系统默认值。
--return-32bit-file-ids {yes | no}
适用于 NFSv3 及更高版本。如果设置为 yes,会将从 readdir 返回的文件标识符的大小限制为 32 位
值。默认值为 no。
注: 提供此设置的目的是确保与早期 NFS 客户端的向后兼容性,仅应在必要时启用。

--revert-return-32bit-file-ids
将此设置还原为系统默认值。
--symlinks {yes | no}
如果设置为 yes,则建议支持符号链接。默认设置为 no。
--revert-symlinks
将此设置还原为系统默认值。
--new-zone< 字符串 >

OneFS isi 命令 N 到 R 395


指定应该应用导出的新访问分区。默认分区为 system。
--description< 字符串 >
此 NFS 导出的描述。
--paths< 路径 > ...
必需。从 /ifs 开头,指定要导出的路径。通过重复此选项,可以指定多个路径。
--clear-paths
清除原来为此导出指定的任何路径。此路径必须在 /ifs 目录中。
--add-paths< 路径 > ...
添加到原来为此导出指定的路径。此路径必须在 /ifs 中。通过重复此选项,可以指定多个路径。
--remove-paths< 路径 > ...
删除原来为此导出指定的其中一个路径。此路径必须在 /ifs 中。通过重复此选项,可以指定多个要删
除的路径。
--clients< 字符串 >
指定允许通过该导出进行访问的客户端。以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户
端。可以通过重复此选项来添加多个客户端。
--clear-clients
清除原来有权通过此导出访问的完整客户端列表。
--add-clients< 字符串 >
指定要添加到有权通过此导出访问的客户端列表的客户端。以 IPv4 或 IPv6 地址、主机名、网络组或
CIDR 范围指定要添加的客户端。可以通过重复此选项来添加多个客户端。
--remove-clients< 字符串 >
指定要从有权通过此导出访问的客户端列表中删除的客户端。以 IPv4 或 IPv6 地址、主机名、网络组或
CIDR 范围指定要删除的客户端。通过重复此选项,可以删除多个客户端。
--root-clients< 字符串 >
允许指定客户端的 root 用户以群集的 root 用户身份执行操作。此选项将覆盖指定客户端的 --map-all
和 --map-root 选项。
以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户端。您可以在逗号分隔列表中指定多个客
户端。
--clear-root-clients
清除原来有权通过此导出访问的完整 Root 客户端列表。
--add-root-clients< 字符串 >
指定要添加到有权通过此导出访问的 Root 客户端列表的 Root 客户端。以 IPv4 或 IPv6 地址、主机名、
网络组或 CIDR 范围指定要添加的 root 客户端。通过重复此选项,可以添加多个 Root 客户端。
--remove-root-clients< 字符串 >
指定要从有权通过此导出访问的 Root 客户端列表中删除的 Root 客户端。以 IPv4 或 IPv6 地址、主机
名、网络组或 CIDR 范围指定要删除的 root 客户端。通过重复此选项,可以删除多个 Root 客户端。
--read-write-clients< 字符串 >
针对此导出授予对指定客户端的读/写权限。此选项将覆盖指定客户端的 --read-only 选项。
以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户端。您可以在逗号分隔列表中指定多个客
户端。
--clear-read-write-clients
清除原来有权通过此导出访问的完整读写客户端列表。
--add-read-write-clients< 字符串 >
指定要添加到有权通过此导出访问的读写客户端列表的读写客户端。以 IPv4 或 IPv6 地址、主机名、网
络组或 CIDR 范围指定要添加的读写客户端。通过重复此选项,可以添加多个读写客户端。
--remove-read-write-clients< 字符串 >
指定要从有权通过此导出访问的读写客户端列表中删除的读写客户端。以 IPv4 或 IPv6 地址、主机名、
网络组或 CIDR 范围指定要删除的读写客户端。通过重复此选项,可以删除多个读写客户端。
--read-only-clients< 字符串 >
针对此导出使指定客户端成为只读客户端。此选项将覆盖指定客户端的 --read-only 选项。

396 OneFS isi 命令 N 到 R


以 IPv4 或 IPv6 地址、主机名、网络组或 CIDR 范围指定客户端。您可以在逗号分隔列表中指定多个客
户端。
--clear-read-only-clients
清除原来有权通过此导出访问的完整只读客户端列表。
--add-read-only-clients< 字符串 >
指定要添加到有权通过此导出访问的只读客户端列表的只读客户端。以 IPv4 或 IPv6 地址、主机名、网
络组或 CIDR 范围指定要添加的只读客户端。通过重复此选项,可以添加多个只读客户端。
--remove-read-only-clients< 字符串 >
指定要从有权通过此导出访问的只读客户端列表中删除的只读客户端。以 IPv4 或 IPv6 地址、主机名、
网络组或 CIDR 范围指定要删除的只读客户端。通过重复此选项,可以删除多个只读客户端。
--all-dirs {yes | no}
如果设置为 yes,此导出将涵盖所有目录。默认设置为 no。
--revert-all-dirs
将此设置还原为系统默认值。
--encoding< 字符串 >
指定通过此 NFS 导出连接的客户端的字符编码。
下表提供了有效值及其对应的字符编码。这些值取自节点的 /etc/encodings.xml 文件,不区分大小
写。

值 编码
cp932 Windows-SJIS
cp949 Windows-949
cp1252 Windows-1252
euc-kr EUC-KR
euc-jp EUC-JP
euc-jp-ms EUC-JP-MS
utf-8-mac UTF-8-MAC
utf-8 UTF-8
iso-8859-1 ISO-8859-1 (Latin-1)
iso-8859-2 ISO-8859-2 (Latin-2)
iso-8859-3 ISO-8859-3 (Latin-3)
iso-8859-4 ISO-8859-4 (Latin-4)
iso-8859-5 ISO-8859-5 (Cyrillic)
iso-8859-6 ISO-8859-6 (Arabic)
iso-8859-7 ISO-8859-7 (Greek)
iso-8859-8 ISO-8859-8 (Hebrew)
iso-8859-9 ISO-8859-9 (Latin-5)
iso-8859-10 ISO-8859-10 (Latin-6)
iso-8859-13 ISO-8859-13 (Latin-7)
iso-8859- 14 ISO-8859-14 (Latin-8)
iso-8859-15 ISO-8859-15 (Latin-9)
iso-8859-16 ISO-8859-16 (Latin-10)

--revert-encoding
将此设置还原为系统默认值。

OneFS isi 命令 N 到 R 397


--security-flavors {unix | krb5 | krb5i | krb5p}
指定支持的安全方式。要支持多种安全方式,请针对每个额外的条目重复此选项。以下值有效:

unix UNIX(系统)身份认证。
krb5 Kerberos V5 身份认证。
krb5i Kerberos V5 完整性身份认证。
krb5p Kerberos V5 隐私身份认证。

--revert-security-flavors
将此设置还原为系统默认值。
--clear-security-flavors
清除支持的安全方式的值。
--add-security-flavors {unix | krb5 | krb5i | krb5p}
添加支持的安全方式。为每个要添加的附加受支持安全方式重复此过程。
--remove-security-flavors
删除支持的安全方式。为每个要从列表中删除的附加受支持安全方式重复此过程。
--snapshot {< 快照 > | < 快照别名 >}
指定要导出的快照或快照别名的 ID。如果指定此选项,将在指定的快照或由指定的快照别名引用的快照
中捕获的状态下导出目录。如果快照未捕获导出路径,用户将无法访问导出。
如果指定了快照别名,然后将该别名修改为引用新的快照,新快照将自动应用到导出。
由于快照是只读的,客户端将无法通过导出修改数据,除非指定引用文件系统的实时版本的快照别名
ID。
指定 < 快照 > 或 < 快照别名 > 作为快照或快照别名的 ID 或名称。
--revert-snapshot
将此设置还原为系统默认值。
--map-lookup-uid {yes | no}
如果设置为 yes,则将从本地查找传入的 UNIX 用户标识符 (UID)。默认设置为 no。
--revert-map-lookup-uid
将此设置还原为系统默认值。
--map-retry {yes | no}
如果设置为 yes,系统将重试失败的用户映射查找。默认设置为 no。
--revert-map-retry
将此设置还原为系统默认值。
--map-root-enabled {yes | no}
启用/禁用将传入的 Root 用户映射到特定帐户。
--revert-map-root-enabled
将此设置还原为系统默认值。
--map-non-root-enabled {yes | no}
启用/禁用将传入的非 Root 用户映射到特定帐户。
--revert-map-non-root-enabled
将此设置还原为系统默认值。
--map-failure-enabled {yes | no}
启用/禁用在身份查找失败后将用户映射到特定帐户。
--revert-map-failure-enabled
将此设置还原为系统默认值。
--map-all< 身份 >
指定将由任意用户执行的操作的默认身份。如果未将此选项设置为 root,则可以允许特定客户端的
root 用户作为群集的 root 用户执行操作,方法是将该客户端包括在 --root-clients 列表中。
--revert-map-all
将此设置还原为系统默认值。

398 OneFS isi 命令 N 到 R


--map-root< 身份 >
将传入的 Root 用户映射到特定用户和/或组 ID。
--revert-map-root
将此设置还原为系统默认值。
--map-non-root< 身份 >
将非 Root 用户映射到特定用户和/或组 ID。
--revert-map-non-root
将此设置还原为系统默认值。
--map-failure< 身份 >
在身份尝试失败后将用户映射到特定用户和/或组 ID。
--revert-map-failure
将此设置还原为系统默认值。
--map-full {yes | no}
确定在导出选项(如 --map-root 或 --map-all)中指定用户的情况下如何完成用户映射。启用时,
用户映射将查询 OneFS 用户数据库并且从适用的身份认证子系统(如本地身份认证或 Active
Directory)中检索用户。禁用时,只查询本地身份认证。
默认设置为 yes。
--revert-map-full
将 --map-full 设置还原为系统默认值 yes。
--commit-asynchronous {yes | no}
如果设置为 yes,将支持异步执行提交数据操作。默认设置为 no
--revert-commit-asynchronous
将此设置还原为系统默认值。
--read-only {yes | no}
确定访问导出的所有客户端的默认权限。
如果设置为 yes,则可以通过将该客户端包括在 --read-write-clients 列表中来授予对特定客户
端的读/写权限。
如果设置为 no,则可以通过将该客户端包括在 --read-only-clients 列表中来使特定客户端成为只
读客户端。默认设置为 no。
--revert-read-only
将此设置还原为系统默认值。
--readdirplus {yes | no}
仅适用于 NFSv3。如果设置为 yes,将支持处理 readdir-plus 请求。默认设置为 yes。
--revert-readdirplus
将此设置还原为系统默认值。
--read-transfer-max-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的最大读取传输大小。有效值是后面跟区分大小写的测量单位的
数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字
节。最大值为 4294967295b。初始默认值为 1M。
--revert-read-transfer-max-size
将此设置还原为系统默认值。
--read-transfer-multiple< 整数 >
指定要向 NFSv3 和 NFSv4 客户端报告的建议多读大小。有效值为 0-4294967295。初始默认值为
512。
--revert-read-transfer-multiple
将此设置还原为系统默认值。
--read-transfer-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选读取传输大小。有效值是后面跟区分大小写的测量单位的
数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字
节。最大值是 4294967295b;如果 --read-transfer-max-size 设置为更小的值,最大值也会更
小。初始默认值为 128K。

OneFS isi 命令 N 到 R 399


--revert-read-transfer-size
将此设置还原为系统默认值。
--setattr-asynchronous {yes | no}
如果设置为 yes,将异步执行设置属性操作。默认设置为 no。
--revert-setattr-asynchronous
将此设置还原为系统默认值。
--time-delta< 浮点数 >
指定服务器时间粒度(以秒为单位)。
--revert-time-delta
将此设置还原为系统默认值。
--write-datasync-action {datasync | filesync | unstable}
仅适用于 NFSv3 和 NFSv4。指定备选数据同步写入方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 datasync,将执行指定的请求。
--revert-write-datasync-action
将此设置还原为系统默认值。
--write-datasync-reply {datasync | filesync}
仅适用于 NFSv3 和 NFSv4。指定备选数据同步回复方法。以下值有效:
● datasync
● filesync
默认值为 datasync(不会单独响应)。
--revert-write-datasync-reply
将此设置还原为系统默认值。
--write-filesync-action {datasync | filesync | unstable}
仅适用于 NFSv3 和 NFSv4。指定备选文件同步写入方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 filesync,将执行指定的请求。
--revert-write-filesync-action
将此设置还原为系统默认值。
--write-filesync-reply {filesync}
仅适用于 NFSv3 和 NFSv4。指定备选文件同步回复方法。唯一有效值为 filesync(不会单独响
应)。
--write-unstable-action {datasync | filesync | unstable}
指定备选不稳定写入方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 unstable,将执行指定的请求。
--revert-write-unstable-action
将此设置还原为系统默认值。
--write-unstable-reply {datasync | filesync | unstable}
指定备选不稳定回复方法。以下值有效:
● datasync
● filesync
● unstable
默认值为 unstable(不会单独响应)。

400 OneFS isi 命令 N 到 R


--revert-write-unstable-reply
将此设置还原为系统默认值。
--write-transfer-max-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选最大写入传输大小。有效值是后面跟区分大小写的测量单
位的数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使
用字节。最大值为 4294967295b。初始默认值为 1M。
--revert-write-transfer-max-size
将此设置还原为系统默认值。
--write-transfer-multiple< 整数 >
指定要向 NFSv3 和 NFSv4 客户端报告的建议写入传输乘数。有效值为 0-4294967295。初始默认值为
512。
--revert-write-transfer-multiple
将此设置还原为系统默认值。
--write-transfer-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选写入传输大小。有效值是后面跟区分大小写的测量单位的
数字:b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。如果未指定单位,默认情况下将使用字
节。最大值是 4294967295b;如果 --write-transfer-max-size 设置为更小的值,最大值也会
更小。初始默认值为 512K。
--revert-write-transfer-size
将此设置还原为系统默认值。
--zone
初始创建导出时所在的访问分区。
--ignore-unresolvale-hosts
创建或修改导出时不会呈现无法解析的主机上的错误状况。
--ignore-bad-paths
创建或修改导出时不会呈现错误路径上的错误状况。
--ignore-bad-auth
创建或修改导出时将忽略映射选项的错误身份认证。
--ignore-conflicts
将忽略新的或修改过的导出和现有配置之间的冲突。
{--force | -f}
如果设置为 no(默认值),运行命令时将显示确认提示。如果设置为 yes,命令执行时不会显示确认提
示。
{--verbose | -v}
显示更多详细信息。

isi nfs exports reload


重新加载 NFS 导出配置。

语法
isi nfs exports reload
[--zone <string>

选项
--zone
要重新加载的导出的访问分区。

OneFS isi 命令 N 到 R 401


isi nfs exports view
查看 NFS 导出。

语法
isi nfs exports view <ID>
[--zone < 字符串 >]

选项
<ID>
指定要显示的 NFS 导出的 ID。如果您不知道 ID,请使用 isi nfs exports list 命令查看导出及其
关联 ID 的列表。
--zone< 字符串 >
指定创建导出时所在的访问分区的名称。

isi nfs log-level modify


设置的 NFS 服务的日志记录级别。

语法
isi nfs log-level modify <level>
[--verbose]

选项
< 级别 >
有效日志记录级别包括:

日志级别 描述
always 指定将所有 NFS 事件记录到 NFS 日志文件中。
error 指定仅将 NFS 错误情况记录到 NFS 日志文件中。
warning 指定仅将 NFS 警告情况记录到 NFS 日志文件中。
info 指定仅将 NFS 信息情况记录到 NFS 日志文件中。
verbose 指定详细日志记录。
debug 添加有助于我们解决问题的信息
trace 添加有助于我们查明问题的跟踪信息

{--verbose | -v}
显示更多详细信息。

402 OneFS isi 命令 N 到 R


isi nfs log-level view
显示 NFS 服务的日志记录级别。

语法
isi nfs log-level view

选项
此命令没有选项。

isi nfs netgroup check


更新 NFS 网络组缓存。

语法
isi nfs netgroup check
[--host < 字符串 >]
[--verbose]

选项
--host< 字符串 >
要检查的节点的 IPv4 或 IPv6 地址。默认值为 localhost IP 地址。
{--verbose | -v}
显示更多详细信息。

isi nfs netgroup flush


刷新 NFS 网络组缓存。

语法
isi nfs netgroup flush
[--host < 字符串 >]
[--verbose]

选项
--host< 字符串 >
要刷新的节点的 IPv4 或 IPv6 地址。如果未指定节点,将刷新所有节点(默认值)。
{verbose | -v}
显示更多详细信息。

OneFS isi 命令 N 到 R 403


isi nfs netgroup modify
修改 NFS 网络组缓存设置。

语法
isi nfs netgroup modify
[--bgwrite < 持续时间 >]
[--expiration < 持续时间 >]
[--lifetime < 持续时间 >]
[--retry < 持续时间 >]
[--verbose]

选项
注: 在以下选项定义中,将整数格式的持续时间表示为 [YMWDHms]。

{bgwrite | -w} < 持续时间 >


设置磁盘备份间隔。
{expiration | -e} < 持续时间 >
设置网络组到期时间。
{lifetime | -i} < 持续时间 >
设置网络组生命周期。
{retry | -r} < 持续时间 >
设置重试间隔。
{verbose | -v}
显示更多详细信息。

isi nfs nlm locks list


仅适用于 NFSv3。显示 NFS 网络锁定管理器 (NLM) 建议锁定的列表。

语法
isi nfs nlm locks list
[--limit < 整数 >]
[--sort {客户端 | path | lock_type | range | created}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定数量的 NFS nlm 锁定。
--sort {client | path | lock_type | range | created}
指定作为排序依据的字段。
{--descending | -d}

404 OneFS isi 命令 N 到 R


指定按降序排列数据。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
要查看所有当前 NLM 锁定的详细列表,请运行以下命令:

isi nfs nlm locks list --verbose

在以下示例输出中,当前有三个锁定:/ifs/home/test1/file.txt 上一个,/ifs/home/test2/file.txt 上两个。

Client Path Lock Type Range


------------------------ ------------------------ --------- ------
machineName/10.72.134.119 /ifs/home/test1/file.txt exclusive [0, 2]
machineName/10.59.166.125 /ifs/home/test2/file.txt shared [10, 20]
machineName/10.63.119.205 /ifs/home/test2/file.txt shared [10, 20]

isi nfs nlm locks waiters


显示等待在当前锁定的文件上放置网络锁定管理器 (NLM) 锁的客户端列表。此命令仅适用于 NFSv3。

语法
isi nfs nlm locks waiters
[--limit < 整数 >]
[--sort {客户端 | path | lock_type | range | created}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l}< 整数 >
显示不超过指定数量的 NLM 锁。
--sort {client | path | lock_type | range | created}
指定作为排序依据的字段。
--descending
指定按降序排列数据。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}

OneFS isi 命令 N 到 R 405


显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
以下命令显示等待锁定当前锁定文件的客户端的详细列表:

isi nfs nlm locks waiters --verbose

系统将显示与以下示例类似的输出:

Client Path Lock Type Range


--------------------- ------------------------ --------- ------
machineName/1.2.34.5 /ifs/home/test1/file.txt exclusive [0, 2]

isi nfs nlm sessions check


搜索丢失锁。

语法
isi nfs nlm sessions check
[--cluster-ip < 字符串 >]
[--zone < 字符串 >]

选项
--cluster-ip< 字符串 >
客户端连接到的群集 IP 地址。
--zone< 字符串 >
客户端连接到的访问分区。

isi nfs nlm sessions delete


删除与 NFS 网络锁定管理器 (NLM) 连接关联的所有状态。

语法
isi nfs nlm sessions delete < 主机名 > < 群集 IP>
[--zone < 字符串 >]
[--force]
[--verbose]

选项
< 主机名 >
启动会话的客户端的名称。
< 群集 IP>

406 OneFS isi 命令 N 到 R


客户端连接到的群集 IP 地址。
--zone< 字符串 >
客户端连接到的访问分区。
{force | -f}
跳过确认提示。
{verbose | -v}
显示更多详细信息。

isi nfs nlm sessions list


显示拥有 NFS 网络锁定管理器 (NLM) 锁的客户端列表。此命令仅适用于 NFSv3。

语法
isi nfs nlm sessions list
[--limit < 整数 >]
[--sort {ID | 客户端}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
要显示的 NFS NLM 会话数。
--sort {hostname | cluster_ip | is_active | notify_attempts_remaining}
指定作为排序依据的字段。
{--descending | -d}
指定按降序排列数据。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
要查看活动 NLM 会话的列表,请运行以下命令:

isi nfs nlm sessions list

OneFS isi 命令 N 到 R 407


isi nfs nlm sessions refresh
刷新 NFS 网络锁定管理器 (NLM) 客户端。

语法
isi nfs nlm sessions refresh < 主机名 > < 群集 IP>
[--zone < 字符串 >]
[--force]
[--verbose]

选项
< 主机名 >
启动会话的客户端的名称。
< 群集 IP>
客户端连接到的群集 IP 地址。
--zone< 字符串 >
客户端连接到的访问分区。
{--force | -f}
跳过确认提示。
{--verbose | -v}
显示更多详细信息。

isi nfs nlm sessions view


显示有关 NFS 网络锁定管理器 (NLM) 客户端连接的信息。

语法
isi nfs nlm sessions view < 主机名 >
[--cluster-ip < 字符串 >]
[--zone < 字符串 >]
[--limit < 整数 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
< 主机名 >
启动会话的客户端的名称。
--cluster-ip< 字符串 >
客户端连接到的群集 IP 地址。
--zone< 字符串 >
客户端连接到的访问分区。
{--limit | -l} < 整数 >
显示不超过指定数量的 NFS nlm 锁定。

408 OneFS isi 命令 N 到 R


--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi nfs settings export modify


修改创建 NFS 导出时应用的默认设置。

注: 可以通过运行 isi nfs settings export view 命令查看当前配置的默认 NFS 导出设置。

语法
isi nfs exports modify <ID>
[--block-size <size>]
[--revert-block-size]
[--can-set-time {yes|no}]
[--revert-can-set-time]
[--case-insensitive {yes|no}]
[--revert-case-insensitive]
[--case-preserving {yes|no}]
[--revert-case-preserving]
[--chown-restricted {yes|no}]
[--revert-chown-restricted]
[--directory-transfer-size <size>]
[--revert-directory-transfer-size]
[--link-max <integer>]
[--revert-link-max]
[--max-file-size <size>]
[--revert-max-file-size]
[--name-max-size <integer>]
[--revert-name-max-size]
[--no-truncate {yes|no}]
[--revert-no-truncate]
[--return-32bit-file-ids {yes|no}]
[--revert-return-32bit-file-ids]
[--symlinks {yes|no}]
[--revert-symlinks]
[--all-dirs {yes|no}]
[--revert-all-dirs]
[--encoding <string>]
[--revert-encoding]
[--security-flavors {unix|krb5|krb5i|krb5p}]
[--revert-security-flavors]
[--clear-security-flavors]
[--add-security-flavors {unix|krb5|krb5i|krb5p}]
[--remove-security-flavors <string>]
[--snapshot <snapshot>]
[--revert-snapshot]
[--map-lookup-uid {yes|no}]
[--revert-map-lookup-uid]
[--map-retry {yes|no}]
[--revert-map-retry]
[--map-root-enabled {yes|no}]
[--revert-map-root-enabled]
[--map-non-root-enabled {yes|no}]
[--revert-map-non-root-enabled]
[--map-failure-enabled {yes|no}]

OneFS isi 命令 N 到 R 409


[--revert-map-failure-enabled]
[--map-all <identity>]
[--revert-map-all]
[--map-root <identity>]
[--revert-map-root]
[--map-non-root <identity>]
[--revert-map-non-root]
[--map-failure <identity>]
[--revert-map-failure]
[--map-full {yes|no}]
[--revert-map-full]
[--commit-asynchronous {yes|no}]
[--revert-commit-asynchronous]
[--read-only {yes|no}]
[--revert-read-only]
[--readdirplus {yes|no}]
[--revert-readdirplus]
[--read-transfer-max-size <size>]
[--revert-read-transfer-max-size]
[--read-transfer-multiple <integer>]
[--revert-read-transfer-multiple]
[--read-transfer-size <size>]
[--revert-read-transfer-size]
[--setattr-asynchronous {yes|no}]
[--revert-setattr-asynchronous]
[--time-delta <integer>]
[--revert-time-delta]
[--write-datasync-action {datasync|filesync|unstable}]
[--revert-write-datasync-action]
[--write-datasync-reply {datasync|filesync}]
[--revert-write-datasync-reply]
[--write-filesync-action {datasync|filesync|unstable}]
[--revert-write-filesync-action]
[--write-filesync-reply filesync]
[--write-unstable-action {datasync|filesync|unstable}]
[--revert-write-unstable-action]
[--write-unstable-reply {datasync|filesync|unstable}]
[--revert-write-unstable-reply]
[--write-transfer-max-size <size>]
[--revert-write-transfer-max-size]
[--write-transfer-multiple <integer>]
[--revert-write-transfer-multiple]
[--write-transfer-size <size>]
[--revert-write-transfer-size]
[--zone <string>]
[--force]
[--verbose]

选项
--block-size< 大小 >
指定数据块大小(以字节为单位)。
--revert-block-size
将此设置还原为系统默认值。
--can-set-time {yes|no}
如果设置为 yes,将支持导出设置时间。 默认设置为 no。
--revert-can-set-time
将此设置还原为系统默认值。
--case-insensitive {yes|no}
如果设置为 yes,服务器将报告它会忽略文件名的大小写。 默认设置为 no。
--revert-case-insensitive
将此设置还原为系统默认值。
--case-preserving {yes|no}
如果设置为 yes,服务器将报告它始终会保留文件名的大小写。 默认设置为 no。

410 OneFS isi 命令 N 到 R


--revert-case-preserving
将此设置还原为系统默认值。
--chown-restricted {yes|no}
如果设置为 yes,服务器将报告仅超级用户可更改文件所有权。 默认设置为 no。
--revert-chown-restricted
将此设置还原为系统默认值。
--directory-transfer-size< 大小 >
指定首选目录传输大小。 有效值是后面跟区分大小写的测量单位的数字: b 表示字节;K 表示 KB;M
表示 MB;或者 G 表示 GB。 如果未指定单位,默认情况下将使用字节。 最大值为 4294967295b。初
始默认值为 128K。
--revert-directory-transfer-size
将此设置还原为系统默认值。
--link-max< 整数 >
已报告的到某文件的最大链接数。
--revert-link-max
将此设置还原为系统默认值。
--max-file-size< 大小 >
指定服务器上允许的最大文件大小(以字节为单位)。 如果文件大于指定值,将返回错误。
--revert-max-file-size
将此设置还原为系统默认值。
--name-max-size< 整数 >
已报告的文件名最大字符长度。
--revert-name-max-size
将此设置还原为系统默认值。
--no-truncate {yes|no}
如果设置为 yes,文件名称太长将导致错误,而不是被截断。
--revert-no-truncate
将此设置还原为系统默认值。
--return-32bit-file-ids {yes|no}
适用于 NFSv3 及更高版本。 如果设置为 yes,会将从 readdir 返回的文件标识符的大小限制为 32 位
值。 默认值为 no。
注: 提供此设置的目的是确保与早期 NFS 客户端的向后兼容性,仅应在必要时启用。

--revert-return-32bit-file-ids
将此设置还原为系统默认值。
--symlinks {yes|no}
如果设置为 yes,则建议支持符号链接。 默认设置为 no。
--revert-symlinks
将此设置还原为系统默认值。
--new-zone< 字符串 >
指定应该应用导出的新访问分区。 默认分区为 system。
--all-dirs {yes|yesno}
如果设置为 yes,此导出将涵盖所有目录。 默认设置为 no。
--revert-all-dirs
将此设置还原为系统默认值。
--encoding< 字符串 >
指定通过此 NFS 导出连接的客户端的字符编码。
下表提供了有效值及其对应的字符编码。 这些值取自节点的 /etc/encodings.xml 文件,不区分大
小写。

OneFS isi 命令 N 到 R 411


值 编码
cp932 Windows-SJIS
cp949 Windows-949
cp1252 Windows-1252
euc-kr EUC-KR
euc-jp EUC-JP
euc-jp-ms EUC-JP-MS
utf-8-mac UTF-8-MAC
utf-8 UTF-8
iso-8859-1 ISO-8859-1 (Latin-1)
iso-8859-2 ISO-8859-2 (Latin-2)
iso-8859-3 ISO-8859-3 (Latin-3)
iso-8859-4 ISO-8859-4 (Latin-4)
iso-8859-5 ISO-8859-5 (Cyrillic)
iso-8859-6 ISO-8859-6 (Arabic)
iso-8859-7 ISO-8859-7 (Greek)
iso-8859-8 ISO-8859-8 (Hebrew)
iso-8859-9 ISO-8859-9 (Latin-5)
iso-8859-10 ISO-8859-10 (Latin-6)
iso-8859-13 ISO-8859-13 (Latin-7)
iso-8859- 14 ISO-8859-14 (Latin-8)
iso-8859-15 ISO-8859-15 (Latin-9)
iso-8859-16 ISO-8859-16 (Latin-10)

--revert-encoding
将此设置还原为系统默认值。
--security-flavors {unix|krb5|krb5i|krb5p} ...
指定支持的安全方式。 要支持多种安全方式,请针对每个额外的条目重复此选项。 以下值有效:

sys Sys 或 UNIX 身份认证。


krb5 Kerberos V5 身份认证。
krb5i Kerberos V5 完整性身份认证。
krb5p Kerberos V5 隐私身份认证。

--revert-security-flavors
将此设置还原为系统默认值。
--snapshot {< 快照 >|< 快照别名 >}
指定要导出的快照或快照别名的 ID。 如果指定此选项,将在指定的快照或由指定的快照别名引用的快照
中捕获的状态下导出目录。 如果快照未捕获导出路径,用户将无法访问导出。
如果指定了快照别名,然后将该别名修改为引用新的快照,新快照将自动应用到导出。
由于快照是只读的,客户端将无法通过导出修改数据,除非指定引用文件系统的实时版本的快照别名
ID。
指定 < 快照 > 或 < 快照别名 > 作为快照或快照别名的 ID 或名称。
--revert-snapshot
将此设置还原为系统默认值。

412 OneFS isi 命令 N 到 R


--map-lookup-uid {yes|no}
如果设置为 yes,则将从本地查找传入的 UNIX 用户标识符 (UID)。 默认设置为 no。
--revert-map-lookup-uid
将此设置还原为系统默认值。
--map-retry {yes|no}
如果设置为 yes,系统将重试失败的用户映射查找。 默认设置为 no。
--revert-map-retry
将此设置还原为系统默认值。
--map-root-enabled {yes|no}
启用/禁用将传入的 Root 用户映射到特定帐户。
--revert-map-root-enabled
将此设置还原为系统默认值。
--map-non-root-enabled {yes|no}
启用/禁用将传入的非 Root 用户映射到特定帐户。
--revert-map-non-root-enabled
将此设置还原为系统默认值。
--map-failure-enabled {yes|no}
启用/禁用在身份查找失败后将用户映射到特定帐户。
--revert-map-failure-enabled
将此设置还原为系统默认值。
--map-all< 身份 >
指定任意用户执行操作时所使用的默认身份。 如果未将此选项设置为 root,您可以允许特定客户端的
root 用户作为群集的 root 用户执行操作,方法是将该客户端包括在 --root-clients 列表中。
--revert-map-all
将此设置还原为系统默认值。
--map-root< 身份 >
将传入的 Root 用户映射到特定用户和/或组 ID。
--revert-map-root
将此设置还原为系统默认值。
--map-non-root< 身份 >
将非 Root 用户映射到特定用户和/或组 ID。
--revert-map-non-root
将此设置还原为系统默认值。
--map-failure< 身份 >
在身份尝试失败后将用户映射到特定用户和/或组 ID。
--revert-map-failure
将此设置还原为系统默认值。
--map-full {yes|no}
确定在导出选项(如 --map-root 或 --map-all)中指定用户的情况下如何完成用户映射。启用时,
用户映射将查询 OneFS 用户数据库并且从适用的身份认证子系统(如本地身份认证或 Active
Directory)中检索用户。 禁用时,只查询本地身份认证。
默认设置为 yes。
--revert-map-full
将 --map-full 设置还原为系统默认值 yes。
--commit-asynchronous {yes|no}
如果设置为 yes,将支持异步执行提交数据操作。 默认设置为 no
--revert-commit-asynchronous
将此设置还原为系统默认值。
--read-only {yes|no}

OneFS isi 命令 N 到 R 413


确定访问导出的所有客户端的默认权限。
如果设置为 yes,则可以通过将该客户端包括在 --read-write-clients 列表中来授予对特定客户
端的读/写权限。
如果设置为 no,则可以通过将该客户端包括在 --read-only-clients 列表中来使特定客户端成为只
读客户端。 默认设置为 no。
--revert-read-only
将此设置还原为系统默认值。
--readdirplus {yes|no}
仅适用于 NFSv3。 如果设置为 yes,将支持处理 readdir-plus 请求。 默认设置为 no。
--revert-readdirplus
将此设置还原为系统默认值。
--read-transfer-max-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的最大读取传输大小。 有效值是后面跟区分大小写的测量单位的
数字: b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。 如果未指定单位,默认情况下将使用字
节。 最大值为 4294967295b。初始默认值为 512K。
--revert-read-transfer-max-size
将此设置还原为系统默认值。
--read-transfer-multiple< 整数 >
指定要向 NFSv3 和 NFSv4 客户端报告的建议多读大小。 有效值为 0-4294967295。 初始默认值为
512。
--revert-read-transfer-multiple
将此设置还原为系统默认值。
--read-transfer-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选读取传输大小。 有效值是后面跟区分大小写的测量单位的
数字: b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。 如果未指定单位,默认情况下将使用字
节。 最大值为 4294967295b。初始默认值为 128K。
--revert-read-transfer-size
将此设置还原为系统默认值。
--setattr-asynchronous {yes|no}
如果设置为 yes,将异步执行设置属性操作。 默认设置为 no。
--revert-setattr-asynchronous
将此设置还原为系统默认值。
--time-delta< 整数 >
指定服务器时间粒度(以秒为单位)。
--revert-time-delta
将此设置还原为系统默认值。
--write-datasync-action {datasync|filesync|unstable}
仅适用于 NFSv3 和 NFSv4。 指定备选数据同步写入方法。 以下值有效:
● datasync
● filesync
● unstable
默认值为 datasync,将执行指定的请求。
--revert-write-datasync-action
将此设置还原为系统默认值。
--write-datasync-reply {datasync|filesync}
仅适用于 NFSv3 和 NFSv4。 指定备选数据同步回复方法。 以下值有效:
● datasync
● filesync
默认值为 datasync(不会单独响应)。
--revert-write-datasync-reply

414 OneFS isi 命令 N 到 R


将此设置还原为系统默认值。
--write-filesync-action {datasync|filesync|unstable}
仅适用于 NFSv3 和 NFSv4。 指定备选文件同步写入方法。 以下值有效:
● datasync
● filesync
● unstable
默认值为 filesync,将执行指定的请求。
--revert-write-filesync-action
将此设置还原为系统默认值。
--write-filesync-reply {filesync}
仅适用于 NFSv3 和 NFSv4。 指定备选文件同步回复方法。 唯一有效值为 filesync(不会单独响
应)。
--write-unstable-action {datasync|filesync|unstable}
指定备选不稳定写入方法。 以下值有效:
● datasync
● filesync
● unstable
默认值为 unstable,将执行指定的请求。
--revert-write-unstable-action
将此设置还原为系统默认值。
--write-unstable-reply {datasync|filesync|unstable}
指定备选不稳定回复方法。 以下值有效:
● datasync
● filesync
● unstable
默认值为 unstable(不会单独响应)。
--revert-write-unstable-reply
将此设置还原为系统默认值。
--write-transfer-max-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选读取传输大小。 有效值是后面跟区分大小写的测量单位的
数字: b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。 如果未指定单位,默认情况下将使用字
节。 最大值为 4294967295b。初始默认值为 512K。
--revert-write-transfer-max-size
将此设置还原为系统默认值。
--write-transfer-multiple< 整数 >
指定要向 NFSv3 和 NFSv4 客户端报告的建议写入传输乘数。 有效值是 0–4294967295。 初始默认值
为 512。
--revert-write-transfer-multiple
将此设置还原为系统默认值。
--write-transfer-size< 大小 >
指定要向 NFSv3 和 NFSv4 客户端报告的首选读取传输大小。 有效值是后面跟区分大小写的测量单位的
数字: b 表示字节;K 表示 KB;M 表示 MB;或者 G 表示 GB。 如果未指定单位,默认情况下将使用字
节。 最大值为 4294967295b。初始默认值为 512K。
--revert-write-transfer-size
将此设置还原为系统默认值。
--zone
初始创建导出时所在的访问分区。
--force
如果设置为 no(默认值),运行命令时将显示确认提示。 如果设置为 yes,命令运行时不会显示确认
提示。
--verbose

OneFS isi 命令 N 到 R 415


显示更多详细信息。

isi nfs settings export view


显示默认 NFS 导出设置。

语法
isi nfs settings export view
[--zone <string>]

选项
--zone< 字符串 >
指定应用默认设置的访问分区。

示例
要查看当前配置的默认导出设置,请运行以下命令:

isi nfs settings export view

系统将显示与以下示例类似的输出:

Read Write Clients: -


Unresolved Clients: -
All Dirs: No
Block Size: 8.0K
Can Set Time: Yes
Case Insensitive: No
Case Preserving: Yes
Chown Restricted: No
Commit Asynchronous: No
Directory Transfer Size: 128.0K
Encoding: DEFAULT
Link Max: 32767
Map Lookup UID: No
Map Retry: Yes
Map Root
Enabled: True
User: nobody
Primary Group: -
Secondary Groups: -
Map Non Root
Enabled: False
User: nobody
Primary Group: -
Secondary Groups: -
Map Failure
Enabled: False
User: nobody
Primary Group: -
Secondary Groups: -
Map Full: Yes
Max File Size: 8192.00000P
Name Max Size: 255
No Truncate: No
Read Only: No
Readdirplus: Yes
Return 32Bit File Ids: No
Read Transfer Max Size: 1.00M
Read Transfer Multiple: 512

416 OneFS isi 命令 N 到 R


Read Transfer Size: 128.0K
Security Type: unix
Setattr Asynchronous: No
Snapshot: -
Symlinks: Yes
Time Delta: 1.0 ns
Write Datasync Action: datasync
Write Datasync Reply: datasync
Write Filesync Action: filesync
Write Filesync Reply: filesync
Write Unstable Action: unstable
Write Unstable Reply: unstable
Write Transfer Max Size: 1.00M
Write Transfer Multiple: 512
Write Transfer Size: 512.0K

isi nfs settings global modify


修改默认 NFS 全局设置。

语法
isi nfs settings global modify
[--nfsv3-enabled <boolean>]
[--nfsv3-rdma-enabled <boolean>]
[--nfsv4-enabled <boolean>]
[--nfsv40-enabled <boolean>]
[--nfsv41-enabled <boolean>]
[--nfsv42-enabled <boolean>]
[--rquota-enabled <boolean>]
[{--force | -f}]
[{--verbose | -v}]

选项
[--nfsv3-enabled < 布尔值 >]
启用或禁用 NFS 协议的版本 3。
[--nfsv3-rdma-enabled < 布尔值 >]
为 NFSv3 协议启用或禁用 RDMA 功能。
[--nfsv4-enabled < 布尔值 >]
启用或禁用 NFSv4 协议的所有可用版本。
[--nfsv40-enabled < 布尔值 >]
启用或禁用 NFSv4 协议的次要版本 0。
[--nfsv41-enabled < 布尔值 >]
启用或禁用 NFSv4 协议和 NFSv4 协议的次要版本 1。
[--nfsv42-enabled < 布尔值 >]
启用或禁用 NFSv4 协议和 NFSv4 协议的次要版本 2。
[--rquota-enabled < 布尔值 >]
启用或禁用 rquota 协议。
[{--force | -f}]
运行命令,而不要求确认。
[{--verbose | -v}]
显示此命令的详细信息。

OneFS isi 命令 N 到 R 417


isi nfs settings global view
显示 NFS 设置的全局选项。

语法
isi nfs settings global view

选项
此命令没有选项。

示例
下面是使用此命令生成的报告示例:

NFS Service Enabled: No


[The following settings are ignored if NFS Service Enabled = No]
NFSv3 Enabled: Yes
NFSv3 RDMA Enabled: No
NFSv4 Enabled: No
v4.0 Enabled: No
v4.1 Enabled: No
v4.2 Enabled: No
Rquota Enabled: No

isi nfs settings zone modify


修改 NFSv4 ID 映射程序的默认 NFS 分区设置。

语法
isi nfs settings zone modify
[--nfsv4-domain < 字符串 >]
[--revert-nfsv4-domain]
[--nfsv4-replace-domain {yes | no}]
[--revert-nfsv4-replace-domain]
[--nfsv4-no-domain {yes | no}]
[--revert-nfsv4-no-domain]
[--nfsv4-no-domain-uids {yes | no}]
[--revert-nfsv4-no-domain-uids]
[--nfsv4-no-names {yes | no}]
[--revert-nfsv4-no-names]
[--nfsv4-allow-numeric-ids {yes | no}]
[--revert-nfsv4-allow-numeric-ids]
[--zone < 字符串 >]
[--verbose]

选项
--nfsv4-domain< 字符串 >
指定 NFSv4 域名。
--revert-nfsv4-domain
将 --nfsv4-domain 设置还原为系统默认值 (localhost)。

418 OneFS isi 命令 N 到 R


--nfsv4-replace-domain {yes | no}
将所有者/组域替换为 NFSv4 域名。
--revert-nfsv4-replace-domain
将设置还原为系统默认值。默认值为 yes。
--nfsv4-no-domain {yes | no}
发送没有 NFSv4 域名的所有者/组。
--revert-nfsv4-no-domain
将设置还原为系统默认值。默认值为 no。
--nfsv4-no-domain-uids {yes | no}
发送没有 NFSv4 域名的 UID/GID。
--revert-nfsv4-no-domain-uids
将设置还原为系统默认值。默认值为 yes。
--nfsv4-no-names {yes | no}
始终以 UID/GID 格式发送所有者/组。
--revert-nfsv4-no-names
将设置还原为系统默认值。默认值为 no。
--nfsv4-allow-numeric-ids {yes | no}
在查找失败或启用 --nfsv4-no-names 时,以 UID/GID 格式发送所有者/组。
--revert-nfsv4-allow-numeric-ids
将设置还原为系统默认值。默认值为 yes。
--zone< 字符串 >
指定访问分区。
{--verbose | -v}
显示更多详细信息。

示例
以下命令指定 NFS 服务器将接受以 UID/GID 替代用户名:

isi nfs settings zone modify --nfsv4-no-names yes

isi nfs settings zone view


显示默认的 NFSv4 相关访问分区设置。

语法
isi nfs settings zone view
[--zone <string>]

选项
--zone< 字符串 >
指定要查看其 NFSv4 相关设置的访问分区。

OneFS isi 命令 N 到 R 419


示例
以下命令指定您想要检查名为 Zone1 的访问分区的 NFSv4 相关设置:

isi nfs settings zone view --zone=Zone1

isi ntp servers create


向群集添加网络时间协议 (NTP) 服务器。

语法
isi ntp servers create <name>
[--key <string>]
[--verbose]

选项
<名称> 要添加至群集的 NTP 服务器的主机名。
{--key | -k} <字 将 NTP 服务器映射到密钥文件中的密钥的值。
符串>
{--verbose | 显示更多详细信息。
-v}

isi ntp servers delete


从群集中删除一个或多个网络时间协议 (NTP) 服务器。

语法
isi ntp servers delete (<name> | --all)
[--verbose]
[--force]

选项
<名称> 已连接至群集的 NTP 服务器的主机名。
--all 删除所有连接的 NTP 服务器。
{--verbose | 显示更多详细信息。
-v}
{--force | -f} 不提示确认删除。

420 OneFS isi 命令 N 到 R


isi ntp servers list
列出网络时间协议 (NTP) 服务器。

语法
isi ntp servers list
[--limit <integer>]
[--sort (name | key)]
[--descending]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 要显示的 NTP 服务器数。
整数>
--sort (name | 按服务器名称或密钥路径对列表输出进行排序。
key)
{--descending | 按降序对数据进行排序。
-d}
--format 以表格、JSON、CSV 或列表格式显示 NTP 服务器。
(table | json |
csv | list)
{--no-header | 不会以表格或 CSV 格式显示标头。
-a}
{--no-footer | 不显示表格摘要页脚信息。
-z}
{--verbose | 显示更多详细信息。
-v}

OneFS 显示服务器和密钥路径的列表。

isi ntp servers modify


修改网络时间协议 (NTP) 服务器信息。

语法
isi ntp servers modify <name>
[--key (<string> | --clear-key)]
[--verbose]

选项
<名称> 已连接至群集的 NTP 服务器的主机名。

OneFS isi 命令 N 到 R 421


{--key | -k) ( < 将 NTP 服务器映射到密钥文件中的密钥的值。
字符串> | --
clear-key --clear-key 清除密钥值。

{--verbose | 显示更多详细信息。
-v}

isi ntp servers view


查看网络时间协议 (NTP) 服务器属性。

语法
isi ntp servers view <name>

选项
<名称> 输入 NTP 服务器的主机名。

OneFS 显示有关指定 NTP 服务器的信息。

isi ntp settings modify


修改网络时间协议 (NTP) 服务器配置设置。

语法
isi ntp settings modify
[--chimers <integer>]
[--excluded (<lnn> | --clear-excluded | --add-excluded <lnn> | --remove-excluded
<lnn>)]
[--key-file (<path> | --clear-key-file]
[--verbose]

选项
--chimers <整数 与 NTP 服务器联系的 chimer 节点的数量。
>
{--excluded | 指定用于从 chimer duty 中排除节点的逻辑节点名称 (LNN) 编号。为所需的每个额外 LNN 指定此选项。
-x} ( <lnn> | --
clear- --clear- 清除从 chimer duty 中排除的 LNN 列表。
excluded | -- excluded
add-excluded --add- 将服务器添加至从 chimer duty 中排除的 LNN 列表。为所需的每个额外 LNN 指定
<lnn> | -- excluded <LNN> 此选项。
remove-
excluded <lnn> ) --remove 删除从 chimer duty 中排除的 LNN 列表中的服务器。为所需的每个额外 LNN 指定
excluded <LNN> 此选项。

{--key-file | 维护 NTP 密钥文件信息。


-k} ( <路径> | --
clear-key- <路径> OneFS 文件系统中 NTP 密钥文件的路径。
file)

422 OneFS isi 命令 N 到 R


--clear-key- 清除 NTP 密钥文件路径。
file

{--verbose | 显示更多详细信息。
-v}

isi ntp settings view


查看群集网络时间协议 (NTP) 配置设置。

语法
isi ntp settings view

选项
None

OneFS 显示群集 NTP 配置设置。

isi performance datasets create


创建新的 OneFS 性能数据集。

语法
isi performance datasets create <metrics> (export_id | groupname | local_address | path
| protocol | remote_address |
share_name | username | zone_name)
[{--filters | -f} <metrics>]
[{--name | -n} <string>]
[{--help | -h}]

选项
<指标> 要包含在新数据集中的统计信息指标。您可以指定多个指标选项。
{export_id |
groupname |
local_address
| path |
protocol |
remote_addres
s | share_name |
username |
zone_name)
{--filter | -f} 用于从 < 指标 > 参数中的可用值中筛选新数据集的统计信息指标。
{--name | -n} 新数据集的自定义名称。
{--help | -h} 显示此命令的帮助。

OneFS isi 命令 N 到 R 423


isi performance datasets delete
删除性能数据集。

语法
isi performance datasets delete <dataset>
[--remove-filters]
[--unpin-workloads]
[--force]

选项
<数据集> 您要删除的数据集的名称或数字 ID。
{--remove- 在删除数据集之前,请从性能数据集中删除所有筛选器。
filters | -r}
{--unpin- 在删除数据集之前,请从性能数据集中取消固定所有工作负载。
workloads | -u}
{--force | -f} 不提示确认数据集删除。

isi performance datasets list


列出配置的性能数据集。

语法
isi performance datasets list
[--sort {id | name | statkey | creation_time}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--sort {id | 按指定字段对数据进行排序。
name | statkey |
creation_time}
{--descending | 指定按降序排列数据。
-d}
--format 以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{table | json |
csv | list}
{--no-header | 显示不带页眉的表和 CSV 输出。
-a}
{--no-footer | 显示不带页脚的表输出。
-z}

424 OneFS isi 命令 N 到 R


{--verbose | 显示更多详细信息。
-v}

isi peformance datasets modify


修改配置的性能数据集。

语法
isi performance datasets modify <dataset>
[--name <string>]

选项
<数据集> 要修改的数据集的名称或数字 ID。
{--name | -n} 性能数据集的新自定义名称。

isi performance datasets view


查看已配置的 OneFS 性能数据集的属性。

语法
isi performance datasets view <dataset>

选项
<数据集> 要查看其属性的 OneFS 性能数据集的名称或数字 ID。

OneFS 显示指定 OneFS 性能数据集的属性。

isi performance filters apply


将新筛选器应用到先前配置的 OneFS 性能数据集。

语法
isi performance filters apply <dataset> <metric-value>
[--name]

选项
<数据集> 要应用筛选器的数据集的名称或数字 ID。
<指标值> 用于定义新功能的指标值。为所需的每个额外值指定 --metric-value。指标值是一个性能指标,是以
冒号 (:) 连接的指标值。例如,protocol:smb2。

OneFS isi 命令 N 到 R 425


{--name | -n} 新筛选器的自定义名称。

isi performance filters list


列出已配置的 OneFS 性能数据集上应用的筛选器。

语法
isi performance filters list <dataset>
[--sort {id | name | creation_time}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
<数据集> 要为其列出筛选器的数据集的名称或数字 ID。
--sort {id | 按指定字段对数据进行排序。
name |
creation_time}
{--descending | 指定按降序排列数据。
-d}
--format 以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{table | json |
csv | list}
{--no-header | 显示不带页眉的表和 CSV 输出。
-a}
{--no-footer | 显示不带页脚的表输出。
-z}
{--verbose | 显示更多详细信息。
-v}

isi performance filters modify


修改应用于 OneFS 性能数据集的筛选器。

语法
isi performance filters modify <dataset> <filter>
[--name <string>]

选项
<数据集> 要修改筛选器的数据集的名称或数字 ID。
<filter> 要修改的筛选器的名称或数字 ID。
{--name | -n} 筛选器的新自定义名称。

426 OneFS isi 命令 N 到 R


isi performance filters remove
移除应用于 OneFS 性能数据集的筛选器。

语法
isi performance filters remove <dataset> <filter>
[--force]

选项
<数据集> 要从中删除筛选器的数据集的名称或数字 ID。
<筛选器> 要从数据集中删除的筛选器的名称或数字 ID。
{--force | -f} 不提示确认删除筛选器。

isi performance filters view


查看应用于 OneFS 性能数据集的筛选器的属性。

语法
isi performance filters view <dataset> <filter>

选项
<数据集> 您已应用了筛选器的数据集的名称或数字 ID。
<筛选器> 要查看的筛选器的名称或数字 ID。

OneFS 显示应用于 OneFS 性能数据集的指定筛选器的属性。

isi performance metrics list


列出可用于定义 OneFS 性能数据集的统计信息指标。

语法
isi performance metrics list
[--sort {id | datatype | system_only}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

OneFS isi 命令 N 到 R 427


选项
--sort {id | 按指定字段对数据进行排序。归类为 system_only 的指标将保留用于系统数据集。
datatype |
system_only}
{--descending | 指定按降序排列数据。
-d}
--format 以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{table | json |
csv | list}
{--no-header | 显示不带页眉的表和 CSV 输出。
-a}
{--no-footer | 显示不带页脚的表输出。
-z}
{--verbose | 显示更多详细信息。
-v}

isi performance metrics view


查看用于定义数据集的统计信息指标。

语法
isi performance metrics view <id>

选项
<ID> 要查看的统计信息指标的名称或 ID。

OneFS 显示指定统计信息指标的属性。

isi performance settings modify


修改 OneFS 性能监测设置。

语法
isi performance settings modify <top-n-collection-count>

选项
<前 n 次收集计数> OneFS 针对每个已配置的性能数据集跟踪和收集的最高资源消耗工作负载的数量。默认数量为 1024。

428 OneFS isi 命令 N 到 R


isi performance settings view
查看性能设置。

语法
isi performance settings view

OneFS 显示性能设置。

isi performance workloads list


列出固定至已配置 OneFS 性能数据集的工作负载。

语法
isi performance workloads list <dataset>
[--sort {id | name | creation_time}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
<数据集> 要列出其固定工作负载的数据集的名称或数字 ID。
--sort {id | 按指定字段对数据进行排序。
name |
creation_time}
{--descending | 指定按降序排列数据。
-d}
--format 以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{table | json |
csv | list}
{--no-header | 显示不带页眉的表和 CSV 输出。
-a}
{--no-footer | 显示不带页脚的表输出。
-z}
{--verbose | 显示更多详细信息。
-v}

OneFS isi 命令 N 到 R 429


isi performance workloads modify
修改已固定至已配置 OneFS 性能数据集的工作负载。

语法
isi performance workloads modify <dataset> <workload>
[--name <string>]

选项
<数据集> 要修改固定工作负载的数据集的名称或数字 ID。
<工作负载> 要修改的工作负载的名称或数字 ID。
{--name | -n} 工作负载的新自定义名称。

isi performance workloads pin


将新工作负载固定至配置的 OneFS 性能数据集。

语法
isi performance workloads pin <dataset> <metric-value>
[--name <string>]

选项
<数据集> 要固定其工作负载的数据集的名称或数字 ID。
<指标值> 用于定义新功能的指标值。为所需的每个额外值指定 --metric-value。指标值是一个性能指标,是以
冒号 (:) 连接的指标值。例如,protocol:smb2。
{--name | -n} 设置工作负载的自定义名称。

isi performance workloads unpin


从已配置的 OneFS 性能数据集中删除固定的工作负载。

语法
isi performance workloads unpin <dataset> <workload>
[--force]

选项
<数据集> 要从中取消固定工作负载的数据集的名称或数字 ID。
<工作负载> 要从数据集中取消固定的工作负载的名称或数字 ID。

430 OneFS isi 命令 N 到 R


{--force | -f} 不提示确认从数据集中取消固定工作负载。

isi performance workloads view


查看固定至已配置 OneFS 性能数据集的工作负载的属性。

语法
isi performance workloads view <dataset> <workload>

选项
<数据集> 要查看的数据集的名称或数字 ID。
<工作负载> 要查看的工作负载的名称或 ID。

OneFS 显示固定至 OneFS 性能数据集的指定工作负载的属性。

isi quota quotas create


创建新的文件系统配额。

语法
isi quota quotas create <path> <type>
[--user <name>]
[--group <name>]
[--gid <id>]
[--uid <id>]
[--sid <sid>]
[--wellknown <name>]
[--hard-threshold <size>]
[--advisory-threshold <size>]
[--soft-threshold <size>]
[--soft-grace <duration>]
[--container {yes | no}]
[--ignore-limit-checks]
[--include-snapshots {yes | no}]
[--percent-advisory-threshold=<value>]
[--percent-soft-threshold=<value>]
[--thresholds-include-overhead {yes | no}]
[--thresholds-on {fslogicalsize | physicalsize | applogicalsize}]
[--zone <string>]
[--enforced {yes | no}] [--zone <zone>]
[--verbose]

选项
< 路径 >
在 /ifs 文件系统中指定绝对路径。
小心:

不应在 /ifs 目录上创建任何类型的配额。根级别的配额可能会导致明显的性能降级。

< 类型 > {directory | user | group | default-directory | default-user | default-group}

OneFS isi 命令 N 到 R 431


指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。

user 为特定用户创建配额。需要指定 --user、--uid、--sid 或 --wellknown 选


项。

group 为特定组创建配额。需要指定 --group、--gid、--sid 或 --wellknown 选


项。

default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。

default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--user < 名称 >


指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>
设置安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--hard-threshold < 大小 >
设置磁盘使用的绝对限制。如果请求违反了配额限制,磁盘写入尝试通常会被拒绝。大小是指容量值,
其格式为 < 整数 >[{b | K | M | G | T | P}]。
--advisory-threshold < 大小 >
设置建议域值。仅用于通知目的。不对磁盘写入请求强制实施限制。大小是指容量值,其格式为 < 整数
>[{b | K | M | G | T | P}]。
--soft-threshold < 大小 >
指定软阈值,允许磁盘写入超过阈值,直至软宽限期到期。之后的磁盘写入尝试将被拒绝。大小是指容
量值,其格式为 < 整数 >[{b | K | M | G | T | P}]。
--soft-grace < 持续时间 >
指定软阈值宽限期,这是磁盘写入请求被拒之前等待的时间。
使用以下格式指定 < 持续时间 >:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数

M 指定月数

W 指定周数

D 指定天数

H 指定小时数

432 OneFS isi 命令 N 到 R


--container {yes | no}
指定在报告总可用空间和可用空间量时,是考虑共享(容器)还是整个 Isilon 文件系统。
● no—可用空间相对于整个 Isilon 群集文件系统。这是默认设置。
● yes—可用空间与为每个共享设置的配额有关。SMB、NFS、rquotas 等协议支持此功能。为确定共
享中的总可用空间,OneFS 同时考虑所有配额类型(目录、组、用户)的硬配额和软配额。要报告共
享上的可用空间,它会查找具有最少可用空间的配额。这并非必须设置的最小阈值;它是当前可用空
间的最小值。例如,如果部门具有 100T 限制,并且部门内的每个用户都具有 1T 限制,则 100T 共享
可能会在任何一个用户耗尽其 1T 之前耗尽空间。
yes 设置要求将硬配额或软配额设置为“define a share”并指定 --enforced 设置。

--ignore-limit-checks
创建比父配额具有更高配额限制的子配额。
--include-snapshots {yes | no}
在配额大小中包括快照。
--percent-advisory-threshold=< 值 >
将建议阈值指定为配额硬限制值的百分比。
--percent-soft-threshold=< 值 >
将软限制值指定为配额硬限制值的百分比。
--thresholds-include-overhead {yes | no}
包括设置为 yes 时配额阈值中的 OneFS 存储开销。
--thresholds-on {fslogicalsize | physicalsize | applogicalsize}
根据以下参数强制执行此配额的限制。

fslogicalsize 根据文件系统逻辑大小强制执行基本配额;存储使用情况不包括元数据和数据保
护。

physicalsize 根据物理大小强制执行基本配额;存储使用情况包括元数据和数据保护。

applogicalsiz 根据应用程序逻辑大小强制执行基本配额;存储使用情况包括群集上的容量消耗以
e 及数据分层到云。此存储使用量通常等于或小于文件系统逻辑大小。

--enforced {yes | no}


设置为 yes 时强制执行此配额。指定任意阈值会在创建时自动将该值设置为 yes。
--zone < 分区 >
指定访问分区。
{--verbose | -v}
显示更多详细信息。

isi quota quotas delete


删除文件系统配额或多个配额。

语法

isi quota quotas delete <path> <type>


[--uid <id>]
[--user <name>]
[--gid <id>]
[--group <name>]
[--sid <sid>]
[--wellknown <name>]

OneFS isi 命令 N 到 R 433


[--recurse-path-parents]
[--recurse-path-children]
[--include-snapshots {yes | no}]
[--zone <zone>]
[--verbose]

选项
< 路径 >
在 /ifs 文件系统中指定绝对路径。
<type> {directory | user | group | default-directory | default-user | default-group | --all}
删除指定类型的配额。必须使用 < 路径 > 变量指定参数。以下值有效:

directory 为目录中的所有数据指定配额,而不考虑所有者。
user 为特定用户指定配额。需要指定 --user、--uid 或 --sid。
group 为特定组指定配额。需要指定 --group、--gid 或 --sid 选项。
default- 指定主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 指定主配额,用于为在目录中有数据的每个用户创建链接配额。
default-group 指定主配额,用于为在目录中拥有数据的每个组创建链接配额。
--all 删除所有配额。不能使用 < 类型 > 或 < 路径 > 指定标记。

--uid <ID>
按指定数字用户标识符 (UID) 删除配额。
--user < 名称 >
删除与按名称标识的用户关联的配额。
--gid <ID>
按指定数字组标识符 (GID) 删除配额。
--group < 名称 >
删除与按名称标识的组关联的配额。
--sid <SID>
指定用于选择配额的安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
删除与已知角色关联的配额。
--recurse-path-parents
在父路径中搜索配额。
--recurse-path-children
在子路径中搜索配额。
--include-snapshots {yes | no}
删除包括快照数据使用的配额。
--zone < 分区 >
指定访问分区。
{--verbose | -v}
显示更多详细信息。

434 OneFS isi 命令 N 到 R


isi quota quotas list
显示配额列表。

语法
isi quota quotas list
[--user <name> | --group <name> | --gid <id> | --uid <id> | --sid <sid> | --wellknown
<name>]
[--type (directory | user | group | default-directory | default-user | default-group)]
[--path <path>]
[--recurse-path-parents]
[--recurse-path-children]
[--include-snapshots <boolean>]
[--exceeded]
[--enforced <boolean>]
[--zone <string>]
[{--limit | -l} <integer>]
[--format (table | json | csv | list)]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]
[{--help | -h}]

选项
--user < 名称 >
指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>
指定用于选择配额的安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--type
指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。
user 为特定用户创建配额。需要指定 --user、--uid、--sid 或 --wellknown 选
项。
group 为特定组创建配额。需要指定 --group、--gid、--sid 或 --wellknown 选
项。
default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。
default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--path <路径>
在指定路径上指定配额。

OneFS isi 命令 N 到 R 435


--recurse-path-parents
为配额指定父路径。
--recurse-path-children
为配额指定子路径。
--include-snapshots <布尔>
指定包括快照数据使用的配额。
--exceeded
仅指定具有超出阈值的配额。
--enforced <布尔>
指定具有强制执行的阈值的配额。
--zone <字符串>
在指定分区中指定配额。
{--limit | -l} <整数>
指定要显示的配额数。
--format
以指定的格式显示配额。以下值有效:
● table
● json
● csv
● list
{--no-header | -a}
禁止以 CSV 或表格式显示页眉。
{--no-footer | -z}
禁止显示表摘要页脚信息。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi quota quotas modify


修改文件系统配额。

语法
isi quota quotas modify <path> <type>
[--user <name> | --group <name> | --gid <id> | --uid <id>
| --sid <sid> | --wellknown <name>]
[--hard-threshold <size>]
[--clear-hard-threshold]
[--advisory-threshold <size>]
[--clear-advisory-threshold]
[--soft-threshold <size>]
[--clear-soft-threshold]
[--soft-grace <duration>]
[--container {yes | no}]
[--ignore-limit-checks]
[--include-snapshots {yes | no}]
[--percent-advisory-threshold=<value>]
[--thresholds-include-overhead {yes | no}]
[--thresholds-on {fslogicalsize | physicalsize | applogicalsize}]
[--enforced {yes | no}]
[--linked {yes | no}]

436 OneFS isi 命令 N 到 R


[--zone <string>]
[--verbose]

选项
--path < 路径 >
在 /ifs 文件系统中指定绝对路径。
--type
指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。
user 为特定用户创建配额。需要指定 --user、--uid 或 --sid 选项。
group 为特定组创建配额。需要指定 --group、--gid 或 --sid 选项。
default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。
default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--user < 名称 >


指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>
指定用于选择要修改的配额的安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--hard-threshold < 大小 >
设置磁盘使用的绝对限制。如果请求违反了配额限制,磁盘写入尝试通常会被拒绝。大小是指容量值,
其格式为 < 整数 >[{b | K | M | G | T | P}]。
--clear-hard-threshold
清除磁盘使用的绝对限制。
--advisory-threshold < 大小 >
设置建议域值。仅用于通知目的。不对磁盘写入请求强制实施限制。大小是指容量值,其格式为 < 整数
>[{b | K | M | G | T | P}]。
--clear-advisory-threshold
清除建议阈值。
--soft-threshold < 大小 >
指定软阈值,允许磁盘写入超过阈值,直至软宽限期到期。之后的磁盘写入尝试将被拒绝。大小是指容
量值,其格式为 < 整数 >[{b | K | M | G | T | P}]。
--clear-soft-threshold
清除软阈值。
--soft-grace < 持续时间 >
指定软阈值宽限期,这是磁盘写入请求被拒之前等待的时间。
使用以下格式指定 < 持续时间 >:

<integer><units>

OneFS isi 命令 N 到 R 437


以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
m 指定分钟数
s 指定秒数

--container {yes | no}


指定在报告总可用空间和可用空间量时,是考虑共享(容器)还是整个 Isilon 文件系统。
● no—可用空间相对于整个 Isilon 群集文件系统。这是默认设置。
● yes—可用空间与为每个共享设置的配额有关。SMB、NFS、rquotas 等协议支持此功能。为确定共
享中的总可用空间,OneFS 同时考虑所有配额类型(目录、组、用户)的硬配额和软配额。要报告共
享上的可用空间,它会查找具有最少可用空间的配额。这并非必须设置的最小阈值;它是当前可用空
间的最小值。例如,如果部门具有 100T 限制,并且部门内的每个用户都具有 1T 限制,则 100T 共享
可能会在任何一个用户耗尽其 1T 之前耗尽空间。
yes 设置要求将硬配额或软配额设置为“define a share”并指定 --enforced 设置。

--ignore-limit-checks
创建比父配额具有更高配额限制的子配额。
--include-snapshots {yes | no}
在配额大小中包括快照。
--percent-advisory-threshold=< 值 >
将软限制值或建议阈值指定为配额硬限制值的百分比。
--thresholds-include-overhead {yes | no}
包括设置为 yes 时配额阈值中的 OneFS 存储开销。
--thresholds-on {fslogicalsize | physicalsize | applogicalsize}
根据以下参数强制执行此配额的限制。

fslogicalsize 根据文件系统逻辑大小强制执行基本配额;存储使用情况不包括元数据和数据保
护。

physicalsize 根据物理大小强制执行基本配额;存储使用情况包括元数据和数据保护。

applogicalsiz 根据应用程序逻辑大小强制执行基本配额;存储使用情况包括群集上的容量消耗以
e 及数据分层到云。此存储使用量通常等于或小于文件系统逻辑大小。

--enforced {yes | no}


设置为 yes 时强制执行此配额。指定任意阈值会在创建时自动将该值设置为 yes。
--linked {yes | no}
按默认目录、默认用户或默认组配额断开自动创建的链接配额。断开链接允许单独修改配额。要修改链
接的配额,必须修改该配额所源自的原始默认目录、默认用户或默认组配额,而不是修改链接的配额本
身。
--zone < 字符串 >
该配额使用的分区。请仅将此参数用于解析配额所使用的角色。
{--verbose | -v}
显示更多详细信息。

438 OneFS isi 命令 N 到 R


isi quota quotas notifications clear
清除配额规则并使用系统通知设置。

注: 使用 isi quota quotas notifications disable 命令禁用配额的所有通知。

语法
isi quota quotas notifications clear <path> <type>
[--user <name>]
[--group <name>]
[--gid <id>]
[--uid <id>]
[--sid <sid>]
[--wellknown <name>]
[--include-snapshots {yes | no}]
[--force]

选项
< 路径 >
在 /ifs 文件系统中指定绝对路径。
< 类型 >
指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。
user 为特定用户创建配额。需要指定 --user、--uid、--sid 或 --wellknown 选
项。
group 为特定组创建配额。需要指定 --group、--gid、--sid 或 --wellknown 选
项。
default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。
default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--user < 名称 >


指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>
指定用于选择配额的安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--include-snapshots {yes | no}
在配额大小中包括快照。
{--force | -f}
跳过确认提示。

OneFS isi 命令 N 到 R 439


isi quota quotas notifications create
为配额创建通知规则。

语法
isi quota quotas notifications create
--path <path>
--type {directory | user | group | default-directory | default-user | default-group}
--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}
[--user <name> | --group <name> | --gid <id> | --uid <id>
| --sid <sid> | --wellknown <name>]
[--include-snapshots {yes | no}]
[--schedule <name>]
[--holdoff <duration>]
[--action-alert {yes | no}]
[--action-email-owner {yes | no}]
[--action-email-address <address>]
[--verbose]

选项
--path < 路径 >
在 /ifs 文件系统中指定绝对路径。
--type
指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。
user 为特定用户创建配额。需要指定 --user、--uid、--sid 或 --wellknown 选
项。
group 为特定组创建配额。需要指定 --group、--gid、--sid 或 --wellknown 选
项。
default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。
default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--threshold
指定域值类型。以下值有效:

hard 设置磁盘使用的绝对限制。如果请求违反了配额限制,磁盘写入尝试通常会被拒
绝。
soft 指定软域值。允许磁盘写入超过域值,直至超出软宽限期。之后的磁盘写入尝试将
被拒绝。
advisory 设置建议域值。仅用于通知目的。不对磁盘写入请求强制实施限制。

--condition
指定将发送通知的配额条件。以下值有效:

denied 指定当硬域值或软域值超出其软宽限期而导致磁盘写入操作被拒绝时的通知。
exceeded 指定当磁盘使用超出域值时的通知。
violated 指定当磁盘使用超出配额域值但其他条件均不适用时的通知。
expired 指定当磁盘使用超出软域值且软宽限期已到期时的通知。

440 OneFS isi 命令 N 到 R


--user < 名称 >
指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>
设置安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--include-snapshots {yes | no}
指定包括快照数据使用的配额。
--schedule < 名称 >
指定重复发送通知的日期模式。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
--holdoff < 持续时间 >
指定生成通知前等待的时间长度。
使用以下格式指定 < 持续时间 >:

<integer><units>

OneFS isi 命令 N 到 R 441


以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
s 指定秒数

--action-alert {yes | no}


当满足通知条件时生成警报。
--action-email-owner {yes | no}
指定当超过域值时向用户发送电子邮件。需要 --action-email-address。
--action-email-address < 地址 >
指定接收通知的用户电子邮件地址。为要通知的用户的每个其他电子邮件地址指定 --action-email-
address。
{--verbose | -v}
显示更多详细信息。

isi quota quotas notifications delete


删除配额通知规则。

语法
isi quota quotas notifications delete
--path <path>
--type {directory | user | group | default-directory | default-user | default-group}
--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}
[--user <name> | --group <name> | --gid <id> | --uid <id>
| --sid <sid> | --wellknown <name>]
[--include-snapshots {yes | no}]
[--verbose]

选项
--path < 路径 >
删除 /ifs 文件系统内绝对路径上的配额通知集。
--type
按指定类型删除配额通知。以下值有效:

directory 为目录中的所有数据指定配额,而不考虑所有者。

user 为特定用户指定配额。需要指定 --user、--uid、--sid 或 --wellknown 选


项。

group 为特定组指定配额。需要指定 --group、--gid、--sid 或 --wellknown 选


项。

default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 指定主配额,用于为在目录中有数据的每个用户创建链接配额。

442 OneFS isi 命令 N 到 R


default-group 指定主配额,用于为在目录中拥有数据的每个组创建链接配额。

--threshold
按指定阈值删除配额通知。以下值有效:

hard 指定磁盘使用的绝对限制。

soft 指定软域值。

advisory 指定建议阈值。

--condition
按发送通知所依据的指定条件删除配额通知。以下值有效:

denied 指定当硬域值或软域值超出其软宽限期而导致磁盘写入操作被拒绝时的通知。

exceeded 指定当磁盘使用超出域值时的通知。

violated 指定当磁盘使用超出配额域值但其他条件均不适用时的通知。

expired 指定当磁盘使用超出软域值且软宽限期已到期时的通知。

--user < 名称 >


按指定用户名删除配额通知。
--group < 名称 >
按指定组名称删除配额通知。
--gid <ID>
按指定数字组标识符 (GID) 删除配额通知。
--uid <ID>
按指定数字用户标识符 (UID) 删除配额通知。
--sid <SID>
按用于选择配额的指定安全标识符 (SID) 删除配额通知。例如,S-1-5-21-13。
--wellknown < 名称 >
按指定的已知用户、组、计算机或帐户名称删除配额通知。
--include-snapshots {yes | no}
按配额大小中包括的快照的指定设置来删除配额通知。
{--verbose | -v}
显示更多详细信息。

isi quota quotas notifications disable


禁用所有配额通知。

小心: 禁用所有配额通知时,也会禁用系统通知行为。使用 --clear 选项删除特定配额通知规则并返回系统默认值。

语法
isi quota quotas notifications disable
--path <path>
--type {directory | user | group | default-directory | default-user | default-group}
[--user <name> | --group <name> | --gid <id> | --uid <id>

OneFS isi 命令 N 到 R 443


| --sid <sid> | --wellknown <name>]
[--include-snapshots {yes | no}]

选项
--path < 路径 >
在 /ifs 文件系统中指定绝对路径。
--type
禁用指定类型的配额。必须使用 --path 选项指定参数。以下值有效:

directory 为目录中的所有数据指定配额,而不考虑所有者。

user 为特定用户指定配额。需要指定 -user、--uid、--sid 或 --wellknown 选


项。

group 为特定组指定配额。需要指定 --group、--gid、--sid 或 --wellknown 选


项。

default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 指定主配额,用于为在目录中有数据的每个用户创建链接配额。

default-group 指定主配额,用于为在目录中拥有数据的每个组创建链接配额。

--user < 名称 >


禁用与按名称标识的用户关联的配额。
--gid <ID>
按指定数字组标识符 (GID) 禁用配额。
--uid <ID>
按指定数字用户标识符 (UID) 禁用配额。
--sid <SID>
指定用于选择配额的安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--include-snapshots {yes | no}
禁用包括快照数据使用的配额。

isi quota quotas notifications list


显示配额通知规则的列表。

语法
isi quota quotas notifications list
--path <path>
--type {directory | user | group | default-directory | default-user | default-group}
[--user <name> | --group <name> | --gid <id> | --uid <id>
| --sid <sid> | --wellknown <name>]
[--include-snapshots {yes | no}]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]

444 OneFS isi 命令 N 到 R


[--no-footer]
[--verbose]

选项
--path < 路径 >
在 /ifs 文件系统中指定绝对路径。
--type
指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。

user 为特定用户创建配额。需要指定 --user、--uid、--sid 或 --wellknown 选


项。

group 为特定组创建配额。需要指定 --group、--gid、--sid 或 --wellknown 选


项。

default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。

default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--user < 名称 >


指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>
指定用于选择配额的安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--include-snapshots {yes | no}
在配额大小中包括快照。
{--limit | -l} < 整数 >
指定要显示的配额通知规则的数量。
--format
以指定的格式显示配额通知规则。以下值有效:
table
json
csv
list
{--no-header | -a}
禁止以 CSV 或表格式显示页眉。
{--no-footer | -z}

OneFS isi 命令 N 到 R 445


禁止显示表摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

isi quota quotas notifications modify


修改配额的通知规则。

语法
isi quota quotas notifications modify
--path <path>
--type {directory | user | group | default-directory | default-user | default-group}
--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}
[--user <name> | --group <name> | --gid <id> | --uid <id>
| --sid <sid> | --wellknown <name>]
[--include-snapshots {yes | no}]
[--schedule <string>]
[--holdoff <duration>]
[--clear-holdoff]
[--action-alert {yes | no}]
[--action-email-owner {yes | no}]
[--action-email-address <address>]
[--clear-action-email-address]
[--add-action-email-address <address>]
[--remove-action-email-address <address>]
[--email-template <path>]
[--clear-email-template]
[--verbose]

选项
--path < 路径 >
在 /ifs 文件系统中指定绝对路径。
--type
指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。
user 为特定用户创建配额。需要指定 --user、--uid、--sid 或 --wellknown 选
项。
group 为特定组创建配额。需要指定 --group、--gid、--sid 或 --wellknown 选
项。
default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。
default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--threshold
指定域值类型。以下值有效:

hard 设置磁盘使用的绝对限制。如果请求违反了配额限制,磁盘写入尝试通常会被拒
绝。
soft 指定软域值。允许磁盘写入超过域值,直至超出软宽限期。之后的磁盘写入尝试将
被拒绝。
advisory 设置建议域值。仅用于通知目的。不对磁盘写入请求强制实施限制。

446 OneFS isi 命令 N 到 R


--condition
指定将发送通知的配额条件。以下值有效:

denied 指定当硬域值或软域值超出其软宽限期而导致磁盘写入操作被拒绝时的通知。
exceeded 指定当磁盘使用超出域值时的通知。
violated 指定当磁盘使用超出配额域值但其他条件均不适用时的通知。
expired 指定当磁盘使用超出软域值且软宽限期已到期时的通知。

--user < 名称 >


指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>
设置安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--include-snapshots {yes | no}
在配额大小中包括快照。
--schedule < 名称 >
指定重复发送通知的日期模式。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”

OneFS isi 命令 N 到 R 447


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
--holdoff < 持续时间 >
指定生成通知前等待的时间长度。
使用以下格式指定 < 持续时间 >:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
s 指定秒数

--clear-holdoff
清除 --holdoff 持续时间的值。
--action-alert {yes | no}
当满足通知条件时生成警报。
--action-email-owner {yes | no}
指定当超过域值时向用户发送电子邮件。需要 --action-email-address。
--action-email-address < 地址 >
指定要通知的用户电子邮件地址。为要通知的用户的每个其他电子邮件地址指定 --action-email-
address。
--clear-action-email-address
清除要通知的用户电子邮件地址的值。
--add-action-email-address< 地址 >
添加要通知的用户电子邮件地址。为要通知的用户的每个其他电子邮件地址指定 --add-action-
email-address。
--remove-action-email-address< 地址 >
删除要通知的用户的电子邮件地址。为要通知的用户的每个电子邮件地址指定 --remove-action-
email-address。
--email-template < 路径 >
在 /ifs 中指定电子邮件模板的路径。
--clear-email-template
清除指向电子邮件模板的路径的设置。
{--verbose | -v}
显示更多详细信息。

isi quota quotas notifications view


显示配额通知规则的属性。

语法
isi quota quotas notifications view
--path <path>
--type {directory | user | group | default-directory | default-user | default-group}
--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}

448 OneFS isi 命令 N 到 R


[--user <name> | --group <name> | --gid <id> | --uid <id>
| --sid <sid> | --wellknown <name>]
[--include-snapshots {yes | no}]

选项
--path < 路径 >
在 /ifs 文件系统中指定绝对路径。
--type
指定配额类型。以下值有效:

directory 为目录中的所有数据创建配额,而不考虑所有者。

user 为特定用户创建配额。需要指定 --user、--uid、--sid 或 --wellknown 选


项。

group 为特定组创建配额。需要指定 --group、--gid、--sid 或 --wellknown 选


项。

default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 创建主配额,用于为在目录中有数据的每个用户创建链接配额。

default-group 创建主配额,用于为在目录中拥有数据的每个组创建链接配额。

--threshold
指定域值类型。以下值有效:

hard 设置磁盘使用的绝对限制。如果请求违反了配额限制,磁盘写入尝试通常会被拒
绝。

soft 指定软域值。允许磁盘写入超过域值,直至超出软宽限期。之后的磁盘写入尝试将
被拒绝。

advisory 设置建议域值。仅用于通知目的。不对磁盘写入请求强制实施限制。

--condition
指定将发送通知的配额条件。以下值有效:

denied 指定当硬域值或软域值超出其软宽限期而导致磁盘写入操作被拒绝时的通知。

exceeded 指定当磁盘使用超出域值时的通知。

violated 指定当磁盘使用超出配额域值但其他条件均不适用时的通知。

expired 指定当磁盘使用超出软域值且软宽限期已到期时的通知。

--user < 名称 >


指定用户名。
--group < 名称 >
指定组名称。
--gid <ID>
指定数字组标识符 (GID)。
--uid <ID>
指定数字用户标识符 (UID)。
--sid <SID>

OneFS isi 命令 N 到 R 449


指定用于选择配额的安全标识符 (SID)。例如,S-1-5-21-13。
--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--include-snapshots {yes | no}
在配额大小中包括快照。

isi quota quotas view


显示单个文件系统配额的详细属性。

语法
isi quota quotas view
--path <path>
--type {directory | user | group | default-directory | default-user | default-group}
[--user <name> | --group <name> | --gid <id> | --uid <id>
| --sid <sid> | --wellknown <name>]
[--include-snapshots {yes | no}]
[--zone <string>]

选项
--path < 路径 >
在 /ifs 文件系统中指定绝对路径。
--type
指定特定类型的配额。必须使用 --path 选项指定参数。以下值有效:

directory 为目录中的所有数据指定配额,而不考虑所有者。

user 为特定用户指定配额。需要指定 -user、--uid、--sid 或 --wellknown 选


项。

group 为特定组指定配额。需要指定 --group、--gid、--sid 或 --wellknown 选


项。

default- 创建主配额,用于为在目录中创建的每个直接子目录创建链接配额。
directory
default-user 指定主配额,用于为在目录中有数据的每个用户创建链接配额。

default-group 指定主配额,用于为在目录中拥有数据的每个组创建链接配额。

--user < 名称 >


指定与按名称标识的用户关联的配额。
--group < 名称 >
指定与按名称标识的组关联的配额。
--gid <ID>
按数字组标识符 (GID) 指定配额。
--uid <ID>
按指定数字用户标识符 (UID) 指定配额。
--sid <SID>
指定用于选择配额的安全标识符 (SID)。例如,S-1-5-21-13。

450 OneFS isi 命令 N 到 R


--wellknown < 名称 >
指定已知用户、组、计算机或帐户名称。
--include-snapshots {yes | no}
指定包括快照数据使用的配额。
--zone < 分区 >
指定访问分区。

isi quota reports create


生成配额报告。

语法

isi quota reports create


[--verbose]

选项
{--verbose | -v}
显示更多详细信息。

isi quota reports delete


删除指定报告。

语法
isi quota reports delete
--time <string>
--generated {live | scheduled | manual}
--type {summary | detail}
[--verbose]

选项
--time< 字符串 >
设置报告的时间戳。
采用以下格式指定 < 时间和日期 >:

<YYYY>-<MM>-<DD>[T<hh>:<mm>[:<ss>]]

将 < 时间 > 指定为以下值之一。

Y 指定年数

M 指定月数

W 指定周数

OneFS isi 命令 N 到 R 451


D 指定天数

h 指定小时数

s 指定秒数

--generated
指定生成报告所使用的方法。 以下值有效:
live
scheduled
manual
--type
指定报告类型。 以下值有效:
summary
detail
{--verbose | -v}
显示更多详细信息。

isi quota reports list


显示配额报告列表。

语法

isi quota reports list


[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header
[--no-footer]
[--verbose]

选项
--limit< 整数 >
指定要显示的配额数。
--format
以指定的格式显示配额。 以下值有效:
table
json
csv
list
{--no-header | -a}
禁止以 CSV 或表格式显示页眉。
{--no-footer | -z}
禁止显示表摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

452 OneFS isi 命令 N 到 R


isi quota settings mappings create
创建 SmartQuotas 电子邮件映射规则。

语法
isi quota settings mappings create < 类型 > <domain> < 映射 >
[--verbose]

选项
< 类型 > {ad | local | nis | ldap}
源域的身份认证提供程序类型。
<domain>
要映射的源域的完全限定的域名。
< 映射 >
要映射到的目标域的完全限定的域名。
{--verbose | -v}
显示更多详细信息。

isi quota settings mappings delete


删除 SmartQuotas 电子邮件映射规则。

语法
isi quota settings mappings delete < 类型 > <domain>
[--all]
[--verbose]
[--force]

选项
< 类型 > {ad | local | nis | ldap}
源域的身份认证提供程序类型。
<domain>
要映射的源域的完全限定的域名。
--all
删除所有映射规则。
{--verbose | -v}
显示更多详细信息。
{force | -f}
不显示确认提示的情况下强制删除。

OneFS isi 命令 N 到 R 453


isi quota settings mappings list
列出 SmartQuotas 电子邮件映射规则。

语法
isi quota settings mappings list
[--limit < 整数 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
要显示的配额映射设置数。
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示配额映射设置。
{--no-header | -a}
不会以表格或 CSV 格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

isi quota settings mappings modify


修改现有 SmartQuotas 电子邮件映射规则。

语法
isi quota settings mappings modify < 类型 > <domain> < 映射 >
[--verbose]

选项
< 类型 > {ad | local | nis | ldap}
源域的身份认证提供程序类型。
<domain>
要映射的源域的完全限定的域名。
< 映射 >
要映射到的目标域的完全限定的域名。
{--verbose | -v}
显示更多详细信息。

454 OneFS isi 命令 N 到 R


isi quota settings mappings view
查看 SmartQuotas 电子邮件映射规则。

语法
isi quota settings mappings view < 类型 > <domain>

选项
< 类型 > {ad | local | nis | ldap}
源域的身份认证提供程序类型。
<domain>
要映射的源域的完全限定的域名。

isi quota settings notifications clear


清除所有默认配额通知规则。
清除所有默认通知规则时,系统将恢复到系统通知行为。 使用 --disable 选项禁用特定配额通知规则的通知设置。

语法
isi quota settings notifications clear

isi quota settings notifications create


创建默认通知规则。

语法
isi quota settings notifications create
--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}
--schedule <string>
--holdoff <duration>
[--action-alert {yes | no}]
[--action-email-owner {yes | no}]
[--action-email-address<address>]
[--email-template <path>]
[--verbose]

选项
--threshold
指定域值类型。以下值有效:

hard 设置磁盘使用的绝对限制。如果请求违反了配额限制,磁盘写入尝试通常会被拒
绝。

OneFS isi 命令 N 到 R 455


soft 指定软域值。允许磁盘写入超过域值,直至超出软宽限期。之后的磁盘写入尝试将
被拒绝。
advisory 设置建议域值。仅用于通知目的。不对磁盘写入请求强制实施限制。

--condition
指定将发送通知的配额条件。以下值有效:

denied 指定当硬域值或软域值超出其软宽限期而导致磁盘写入操作被拒绝时的通知。
exceeded 指定当磁盘使用超出域值时的通知。仅适用于软宽限期内的软域值。
violated 指定当磁盘使用超出配额域值但其他条件均不适用时的通知。
expired 指定当磁盘使用超出软域值且软宽限期已到期时的通知。

--schedule < 字符串 >


指定重复发送通知的日期模式。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
--holdoff < 持续时间 >
指定生成通知前等待的时间长度。
使用以下格式指定 < 持续时间 >:

<integer> <units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数

456 OneFS isi 命令 N 到 R


W 指定周数
D 指定天数
H 指定小时数
s 指定秒数

--action-alert {yes | no}


当满足通知条件时生成警报。
--action-email-owner {yes | no}
指定当超过域值时向用户发送电子邮件。需要 --action-email-address。
--action-email-address < 地址 >
指定接收通知的用户电子邮件地址。为要通知的用户的每个其他电子邮件地址指定 --action-email-
address。
--email-template < 路径 >
在 /ifs 中指定电子邮件模板的路径。
{--verbose | -v}
显示更多详细信息。

isi quota settings notifications delete


删除默认配额通知规则。

语法

isi quota settings notifications delete


--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}
[--verbose]

选项
--threshold
指定阈值类型。 以下值有效:

hard 设置磁盘使用的绝对限制。 如果请求违反了配额限制,则通常会拒绝磁盘写入尝


试。

soft 指定软阈值。 允许磁盘写入超过阈值,直至软宽限期到期。 然后,磁盘写入尝试


将被拒绝。

advisory 设置建议阈值。 仅用于通知目的。 不会对磁盘写入请求进行强制限制。

--condition
指定发送通知的配额条件。 以下值有效:

denied 指定当硬阈值或软阈值超出其软宽限期并导致磁盘写入操作被拒绝时的通知。

exceeded 指定当磁盘使用超出阈值时的通知。 仅适用于软宽限期内的软阈值。

violated 指定当磁盘使用超出配额阈值但其他条件均不适用时的通知。

expired 指定当磁盘使用超出软阈值且软宽限期已到期时的通知。

{--verbose | -v}

OneFS isi 命令 N 到 R 457


显示更多详细信息。

isi quota settings notifications list


显示全局配额通知规则列表。

语法
isi quota settings notifications list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
指定要显示的配额通知规则的数量。
--format
以指定的格式显示配额。 以下值有效:
table
json
csv
list
{--no-header | -a}
禁止以 CSV 或表格式显示页眉。
{--no-footer | -z}
禁止显示表摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

isi quota settings notifications modify


修改配额通知规则。

语法
isi quota settings notifications modify
--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}
[--schedule <string>]
[--holdoff <duration>]
[--clear-holdoff]
[--action-alert {yes | no}]
[--action-email-owner {yes | no}]
[--action-email-address <address>]
[--clear-action-email-address]
[--add-action-email-address <address>]
[--remove-action-email-address <address>]
[--email-template <path>]

458 OneFS isi 命令 N 到 R


[--clear-email-template]
[--verbose

选项
--threshold
指定域值类型。以下值有效:

hard 设置磁盘使用的绝对限制。如果请求违反了配额限制,磁盘写入尝试通常会被拒
绝。
soft 指定软域值。允许磁盘写入超过域值,直至超出软宽限期。之后的磁盘写入尝试将
被拒绝。
advisory 设置建议域值。仅用于通知目的。不对磁盘写入请求强制实施限制。

--condition
指定将发送通知的配额条件。以下值有效:

denied 指定当硬域值或软域值超出其软宽限期而导致磁盘写入操作被拒绝时的通知。
exceeded 指定当磁盘使用超出域值时的通知。仅适用于软宽限期内的软域值。
violated 指定当磁盘使用超出配额域值但其他条件均不适用时的通知。
expired 指定当磁盘使用超出软域值且软宽限期已到期时的通知。

--schedule <string>
指定重复发送通知的日期模式。
--holdoff < 持续时间 >
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”

OneFS isi 命令 N 到 R 459


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
指定生成通知前等待的时间长度。
使用以下格式指定 < 持续时间 >:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数
s 指定秒数

--clear-holdoff
清除 持续时间的值。
--action-alert {yes | no}
当满足通知条件时生成警报。
--action-email-owner {yes | no}
指定当超过域值时向用户发送电子邮件。需要 。
--action-email-address < 地址 >
指定接收通知的用户电子邮件地址。为要通知的用户的每个其他电子邮件地址指定 --action-email-
address 。
--clear-action-email-address
清除要通知的用户电子邮件地址的值。
--add-action-email-address< 地址 >
添加要通知的用户电子邮件地址。为要通知的用户的每个其他电子邮件地址指定 --add-action-
email-address 。
--remove-action-email-address< 地址 >
删除要通知的用户的电子邮件地址。为要通知的用户的每个电子邮件地址指定 --remove-action-
email-address。
--email-template <path>
在 中指定电子邮件模板的路径。
--clear-email-template
清除指向电子邮件模板的路径的设置。
{--verbose | -v}
显示更多详细信息。

isi quota settings notifications view


显示系统默认通知规则的属性。

语法
isi quota settings notifications view
--threshold {hard | soft | advisory}
--condition {exceeded | denied | violated | expired}

460 OneFS isi 命令 N 到 R


选项
--threshold
指定阈值类型。 以下值有效:

hard 设置磁盘使用的绝对限制。 如果请求违反了配额限制,则通常会拒绝磁盘写入尝


试。
soft 指定软阈值。 允许磁盘写入超过阈值,直至软宽限期到期。 然后,磁盘写入尝试
将被拒绝。
advisory 设置建议阈值。 仅用于通知目的。 不会对磁盘写入请求进行强制限制。

--condition
指定发送通知的配额条件。 以下值有效:

denied 指定当硬阈值或软阈值超出其软宽限期并导致磁盘写入操作被拒绝时的通知。
exceeded 指定当磁盘使用超出阈值时的通知。 仅适用于软宽限期内的软阈值。
violated 指定当磁盘使用超出配额阈值但其他条件均不适用时的通知。
expired 指定当磁盘使用超出软阈值且软宽限期已到期时的通知。

isi quota settings reports modify


修改群集范围的配额报告设置。

语法
isi quota settings reports modify
[--schedule <schedule>]
[--revert-schedule]
[--scheduled-dir <dir>]
[--revert-scheduled-dir]
[--scheduled-retain <integer>]
[--revert-scheduled-retain]
[--live-dir <dir> | --revert-live-dir]
[--live-retain <integer> | --revert-live-retain]
[--verbose]

选项
--schedule< 计划 >
指定重复发送通知的日期模式。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

OneFS isi 命令 N 到 R 461


● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。 例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。 例如,“saturday”和“sat”都有效。
--revert-schedule
将 --schedule 值设置为系统默认值。
--scheduled-dir< 目录 >
指定存储计划的配额报告的位置。
--revert-scheduled-dir
将 --scheduled-dir 值设置为系统默认值。
--scheduled-retain< 整数 >
指定要保留的计划报告的最大数量。
--revert-scheduled-retain
将 --scheduled-retain 值设置为系统默认值。
--live-dir< 目录 >
指定存储实时配额报告的位置。
--revert-live-dir
将 --live-dir 值设置为系统默认值。
--live-retain< 整数 >
指定要保留的实时配额报告的最大数量。
--revert-live-retain
将 --live-retain 值设置为系统默认值。
{--verbose | -v}
显示更多详细信息。

isi quota settings reports view


显示群集范围的配额报告设置。

语法
isi quota settings reports view

选项
此命令没有选项。

462 OneFS isi 命令 N 到 R


isi readonly list
列出节点的只读信息。

语法
isi readonly list
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
--format 以表格、JSON、CSV 或列表格式显示 ESRS 数据项。
(table | json |
csv | list)
{--no-header | 不会以表格或 CSV 格式显示标头。
-a}
{--no-footer | 不显示表格摘要页脚信息。
-z}
{--verbose | 显示更多详细信息。
-v}

OneFS 显示按 LNN 排序的节点的当前只读模式和状态的列表。

isi readonly modify


更改节点的当前只读状态。

语法
isi readonly modify
[--allowed (yes | no)]
[--enabled (yes | no)]
[--node-lnn <string>]
[--verbose]

选项
--allowed (yes 节点允许的只读状态。默认为 yes。
| no)
--enabled (yes 为节点启用只读状态。默认为 no。
| no)
--node-lnn <字 用于修改只读状态的节点的逻辑节点编号 (LNN)。如果未指定 LNN,则将选择本地节点。
符串>
{--verbose | 显示更多详细信息。
-v}

OneFS isi 命令 N 到 R 463


isi readonly view
查看特定节点的当前只读状态。

语法
isi readonly view
[--node-lnn <integer>]

选项
--node-lnn <整 特定的逻辑节点编号 (LNN)。如果指定 LNN,则将显示本地节点。
数>

OneFS 显示特定节点的只读状态信息。

464 OneFS isi 命令 N 到 R


5
OneFS isi 命令 S 至 Z
本章包含 OneFS CLI 命令 isi s* 到 isi z* 的文档。

主简:
• isi s3 buckets create
• isi s3 buckets delete
• isi s3 buckets list
• isi s3 buckets modify
• isi s3 buckets view
• isi services s3 disable
• isi services s3 enable
• isi s3 keys create
• isi s3 keys delete
• isi s3 log-level
• isi s3 log-level modify
• isi s3 log-level view
• isi s3 mykeys create
• isi s3 mykeys delete
• isi s3 mykeys view
• isi s3 settings global modify
• isi s3 settings global view
• isi s3 settings zone modify
• isi s3 settings zone view
• isi servicelight list
• isi servicelight modify
• isi servicelight view
• isi services
• isi set
• isi smb log-level filters create
• isi smb log-level filters delete
• isi smb log-level filters list
• isi smb log-level filters view
• isi smb log-level modify
• isi smb log-level view
• isi smb openfiles close
• isi smb openfiles list
• isi smb sessions delete
• isi smb sessions delete-user
• isi smb sessions list
• isi smb settings global modify
• isi smb settings global view
• isi smb settings shares modify
• isi smb settings shares view
• isi smb settings zone modify
• isi smb settings zone view
• isi smb shares create
• isi smb shares delete
• isi smb shares list
• isi smb shares modify
• isi smb shares permission create

OneFS isi 命令 S 至 Z 465


• isi smb shares permission delete
• isi smb shares permission list
• isi smb shares permission modify
• isi smb shares permission view
• isi smb shares view
• isi snapshot aliases create
• isi snapshot aliases delete
• isi snapshot aliases list
• isi snapshot aliases modify
• isi snapshot aliases view
• isi snapshot locks create
• isi snapshot locks delete
• isi snapshot locks list
• isi snapshot locks modify
• isi snapshot locks view
• isi snapshot schedules create
• isi snapshot schedules delete
• isi snapshot schedules list
• isi snapshot schedules modify
• isi snapshot schedules pending list
• isi snapshot schedules view
• isi snapshot settings modify
• isi snapshot settings view
• isi snapshot snapshots create
• isi snapshot snapshots delete
• isi snapshot snapshots list
• isi snapshot snapshots modify
• isi snapshot snapshots view
• isi snapshot writable create
• isi snapshot writable delete
• isi snapshot writable list
• isi snapshot writable view
• isi snmp settings modify
• isi snmp settings view
• isi ssh settings modify
• isi statistics client
• isi statistics data-reduction
• isi statistics data-reduction view
• isi statistics drive
• isi statistics heat
• isi statistics list keys
• isi statistics list operations
• isi statistics protocol
• isi statistics pstat
• isi statistics query current
• isi statistics query history
• isi status
• isi storagepool health
• isi storagepool list
• isi storagepool nodepools create
• isi storagepool nodepools delete
• isi storagepool nodepools list
• isi storagepool nodepools modify
• isi storagepool nodepools view
• isi storagepool nodetypes list
• isi storagepool settings modify

466 OneFS isi 命令 S 至 Z


• isi storagepool settings view
• isi storagepool tiers create
• isi storagepool tiers delete
• isi storagepool tiers list
• isi storagepool tiers modify
• isi storagepool tiers view
• isi storagepool unprovisioned view
• isi swift accounts create
• isi swift accounts delete
• isi swift accounts list
• isi swift accounts modify
• isi swift accounts view
• isi sync certificates peer delete
• isi sync certificates peer import
• isi sync certificates peer list
• isi sync certificates peer modify
• isi sync certificates peer view
• isi sync certificates server delete
• isi sync certificates server import
• isi sync certificates server list
• isi sync certificates server modify
• isi sync certificates server view
• isi sync jobs cancel
• isi sync jobs list
• isi sync jobs pause
• isi sync jobs reports list
• isi sync jobs reports view
• isi sync jobs resume
• isi sync jobs start
• isi sync jobs view
• isi sync policies create
• isi sync policies delete
• isi sync policies disable
• isi sync policies enable
• isi sync policies list
• isi sync policies modify
• isi sync policies reset
• isi sync policies resolve
• isi sync policies view
• isi sync recovery allow-write
• isi sync recovery resync-prep
• isi sync reports list
• isi sync reports rotate
• isi sync reports subreports list
• isi sync reports subreports view
• isi sync reports view
• isi sync rules create
• isi sync rules delete
• isi sync rules list
• isi sync rules modify
• isi sync rules reports list
• isi sync rules reports view
• isi sync rules view
• isi sync service policies create
• isi sync service policies delete
• isi sync service policies disable

OneFS isi 命令 S 至 Z 467


• isi sync service policies enable
• isi sync service policies list
• isi sync service policies modify
• isi sync service policies reset
• isi sync service policies resolve
• isi sync service policies view
• isi sync service recovery allow-write
• isi sync service recovery resync-prep
• isi sync service target break
• isi sync service target cancel
• isi sync service target list
• isi sync service target view
• isi sync settings modify
• isi sync settings view
• isi sync target break
• isi sync target cancel
• isi sync target list
• isi sync target reports list
• isi sync target reports subreports list
• isi sync target reports subreports view
• isi sync target reports view
• isi sync target view
• isi tape delete
• isi tape list
• isi tape modify
• isi tape rename
• isi tape rescan
• isi tape view
• isi upgrade cluster add-nodes
• isi upgrade cluster add-remaining-nodes
• isi upgrade cluster archive
• isi upgrade cluster assess
• isi upgrade cluster commit
• isi upgrade cluster drain
• isi upgrade cluster firmware
• isi upgrade cluster firmware start
• isi upgrade cluster from-version
• isi upgrade cluster nodes firmware
• isi upgrade cluster nodes list
• isi upgrade cluster nodes view
• isi upgrade cluster pause
• isi upgrade cluster resume
• isi upgrade cluster retry-last-action
• isi upgrade cluster rollback
• isi upgrade cluster reboot
• isi upgrade cluster settings
• isi upgrade cluster start
• isi upgrade cluster to-version
• isi upgrade cluster unblock
• isi upgrade cluster view
• isi upgrade patches abort
• isi upgrade patches install
• isi upgrade patches list
• isi upgrade patches uninstall
• isi upgrade patches view
• isi version

468 OneFS isi 命令 S 至 Z


• isi worm cdate set
• isi worm cdate view
• isi worm create
• isi worm domains create
• isi worm domains list
• isi worm domains modify
• isi worm domains view
• isi worm files delete
• isi worm files view
• isi zone restrictions create
• isi zone restrictions delete
• isi zone restrictions list
• isi zone zones create
• isi zone zones delete
• isi zone zones list
• isi zone zones modify
• isi zone zones view

isi s3 buckets create


创建 S3 存储区。

语法
isi s3 buckets create <name> <path>
[--create-path]
[--owner <string>]
[--description <string>]
[--acls <string>]
[--zone <string>]
[--object-acl-policy (replace | deny)]
[{--verbose | -v}]

选项
<name>
S3 存储区的名称。
<path>
S3 存储区的路径。必须在 /ifs 中。
--create-path
为 S3 存储区创建路径(如果尚不存在)。
---owner<string>
S3 存储区的所有者的名称。
---description<string>
S3 存储区的描述。
---acls<string>
存储区的访问控制条目的完整列表。此 ACE 列表将替换当前在存储区中的所有 ACE。例如,--acls
name=<> type=<> perm=<>。为要添加的每个额外 ACL 指定 --acls。
--zone<string>
可在其中创建 S3 存储区的访问分区。
---object-acl-policy(replace | deny)
用于修改此存储区中的对象 ACL 的策略。

OneFS isi 命令 S 至 Z 469


{--verbose | -v}
显示更多详细信息。

isi s3 buckets delete


删除 S3 存储区。

语法
isi s3 buckets delete <bucket>
[--zone <string>]
[{--force | -f}]
[{--verbose | -v}]

选项
<bucket>
S3 存储区的名称。
--zone<string>
可以从中删除 S3 存储区的访问分区。
{--force | -f}
不要求确认。
{--verbose | -v}
显示更多详细信息。

isi s3 buckets list


显示存储区的列表。

语法

isi s3 buckets list


[--zone <string>]
[--owner <string>]
[{--limit | -l} <integer>]
[--sort (id | name | owner | path | description)]
[{--descending | -d}]
[--format (table | json | csv | list)]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose| -v}]

选项
--zone<string>
显示访问分区。
--owner<string>
显示存储区所有者的名称。
{--limit | -l <string>

470 OneFS isi 命令 S 至 Z


指定 S3 存储区的数量。
--sort(id | name | owner | path | description)
按指定字段对数据进行排序。
--descending | -d
按降序对数据进行排序。
----formattable | json | csv | list
以表格、JSON、CSV 或列表格式显示 S3 存储区。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi s3 buckets modify


修改 S3 存储区。

语法
isi s3 buckets modify <bucket>
[--description <string>]
[--zone <string>]
[--acls <string> | --add-ace <string> | --remove-ace <string>]
[--object-acl-policy (replace | deny)]
[{--verbose | -v}]

选项
<bucket>
S3 存储区的名称。
---description<string>
S3 存储区的描述。
--zone<string>
可在其中修改 S3 存储区的访问分区。
---acls<string>
存储区的访问控制条目的完整列表。此 ACE 列表将替换当前在存储区中的所有 ACE。例如,--acls
name=<> type=<> perm=<>。为要添加的每个额外 ACL 指定 --acls。
---object-acl-policy(replace | deny)
用于修改此存储区中的对象 ACL 的策略。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 471


isi s3 buckets view
显示 S3 存储区的详细信息。

语法
isi s3 buckets view <bucket>
[--zone <string>]]

选项
<bucket>
显示存储区的名称。
--zone<string>
显示在其中查看 S3 存储区的访问分区的名称。

isi services s3 disable


在群集上禁用 S3 服务。

语法
isi services s3 disable

isi services s3 enable


在群集上启用 S3 服务。

语法
isi services s3 enable

isi s3 keys create


创建 S3 密钥。

语法
isi s3 keys create <user>
[{--existing-key-expiry-time | -E} <integer>]
[--zone <string>]
[{--force | -f}]
[--show-key]
[{--verbose | -v}]

472 OneFS isi 命令 S 至 Z


选项
<user>
为其执行操作的用户。
{--existing-key-expiry-time | -E}
以前密钥的到期时间(以分钟为单位)。
--zone<string>
指定用户的访问分区。
{--force| -f}
强制创建新密钥并删除旧密钥。
{--show-key| -f}
显示密钥。
{--verbose | -v}
显示更多详细信息。

isi s3 keys delete


删除 S3 密钥。

语法
isi s3 keys delete <user>
[--zone <string>]
[{--force | -f}]
[{--verbose | -v}]

选项
<user>
为其执行操作的用户。
--zone<string>
指定用户的访问分区。
{--force| -f}
强制创建新密钥并删除旧密钥。
{--verbose | -v}
显示更多详细信息。

isi s3 log-level
管理 s3 服务的日志级别。

语法

isi s3 log-level <action>


[--timeout <integer>]

OneFS isi 命令 S 至 Z 473


选项
<action>
必须执行的操作。
--timeout <integer>
命令超时秒数(指定为 isi --timeout NNN <command>)。

isi s3 log-level modify


修改 s3 服务的日志级别。

语法
isi s3 log-level modify <level> (always | error | warning | info | verbose |debug |
trace | unknown)
[{--verbose | -v}]

选项
<级别>
s3 服务的日志记录级别。有效日志记录级别包括“always”、“error”、“warning”、“info”、“verbose”、
“debug”和“trace”。
{--verbose | -v}
显示更多详细信息。

isi s3 log-level view


显示 s3 服务的日志级别。

语法
isi s3 log-level view

isi s3 mykeys create


创建 S3 密钥。

语法
isi s3 mykeys create
[{--existing-key-expiry-time | -E} <integer>]
[{--force | -f}]
[--show-key]
[{--verbose | -v}]

474 OneFS isi 命令 S 至 Z


选项
{--existing-key-expiry-time | -E}
以前密钥的到期时间(以分钟为单位)。
{--force | -f}
强制创建新密钥并删除旧密钥。
{--show-key}
显示密钥。
{--verbose | -v}
显示更多详细信息。

isi s3 mykeys delete


删除 S3 密钥。

语法
isi s3 mykeys delete
[{--force | -f}]
[{--verbose | -v}]

选项
{--force | -f}
删除密钥时不要求确认。
{--verbose | -v}
显示更多详细信息。

isi s3 mykeys view


显示 s3 密钥。

语法
isi s3 mykeys view
[--show-key]

选项
{--show-key }
显示密钥。

OneFS isi 命令 S 至 Z 475


isi s3 settings global modify
修改默认 S3 全局选项。

语法
isi s3 settings global modify
[--http-port <integer>]
[--https-port <integer>]
[--https-only <boolean>]
[{--force | -f}]
[{--verbose | -v}]

选项
--http-port <integer>
S3 服务器在其上侦听传入 HTTP 连接的 TCP/IP 端口号。
--https-port <integer>
S3 服务器在其上侦听传入 HTTPS 连接的 TCP/IP 端口号。
--https-only <boolean>
如果设置此标记,S3 仅接受 HTTPS 流量。
{--force| -f}
不要求确认。
{--verbose | -v}
显示更多详细信息。

isi s3 settings global view


查看全局 s3 设置。

语法
isi s3 settings global view

isi s3 settings zone modify


修改默认 S3 分区选项。

语法
isi s3 settings zone modify
[--root-path <path>]
[--revert-root-path]
[--base-domain <string>]
[--object-acl-policy (replace | deny)]
[--bucket-directory-create-mode <integer-octal>]
[--use-md5-for-etag <boolean>]
[--validate-content-md5 <boolean>]
[--zone <string>]
[{--verbose | -v}]

476 OneFS isi 命令 S 至 Z


选项
[--root-path < 路径 > ]
S3 存储区的根路径。根路径必须在访问分区基本路径内。
--revert-root-path
对于 --root-path,将值设置为默认值 system。
[--base-domain < 字符串 > ]
基本域用于指示使用虚拟主机样式寻址的对象地址的域名部分,使 OneFS 可以确定存储区名称。
[--object-acl-policy (replace | deny)]
此分区中的新 S3 存储区的默认对象 ACL 策略。
[--bucket-directory-create-mode < 八进制整数 >]
用于创建存储区目录的权限模式。它以八进制表示。
[--use-md5-for-etag< 布尔值 >]
上传时将 MD5 用于 Etag。
--validate-content-md5< 布尔值 >]
验证给定 Content-MD5。
--zone <string>
访问分区的名称。
{--verbose | -v}
显示更多详细信息。

isi s3 settings zone view


显示 S3 分区选项。

语法
isi s3 settings zone view
[--zone <string>]

选项
--zone <string>
访问分区的名称。

isi servicelight list


按节点显示群集中的服务 LED 以及每个服务 LED 的状态的列表。

语法
isi servicelight list
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

OneFS isi 命令 S 至 Z 477


选项
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{ --no-header | -a}
显示不带页眉的表和 CSV 输出。
{ --no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi servicelight modify


打开或关闭节点服务 LED。

语法
isi servicelight modify
[--enabled <布尔值>]
[--node-lnn <整数>]
[--verbose]

选项
--enabled<boolean>
启用或禁用的节点服务 LED。
--node-lnn<integer>
指定要修改服务指示灯状态的节点。如果省略,将使用本地节点。
{--verbose | -v}
显示更多详细信息。

isi servicelight view


显示节点服务 LED 的状态。

语法
isi servicelight view
[--node-lnn <整数>]

选项
--node-lnn<integer>
指定要查看的节点。如果省略,将显示本地节点的服务 LED 状态。

478 OneFS isi 命令 S 至 Z


isi services
显示可用服务的列表。-l 和 -a 选项可以分开使用,也可以配合使用。

语法

isi services
[-l | -a]
[<service> [{enable | disable}]]

选项
-l
列出所有可用服务和每个服务的当前状态。这是此命令的默认值。
- a
列出所有服务(包括隐藏服务)和每个服务的当前状态。
注: 将 - a 选项与 enable 或 disable 选项配合使用时可能产生意外效果。如果必须将 - a 与
enable 或 disable 选项配合使用,请联系 PowerScale 技术支持 以获得帮助。

<service> {enable | disable}


启用或禁用指定服务。

示例
以下示例显示用于启用 ftp 服务的命令。

isi services vsftpd enable

isi set
工作方式类似于 chmod,提供了一种机制来调整特定于 OneFS 的文件属性(如请求的保护)或显式地对文件重新分条。 可以
按路径或 LIN 指定文件。

语法
isi set
[-f -F -L -n -v -r -R]
[-p <policy>]
[-w <width>]
[-c {on | off}]
[-g <restripe_goal>]
[-e <encoding>]
[-d <@r drives>]
[-a {<default> | <streaming> | <random> | <custom{1..5}> | <disabled>}]
[-l {<concurrency> | <streaming> | <random>}]
[--diskpool {<id> | <name>}]
[-A {on | off}]
[-P {on | off}]
[{--strategy | -s} {<avoid> | <metadata> | <metadata-write> |
<data>]
[<file> {<path> | <lin>}]

OneFS isi 命令 S 至 Z 479


选项
-f
禁止在更改文件失败时显示警告。
-F
包含 /ifs/.ifsvar 目录内容及其所有子目录。 未使用 -F 时,会跳过 /ifs/.ifsvar 目录内容及
其所有子目录。 此设置允许指定可能危险的、不受支持的保护策略。
-L
按 LIN(而不是路径)指定文件参数。
-n
显示会更改的文件的列表而不执行任何操作。
-v
在到达各个文件时显示文件。
-r
运行重新分条。
-R
以递归方式对文件设置保护。
-p< 策略 >
采用以下形式指定保护策略:

+M 其中 M 是在不丢失数据的情况下可以容忍的节点故障数。 +M 必须是数字(数字 1
到 4 有效)。

+D:M 其中 D 指示驱动器故障数,而 M 指示在不丢失数据的情况下可以容忍的节点故障


数。 D 必须是 1 到 4 的数字,M 必须是可以将 D 均分的任何值。 例如,+2:2 和
+4:2 有效,但是 +1:2 和 +3:2 无效。

Nx 其中 N 是将存储的数据的独立镜像拷贝数。 N 必须是数字(1 到 8 是有效选


择)。

-w< 宽度 >
指定文件分条所跨越的节点数。 通常,w = N + M,但是宽度也可以表示使用的节点总数。
您可以设置的最大宽度策略为 32,但是实际保护仍受 N 和 M 的限制。
-c {on | off}
指定写合并是否已打开。
-g< 重新分条目标 >
指定重新分条目标。 以下值有效:
repair
reprotect
rebalance
retune
-e< 编码 >
指定文件名的编码。 以下值有效:
EUC-JP
EUC-JP-MS
EUC-KR
ISO-8859-1
ISO-8859-10

480 OneFS isi 命令 S 至 Z


ISO-8859-13
ISO-8859-14
ISO-8859-15
ISO-8859-160
ISO-8859-2
ISO-8859-3
ISO-8859-4
ISO-8859-5
ISO-8859-6
ISO-8859-7
ISO-8859-8
ISO-8859-9
UTF-8
UTF-8-MAC
Windows-1252
Windows-949
Windows-SJIS
-d<@r 驱动器 >
指定文件跨越的最小驱动器数。
-a< 值 >
指定文件访问模式优化设置。 以下值有效:
default
streaming
random
custom1
custom2
custom3
custom4
custom5
disabled
-l< 值 >
指定文件布局优化设置。 这等效于同时设置 -a 和 -d 标记。
concurrency
streaming
random
--diskpool <id | 名称 >
设置文件的首选磁盘池。
-A {on | off}
指定是否应手动管理文件访问和保护设置。
-P {on | off}
指定文件是否从适用文件池策略继承值。
{--strategy | -s} < 值 >
设置文件的 SSD 策略。 以下值有效:

OneFS isi 命令 S 至 Z 481


如果值是 metadata-write,则文件元数据的所有拷贝都置于 SSD 存储上(如果可以),而用户数据仍避
免使用 SSD。 如果值是 data,则文件的元数据和用户数据(如果使用镜像保护,则是一个拷贝;如果使
用 FEC,则是所有数据块)都置于 SSD 存储上(如果可以)。

avoid 仅将所有关联文件数据和元数据写入 HDD。 会存储文件的数据和元数据,以便避


免使用 SSD 存储,除非这样做会形成空间不足状况。

metadata 将文件数据和元数据均写入 HDD。 文件元数据的一个镜像位于 SSD 存储上(如


果可以),但是数据的策略是避免使用 SSD 存储。

metadata- 将文件数据写入 HDD,将元数据写入 SSD(可用时)。 文件元数据的所有拷贝均


write 位于 SSD 存储上(如果可以),而数据的策略是避免使用 SSD 存储。

data 将 SSD 节点池同时用于数据和元数据。 文件元数据和用户数据(如果使用镜像保


护,则是一个拷贝;如果使用 FEC,则是所有数据块)都位于 SSD 存储上(如果
可以)

<文件> { <路径> | 按路径或 LIN 指定文件。


<LIN> }

isi smb log-level filters create


创建新 SMB 日志筛选器。

语法
isi smb log-level filters create < 级别 >
[--ops < 字符串 >]
[--ip-addrs < 字符串 >]
[--verbose]

选项
< 级别 >
新筛选器的日志记录级别。有效日志记录级别包括:
● always
● error
● warning
● info
● verbose
● debug
● trace
{--ops | -o} < 字符串 >
列出要据以筛选的所有 SMB 操作。针对每个操作重复此项。
{--ip-addrs | -i} < 字符串 >
列出要据以筛选的 IPv4 和 IPv6 地址。针对每个 IP 地址重复此项。

482 OneFS isi 命令 S 至 Z


isi smb log-level filters delete
删除 SMB 日志筛选器。

语法
isi smb log-level filters delete <ID> < 级别 >
[--all]
[--force]
[--verbose]

选项
<ID>
按 ID 删除特定 SMB 日志筛选器。
< 级别 >
删除指定级别的所有 SMB 日志筛选器。以下级别有效:
● always
● error
● warning
● info
● verbose
● debug
● trace
--all
删除所有 SMB 日志级别筛选器。
{--force | -f}
跳过删除确认提示。
{verbose | -v}
显示更多详细信息。

isi smb log-level filters list


列出 SMB 日志筛选器。

语法
isi smb log-level filters list
[--limit < 整数 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示指定数量的 SMB 日志级别筛选器。
--format {table | json | csv | list}
以表格、JSON、逗号分隔或列表格式显示 SMB 日志级别筛选器。

OneFS isi 命令 S 至 Z 483


{--no-header | -a}
不会以逗号分隔或表格格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

isi smb log-level filters view


查看单个 SMB 日志级别筛选器。

语法
isi smb log-level filters view <ID>
[--level < 字符串 >]

选项
<ID>
要查看的 SMB 日志级别筛选器的 ID。
{--level | -l} < 字符串 >
指定要查看的日志级别。以下级别有效:
● always
● error
● warning
● info
● verbose
● debug
● trace

isi smb log-level modify


设置 SMB 服务的日志级别。

语法
isi smb log-level modify < 级别 >
[--verbose]

选项
< 级别 >
指定要为 SMB 服务设置的日志级别。以下级别有效:
● always
● error
● warning
● info
● verbose
● debug

484 OneFS isi 命令 S 至 Z


● trace
{--verbose | -v}
显示更多详细信息。

isi smb log-level view


显示 SMB 服务的当前日志级别。

语法
isi smb log-level view

选项
此命令没有选项。

isi smb openfiles close


关闭打开的文件。
注:

要查看打开的文件列表,请运行 isi smb openfiles list 命令。

语法
isi smb openfiles close <id>
[--force]

选项
<ID>
指定要关闭的打开文件的 ID。
{--force | -f}
禁止显示命令行提示符和消息。

示例
以下命令将关闭 ID 为 32 的文件:

isi smb openfiles close 32

OneFS isi 命令 S 至 Z 485


isi smb openfiles list
显示在 SMB 共享中处于打开状态的文件列表。

语法
isi smb openfiles list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的 SMB 开启文件数量。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi smb sessions delete


删除先按计算机然后按用户(可选)筛选的 SMB 会话。

注: 在删除 SMB 会话之前,任何打开的文件都将自动关闭。

语法
isi smb sessions delete <computer-name>
[{--user <name> | --uid <id> | --sid <sid>}]
[--force]
[--verbose]

选项
< 计算机名称 >
必需。 指定计算机名称。 如果未指定 --user、--uid 或 --sid 选项,系统将删除与该计算机关联的
所有 SMB 会话。
--user< 字符串 >
指定用户的名称。 仅删除与指定用户关联的计算机的 SMB 会话。
--uid<ID>
指定数字用户标识符。 仅删除与指定用户标识符关联的计算机的 SMB 会话。

486 OneFS isi 命令 S 至 Z


--sid<SID>
指定安全标识符。 仅删除与安全标识符关联的计算机的 SMB 会话。
{--force | -f}
指定执行命令时无需提示进行确认。

示例
以下命令将删除与名为 computer1 的计算机关联的所有 SMB 会话。

isi smb sessions delete computer1

以下命令将删除与名为 computer1 的计算机和名为 user1 的用户关联的所有 SMB 会话:

isi smb sessions delete computer1 --user=user1

isi smb sessions delete-user


删除先按用户然后按计算机(可选)筛选的 SMB 会话。
注:

在删除 SMB 会话之前,任何打开的文件都将自动关闭。

语法
isi smb sessions delete-user {<user> | --uid <id> | --sid <sid> }
[--computer-name <string>]
[--force]
[--verbose]

选项
<user>
必需。 指定用户名。 如果忽略 --computer-name 选项,系统将删除与该用户关联的所有 SMB 会
话。
{--computer-name | -C} < 字符串 >
仅删除与指定计算机关联的用户 SMB 会话。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示更多详细信息。

示例
下列命令将删除与名为 user1 的用户关联的所有 SMB 会话:

isi smb sessions delete-user user1

下列命令将删除与名为 user1 的用户和名为 computer1 的计算机关联的所有 SMB 会话:

isi smb sessions delete-user user1 \


--computer-name=computer1

OneFS isi 命令 S 至 Z 487


isi smb sessions list
显示打开的 SMB 会话的列表。

语法
isi smb sessions list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
指定要列出的 SMB 会话的最大数目。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi smb settings global modify


修改全局 SMB 设置。

语法
isi smb settings global modify
[--access-based-share-enum {yes | no}]
[--revert-access-based-share-enum]
[--dot-snap-accessible-child {yes | no}]
[--revert-dot-snap-accessible-child]
[--dot-snap-accessible-root]
[--revert-dot-snap-accessible-root]
[--dot-snap-visible-child {yes | no}]
[--revert-dot-snap-visible-child]
[--dot-snap-visible-root {yes | no}]
[--revert-dot-snap-visible-root]
[--enable-security-signatures {yes | no}]
[--revert-enable-security-signatures]
[--guest-user <string>]
[--revert-guest-user]
[--ignore-eas {yes | no}]
[--revert-ignore-eas]
[--onefs-cpu-multiplier <integer>]
[--revert-onefs-cpu-multiplier]
[--onefs-num-workers <integer>]
[--revert-onefs-num-workers]
[--reject-unencrypted-access {yes | no}]

488 OneFS isi 命令 S 至 Z


[--revert-reject-unencrypted-access]
[--require-security-signatures {yes | no}]
[--revert-require-security-signatures]
[--server-side-copy {yes | no}]
[--revert-server-side-copy]
[--server-string <string>]
[--revert-server-string]
[--support-multichannel {yes | no}]
[--revert-support-multichannel]
[--support-netbios {yes | no}]
[--revert-support-netbios]
[--support-smb2 {yes | no}]
[--revert-support-smb2]
[--support-smb3-encryption {yes | no}]
[--revert-support-smb3-encryption]
[--verbose]

选项
--access-based-share-enum {yes | no}
仅枚举请求用户有权访问的文件和文件夹。
--revert-access-based-share-enum
将值设置为 --access-based-share-enum 的系统默认值。
--dot-snap-accessible-child {yes | no}
指定是否使 /ifs/.snapshot 目录在共享根目录的子目录中可见。默认设置为 no。
--revert-dot-snap-accessible-child
将值设置为 --dot-snap-accessible-child 的系统默认值。
--dot-snap-accessible-root {yes | no}
指定是否使 /ifs/.snapshot 目录在共享根目录中可供访问。默认设置为 yes。
--revert-dot-snap-accessible-root
将值设置为 --dot-snap-accessible-root 的系统默认值。
--dot-snap-visible-child {yes | no}
指定是否使 /ifs/.snapshot 目录在共享根目录的子目录中可见。默认设置为 no。
--revert-dot-snap-visible-child
将值设置为 --dot-snap-visible-child 的系统默认值。
--dot-snap-visible-root {yes | no}
指定是否使 /ifs/.snapshot 目录在共享根目录中可见。默认设置为 no。
--revert-dot-snap-visible-root
将值设置为 --dot-snap-visible-root 的系统默认值。
--enable-security-signatures {yes | no}
指示服务器是否支持签名的 SMB 数据包。
--revert-enable-security-signatures
将值设置为 --enable-security-signatures 的系统默认值。
--guest-user < 整数 >
指定用于来宾访问的完全限定的用户。
--revert-guest-user
将值设置为 --guest-user 的系统默认值。
--ignore-eas {yes | no}
指定是否忽略文件上的 EA。
--revert-ignore-eas
将值设置为 --ignore-eas 的系统默认值。
--onefs-cpu-multiplier < 整数 >
指定要根据 CPU 数量进行配置的 OneFS 工作线程的数量。有效数量为 1-4。

OneFS isi 命令 S 至 Z 489


--revert-onefs-cpu-multiplier
将值设置为 --onefs-cpu-multiplier 的系统默认值。
--onefs-num-workers < 整数 >
指定允许配置的 OneFS 工作线程的数量。有效数量为 0-1024。如果设置为 0,则 SRV 工作进程的数量
将等于按 CPU 数量的 --onefs-cpu-multiplier 倍指定的值。
--revert-onefs-num-workers
将值设置为 --onefs-num-workers 的系统默认值。
--reject-unencrypted-access {yes | no}
拒绝未加密的客户端会话。
--revert-reject-unencrypted-access
将值设置为 --reject-unencrypted-access 的系统默认值。
--require-security-signatures {yes | no}
指定是否需要数据包签名。如果设置为 yes,则始终需要签名。如果设置为 no,则不需要签名,但如果
--enable-security-signatures 选项设置为 yes,将允许请求签名的客户端进行连接。
--revert-require-security-signatures
将值设置为 --require-security-signatures 的系统默认值。
--server-side-copy {yes | no}
启用或禁用 SMB 服务器端拷贝功能。默认值为 yes。
--revert-server-side-copy
将值设置为 --server-side-copy 的系统默认值。
--server-string < 字符串 >
提供服务器的描述。
--revert-server-string
将值设置为 --revert-server-string 的系统默认值。
--support-multichannel {yes | no}
指定是否在群集上为 SMB 3.0 启用多渠道。默认情况下 SMB 多渠道处于启用状态。
--revert-support-multichannel
将 --support-multichannel 的值设置回默认系统值。
--support-netbios {yes | no}
指定是否支持 NetBIOS 协议。
--revert-support-netbios
将值设置为 --support-netbios 的系统默认值。
--support-smb2 {yes | no}
指定是否支持 SMB 2.0 协议。默认设置为 yes。
--revert-support-smb2
将值设置为 --support-smb2 的系统默认值。
--support-smb3-encryption {yes | no}
在群集上启用 SMBv3 加密。默认设置为 no。
--revert-support-smb3-encryption
将值设置为 --support-smb3-encryption 的系统默认值。

isi smb settings global view


显示默认 SMB 配置设置。

语法
isi smb settings global view

490 OneFS isi 命令 S 至 Z


选项
此命令没有选项。

isi smb settings shares modify


Modifies default settings for SMB shares.

Syntax
isi smb settings shares modify
[--access-based-enumeration {yes | no}]
[--revert-access-based-enumeration]
[--access-based-enumeration-root-only {yes | no}]
[--revert-access-based-enumeration-root-only]
[--allow-delete-readonly {yes | no}]
[--revert-allow-delete-readonly]
[--allow-execute-always {yes | no}]
[--revert-allow-execute-always]
[--ca-timeout <integer>]
[--revert-ca-timeout]
[--strict-ca-lockout {yes | no}]
[--revert-strict-ca-lockout]
[--ca-write-integrity {none | write-read-coherent | full}]
[--revert-ca-write-integrity]
[--change-notify {all | norecurse | none}]
[--revert-change-notify]
[--create-permissions {"default acl" | "inherit mode bits" | "use create mask and
mode"}]
[--revert-create-permissions]
[--directory-create-mask <integer>]
[--revert-directory-create-mask]
[--directory-create-mode <integer>]
[--revert-directory-create-mode]
[--file-create-mask <integer>]
[--revert-file-create-mask]
[--file-create-mode <integer>]
[--revert-file-create-mode]
[--file-filtering-enabled {yes | no}]
[--revert-file-filtering-enabled]
[--file-filter-extensions <string>]
[--clear-file-filter-extensions]
[--add-file-filter-extensions <string>]
[--remove-file-filter-extensions <string>]
[--revert-file-filter-extensions]
[--file-filter-type {deny | allow}
[--revert-file-filter-type]
[--hide-dot-files {yes | no}]
[--revert-hide-dot-files]
[--host-acl <host-acl>]
[--revert-host-acl]
[--clear-host-acl]
[--add-host-acl <string>]
[--remove-host-acl <string>]
[--impersonate-guest {always | "bad user" | never}]
[--revert-impersonate-guest]
[--impersonate-user <string>]
[--revert-impersonate-user]
[--mangle-byte-start <integer>]
[--revert-mangle-byte-start]
[--mangle-map <mangle-map>]
[--revert-mangle-map]
[--clear-mangle-map]
[--add-mangle-map <string>]
[--remove-mangle-map <string>]
[--ntfs-acl-support {yes | no}]
[--revert-ntfs-acl-support]

OneFS isi 命令 S 至 Z 491


[--oplocks {yes | no}]\
[--revert-oplocks]
[--smb3-encryption-enabled {yes | no}]
[--revert-smb3-encryption-enabled]
[--strict-flush {yes | no}]
[--revert-strict-flush]
[--strict-locking {yes | no}]
[--revert-strict-locking]
[--zone <string>]

Options
--access-based-enumeration {yes | no}
Specifies whether access-based enumeration is enabled.
--revert-access-based-enumeration
Sets the value to the system default for --access-based-enumeration.
--access-based-enumeration-root-only {yes | no}
Specifies whether access-based enumeration is only enabled on the root directory of the share.
--revert-access-based-enumeration-root-only
Sets the value to the system default for --access-based-enumeration-root-only.
--allow-delete-readonly {yes | no}
Specifies whether read-only files can be deleted.
--revert-allow-delete-readonly
Sets the value to the system default for --allow-delete-readonly.
--allow-execute-always {yes | no}
Specifies whether a user with read access to a file can also execute the file.
--revert-allow-execute-always
Sets the value to the system default for --allow-execute-always.
--ca-timeout <integer>
The amount of time, in seconds, a persistent handle is retained after a client is disconnected or a server
fails. The default is 120 seconds.
--revert-ca-timeout
Sets the value to the system default for --ca-timeout.
--strict-ca-lockout {yes | no}
If set to yes, prevents another client from opening a file if a client has an open but disconnected
persistent handle for that file. If set to no, OneFS issues persistent handles, but discards them if
any client other than the original opener attempts to open the file. This option is only relevant if
--continuously-available was set to yes when the share was created. The default is yes.
--revert-strict-ca-lockout
Sets the value to the system default for --strict-ca-lockout.
--ca-write-integrity {none | write-read-coherent | full}
Specifies the level of write integrity on continuously available shares:

none Continuously available writes are not handled differently than other writes to
the cluster. If you specify none and a node fails, you may experience data loss
without notification. Therefore, we do not recommend this option.
write-read- Ensures that writes to the share are moved to persistent storage before a
coherent success message is returned to the SMB client that sent the data. This is the
default setting.
full Ensures that writes to the share are moved to persistent storage before a
success message is returned to the SMB client that sent the data, and prevents
OneFS from granting SMB clients write-caching and handle-caching leases.

--revert-ca-write-integrity

492 OneFS isi 命令 S 至 Z


Sets the value to the system default for --ca-write-integrity.
--change-notify {norecurse | all | none}
Defines the change notify setting. The acceptable values are norecurse, all, and none.
--revert-change-notify
Sets the value to the system default for --change-notify.
--create-permissions {"default acl" | "inherit mode bits" | "use create mask and mode"}
Sets the default permissions to apply when a file or directory is created.
--revert-create-permissions
Sets the value to the system default for --create-permissions.
--directory-create-mask <integer>
Defines which mask bits are applied when a directory is created.
--revert-directory-create-mask
Sets the value to the system default for --directory-create-mask.
--directory-create-mode <integer>
Defines which mode bits are applied when a directory is created.
--revert-directory-create-mode
Sets the value to the system default for --directory-create-mode.
--file-create-mask <integer>
Defines which mask bits are applied when a file is created.
--revert-file-create-mask
Sets the value to the system default for --file-create-mask.
--file-create-mode <integer>
Defines which mode bits are applied when a file is created.
--revert-file-create-mode
Sets the value to the system default for --file-create-mode.
--file-filtering-enabled {yes | no}
If set to yes, enables file filtering at the share level. The default setting is no.
--revert-file-filtering-enabled
Sets the value for the system default of --file-filtering-enabled.
--file-filter-type {deny | allow}
If set to allow, allows the specified file types to be written to the share. The default setting is deny.
--revert-file-filter-type
Sets the value for the system default of --file-filter-type.
--file-filter-extensions <string>
Specifies the list of file types to deny or allow writes to the share, depending on the setting of --file-
filter-type. File types may be specified in a list of comma separated values.
--clear-file-filter-extensions
Clears the list of file filtering extensions for the share.
--add-file-filter-extensions <string>
Adds entries to the list of file filter extensions. Repeat for each file extension to add.
--remove-file-filter-extensions <string>
Removes entries to the list of file filter extensions. Repeat for each file extension to remove.
--revert-file-filter-extensions
Sets the value for the system default of --file-filter-extensions.
--hide-dot-files {yes | no}
Specifies whether to hide files that begin with a period—for example, UNIX configuration files.
--revert-hide-dot-files
Sets the value to the system default for --hide-dot-files.

OneFS isi 命令 S 至 Z 493


--host-acl <string>
Specifies which hosts are allowed access. Specify --host-acl for each additional host ACL clause.
This will replace any existing ACL.
--revert-host-acl
Sets the value to the system default for --host-acl.
--clear-host-acl <string>
Clears the value for an ACL expressing which hosts are allowed access.
--add-host-acl <string>
Adds an ACE to the already-existing host ACL. Specify --add-host-acl for each additional host ACL
clause to be added.
--remove-host-acl <string>
Removes an ACE from the already-existing host ACL. Specify --remove-host-acl for each
additional host ACL clause to be removed.
--impersonate-guest {always | "bad user" | never}
Allows guest access to the share. The acceptable values are always, "bad user", and never.
--revert-impersonate-guest
Sets the value to the system default for --impersonate-guest.
--impersonate-user <string>
Allows all file access to be performed as a specific user. This must be a fully qualified user name.
--revert-impersonate-user
Sets the value to the system default for --impersonate-user.
--mangle-byte-start <string>
Specifies the wchar_t starting point for automatic invalid byte mangling.
--revert-mangle-byte-start
Sets the value to the system default for --mangle-byte-start.
--mangle-map <string>
Maps characters that are valid in OneFS but are not valid in SMB names.
--revert-mangle-map
Sets the value to the system default for --mangle-map.
--clear-mangle-map <string>
Clears the values for character mangle map.
--add-mangle-map <string>
Adds a character mangle map. Specify --add-mangle-map for each additional Add character mangle
map.
--remove-mangle-map <string>
Removes a character mangle map. Specify --remove-mangle-map for each additional Remove
character mangle map.
--ntfs-acl-support {yes | no}
Specifies whether ACLs can be stored and edited from SMB clients.
--revert-ntfs-acl-support
Sets the value to the system default for --ntfs-acl-support.
--oplocks {yes | no}
Specifies whether to allow oplock requests.
--revert-oplocks
Sets the value to the system default for --oplocks.
--smb3-encryption-enabled {yes | no}
Enables SMBv3 encryption on the share. The default setting is no.
--revert-smb3-encryption-enabled
Sets the value to the system default for --smb3-encryption-enabled.

494 OneFS isi 命令 S 至 Z


--strict-flush {yes | no}
Specifies whether to always honor flush requests.
--revert-strict-flush
Sets the value to the system default for --strict-flush.
--strict-locking {yes | no}
Specifies whether the server will check for and enforce file locks.
--revert-strict-locking
Sets the value to the system default for --strict-locking.
--zone <string>
Specifies the name of the access zone.

isi smb settings shares view


显示所有 SMB 共享或指定访问分区中的 SMB 共享的默认设置。

语法
isi smb settings shares view
[--zone <string>]

选项
--zone < 字符串 >
指定访问分区的名称。仅显示指定分区中的共享的设置。

isi smb settings zone modify


修改特定访问分区的 SMB 设置。

语法
isi smb settings zone modify
[--access-based-share-enum {yes | no}]
[--revert-access-based-share-enum]
[--enable-security-signatures {yes | no}]
[--revert-enable-security-signatures]
[--reject-unencrypted-access {yes | no}]
[--revert-reject-unencrypted-access]
[--require-security-signatures {yes | no}]
[--revert-require-security-signatures]
[--server-side-copy {yes | no}]
[--revert-server-side-copy]
[--support-multichannel {yes | no}]
[--revert-support-multichannel]
[--support-smb2 {yes | no}]
[--revert-support-smb2]
[--support-smb3-encryption {yes | no}]
[--revert-support-smb3-encryption]
[--zone <string>]
[--verbose]

OneFS isi 命令 S 至 Z 495


选项
--access-based-share-enum {yes | no}
仅枚举请求用户有权访问的文件和文件夹。
--revert-access-based-share-enum
将值设置为 --access-based-share-enum 的系统默认值。
--enable-security-signatures {yes | no}
指示服务器是否支持签名的 SMB 数据包。
--revert-enable-security-signatures
将值设置为 --enable-security-signatures 的系统默认值。
--reject-unencrypted-access {yes | no}
拒绝未加密的客户端会话。
--revert-reject-unencrypted-access
将值设置为 --reject-unencrypted-access 的系统默认值。
--require-security-signatures {yes | no}
指定是否需要数据包签名。如果设置为 yes,则始终需要签名。如果设置为 no,则不需要签名,但如果
--enable-security-signatures 选项设置为 yes,将允许请求签名的客户端进行连接。
--revert-require-security-signatures
将值设置为 --require-security-signatures 的系统默认值。
--server-side-copy {yes | no}
启用或禁用 SMB 服务器端拷贝功能。默认值为 yes。
--revert-server-side-copy
将值设置为 --server-side-copy 的系统默认值。
--support-multichannel {yes | no}
指定是否在群集上为 SMB 3.0 启用多渠道。默认情况下 SMB 多渠道处于启用状态。
--revert-support-multichannel
将 --support-multichannel 的值设置回默认系统值。
--support-smb2 {yes | no}
指定是否支持 SMB 2.0 协议。默认设置为 yes。
--revert-support-smb2
将值设置为 --support-smb2 的系统默认值。
--support-smb3-encryption {yes | no}
支持访问分区的 SMBv3 加密。默认设置为 no。
--revert-support-smb3-encryption
将值设置为 --support-smb3-encryption 的系统默认值。
--zone < 字符串 >
访问分区。

isi smb settings zone view


查看特定访问分区的 SMB 设置。

语法
isi smb settings zone view
[--zone <string>]

496 OneFS isi 命令 S 至 Z


选项
--zone < 字符串 >
要查看其 SMB 设置的访问分区的名称。

isi smb shares create


创建 SMB 共享。

语法
isi smb shares create <name> <path>
[--zone <string>]
[--inheritable-path-acl {yes | no}]
[--create-path]
[--host-acl <string>]
[--description <string>]
[--csc-policy {none | documents | manual | programs}]
[--allow-variable-expansion {yes | no}]
[--auto-create-directory {yes | no}]
[--browsable {yes | no}]
[--allow-execute-always {yes | no}]
[--directory-create-mask <integer>]
[--strict-locking {yes | no}]
[--hide-dot-files {yes | no}]
[--impersonate-guest {always | "bad user" | never}]
[--strict-flush {yes | no}]
[--access-based-enumeration {yes | no}]
[--access-based-enumeration-root-only {yes | no}]
[--continuously-available {yes | no}]
[--ca-timeout <integer>]
[--strict-ca-lockout {yes | no}]
[--ca-write-integrity {none | write-read-coherent | full}]
[--mangle-byte-start <string>]
[--file-create-mask <integer>]
[--create-permissions {"default acl" | "inherit mode bits"
| "use create mask and mode"}]
[--mangle-map <string>]
[--impersonate-user <string>]
[--change-notify <string>]
[--oplocks {yes | no}]
[--allow-delete-readonly {yes | no}]
[--directory-create-mode <integer>]
[--ntfs-acl-support {yes | no}]
[--file-create-mode <integer>]
[--file-filtering-enabled {yes | no}]
[--file-filter-type {deny | allow}]
[--file-filter-extensions <string>]
[--smb3-encryption-enabled {yes | no}]

选项
<name>
必需。指定新 SMB 共享的名称。
<path>
必需。指定要创建的 SMB 共享的完整路径,以 /ifs 开头。
--zone < 字符串 >
指定将新 SMB 共享分配到其中的访问分区。如果未指定访问分区,则将新 SMB 共享分配给默认
System 分区。

OneFS isi 命令 S 至 Z 497


{--inheritable-path-acl | -i} {yes | no}
如果设置为 yes 且父目录有可继承的访问控制列表 (ACL),则将在共享路径上继承其 ACL。默认设置为
no。
--create-path
创建 SMB 共享路径(如果尚不存在)。
--host-acl < 字符串 >
指定定义主机访问的 ACL。为每个额外的主机 ACL 子句指定 --host-acl。
--description < 字符串 >
指定 SMB 共享的描述。
--csc-policy {none | documents | manual | programs}
为共享设置客户端缓存策略。
--allow-variable-expansion {yes | no}
指定自动扩展主目录的变量。
--directory-create-mask < 整数 >
自动创建主目录。
--browsable {yes | no}, -b {yes | no}
如果设置为 yes,则使共享在网络视图和浏览列表中可见。默认设置为 yes。
--allow-execute-always {yes | no}
如果设置为 yes,则使对文件具有读取权限的用户也可以执行文件。默认设置为 no。
--directory-create-mask < 整数 >
定义在创建目录时应用哪些掩码位。
--strict-locking {yes | no}
如果设置为 yes,指示服务器检查并强制执行文件锁定。默认设置为 no。
--hide-dot-files {yes | no}
如果设置为 yes,则隐藏以十进位开始的文件,例如 UNIX 配置文件。默认设置为 no。
--impersonate-guest {always | "bad user" | never}
允许对共享进行来宾访问。可接受的值包括 always、"bad user" 和 never。
--strict-flush {yes | no}
如果设置为 yes,将始终认可刷新请求。默认设置为 yes。
--access-based-enumeration {yes | no}
如果设置为 yes,将仅在请求用户可以访问的文件和文件夹上启用基于访问权限的枚举。默认设置为
no。
--access-based-enumeration-root-only {yes | no}
如果设置为 yes,将仅在 SMB 共享的根目录上启用基于访问权限的枚举。默认设置为 no。
--continuously-available {yes | no}
如果设置为 yes,共享允许某些 Windows 客户端打开可在网络断开连接或服务器发生故障后可回收的持
久句柄。默认值为 no。
--ca-timeout < 整数 >
在客户端断开连接或服务器出现故障后保留持久句柄的时间量(以秒为单位)。默认值是 120 秒。
--strict-ca-lockout {yes | no}
如果设置为 yes,并且另一个客户端具有该文件已打开但断开连接的持久句柄,将防止某个客户端打开
文件。如果设置为 no,OneFS 将发出持久句柄,但在非原始打开项的任何客户端尝试打开文件时废弃持
久句柄。默认值为 yes。
--ca-write-integrity {none | write-read-coherent | full}
连续可用共享上指定写入完整性的级别:

none 连续可用写入的处理方式与群集的其他写入不同。如果指定 none 且某个节点发


生故障,则可能会遇到数据丢失,而且没有通知。因此,我们不建议使用此选项。
write-read- 确保在将成功消息返回给发送数据的 SMB 客户端之前,共享写入将移到持久存
coherent 储。这是默认设置。

498 OneFS isi 命令 S 至 Z


full 确保在将成功消息返回给发送数据的 SMB 客户端之前,共享写入将移到持久存
储,并且防止 OneFS 授予 SMB 客户端写入缓存和句柄缓存租赁。

--mangle-byte-start < 字符串 >


为自动的无效字节编码识别指定 wchar_t 起点。
--file-create-mask < 整数 >
定义在创建文件时应用哪些掩码位。
--create-permissions {"default acl" | "inherit mode bits" | "use create mask and mode"}
设置在创建文件或目录时要应用的默认权限。有效值包括 "default acl"、"inherit mode
bits" 和 "use create mask and mode"
--mangle-map < 字符串 >
映射在 OneFS 中有效但在 SMB 名称中无效的字符。
--impersonate-user < 字符串 >
允许作为特定用户执行所有文件访问。该值必须是完全限定用户名。
--change-notify {norecurse | all | none}
定义更改通知设置。可接受的值包括 norecurse、all 或 none。
--oplocks {yes | no}
如果设置为 yes,则允许 oplock 请求。默认设置为 yes。
--allow-delete-readonly {yes | no}
如果设置为 yes,则允许删除只读文件。默认设置为 no。
--directory-create-mode < 整数 >
定义在创建目录时应用哪些模式位。
--ntfs-acl-support {yes | no}
如果设置为 yes,则允许在 SMB 客户端上存储和编辑 ACL。默认设置为 yes。
--file-create-mode < 整数 >
定义在创建文件时应用哪些模式位。
--file-filtering-enabled {yes | no}
如果设置为 yes,则在共享级别启用文件筛选。默认设置为 no。
--file-filter-type {deny | allow}
如果设置为 allow,则允许将指定文件类型写入共享。默认设置为 deny。
--file-filter-extensions < 字符串 >
指定拒绝或允许写入共享的文件扩展名列表,具体取决于 --file-filter-type 的设置。可以在逗号
分隔值列表中指定文件类型。
--smb3-encryption-enabled {yes | no}
在共享上启用 SMBv3 加密。

isi smb shares delete


删除 SMB 共享。

语法
isi smb shares delete < 共享 >
[--zone < 字符串 >]
[--force]
[--verbose]

OneFS isi 命令 S 至 Z 499


选项
< 共享 >
指定要删除的 SMB 共享的名称。
--zone< 字符串 >
指定将 SMB 共享分配到其中的访问分区。如果未指定访问分区,系统会删除分配给默认 System 分区
(如果找到)的、具有指定名称的 SMB 共享。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示更多详细信息。

示例
以下命令将删除“example-zone”访问分区中名为“test-smb”的共享,而不会显示警告提示:

isi smb shares delete test-smb --zone example-zone --force

isi smb shares list


显示 SMB 共享列表。

语法
isi smb shares list
[--zone <string>]
[--limit <integer>]
[--sort {name | path | description}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--zone< 字符串 >
指定访问分区。 显示指定分区中的所有 SMB 共享。 如果未指定访问分区,系统将在默认 System 分区
中显示所有 SMB 共享。
{--limit | -l} < 整数 >
指定要列出的项目的最大数量。
--sort {name | path | description}
指定作为项目排序依据的字段。
{--descending | -d}
按降序对数据进行排序。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}

500 OneFS isi 命令 S 至 Z


显示不带页脚的表输出。
--verbose | -v
显示更多详细信息。

isi smb shares modify


修改 SMB 共享的设置。

语法
isi smb shares modify <share>
[--name <string>]
[--path <path>]
[--zone <string>]
[--new-zone <string>]
[--host-acl <host-acl>]
[--revert-host-acl]
[--clear-host-acl]
[--add-host-acl <string>]
[--remove-host-acl <string>]
[--description <string>]
[--csc-policy {manual | documents | programs | none}]
[--revert-csc-policy]
[--allow-variable-expansion {yes | no}]
[--revert-allow-variable-expansion]
[--auto-create-directory {yes | no}]
[--revert-auto-create-directory {yes | no}]
[--browsable {yes | no}]
[--revert-browsable]
[--allow-execute-always {yes | no}]
[--revert-allow-execute-always]
[--directory-create-mask <integer>]
[--revert-directory-create-mask]
[--strict-locking {yes | no}]
[--revert-strict-locking]
[--hide-dot-files {yes | no}]
[--revert-hide-dot-files]
[--impersonate-guest {always | "bad user" | never}]
[--revert-impersonate-guest]
[--strict-flush {yes | no}]
[--revert-strict-flush]
[--access-based-enumeration {yes | no}]
[--revert-access-based-enumeration]
[--access-based-enumeration-root-only {yes | no}]
[--revert-access-based-enumeration-root-only]
[--ca-timeout <integer>]
[--revert-ca-timeout]
[--strict-ca-lockout {yes | no}]
[--revert-strict-ca-lockout]
[--ca-write-integrity {none | write-read-coherent | full}]
[--revert-ca-write-integrity]
[--mangle-byte-start <integer>]
[--revert-mangle-byte-start]
[--file-create-mask <integer>]
[--revert-file-create-mask]
[--create-permissions {"default acl" | "inherit mode bits"
| "use create mask and mode"}]
[--revert-create-permissions]
[--mangle-map <mangle-map>]
[--revert-mangle-map]
[--clear-mangle-map]
[--add-mangle-map <string>]
[--remove-mangle-map <string>]
[--impersonate-user <string>]
[--revert-impersonate-user]
[--change-notify {all | norecurse | none}'
[--revert-change-notify]

OneFS isi 命令 S 至 Z 501


[--oplocks {yes | no}]
[--revert-oplocks]
[--allow-delete-readonly {yes | no}]
[--revert-allow-delete-readonly]
[--directory-create-mode <integer>]
[--revert-directory-create-mode]
[--ntfs-acl-support {yes | no}]
[--revert-ntfs-acl-support]
[--file-create-mode <integer>]
[--revert-file-create-mode]
[--file-filtering-enabled {yes | no}]
[--revert-file-filtering-enabled]
[--file-filter-type {deny | allow}]
[--revert-file-filter-type]
[--file-filter-extensions <string>]
[--clear-file-filter-extensions]
[--add-file-filter-extensions <string>]
[--remove-file-filter-extensions <string>]
[--revert-file-filter-extensions]
[--smb3-encryption-enabled {yes | no}]
[--revert-smb3-encryption-enabled]
[--verbose]

选项
< 共享 >
必需。指定要修改的 SMB 共享的名称。
--name < 名称 >
指定 SMB 共享的名称。
--path < 路径 >
为 SMB 共享指定新路径,以 /ifs 开头。
--zone < 字符串 >
指定将 SMB 共享分配到其中的访问分区。如果未指定访问分区,则系统会修改分配给默认 System 分
区(如果找到)的、具有指定名称的 SMB 共享。
--new-zone < 字符串 >
指定要将 SMB 共享重新分配到其中的新访问分区。
--host-acl < 主机 ACL>
表示允许访问哪些主机的 ACL。为每个额外的主机 ACL 子句指定 --host-acl。
--revert-host-acl
将值设置为 --host-acl 的系统默认值。
--clear-host-acl
清除表示允许访问哪些主机的 ACL 的值。
--add-host-acl < 字符串 >
添加表示允许访问哪些主机的 ACL。为要添加的每个额外的主机 ACL 子句指定 --add-host-acl。
--remove-host-acl < 字符串 >
删除表示允许访问哪些主机的 ACL。为要删除的每个额外的主机 ACL 子句指定 --remove-host-
acl。
--description < 字符串 >
此 SMB 共享的描述。
--csc-policy, -C {manual | documents | programs | none}
为共享指定客户端缓存策略。
--revert-csc-policy
将值设置为 --csc-policy 的系统默认值。
{--allow-variable-expansion | -a} {yes | no}
允许自动扩展主目录的变量。
--revert-allow-variable-expansion

502 OneFS isi 命令 S 至 Z


将值设置为 --allow-variable-expansion 的系统默认值。
{--auto-create-directory | -d} {yes | no}
自动创建主目录。
--revert-auto-create-directory
将值设置为 --auto-create-directory 的系统默认值。
{--browsable | -b} {yes | no}
此共享在网络视图和浏览列表中可见。
--revert-browsable
将值设置为 --browsable 的系统默认值。
--allow-execute-always {yes | no}
允许用户执行他们具有读取权限的文件。
--revert-allow-execute-always
将值设置为 --allow-execute-always 的系统默认值。
--directory-create-mask < 整数 >
指定目录创建掩码位。
--revert-directory-create-mask
将值设置为 --directory-create-mask 的系统默认值。
--strict-locking {yes | no}
指定字节范围锁定是否会发生 SMB I/O 争用。
--revert-strict-locking
将值设置为 --strict-locking 的系统默认值。
--hide-dot-files {yes | no}
隐藏以句点“.”开头的文件和目录。
--revert-hide-dot-files
将值设置为 --hide-dot-files 的系统默认值。
--impersonate-guest {always | "bad user" | never}
指定以来宾帐户身份进行用户访问的条件。
--revert-impersonate-guest
将值设置为 --impersonate-guest 的系统默认值。
--strict-flush {yes | no}
处理 SMB 刷新操作。
--revert-strict-flush
将值设置为 --strict-flush 的系统默认值。
--access-based-enumeration {yes | no}
指定仅枚举请求用户有权访问的文件和文件夹。
--revert-access-based-enumeration
将值设置为 --access-based-enumeration 的系统默认值。
--access-based-enumeration-root-only {yes | no}
仅在共享的根目录上指定基于访问权限的枚举。
--revert-access-based-enumeration-root-only
将值设置为 --access-based-enumeration-root-only 的系统默认值。
--ca-timeout < 整数 >
在客户端断开连接或服务器出现故障后保留持久句柄的时间量(以秒为单位)。默认值是 120 秒。
--revert-ca-timeout
将值设置为 --ca-timeout 的系统默认值。
--strict-ca-lockout {yes | no}
如果设置为 yes,并且某个客户端具有该文件已打开但断开连接的持久句柄,将防止另一个客户端打开
文件。如果设置为 no,OneFS 将发出持久句柄,但在非原始打开项的任何客户端尝试打开文件时废弃持

OneFS isi 命令 S 至 Z 503


久句柄。仅当在创建共享时将 --continuously-available 设置为 yes,此选项才相关。默认值为
yes。
--revert-strict-ca-lockout
将值设置为 --strict-ca-lockout 的系统默认值。
--ca-write-integrity {none | write-read-coherent | full}
连续可用共享上指定写入完整性的级别:

none 连续可用写入的处理方式与群集的其他写入不同。如果指定 none 且某个节点发


生故障,则可能会遇到数据丢失,而且没有通知。因此,我们不建议使用此选项。
write-read- 确保在将成功消息返回给发送数据的 SMB 客户端之前,共享写入将移到持久存
coherent 储。这是默认设置。
full 确保在将成功消息返回给发送数据的 SMB 客户端之前,共享写入将移到持久存
储,并且防止 OneFS 授予 SMB 客户端写入缓存和句柄缓存租赁。

--revert-ca-write-integrity
将值设置为 --ca-write-integrity 的系统默认值。
--mangle-byte-start < 整数 >
为自动字节编码识别指定 wchar_t 起点。
--revert-mangle-byte-start
将值设置为 --mangle-byte-start 的系统默认值。
--file-create-mask < 整数 >
指定文件创建掩码位。
--revert-file-create-mask
将值设置为 --file-create-mask 的系统默认值。
--create-permissions {"default acl" | "inherit mode bits" | "use create mask and mode"}
为共享中的新文件和目录设置创建权限。
--revert-create-permissions
将值设置为 --create-permissions 的系统默认值。
--mangle-map < 编码识别映射 >
字符编码识别映射。为每个额外的字符编码识别映射指定 --mangle-map。
--revert-mangle-map
将值设置为 --mangle-map 的系统默认值。
--clear-mangle-map
清除字符编码识别映射的值。
--add-mangle-map < 字符串 >
添加字符编码识别映射。为每个额外的添加字符编码识别映射指定 --add-mangle-map。
--remove-mangle-map < 字符串 >
删除字符编码识别映射。为每个额外的删除字符编码识别映射指定 --remove-mangle-map。
--impersonate-user < 字符串 >
将用作来宾帐户的用户帐户。
--revert-impersonate-user
将值设置为 --impersonate-user 的系统默认值。
--change-notify {all | norecurse | none}
指定共享上的更改通知警报级别。
--revert-change-notify
将值设置为 --change-notify 的系统默认值。
--oplocks {yes | no}
支持 oplock。
--revert-oplocks
将值设置为 --oplocks 的系统默认值。

504 OneFS isi 命令 S 至 Z


--allow-delete-readonly {yes | no}
允许删除共享中的只读文件。
--revert-allow-delete-readonly
将值设置为 --allow-delete-readonly 的系统默认值。
--directory-create-mode < 整数 >
指定目录创建模式位。
--revert-directory-create-mode
将值设置为 --directory-create-mode 的系统默认值。
--ntfs-acl-support {yes | no}
针对文件和目录支持 NTFS ACL。
--revert-ntfs-acl-support
将值设置为 --ntfs-acl-support 的系统默认值。
--file-create-mode < 整数 >
指定文件创建模式位。
--revert-file-create-mode
将值设置为 --file-create-mode 的系统默认值。
--file-filtering-enabled {yes | no}
如果设置为 yes,则在共享级别启用文件筛选。默认设置为 no。
--revert-file-filtering-enabled
将值设置为 --file-filtering-enabled 的系统默认值。
--file-filter-type {deny | allow}
如果设置为 allow,则允许将指定文件类型写入共享。默认设置为 deny。
--revert-file-filter-type
将值设置为 --file-filter-type 的系统默认值。
--file-filter-extensions < 字符串 >
指定要拒绝或允许写入共享的文件类型列表,具体取决于 --file-filter-type 的设置。可以在逗号
分隔值列表中指定文件类型。
--clear-file-filter-extensions
清除共享的文件筛选扩展名列表。
--add-file-filter-extensions < 字符串 >
将条目添加到文件筛选器扩展名列表。针对每个要添加的文件扩展名重复此操作。
--remove-file-filter-extensions < 字符串 >
从文件筛选器扩展名列表中删除条目。针对每个要删除的文件扩展名重复此操作。
--revert-file-filter-extensions
将值设置为 --file-filter-extensions 的系统默认值。
--smb3-encryption-enabled {yes | no}
在共享上启用 SMBv3 加密。
--revert-smb3-encryption-enabled
将值设置为 --smb3-encryption-enabled 的系统默认值。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 505


isi smb shares permission create
创建 SMB 共享的权限。

语法
isi smb shares permission create <share> {<user> | --group <name>
| --gid <id> | --uid <id> | --sid <string> | --wellknown <string>}
{--run-as-root | --permission-type {allow | deny}
--permission {full | change | read}}
[--zone <zone>]
[--verbose]

选项
< 共享 >
指定 SMB 共享的名称。
< 用户 >
按名称指定用户。
--group< 名称 >
按名称指定组。
--gid<ID>
按 UNIX 组标识符指定组。
--uid<ID>
按 UNIX 用户标识符指定用户。
--sid< 字符串 >
按其 Windows 安全标识符指定对象。
--wellknown< 字符串 >
指定已知用户、组、计算机或帐户名称。
{--permission-type | -d} {deny | allow}
指定允许还是拒绝权限。
{--permission | -p} {read | full | change}
指定要允许或拒绝的控制级别。
--run-as-root {yes | no}
如果设置为 yes,将允许帐户以 root 身份运行。 默认设置为 no。
--zone< 分区 >
指定访问分区。
{--verbose | -v}
显示更多详细信息。

506 OneFS isi 命令 S 至 Z


isi smb shares permission delete
删除 SMB 共享的用户或组权限。

语法
isi smb shares permission delete <share> {<user> | --group <name>
|--gid <id> | --uid <id> | --sid <string> | --wellknown <string>}
[--zone <string>]
[--force]
[--verbose]

选项
< 共享 >
必需。 指定 SMB 共享名称。
< 用户 >
按名称指定用户。
--group< 名称 >
按名称指定组。
--gid<ID>
按 UNIX 组标识符指定组。
--uid<ID>
按 UNIX 用户标识符指定用户。
--sid< 字符串 >
按其 Windows 安全标识符指定对象。
--wellknown< 字符串 >
指定已知用户、组、计算机或帐户名称。
--zone< 字符串 >
指定访问分区。
{--force | -f}
指定执行命令时无需提示进行确认。
{--verbose | -v}
显示更多详细信息。

isi smb shares permission list


显示 SMB 共享的权限列表。

语法
isi smb shares permission list <share>
[--zone <zone>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]

OneFS isi 命令 S 至 Z 507


选项
< 共享 >
指定要显示的 SMB 共享的名称。
--zone< 分区 >
指定要显示的访问分区。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。

isi smb shares permission modify


修改 SMB 共享的权限。

语法
isi smb shares permission modify <share> {<user> | --group <name>
| --gid <id> | --uid <id> | --sid <string> | --wellknown <string>}
{--run-as-root | --permission-type {allow | deny}
--permission {full | change | read}}
[--zone <zone>]
[--verbose]

选项
< 共享 >
指定 SMB 共享的名称。
< 用户 >
按名称指定用户。
--group< 名称 >
按名称指定组。
--gid<ID>
按 UNIX 组标识符指定组。
--uid<ID>
按 UNIX 用户标识符指定用户。
--sid< 字符串 >
按其 Windows 安全标识符指定对象。
--wellknown< 字符串 >
指定已知用户、组、计算机或帐户名称。
{--permission-type | -d} {deny | allow}
指定允许还是拒绝权限。
{--permission | -p} {read | full | change}
指定要允许或拒绝的控制级别。

508 OneFS isi 命令 S 至 Z


--run-as-root {yes | no}
如果设置为 yes,将允许帐户以 root 身份运行。 默认设置为 no。
--zone< 分区 >
指定访问分区。
{--verbose | -v}
显示更多详细信息。

isi smb shares permission view


显示 SMB 共享的单一权限。

语法
isi smb shares permission view <share> {<user> |
--group <name> | --gid <integer>
| --uid <integer> | --sid <string>
| --wellknown <string>}
[--zone <string>]

选项
<share>
指定 SMB 共享的名称。
<user>
指定用户名。
--group< 名称 >
指定组名称。
--gid< 整数 >
指定数字组标识符。
--uid< 整数 >
指定数字用户标识符。
--sid< 字符串 >
指定安全标识符。
--wellknown< 字符串 >
指定已知用户、组、计算机或帐户名称。
--zone< 字符串 >
指定访问分区。

OneFS isi 命令 S 至 Z 509


isi smb shares view
显示有关 SMB 共享的信息。

语法
isi smb shares view <share>
[--zone <string>]

选项
< 共享 >
指定要查看的 SMB 共享的名称。
--zone< 字符串 >
指定将 SMB 共享分配到其中的访问分区。 如果未指定访问分区,系统会显示分配给默认 System 分区
(如果找到)的、具有指定名称的 SMB 共享。

isi snapshot aliases create


为快照或文件系统的实时版本指定快照别名。

语法
isi snapshot aliases create <name> <target>
[--verbose]

选项
< 名称 >
指定别名名称。
< 模板 >
为指定快照或文件系统的实时版本指定别名。
指定快照 ID 或名称。 要针对文件系统的实时版本,请指定 LIVE。
{--verbose | -v}
显示更多详细信息。

isi snapshot aliases delete


删除快照别名。

语法
isi snapshot aliases delete {<alias> | --all}
[--force]
[--verbose]

510 OneFS isi 命令 S 至 Z


选项
< 别名 >
删除指定名称的快照别名。
指定快照别名名称或 ID。
--all
删除所有快照别名。
{--force | -f}
运行命令,不提示您确认是否要删除快照别名。
{--verbose | -v}
显示更多详细信息。

isi snapshot aliases list


显示快照别名列表。

语法
isi snapshot aliases list
[--limit <integer>]
[--sort {id | name | target_id | target_name | created}]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

id 按快照别名的 ID 对输出进行排序。
name 按快照别名的名称对输出进行排序。
target_id 按分配了快照别名的快照的 ID 对输出进行排序。
target_name 按分配了快照别名的快照的名称对输出进行排序。
created 按快照别名的创建时间对输出进行排序。

{--descending | -d}
以相反的顺序显示输出。
--format< 输出格式 >
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}

OneFS isi 命令 S 至 Z 511


显示更多详细信息。

isi snapshot aliases modify


修改快照别名。

语法
isi snapshot aliases modify <alias>
{--name <name> | --target <snapshot>}
[--verbose]

选项
<alias>
修改指定的快照别名。
指定快照别名名称或 ID。
--name <name>
为快照别名指定新名称。
--target< 快照 >
为指定快照或文件系统的实时版本重新指定快照别名。
指定快照 ID 或名称。 要针对文件系统的实时版本,请指定 LIVE。
{--verbose | -v}
显示更多详细信息。

isi snapshot aliases view


显示有关快照别名的详细信息。

语法
isi snapshot aliases view <alias>

选项
<alias>
显示有关指定快照别名的详细信息。
指定快照别名名称或 ID。

isi snapshot locks create


创建快照锁定。
注: 建议您不要创建快照锁定,也不要使用此命令。 如果达到快照的最大锁定数量,某些应用程序(例如 SyncIQ)可能无
法正常工作。

512 OneFS isi 命令 S 至 Z


语法
isi snapshot locks create <snapshot>
[--comment <string>]
[--expires {<timestamp> | <duration>}]
[--verbose]

选项
<snapshot>
指定要应用此锁定的快照的名称。
{--comment | -c} < 字符串 >
指定描述锁定的注释。
指定任意字符串。
{--expires | -x} {< 时间戳 > | < 持续时间 >}
指定系统自动删除锁定的时间。
如果未指定此选项,快照锁定将无限期存在。
采用以下格式指定 < 时间戳 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

采用以下格式指定 < 持续时间 >:

<integer><time>

以下 < 时间 > 值有效:

Y 指定年数

M 指定月数

W 指定周数

D 指定天数

H 指定小时数

{--verbose | -v}
显示确认删除了快照锁定的消息。

isi snapshot locks delete


删除快照锁定。 删除快照锁定可能会导致数据丢失。

小心: 建议您不要删除快照锁定,也不要运行此命令。 删除由 OneFS 创建的快照锁定可能会导致数据丢失。

语法
isi snapshot locks delete <snapshot> <id>
[--force]
[--verbose]

OneFS isi 命令 S 至 Z 513


选项
<snapshot>
删除应用到指定快照的快照锁定。
指定快照名称或 ID。
<id>
修改指定 ID 的快照锁定。
{--force | -f}
不会提示您确认是否要删除此快照锁定。
{--verbose | -v}
显示确认删除了快照锁定的消息。

isi snapshot locks list


显示应用于特定快照的所有锁定的列表。

语法
isi snapshot locks list <snapshot>
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
<snapshot>
显示属于指定快照的所有锁定。
指定快照名称。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

id 按快照锁定的 ID 对输出进行排序。
comment 按快照锁定的描述的字母顺序对输出进行排序。
expires 按锁定在自动被删除前在群集上持续的时间长度对输出进行排序。
count 按锁定被持有的次数对输出进行排序。

{--descending | -d}
以相反的顺序显示输出。
--format< 输出格式 >
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}

514 OneFS isi 命令 S 至 Z


显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi snapshot locks modify


修改快照锁定的到期日期。
小心:

建议您不要修改快照锁定的到期日期,也不要运行此命令。 删除由 OneFS 创建的快照锁定的到期日期可能会导致数据丢


失。

语法
isi snapshot locks modify <snapshot> <id>
{--expires {<timestamp> | <duration>} | --clear-expires}
[--verbose]

选项
<snapshot>
修改应用到指定快照的快照锁定。
指定快照名称或 ID。
<id>
修改指定 ID 的快照锁定。
{--expires | -x} {< 时间戳 > | < 持续时间 >}
指定系统自动删除锁定的时间。
如果未指定此选项,快照锁定将无限期存在。
采用以下格式指定 < 时间戳 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

采用以下格式指定 < 持续时间 >:

<integer><time>

以下 < 时间 > 值有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--clear-expires
删除快照锁定的持续时间。 如果指定该选项,快照锁定将无限期存在于群集上。
{--verbose | -v}
显示确认修改了快照锁定的消息。

OneFS isi 命令 S 至 Z 515


示例
以下命令将导致应用到 Wednesday_Backup 的快照锁定在三个星期后到期:

isi snapshot locks modify Wednesday_Backup 1 --expires 3W

isi snapshot locks view


显示有关快照锁定的信息。

语法
isi snapshot locks view <snapshot> <id>

选项
<snapshot>
指定要查看其锁定的快照。
指定快照名称或 ID。
<id>
显示指定的锁定。
指定快照锁定 ID。

isi snapshot schedules create


创建快照计划。 快照计划确定以重复方式定期生成快照的时间。

语法
isi snapshot schedules create <name> <path> <pattern> <schedule>
[--alias <alias>]
[--duration <duration>]
[--verbose]

选项
<name>
为快照计划指定名称。
<path>
指定要包括快照的目录路径。
<pattern>
指定根据计划创建的快照的命名模式。
<schedule>
指定快照的创建频率。
采用以下格式指定:

"<interval> [<frequency>]"

516 OneFS isi 命令 S 至 Z


采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。 例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。 例如,“saturday”和“sat”都有效。
--alias< 别名 >
为根据计划生成的最新快照指定别名。 别名使您能够快速查找根据计划生成的最新快照。
指定任意字符串。
{--duration | -x} < 持续时间 >
指定在 OneFS 自动删除根据计划生成的快照之前这些快照可以存储在群集中的时间。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数

M 指定月数

W 指定周数

D 指定天数

H 指定小时数

{--verbose | -v}
显示确认创建了快照计划的消息。

OneFS isi 命令 S 至 Z 517


isi snapshot schedules delete
删除快照计划。如果删除快照计划,将不会再根据计划生成快照。但之前根据计划生成的快照不会受到影响。

语法
isi snapshot schedules delete {<schedule-name> | <all>
[--force]
[--verbose]

选项
<schedule-name>
删除指定的快照计划。
指定快照计划名称或 ID。
<all>
删除所有快照计划。
{--force | -f}
不会提示您确认是否要删除此快照计划。
{--verbose | -v}
显示确认删除了快照计划的消息。

isi snapshot schedules list


显示所有快照计划的列表。

语法
isi snapshot schedules list
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

id 按快照计划的 ID 对输出进行排序。
name 按快照计划的名称的字母顺序对输出进行排序。
path 按根据计划创建的快照所包含的目录的绝对路径对输出进行排序。
pattern 按分配给根据计划生成的快照的快照命名模式的字母顺序对输出进行排序。

518 OneFS isi 命令 S 至 Z


schedule 按计划的字母顺序对输出进行排序。 例如,“Every week”排在“Yearly on January
3rd”前面。
duration 按根据计划创建的快照在自动被删除前在群集上持续的时间长度对输出进行排序。
alias 按分配给根据计划生成的最近快照的别名的字母顺序对输出进行排序。
next_run 按根据计划将要创建快照的下一次时间对输出进行排序。
next_snapshot 按计划为下一次创建的快照名称的字母顺序对输出进行排序。

{--descending | -d}
以相反的顺序显示输出。
--format< 输出格式 >
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi snapshot schedules modify


修改现有快照计划的属性。
如果修改快照计划,已经根据计划生成的快照不会受这些更改的影响。

语法
isi snapshot schedules modify <schedule-name>
{--name <name> | --alias <name> | --path <path>
| --pattern <naming-pattern> | --schedule <schedule>
| --duration <duration> | --clear-duration}...
[--verbose]

选项
<schedule-name>
修改指定的快照计划。
指定快照计划名称或 ID。
--name< 名称 >
为计划指定新名称。
指定任意字符串。
{--alias | -a} < 名称 >
为根据计划生成的最新快照指定别名。 别名使您能够快速查找根据计划生成的最新快照。 如果指定了别
名,则该别名将应用到按计划生成的下一个快照以及后续生成的所有快照。
指定任意字符串。
--path< 路径 >
为该快照计划指定新目录路径。 如果指定了路径,则按计划生成的快照将仅包含此目录路径。
指定目录路径。
--pattern< 命名模式 >
指定根据计划创建的快照的命名模式。

OneFS isi 命令 S 至 Z 519


--schedule< 计划 >
指定快照的创建频率。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。 例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。 例如,“saturday”和“sat”都有效。
{--duration | -x} < 持续时间 >
指定在 OneFS 自动删除根据计划生成的快照之前这些快照可以存储在群集中的时间。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数

M 指定月数

W 指定周数

D 指定天数

H 指定小时数

--clear-duration
删除根据计划创建的快照的持续时间。 如果指定该选项,生成的快照将无限期存在于群集中。
{--verbose | -v}
显示确认修改了快照计划的消息。

520 OneFS isi 命令 S 至 Z


isi snapshot schedules pending list
显示计划按快照计划生成的快照的列表。

语法
isi snapshot schedules pending list
[--begin <timestamp>]
[--end <timestamp>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--begin | -b} < 时间戳 >
仅显示计划在指定日期之后生成的快照。
采用以下格式指定 < 时间戳 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

如果未指定此选项,输出将显示计划在当前时间之后生成的快照的列表。
{--end | -e} < 时间 >
仅显示计划在指定日期之前生成的快照。
采用以下格式指定 < 时间 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

如果未指定此选项,输出将显示计划在开始时间后的 30 天内生成的快照的列表。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format< 输出格式 >
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi snapshot schedules view


显示有关快照计划的信息。

语法
isi snapshot schedules view <schedule-name>

OneFS isi 命令 S 至 Z 521


选项
<schedule-name>
显示有关指定的快照计划的信息。
指定快照计划名称或 ID。

isi snapshot settings modify


修改快照设置。

语法
isi snapshot settings modify
{--service {enable | disable}
| --autocreate {enable | disable}
| --autodelete {enable | disable}
| --reserve <integer>
| --global-visible-accessible {yes | no}
| --nfs-root-accessible {yes | no}
| --nfs-root-visible {yes | no}
| --nfs-subdir-accessible {yes | no}
| --smb-root-accessible {yes | no}
| --smb-root-visible {yes | no}
| --smb-subdir-accessible {yes | no}
| --local-root-accessible {yes | no}
| --local-root-visible {yes | no}
| --local-subdir-accessible {yes | no}}...
[--verbose]

选项
--service {enable | disable}
确定是否可以生成快照。
注: 禁用快照生成可能会导致某些 OneFS 操作失败。建议您不要禁用此设置。

--autocreate {enable | disable}


确定是否根据快照计划自动生成快照。
指定 disable 不会阻止 OneFS 应用程序生成快照。
--autodelete {enable | disable}
确定是否根据到期日期自动删除快照。
所有超过其到期日期而又禁用了此选项的快照都将在再次启用该选项时立即被删除。
--reserve< 整数 >
指定要保留供快照使用的文件系统的百分比。
指定 1 到 100 之间的正整数。
注: 此选项仅限制可供 SnapshotIQ 以外的应用程序使用的空间量。它不会限制允许快照占用的空间
量。快照可以占用超过指定的系统存储空间的百分比的空间。

--global-visible-accessible {yes | no}


指定 yes 将导致快照目录和子目录可见并可通过所有协议进行访问,从而覆盖所有其他可见性和可访问
性设置。指定 no 将导致通过其他快照可见性和可访问性设置控制其可见性和可访问性设置。
--nfs-root-accessible {yes | no}
确定是否可以通过 NFS 访问快照目录。
--nfs-root-visible {yes | no}

522 OneFS isi 命令 S 至 Z


确定是否可以通过 NFS 查看快照目录。
--nfs-subdir-accessible {yes | no}
确定是否可以通过 NFS 访问快照子目录。
--smb-root-accessible {yes | no}
确定是否可以通过 SMB 访问快照目录。
--smb-root-visible {yes | no}
确定是否可以通过 SMB 查看快照目录。
--smb-subdir-accessible {yes | no}
确定是否可以通过 SMB 访问快照子目录。
--local-root-accessible {yes | no}
确定是否可以通过本地文件系统访问快照目录。
--local-root-visible {yes | no}
确定是否可以通过本地文件系统查看快照目录。
--local-subdir-accessible {yes | no}
确定是否可以通过本地文件系统访问快照子目录。
{--verbose | -v}
显示确认修改了哪些快照设置的消息。

isi snapshot settings view


显示当前 SnapshotIQ 设置。

语法
isi snapshot settings view

选项
此命令没有选项。

isi snapshot snapshots create


创建目录快照。

语法
isi snapshot snapshots create <path>
[--name <name>]
[--expires {<timestamp> | <duration>}]
[--alias <name>]
[--verbose]

选项
< 路径 >
指定要包括在此快照中的目录路径。
--name< 名称 >

OneFS isi 命令 S 至 Z 523


指定快照名称。
{--expires | -x} {< 时间戳 > | < 持续时间 >}
指定 OneFS 自动删除此快照的时间。
如果未指定此选项,快照将无限期存在。
采用以下格式指定 < 时间戳 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

采用以下格式指定 < 持续时间 >:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

{--alias | -a} < 名称 >


为此快照指定别名。 快照别名是快照的备选名称。
指定任意字符串。
{--verbose | -v}
显示确认创建了快照的消息。

isi snapshot snapshots delete


删除快照。 如果删除某个快照,用户或系统便不能再访问该快照。

语法
isi snapshot snapshots delete {--all | --snapshot <snapshot>
| --schedule <schedule> | --type <type>}
[--force]
[--verbose]

选项
--all
删除所有快照。
--snapshot< 快照 >
删除指定的快照。
指定快照名称或 ID。
--schedule< 计划 >
删除根据指定计划创建的所有快照。
指定快照计划名称或 ID。
--type< 类型 >
删除指定类型的所有快照。
以下类型有效:

524 OneFS isi 命令 S 至 Z


alias 删除所有快照别名。
real 删除所有快照。

{--force | -f}
不会提示您确认是否要删除快照。
{--verbose | -v}
显示确认删除了快照的消息。

示例
以下命令将删除 newSnap1:

isi snapshot snapshots delete --snapshot newSnap1

isi snapshot snapshots list


显示所有快照和快照别名的列表。

语法
isi snapshot snapshots list
[--state <state>]
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--state< 状态 >
仅显示处于指定状态的快照和快照别名。
以下状态有效:

all 显示当前占用了群集空间的所有快照和快照别名。
active 仅显示尚未删除的快照和快照别名。
deleting 仅显示已删除但仍然占用群集空间的快照。 被已删除快照占用的空间将在下次运
行快照删除作业时释放。

{--limit | -l} < 整数 >


显示不超过指定的项目数。
--sort< 属性 >
按指定属性对命令输出进行排序。
以下属性有效:

id 按快照 ID 对输出进行排序。
name 按快照名称的字母顺序对输出进行排序。
path 按包含在快照中的目录的绝对路径对输出进行排序。
has_locks 按是否对快照应用了任何快照锁定对输出进行排序。

OneFS isi 命令 S 至 Z 525


schedule 如果根据计划生成了快照,则按快照计划的名称的字母顺序对输出进行排序。
target_id 如果快照是别名,则按目标快照的快照 ID 而不是别名的快照 ID 对输出进行排序。
target_name 如果快照是别名,则按目标快照的名称而不是别名的名称对输出进行排序。
created 按快照的创建时间对输出进行排序。
expires 按计划自动删除快照的时间对输出进行排序。
size 按快照所占用的磁盘空间量对输出进行排序。
shadow_bytes 根据快照从卷影存储引用的数据量对输出进行排序。 如果对包含在快照中的文件
进行克隆或快照取自克隆文件,快照将引用卷影存储数据。
pct_reserve 按快照占用的快照保留百分比对输出进行排序。
pct_filesyste 按快照占用的文件系统百分比对输出进行排序。
m
state 根据快照状态对输出进行排序。

{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表输出。
{--no-footer | -z}
显示不带页脚的表输出。 页脚显示快照总数,例如快照使用的总存储空间。
{--verbose | -v}
显示更多详细信息。

isi snapshot snapshots modify


修改快照或快照别名的属性。

语法
isi snapshot snapshots modify <snapshot>
{--name <name> | --expires {<timestamp> | <duration>}
| --clear-expires | --alias <name>}...
[--verbose]

选项
<snapshot>
修改指定的快照或快照别名。
指定快照或快照别名的名称或 ID。
--name< 名称 >
为快照或快照别名指定新名称。
指定任意字符串。
{--expires | -x} {< 时间戳 > | < 持续时间 >}
指定 OneFS 自动删除此快照的时间。

526 OneFS isi 命令 S 至 Z


采用以下格式指定 < 时间戳 >:

<yyyy>-<mm>-<dd>[T<HH>:<MM>[:<SS>]]

采用以下格式指定 < 持续时间 >:

<integer><time>

以下 < 时间 > 值有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

不能修改快照别名的到期日期。
--clear-expires
从快照中删除到期日期,从而允许快照无限期存在于群集中。
不能修改快照别名的到期日期。
{--alias | -a} < 名称 >
指定快照的别名。 快照别名是快照的备选名称。 不能为快照别名指定别名。
指定任意字符串。
{--verbose | -v}
显示确认修改了快照或快照别名的消息。

isi snapshot snapshots view


显示单个快照的属性。

语法
isi snapshot snapshots view <snapshot>

选项
<snapshot>
显示有关指定快照的信息。
指定快照名称或 ID。

isi snapshot writable create


创建可写快照

语法
isi snapshot writable create <src-snapshot> <destination-path>
[{--help | -h}]
[{--verbose| -v}]

OneFS isi 命令 S 至 Z 527


选项
<src-snapshot>
指定源快照的名称或数字 ID。
<destination-path>
指定可写快照的绝对路径。路径必须在 /ifs 文件系统内。
{help | -h}
显示此命令的帮助。
{--verbose | -v}
显示更多信息。

isi snapshot writable delete


删除可写快照。

语法
isi snapshot writable delete <writable-snapshot-path>
[{--force | -f}]
[{--help | -h}]
[{--verbose | -v}]

选项
<writable-snapshot-path>
指定要删除的可写快照的绝对路径。路径必须在 /ifs 文件系统内。
{--force | -f}
不会提示您确认是否要删除此快照锁定。
{--help | -h}
显示此命令的帮助。
{--verbose | -v}
显示确认删除了可写快照的消息。

isi snapshot writable list


显示所有可写快照的列表。

语法
isi snapshot writable list
[--state {all | active | deleting}]
[{--limit | -l} <integer>]
[--sort {dest-path | src-path | src-snapshot | created | log_size | physical_size |
state}]
[{--descending | -d}]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--help]
[--verbose]

528 OneFS isi 命令 S 至 Z


选项
--state {all | active | deleting}
仅列出处于指定状态的可写快照。
以下状态有效:

all 显示当前占用群集空间的所有可写快照。
active 仅显示未删除的可写快照。
deleting 仅显示已删除但仍然占用群集空间的可写快照。被已删除快照占用的空间会在下次
运行快照删除作业时释放。

--sort < 属性 >


按照指定的属性对显示的输出进行排序。
以下值有效:

dst_path 按绝对目标路径对输出进行排序。
src_path 按源快照的绝对路径名称对输出进行排序。
src_snap 按可写快照的名称或数字 ID 对输出进行排序。
created 按创建可写快照的日期对输出进行排序。
log_size 需要在此处定义。
physical_size 按可写快照的物理大小对输出进行排序。
state 按可写快照的状态对输出进行排序:active、all 或 deleting。

{--descending | -d}
以降序顺序显示输出。
--format < 输出格式 >
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi snapshot writable view


显示单个可写快照的属性。

语法
isi snapshot writable view <snapshot-path>

选项
<snapshot-path>
可写快照的绝对路径。此路径必须在 /ifs 文件系统中。

OneFS isi 命令 S 至 Z 529


isi snmp settings modify
修改群集的 SNMP 设置。

语法
isi snmp settings modify
[--service {yes | no}]
[--system-location <string>]
[--revert-system-location]
[--system-contact <string>]
[--revert-system-contact]
[--snmp-v1-v2c-access {yes | no}]
[--revert-snmp-v1-v2c-access]
[--read-only-community <string>]
[--revert-read-only-community]
[--snmp-v3-access {yes | no}]
[--revert-snmp-v3-access]
[--snmp-v3-read-only-user <string>]
[--revert-snmp-v3-read-only-user]
[--snmp-v3-auth-protocol {SHA | MD5}]
[--snmp-v3-priv-protocol {AES | DES}]
[--snmp-v3-security-level {noAuthNoPriv | authNoPriv | authPriv}]
[--snmp-v3-password <string>]
[--revert-snmp-v3-password]
[--set-snmp-v3-password]
[--snmp-v3-priv-password <string>]
[--revert-snmp-v3-priv-password]
[--set-snmp-v3-priv-password]
[--verbose]

选项
--service {yes | no}
启用或禁用 SNMP 服务。
--system-location <string>
SNMP 系统的位置。
--revert-system-location
将 --system-location 设置为系统默认值。
--system-contact <string>
系统所有者的有效电子邮件地址。
--revert-system-contact
将 --system-contact 设置为系统默认值。
--snmp-v1-v2c-access {yes | no}
启用或禁用 SNMP v1 和 v2c 协议。
--revert-snmp-v1-v2c-access
将 --snmp-v1-v2c-access 设置为系统默认值。
{--read-only-community | -c} < 字符串 >
只读社区的名称。
--revert-read-only-community
将 --read-only-community 设置为系统默认值。
--snmp-v3-access {yes | no}
启用或禁用 SNMP v3。
--revert-snmp-v3-access
将 --snmp-v3-access 设置为系统默认值。

530 OneFS isi 命令 S 至 Z


{--snmp-v3-read-only-user | -u} < 字符串 >
SNMP v3 读取请求的只读用户。
--revert-snmp-v3-read-only-user
将 --snmp-v3-read-only-user 设置为系统默认值。
--snmp-v3-auth-protocol {SHA | MD5}
将 SNMP v3 身份验证算法设置为 SHA 或 MD5。默认值为 MD5。
--snmp-v3-priv-protocol {AES | DES}
将 SNMP v3 加密算法设置为 AES 或 DES。默认值为 AES。
--snmp-v3-security-level {noAuthNoPriv | authNoPriv | authPriv}
设置 SNMP v3 安全级别。默认值为 authNoPriv。
--set-snmp-v3-password
以交互方式指定 --snmp-v3-password。
{--snmp-v3-password | -p} < 字符串 >
修改 SNMP v3 密码。
--revert-snmp-v3-password
将 --snmp-v3-password 设置为系统默认值。
--snmp-v3-priv-password <string>
设置 SNMP v3 隐私密码。
--revert-snmp-v3-priv-password
将 SNMP v3 隐私密码设置为系统默认值。
--set-snmp-v3-priv-password
以交互方式指定 --snmp-v3-priv-password。

isi snmp settings view


查看群集的 SNMP 设置。

语法
isi snmp settings view

示例
要查看当前配置的 SNMP 设置,请运行以下命令:

isi snmp settings view

系统将显示与以下示例类似的输出:

System Location: unset


System Contact: [email protected]
Snmp V1 V2C Access: Yes
Read Only Community: I$ilonpublic
Snmp V3 Access: No
Snmp V3 Read Only User: general
SNMP Service Enabled: No

OneFS isi 命令 S 至 Z 531


isi ssh settings modify
修改 SSH 服务器设置。

语法
isi ssh settings modify
[--ciphers <string>]
[--host-key-algorithms <string>]
[--ignore-rhosts <boolean>]
[--kex-algorithms <string>]
[--login-grace-time <duration>]
[--log-level <string>]
[--macs <string>]
[--max-auth-tries <integer>]
[--max-sessions <integer>]
[--max-startups <string>]
[--permit-empty-passwords <boolean>]
[--permit-root-login <boolean>]
[--port <integer>]
[--print-motd <boolean>]
[--pubkey-accepted-key-types <string>]
[--strict-modes <boolean>]
[--subsystem <string>]
[--syslog-facility <string>]
[--tcp-keep-alive <boolean>]
[--user-auth-method (password | publickey | both | any)]
[--match <string>]
[{--verbose | -v}]
[{--help | -h}]

选项
--ciphers <string>
指定协议版本 2 允许的密码。
--host-key-algorithms <string>
指定服务器提供的协议版本 2 主机密钥算法。
--ignore-rhosts <boolean>
允许忽略 .rhosts 和 .shosts 文件。
--kex-algorithms <string>
指定可用的 KEX 算法。
--login-grace-time < 持续时间 >
指定空闲登录失败前等待的时间长度。
--log-level <string>
指定记录来自 sshd 的消息时的日志级别。
--macs <string>
指定可用的 MAC 算法。
--max-auth-tries <integer>
指定每个连接的最大身份验证尝试次数。
--max-sessions <integer>
指定每个网络连接允许的最大开放会话数。
--max-startups <integer>
指定未经过身份验证的最大连接数。
--permit-empty-passwords <integer>
如果允许密码身份验证,则启用空密码。

532 OneFS isi 命令 S 至 Z


--permit-root-login <boolean>
启用 root SSH 登录。
--port <integer>
指定应侦听的端口 sshd。
--print-motd <boolean>
启用用户登录后打印 /etc/motd。
--pubkey-accepted-key-types <string>
指定接受的公钥类型。
--strict-modes <boolean>
指定 sshd 是否应在接受登录之前检查主目录权限。
--subsystem <string>
指定外部子系统。
--syslog-facility <string>
指定记录来自 sshd 的消息时的工具代码。
--tcp-keep-alive <boolean>
启用发送 TCP 保持活动消息。
--user-auth-methodpasswordpublickeybothany
指定用户应如何进行身份验证。
--match <string>
指定匹配数据块。
--verbose | -v
显示更多详细信息。
--help | -h
显示此命令的帮助。

isi statistics client


对每个支持的协议,按吞吐量显示访问群集的最活跃客户端。您可以指定选项以跟踪用户进行的访问,例如相同客户端主机上多
个用户访问群集。

语法
isi statistics client
[--numeric]
[--local-addresses <string>]
[--local_names <string>]
[--remote_addresses <integer>]
[--remote_names <string>]
[--user-ids <integer>]
[--user-names <string>]
[--protocols <value>]
[--classes <string>]
[--nodes <value>]
[--degraded]
[--nohumanize]
[--interval <integer>]
[--repeat <integer>]
[--limit]
[--long]
[--totalby <column>]
[--output <column>]
[--sort <column>]
[--format]
[--no-header]

OneFS isi 命令 S 至 Z 533


[--no-footer]
[--verbose]

选项
--numeric
如果本地主机、远程客户端或用户的文本标识符处于要显示的列的列表中(默认设置是显示它们),则
显示这些列的未解析数字等效项。
--local-addresses <string>
指定将报告其统计信息的本地 IP 地址。
--local-names <string>
指定将报告其统计信息的本地主机名称。
--remote-addresses <string>
指定将报告其统计信息的远程 IP 地址。
--remote-names <string>
指定将报告其统计信息的远程客户端名称。
--user-ids <string>
指定将报告其统计信息的用户 ID。默认设置为所有用户。
--user-names <string>
指定将报告其统计信息的用户名。默认设置为所有用户。
--protocols < 值 >
指定要报告其统计信息的协议。可以在逗号分隔列表中指定多个值,例如 --protocols
http,papi。以下值有效:
● all
● external
● ftp
● hdfs
● http
● internal
● irp
● jobd
● lsass_in
● lsass_out
● nlm
● nfs3
● nfs4
● papi
● s3
● siq
● smb1
● smb2
--classes <string>
指定要报告其统计信息的操作类。默认设置为所有类。以下值有效:

other 其他未分类操作的文件系统信息
write 文件和流写入
read 文件和流读取
namespace_rea 属性、统计信息和 ACL 读取;查找、目录读取
d
namespace_wri 重命名;属性设置;权限、时间和 ACL 写入
te

{--nodes | -n} <node>

534 OneFS isi 命令 S 至 Z


指定要报告其统计信息的节点。可以在逗号分隔列表中指定多个值,例如 --nodes 1,2。默认值为
all。以下值有效:
● all
● < 整数 >
{--degraded | -d}
使报告在某些节点无响应时继续运行。
--nohumanize
以基本数量显示所有数据(无动态转换)。如果设置,则此选项还禁用数据表中的单位显示。
{--interval | -i}< 浮点数 >
按以秒为单位指定的间隔报告数据。
{--repeat | -r} < 整数 >
指定在退出之前要运行报告的次数。
注: 要无限期运行报告,请指定 -1。

{--limit | -l}< 整数 >


显示要显示的统计信息数量。
--long
显示所有可能的列。
--totalby < 列 >
根据指定字段聚合结果。以下值有效:
● Node
● {Proto | protocol}
● Class
● {UserId | user.id}
● {UserName | user.name}
● {LocalAddr | local_addr}
● {LocalName | local_name}
● {RemoteAddr | remote_addr}
● {RemoteName | remote_name}
--output < 列 >
指定要显示的列。以下值有效:

{NumOps | 显示执行操作的次数。
num_operation
s}
{Ops | 显示执行操作的速率。以每秒操作数为单位显示。
operation_rat
e}
{InMax | 显示操作的最大输入(已接收)字节。
in_max}
{InMin | 显示操作的最小输入(已接收)字节。
in_min}
In 显示自 isi statistics 上次收集数据以来操作的输入速率。以每秒字节数为
单位显示。
{InAvg | 显示操作的平均输入(已接收)字节。
in_avg}
{OutMax | 显示操作的最大输出(已发送)字节。
out_max}
{OutMin | 显示操作的最小输出(已发送)字节。
out_min}
Out 显示自 isi statistics 上次收集数据以来操作的输出速率。以每秒字节数为
单位显示。

OneFS isi 命令 S 至 Z 535


{OutAvg | 显示操作的平均输出(已发送)字节。
out_avg}
{TimeMax | 显示完成操作的最大消耗时间。以微秒为单位显示。
time_max}
{TimeMin | 显示完成操作的最小消耗时间。以微秒为单位显示。
time_min}
{TimeAvg | 显示完成操作的平均消耗时间。以微秒为单位显示。
time_avg}
Node 显示对其执行了操作的节点。
{Proto | 显示操作的协议。
protocol}
Class 显示操作的类。
{UserID | 显示发出操作请求的用户的数字 UID。
user.id}
{UserName | 显示 UserID 的解析文本名称。如果无法执行解析,则显示 UNKNOWN。
user.name}
{LocalAddr | 显示发出操作请求的用户的本地 IP 地址。
local_addr}
{LocalName | 显示发出操作请求的用户的本地主机名。
local_name}
{RemoteAddr | 显示发出操作请求的用户的远程 IP 地址。
remote_addr}
{RemoteName | 显示发出操作请求的用户的远程客户端名称。
remote_name}

--sort < 列 >


指定行的排序方式。以下值有效:
● {NumOps | num_operations}
● {Ops | operation_rate}
● {InMax | in_max}
● {InMin | in_min}
● In
● {InAvg | in_avg}
● {OutMax | out_max}
● {OutMin | out_min}
● Out
● {OutAvg | out_avg}
● {TimeMax | time_max}
● {TimeMin | time_min}
● {TimeAvg | time_avg}
● Node
● {Proto | protocol}
● Class
● {UserID | user.id}
● {UserName | user.name}
● {LocalAddr | local_addr}
● {LocalName | local_name}
● {RemoteAddr | remote_addr}
● {RemoteName | remote_name}
--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --repeat 的情况下指定 --top,则报告会无限期运行。

536 OneFS isi 命令 S 至 Z


{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。
{--verbose | -v}
显示更多详细信息。

isi statistics data-reduction


查看与通过压缩和重复数据消除的数据减少相关的统计信息。

语法
isi statistics data-reduction <action>
[--resolution <integer>]
[{--help | -h}]

选项
--resolution < 整数 >
以秒为单位指定系列数据点之间的最小间隔。
{--help | -h}
显示此命令的帮助。

isi statistics data-reduction view


查看与通过压缩和重复数据消除的数据减少相关的统计信息。

语法
isi statistics data-reduction view
[--resolution <integer>]
[{--help | -h}]

选项
--resolution < 整数 >
以秒为单位指定系列数据点之间的最小间隔。
{--help | -h}
显示此命令的帮助。

OneFS isi 命令 S 至 Z 537


isi statistics drive
按驱动器显示性能信息。

语法
isi statistics drive
[--type < 值 >]
[--nodes < 值 >]
[--degraded]
[--nohumanize]
[--interval < 整数 >]
[--repeat < 整数 >]
[--limit < 整数 >]
[--long]
[--output < 列 >]
[--sort < 列 >]
[--format][--top]
[--no-header]
[--no-footer]
[--verbose]

选项
--type<string>
指定将报告其统计信息的驱动器类型。默认设置为所有驱动器。以下值有效:
● sata
● sas
● ssd
{ --nodes | -n} <node>
指定要报告其统计信息的节点。可以在逗号分隔列表中指定多个值,例如 --nodes 1,2。默认值是
all。以下值有效:
● all
● < 整数 >
{--degraded | -d}
将报告设置为在某些节点无响应时继续运行。
--nohumanize
以基本数量显示所有数据(无动态转换)。如果设置,则此参数还禁用数据表中的单位显示。
{--interval | -I} < 整数 >
按以秒为单位指定的间隔报告数据。
{--repeat | -r} < 整数 >
指定在退出之前要运行报告的次数。
注: 要将报告设置为无限期运行,请指定 -1。

{--limit | -l}< 整数 >


显示要显示的统计信息数量。
--long
显示所有可能的列。
--output< 列 >
指定要显示的列。以下值有效:
● {Timestamp | time}
● {Drive | drive_id}
● {Type | }
● {BytesIn | bytes_in}

538 OneFS isi 命令 S 至 Z


● {SizeIn | xfer_size_in}
● {OpsOut | xfers_out}
● {BytesOut | bytes_out}
● {SizeOut | xfer_size_out}
● {TimeAvg | access_latency}
● {Slow | access_slow}
● {TimeInQ | iosched_latency}
● {Queued | iosched_queue}
● {Busy | used_bytes_percent}
● {Inodes | used_inodes}
--sort< 列 >
指定行的排序方式。以下值有效:
● {Timestamp | time}
● {Drive | drive_id}
● {Type | }
● {BytesIn | bytes_in}
● {SizeIn | xfer_size_in}
● {OpsOut | xfers_out}
● {BytesOut | bytes_out}
● {SizeOut | xfer_size_out}
● {TimeAvg | access_latency}
● {Slow | access_slow}
● {TimeInQ | iosched_latency}
● {Queued | iosched_queue}
● {Busy | used_bytes_percent}
● {Inodes | used_inodes}
--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --top 的情况下指定 --repeat,则报告会无限期运行。

{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。
{--verbose | -v}
显示更多详细信息。

isi statistics heat


显示各种指标的最活跃 /ifs 路径。

语法
isi statistics heat
[--events < 字符串 >]
[--pathdepth < 整数 >]
[--maxpath < 整数 >]
[--classes < 字符串 >]
[--numeric]
[--nodes < 值 >]
[--degraded]
[--nohumanize]
[--interval < 整数 >]
[--repeat < 整数 >]

OneFS isi 命令 S 至 Z 539


[--limit < 整数 >]
[--long]
[--totalby < 列 >]
[--output < 列 >]
[--sort < 列 >
[--format]
[--no-header]
[--no-footer]
[--verbose]

选项
--events< 字符串 >
指定为指定信息报告的事件类型。以下值有效:

blocked 在等待另一个操作释放资源时,阻止对 LIN 进行的访问。类为 other。


contended LIN 遇到跨节点争用;在同时通过多个节点访问它。类为 other。
deadlocked 锁定 LIN 的尝试导致死锁。类为 other。
getattr 读取了文件或目录属性。类为 namespace_read。
link LIN 已链接到文件系统;与此事件关联的 LIN 是父目录,不是链接的 LIN。类为
namespace_write。
lock LIN 已锁定。类为 other。
lookup 在目录中查找名称;所搜索目录的 LIN 与事件关联。类为 namespace_read。
read 执行了读取。类为 read。
rename 文件或目录已重命名。与此事件关联的 LIN 是在其中对源目录或目标目录(如果
它们不同)进行重命名的目录。类为 namespace_write。
setattr 添加、修改或删除了文件或目录属性。类为 namespace_write。
unlink 文件或目录已从文件系统取消链接,与此事件关联的 LIN 是所删除项目的父目
录。类为 namespace_write。
write 执行了写入。类为 write。

-pathdepth< 整数 >
将路径减小为指定深度。
--maxpath< 整数 >
指定要在文件系统中查找的最大路径长度。
--classes< 字符串 >
指定将为指定信息报告的类。默认设置为所有类。以下值有效:

write 文件和流写入
read 文件和流读取
namespace_wri 重命名;属性设置;权限、时间和 ACL 写入
te
namespace_rea 属性、统计信息和 ACL 读取;查找、目录读取
d
other 文件系统信息

--numeric
如果本地主机、远程客户端或用户的文本标识符处于要显示的列的列表中(默认设置是显示它们),则
显示这些列的未解析数字等效项。
{ --nodes | -n} < 值 >
指定要报告其统计信息的节点。可以在逗号分隔列表中指定多个值,例如 --nodes 1,2。默认值是
all。以下值有效:
● all

540 OneFS isi 命令 S 至 Z


● < 整数 >
{--degraded | -d}
将报告设置为在某些节点无响应时继续运行。
--nohumanize
以基本数量显示所有数据(无动态转换)。如果设置,则此选项还禁用数据表中的单位显示。
{--interval | -I} < 整数 >
按以秒为单位指定的间隔报告数据。
{--repeat | -r} < 整数 >
指定在退出之前要运行报告的次数。
注: 要将报告设置为无限期运行,请指定 -1。

--limit< 整数 >
在汇总和排序之后仅显示指定数量的条目。
--long
显示所有可能的列。
--totalby< 列 >
根据指定字段聚合结果。以下值有效:
● Node
● {Event | event_name}
● {Class | class_name}
● LIN
● Path
--output< 列 >
指定要显示的列。以下值有效:

{Ops | 显示执行操作的速率。以每秒操作数为单位显示。
operation_rat
e}
Node 显示对其执行了操作的节点。
{Event | 显示事件的名称。
event_name}
{ Class | 显示操作的类。
class_name}
LIN 显示与事件关联的文件或目录的 LIN。
Path 显示与事件 LIN 关联的路径。

--sort< 列 >
指定行的排序方式。以下值有效:
● {Ops | operation_rate}
● Node
● {Event | event_name}
● {Class | class_name}
● LIN
● Path
--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --top 的情况下指定 --repeat,则报告会无限期运行。

{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。

OneFS isi 命令 S 至 Z 541


{--verbose | -v}
显示更多详细信息。

isi statistics list keys


显示所有可用密钥的列表。

语法

isi statistics list operations


[--limit]
[--format]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l}< 整数 >
显示要显示的统计信息数量。
--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --top 的情况下指定 --repeat,则报告会无限期运行。

{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。
{--verbose | -v}
显示更多详细信息。

isi statistics list operations


显示 --operations 选项的有效参数列表。

语法

isi statistics list operations


[--protocols <value>]
[--limit]
[--format]
[--no-header]
[--no-footer]
[--verbose]

选项
--protocols < 值 >

542 OneFS isi 命令 S 至 Z


指定要报告其统计信息的协议。可以在逗号分隔列表中指定多个值,例如 --protocols
http,papi。以下值有效:
● nfs3
● smb1
● nlm
● ftp
● http
● siq
● smb2
● nfs4
● papi
● jobd
● irp
● lsass_in
● lsass_out
● hdfs
● console
● ssh
● s3
{--limit | -l}< 整数 >
显示要显示的统计信息数量。
--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --repeat 的情况下指定 --top,则报告会无限期运行。

{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。
{--verbose | -v}
显示更多详细信息。

isi statistics protocol


按协议(如 NFSv3 和 HTTP)显示统计信息。

语法

isi statistics protocol


[--classes <class>...]
[--protocols <protocol>...]
[--operations <operation>...]
[--zero]
[--nodes <value>]
[--degraded]
[--nohumanize]
[--interval <integer>]
[--repeat <integer>]
[--limit]
[--long]
[--totalby <column>...]
[--output <column>...]
[--nodes <value>]
[--sort <column>...]
[--format]

OneFS isi 命令 S 至 Z 543


[--no-header]
[--no-footer]
[--verbose]

选项
--classes < 类 >
指定要报告其统计信息的操作类。以下值有效:

other 文件系统信息。可以在逗号分隔列表中指定多个值。
write 文件和流写入
read 文件和流读取
create 文件、链接、节点、流和目录创建
delete 文件、链接、节点、流和目录删除
namespace_rea 属性、统计信息和 ACL 读取;查找、目录读取
d
namespace_write 重命名;属性设置;权限、时间和 ACL 写入
file_state 打开、关闭;锁定:获取、释放、中断、检查;通知
会话状态 协议连接或会话状态的协商、查询或操作

--protocols < 值 >


指定要报告其统计信息的协议。可以在逗号分隔列表中指定多个值,例如 --protocols
http,papi。以下值有效:
● all
● external
● ftp
● hdfs
● http
● internal
● irp
● jobd
● lsass_in
● lsass_out
● nfs3
● nfs4
● nlm
● papi
● s3
● siq
● smb1
● smb2
--operations < 操作 >
指定报告其统计信息的操作。要查看有效值列表,请运行 isi statistics list operations 命
令。可以在逗号分隔列表中指定多个值。
--zero
显示没有值的表条目。
{--nodes | -n} <node>
指定要报告其统计信息的节点。可以在逗号分隔列表中指定多个值,例如 --nodes 1,2。默认值为
all。以下值有效:
● all
● < 整数 >
{--degraded | -d}
使报告在某些节点无响应时继续运行。

544 OneFS isi 命令 S 至 Z


--nohumanize
以基本数量显示所有数据(无动态转换)。如果设置,则此选项还禁用数据表中的单位显示。
{--interval | -i} < 浮点数 >
按以秒为单位指定的间隔报告数据。
{--repeat | -r} < 整数 >
指定在退出之前要运行报告的次数。
注: 要将报告设置为无限期运行,请指定 -1。

{--limit | -l}< 整数 >


显示要显示的统计信息数量。
--long
显示所有可能的列。
--totalby <列>
根据指定字段聚合结果。以下值有效:
● Node
● {Proto | protocol}
● Class
● {Op | operation}
--output < 列 >
指定要显示的列。以下值有效:

{timestamp | 显示 isi statistics 工具上次收集数据的时间。以 POSIX 时间(自 1970 年 1


time} 月 1 日以来经过的秒数)显示。
采用以下格式指定 < 时间和日期 >:

<YYYY>-<MM>-<DD>[T<hh>:<mm>[:<ss>]]

将 < 时间 > 指定为以下值之一。

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
h 指定小时数
s 指定秒数

{NumOps | 显示执行操作的次数。
operation_cou
nt}
{Ops | 显示执行操作的速率。以每秒操作数为单位显示。
operation_rat
e}
{InMax | 显示操作的最大输入(已接收)字节。
in_max}
{InMin | 显示操作的最小输入(已接收)字节。
in_min}
In 显示自 isi statistics 上次收集数据以来操作的输入速率。以每秒字节数为单位显
示。
{InAvg | 显示操作的平均输入(已接收)字节。
in_avg}
{InStdDev | 显示操作的输入(已接收)字节的标准偏差。以字节为单位显示。
in_standard_d
ev}

OneFS isi 命令 S 至 Z 545


{OutMax | 显示操作的最大输出(已发送)字节。
out_max}
{OutMin | 显示操作的最小输出(已发送)字节。
out_min}
Out 显示自 isi statistics 上次收集数据以来操作的输出速率。以每秒字节数为单位显
示。
{OutAvg | 显示操作的平均输出(已发送)字节。
out_avg}
{OutStdDev | 显示操作的输出(已发送)字节的标准偏差。以字节为单位显示。
out_standard_
dev}
{TimeMax | 显示完成操作的最大消耗时间。以微秒为单位显示。
time_max}
{TimeMin | 显示完成操作的最小消耗时间。以微秒为单位显示。
time_min}
{TimeAvg | 显示完成操作的平均消耗时间。以微秒为单位显示。
time_avg}
{TimeStdDev | 显示完成操作的已用时间作为平均已用时间的标准偏差。
time_standard
_dev}
Node 显示对其执行了操作的节点。
{Proto | 显示操作的协议。
protocol}
Class 显示操作的类。
{Op | 显示操作的名称
operation}

--sort <列>
指定行的排序方式。以下值有效:
● Class
● In
● InAvg | in_avg}
● InMax | in_max}
● InMin | in_min}
● InStdDev | in_standard_dev}
● Node
● NumOps | operation_count}
● Op | operation}
● Ops | operation_rate}
● Out
● OutAvg | out_avg}
● OutMax | out_max}
● OutMin | out_min}
● OutStdDev | out_standard_dev}
● Proto | protocol}
● TimeAvg | time_avg}
● TimeMax | time_max}
● TimeMin | time_min}
● TimeStamp | time}
● TimeStdDev | time_standard_dev}
--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。

546 OneFS isi 命令 S 至 Z


注: 如果在不使用 --repeat 的情况下指定 --top,则报告会无限期运行。

{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。
{--verbose | -v}
显示更多详细信息。

isi statistics pstat


显示精选的群集范围和协议数据。

语法
isi statistics pstat
[--protocol <protocol>]
[--degraded]
[--interval <integer>]
[--repeat <integer>]
[--format]
[--verbose]

选项
--protocols < 值 >
指定要报告其统计信息的协议。可以在逗号分隔列表中指定多个值,例如 --protocols
http,papi。以下值有效:
● ftp
● hdfs
● http
● irp
● jobd
● lsass_out
● lsass_in
● nfs3
● nfs4
● nlm
● nfsrdma
● papi
● s3
● siq
● smb1
● smb2
{--degraded | -d}
将报告设置为在某些节点无响应时继续运行。
{--interval | -i} < 浮点数 >
按以秒为单位指定的间隔报告数据。
{--repeat | -r} < 整数 >
指定在退出之前要运行报告的次数。
注: 要将报告设置为无限期运行,请指定 -1。

--format {table | json | csv | list | top}

OneFS isi 命令 S 至 Z 547


以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --repeat 的情况下指定 --top,则报告会无限期运行。

{--verbose | -v}
显示更多详细信息。

isi statistics query current


显示当前统计信息。

语法
isi statistics query history
[--keys < 字符串 >]
[--substr]
[--raw]
[--nodes < 值 >]
[--degraded]
[--interval < 数字 >]
[--repeat < 数字 >]
[--limit]
[--long]
[--format]
[--no-header]
[--no-footer]
[--verbose]

选项
--keys< 字符串 > ...
指定应为请求的节点报告的统计信息,其中 < 字符串 > 的值是统计信息键。使用 isi statistics
list keys 命令可获取统计信息键的完整列表。
--substr
匹配使用 --keys 指定的每个密钥的 '.*< 密钥 > .*' 的统计信息。
--raw
以十六进制输出复杂对象。
{ --nodes | -n} <node>
指定要报告其统计信息的节点。可以在逗号分隔列表中指定多个值,例如 --nodes 1,2。默认值是
all。以下值有效:
● all
● < 整数 >
{--degraded | -d}
将报告设置为在某些节点无响应时继续运行。
{--interval | -i} < 浮点数 >
按以秒为单位指定的间隔报告数据。
{--repeat | -r} <integer>
指定在退出之前要运行报告的次数。
注: 要将报告设置为无限期运行,请指定 -1。

{--limit | -l}< 整数 >


显示要显示的统计信息数量。
--long
显示所有可能的列。

548 OneFS isi 命令 S 至 Z


--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --top 的情况下指定 --repeat,则报告会无限期运行。

{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。
{--verbose | -v}
显示更多详细信息。

isi statistics query history


显示可用历史统计信息。并非所有统计信息都配置为支持历史查询。

语法
isi statistics query history
[--keys < 字符串 >]
[--substr]
[--begin < 整数 >]
[--end < 整数 >]
[--resolution < 数字 >]
[--memory-only]
[--raw]
[--nodes < 值 >]
[--degraded]
[--nohumanize]
[--interval < 数字 >]
[--repeat < 数字 >]
[--limit]
[--format]
[--no-header]
[--no-footer]
[--verbose]

选项
--keys< 字符串 > ...
指定应为请求的节点报告的统计信息,其中 < 字符串 > 的值是统计信息键。使用 isi statistics
list keys 命令可获取统计信息键的完整列表。
--substr
匹配使用 --keys 指定的每个密钥的 '.*< 密钥 > .*' 的统计信息。
--begin< 时间 >
以 UNIX 纪元时间戳格式指定开始时间。
--end< 时间 >
以 UNIX 纪元时间戳格式指定结束时间。
--resolution< 整数 >
以秒为单位指定系列数据点之间的最小间隔。
--memory-only
仅检索内存中的统计信息,而不检索持久保存到磁盘的统计信息。
--raw
以十六进制输出复杂对象。

OneFS isi 命令 S 至 Z 549


{ --nodes | -n} <node>
指定要报告其统计信息的节点。可以在逗号分隔列表中指定多个值,例如 --nodes 1,2。默认值是
all。以下值有效:
● all
● < 整数 >
{--degraded | -d}
将报告设置为在某些节点无响应时继续运行。
--nohumanize
以基本数量显示所有数据(无动态转换)。如果设置,则此选项还禁用数据表中的单位显示。
{--interval | -i} < 浮点数 >
按以秒为单位指定的间隔报告数据。
{--repeat | -r} <integer>
指定在退出之前要运行报告的次数。
注: 要将报告设置为无限期运行,请指定 -1。

{--limit | -l}< 整数 >


显示要显示的统计信息数量。
--format {table | json | csv | list | top}
以表格、JavaScript Object Notation (JSON)、逗号分隔值 (CSV)、列表格式或者可在单个表格中连续覆
盖数据的顶层样式显示来显示输出。
注: 如果在不使用 --top 的情况下指定 --repeat,则报告会无限期运行。

{--noheader | -a}
显示没有列标题的数据。
{ --no-footer | -z}
显示不带页脚的数据。
{--verbose | -v}
显示更多详细信息。

isi status
显示有关群集上节点的当前状态的信息。

语法

isi status
[--all-nodes | -a]
[--node | -n < 整数 >]
[--all-nodepools | -p]
[--nodepool | -l < 字符串 >]
[--quiet | -q]
[--verbose | -v]

选项
--all-nodes | -a
显示群集上所有节点的节点特定状态。
--node | -n< 整数 >
显示由逻辑节点编号 (LNN) 指定的节点的节点特定状态。
--all-nodepools | -p
显示群集中所有节点池的节点池状态。

550 OneFS isi 命令 S 至 Z


--nodepool | -l< 字符串 >
显示指定节点池的节点池状态。
--quiet | -q
显示更少详细信息。
--verbose | -v
针对 --nodepool 或 --all-nodepools 选项显示更多详细信息。

isi storagepool health


显示存储池的运行状况信息。

语法

isi storagepool health

选项
{--verbose | -v}
显示更多详细信息。

isi storagepool list


显示群集中的节点池和层。

语法

isi storagepool list


[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--format
以指定格式显示节点池和层。 以下值有效:
table
json
csv
list
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}

OneFS isi 命令 S 至 Z 551


显示更多详细信息。

isi storagepool nodepools create


创建手动管理的节点池。 此命令应仅由有经验的 OneFS 管理员使用或在技术支持人员的帮助下使用。

语法
isi storagepool nodepools create <name>
[--lnns <lnns>]
[--verbose]

选项
<name>
指定节点池的名称。 名称必须以字母或下划线开头,只能包含字母、数字、连字符、下划线或句点。
{--lnns<LNN> | -n<LNN>}
指定该池中的节点。 节点可以是逗号分隔的列表,或某个范围内的 LNN,例如 1,4,10,12,14,15 或
1-6。
{--verbose | -v}
显示更多详细信息。

isi storagepool nodepools delete


删除节点池并将受影响的节点自动调配到适当的节点池。 此命令仅适用于手动管理的节点池,并且只能由有经验的 OneFS 管理
员执行或者在技术支持人员的指导下执行。

语法

isi storagepool nodepools delete <name>


[--force]
[--verbose]

选项
< 名称 >
指定要删除的节点的名称。
{--force | -f}
禁止显示任何提示、警告或确认消息。
{--verbose | -v}
显示更多详细信息。

552 OneFS isi 命令 S 至 Z


isi storagepool nodepools list
查看节点池的列表。

语法

isi storagepool nodepools list


[--limit <integer>
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
指定要显示的节点池数量。
--format
以指定格式显示层。 以下值有效:
table
json
csv
list
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi storagepool nodepools modify


修改节点池。

语法
isi storagepool nodepools modify <name>
[{--protection-policy | -p} <string>]
[{--lnns | -n} <integer>] | [--add-lnns <integer>] | --remove-lnns <integer>] | --node-
type-ids <integer>]
[--add-node-type-ids <integer> | --remove-node-type-ids <integer>]
[{--tier -t} <string> | --clear-tier]
[{--l3 | -3}{yes | no}]
[{--assess | -a}]
[{--set-name | -s} <string>]

OneFS isi 命令 S 至 Z 553


选项
< 字符串 >
要修改的节点池的名称。
--protection-policy < 字符串 >
请求的节点池保护。可能的保护策略值包括:
● +1n
● +2d:1n
● +2n
● +3d:1n
● +3d:1n1d
● +3n
● +4d:1n
● +4d:2n
● +4n
● 镜像值:2x、3x、4x、5x、6x、7x、8x
OneFS 将计算最佳保护策略(称为建议的保护)。如果您设置的值低于建议的保护,OneFS 将显示警
报。
{--lnns | -n} < 整数 >
手动管理的节点池的节点。为手动管理的节点池的每个附加节点指定 --lnns。
--add-lnns < 整数 >
为手动管理的节点池添加节点。为要添加的每个附加节点指定 --add-lnns。
--remove-lnns < 整数 >
为手动管理的节点池删除节点。为要删除的每个附加节点指定 --remove-lnns。
--node-type-ids < 整数 >
节点池的节点类型 ID。为每个附加节点类型 ID 指定 --node-type-ids。
--add-node-type-ids < 整数 >
添加节点池的节点类型 ID。为要添加的每个附加项目指定 --add-node-type-ids。
--remove-node-type-ids < 整数 >
删除节点池的节点类型 ID。为要删除的每个附加项目指定 --remove-node-type-ids。
{--tier | -t} < 字符串 >
设置节点池的父池。可以将节点池组合为一个层,以为特定的文件池提供服务。
--clear-tier
从其父层中删除指定的节点池。
{--l3 | -3} {yes | no}
在指定节点池中将 SSD 用作 L3 缓存。请注意,在 Isilon HD400、A200 和 A2000 节点池上,L3 高速缓
存默认是启用的,而且无法将其禁用。如果您尝试禁用 HD400、A200 或 A2000 节点池上的 L3 高速缓
存,OneFS 将生成以下错误消息: Disabling L3 not supported for the given node
type.
{--assess | -a}
测试是否可以执行操作。
--set-name < 字符串 >
手动管理的节点池的新名称。
{--verbose | -v}
显示更多详细信息。
{--force | -f }
请勿要求确认。

554 OneFS isi 命令 S 至 Z


示例
以下命令指定名为 hq_datastore 的节点池中的 SSD 将用作 L3 缓存:

isi storagepool nodepools modify hq_datastore --l3 yes

以下命令可将节点池 hq_datastore 添加到名为 archive-1 的现有层:

isi storagepool nodepools modify hq_datastore --tier archive-1

以下命令指定要包括在节点池中的节点类型:

isi storagepool nodepools modify v200_25gb_8gb --node-type-ids=1,2,3

以下命令会将节点类型添加(或合并)到指定节点池 v200_25gb_8gb:

isi storagepool nodepools modify v200_25gb_8gb --add-node-type-ids=4

isi storagepool nodepools view


显示节点池的详细信息。

语法

isi storagepool nodepools view <name>


[--verbose]

选项
< 名称 >
指定存储池的名称。
{--verbose | -v}
显示更多详细信息。

isi storagepool nodetypes list


显示节点类型的列表。

语法

isi storagepool nodetypes list


[{--limit | -l} <integer>
[--format {table | json | csv | list}]
[{--no-header | -a}]
[{--no-footer | -z}]
[{--verbose | -v}]

OneFS isi 命令 S 至 Z 555


选项
{--limit | -l} < 整数 >
指定要显示的节点类型数量。
--format
以指定格式显示节点类型。以下值有效:
table
json
csv
list
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi storagepool settings modify


修改全局 SmartPools 设置。

语法
isi storagepool settings modify
[--automatically-manage-protection {all | files_at_default | none}]
[--automatically-manage-io-optimization {all | files_at_default | none}]
[--protect-directories-one-level-higher {yes | no}]
[--global-namespace-acceleration-enabled {yes | no}]
[--virtual-hot-spare-deny-writes {yes | no}]
[--virtual-hot-spare-hide-spare {yes | no}]
[--virtual-hot-spare-limit-drives <integer>]
[--virtual-hot-spare-limit-percent <integer>]
[--spillover-target <string>]
[--spillover-anywhere]
[--spillover-enabled {yes | no}]
[--ssd-l3-cache-default-enabled {yes | no}]
[--ssd-qab-mirrors {one | all}]
[--ssd-system-btree-mirrors {one | all}]
[--ssd-system-delta-mirrors {one | all}]
[--verbose]

需要的权限
ISI_PRIV_SMARTPOOLS

选项
--automatically-manage-protection {all | files_at_default | none}
指定 SmartPools 是否管理文件的保护设置。
--automatically-manage-io-optimization {all | files_at_default | none}
指定 SmartPools 是否管理文件的 I/O 优化设置。

556 OneFS isi 命令 S 至 Z


--protect-directories-one-level-higher {yes | no}
保护更高一级的目录。
--global-namespace-acceleration-enabled {yes | no}
启用或禁用全局命名空间加速
--virtual-hot-spare-deny-writes {yes | no}
拒绝向虚拟热备盘写入新数据。
--virtual-hot-spare-hide-spare {yes | no}
减少虚拟热备盘的可用空间量。
--virtual-hot-spare-limit-drives < 整数 >
指定虚拟驱动器的最大数量。
--virtual-hot-spare-limit-percent < 整数 >
限制分配给虚拟热备盘的节点资源百分比。
--spillover-target < 字符串 >
指定溢出目标。
--spillover-anywhere
将溢出全局设置为任意位置。
--spillover-enabled {yes | no}
启用或禁用溢出。如果启用溢出,则写入将根据需要溢出到 spillover_target 内的池中。
--ssd-l3-cache-default-enabled {yes | no}
启用或禁用将新节点池中的 SSD 用作 L3 缓存。
--ssd-qab-mirrors {one | all}
指定将一个 QAB(配额核算数据块)镜像或所有 QAB 镜像存储在 SSD 上。默认设置是将一个镜像存储
在 SSD 上。通过指定 all,系统对 QAB 的访问可能会更快。
--ssd-system-btree-mirrors {one | all}
指定将一个系统 B-tree 镜像或所有系统 B-tree 镜像存储在 SSD 上。默认设置是将一个镜像存储在 SSD
上。通过指定 all,系统对 B-tree 的访问可能会更快。
--ssd-system-delta-mirrors {one | all}
指定将一个系统增量镜像或所有系统增量镜像存储在 SSD 上。默认设置是将一个镜像存储在 SSD 上。
通过指定 all,对系统 delta 的访问可能会更快。
--verbose
启用详细消息传递。

示例
以下命令指定将新创建的节点池中的 SSD 用作 L3 缓存:

isi storagepool settings modify --ssd-l3-cache-default-enabled yes

以下命令指定可将 20% 的节点资源用于虚拟热备盘:

isi storagepool settings modify --virtual-hot-spare-limit-percent 20

isi storagepool settings view


显示全局 SmartPools 设置。

语法
isi storagepool settings view

OneFS isi 命令 S 至 Z 557


选项
此命令没有选项。

示例
以下命令将显示群集上的全局 SmartPools 设置:

isi storagepool settings view

系统将显示与以下示例类似的输出:

Automatically Manage Protection: files_at_default


Automatically Manage Io Optimization: files_at_default
Protect Directories One Level Higher: Yes
Global Namespace Acceleration: disabled
Virtual Hot Spare Deny Writes: Yes
Virtual Hot Spare Hide Spare: Yes
Virtual Hot Spare Limit Drives: 1
Virtual Hot Spare Limit Percent: 0
Global Spillover Target: anywhere
Spillover Enabled: Yes
SSD L3 Cache Default Enabled: Yes
SSD Qab Mirrors: one
SSD System Btree Mirrors: one
SSD System Delta Mirrors: one

isi storagepool tiers create


创建层。

语法

isi storagepool tiers create <name>


[--children <string>]
[--verbose]

选项
< 名称 >
指定存储池层的名称。 指定任意字符串。
--children< 字符串 >
指定要添加到层的精简池 对于每个要添加的节点池,请包括单独的 --children 参数。
--verbose
显示更多详细信息。

注: 名称必须以字母或下划线开头,只能包含字母、数字、连字符、下划线或句点。

示例
以下命令将创建一个层并向其中添加两个节点池:

isi storagepool tiers create ARCHIVE_1 --children hq_datastore1


--children hq_datastore2

558 OneFS isi 命令 S 至 Z


isi storagepool tiers delete
删除层。

语法

isi storagepool tiers delete {<name> | --all}


[--verbose]

选项
{<name> | --all}
指定要删除的层。 可接受值包括层的名称或所有名称。
{--verbose | -v}
显示更多详细信息。

isi storagepool tiers list


显示层列表。

语法

isi storagepool tiers list


[{--limit | -l} integer
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l}
指定要显示的存储池层的数量。
--format
以指定格式显示层。以下值有效:
table
json
csv
list
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 559


isi storagepool tiers modify
修改层。

语法

isi storagepool tiers modify <name>


[{--set-name | -s} <string>]
[{--children | -c} <string> | --clear-children | --add-children <string> | --remove-
children <string>]
[--verbose]

选项
< 名称 >
指定要修改的层。
{--set-name | -s} <字符串>
为层设置新名称。
{--children | -c} < 字符串 >
指定作为层子项的节点池。为每个附加节点池指定 --children。
--clear-children
清除作为层子项的节点池的值。
--add-children < 字符串 >
添加作为层子项的节点池。为要添加的每个附加节点池指定 --add-children。
--remove-children < 字符串 >
删除作为层子项的节点池。为要删除的每个附加节点池指定 --remove-children。
{--verbose | -v}
显示更多详细信息。

注: 名称必须少于 256 个字符,以字母或下划线开头,只能包含字母、数字、连字符、下划线或句点。

isi storagepool tiers view


显示层的详细信息。

语法

isi storagepool tiers view <name>

选项
<name>
指定层的名称。
{--verbose | -v}
显示更多详细信息。

560 OneFS isi 命令 S 至 Z


isi storagepool unprovisioned view
显示 Isilon 群集中的未调配节点和驱动器。

语法

isi storagepool unprovisioned view


[--limit <integer>
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
限制要显示的未调配节点和驱动器的数量。
--format
以指定格式显示未调配节点和驱动器的列表。以下值有效:
table
json
csv
list
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi swift accounts create


创建新 Swift 帐户。

语法
isi swift accounts create <name> <swiftuser> <swiftgroup>
[--zone <string>]
[--users <string>]
[--verbose]

选项
< 名称 >
指定 Swift 帐户的名称。
<Swift 用户 >
指定在 Swift 帐户中拥有文件的文件系统用户。

OneFS isi 命令 S 至 Z 561


<Swift 组 >
指定在 Swift 帐户中拥有文件的文件系统组。<Swift 组 > 与代表帐户的目录相关联,而容器和对象则与
用户的主要组相关联。如果管理员要将 <Swift 组 > 分配给容器和对象,则必须将 <Swift 组 > 指定为
Swift 用户的主要组。
--zone < 字符串 >
指定与 Swift 帐户关联的访问分区。
--users < 字符串 >
指定获得 Swift 帐户访问权限的用户。为每个必须获得 Swift 帐户访问权限的额外用户指定 --users。
{--verbose | -v}
显示详细信息。

isi swift accounts delete


删除 Swift 帐户。

语法
isi swift accounts delete <name>
[--zone <string>]
[--verbose]
[--force]

选项
< 名称 >
指定 Swift 帐户名称。
--zone < 字符串 >
指定与 Swift 帐户关联的访问分区。
{--verbose | -v}
显示详细信息。
{--force | -f}
在删除之前不要求确认。

isi swift accounts list


列出所有 Swift 帐户。

语法
isi swift accounts list
[--zone <string>]
[--limit <integer>]
[--sort (name | zone | swiftuser | swiftgroup | users)]
[--descending]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

562 OneFS isi 命令 S 至 Z


选项
--zone < 字符串 >
指定与 Swift 帐户关联的访问分区。
{--limit | -l} < 整数 >
指定要显示的帐户数量。
--sort (name | zone | swiftuser | swiftgroup | users)
使用帐户名、访问分区、Swift 用户、Swift 组或分配给 Swift 帐户访问权限的用户其中之一对数据进行
排序。
{--descending | -d}
按降序对数据进行排序。
--format (table | json | csv | list)
以表格、JSON、CSV 或列表格式显示帐户。
{--no-header | -a}
不会以 CSV 或表格格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示详细信息。

isi swift accounts modify


修改 Swift 帐户。

语法
isi swift accounts modify <name>
[--zone <string>]
[--swiftuser <string>]
[--swiftgroup <string>]
[--users <string> | --clear-users | --add-users <string> | --remove-users <string>]
[--verbose]

选项
< 名称 >
指定 Swift 帐户的名称。
--zone < 字符串 >
指定与 Swift 帐户关联的访问分区。
--swiftuser < 字符串 >
指定在 Swift 帐户中拥有文件的文件系统用户。
--swiftgroup < 字符串 >
指定在 Swift 帐户中拥有文件的文件系统组。<Swift 组 > 与代表帐户的目录相关联,而容器和对象则与
用户的主要组相关联。如果管理员要将 <Swift 组 > 分配给容器和对象,则必须将 <Swift 组 > 指定为
Swift 用户的主要组。
--users < 字符串 >
指定获得 Swift 帐户访问权限的用户。为每个必须获得 Swift 帐户访问权限的额外用户指定 --users。
--clear-users
清除为获得 Swift 帐户访问权限的用户指定的值。
--add-users < 字符串 >

OneFS isi 命令 S 至 Z 563


添加用户并为其分配 Swift 帐户的访问权限。为要添加的每个额外用户指定 --add-users。
--remove-users < 字符串 >
删除获得 Swift 帐户访问权限的用户。为要删除的每个额外用户指定 --remove-users。
{--verbose | -v}
显示详细信息。

isi swift accounts view


显示与 Swift 帐户关联的详细信息。

语法
isi swift accounts view <name>
[--zone <string>]

选项
< 名称 >
指定 Swift 帐户的名称。
--zone < 字符串 >
指定与 Swift 帐户关联的访问分区。

isi sync certificates peer delete


删除受信任的 SyncIQ TLS 证书。

语法
isi sync certificates peer delete <id>
[--force]
[--verbose]

选项
<ID>
系统证书标识符或证书名称。
{--force | -f}
不提示确认删除。
{--verbose | -v}
显示更多详细信息。

564 OneFS isi 命令 S 至 Z


isi sync certificates peer import
导入受信任的 SyncIQ TLS 证书。

语法
isi sync certificates peer import <certificate-path>
[--name <string>]
[--description <string>]
[--verbose]

选项
<certificate-path>
TLS 证书文件(采用 PEM、DER 或 PCKS#12 格式)的本地路径。此证书文件会拷贝到系统证书存储区
域中,可以在导入之后删除。
--name < 字符串 >
管理员配置的证书标识符。
--description < 字符串 >
为方便管理而提供的描述字段。
{--verbose | -v}
显示更多详细信息。

isi sync certificates peer list


查看受信任的 SyncIQ TLS 证书的列表。

语法
isi sync certificates peer list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l}< 整数 >
要列出的 SyncIQ 证书对等主机的数量。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 565


isi sync certificates peer modify
修改受信任的 SyncIQ TLS 证书。

语法
isi sync certificates peer modify <id>
[--name <string>]
[--description <string>]
[--verbose]

选项
<ID>
系统证书标识符或证书名称。
--name < 字符串 >
管理员配置的证书标识符。
--description < 字符串 >
为方便管理而提供的描述字段。
{--verbose | -v}
显示更多详细信息。

isi sync certificates peer view


查看受信任的 SyncIQ TLS 证书。

语法
isi sync certificates peer view <id>
[--format (list | json)]

选项
<ID>
系统证书标识符或证书名称。
--format (list | json)
以列表(默认)或 JavaScript Object Notation (JSON) 格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

566 OneFS isi 命令 S 至 Z


isi sync certificates server delete
删除 SyncIQ TLS 证书。

语法
isi sync certificates server delete <id>
[--force]
[--verbose]

选项
<ID>
系统证书标识符或证书名称。
{--force | -f}
不提示确认删除。
{--verbose | -v}
显示更多详细信息。

isi sync certificates server import


导入 SyncIQ TLS 证书。

语法
isi sync certificates server import <certificate-path> <certificate-key-path>
[--name <string>]
[--certificate-key-password <string>]
[--verbose]

选项
<certificate-path>
TLS 证书文件(采用 PEM、DER 或 PCKS#12 格式)的本地路径。此证书文件会拷贝到系统证书存储区
域中,可以在导入之后删除。
<certificate-key-path>
TLS 证书密钥文件(采用 PEM、DER 或 PCKS#12 格式)的本地路径。此证书密钥文件会拷贝到系统证
书存储区域中,应在导入之后删除。
--name < 字符串 >
管理员配置的证书标识符。
--certificate-key-password < 字符串 >
证书密钥的密码(如果私钥使用密码进行加密)。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 567


isi sync certificates server list
查看 SyncIQ TLS 证书列表。

语法
isi sync certificates server list
[--limit <integer>]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l}< 整数 >
要列出的 SyncIQ 证书服务器数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync certificates server modify


修改 SyncIQ TLS 证书。

语法
isi sync certificates server modify <id>
[--name <string>]
[--description <string>]
[--verbose]

选项
<ID>
系统证书标识符或证书名称。
--name < 字符串 >
管理员配置的证书标识符。
--description < 字符串 >
为方便管理而提供的描述字段。
{--verbose | -v}
显示更多详细信息。

568 OneFS isi 命令 S 至 Z


isi sync certificates server view
查看 SyncIQ TLS 证书。

语法
isi sync certificates peer view <id>
[--format (list | json)]

选项
<ID>
系统证书标识符或证书名称。
--format (list | json)
以列表(默认)或 JavaScript Object Notation (JSON) 格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync jobs cancel


取消运行中或暂停的复制作业。

语法
isi sync jobs cancel {<policy-name> | --all}
[--verbose]

选项
<policy-name>
取消根据指定的复制策略创建的作业。
指定复制策略名称或 ID。
--all
取消当前正在运行的所有复制作业。
--verbose
显示更多详细信息。

OneFS isi 命令 S 至 Z 569


isi sync jobs list
显示有关复制策略最近完成的以及计划的下一次复制作业的信息。

语法
isi sync jobs list
[--state <state>]
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
如果未指定选项,则显示有关所有策略的复制作业的信息。
--state< 状态 >
仅显示指定状态的作业。
以下值有效:

scheduled 显示计划运行的作业。
running 显示正在运行的作业。
paused 显示被用户暂停的作业。
finished 显示已成功完成的作业。
failed 显示在复制过程中失败的作业。
canceled 显示被用户取消的作业。
needs_attention 显示需要用户干预才能继续的作业。

--format {table | json | csv | list}


以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync jobs pause


暂停正在运行的复制作业。

语法
isi sync jobs pause {<policy-name> | --all}
[--verbose]

570 OneFS isi 命令 S 至 Z


选项
<policy-name>
暂停根据指定的复制策略创建的作业。
指定复制策略名称。
--all
暂停当前正在运行的所有复制作业。
{--verbose | -v}
显示更多详细信息。

isi sync jobs reports list


显示有关正在运行的、针对本地群集的复制作业的信息。

语法
isi sync jobs reports list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync jobs reports view


显示有关正在运行的、针对本地群集的复制作业的信息。

语法
isi sync jobs reports view <policy>

选项
<policy>
显示有关根据指定策略创建的复制作业的信息。

OneFS isi 命令 S 至 Z 571


指定复制策略名称或 ID。

isi sync jobs resume


恢复暂停的复制作业。

语法
isi sync jobs resume {<policy-name> | --all}
[--verbose]

选项
<policy-name>
恢复按指定策略创建的已暂停作业。
指定复制策略名称。
--all
恢复当前正在运行的所有复制作业。
{--verbose | -v}
显示更多详细信息。

isi sync jobs start


针对复制策略启动复制作业。

语法
isi sync jobs start <policy-name>
[--test]
[--source-snapshot <snapshot>]
[--verbose]

选项
<policy-name>
针对指定的复制策略启动复制作业。
--test
创建反映以下内容的复制策略报告:运行指定的策略时会复制的文件和目录的数量。 您可以仅测试之前
未运行过的策略。
--source-snapshot< 快照 >
根据指定 SnapshotIQ 快照复制数据。 如果指定,将不会针对复制工作生成快照。 不支持根据 SyncIQ
工具生成的快照复制数据。
指定快照名称或 ID。 策略的源目录必须包含在指定的快照中。 仅当上一个复制作业成功完成或执行完整
或差异复制时,此选项才有效。 如果上一个复制作业成功完成,则指定的快照时间必须比上一个复制作
业引用的快照新。
{--verbose | -v}
显示更多详细信息。

572 OneFS isi 命令 S 至 Z


isi sync jobs view
显示有关正在运行的复制作业的信息。

语法
isi sync jobs view <policy>

选项
<policy>
显示有关根据指定策略创建的、正在运行的复制作业的信息。
指定复制策略名称或 ID。

isi sync policies create


创建复制策略。

语法
isi sync policies create <name> <action>
<source-root-path> <target-host> <target-path>
[--enabled (yes | no)]
[--description <string>]
[--check-integrity (yes | no)]
[--source-include-directories <string>]
[--source-exclude-directories <string>]
[--source-subnet <subnet> | --source-pool <pool>]
[--target-snapshot-archive (on | off)]
[--target-snapshot-pattern <naming-pattern>]
[--target-snapshot-expiration <duration>]
[--target-snapshot-alias <naming-pattern>]
[--target-detect-modifications (on | off)]
[--source-snapshot-archive (on | off)]
[--source-snapshot-pattern <naming-pattern>]
[--source-snapshot-expiration <duration>]
[--snapshot-sync-pattern <pattern>]
[--snapshot-sync-existing (yes | no)]
[--schedule (<schedule> | when-source-modified
| when-snapshot-taken)]
[--job-delay <duration>]
[--skip-when-source-unmodified (true | false)]
[--rpo-alert <duration>]
[--log-level <level>]
[--log-removed-files (yes | no)]
[--workers-per-node <integer>]
[--report-max-age <duration>]
[--report-max-count <integer>]
[--restrict-target-network (on | off)]
[--target-compare-initial-sync (on | off)]
[--accelerated-failback (yes | no)]
[--priority (0 | 1 | normal | high)]
[--cloud-deep-copy (deny | allow | force)]
[--bandwidth-reservation <integer>]
[--target-certificate-id <string>]
[--ocsp-issuer-certificate-id <string>]
[--ocsp-address <string>]
[--encryption-cipher-list <string>]
[--linked-service-policies <string>]
[--delete-quotas (yes | no)]

OneFS isi 命令 S 至 Z 573


[--password (<password>]
[--set-password)]
[--verbose]

选项
< 名称 >
指定复制策略的名称。
指定任意字符串。
< 操作 >
指定复制策略的类型。
以下复制策略类型有效:

copy 创建将所有文件的拷贝从源添加到目标的拷贝策略。
sync 创建以下同步策略:将源群集上的数据同步到目标群集并删除目标群集上未显示在
源群集中的所有文件。

< 源根路径 >


在本地群集上指定要从中复制文件的目录。
指定完整目录路径。
< 目标主机 >
指定策略要将数据复制到其中的群集。
指定以下值之一:
● 目标群集中任意节点的完全限定的域名。
● 目标群集中任意节点的主机名。
● 目标群集中 SmartConnect 分区的名称。
● 目标群集中任意节点的 IPv4 或 IPv6 地址。
● localhost
这会将数据复制到本地群集的另一个目录。

注: SyncIQ 不支持动态分配的 IP 地址池。如果复制作业连接至动态分配的 IP 地址,SmartConnect


可能会在复制作业运行时重新分配地址,这可能会断开作业并导致作业失败。
< 目标路径 >
在目标群集上指定要将文件复制到其中的目录。
指定完整目录路径。
--enabled (yes | no)
确定策略是已启用还是已禁用。
默认值为 yes。
--description < 字符串 >
指定复制策略的描述。
--check-integrity (yes | no}
指定是否针对受 SyncIQ 作业影响的每个文件数据包执行校验和。如果将此选项设置为 yes 且校验和值
不匹配,SyncIQ 将重新传输文件数据包。
默认值为 yes。
{--source-include-directories | -i} < 路径 >
仅在复制中包括指定的目录。
指定包含在根目录中的任何目录路径。可以通过在一个命令中多次指定 --source-include-
directories 来指定多个目录。例如,如果根目录为 /ifs/data,则可以指定以下内容:

--source-include-directories /ifs/data/music --source-include-


directories /ifs/data/movies

574 OneFS isi 命令 S 至 Z


{--source-exclude-directories | -e} < 路径 >
不在复制中包括指定目录。指定包含在根目录中的任何目录路径。如果指定了 --source-include-
directories,则 --source-exclude-directories 目录必须包含在包括的目录中。可以通过在
一个命令中多次指定 --source-exclude-directories 来指定多个目录。例如,您可以指定以下内
容:

--source-exclude-directories /ifs/data/music --source-exclude-


directories /ifs/data/movies \
--exclude /ifs/data/music/working

--source-subnet < 子网 >


将复制作业限制为仅在本地群集的指定子网中的节点上运行。如果指定此选项,您还必须指定 --
source-pool。
--source-pool < 池 >
将复制作业限制为仅在本地群集的指定池中的节点上运行。如果指定此选项,您还必须指定 --
source-subnet。
--target-snapshot-archive {on | off}
确定是否在目标群集上生成归档快照。如果将此选项设置为 off,SyncIQ 仍将一次仅在目标群集上保留
一份快照,以方便回切。必须在目标群集上激活 SnapshotIQ 许可证,才能在目标群集上生成归档快照。
--target-snapshot-pattern < 命名模式 >
为复制作业在目标群集上生成的快照指定快照命名模式。
默认命名模式为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-%Y-%m-%d_%H-%M

--target-snapshot-expiration < 持续时间 >


在目标群集上指定归档快照的到期期限。
如果未指定此选项,归档快照将无限期保留在目标群集上。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--target-snapshot-alias < 命名模式 >


为目标群集上最近生成的归档快照指定命名模式。
默认别名为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-latest

--target-detect-modifications {on | off}


确定在复制文件之前 SyncIQ 是否检查目标目录以进行修改。
小心: 指定 off 可能会导致数据丢失。建议您在指定 off 之前先咨询 Isilon 技术支持。

--source-snapshot-archive {on | off}


确定是否在源群集上保留归档快照。如果将此选项设置为 off,SyncIQ 仍将一次为策略保留一份快照,
以方便复制。
--source-snapshot-pattern < 命名模式 >
为源群集上最近生成的归档快照指定命名模式。

OneFS isi 命令 S 至 Z 575


例如,以下模式为有效模式:

SIQ-source-%{PolicyName}-%Y-%m-%d_%H-%M

--source-snapshot-expiration < 持续时间 >


指定保留在源群集上的归档快照的到期期限。
如果未指定此选项,归档快照将无限期存在于源群集上。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--snapshot-sync-pattern < 字符串 >


当计划设置为 when-snapshot-taken 时,快照命名模式必须匹配才能触发复制作业。默认值为星号
(*)。
--snapshot-sync-existing (yes | no)
如果设置为 Yes,则快照触发的复制作业将包括在策略创建时间之前执行的复制。默认设置为 No。如果
设置为 yes,则设置 --schedule when-snapshot-taken。
{--schedule | -S} {< 计划 > | when-source-modified | when-snapshot-taken}
指定数据的复制频率。指定 when-source-modified 会导致 OneFS 在每次修改策略的源目录时都会
复制数据。指定 when-snapshot-taken 会导致 OneFS 在每次拍摄源目录的快照时都会复制数据。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

576 OneFS isi 命令 S 至 Z


● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to
<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
--job-delay < 持续时间 >
指定 SyncIQ 在修改源目录后和在启动复制作业前等待的时间量。如果将此复制策略的 --schedule 设
置为 when-source-modified,并且修改了源目录的内容,则 SyncIQ 将在启动复制作业前等待指定
时间量。
默认值为 0 seconds。
--skip-when-source-unmodified {true | false}
如果源目录的内容自上次运行此策略以来未曾修改,会导致策略无法运行。如果将此复制策略的 --
schedule 设置为 < 计划 >,并且将策略计划为在更改源目录的内容之前运行,将不会运行策略。
--rpo-alert < 持续时间 >
如果超过指定恢复点目标 (RPO),会创建 OneFS 事件。例如,假设您设置 5 hours 的 RPO;一个作业
在下午 1:00 启动,并在下午 3:00 完成;第二个作业在下午 3:30 启动;如果第二个作业没有在下午 6:00
完成,SyncIQ 将创建一个 OneFS 事件。
默认值为 0,这将不会生成事件。仅当将 --schedule 设置为 < 计划 > 时,此选项才有效。

注: 仅当通过 SyncIQ 设置全局启用 RPO 警报时,此选项才有效。事件的事件 ID 为 400040020。

--log-level < 级别 >


指定记录在日志中的数据量。
有效值如下所示,它们按最少到最多信息的顺序排列:
● fatal
● error
● notice
● info
● copy
● debug
● trace
默认值为 info。
--log-removed-files {yes | no}
确定在运行同步策略时 SyncIQ 是否保留删除的所有文件的日志。此参数对复制策略没有影响。
默认值为 no。
{--workers-per-node | -w} < 整数 >
指定每个节点上由 SyncIQ 生成、用以针对策略执行每个复制作业的工作进程的数量。
默认值为 3。

注: 此选项已被弃用,因此即使配置也无法识别。

--report-max-age < 持续时间 >


指定复制报告在被 SyncIQ 自动删除之前的保留时间。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数

OneFS isi 命令 S 至 Z 577


H 指定小时数

--report-max-count < 整数 >


为保留策略指定要保留的报告的最大数量。
--restrict-target-network (on | off)
如果指定 on 并将目标群集指定为 SmartConnect 分区,复制作业将仅连接至指定分区中的节点。如果指
定 off,则不会将复制作业限定到目标群集上的特定节点。
--target-compare-initial-sync (on | off)
确定针对此策略执行完整复制还是差异复制。在首次运行策略或者重置策略后,将执行完整复制或差异
复制。如果设置为 on,将执行差异复制。如果设置为 off,将执行完整复制。
如果在首次运行复制策略时启用了差异复制,策略运行速度将变慢且不会带来任何优势。
默认值为 off。
--accelerated-failback (enable | disable)
如果启用,SyncIQ 将在下次运行作业时执行回切配置任务,而不是在回切过程中等待执行这些任务。提
前执行这些任务将增加回切操作的速度。
--priority (0 | 1)
确定策略是否具有优先级。
默认值为 0,这意味着策略没有优先级。如果设置为 1,则策略为高优先级。
--cloud-deep-copy (deny | allow | force)
确定策略将如何复制 CloudPools 智能链接。如果设置为 deny,SyncIQ 会将所有 CloudPools 智能链接
都复制到目标群集作为智能链接;如果目标群集不支持智能链接,则作业将失败。如果设置为 force,
SyncIQ 会将所有智能链接都复制到目标群集作为常规文件。如果设置为 allow,SyncIQ 会尝试将智能
链接复制到目标群集作为智能链接;如果目标群集不支持智能链接,SyncIQ 将复制智能链接作为常规文
件。
--bandwidth-reservation < 整数 >
此策略所需的带宽保留,以 kb/s 为单位。除非 SyncIQ 带宽规则生效,否则此功能不会激活。
--target-certificate-id < 字符串 >
用于加密的目标群集证书的标识符。
--ocsp-issuer-certificate-id < 字符串 >
颁发要检查其吊销状态的证书的证书颁发机构的标识符。
--ocsp-address < 字符串 >
要连接到的 OCSP 响应方的地址。
--encryption-cipher-list < 字符串 >
与群集加密一起使用的密码列表。对于 SyncIQ 目标,这是受支持的密码列表。对于 SyncIQ 源,将按顺
序使用密码列表。
--linked-service-policies < 字符串 >...
SyncIQ 策略标识符列表,其源根目录将用于筛选服务复制。为每个额外的服务策略标识符再次指定此选
项。
--delete-quotas (yes | no)
如果设置为 Yes,则在从源中删除配额时,强制从目标中删除配额。
--password < 密码 >
指定用于访问目标群集的密码。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --
set-password。
--set-password
命令运行后提示您为目标群集指定密码。如果您不希望群集上的其他用户看到您指定的密码,该功能很
有用。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --password。
{--verbose | -v}
显示确认创建了快照计划的消息。

578 OneFS isi 命令 S 至 Z


isi sync policies delete
删除复制策略。
命令要等到 SyncIQ 可与目标群集通信后才会成功;届时,策略仍会显示在 isi sync policies list 命令的输出中。 源群
集与目标群集重新建立连接后,SyncIQ 将在此作业下次计划运行时删除策略;如果策略配置为仅手动运行,您就必须重新手动
运行策略。 如果 SyncIQ 一直无法与目标群集通信,请指定 --local-only 选项。 这将仅从本地群集删除策略,而不会断开
目标群集上的目标关联。

语法
isi sync policies delete {<policy> | --all}
[--local-only]
[--force]
[--verbose]

选项
<policy>
删除指定的复制策略。
--all
删除所有复制策略。
--local-only
不要断开目标群集上的目标关联。 不删除目标群集上的策略关联将导致目标目录保留在只读状态。
注: 如果 SyncIQ 无法与目标群集通信,您必须指定此选项才能成功删除策略。

{--force | -f}
删除策略,即使关联的作业当前正在运行也是如此。 而且不会提示您确认删除。
小心: 如果关联的复制作业当前正在运行,强制策略进行删除可能会导致错误。

{--verbose | -v}
显示确认消息。

isi sync policies disable


临时禁用复制策略。 如果禁用复制策略,策略将不会创建复制作业。 但是,如果当前正在针对某个复制策略运行复制作业,禁
用策略将暂停或停止作业。

语法
isi sync policies disable {<policy> | --all}
[--verbose]

选项
<policy>
禁用指定的复制策略。 指定复制策略名称或复制策略 ID。
--all
在群集上禁用所有复制策略。
--verbose
显示更多详细信息。

OneFS isi 命令 S 至 Z 579


isi sync policies enable
启用已禁用的复制策略。

语法
isi sync policies enable {<policy> | --all}
[--verbose]

选项
<policy>
启用指定的复制策略。 指定复制策略名称或复制策略 ID。
--all
在群集上启用所有复制策略。
--verbose
显示更多详细信息。

isi sync policies list


显示复制策略的列表。

语法
isi sync policies list
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
如果未指定选项,则显示所有复制策略的表。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

name 按复制策略的名称对输出进行排序。
target_path 按目标目录的路径对输出进行排序。
action 按复制策略的类型对输出进行排序。
description 按策略描述对输出进行排序。
enabled 按策略处于启用还是禁用状态对输出进行排序。
target_host 按目标群集对输出进行排序。

580 OneFS isi 命令 S 至 Z


check_integri 按策略是否配置为针对受复制作业影响的每个文件数据包执行校验和对输出进行排
ty 序。
source_root_p 按源目录的路径对输出进行排序。
ath
source_includ 按显式包括在复制中的目录对输出进行排序。
e_directories
source_exclud 按显式排除在复制以外的目录对输出进行排序。
e_directories
file_matching 按确定要复制的文件的谓词对输出进行排序。
_pattern
target_snapsh 按是否在目标群集上生成归档快照对输出进行排序。
ot_archive
target_snapsh 按复制作业在目标群集上生成的快照的快照命名模式对输出进行排序。
ot_pattern
target_snapsh 按目标群集上的归档快照的到期期限对输出进行排序。
ot_expiration
target_detect 按针对此策略执行完整复制还是差异复制对输出进行排序。
_modification
s
source_snapsh 按是否在源群集上保留归档快照对输出进行排序。
ot_archive
source_snapsh 按在源群集上生成的最新归档快照的命名模式对输出进行排序。
ot_pattern
source_snapsh 按源群集上保留的归档快照的到期期限对输出进行排序。
ot_expiration
schedule 按策略计划对输出进行排序。
log_level 按记录在日志中的数据量对输出进行排序。
log_removed_f 按 OneFS 是否保留运行复制策略时删除的所有文件的日志对输出进行排序。
iles
workers_per_n 按 OneFS 生成的、用以根据策略执行每个复制作业的每个节点的工作进程数对输
ode 出进行排序。
report_max_ag 按复制报告在被 OneFS 自动删除之前的保留时间对输出进行排序。
e
report_max_co 按针对复制策略保留的最大报告数量对输出进行排序。
unt
force_interfa 按数据是否仅通过由 isi sync policies create 的 --source-network
ce 选项或 isi sync policies modify 命令指定的子网的默认接口发送对输出
进行排序。
restrict_targ 按是否将复制作业限制为连接到目标群集上指定分区中的节点对输出进行排序。
et_network
target_compar 按针对策略执行完整复制还是差异复制对输出进行排序。
e_initial_syn
c
last_success 按上一次成功完成的复制作业对输出进行排序。
password_set 按策略是否为目标群集指定密码对输出进行排序。
source_networ 按将复制策略限制到的本地群集上的子网对输出进行排序。
k
source_interf 按将复制策略限制到的本地群集上的池对输出进行排序。
ace

{--descending | -d}

OneFS isi 命令 S 至 Z 581


以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync policies modify


修改现有复制策略。

语法
isi sync policies modify <policy>
[--name <new-policy-name>]
[--action <policy-type>]
[--target-host <target-cluster>]
[--target-path <target-path>]
[--source-root-path <root-path>]
[--description <string>]
[--password <password>]
[--set-password]
[--source-include-directories <string>]
[--clear-source-include-directories]
[--add-source-include-directories <string>]
[--remove-source-include-directories <string>]
[--source-exclude-directories <string>]
[--clear-source-exclude-directories]
[--add-source-exclude-directories <string>]
[--remove-source-exclude-directories <string>]
[--begin-filter <predicate> --operator <value> ... --end-filter]
[--schedule {<schedule> | when-source-modified}]
[--skip-when-source-unmodified {true | false}]
[--rpo-alert <duration>]
[--job-delay <duration>]
[--clear-job-delay]
[--snapshot-sync-pattern <pattern>]
[--snapshot-sync-existing {yes | no}]
[--enabled {true | false}]
[--check-integrity {true | false}]
[--log-level <level>]
[--log-removed-files {yes | no}]
[--workers-per-node <integer>]
[--target-snapshot-archive {on | off}]
[--target-snapshot-pattern <naming-pattern>]
[--target-snapshot-expiration <duration>]
[--target-snapshot-alias <naming-pattern>]
[--target-detect-modifications {on | off}]
[--source-snapshot-archive {on | off}]
[--source-snapshot-pattern <naming-pattern>]
[--source-snapshot-expiration <duration>]
[--report-max-age <duration>]
[--report-max-count <integer>]
[--restrict-target-network {on | off}]
[--source-subnet <subnet> --source-pool <pool>]
[--clear-source-network]
[--target-compare-initial-sync {on | off}]
[--accelerated-failback {yes | no}]
[--priority {0 | 1}]
[--cloud-deep-copy {deny | allow | force}]

582 OneFS isi 命令 S 至 Z


[--verbose]
[--force]

选项
< 策略 >
按当前策略 ID 或名称标识要修改的策略。
{--name | -n} < 新策略名称 >
为此复制策略指定新名称。
--action < 策略类型 >
指定复制策略的类型。
以下复制策略类型有效:

copy 创建将所有文件的拷贝从源添加到目标的拷贝策略。
sync 创建以下同步策略:将源群集上的数据同步到目标群集并删除目标群集上未显示在
源群集中的所有文件。

{--target-host | -C} < 目标群集 >


指定策略要将数据复制到其中的群集。
指定以下值之一:
● 目标群集中任意节点的完全限定的域名。
● 目标群集中任意节点的主机名。
● 目标群集中 SmartConnect 分区的名称。
● 目标群集中任意节点的 IPv4 或 IPv6 地址。
● localhost
这会将数据复制到本地群集的另一个目录。

注: SyncIQ 不支持动态分配的 IP 地址池。如果复制作业连接至动态分配的 IP 地址,SmartConnect


可能会在复制作业运行时重新分配地址,这可能会断开作业并导致作业失败。

{--target-path | -p} < 目标路径 >


在目标群集上指定要将文件复制到其中的目录。
指定完整目录路径。
--source-root-path < 根路径 >
在本地群集上指定要从中复制文件的目录。
指定完整目录路径。
--description < 字符串 >
指定此复制策略的描述。
--password < 密码 >
指定用于访问目标群集的密码。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --
set-password。
--set-password
命令运行后提示您为目标群集指定密码。如果您不希望群集上的其他用户看到您指定的密码,该功能很
有用。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --password。
{--source-include-directories | -i} < 路径 >
仅在复制中包括指定的目录。
指定包含在根目录中的任何目录路径。可以通过在一个命令中多次指定 --source-include-
directories 来指定多个目录。例如,如果根目录为 /ifs/data,则可以指定以下内容:

--source-include-directories /ifs/data/music --source-include-


directories /ifs/data/movies

--clear-source-include-directories

OneFS isi 命令 S 至 Z 583


清除包括的目录列表。
--add-source-include-directories < 路径 >
将指定目录添加到包括的目录列表中。
--remove-source-include-directories < 路径 >
从包括的目录列表删除指定目录。
{--source-exclude-directories | -e} < 路径 >
不在复制中包括指定目录。
指定包含在根目录中的任何目录路径。如果指定了 --source-include-directories,则 --
source-exclude-directories 目录必须包含在包括的目录中。可以通过在一个命令中多次指定 --
source-exclude-directories 来指定多个目录。例如,您可以指定以下内容:

--source-exclude-directories /ifs/data/music --source-exclude-


directories /ifs/data/movies --exclude /ifs/data/music/working

--clear-source-exclude-directories
清除排除的目录列表。
--add-source-exclude-directories < 路径 >
将指定目录添加到排除的目录列表中。
--remove-source-exclude-directories < 路径 >
从排除的目录列表中删除指定目录。
--begin-filter < 谓词 >--operator < 值 > [< 谓词 >--operator<operator> <l 链接 >]... --end-filter
指定用于确定复制哪些文件的文件匹配条件。指定 < 谓词 > 与下列一个或多个选项:
对于拷贝和同步策略,下列选项均有效:
--size< 整数 >[{B | KB | MB | GB | TB | PB}]
根据指定大小选择文件。
--file-type < 值 >
仅选择指定的文件系统对象类型。
以下值有效:

f 指定常规文件
d 指定目录
l 指定软链接

--name < 值 >


仅选择名称与指定字符串匹配的文件。
您可以包含以下通配符:
● *
● [ ]
● ?
以下选项仅对拷贝策略有效:
--accessed-after '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months |
years} ago}'
选择自指定时间以来访问过的文件。此谓词仅对拷贝策略有效。
--accessed-before '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months |
years} ago}'
选择自指定时间以来未访问过的文件。此谓词仅对拷贝策略有效。
--accessed-time '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months |
years} ago}'
选择在指定时间访问过的文件。此谓词仅对拷贝策略有效。
--birth-after '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months | years}
ago}'
选择在指定时间之后创建的文件。此谓词仅对拷贝策略有效。

584 OneFS isi 命令 S 至 Z


--birth-before '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months | years}
ago}'
选择在指定时间之前创建的文件。此谓词仅对拷贝策略有效。
--birth-time '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months | years}
ago}'
选择在指定时间创建的文件。此谓词仅对拷贝策略有效。
--changed-after '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months |
years} ago}'
选择自指定时间以来修改过的文件。此谓词仅对拷贝策略有效。
--changed-before '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months |
years} ago}'
选择自指定时间以来未修改过的文件。此谓词仅对拷贝策略有效。
--changed-time '{<mm>/<dd>/<yyyy> [<HH>:<mm>] | < 整数 > {days | weeks | months | years}
ago}'
选择在指定时间修改过的文件。此谓词仅对拷贝策略有效。
--no-group
根据文件是否由组拥有来选择文件。
--no-user
根据文件是否由用户拥有来选择文件。
--posix-regex-name < 值 >
仅选择名称与指定的 POSIX 正则表达式匹配的文件。支持 IEEE Std 1003.2 (POSIX.2) 正则表达
式。
--user-id <ID>
根据文件是否由指定 ID 的用户拥有来选择文件。
--user-name < 名称 >
根据文件是否由指定名称的用户拥有来选择文件。
--group-id <ID>
根据文件是否由指定 ID 的组拥有来选择文件。
--group-name < 名称 >
根据文件是否由指定名称的组拥有来选择文件。
下列 < 运算符 > 值有效:

运算符 描述
eq 等于。这是默认值。
ne 不等于
lt 小于
le 小于或等于
gt 大于
ge 大于或等于
not Not

您可以使用下列 < 链接 > 值合并和更改可用于谓词的选项:


--and
选择满足位于该值之前和之后的选项条件的文件。
--or
选择满足位于该值之前的选项条件的文件或满足位于该值之后的选项条件的文件。
{--schedule | -S} {< 计划 > | when-source-modified}
指定数据的复制频率。指定 when-source-modified 会导致 OneFS 在每次修改策略的源目录时都会
复制数据。

OneFS isi 命令 S 至 Z 585


采用以下格式指定 < 计划 >:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
要将策略配置为仅手动运行,请指定以下选项:

--schedule ""

--skip-when-source-unmodified {true | false}


如果源目录的内容自上次运行此策略以来未曾修改,会导致策略无法运行。如果将此复制策略的 --
schedule 设置为 < 计划 >,并且将策略计划为在更改源目录的内容之前运行,将不会运行策略。
--rpo-alert < 持续时间 >
如果超过指定恢复点目标 (RPO),会创建 OneFS 事件。例如,假设您设置 5 hours 的 RPO;一个作业
在下午 1:00 启动,并在下午 3:00 完成;第二个作业在下午 3:30 启动;如果第二个作业没有在下午 6:00
完成,SyncIQ 将创建一个 OneFS 事件。
默认值为 0,这将不会生成事件。仅当将 --schedule 设置为 < 计划 > 时,此选项才有效。

注: 仅当通过 SyncIQ 设置全局启用 RPO 警报时,此选项才有效。事件的事件 ID 为 400040020。

--job-delay < 持续时间 >


指定 SyncIQ 在修改源目录后和在启动复制作业前等待的时间量。如果将此复制策略的 --schedule 设
置为 when-source-modified,并且修改了源目录的内容,则 SyncIQ 将在启动复制作业前等待指定
时间量。
默认值为 0 seconds。
--clear-job-delay
清除 SyncIQ 在修改源目录后和在启动复制作业前等待的时间量。
--snapshot-sync-pattern < 模式 >
指定要同步的快照的命名模式。如果将此复制策略的 --schedule 设置为 when-snapshot-taken,
拍摄源目录的快照,并且快照名称与指定命名模式匹配,则 SyncIQ 会将快照复制到目标群集。

586 OneFS isi 命令 S 至 Z


默认值为 "*",这会在将策略的 --schedule 设置为 when-snapshot-taken 时,导致复制源目录
的所有快照。
--snapshot-sync-existing {yes | no}
确定是否策略是否复制创建策略前拍摄的快照中包含的数据。
注: 由于最初创建策略后即无法修改此设置,因此无法使用 isi sync policies modify 指定此
选项。

--enabled {true | false}


确定策略是已启用还是已禁用。
--check-integrity {true | false}
指定是否针对受 SyncIQ 作业影响的每个文件数据包执行校验和。如果将此选项设置为 true 且校验和值
不匹配,则 SyncIQ 将重新传输文件数据包。
默认值为 true。
--log-level < 级别 >
指定记录在日志中的数据量。
有效值如下所示,它们按最少到最多信息的顺序排列:
● fatal
● error
● notice
● info
● copy
● debug
● trace
默认值为 info。
--log-removed-files {yes | no}
确定在运行同步策略时 SyncIQ 是否保留删除的所有文件的日志。如果是拷贝策略,此参数将不受影响。
默认值为 no。
{--workers-per-node | -w} < 整数 >
指定每个节点上由 SyncIQ 生成、用以针对策略执行每个复制作业的工作进程的数量。
默认值为 3。

注: 此选项已被弃用,因此即使配置也无法识别。

--target-snapshot-archive {on | off}


确定是否在目标群集上生成归档快照。如果将此选项设置为 off,SyncIQ 仍将一次仅在目标群集上保留
一份快照,以方便回切。必须在目标群集上激活 SnapshotIQ 许可证,才能在目标群集上生成归档快照。
--target-snapshot-pattern < 命名模式 >
为复制作业在目标群集上生成的快照指定快照命名模式。
默认命名模式为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-%Y-%m-%d_%H-%M

--target-snapshot-expiration < 持续时间 >


在目标群集上指定归档快照的到期期限。
如果未指定此选项,归档快照将无限期保留在目标群集上。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数

OneFS isi 命令 S 至 Z 587


W 指定周数
D 指定天数
H 指定小时数

--target-snapshot-alias < 命名模式 >


为目标群集上最近生成的归档快照指定命名模式。
默认别名为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-latest

--target-detect-modifications {on | off}


确定在复制文件之前 SyncIQ 是否检查目标目录以进行修改。
小心: 指定 off 可能会导致数据丢失。建议您在指定 off 之前先咨询 Isilon 技术支持。

--source-snapshot-archive {on | off}


确定是否在源群集上保留归档快照。如果将此选项设置为 off,SyncIQ 仍将一次为策略保留一份快照,
以方便复制。
--source-snapshot-pattern < 命名模式 >
为源群集上最近生成的归档快照指定命名模式。
例如,以下模式为有效模式:

SIQ-source-%{PolicyName}-%Y-%m-%d_%H-%M

--source-snapshot-expiration < 持续时间 >


指定保留在源群集上的归档快照的到期期限。
如果未指定此选项,归档快照将无限期存在于源群集上。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--report-max-age < 持续时间 >


指定复制报告在被 SyncIQ 自动删除之前的保留时间。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--report-max-count < 整数 >


为保留策略指定要保留的报告的最大数量。
--restrict-target-network {on | off}

588 OneFS isi 命令 S 至 Z


如果指定 on 并将目标群集指定为 SmartConnect 分区,复制作业将仅连接至指定分区中的节点。如果指
定 off,则不会将复制作业限定到目标群集上的特定节点。
--source-subnet < 子网 >
将复制作业限制为仅在本地群集的指定子网中的节点上运行。
--source-pool < 池 >
将复制作业限制为仅在本地群集的指定池中的节点上运行。
--clear-source-network
在群集中的任意节点上运行复制作业,而不是将作业限制在指定子网。
--target-compare-initial-sync {on | off}
确定针对此策略执行完整复制还是差异复制。在首次运行策略或者重置策略后,将执行完整复制或差异
复制。如果设置为 on,将执行差异复制。如果设置为 off,将执行完整复制。
如果在首次运行复制策略时启用了差异复制,策略运行速度将变慢且不会带来任何优势。
默认值为 off。
--accelerated-failback {enable | disable}
如果启用,SyncIQ 将在下次运行作业时执行回切配置任务,而不是在回切过程中等待执行这些任务。提
前执行这些任务将增加回切操作的速度。
--priority {0 | 1}
确定策略是否具有优先级。
--cloud-deep-copy {deny | allow | force}
确定策略将如何复制 CloudPools 智能链接。如果设置为 deny,SyncIQ 会将所有 CloudPools 智能链接
都复制到目标群集作为智能链接;如果目标群集不支持智能链接,则作业将失败。如果设置为 force,
SyncIQ 会将所有智能链接都复制到目标群集作为常规文件。如果设置为 allow,SyncIQ 会尝试将智能
链接复制到目标群集作为智能链接;如果目标群集不支持智能链接,SyncIQ 将复制智能链接作为常规文
件。
{--verbose | -v}
显示确认消息。
{--force | -f}
不提示您确认修改。

isi sync policies reset


在策略遇到错误且无法确定错误原因或无法更正错误时重置复制策略。 如果能确定错误原因并进行更正,则运行 isi sync
policies resolve。
重置复制策略将导致在下一次运行策略时执行完整复制或差异复制。

语法
isi sync policies reset {<policy> | --all}
[--verbose]

选项
<policy>
重置指定的复制策略。
指定复制策略名称或 ID
--all
重置所有复制策略
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 589


isi sync policies resolve
在策略遇到错误且错误得到更正后解析发生冲突的复制策略。如果无法更正错误原因,则联系技术支持。

语法
isi sync policies resolve <policy>
[--force]

选项
<policy>
解析指定的复制策略。
指定复制策略名称或 ID。
{--force | -f}
禁止显示命令行提示符和消息。

isi sync policies view


显示有关复制策略的信息。

语法
isi sync policies view <policy>

选项
<policy>
显示有关指定的复制策略的信息。
指定复制策略名称或 ID。

isi sync recovery allow-write


允许在不中断本地群集与策略之间的关联的情况下对复制策略的目标目录中的数据进行修改。 isi sync target
allow_write 命令最常用于故障切换和回切操作。

语法
isi sync recovery allow-write <policy-name>
[--revert]
[--log-level <level>]
[--workers-per-node <integer>]
[--verbose]

选项
<policy-name>

590 OneFS isi 命令 S 至 Z


允许针对指定复制策略的目标目录进行写入。
指定复制策略名称、复制策略 ID 或目标目录的路径。
--revert
仅恢复本地群集上的允许写入操作。 此操作不影响复制策略的源群集。
--log-level< 级别 >
指定记录在日志中的数据量。
有效值如下所示,它们按最少到最多信息的顺序排列:
● fatal
● error
● notice
● info
● copy
● debug
● trace
默认值为 info。
{--workers-per-node | -w}< 整数 >
指定每个节点上由 SyncIQ 生成、用以执行允许写入作业的工作进程的数量。
默认值为 3。
{--verbose | -v}
显示更多详细信息。

isi sync recovery resync-prep


禁用指定策略,将策略的源目录恢复到上一个恢复点,并在目标群集上创建镜像策略。 isi sync resync prep 命令最常用
于回切操作。

语法
isi sync recovery resync-prep <policy-name>
[--verbose]

选项
<policy-name>
针对以下复制策略。
指定复制策略名称或 ID。 复制策略必须是同步策略。
--verbose
显示更多详细信息。

isi sync reports list


显示有关针对远程群集的已完成复制作业的信息。

语法
isi sync reports list
[--policy-name <policy>]
[--state <state>]

OneFS isi 命令 S 至 Z 591


[--reports-per-policy <integer>]
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--policy-name< 策略 >
仅显示针对指定策略创建的复制报告。
--state< 状态 >
仅显示其作业处于指定状态的复制报告。
--reports-per-policy< 整数 >
针对每个策略显示不超过指定数量的报告。 10 默认值为 。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:
start_time
按复制作业的开始时间对输出进行排序。
end_time
按复制作业的结束时间对输出进行排序。
action
按复制作业执行的操作对输出进行排序。
state
按复制作业的进度对输出进行排序。
id
按复制子报告的 ID 对输出进行排序。
policy_id
按复制策略的 ID 对输出进行排序。
policy_name
按复制策略的名称对输出进行排序。
job_id
按复制作业的 ID 对输出进行排序。
total_files
按复制作业修改过的文件总数对输出进行排序。
files_transferred
按传输到目标群集的文件总数对输出进行排序。
bytes_transferred
按传输到目标群集的文件总数对输出进行排序。
duration
按复制作业的运行时长对输出进行排序。
errors
按复制作业遇到的错误对输出进行排序。
warnings
按复制作业触发的警告对输出进行排序。

592 OneFS isi 命令 S 至 Z


{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync reports rotate


如果复制报告的数量超过最大值,则删除复制报告。 系统会间歇性地自动删除超出最大数量的报告。 但是,此命令会导致超出
最大数量的报告立即被删除。

语法
isi sync reports rotate
[--verbose]

选项
{--verbose | -v}
显示更多详细信息。

isi sync reports subreports list


显示有关针对远程群集的已完成复制作业的子报告。

语法
isi sync reports subreports list <policy> <job-id>
[--limit]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
<policy>
显示有关指定策略的子报告。
<job-id>
显示有关指定 ID 的作业的子报告。
{--limit | -l} < 整数 >
显示不超过指定的项目数。

OneFS isi 命令 S 至 Z 593


--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:
start_time
按复制作业的开始时间对输出进行排序。
end_time
按复制作业的结束时间对输出进行排序。
action
按复制作业执行的操作对输出进行排序。
state
按复制作业的进度对输出进行排序。
id
按复制报告的 ID 对输出进行排序。
policy_id
按复制策略的 ID 对输出进行排序。
policy_name
按复制策略的名称对输出进行排序。
job_id
按复制作业的 ID 对输出进行排序。
total_files
按复制作业修改过的文件总数对输出进行排序。
files_transferred
按传输到目标群集的文件总数对输出进行排序。
bytes_transferred
按传输到目标群集的文件总数对输出进行排序。
duration
按复制作业的运行时长对输出进行排序。
errors
按复制作业遇到的错误对输出进行排序。
warnings
按复制作业触发的警告对输出进行排序。
{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

594 OneFS isi 命令 S 至 Z


isi sync reports subreports view
显示有关针对远程群集的已完成复制作业的子报告。

语法
isi sync reports subreports view <policy> <job-id> <subreport-id>

选项
<policy>
显示有关指定的复制策略的子报告。 指定复制策略名称。
<job-id>
显示有关指定的复制作业的子报告。 指定复制作业 ID。
<subreport-id>
显示指定 ID 的子报告。

isi sync reports view


显示有关针对远程群集的已完成复制作业的信息。

语法
isi sync reports view <policy> <job-id>

选项
<policy>
显示有关指定的复制策略的复制报告。
<job-id>
显示有关指定 ID 的作业的复制报告。

isi sync rules create


创建复制性能规则。

语法
isi sync rules create <type> <interval> <days> <limit>
[--description <string>]
[--verbose]

选项
<type>

OneFS isi 命令 S 至 Z 595


指定性能规则的类型。 以下值有效:
file_count
创建限制每秒钟可由复制作业发送的文件数量的性能规则。
bandwidth
创建限制复制作业可以使用的带宽量的性能规则。
<interval>
在一天的指定小时内强制执行性能规则。 采用以下格式指定:

<hh>:<mm>-<hh>:<mm>

<days>
在一周的指定天数内强制执行性能规则。
以下值有效:

X 指定星期日
M 指定星期一
T 指定星期二
W 指定星期三
R 指定星期四
F 指定星期五
S 指定星期六

可以通过指定以逗号分隔的多个值来包括多天。 还可以通过指定以短横线分隔的两个值来包括某个范围
内的天数。
<limit>
指定可以发送的最大文件数或复制作业每秒钟可以使用的最大 KB 数。
--description< 字符串 >
指定此性能规则的描述。
--verbose
显示更多详细信息。

isi sync rules delete


删除复制性能规则。

语法
isi sync rules delete {<id> | --all | --type <type>}
[--force]
[--verbose]

选项
<id>
删除指定 ID 的性能规则。
--all
删除所有性能规则。
--type< 类型 >
删除指定类型的性能规则。 以下值有效:
file_count

596 OneFS isi 命令 S 至 Z


删除限制每秒钟可由复制作业发送的文件数量的所有性能规则。
操作成本
删除限制复制作业可以使用的带宽量的所有性能规则。
--force
不会提示您确认是否要删除性能规则。
--verbose
显示更多详细信息。

isi sync rules list


显示复制性能规则的列表。

语法
isi sync rules list
[--type <type>]
[--limit]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--type< 类型 >
仅显示指定类型的性能规则。 以下值有效:
file_count
仅显示限制每秒钟可由复制作业发送的文件数量的性能规则。
操作成本
仅显示限制复制作业可以使用的带宽量的性能规则。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync rules modify


修改复制性能规则。

语法
isi sync rules modify <id>
[--interval <interval>]
[--days <days>]

OneFS isi 命令 S 至 Z 597


[--limit <integer>]
[--enabled {true | false}]
[--description <string>]
[--verbose]

选项
<id>
修改指定 ID 的复制性能规则。
{--interval | -i} < 间隔 >
指定在一天的哪些小时内强制执行性能规则。 采用以下格式指定:

<hh>:<mm>-<hh>:<mm>

{--days | -d} < 天 >


指定在一周的哪些天内强制执行性能规则。
以下值有效:

X 指定星期日
M 指定星期一
T 指定星期二
W 指定星期三
R 指定星期四
F 指定星期五
S 指定星期六

可以通过指定以逗号分隔的多个值来包括多天。 还可以通过指定以短横线分隔的两个值来包括某个范围
内的天数。
--limit<limit>
指定可以发送的最大文件数或复制作业每秒钟可以使用的最大 KB 数。
--enabled {true | false}
确定策略是已启用还是已禁用。
--description< 字符串 >
指定此性能规则的描述。
{--verbose | -v}
显示更多详细信息。

isi sync rules reports list


列出正在运行的作业的 SyncIQ 带宽报告。

语法
isi sync rules reports list
[--policy-id <string>]
[--start <integer>]
[--end <integer>]
[--sort (name | speed)]
[--descending]

598 OneFS isi 命令 S 至 Z


选项
--policy-id < 字符串 >
SyncIQ 策略标识符。
{--start | -s} < 整数 >
带宽报告的开始时间戳。
{--end | -e} < 整数 >
带宽报告的结束时间戳。
--sort (name | speed)
按指定字段对数据进行排序。
{--descending | -d}
按降序对数据进行排序。

isi sync rules reports view


查看正在运行的 SyncIQ 作业的带宽。

语法
isi sync rules reports view <policy-id>
[--start <integer>]
[--end <integer>]

选项
< 策略 ID>
SyncIQ 策略标识符。
{--start | -s} < 整数 >
带宽报告的开始时间戳。
{--end | -e} < 整数 >
带宽报告的结束时间戳。

isi sync rules view


显示有关复制性能规则的信息。

语法
isi sync rules view <id>

选项
<id>
显示有关指定 ID 的复制性能规则的信息。

OneFS isi 命令 S 至 Z 599


isi sync service policies create
创建 SyncIQ 服务策略。

语法
isi sync service policies create <name> <target-host>
[--enabled (yes | no)]
[--description <string>]
[--check-integrity (yes | no)]
[--source-subnet <subnet> | --source-pool <pool>]
[--target-snapshot-pattern <naming-pattern>]
[--target-snapshot-expiration <duration>]
[--target-snapshot-alias <naming-pattern>]
[--source-snapshot-pattern <naming-pattern>]
[--source-snapshot-expiration <duration>]
[--snapshot-sync-pattern <pattern>]
[--snapshot-sync-existing (yes | no)]
[--schedule (<schedule> | when-source-modified
| when-snapshot-taken)]
[--rpo-alert <duration>]
[--log-level <level>]
[--workers-per-node <integer>]
[--report-max-age <duration>]
[--report-max-count <integer>]
[--restrict-target-network (on | off)]
[--target-compare-initial-sync (on | off)]
[--accelerated-failback (yes | no)]
[--priority (0 | 1 | normal | high)]
[--bandwidth-reservation <integer>]
[--target-certificate-id <string>]
[--ocsp-issuer-certificate-id <string>]
[--ocsp-address <string>]
[--encryption-cipher-list <string>]
[--linked-data-policies <string>]
[--replicated-services <string>]
[--service-history-max-age <duration>]
[--service-history-max-count <integer>]
[--password (<password>]
[--set-password)]
[--verbose]

选项
< 名称 >
指定复制服务策略的名称。
指定任意字符串。
< 目标主机 >
指定策略要将数据复制到其中的群集。
指定以下值之一:
● 目标群集中任意节点的完全限定的域名。
● 目标群集中任意节点的主机名。
● 目标群集中 SmartConnect 分区的名称。
● 目标群集中任意节点的 IPv4 或 IPv6 地址。
● localhost
这会将数据复制到本地群集的另一个目录。

注: SyncIQ 不支持动态分配的 IP 地址池。如果复制作业连接至动态分配的 IP 地址,SmartConnect


可能会在复制作业运行时重新分配地址,这可能会断开作业并导致作业失败。

600 OneFS isi 命令 S 至 Z


--enabled (yes | no)
确定服务策略是已启用还是已禁用。
默认值为 yes。
--description < 字符串 >
指定复制服务策略的描述。
--check-integrity (yes | no}
指定是否针对受复制策略影响的每个文件数据包执行校验和。如果将此选项设置为 yes 且校验和值不匹
配,SyncIQ 将重新传输文件数据包。
默认值为 yes。
--source-subnet < 子网 >
将复制策略限制为仅在本地群集的指定子网中的节点上运行。如果指定此选项,您还必须指定 --
source-pool。
--source-pool < 池 >
将复制策略限制为仅在本地群集的指定池中的节点上运行。如果指定此选项,您还必须指定 --
source-subnet。
--target-snapshot-pattern < 命名模式 >
为复制作业在目标群集上生成的快照指定快照命名模式。
默认命名模式为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-%Y-%m-%d_%H-%M

--target-snapshot-expiration < 持续时间 >


在目标群集上指定归档快照的到期期限。
如果未指定此选项,归档快照将无限期保留在目标群集上。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--target-snapshot-alias < 命名模式 >


为目标群集上最近生成的归档快照指定命名模式。
默认别名为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-latest

--source-snapshot-pattern < 命名模式 >


为源群集上最近生成的归档快照指定命名模式。
例如,以下模式为有效模式:

SIQ-source-%{PolicyName}-%Y-%m-%d_%H-%M

--source-snapshot-expiration < 持续时间 >


指定保留在源群集上的归档快照的到期期限。
如果未指定此选项,归档快照将无限期存在于源群集上。

OneFS isi 命令 S 至 Z 601


采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--snapshot-sync-pattern < 字符串 >


当计划设置为 when-snapshot-taken 时,快照命名模式必须匹配才能触发复制作业。默认值为星号
(*)。
--snapshot-sync-existing (yes | no)
如果设置为 Yes,则快照触发的复制作业将包括在策略创建时间之前执行的复制。默认设置为 No。如果
设置为 yes,则设置 --schedule when-snapshot-taken。
{--schedule | -S} (<schedule | when-source-modified | when-snapshot-taken)
指定执行复制策略的频率。指定 when-source-modified 会导致 OneFS 在每次修改策略的源目录时
都会复制数据。指定 when-snapshot-taken 会导致 OneFS 在每次拍摄源目录的快照时都会复制数
据。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
--rpo-alert < 持续时间 >

602 OneFS isi 命令 S 至 Z


如果超过指定恢复点目标 (RPO),会创建 OneFS 事件。例如,假设您设置 5 hours 的 RPO;一个作业
在下午 1:00 启动,并在下午 3:00 完成;第二个作业在下午 3:30 启动;如果第二个作业没有在下午 6:00
完成,SyncIQ 将创建一个 OneFS 事件。
默认值为 0,这将不会生成事件。仅当将 --schedule 设置为 <schedule> 时,此选项才有效。

注: 仅当通过 SyncIQ 设置全局启用 RPO 警报时,此选项才有效。事件的事件 ID 为 400040020。

--log-level < 级别 >


指定记录在日志中的数据量。
有效值如下所示,它们按最少到最多信息的顺序排列:
● fatal
● error
● notice
● info
● copy
● debug
● trace
默认值为 info。
{--workers-per-node | -w} < 整数 >
指定每个节点上由 SyncIQ 生成、用以针对策略执行每个复制作业的工作进程的数量。
默认值为 3。

注: 此选项已被弃用,因此即使配置也无法识别。

--report-max-age < 持续时间 >


指定复制报告在被 SyncIQ 自动删除之前的保留时间。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--report-max-count < 整数 >


为保留策略指定要保留的报告的最大数量。
--restrict-target-network (on | off)
如果指定 on 并将目标群集指定为 SmartConnect 分区,复制作业将仅连接至指定分区中的节点。如果指
定 off,则不会将复制作业限定到目标群集上的特定节点。
--accelerated-failback (enable | disable)
如果启用,SyncIQ 将在下次运行作业时执行回切配置任务,而不是在回切过程中等待执行这些任务。提
前执行这些任务将增加回切操作的速度。
--priority (0 | 1)
确定策略是否具有优先级。
默认值为 0,这意味着策略没有优先级。如果设置为 1,则策略为高优先级。
--bandwidth-reservation < 整数 >
此策略所需的带宽保留,以 kb/s 为单位。除非 SyncIQ 带宽规则生效,否则此功能不会激活。
--target-certificate-id < 字符串 >
用于加密的目标群集证书的标识符。

OneFS isi 命令 S 至 Z 603


--ocsp-issuer-certificate-id < 字符串 >
颁发要检查其吊销状态的证书的证书颁发机构的标识符。
--ocsp-address < 字符串 >
要连接到的 OCSP 响应方的地址。
--encryption-cipher-list < 字符串 >
与群集加密一起使用的密码列表。对于 SyncIQ 目标,这是受支持的密码列表。对于 SyncIQ 源,将按顺
序使用密码列表。
--linked-data-policies < 字符串 >...
SyncIQ 策略标识符列表,其源根目录将用于筛选服务复制。为每个额外的服务策略标识符再次指定此选
项。
--replicated-services < 字符串 >
要复制的服务列表。为每个额外服务再次指定。
--service-history-max-age < 持续时间 >
要维护的服务信息的最长期限。
--service-history-max-count < 整数 >
要维护的服务历史记录信息的最大数量。
--password < 密码 >
指定用于访问目标群集的密码。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --
set-password。
--set-password
命令运行后提示您为目标群集指定密码。如果您不希望群集上的其他用户看到您指定的密码,该功能很
有用。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --password。
{--verbose | -v}
显示确认创建了快照计划的消息。

isi sync service policies delete


删除一个或所有 SyncIQ 服务策略。

语法
isi sync service policies delete <policy> | --all
[--local-only]
[--force]
[--verbose]

选项
< 策略 >
删除指定的复制服务策略。
--all
删除所有复制服务策略。
--local-only
不要断开目标群集上的目标关联。不删除目标群集上的策略关联将导致目标目录保留在只读状态。
注: 如果 SyncIQ 无法与目标群集通信,您必须指定此选项才能成功删除服务策略。

{--force | -f}
删除服务策略,即使关联的作业当前正在运行也是如此。而且不会提示您确认删除。
小心: 如果关联的复制作业当前正在运行,强制服务策略进行删除可能会导致错误。

{--verbose | -v}

604 OneFS isi 命令 S 至 Z


显示确认消息。

isi sync service policies disable


禁用一个或所有复制服务策略。

语法
isi sync service policies disable <policy> | --all
[--verbose]

选项
< 策略 >
禁用指定的复制策略。指定复制策略名称或复制策略 ID。
--all
在群集上禁用所有复制策略。
{--verbose | -v}
显示更多详细信息。

isi sync service policies enable


启用一个或所有复制服务策略。

语法
isi sync service policies enable <policy> | --all
[--verbose]

选项
< 策略 >
启用指定的复制服务策略。指定复制服务策略名称或 ID。
--all
在群集上启用所有复制服务策略。
{--verbose | -v}
显示更多详细信息。

isi sync service policies list


列出复制服务策略。

语法
isi sync service policies list
[--limit <integer>]
[--sort (id | name | source_root_path | enabled | target_host | target_path |

OneFS isi 命令 S 至 Z 605


target_snapshot_pattern | target_snapshot_expiration | target_snapshot_alias |
source_snapshot_pattern | source_snaphot_expiration | snapshot_sync_pattern |
snapshot_sync_existing | schedule | rpo_alert | log_level | workers_per_node |
report_max_age | report_max_count | force_interface | restrict_target_network |
expected_dataloss | disable_fofb | disable_file_split | accelerated_failback |
database_mirrored | source_domain_marked | priority | bandwidth_reservation |
last_job_state | last_started | last_success | password_set | conflicted | has_sync_date
| source_certificate_id | ocsp_address | encryption_cipher_list | encrypted |
linked_data_policies | replicated_services | service_history_max_age |
service_history_max_count) ]
[--descending]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
如果未指定选项,则显示所有复制服务策略的列表。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort < 属性 >
按照指定的属性对显示的输出进行排序。
{--descending | -d}
以相反的顺序显示输出。
--format (table | json | csv | list)
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync service policies modify


修改复制服务策略。

语法
isi sync service policies modify <policy>
[--name <service_policy_name>]
[--enabled (yes | no)]
[--target-host <target-cluster>]
[--description <service-policy-description>]
[--check-integrity (yes | no)]
[--source-subnet <subnet> --source-pool <pool>]
[--target-snapshot-pattern <naming-pattern>]
[--target-snapshot-expiration <duration>]
[--target-snapshot-alias <naming-pattern>]
[--source-snapshot-pattern <naming-pattern>]
[--source-snapshot-expiration <duration>]
[--snapshot-sync-pattern <pattern>]
[--snapshot-sync-existing (yes | no)]
[--schedule (<schedule> | when-source-modified | when-snapshot-taken)]
[--rpo-alert <duration>]
[--clear-rpo-alert]
[--log-level <level>]

606 OneFS isi 命令 S 至 Z


[--workers-per-node <integer> | --clear-rpo]
[--report-max-age <duration>]
[--report-max-count <integer>]
[--restrict-target-network (on | off)]
[--accelerated-failback (yes | no)]
[--priority (0 | 1 | normal | high)]
[--bandwidth-reservation <integer>]
[--clear-bandwidth-reservation]
[--target-certificate-id <string>]
[--ocsp-issuer-certificate-id <string>]
[--ocsp-address <string>]
[--encryption-cipher-list <string>]
[--linked-data-policies <string>]
[--clear-linked-data-policies]
[--add-linked-data-policies <string>...]
[--remove-linked-data-policies <string>...]
[--replicated-services <string>]
[--clear-replicated-services]
[--add-replicated-services <string>...]
[--remove-replicated-services <string>...]
[--service-history-max-age <duration>]
[--service-history-max-count <integer>]
[--password (<password>]
[--set-password)]
[--clear-source-network]
[--verbose]
[--force]

选项
< 策略 >
复制服务策略名称。
{--name | -n} < 服务策略名称 >
指定复制服务策略的名称。
指定任意字符串。
--enabled (yes | no)
确定服务策略是已启用还是已禁用。
默认值为 yes。
{--target-host | -C} < 目标群集 >
指定要将服务策略数据复制到其中的群集。
指定以下值之一:
● 目标群集中任意节点的完全限定的域名。
● 目标群集中任意节点的主机名。
● 目标群集中 SmartConnect 分区的名称。
● 目标群集中任意节点的 IPv4 或 IPv6 地址。
● localhost
这会将数据复制到本地群集的另一个目录。

注: SyncIQ 不支持动态分配的 IP 地址池。如果复制作业连接至动态分配的 IP 地址,SmartConnect


可能会在复制作业运行时重新分配地址,这可能会断开作业并导致作业失败。

--description < 服务策略描述 >


指定复制服务策略的描述。
--check-integrity (yes | no}
指定是否针对受复制策略影响的每个文件数据包执行校验和。如果将此选项设置为 yes 且校验和值不匹
配,SyncIQ 将重新传输文件数据包。
默认值为 yes。
--source-subnet < 子网 >

OneFS isi 命令 S 至 Z 607


将复制服务策略限制为仅在本地群集的指定子网中的节点上运行。如果指定此选项,您还必须指定 --
source-pool。
--source-pool < 池 >
将复制服务策略限制为仅在本地群集的指定池中的节点上运行。如果指定此选项,您还必须指定 --
source-subnet。
--target-snapshot-pattern < 命名模式 >
为复制作业在目标群集上生成的快照指定快照命名模式。
默认命名模式为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-%Y-%m-%d_%H-%M

--target-snapshot-expiration < 持续时间 >


在目标群集上指定归档快照的到期期限。
如果未指定此选项,归档快照将无限期保留在目标群集上。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--target-snapshot-alias < 命名模式 >


为目标群集上最近生成的归档快照指定命名模式。
默认别名为以下字符串:

SIQ-%{SrcCluster}-%{PolicyName}-latest

--source-snapshot-pattern < 命名模式 >


为源群集上最近生成的归档快照指定命名模式。
例如,以下模式为有效模式:

SIQ-source-%{PolicyName}-%Y-%m-%d_%H-%M

--source-snapshot-expiration < 持续时间 >


指定保留在源群集上的归档快照的到期期限。
如果未指定此选项,归档快照将无限期存在于源群集上。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--snapshot-sync-pattern < 字符串 >

608 OneFS isi 命令 S 至 Z


当计划设置为 when-snapshot-taken 时,快照命名模式必须匹配才能触发复制作业。默认值为星号
(*)。
--snapshot-sync-existing (yes | no)
如果设置为 Yes,则快照触发的复制作业将包括在策略创建时间之前执行的复制。默认设置为 No。如果
设置为 yes,则设置 --schedule when-snapshot-taken。
{--schedule | -S} (< 计划 > | when-source-modified | when-snapshot-taken)
指定执行复制策略的频率。指定 when-source-modified 会导致 OneFS 在每次修改策略的源目录时
都会复制数据。指定 when-snapshot-taken 会导致 OneFS 在每次拍摄源目录的快照时都会复制数
据。
采用以下格式指定:

"<interval> [<frequency>]"

采用以下格式之一指定 < 间隔 >:

● Every [{other | <integer>}] {weekday | day}

● Every [{other | <integer>}] week [on <day>]

● Every [{other | <integer>}] month [on the <integer>]

● Every [<day>[, ...] [of every [{other | <integer>}] week]]

● The last {day | weekday | <day>} of every [{other | <integer>}] month

● The <integer> {weekday | <day>} of every [{other | <integer>}] month

● Yearly on <month> <integer>

● Yearly on the {last | <integer>} [weekday | <day>] of <month>

采用以下格式之一指定 < 频率 >:

● at <hh>[:<mm>] [{AM | PM}]

● every [<integer>] {hours | minutes} [between <hh>[:<mm>] [{AM | PM}]


and <hh>[:<mm>] [{AM | PM}]]

● every [<integer>] {hours | minutes} [from <hh>[:<mm>] [{AM | PM}] to


<hh>[:<mm>] [{AM | PM}]]

您可以选择将“st”、“th”或“rd”附加到 < 整数 >。例如,您可以指定“Every 1st month”


将 < 天 > 指定为任何一个星期几或是该天的三字母缩写。例如,“saturday”和“sat”都有效。
--rpo-alert < 持续时间 >
如果超过指定恢复点目标 (RPO),会创建 OneFS 事件。例如,假设您设置 5 hours 的 RPO;一个作业
在下午 1:00 启动,并在下午 3:00 完成;第二个作业在下午 3:30 启动;如果第二个作业没有在下午 6:00
完成,SyncIQ 将创建一个 OneFS 事件。
默认值为 0,这将不会生成事件。仅当将 --schedule 设置为 < 计划 > 时,此选项才有效。

注: 仅当通过 SyncIQ 设置全局启用 RPO 警报时,此选项才有效。事件的事件 ID 为 400040020。

--clear-rpo-alert
清除 RPO 警报。
--log-level < 级别 >
指定记录在日志中的数据量。
有效值如下所示,它们按最少到最多信息的顺序排列:
● fatal
● error

OneFS isi 命令 S 至 Z 609


● notice
● info
● copy
● debug
● trace
默认值为 info。
{--workers-per-node | -w} < 整数 >
指定每个节点上由 SyncIQ 生成、用以针对策略执行每个复制作业的工作进程的数量。
默认值为 3。

注: 此选项已被弃用,因此即使配置也无法识别。

--report-max-age < 持续时间 >


指定复制报告在被 SyncIQ 自动删除之前的保留时间。
采用以下格式指定:

<integer><units>

以下 < 单位 > 有效:

Y 指定年数
M 指定月数
W 指定周数
D 指定天数
H 指定小时数

--report-max-count < 整数 >


为保留策略指定要保留的报告的最大数量。
--restrict-target-network (on | off)
如果指定 on 并将目标群集指定为 SmartConnect 分区,复制作业将仅连接至指定分区中的节点。如果指
定 off,则不会将复制作业限定到目标群集上的特定节点。
--accelerated-failback (enable | disable)
如果启用,SyncIQ 将在下次运行作业时执行回切配置任务,而不是在回切过程中等待执行这些任务。提
前执行这些任务将增加回切操作的速度。
--priority (0 | 1)
确定策略是否具有优先级。
默认值为 0,这意味着策略没有优先级。如果设置为 1,则策略为高优先级。
--bandwidth-reservation < 整数 >
此策略所需的带宽保留,以 kb/s 为单位。除非 SyncIQ 带宽规则生效,否则此功能不会激活。
--clear-bandwidth-reservation
清除此服务策略的带宽保留。
--target-certificate-id < 字符串 >
用于加密的目标群集证书的标识符。
--ocsp-issuer-certificate-id < 字符串 >
颁发要检查其吊销状态的证书的证书颁发机构的标识符。
--ocsp-address < 字符串 >
要连接到的 OCSP 响应方的地址。
--encryption-cipher-list < 字符串 >
与群集加密一起使用的密码列表。对于 SyncIQ 目标,这是受支持的密码列表。对于 SyncIQ 源,将按顺
序使用密码列表。
--linked-data-policies < 字符串 >...

610 OneFS isi 命令 S 至 Z


SyncIQ 策略标识符列表,其源根目录将用于筛选服务复制。为每个额外的服务策略标识符再次指定此选
项。
--clear-linked-data-policies
清除 SyncIQ 策略标识符列表。
--add-linked-data-policies < 字符串 >...
将项目添加至 SyncIQ 策略标识符列表。对多个策略重复此操作。
--remove-linked-data-policies < 字符串 >...
从 SyncIQ 策略标识符列表中删除项目。对多个策略重复此操作。
--replicated-services < 字符串 >...
要复制的服务列表。为每个额外服务再次指定。
--clear-replicated-services
清除要复制的服务列表。
--add-replicated-services < 字符串 >...
将项目添加至要复制的服务列表。对多个复制的服务重复此操作。
--remove-replicated-services < 字符串 >...
从要复制的服务列表中删除项目。对多个复制的服务重复此操作。
--service-history-max-age < 持续时间 >
要维护的服务信息的最长期限。
--service-history-max-count < 整数 >
要维护的服务历史记录信息的最大数量。
--password < 密码 >
指定用于访问目标群集的密码。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --
set-password。
--set-password
命令运行后提示您为目标群集指定密码。如果您不希望群集上的其他用户看到您指定的密码,该功能很
有用。如果目标群集需要密码以用于身份验证目的,则必须指定此参数或 --password。
--clear-source-network
清除源子网和池。
{--verbose | -v}
显示确认创建了快照计划的消息。
{--force | -f}
不提示您确认修改。

isi sync service policies reset


在策略遇到错误且无法确定错误原因或无法更正错误时重置复制服务策略。如果能确定错误原因并进行更正,则运行 isi
sync service policies resolve。
重置复制服务策略将导致在下一次运行策略时执行完整复制或差异复制。

语法
isi sync service policies reset <policy> | --all
[--verbose]

选项
< 策略 >
重置指定的复制服务策略。指定复制服务策略名称或 ID

OneFS isi 命令 S 至 Z 611


--all
重置所有复制策略
{--verbose | -v}
显示更多详细信息。

isi sync service policies resolve


在策略遇到错误且错误原因得到更正后解析发生冲突的复制服务策略。如果无法更正错误原因,则联系技术支持。

语法
isi sync service policies resolve <policy>
[--force]

选项
< 策略 >
解析指定的复制策略。
指定复制策略名称或 ID。
{--force | -f}
禁止显示命令行提示符和消息。

isi sync service policies view


显示有关复制服务策略的信息。

语法
isi sync service policies view <policy>

选项
< 策略 >
显示有关指定的复制服务策略的信息。
指定复制服务策略名称或 ID。

isi sync service recovery allow-write


允许写入策略目标路径。

语法
isi sync service recovery allow-write <policy-name> <timestamp> <tgt-path>
[--log-level (fatal | error | notice | info | copy | debug | trace)]
[--skip-copy (yes | no)]
[--skip-map (yes | no)]

612 OneFS isi 命令 S 至 Z


[--skip-failover (yes | no)]
[--verbose]

选项
< 策略名称 >
故障切换/回切作业的策略名称。
< 时间戳 >
要从中恢复的服务复制策略备份的时间戳。
< 目标路径 >
用于输出要恢复的服务复制文件的目录。
--log-level < 级别 >
指定记录在日志中的数据量。
有效值如下所示,它们按最少到最多信息的顺序排列:
● fatal
● error
● notice
● info
● copy
● debug
● trace
默认值为 info。
--skip-copy (yes | no)
跳过服务复制允许写入操作的拷贝阶段。
--skip-map (yes | no)
跳过服务复制允许写入操作的映射阶段。
--skip-failover (yes | no)
跳过服务复制允许写入操作的数据故障切换阶段。
{--verbose | -v}
显示更多详细信息。

isi sync service recovery resync-prep


为重新同步准备服务策略。

语法
isi sync service recovery resync-prep <policy-name>
[--verbose]

选项
< 策略名称 >
为重新同步而准备的作业的策略名称。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 613


isi sync service target break
删除服务策略复制目标关联。

语法
isi sync service target break <policy> | --target-path <path>
[--force]
[--verbose]

选项
< 策略 >
目标复制策略名称。
< 目标路径 >
复制策略的目标路径。
{--force | -f}
即使复制作业正在运行,也要中断目标关联。请勿要求确认。
{--verbose | -v}
显示更多详细信息。

isi sync service target cancel


取消以此群集为目标当前正在运行的服务复制作业。

语法
isi sync service target cancel <policy> | --target-path <path> | --all
[--verbose]

选项
< 策略 >
目标复制策略名称。
< 目标路径 >
复制策略的目标路径。
--all
取消所有以此群集为目标正在运行的作业。
{--verbose | -v}
显示更多详细信息。

614 OneFS isi 命令 S 至 Z


isi sync service target list
列出目标策略。

语法
isi sync service target list
[--target-path <path>]
[--limit <integer>]
[--sort (name | source_host | target_path | last_job_state | failover_failback_state)]
[--descending]
[--format (table | json | csv | list)]
[--no-header]
[--no-footer]
[--verbose]

选项
--target-path < 路径 >
显示具有指定目标路径的目标策略。
--sort (name | source_host | target_path | last_job_state | failover_failback_state)
按照指定的属性对显示的输出进行排序。
{--descending | -d}
以相反的顺序显示输出。
--format (table | json | csv | list)
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync service target view


查看目标服务复制策略的属性。

语法
isi sync service target view <policy> | --target-path <path>

选项
< 策略 >
目标复制策略名称。
< 目标路径 >
复制策略的目标路径。

OneFS isi 命令 S 至 Z 615


isi sync settings modify
管理全局复制设置。

语法
isi sync settings modify
[--service(on | off | paused)]
[--source-subnet <string>]
[--source-pool <string>]
[--restrict-target-network <boolean>]
[--report-max-age <duration>]
[--report-max-count <integer>]
[--rpo-alerts <boolean>]
[--bandwidth-reservation-reserve-percentage <integer>]
[--bandwidth-reservation-reserve-absolute <integer> |
--clear-bandwidth-reservation-reserve-absolute]
[--encryption-required <boolean>]
[--cluster-certificate-id <string>]
[--ocsp-issuer-certificate-id <string>]
[--ocsp-address <string>]
[--encryption-cipher-list <string>]
[--renegotiation-period <duration>]
[--service-history-max-age <duration>]
[--service-history-max-count <integer>]
[--use-workers-per-node <boolean>]
[{--verbose | -v}]
[{--help | -h}]

选项
如果未指定选项,则显示当前的默认复制报告设置。
--service {on | off | paused}
确定 SyncIQ 应用程序的状态。
--source-subnet < 子网 >
将复制作业限制为仅在本地群集的指定子网中的节点上运行。
--source-pool < 池 >
将复制作业限制为仅在本地群集的指定池中的节点上运行。
--restrict-target-network < 布尔值 >
将目标限制为目标分区名称中的节点。
--report-max-age < 持续时间 >
为复制策略指定要保留的报告的默认最长期限。
--report-max-count < 整数 >
为复制策略指定要保留的报告的最大数量。
--rpo-alerts < 布尔值 >
如果禁用,则不会生成 RPO 警报。
--bandwidth-reservation-reserve-percentage < 整数 >
指定为未指定带宽保留的策略保留的 SyncIQ 带宽百分比。
--bandwidth-reservation-reserve-absolute < 整数 >
指定为未指定带宽保留的策略保留的 SyncIQ 带宽量(以 kb/s 为单位)。此字段优先于
bandwidth_reservation_reserve_percentage。
--clear-bandwidth-reservation-reserve-absolute
指定清除绝对带宽保留。
--encryption-required < 布尔值 >

616 OneFS isi 命令 S 至 Z


如果为 true,则要求所有 SyncIQ 策略使用加密的通信。
--cluster-certificate-id < 字符串 >
指定要用于加密的群集证书的 ID。
--ocsp-issuer-certificate-id < 字符串 >
指定颁发要检查其吊销状态的证书的证书颁发机构的 ID。
--ocsp-address < 字符串 >
指定要连接到的 OCSP 响应方的地址。
--encryption-cipher-list < 字符串 >
指定与加密一起使用的密码列表。
注: 对于 SyncIQ 目标,此列表可用作支持的密码的列表。对于 SyncIQ 源,将尝试按顺序使用密码
列表。

--renegotiation-period < 持续时间 >


指定在强制重新协商之前保持加密连接的持续时间。
--service-history-max-age < 持续时间 >
指定要维护的服务信息的最长期限。
--service-history-max-count < 整数 >
指定要维护的历史服务信息记录的最大数量。
--use-workers-per-node < 布尔值 >
如果启用,SyncIQ 会将已弃用的 workers_per_node 字段与工作进程池功能配合使用,并相应地限制工
作进程。
{--verbose | -v}
显示更多详细信息。
{--help | -h}
显示此命令的帮助。

isi sync settings view


显示全局复制设置。

语法
isi sync settings view

选项
此命令没有选项。

isi sync target break


针对复制策略中断本地群集与目标群集之间的关联。
注:

中断源与目标之间的关联要求您重置复制策略才能再次运行策略。 完整复制或差异复制可能需要很长时间才能完成,具体
取决于要复制的数据量。

OneFS isi 命令 S 至 Z 617


语法
isi sync target break {<policy> | --target-path <path>}
[--force]
[--verbose]

选项
<policy>
删除针对此群集的指定复制策略的关联。
指定复制策略名称、复制策略 ID 或目标目录的路径。
--target-path< 路径 >
删除针对指定目录路径的复制策略的关联。
{--force | -f}
强制删除复制策略关联,即使关联的作业当前正在运行也是如此。
小心: 如果关联的复制作业当前正在运行,强制目标中断可能会导致错误。

{--verbose | -v}
显示更多详细信息。

isi sync target cancel


取消针对本地群集正在运行的复制作业。

语法
isi sync target cancel {<policy> | --target-path <path> | --all}
[--verbose]

选项
<policy>
取消根据指定的复制策略创建的复制作业。
指定复制策略名称或 ID。
--target-path< 路径 >
取消针对指定目录的复制作业。
--all
取消针对本地群集正在运行的所有复制作业。
--verbose
显示更多详细信息。

618 OneFS isi 命令 S 至 Z


isi sync target list
显示针对本地群集的复制策略列表。

语法
isi sync target list
[--target-path <path>]
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
如果未指定选项,则显示当前针对本地群集的所有复制策略的表。
--target-path< 路径 >
显示有关针对指定目录的复制策略的信息。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

名称 按复制策略的名称对输出进行排序。
source_host 按源群集的名称对输出进行排序。
target_path 按目标目录的路径对输出进行排序。
last_job_status 按根据策略创建的上一个复制作业的状态对输出进行排序。
failover_failback 按目标目录是否为只读对输出进行排序。
_state

{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

OneFS isi 命令 S 至 Z 619


isi sync target reports list
显示有关针对本地群集的已完成复制作业的信息。

语法
isi sync target reports list
[--state <state>]
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
如果未指定选项,则显示有关所有已完成复制作业的基本信息。
--state< 状态 >
仅显示有关处于指定状态的复制作业的信息。 以下状态有效:
● scheduled
● running
● paused
● finished
● failed
● canceled
● needs_attention
● unknown
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:
start_time
按复制作业的开始时间对输出进行排序。
end_time
按复制作业的结束时间对输出进行排序。
action
按复制作业执行的操作对输出进行排序。
state
按复制作业的进度对输出进行排序。
id
按复制子报告的 ID 对输出进行排序。
policy_id
按复制策略的 ID 对输出进行排序。
policy_name
按复制策略的名称对输出进行排序。
job_id
按复制作业的 ID 对输出进行排序。
total_files

620 OneFS isi 命令 S 至 Z


按复制作业修改过的文件总数对输出进行排序。
files_transferred
按传输到目标群集的文件总数对输出进行排序。
bytes_transferred
按传输到目标群集的文件总数对输出进行排序。
duration
按复制作业的运行时长对输出进行排序。
errors
按复制作业遇到的错误对输出进行排序。
warnings
按复制作业触发的警告对输出进行排序。
{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync target reports subreports list


显示有关针对本地群集的已完成复制作业的子报告。

语法
isi sync target reports subreports list <policy> <job-id>
[--limit]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
<policy>
显示有关指定策略的子报告。
<job-id>
显示有关指定 ID 的作业的子报告。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:
start_time

OneFS isi 命令 S 至 Z 621


按复制作业的开始时间对输出进行排序。
end_time
按复制作业的结束时间对输出进行排序。
action
按复制作业执行的操作对输出进行排序。
state
按复制作业的进度对输出进行排序。
id
按复制报告的 ID 对输出进行排序。
policy_id
按复制策略的 ID 对输出进行排序。
policy_name
按复制策略的名称对输出进行排序。
job_id
按复制作业的 ID 对输出进行排序。
total_files
按复制作业修改过的文件总数对输出进行排序。
files_transferred
按传输到目标群集的文件总数对输出进行排序。
bytes_transferred
按传输到目标群集的文件总数对输出进行排序。
duration
按复制作业的运行时长对输出进行排序。
errors
按复制作业遇到的错误对输出进行排序。
warnings
按复制作业触发的警告对输出进行排序。
{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

isi sync target reports subreports view


显示有关针对本地群集的已完成复制作业的子报告。

语法
isi sync target reports subreports view <policy> <job-id> <subreport-id>

622 OneFS isi 命令 S 至 Z


选项
<policy>
显示有关指定的复制策略的子报告。 指定复制策略名称。
<job-id>
显示有关指定的复制作业的子报告。 指定复制作业 ID。
<subreport-id>
显示具有指定 ID 的子报告。

isi sync target reports view


显示有关针对本地群集的已完成复制作业的信息。

语法
isi sync target reports view <policy> <job-id>

选项
<policy>
显示有关指定的复制策略的复制报告。
<job-id>
显示有关指定 ID 的作业的复制报告。

isi sync target view


显示有关针对本地群集的复制作业的信息。

语法
isi sync target view {<policy-name> | --target-path <path>}

选项
<policy-name>
显示有关指定策略的信息。
--target-path< 路径 >
显示有关针对指定目录的策略的信息。

OneFS isi 命令 S 至 Z 623


isi tape delete
从当前连接到群集中的备份加速器节点的 NDMP 磁带或介质转换器设备中断开群集的连接。

语法
isi tape delete
[--name < 字符串 >]
[--all]
[--force]
[--verbose]

选项
--name< 字符串 >
NDMP 磁带或介质转换器设备的名称。
--all
从所有设备断开群集的连接。
{--force | -f}
跳过确认提示。
{--verbose | -v}
显示更多详细信息。

示例
以下命令断开 tape001 与群集的连接:

isi tape delete tape001

isi tape list


显示当前连接至群集的 NDMP 设备的列表。

语法

isi tape list


[--node <lnn>]
[--tape]
[--activepath]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--node <LNN>
仅显示连接至指定逻辑节点编号 (LNN) 的节点的设备。
--tape

624 OneFS isi 命令 S 至 Z


仅显示磁带设备。
--activepath
仅显示设备的活动路径。
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示设备。
{--no-header | -a}
不会以表格或 CSV 格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

示例
要查看所有 NDMP 设备的列表,请运行以下命令:

isi tape list

isi tape modify


修改磁带或介质转换器设备的名称或状态。

语法
isi tape modify --name <name>
[--new-name <string>]
[--close-device]

选项
--name < 名称 >
当前设备名称。
--new-name < 字符串 >
新设备名称。
--close-device
设备当前打开时强制将设备状态设为 closed。如果 NDMP 会话意外停止,磁带或介质转换器设备可能仍
处于打开状态,这会阻止再次打开设备。

isi tape rename


重命名当前连接至群集中的备份加速器节点的 NDMP 设备。

语法

isi tape rename <devname> <rename>

OneFS isi 命令 S 至 Z 625


选项
<devname>
修改指定 NDMP 设备的名称。
<rename>
为给定 NDMP 设备指定新名称。

示例
以下示例会将 tape003 重命名为 tape005:

isi tape rename tape003 tape005

isi tape rescan


扫描光纤通道端口,查找连接至备份加速器节点的未检测到的 NDMP 备份设备。如果扫描发现新设备,群集将为这些新设备创
建条目。

语法

isi tape rescan


[--node <LNN>]
[--port < 整数 >]
[--reconcile]

选项
如果未指定选项,将扫描所有节点和端口。
--node<LNN>
仅扫描具有指定逻辑节点编号 (LNN) 的节点。
--port< 整数 >
仅扫描指定端口。如果指定 --node,将仅扫描指定节点上的指定端口。如果未指定 --node,将仅扫
描所有节点上的指定端口。
--reconcile
删除变为不可访问的设备或路径的条目。

示例
要扫描整个群集以查找 NDMP 设备,并删除变为不可访问的设备和路径的条目,请运行以下命令:

isi tape rescan --reconcile

626 OneFS isi 命令 S 至 Z


isi tape view
显示有关磁带或介质转换器设备的信息。

语法
isi tape view --name <name>
[--activepath]
[--format {list | json}]

选项
< 名称 >
磁带或介质转换器设备的名称。
--activepath
仅显示设备的活动路径。
--format {list | json}
以列表或 JSON 格式显示设备。

isi upgrade cluster add-nodes


将新节点添加到正在运行的升级进程。

语法
isi upgrade cluster add-nodes < 节点 >
[--yes]

选项
< 节点 >
要标记为升级的逗号分隔 (1,3,7) 或连字符分隔 (1-7) 指定逻辑节点编号 (LNN) 的列表。
--yes
在提示符处自动回答 yes。

isi upgrade cluster add-remaining-nodes


让系统包括现有升级内的任何剩余节点或新节点。

语法
isi upgrade cluster add-remaining-nodes
[--yes]

OneFS isi 命令 S 至 Z 627


选项
--yes
在提示符处自动回答 yes。

isi upgrade cluster archive


启动升级框架的归档。

语法
isi upgrade cluster archive
[--clear]

选项
--clear
归档完成后清除升级。

isi upgrade cluster assess


运行升级检查,而不启动升级。

语法
isi upgrade cluster assess < 安装映像路径 >

选项
< 安装映像路径 >
升级安装映像的路径。必须在 /ifs 或 http:// 源内。

isi upgrade cluster commit


将升级提交到新版本。运行此命令无法回滚。

语法
isi upgrade cluster commit
[--yes]

选项
--yes
在升级提交提示符处自动回答 yes。

628 OneFS isi 命令 S 至 Z


isi upgrade cluster drain
在升级期间耗尽 SMB 客户端。

语法
isi upgrade cluster drain <action>
[--timeout <<integer>>]

选项
<action>
指定在升级期间耗尽客户端时可以执行的操作。

delay 选择要在同一邻近区域中的非延迟节点之后升级的节点。
跳过 选择要升级的节点,而无需等待客户端耗尽。
timeout 管理用于升级耗尽行为的超时。

--timeout <integer>
命令超时秒数。

isi upgrade cluster firmware


这是用于固件升级的命令行界面。

语法
isi upgrade cluster firmware < 操作 >
[--timeout < 整数 >]

选项
< 操作 >
指定可以针对固件升级执行的操作。

package 列出群集上的所有节点并显示有关给定节点的详细固件程序包信息。
设备 列出群集上的所有节点并显示每个节点的当前固件的详细状态。
assess 运行升级检查,而不启动固件升级。
查看 显示当前固件升级活动的概述状态。
start 开始升级进程。

注: 所有升级进程都需要很长时间来运行。命令的返回状态仅与命令本身的发出相关,而与成功完成
无关。

--timeout< 整数 >
命令超时秒数。

OneFS isi 命令 S 至 Z 629


示例
以下命令运行升级检查,而不启动固件升级。

isi upgrade cluster firmware assess

isi upgrade cluster firmware start


开始固件升级进程。

语法
isi upgrade cluster firmware start
[--nodes-to-upgrade <integer_range_list>]
[--fw-pkg <path>]
[--include-device <string>]
[--exclude-device <string>]
[--include-type <string>]
[--exclude-type <string>]
[--no-burn]
[--no-verify]
[--no-reboot]
[--simultaneous | --rolling | --parallel]
[{--force | -f}]

选项
--nodes-to-upgrade < 整数范围列表 >
列出标记为升级的逗号分隔节点 LNN,“all”表示所有节点。
--fw-pkg <path>
自动用于启动固件升级的固件程序包的绝对路径。该文件路径必须可在 /ifs 目录中访问。如果未指定
路径,则框架会查找群集上保持的程序包。
--include-device <string>
列出要包含在固件升级中的逗号分隔设备。
--exclude-device <string>
列出要在固件升级中排除的逗号分隔设备。
--include-type <string>
列出要包含在固件升级中的逗号分隔设备类型。
--exclude-type <string>
列出要在固件升级中排除的逗号分隔设备类型。
--no-burn
不刻录固件。
--no-verify
升级后不会验证所有组件的固件升级。
--no-reboot
固件升级之后不重新启动节点。
--simultaneous
将固件同时应用于所有所选节点。
--rolling
通过一次滚动到一个节点,无中断地应用固件。
--parallel

630 OneFS isi 命令 S 至 Z


将固件无中断地同时并行应用于多个节点。
--force | -f
不提示您确认是否要开始固件升级进程。

isi upgrade cluster from-version


显示要从中升级的群集的版本。

语法
isi upgrade cluster from-version

示例
要查看有关要从中升级的群集版本的信息,请运行以下命令:

isi upgrade cluster from-version

系统将显示与以下示例类似的输出:

Upgrading Current OS Version: 7.2.1.1


Major: 7
Minor: 0
Maintenance: 0
Bugfix: 0

isi upgrade cluster nodes firmware


这是用于无中断升级固件升级框架的命令行界面。

语法
isi upgrade cluster nodes firmware < 操作 >
[--timeout < 整数 >]

选项
< 操作 >
指定可就节点固件更新采取的报告措施。

设备 报告已安装固件程序包中支持的节点上的设备。
package 报告已安装固件程序包的内容。
progress 以列表或视图格式报告有关固件升级的状态信息。

--timeout< 整数 >
命令超时秒数。

OneFS isi 命令 S 至 Z 631


示例
以下命令将显示已安装固件程序包的内容:

isi upgrade cluster nodes firmware package

isi upgrade cluster nodes list


列出群集上的所有节点并显示其升级活动的详细状态。

语法
isi upgrade cluster nodes list

示例
要列出群集上所有节点的升级状态,请运行以下命令:

isi upgrade cluster nodes list

系统将显示与以下示例类似的输出:

LNN State Error Last Action Result Progress Version


-------------------------------------------------------------------------------
1 committed - - - None 9.2.1.0_build(56)style(11)
2 committed - - - None 9.2.1.0_build(56)style(11)
3 committed - - - None 9.2.1.0_build(56)style(11)
-------------------------------------------------------------------------------
Total: 3

isi upgrade cluster nodes view


显示指定节点上的当前升级活动的详细状态。

语法
isi upgrade cluster nodes view <LNN>

选项
<LNN>
要查看升级状态的节点的逻辑节点编号 (LNN)。

示例
要查看 LNN 为 1 的节点的升级状态,请运行以下命令:

isi upgrade cluster nodes view 1

系统将显示与以下示例类似的输出:

632 OneFS isi 命令 S 至 Z


Node LNN: 1
Node Upgrade State: committed
Error Details: None
Last Upgrade Action: -
Last Action Result: -
Node Upgrade Progress: None
Node OS Version: 8.0.0.0

isi upgrade cluster pause


暂停升级过程。

语法
isi upgrade cluster pause <action>
[--force-f]

选项
{--force | -f}
不提示暂停升级的确认。

isi upgrade cluster resume


恢复暂停的升级过程。

语法
isi upgrade cluster resume <action>
[--force-f]

选项
{--force | -f}
不提示恢复升级的确认。

isi upgrade cluster retry-last-action


如果上一个操作失败,在节点上重试最后一个升级操作。

语法
isi upgrade cluster retry-last-action < 节点 >

选项
< 节点 >

OneFS isi 命令 S 至 Z 633


要选择的逗号分隔 (1,3,7) 或连字符分隔 (1-7) 逻辑节点编号的列表。您还可以使用 all 选择任何给定时
间的所有群集节点。

isi upgrade cluster rollback


停止升级群集并返回以前的版本。这会导致升级的中断回滚。

语法
isi upgrade cluster rollback
[--yes]

选项
--yes
在命令提示符处自动回答 yes。

isi upgrade cluster reboot


执行群集的滚动重新启动。

语法
isi upgrade cluster reboot
[--nodes <integer_range_list>]
[--drain-timeout <duration>]
[--alert-timeout <duration>]
[{--force | -f}]

选项
--nodes < 整数范围列表 >
要选择的逗号分隔 (1,3,7...) 或连字符分隔 (1-7) 逻辑节点号码 (LNN) 的列表。在重新启动过程中的任何
给定时间,您也可以输入 all 以选择所有群集节点。
--drain-timeout < 持续时间 >
确定在重新启动之前进程等待 SMB 客户端从节点断开连接的持续时间。值“0”表示无限期等待。
--alert-timeout < 持续时间 >
确定在此之后开始释放并引发警报的持续时间。
{--force | -f}
不提示确认重新启动。

634 OneFS isi 命令 S 至 Z


isi upgrade cluster settings
显示当前正在运行的升级的设置。

语法
isi upgrade cluster settings

选项
此命令没有选项。

isi upgrade cluster start


开始升级进程。

语法
isi upgrade cluster start <install-image-path>
[--skip-optional]
[--simultaneous | --rolling | --parallel]
[--nodes <integer_range_list>]
[--patch-paths <string>]
[--drain-timeout <duration>]
[--alert-timeout <duration>]
[--fw-pkg <path>]
[--include-device <string>]
[--exclude-device <string>]
[--include-type <string>]
[--exclude-type <string>]
[--no-burn]
[{--force | -f}]

选项
< 安装映像路径 >
升级安装映像的位置的文件路径。该文件路径必须可在 /ifs 目录中或按 https:// URL 访问。
--skip-optional
跳过可选预升级检查。
--simultaneous
启动同步升级。
--rolling
启动滚动升级.
--parallel
启动并行升级。
--nodes < 整数范围列表 >
列出要选择升级的逗号分隔 (1,3,7) 或连字符分隔 (1-7) 逻辑节点号码 (LNN)。
--patch-paths <string>
确定要在升级期间安装的一个或多个修补程序的逗号指定绝对路径。
--drain-timeout < 持续时间 >

OneFS isi 命令 S 至 Z 635


确定在重新启动之前进程等待 SMB 客户端从节点断开连接的持续时间。值“0”表示无限期等待。
--alert-timeout < 持续时间 >
确定释放开始之后引发警报的持续时间。
--fw-pkg <path>
用于启动合并 OneFS 和固件升级的固件程序包绝对路径。该文件路径必须可在 /ifs 目录中访问。
--include-device <string>
列出要包含在固件升级中的逗号分隔设备。
--exclude-device <string>
列出要在固件升级中排除的逗号分隔设备。
--include-type <string>
列出要包含在固件升级中的逗号分隔设备类型。
--exclude-type <string>
列出要在固件升级中排除的逗号分隔设备类型。
--no-burn
不刻录固件。
--force | -f
不提示您确认是否要开始升级进程。

isi upgrade cluster to-version


显示要升级到的群集的版本。

语法
isi upgrade cluster to-version

选项
此命令没有选项。

isi upgrade cluster unblock


如果发现保留问题,请让升级继续进行。

语法
isi upgrade cluster unblock <action>
[--force-f]

选项
{--force | -f}
不提示取消阻止升级的确认。

636 OneFS isi 命令 S 至 Z


isi upgrade cluster view
显示群集上的当前升级活动的状态。

语法
isi upgrade cluster view
[{--interactive | -i}]
[--by-domain]
[--show-stalls]

选项
{--interactive | -i}
显示升级状态的交互式自动刷新视图。
--by-domain
按故障域聚合节点。
--show-stalls
显示可能的升级停滞原因。

isi upgrade patches abort


通过尝试终止最近失败的操作来修复修补程序系统。

语法
isi upgrade patches abort
[--force]

选项
{--force | -f}
跳过此命令的确认提示。

isi upgrade patches install


安装系统修补程序。

语法
isi upgrade patches install <patch>
[--simultaneous | --rolling | --parallel]
[{--force | -f}]

选项
< 修补程序 >

OneFS isi 命令 S 至 Z 637


要安装的修补程序的文件路径位置。
--simultaneous
启动同步修补程序过程。
--rolling
启动滚动修补程序过程。
--parallel
启动并行修补程序过程。
{--force | -f}
不提示您确认是否要安装修补程序。

isi upgrade patches list


列出所有系统修补程序。

语法
isi upgrade patches list
[--local]
[--limit < 整数 >]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
--local
仅列出本地节点上的修补程序信息。
{--limit | -l} < 整数 >
要显示的升级修补程序数。
--format {table | json | csv | list}
以表格、JSON、CSV 或列表格式显示升级修补程序。
{--no-header | -a}
不会以 CSV 或表格格式显示标头。
{--no-footer | -z}
不显示表格摘要页脚信息。
{--verbose | -v}
显示更多详细信息。

isi upgrade patches uninstall


卸载系统修补程序。

语法
isi upgrade patches uninstall <patch>
[--simultaneous | --rolling | --parallel]
[{--force | -f}

638 OneFS isi 命令 S 至 Z


选项
< 修补程序 >
要卸载的修补程序的名称或 ID。
--simultaneous
启动同步修补程序过程。
--rolling
启动滚动修补程序过程。
--parallel
启动并行修补程序过程。
{--force | -f}
不提示您确认是否要卸载修补程序。

isi upgrade patches view


显示系统修补程序的详细信息。

语法
isi upgrade patches view < 修补程序 >
[--local]

选项
< 修补程序 >
要查看的修补程序的名称或 ID。
--local
仅显示本地节点的修补程序信息。

isi version
显示群集版本信息。

语法
isi version
[--format {list | json}]
[--verbose

选项
--format {list | json}
以列表或 JSON 格式显示群集版本信息。
{--verbose | -v}
显示更多详细群集版本信息。

OneFS isi 命令 S 至 Z 639


isi worm cdate set
将 SmartLock 法规遵从性时钟设置为系统时钟上的当前时间。
小心:

可以仅设置一次法规遵从性时钟。 设置法规遵从性时钟后,将无法修改法规遵从性时钟的时间。

语法
isi worm cdate set

选项
此命令没有选项。

isi worm cdate view


显示是否设置 SmartLock 法规遵从性时钟。 如果设置了法规遵从性时钟,将显示法规遵从性时钟上的当前时间。

语法
isi worm cdate view

选项
此命令没有选项。

isi worm create


将现有目录指定为 WORM 根目录。isi smartlock create 命令是此命令的别名。

语法
isi worm create <path>

选项
<path>
将指定目录指定为 SmartLock 目录。指定的目录必须为空。
指定目录路径。

640 OneFS isi 命令 S 至 Z


isi worm domains create
创建 SmartLock 目录。

语法
isi worm domains create <path>
[--compliance]
[--autocommit-offset <duration>]
[--override-date <timestamp>]
[{--privileged-delete {true | false}]
[--disable-privileged-delete]
[--default-retention {<duration> | forever | use_min
| use_max}]
[--min-retention {<duration> | forever}]
[--max-retention <duration>]
[--mkdir]
[--force]
[--verbose]

选项
<path>
在指定路径下创建 SmartLock 目录。
指定目录路径。
{--compliance | -C}
将 SmartLock 目录指定为 SmartLock 法规遵从性目录。此选项仅在以 SmartLock 法规遵从性模式运行
的群集上有效。
{--autocommit-offset | -a} < 持续时间 >
指定自动提交时间段。如果 SmartLock 目录中存在的文件在指定时间内未发生修改,则会将该文件自动
提交到 WORM 状态。
使用以下格式指定 < 持续时间 >:

<integer><units>

指定以下有效 < 单位 >:

Y 指定年数
M 指定月数

W 指定周数

D 指定天数

H 指定小时数

m 指定分钟数

s 指定秒数

要指定无自动提交时间段,请指定 none。默认值为 none。


{--override-date | -o} < 时间戳 >
为目录指定覆盖保留日期。无论此目录的最长保留期如何,也无论用户是否指定了从 WORM 状态释放文
件的更早日期,已提交到 WORM 状态的文件在超过指定日期之前都不会从 WORM 状态释放。

OneFS isi 命令 S 至 Z 641


采用以下格式指定 < 时间戳 >:

<YYYY>-<MM>-<DD>[T<hh>:<mm>[:<ss>]]

{--privileged-delete | -p} {true | false}


确定是否可以通过 isi worm files delete 命令删除目录中的文件。此选项仅对 SmartLock 企业目
录可用。
默认值为 false。
--disable-privileged-delete
永久阻止从 SmartLock 目录删除 WORM 提交文件。
注:

如果指定此选项,则任何时候都不能启用该目录的特权删除功能。如果随后在目录中将文件提交到
WORM 状态,则在超过保留期之前不能删除该文件。

{--default-retention | -d} {< 持续时间 > | forever | use_min | use_max}


指定默认保留期。如果用户未明确指定保留期到期日期,则在将文件提交到 WORM 状态时会向文件分配
默认保留期。
使用以下格式指定 < 持续时间 >:

<integer><units>

指定以下有效 < 单位 >:

Y 指定年数
M 指定月数

W 指定周数

D 指定天数

H 指定小时数

m 指定分钟数

s 指定秒数

要默认情况下永久保留 WORM 提交文件,请指定 forever。要将最短保留期指定为默认保留期,请指


定 use_min。要将最长保留期指定为默认保留期,请指定 use_max。
{--min-retention | -m} {< 持续时间 > | forever}
指定最短保留期。文件将至少在 WORM 状态下保留指定的时间段。
使用以下格式指定 < 持续时间 >:

<integer><units>

指定下列值之一作为 < 单位 >:

Y 指定年数
M 指定月数

W 指定周数

D 指定天数

H 指定小时数

m 指定分钟数

s 指定秒数

642 OneFS isi 命令 S 至 Z


要永久保留所有 WORM 提交文件,请指定 forever。
{--max-retention | -x} {< 持续时间 > | forever}
指定最长保留期。不能将文件保留在 WORM 状态超过指定的时间,即使用户指定的到期日期导致更长的
保留期也是如此。
使用以下格式指定 < 持续时间 >:

<integer><units>

指定下列值之一作为 < 单位 >:

Y 指定年数
M 指定月数

W 指定周数

D 指定天数

H 指定小时数

m 指定分钟数

s 指定秒数

要指定无最长保留期,请指定 forever。
{--mkdir | -M}
创建指定条目(如果尚不存在)。
{--force | -f}
不提示您确认创建 SmartLock 目录。
{--verbose | -v}
显示更多详细信息。

isi worm domains list


显示 WORM 目录列表。

语法
isi worm domains list
[--limit <integer>]
[--sort <attribute>]
[--descending]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--sort< 属性 >
按照指定的属性对显示的输出进行排序。
以下值有效:

OneFS isi 命令 S 至 Z 643


id 按 SmartLock 目录 ID 对输出进行排序。
path 按 SmartLock 目录的路径对输出进行排序。
type 根据 SmartLock 目录是否是法规遵从性目录对输出进行排序。
lin 按 SmartLock 目录的信息节点编号对输出进行排序。
autocommit_of 按 SmartLock 目录的自动提交时间段对输出进行排序。
fset
override_date 按 SmartLock 目录的覆盖保留日期对输出进行排序。
privileged_de 根据是否针对 SmartLock 目录启用了特权删除功能对输出进行排序。
lete
default_reten 按 SmartLock 目录的默认保留期对输出进行排序。
tion
min_retention 按 SmartLock 目录的最短保留期对输出进行排序。
max_retention 按 SmartLock 目录的最长保留期对输出进行排序。
total_modifie 按 SmartLock 目录的修改总次数对输出进行排序。
s

{--descending | -d}
以相反的顺序显示输出。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表输出。
{--no-footer | -z}
显示不带页脚的表输出。 页脚显示快照总数,例如快照使用的总存储空间。
{--verbose | -v}
显示更多详细信息。

isi worm domains modify


修改 SmartLock 目录的 SmartLock 设置。

语法
isi worm domains modify <domain>
[--compliance]
[{--autocommit-offset <duration> | --clear-autocommit-offset}]
[{--override-date <timestamp> | --clear-override-date}]
[{--privileged-delete {true | false}]
[--disable-privileged-delete]
[{--default-retention {<duration> | forever | use_min
| use_max} | --clear-default-retention}]
[{--min-retention {<duration> | forever} | --clear-min-retention}]
[{--max-retention | -x} (<duration> | forever) | --clear-max-retention]
[{--exclude | -x} <string>]
[--set-pending-delete]
[{--force | -f}]
[{--verbose | -v}]
[{--help | -h}]

选项
<domain>

644 OneFS isi 命令 S 至 Z


修改指定的 SmartLock 目录。
指定 SmartLock 目录的目录路径、ID 或 LIN。
{--compliance | -C}
将 SmartLock 目录指定为 SmartLock 法规遵从性目录。此选项仅在以 SmartLock 法规遵从性模式运行
的群集上有效。
{--autocommit-offset | -a} < 持续时间 >
指定自动提交时间段。如果 SmartLock 目录中存在的文件在指定时间内未发生修改,则会将该文件自动
提交到 WORM 状态。
使用以下格式指定 < 持续时间 >:

<integer><units>

指定以下有效 < 单位 >:

支持 指定年数
M 指定月数

W 指定周数

D 指定天数

H 指定小时数

m 指定分钟数

s 指定秒数

要指定无自动提交时间段,请指定 none。默认值为 none。


--clear-autocommit-offset
删除给定 SmartLock 目录的自动提交时间段。
{--override-date | -o} < 时间戳 >
为目录指定覆盖保留日期。无论此目录的最长保留期如何,也无论用户是否指定了从 WORM 状态释放文
件的更早日期,已提交到 WORM 状态的文件在超过指定日期之前都不会从 WORM 状态释放。
采用以下格式指定 < 时间戳 >:

<YYYY>-<MM>-<DD>[T<hh>:<mm>[:<ss>]]

--clear-override-date
删除给定 SmartLock 目录的覆盖保留日期。
{--privileged-delete | -p} {true | false}
确定是否可以通过 isi worm files delete 命令删除目录中的文件。此选项仅对 SmartLock 企业目
录可用。
默认值为 false。
--disable-privileged-delete
永久阻止从 SmartLock 目录删除 WORM 提交文件。
注:

如果指定此选项,则任何时候都不能启用 SmartLock 目录的特权删除功能。如果随后在目录中将文


件提交到 WORM 状态,则在超过保留期到期日期之前不能删除该文件。

{--default-retention | -d} {< 持续时间 > | forever | use_min | use_max}


指定默认保留期。如果用户未明确指定保留期到期日期,则在将文件提交到 WORM 状态时会向文件分配
默认保留期。
使用以下格式指定 < 持续时间 >:

<integer><units>

OneFS isi 命令 S 至 Z 645


指定以下有效 < 单位 >:

支持 指定年数
M 指定月数

W 指定周数

D 指定天数

H 指定小时数

m 指定分钟数

s 指定秒数

要默认情况下永久保留 WORM 提交文件,请指定 forever。要将最短保留期指定为默认保留期,请指


定 use_min。要将最长保留期指定为默认保留期,请指定 use_max。
--clear-default-retention
删除给定 SmartLock 目录的默认保留期。
{--min-retention | -m} {< 持续时间 > | forever}
指定最短保留期。文件将至少在 WORM 状态下保留指定的时间段。
使用以下格式指定 < 持续时间 >:

<integer><units>

指定下列值之一作为 < 单位 >:

支持 指定年数
M 指定月数

W 指定周数

D 指定天数

H 指定小时数

m 指定分钟数

s 指定秒数

要永久保留所有 WORM 提交文件,请指定 forever。


--clear-min-retention
删除给定 SmartLock 目录的最短保留期。
{--max-retention | -x} {< 持续时间 > | forever}
指定最长保留期。不能将文件保留在 WORM 状态超过指定的时间,即使用户指定的到期日期导致更长的
保留期也是如此。
使用以下格式指定 < 持续时间 >:

<integer><units>

指定下列值之一作为 < 单位 >:

支持 指定年数
M 指定月数

W 指定周数

D 指定天数

646 OneFS isi 命令 S 至 Z


H 指定小时数

m 指定分钟数

s 指定秒数

要指定无最长保留期,请指定 forever。
--clear-max-retention
删除给定 SmartLock 目录的最长保留期。
{--exclude | -x} < 字符串 >
从 WORM 域中排除的路径。为每个额外路径指定 --exclude。
--set-pending-delete
标记要删除的法规遵从性域。此操作是不可逆的。
{--force | -f}
不提示您确认创建 SmartLock 目录。
{--verbose | -v}
显示更多详细信息。

isi worm domains view


显示有关特定目录或文件的 WORM 信息。

语法
isi worm domains view <domain>

选项
<domain>
显示有关指定 SmartLock 目录的信息。
指定 SmartLock 目录的目录路径、ID 或 LIN。

isi worm files delete


删除提交到 WORM 状态的文件。 此命令仅可由 root 用户或法规遵从性管理员运行。

语法
isi worm files delete <path>
[--force]
[--verbose]

选项
<path>
删除指定文件。 文件必须位于已启用特权删除功能的 SmartLock 企业目录中。
指定为文件路径。

OneFS isi 命令 S 至 Z 647


--force
不会提示您确认是否要删除文件。
--verbose
显示更多详细信息。

isi worm files view


显示有关提交到 WORM 状态的文件的信息。

语法
isi worm files view <path>
[--no-symlinks]

选项
<path>
显示有关指定文件的信息。 文件必须提交到 WORM 状态。
指定为文件路径。
--no-symlinks
如果 <path> 引用了文件,且给定的文件是一个符号链接,则将显示有关该符号链接的 WORM 信息。
如果未指定此选项,且文件是一个符号链接,则将显示有关符号链接所引用的文件的 WORM 信息。

isi zone restrictions create


禁止用户或组访问 /ifs 目录。 受限用户或组进行的读取或写入尝试会返回 ACCESS DENIED 错误。

语法
isi zone restrictions create <zone> {<user> | --uid <integer>
| --group <string> | --gid <integer> | --sid <string>
| --wellknown <string>}
[--verbose]

选项
<zone>
按名称指定访问分区。
<user>
按名称指定用户。
--uid< 整数 >
按 UID 指定用户。
--group< 字符串 >
按名称指定组。
--gid< 整数 >
按 GID 指定组。
--sid< 字符串 >

648 OneFS isi 命令 S 至 Z


按用户或组 SID 指定对象。
--wellknown< 名称 >
指定已知用户、组、计算机或帐户名称。
{--verbose | -v}
在运行命令之后返回成功或失败消息。

isi zone restrictions delete


删除禁止用户或组访问 /ifs 目录的限制。

语法
isi zone restrictions delete <zone> {<user> | --uid <integer>
| --group <string> | --gid <integer> | --sid <string>
| --wellknown <string>}
[--force]
[--verbose]

选项
<zone>
按名称指定访问分区。
<user>
按名称指定用户。
--uid< 整数 >
按 UID 指定用户。
--group< 字符串 >
按名称指定组。
--gid< 整数 >
按 GID 指定组。
--sid< 字符串 >
按用户或组 SID 指定对象。
--wellknown< 字符串 >
按已知 SID 指定对象。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
在运行命令之后返回成功或失败消息。

isi zone restrictions list


显示被禁止访问 /ifs 目录的用户或组的列表。

语法
isi zone restrictions list <zone>
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]

OneFS isi 命令 S 至 Z 649


[--no-footer]
[--verbose]

选项
<zone>
按名称指定访问分区。
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
要显示内置系统分区的受限用户的列表,请运行以下命令:

isi zone restrictions list system

isi zone zones create


创建访问分区。

语法
isi zone zones create < 名称 > < 路径 >
[--map-untrusted < 工作组 >]
[--auth-providers < 提供程序类型 >:< 提供程序名称 >]
[--netbios-name < 字符串 >]
[--user-mapping-rules < 字符串 >]
[--home-directory-umask < 整数 >]
[--skeleton-directory < 字符串 >]
[--cache-entry-expiry < 持续时间 >]
[--create-path]
[--force-overlap]
[--groupnet <groupnet>]
[--verbose]

选项
< 名称 >
指定访问分区的名称。
< 路径 >
指定分区的基本目录路径。
--map-untrusted< 工作组 >
在身份认证过程中将不受信任的域映射到指定 NetBIOS 工作组。

650 OneFS isi 命令 S 至 Z


--auth-providers< 提供程序类型 >:< 提供程序名称 >
为向访问分区进行身份认证,指定一个或多个身份认证提供程序(以逗号分隔)。身份认证提供程序按
指定顺序进行检查。您必须按以下格式指定身份认证提供程序的名称:<提供程序类型>:<提供程序名称
>。
--netbios-name< 字符串 >
指定 NetBIOS 名称。
--user-mapping-rules< 字符串 >
为访问分区指定一个或多个用户映射规则(以逗号分隔)。
--home-directory-umask< 整数 >
指定要对自动创建的用户主目录设置的权限。
--skeleton-directory< 字符串 >
为用户主目录设置主干目录。
--cache-entry-expiry< 持续时间 >
指定缓存用户/组的持续时间。
--create-path
指定输入值表示要创建(尚不存在时)的访问分区路径。
--force-overlap
允许基本目录与其他访问分区的基本目录重叠。
--groupnet< 字符串 >
指定访问分区引用的 groupnet。
{--verbose | -v}
显示运行命令的结果。

isi zone zones delete


删除访问分区。 与该访问分区关联的所有身份认证提供程序对其他分区保持可用状态,但是 IP 地址不重新分配。 您无法删除内
置系统分区。

语法
isi zone zones delete <zone>
[--force]
[--verbose]

选项
<zone>
指定要删除的访问分区的名称。
{--force | -f}
禁止显示命令行提示符和消息。
{--verbose | -v}
显示运行命令的结果。

OneFS isi 命令 S 至 Z 651


isi zone zones list
显示群集中的访问分区的列表。

语法
isi zone zones list
[--limit <integer>]
[--format {table | json | csv | list}]
[--no-header]
[--no-footer]
[--verbose]

选项
{--limit | -l} < 整数 >
显示不超过指定的项目数。
--format {table | json | csv | list}
以表(默认)、JavaScript Object Notation (JSON)、逗号分隔值 (CSV) 或列表格式显示输出。
{--no-header | -a}
显示不带页眉的表和 CSV 输出。
{--no-footer | -z}
显示不带页脚的表输出。
{--verbose | -v}
显示更多详细信息。

示例
要查看群集中所有访问分区的列表,请运行以下命令:

isi zone zones list

isi zone zones modify


修改访问分区。

语法
isi zone zones modify < 分区 >
[--name < 字符串 >]
[--path < 路径 >]
[--map-untrusted < 字符串 >]
[--auth-providers < 提供程序类型 >:< 提供程序名称 >]
[--clear-auth-providers]
[--add-auth-providers < 提供程序类型 >:< 提供程序名称 >]
[--remove-auth-providers < 提供程序类型 >:< 提供程序名称 >]
[--netbios-name < 字符串 >]
[--user-mapping-rules < 字符串 >]
[--clear-user-mapping-rules]
[--add-user-mapping-rules < 字符串 >]
[--remove-user-mapping-rules < 字符串 >]
[--home-directory-umask < 整数 >]
[--skeleton-directory < 字符串 >]

652 OneFS isi 命令 S 至 Z


[--cache-entry-expiry < 持续时间 >]
[--revert-cache-entry-expiry]
[--create-path]
[--force-overlap]
[--verbose]

选项
< 分区 >
指定要修改的访问分区的名称。
--name< 字符串 >
指定访问分区的新名称。您无法更改内置系统访问分区的名称。
--path< 路径 >
指定分区的基本目录路径。
--map-untrusted< 字符串 >
指定要在身份认证过程中将不受信任的域映射到的 NetBIOS 工作组。
--auth-providers< 提供程序类型 >:< 提供程序名称 >
为向访问分区进行身份认证,指定一个或多个身份认证提供程序(以逗号分隔)。此选项覆盖身份认证
提供程序列表中的任何现有条目。要添加或删除提供程序而不影响当前条目,请为 --add-auth-
providers 或 --remove-auth-providers 配置设置。
--clear-auth-providers
从访问分区中删除所有身份认证提供程序。
--add-auth-providers< 提供程序类型 >:< 提供程序名称 >
向访问分区添加一个或多个身份认证提供程序(以逗号分隔)。
--remove-auth-providers< 提供程序类型 >:< 提供程序名称 >
从访问分区中删除一个或多个身份认证提供程序(以逗号分隔)。
--netbios-name< 字符串 >
指定 NetBIOS 名称。
--user-mapping-rules< 字符串 >
为访问分区指定一个或多个用户映射规则(以逗号分隔)。此选项覆盖用户映射规则列表中的所有条
目。要添加或删除映射规则而不覆盖当前条目,请使用 --add-user-mapping-rules 或 --
remove-user-mapping-rules 配置设置。
--clear-user-mapping-rules
从访问分区中删除所有用户映射规则。
--add-user-mapping-rules< 字符串 >
向访问分区添加一个或多个用户映射规则(以逗号分隔)。
--remove-user-mapping-rules< 字符串 >
从访问分区中删除一个或多个用户映射规则(以逗号分隔)。
--home-directory-umask< 整数 >
指定要对自动创建的用户主目录设置的权限。
--skeleton-directory< 字符串 >
为用户主目录设置主干目录。
--cache-entry-expiry< 持续时间 >
指定缓存用户/组的持续时间。
--cache-entry-expiry
将 --cache-entry-expiry 值设置为系统默认值。
--create-path
指定要创建的分区路径(如果尚不存在)。
--force-overlap
允许基本目录与其他访问分区的基本目录重叠。

OneFS isi 命令 S 至 Z 653


{--verbose | -v}
显示运行命令的结果。

isi zone zones view


显示访问分区的属性。

语法
isi zone zones view <zone>

选项
<zone>
指定要查看的访问分区的名称。

654 OneFS isi 命令 S 至 Z

You might also like