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 governing how the file system is mounted. The permitted attributes are:

    • mountLeafOwner, mountLeafGroup, mountLeafMode: Specify the ownership and permission attributes applied to the leaf directory in the file system mount path.

    • mountNoRootSUID: Controls whether non-root users are permitted to run root-owned binaries with the set user ID (setuid) permission.

      • true: Only the root user can run root-owned setuid binaries.

      • false: Non-root users can also run root-owned setuid binaries.

      If not specified, the default value is false.

    • mountReadOnly: Specifies whether the file system is mounted with read-only access.

      • true: Mounts the file system with read-only access.

      • false: Mounts the file system with read-write access.

      If not specified, the default value is false.

    You cannot set any other file system attributes during registration.

    Use the describe acfsfilesystems to see further details about all Exascale-managed ACFS file system attributes. See also Describing Resources and Attributes.

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 be associated with an existing cluster-wide EDV attachment and contain an existing ACFS file system, otherwise the command fails. Registration of 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.

Note the following when using the acfsctl deregister command:

  • The ACFS file system is dismounted and the mount point directory is removed on every node in the Oracle Grid Infrastructure (GI) cluster. The command also removes the ACFS file system registration in the GI cluster.