JavaScript is required to for searching.
Skip Navigation Links
Exit Print View
Oracle® ZFS Storage Appliance Administration Guide
Oracle Technology Network
Library
PDF
Print View
Feedback
search filter icon
search icon

Document Information

Using This Documentation

Chapter 1 Oracle ZFS Storage Appliance Overview

Chapter 2 Status

Chapter 3 Initial Configuration

Chapter 4 Network Configuration

Chapter 5 Storage Configuration

Chapter 6 Storage Area Network Configuration

Chapter 7 User Configuration

Chapter 8 Setting ZFSSA Preferences

Chapter 9 Alert Configuration

Chapter 10 Cluster Configuration

Chapter 11 ZFSSA Services

Chapter 12 Shares, Projects, and Schema

Understanding Shares

Storage Pools

Using Shares

Share Properties

Share Snapshots

Share Clones

Shares Space Management

Shares Space Terminology

Understanding Snapshots

File System and Project Settings

Data Quotas

Data Reservations

Space Management for Replicating LUNs

User and Group Settings

Viewing Current Usage

Viewing Current Usage in the BUI

Viewing Current Usage in the CLI

Setting User or Group Quotas

Set User or Group Quotas Using the BUI

Set User or Group Quotas Using the CLI

Identity Management

Filesystem Namespace

Namespace Nested Mountpoints

Namespace Protocol Access to Mountpoints

Namespace NFSv2 / NFSv3

Namespace NFSv4

Namespace SMB

Namespace FTP / FTPS / SFTP

Namespace HTTP / HTTPS

Shares > Shares

Working with Shares > Shares in the BUI

List of Shares

Editing a Share

Usage Statistics

Static Properties

Shares Project Panel

Creating a Share

Working with Shares > Shares in the CLI

Navigation

Share Operations

Shares > Shares CLI Properties

Shares > Shares > General - BUI Page

Space Usage

Volume Size

Thin Provisioned

Mountpoint

Read only

Update access time on read

Non-blocking mandatory locking

Data deduplication

Data compression

Checksum

Cache Device Usage

Synchronous Write Bias

Database Record Size

Additional Replication

Virus Scan

Prevent Destruction

Restrict Ownership Change

Custom Properties

Shares > Shares > Protocols - BUI Page

Shares Protocols

Share Protocols - NFS

Share Protocols - CLI

Security Modes

Character Set Encodings

Shares - SMB

Shares - iSCSI

Shares - HTTP

Shares - FTP

Shares - SFTP

Shares > Shares > Access

Access Control

Shares - Root Directory Access

Shares - User

Shares - Group

Shares - Permissions

Shares - ACL Behavior

ACL Behavior on Mode Change

ACL Inheritance Behavior

Root Directory ACL

Shares - Snapshots

Shares - Snapshot Properties

.zfs/snapshot visible

Scheduled Snapshot Label

Listing Snapshots Using the BUI

Manual Snapshots Using the BUI

Create a project level snapshot

Create a share/LUN level snapshot

Renaming a Snapshot (BUI)

Destroying a Snapshot (BUI)

Rolling back to a Snapshot (BUI)

Cloning a Snapshot (BUI)

Scheduled Snapshots Using the BUI

Manual Snapshots Using the CLI

Listing Snapshots (CLI)

Taking Manual Snapshots (CLI)

Renaming a Snapshot (CLI)

Destroying a Snapshot (CLI)

Rolling back to a Snapshot (CLI)

Cloning a Snapshot (CLI)

Listing Dependent Clones Using the CLI

Scheduled Snapshots Using the CLI

Setting the Scheduled Snapshot Label Using the CLI

Projects

Working with Projects Using the BUI

Project Fields

Editing a Project

Usage Statistics

Static Properties

Creating Projects

Working with Projects Using the CLI

Navigation

Project Operations

Selecting a Pool in a Cluster

Project Properties

Project - General

Project - General Properties

Project - Space Usage

Project - Quota

Project - Reservation

Project - Inherited Properties

Project - Custom Properties

Filesystem Creation Defaults

LUN Creation Defaults

Project Protocols

Project Access

Project Snapshots

Project Snapshot Properites

.zfs/snapshot visible

Scheduled Snapshot Label

Schemas

Customized Share Properties

Working with Schemas in the BUI

Configuring a Schema Using the BUI

Working with Schemas Using the CLI

Configuring a Schema Using the CLI

Chapter 13 Replication

Chapter 14 Shadow Migration

Chapter 15 CLI Scripting

Chapter 16 Maintenance Workflows

Chapter 17 Integration

Index

Working with Shares > Shares in the CLI

The shares CLI is under shares

Navigation

You must first select a project (including the default project) before selecting a share:

clownfish:> shares
clownfish:shares> select default
clownfish:shares default> select foo
clownfish:shares default/foo> get
Properties:
                    aclinherit = restricted (inherited)
                       aclmode = discard (inherited)
                         atime = true (inherited)
               casesensitivity = mixed
                      checksum = fletcher4 (inherited)
                   compression = off (inherited)
                 compressratio = 100
                        copies = 1 (inherited)
                      creation = Mon Oct 13 2009 05:21:33 GMT+0000 (UTC)
                    mountpoint = /export/foo (inherited)
                 normalization = none
                         quota = 0
                    quota_snap = true
                      readonly = false (inherited)
                    recordsize = 128K (inherited)
                   reservation = 0
              reservation_snap = true
                secondarycache = all (inherited)
                        nbmand = false (inherited)
                      sharesmb = off (inherited)
                      sharenfs = on (inherited)
                       snapdir = hidden (inherited)
                     snaplabel = project1:share1
                      utf8only = true
                         vscan = false (inherited)
                      sharedav = off (inherited)
                      shareftp = off (inherited)
                    space_data = 43.9K
              space_unused_res = 0
               space_snapshots = 0
               space_available = 12.0T
                   space_total = 43.9K
                    root_group = other
              root_permissions = 700
                     root_user = nobody

Share Operations

A share is created by selecting the project and issuing the filesystem or lun command. The properties can be modified as needed before committing the changes:

clownfish:shares default> filesystem foo
clownfish:shares default/foo (uncommitted)> get
                    aclinherit = restricted (inherited)
                       aclmode = discard (inherited)
                         atime = true (inherited)
                      checksum = fletcher4 (inherited)
                   compression = off (inherited)
                        copies = 1 (inherited)
                    mountpoint = /export/foo (inherited)
                         quota = 0 (inherited)
                      readonly = false (inherited)
                    recordsize = 128K (inherited)
                   reservation = 0 (inherited)
                secondarycache = all (inherited)
                        nbmand = false (inherited)
                      sharesmb = off (inherited)
                      sharenfs = on (inherited)
                       snapdir = hidden (inherited)
                     snaplabel = project1:share1
                         vscan = false (inherited)
                      sharedav = off (inherited)
                      shareftp = off (inherited)
                    root_group = other (default)
              root_permissions = 700 (default)
                     root_user = nobody (default)
               casesensitivity = (default)
                 normalization = (default)
                      utf8only = (default)
                    quota_snap = (default)
              reservation_snap = (default)
                    custom:int = (default)
                 custom:string = (default)
                  custom:email = (default)
clownfish:shares default/foo (uncommitted)> set sharenfs=off
                      sharenfs = off (uncommitted)
clownfish:shares default/foo (uncommitted)> commit
clownfish:shares default>

A share can be destroyed using the destroy command from the share context:

clownfish:shares default/foo> destroy 
This will destroy all data in "foo"! Are you sure? (Y/N) 
clownfish:shares default> 

A share can be renamed from the project context using the rename command:

clownfish:shares default> rename foo bar
clownfish:shares default>

A share can be moved between projects from the project context using the move command:

clownfish:shares default> move foo home 
clownfish:shares default> 

User and group usage and quotas can be managed through the users or groups commands after selecting the particular project or share. For more information on how to manage user and group quotas, see the Space Management section.

Shares > Shares CLI Properties

The following properties are available in the CLI, with their equivalent in the BUI. Properties can be set using the standard CLI commands get and set. In addition, properties can be inherited from the parent project by using the unset command.

Table 12-5  Shares > Shares CLI Properties
CLI Name
BUI Name
BUI Location
aclinherit
inherited
Access
aclmode
inherited
Access
atime
inherited
General
casesensitivity
create time
Static
checksum
inherited
General
compression
inherited
General
compresratio
read-only
Static
copies
inherited
General
creation
read-only
-
-
dedup
inherited
General
exported
inherited, replication packages only
General
fixednumber
LUN local
Protocols
initiatorgroup
LUN local
Protocols
logbias
inherited
General
lunumber
LUN local
Protocols
lunguid
read-only, LUN local
Protocols
mountpoint
inherited
General
nbmand
inherited
General
nodestroy
inherited
General
normalization
create time
Static
origin
read-only
Static
quota
space management
General
quota_snap
space management
General
readonly
inherited
General
recordsize
inherited
General
reservation
space management
General
reservation_snap
space management
General
root_group
filesystem local
Access
root_permissions
filesystem local
Access
root_user
filesystem local
Access
rstchown
inherited
General
secondary cache
inherited
General
shadow
create time
Static
sharedav
inherited
Protocols
shareftp
inherited
Protocols
sharenfs
inherited
Protocols
sharesmb
inherited
Protocols
snapdir
inherited
Snapshots
snaplabel
inherited
Snapshots
space_available
read-only
Usage
space_data
read-only
Usage
space_snapshots
read-only
Usage
space_total
read-only
Usage
space_unused_res
read-only
Usage
sparse
LUN local
General
targetgroup
LUN local
Protocols
utf8only
create time
Static
volblocksize
create time
Static
vscan
inherited
General