mkacfsfilesystem

Purpose

The mkacfsfilesystem command creates an Exascale-managed implementation of Oracle Advanced Cluster File System (ACFS) on an Exascale volume using Exascale Direct Volumes (EDV).

Syntax

mkacfsfilesystem volume-ID mount-path [ --force ] 
                 [ --attributes attribute=value[,attribute=value]... ]

Command Options

The options for the mkacfsfilesystem command are:

volume-ID: Identifies the volume that hosts the file system. You can use the lsvolume command to find the identifier for each volume.
mount-path: Specifies the file system mount path.
--force: Optionally instructs the command to ignore and overwrite any existing file system on the volume.
--attributes: Optionally specifies attributes for the file system.

Use the describe mkacfsfilesystem command to see details about the ACFS file system attributes you can set. See also Describing Resources and Attributes.

Usage Notes

Note the following information when using this command:

The specified volume (volume-ID) must be associated with a cluster-wide EDV attachment, otherwise the command fails. Using a volume with a node-specific EDV attachment is not permitted.
The ACFS file system is mounted on every node in the Oracle Grid Infrastructure (GI) cluster and the ACFS details are registered with the GI cluster. After registration, the file system is automatically mounted (or remounted) by Oracle Clusterware as required.
Before using the mkacfsfilesystem command, ensure that ACFS is configured appropriately on the target system.

For instance, you can create a file system using ACFS encryption by specifying the encryptionEnabled, encryptionAlgorithm, and encryptionKeyLength attributes in the mkacfsfilesystem command. For example:
```
@> mkacfsfilesystem vol0001_bbd6fb4c75e2411b9bf366fe702eabaf /mnt/acfs1 
    --attributes encryptionEnabled=true,encryptionAlgorithm=AES,encryptionKeyLength=192
```
However, the command fails if ACFS encryption is not initialized on the target system. To initialize ACFS encryption, the system administrator must run the following command before the file system is created:
```
# acfsutil encr init
```

6.2.12.15 mkacfsfilesystem