Go to main content

Oracle® ZFS Storage Appliance Administration Guide, Release OS8.7.x

Exit Print View

Updated: September 2017
 
 

Static Properties

Static (create time) properties are specified at filesystem or LUN creation time, but cannot be changed once the share has been created. These properties control the on-disk data structures, and include internationalization settings, case sensitivity, and volume block size.

In the BUI, static properties can be viewed on the left side of the interface when editing a filesystem or LUN.

Table 112  Filesystem and LUN Static Properties
BUI Name
CLI Name
Description
Creation date
creation
Indicates the date of creation.
Compression ratio
compressratio
Current compression ratio for the filesystem or LUN, which is a product of the compression algorithm. For more information, see Compression ratio.
Case sensitivity
casesensitivity
The case sensitivity property controls whether directory lookups are case-sensitive or case-insensitive. For more information, see Case sensitivity.
Reject non UTF-8
utf8only
This property enforces UTF-8 encoding for all files and directories. For more information, see Reject non UTF-8.
Normalization
normalization
The normalization property controls what unicode normalization, if any, is performed on filesystems and directories. Unicode supports the ability to have the same logical name represented by different encodings. For more information, see Normalization.
Volume block size (LUNs only)
volblocksize
The volume block size property sets the native block size for LUNs. For more information, see Volume block size.
Origin
origin
Shows the name of the snapshot from which it was cloned. For more information, see Origin.
Data migration source (Filesystems only)
shadow
Location of the source if the filesystem is actively shadowing an existing filesystem, either locally or over NFS. For more information, see Data Migration Source

Compression ratio

If compression is enabled, this property shows the compression ratio currently achieved for the share. This is expressed as a multiplier. For example, a compression of 2x means that the data is consuming half as much space as the uncompressed contents. For more information about selecting a compression algorithm, see "Data Compression" described in Inherited Properties.

Case sensitivity

The case sensitivity property controls whether directory lookups are case-sensitive or case-insensitive. It supports the following options:

BUI Value
CLI Value
Description
Mixed
mixed
Case sensitivity depends on the protocol being used. For NFS, FTP, and HTTP, lookups are case-sensitive. For SMB, lookups are case-insensitive. This is default, and prioritizes conformance of the various protocols over cross-protocol consistency. When using this mode, it's possible to create files that are distinct over case-sensitive protocols, but clash when accessed over SMB. In this situation, the SMB server will create a "mangled" version of the conflicts that uniquely identify the filename.
Insensitive
insensitive
All lookups are case-insensitive, even over protocols (such as NFS) that are traditionally case-sensitive. This can cause confusion for clients of these protocols, but prevents clients from creating name conflicts that would cause mangled names to be used over SMB. This setting should only be used where SMB is the primary protocol and alternative protocols are considered second-class, where conformance to expected standards is not an issue.
Sensitive
sensitive
All lookups are case-sensitive, even over SMB where lookups are traditionally case-insensitive. In general, this setting should not be used because the SMB server can deal with name conflicts via mangled names, and may cause Windows applications to behave strangely.

Reject non UTF-8

This property enforces UTF-8 encoding for all files and directories. When set, attempts to create a file or directory with an invalid UTF-8 encoding will fail. This only affects NFSv3, where the encoding is not defined by the standard. NFSv4.0 and NFSv4.1 always use UTF-8, and SMB negotiates the appropriate encoding. This setting should normally be "on", or else SMB (which must know the encoding in order to do case sensitive comparisons, among other things) will be unable to decode filenames that are created with and invalid UTF-8 encoding. This setting should only be set to "off" in pre-existing NFSv3 deployments where clients are configured to use different encodings. Enabling SMB, NFSv4.0 or NFSv4.1 when this property is set to "off" can yield undefined results if a NFSv3 client creates a file or directory that is not a valid UTF-8 encoding. This property must be set to "on" if the normalization property is set to anything other than "none".

Normalization

The normalization property controls what unicode normalization, if any, is performed on filesystems and directories. Unicode supports the ability to have the same logical name represented by different encodings. Without normalization, the on-disk name stored will be different, and lookups using one of the alternative forms will fail depending on how the file was created and how it is accessed. If this property is set to anything other than "none" (the default), the "Reject non UTF-8" property must also be set to "on".

BUI Value
CLI Value
Description
None
none
No normalization is done.
Form C
formC
Normalization Form Canonical Composition (NFC) - Characters are decomposed and then recomposed by canonical equivalence.
Form D
formD
Normalization Form Canonical Decomposition (NFD) - Characters are decomposed by canonical equivalence.
Form KC
formKC
Normalization Form Compatibility Composition (NFKC) - Characters are decomposed by compatibility equivalence, then recomposed by canonical equivalence.
Form KD
formKD
Normalization Form Compatibility Decomposition (NFKD) - Characters are decomposed by compatibility equivalence.

Volume block size

The volume block size property sets the native block size for LUNs. This can be any power of 2 from 512 bytes to 1M, and the default is 8K.


Note -  LUNs with a volume block size smaller than 4K may cause performance degradation.

Origin

If this is a clone, this is the name of the snapshot from which it was cloned.

Data Migration Source

If set, then this filesystem is actively shadowing an existing filesystem, either locally or over NFS. For more information about data migration, see Shadow Migration.