6.2.12.1 acfsctl

Control registration for Exascale-managed ACFS file systems.

Purpose

The acfsctl command controls registration for Exascale-managed implementations of Oracle Advanced Cluster File System (ACFS).

Syntax

acfsctl register volume-id mount-path [ --attributes attribute=value[,attribute=value] ... ]

acfsctl deregister acfs-id [ --force ]

Command Options

The options for the acfsctl register command are:

• volume-id: Identifies the volume that hosts the file system. You can use the lsacfsfilesystem command to find the volume identifier associated with each Exascale-managed ACFS file system.

• mount-path: Specifies the file system mount path.

• --attributes: Optionally specifies attributes for the file system registration.

The options for the acfsctl deregister command are:

• acfs-id: Identifies the ACFS file system being deregistered. You can use the lsacfsfilesystem command to find the identifier for each Exascale-managed ACFS file system.

• --force: Optionally ignores any errors and forces deregistration of the file system, even if it is use.

Usage Notes

Note the following information when using the acfsctl register command:

• The specified volume (volume-id) must have an associated EDV attachment and existing ACFS file system, otherwise the command fails.

• If the EDV attachment is a cluster-wide attachment, the ACFS file system is mounted on every node in the Oracle Grid Infrastructure (GI) cluster. If the EDV attachment is a node-specific attachment, the file system is mounted only on that node. In all cases, the ACFS details are registered with the GI cluster, and the file system is automatically mounted (or remounted) by Oracle Clusterware as required.

Note the following when using the acfsctl deregister command:

• If the underlying EDV attachment is a cluster-wide attachment, the ACFS file system is dismounted and the mount point directory is removed on every node in the Oracle Grid Infrastructure (GI) cluster. If the EDV attachment is a node-specific attachment, the file system is dismounted and the mount point directory is removed on that node. The command also removes the ACFS file system registration in the GI cluster.