Table Of Content®
Oracle ZFS Storage Appliance
Administration Guide, Release 2013.1.3.0
Part No: E55851-01
December 2014
Copyright © 2009, 2014, Oracle and/or its affiliates. All rights reserved.
This software and related documentation are provided under a license agreement containing restrictions on use and disclosure and are protected by intellectual property laws. Except
as expressly permitted in your license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license, transmit, distribute, exhibit, perform,
publish, or display any part, in any form, or by any means. Reverse engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.
The information contained herein is subject to change without notice and is not warranted to be error-free. If you find any errors, please report them to us in writing.
If this is software or related documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S. Government, the following notice is applicable:
U.S. GOVERNMENT END USERS. Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered
to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or
documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
This software or hardware is developed for general use in a variety of information management applications. It is not developed or intended for use in any inherently dangerous
applications, including applications that may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you shall be responsible to take all
appropriate fail-safe, backup, redundancy, and other measures to ensure its safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.
Oracle and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners.
Intel and Intel Xeon are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are used under license and are trademarks or registered trademarks of
SPARC International, Inc. AMD, Opteron, the AMD logo, and the AMD Opteron logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.
This software or hardware and documentation may provide access to or information on content, products, and services from third parties. Oracle Corporation and its affiliates are
not responsible for and expressly disclaim all warranties of any kind with respect to third-party content, products, and services. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content, products, or services.
Copyright © 2009, 2014, Oracle et/ou ses affiliés. Tous droits réservés.
Ce logiciel et la documentation qui l’accompagne sont protégés par les lois sur la propriété intellectuelle. Ils sont concédés sous licence et soumis à des restrictions d’utilisation et
de divulgation. Sauf disposition de votre contrat de licence ou de la loi, vous ne pouvez pas copier, reproduire, traduire, diffuser, modifier, breveter, transmettre, distribuer, exposer,
exécuter, publier ou afficher le logiciel, même partiellement, sous quelque forme et par quelque procédé que ce soit. Par ailleurs, il est interdit de procéder à toute ingénierie inverse
du logiciel, de le désassembler ou de le décompiler, excepté à des fins d’interopérabilité avec des logiciels tiers ou tel que prescrit par la loi.
Les informations fournies dans ce document sont susceptibles de modification sans préavis. Par ailleurs, Oracle Corporation ne garantit pas qu’elles soient exemptes d’erreurs et vous
invite, le cas échéant, à lui en faire part par écrit.
Si ce logiciel, ou la documentation qui l’accompagne, est concédé sous licence au Gouvernement des Etats-Unis, ou à toute entité qui délivre la licence de ce logiciel ou l’utilise pour
le compte du Gouvernement des Etats-Unis, la notice suivante s’applique:
U.S. GOVERNMENT END USERS. Oracle programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, delivered
to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental regulations. As
such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or
documentation, shall be subject to license terms and license restrictions applicable to the programs. No other rights are granted to the U.S. Government.
Ce logiciel ou matériel a été développé pour un usage général dans le cadre d’applications de gestion des informations. Ce logiciel ou matériel n’est pas conçu ni n’est destiné
à être utilisé dans des applications à risque, notamment dans des applications pouvant causer des dommages corporels. Si vous utilisez ce logiciel ou matériel dans le cadre
d’applications dangereuses, il est de votre responsabilité de prendre toutes les mesures de secours, de sauvegarde, de redondance et autres mesures nécessaires à son utilisation dans
des conditions optimales de sécurité. Oracle Corporation et ses affiliés déclinent toute responsabilité quant aux dommages causés par l’utilisation de ce logiciel ou matériel pour ce
type d’applications.
Oracle et Java sont des marques déposées d’Oracle Corporation et/ou de ses affiliés. Tout autre nom mentionné peut correspondre à des marques appartenant à d’autres propriétaires
qu’Oracle.
Intel et Intel Xeon sont des marques ou des marques déposées d’Intel Corporation. Toutes les marques SPARC sont utilisées sous licence et sont des marques ou des marques
déposées de SPARC International, Inc. AMD, Opteron, le logo AMD et le logo AMD Opteron sont des marques ou des marques déposées d’Advanced Micro Devices. UNIX est une
marque déposée d’The Open Group.
Ce logiciel ou matériel et la documentation qui l’accompagne peuvent fournir des informations ou des liens donnant accès à des contenus, des produits et des services émanant
de tiers. Oracle Corporation et ses affiliés déclinent toute responsabilité ou garantie expresse quant aux contenus, produits ou services émanant de tiers. En aucun cas, Oracle
Corporation et ses affiliés ne sauraient être tenus pour responsables des pertes subies, des coûts occasionnés ou des dommages causés par l’accès à des contenus, produits ou services
tiers, ou à leur utilisation.
Contents
About the Oracle ZFS Storage Appliance .......................................................... 17
Oracle ZFS Storage Appliance Key Features ...................................................... 17
Supported Protocols ....................................................................................... 18
Oracle ZFS Storage Appliance Data Services ...................................................... 18
Data Availability ............................................................................................ 19
Oracle ZFS Storage Appliance Configuration ...................................................... 20
Browser User Interface (BUI) .......................................................................... 20
Network Icons ............................................................................................... 28
Dashboard Icons ............................................................................................ 28
Analytics Toolbar Icons .................................................................................. 29
Identity Mapping Icons ................................................................................... 30
Supported Browsers ....................................................................................... 31
Command Line Interface (CLI) ........................................................................ 32
CLI Contexts ......................................................................................... 33
CLI Properties ....................................................................................... 38
Working with CLI Scripting ............................................................................. 40
Using Batch Commands .......................................................................... 41
Understanding the CLI Scripting Commands .............................................. 41
▼ Accessing the CLI Script Environment ................................................. 42
Understanding the Built-in CLI Functions .................................................. 42
▼ Using the Run Function ..................................................................... 43
▼ Using the Get Function ...................................................................... 43
▼ Using the List Function ..................................................................... 44
▼ Using the Children Function ............................................................... 45
▼ Using the Choices Function ................................................................ 46
Using the Functions for Generating Output ................................................. 47
Understanding CLI Scripting Errors .......................................................... 47
Configuring the Oracle ZFS Storage Appliance ................................................. 49
Initial Appliance Configuration ........................................................................ 49
▼ Initial Configuration Using the BUI ..................................................... 50
3
Contents
Initial Configuration Using the CLI ........................................................... 51
Network Configuration ................................................................................... 56
Working with the Network Configuration BUI Page ..................................... 57
Configuring Network Devices .................................................................. 58
Configuring Network Datalinks ................................................................ 58
Configuring Network Interfaces ................................................................ 60
Configuring Network IP MultiPathing (IPMP) ............................................ 61
Configuring Network Performance and Availability ...................................... 63
Configuring Network Routing .................................................................. 63
Network Configuration Using the BUI ....................................................... 66
Network Configuration Using the CLI ....................................................... 74
Storage Configuration ..................................................................................... 77
Choose a Storage Profile ......................................................................... 79
Data Profile Configuration ....................................................................... 81
Importing Existing Storage Pools .............................................................. 83
Adding Storage ...................................................................................... 83
Unconfiguring Storage ............................................................................ 83
Renaming a Storage Pool ........................................................................ 84
Storage Pool Scrub ................................................................................. 84
▼ Configuring a Storage Pool using the BUI ............................................. 84
▼ Adding Cache Devices to an Existing Pool using the BUI ......................... 85
▼ Adding Cache Devices to an Existing Pool using the CLI ......................... 85
Understanding the Appliance Status .................................................................. 86
Dashboard Status ................................................................................... 87
Summary of Memory Use ....................................................................... 88
Dashboard Services ................................................................................ 89
Dashboard Hardware .............................................................................. 90
Disk Activity Dashboard ......................................................................... 91
Recent Alerts ........................................................................................ 93
Dashboard CLI ...................................................................................... 93
▼ Running the Dashboard Continuously ................................................... 94
Status Dashboard Settings ....................................................................... 95
▼ Changing the Displayed Activity Statistics ............................................ 97
▼ Changing the Activity Thresholds ........................................................ 97
NDMP Status ........................................................................................ 97
NDMP States ........................................................................................ 99
Configuring Storage Area Network ................................................................... 99
SAN Terminology ................................................................................ 102
Configuring SAN Fibre Channel ............................................................. 104
Configuring FC Port Modes using the BUI ............................................... 106
4 Oracle ZFS Storage Appliance Administration Guide, Release 2013.1.3.0 • December 2014
Contents
Discovering FC Ports using the BUI ........................................................ 107
Creating FC Initiator Groups using the BUI .............................................. 108
Associating a LUN with an FC Initiator Group using the BUI ....................... 109
▼ Changing FC Port Modes using the CLI .............................................. 110
▼ Discovering FC Ports using the CLI ................................................... 110
▼ Creating FC Initiator Groups using the CLI ......................................... 111
▼ Associating a LUN with an FC Initiator Group using the CLI .................. 112
▼ Scripting Aliases for Initiators and Initiator Groups using the CLI ............ 112
Configuring SAN iSCSI ........................................................................ 114
Configuring SAN iSCSI Initiators ........................................................... 115
▼ Creating an Analytics Worksheet using the BUI .................................... 116
▼ Configuring SAN iSER Targets ......................................................... 116
▼ Adding an iSCSI Target with an Auto-generated IQN using the CLI .......... 119
▼ Adding an iSCSI Target with a Specific IQN and RADIUS Authentication
using the CLI ...................................................................................... 120
▼ Adding an iSCSI Initiator with CHAP Authentication using the CLI ......... 120
▼ Adding an iSCSI Target Group using the CLI ....................................... 121
▼ Adding an iSCSI Initiator Group using the CLI .................................... 121
Configuring SAN SRP .......................................................................... 121
▼ Configuring SRP Target using the BUI ............................................... 122
▼ Configuring SRP Targets Using the CLI .............................................. 123
Configuring Users ........................................................................................ 124
User Authorizations .............................................................................. 125
Managing User Properties ...................................................................... 126
▼ Adding an Administrator using the BUI .............................................. 127
▼ Adding a Role using the BUI ............................................................ 128
▼ Adding Authorizations to a Role using the BUI .................................... 128
▼ Deleting Authorizations from a Role using the BUI ............................... 128
▼ Adding a User Who can Only View the Dashboard using the BUI ............. 128
▼ Adding a Role using the CLI ............................................................ 129
▼ Adding an Administrator using the CLI ............................................... 129
▼ Adding Authorizations to a Role using the CLI ..................................... 130
▼ Deleting Authorizations from a Role using the CLI ............................... 132
Setting Oracle ZFS Storage Appliance Preferences ............................................. 132
Preference Properties ............................................................................ 132
▼ Setting Preferences using the CLI ...................................................... 133
▼ Setting SSH Public Keys using the CLI .............................................. 134
Configuring Alerts ........................................................................................ 134
Alert Categories ................................................................................... 135
Threshold Alerts .................................................................................. 135
5
Contents
▼ Adding a Threshold Alert using the BUI ............................................. 136
▼ Adding an Alert Action using the BUI ................................................ 137
▼ Adding a Threshold Alert using the CLI .............................................. 137
▼ Adding an Alert Action using the CLI ................................................ 138
Sending Email Alerts ............................................................................ 139
Sending an SNMP Trap ......................................................................... 139
Sending Syslog Messages ...................................................................... 140
Resuming/Suspending Datasets ............................................................... 140
Resuming/Suspending Worksheets ........................................................... 140
Executing a Workflow ........................................................................... 140
Configuring Clustering .................................................................................. 141
Understanding Clustering ....................................................................... 141
▼ Configuring Clustering using the BUI ................................................. 162
▼ Unconfiguring Clustering using the BUI .............................................. 164
▼ Shutting Down a Clustered Configuration using the CLI ......................... 165
▼ Shutdown the Stand-by Head using the CLI ......................................... 166
▼ Unconfiguring Clustering using the CLI .............................................. 166
Cabling ZS3-2 Clusters ......................................................................... 168
Cabling ZS4-4, ZS3-4, and 7x20 Clusters ................................................. 169
Cabling Storage Shelves for Clustering .................................................... 169
Working with Services ..................................................................................... 173
Working with Oracle ZFS Storage Appliance Services ........................................ 174
Data Services ...................................................................................... 175
Required Service Ports .......................................................................... 177
Services BUI Page Icons and Buttons ...................................................... 177
Configuring Services using the CLI ......................................................... 178
▼ Viewing a Specific Service Screen using the BUI .................................. 179
▼ Viewing a Specific Service Screen ..................................................... 180
▼ Enabling a Service using the BUI ...................................................... 180
▼ Disabling a Service using the BUI ..................................................... 180
▼ Defining Properties using the BUI ...................................................... 180
▼ Viewing Service Logs using the BUI .................................................. 180
▼ Selecting a Service using the CLI ...................................................... 181
▼ Viewing a Service's State using the CLI .............................................. 181
▼ Enabling a Service using the CLI ....................................................... 181
▼ Disabling a Service using the CLI ...................................................... 182
▼ Setting Properties using the CLI ........................................................ 182
▼ Viewing Service Help using the CLI ................................................... 182
6 Oracle ZFS Storage Appliance Administration Guide, Release 2013.1.3.0 • December 2014
Contents
Working with NFS ....................................................................................... 183
NFS Properties .................................................................................... 183
Configuring Kerberos Realms for NFS ..................................................... 185
NFS Logs ........................................................................................... 186
NFS Analytics ..................................................................................... 186
NFS Properties .................................................................................... 187
▼ Sharing a Filesystem over NFS .......................................................... 187
Working with iSCSI ..................................................................................... 187
Working with SMB ...................................................................................... 189
SMB Properties .................................................................................... 190
SMB Share Properties ........................................................................... 191
NFS/SMB Interoperability ..................................................................... 192
SMB DFS Namespaces ......................................................................... 192
SMB Microsoft Stand-alone DFS Namespace Management Tools Support
Matrix ................................................................................................ 193
▼ Adding DFS Namespaces to a Local SMB Group .................................. 194
SMB Autohome ................................................................................... 195
▼ Adding SMB Autohome Rules .......................................................... 195
SMB Local Groups ............................................................................... 196
▼ Adding a User to an SMB Local Group .............................................. 197
SMB MMC Integration ......................................................................... 197
SMB Share Management ....................................................................... 198
SMB Users, Groups, and Connections ...................................................... 199
Listing SMB Services ........................................................................... 200
▼ Configuring SMB using the BUI ........................................................ 202
▼ Configuring SMB Active Directory using the BUI ................................ 203
▼ Configuring SMB Project and Share using the BUI ............................... 204
▼ Configuring SMB Data Service using the BUI ...................................... 204
Working with FTP ........................................................................................ 205
FTP Properties ..................................................................................... 205
FTP Logs ............................................................................................ 206
Working with HTTP ..................................................................................... 206
HTTP Properties .................................................................................. 207
HTTP Authentication and Access Control ................................................. 207
HTTP Logs ......................................................................................... 208
▼ Allowing HTTP Access to a Share using the BUI ................................. 208
Working with NDMP .................................................................................... 208
NDMP Local vs. Remote Configurations .................................................. 209
NDMP Backup Formats and Types .......................................................... 209
NDMP Back up with "dump" and "tar" .................................................... 210
7
Contents
NDMP Back up with "zfs" ..................................................................... 211
NDMP Incremental backups ................................................................... 212
NDMP Properties ................................................................................. 214
NDMP Logs ........................................................................................ 215
Working with Remote Replication ................................................................... 215
Working with Shadow Migration .................................................................... 216
Working with SFTP ...................................................................................... 216
SFTP Properties ................................................................................... 216
SFTP Port ........................................................................................... 217
SFTP Logs .......................................................................................... 217
▼ Allowing SFTP Access to a Share using the BUI .................................. 217
▼ Configuring SFTP for Remote Access using the CLI ............................. 217
Working with SRP ........................................................................................ 219
Working with TFTP ...................................................................................... 219
▼ Allowing TFTP Access to a Share using the BUI .................................. 219
Working with Virus Scan ............................................................................... 220
Virus Scan Properties ............................................................................ 220
Virus Scan File Extensions .................................................................... 220
Scanning Engines ................................................................................. 221
Virus Scan Logs ................................................................................... 222
▼ Configuring Virus Scanning for a Share using the BUI ........................... 222
Working with NIS ........................................................................................ 222
NIS Properties ..................................................................................... 223
NIS Logs ............................................................................................ 223
▼ Adding an Appliance Administrator from NIS using the BUI ................... 223
Working with LDAP ..................................................................................... 224
LDAP Properties .................................................................................. 225
LDAP Custom Mappings ....................................................................... 226
LDAP Logs ......................................................................................... 227
▼ Adding an Appliance Administrator using the BUI ................................ 227
Working with Active Directory ....................................................................... 228
Active Directory Join Domain ................................................................ 228
Active Directory Join Workgroup ............................................................ 229
Active Directory Domains and Workgroups .............................................. 229
Active Directory LDAP Signing ............................................................. 230
Active Directory Windows Server Support ................................................ 230
▼ Joining an AD Domain using the BUI ................................................ 231
▼ Joining an AD Workgroup using the BUI ............................................ 231
▼ Configuring Active Directory using the CLI ......................................... 231
Working with Identity Mapping ...................................................................... 233
8 Oracle ZFS Storage Appliance Administration Guide, Release 2013.1.3.0 • December 2014
Contents
Identity Mapping Rules ......................................................................... 234
Mapping Rule Directional Symbols ......................................................... 234
Identity Mapping Best Practices .............................................................. 235
Identity Mapping Concepts .................................................................... 235
▼ Configuring Identity Mapping using the BUI ........................................ 237
▼ Viewing Mappings using the BUI ...................................................... 238
▼ Flushing Mappings using the BUI ...................................................... 238
Working with DNS ....................................................................................... 239
DNS Properties .................................................................................... 239
Configuring DNS ................................................................................. 240
DNS Logs ........................................................................................... 240
Active Directory and DNS ..................................................................... 240
Non-DNS Resolution ............................................................................ 240
DNS-Less Operation ............................................................................. 241
Working with Dynamic Routing ...................................................................... 241
Working with IPMP ...................................................................................... 241
Working with NTP ....................................................................................... 242
NTP Properties .................................................................................... 243
▼ Setting Clock Synchronization using the BUI ....................................... 244
▼ Configuring NTP using the CLI ......................................................... 244
Working with Phone Home ............................................................................ 245
Phone Home Properties ......................................................................... 246
▼ Registering the Appliance using the BUI ............................................. 247
▼ Registering the Appliance using the CLI ............................................. 247
▼ Changing Account Information using the BUI ...................................... 248
Working with the RESTful API ...................................................................... 248
Working with Service Tags ............................................................................ 248
Working with SMTP ..................................................................................... 249
Working with SNMP .................................................................................... 250
SNMP Properties .................................................................................. 250
SNMP MIBs ....................................................................................... 251
Sun FM MIB ....................................................................................... 251
Sun AK MIB ....................................................................................... 252
▼ Configuring SNMP to Serve Appliance Status using the BUI ................... 252
▼ Configuring SNMP to Send Traps using the BUI .................................. 252
Working with Syslog .................................................................................... 253
Syslog Properties .................................................................................. 254
Classic Syslog: RFC 3164 ..................................................................... 254
Updated Syslog: RFC 5424 .................................................................... 254
SYSLOG Message Format ..................................................................... 255
9
Contents
SYSLOG Alert Message Format ............................................................. 255
Example Configuring a Solaris Receiver using the CLI ............................... 257
Example Configuring a Linux Receiver using the CLI ................................. 257
Working with System Identity ........................................................................ 258
Working with SSH ....................................................................................... 259
SSH Properties .................................................................................... 259
SSH Logs ........................................................................................... 259
▼ Disabling root SSH Access using the CLI ............................................ 260
Maintaining the Oracle ZFS Storage Appliance ............................................... 261
Working with Maintenance Workflows ............................................................. 261
Understanding Workflows ...................................................................... 262
Understanding Workflow Parameters ....................................................... 263
Constrained Workflow Parameters ........................................................... 264
Optional Workflow Parameters ............................................................... 265
Workflow Error Handling ...................................................................... 266
Workflow Input Validation ..................................................................... 267
Workflow Execution Auditing and Reporting ............................................ 268
Understanding Workflow Versioning ........................................................ 270
Using Workflows for Alert Actions ......................................................... 271
Using Scheduled Workflows .................................................................. 273
Using a Scheduled Workflow ................................................................. 273
Coding Workflow Schedules .................................................................. 274
Creating a Worksheet Based on a Specified Drive Type ............................... 276
Uploading Workflows using the BUI ....................................................... 278
▼ Downloading Workflows using the CLI ............................................... 279
▼ Listing Workflows using the CLI ....................................................... 279
▼ Executing Workflows using the CLI ................................................... 280
Working with Shares ........................................................................................ 283
Working with Storage Pools ........................................................................... 284
Share Properties ........................................................................................... 285
Working with Snapshots ................................................................................ 286
Working with Clones .................................................................................... 286
Space Management for Shares ........................................................................ 287
Shares Terminology .............................................................................. 287
Understanding Snapshots ....................................................................... 288
File System and Project Settings ............................................................. 289
▼ Viewing Current Shares Usage in the BUI ........................................... 290
10 Oracle ZFS Storage Appliance Administration Guide, Release 2013.1.3.0 • December 2014
Description:Adding an iSCSI Target with an Auto-generated IQN using the CLI . 119 Adding an iSCSI Initiator with CHAP Authentication using the CLI
