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.
Parent topic: Block Store Management