Oracle ACFS Command-Line Tools for Oracle ACFS in the Cluster Domain
This topic provides a summary of commands to manage Oracle ACFS in the cluster domain.
Table 16-104 lists commands for managing Oracle ACFS in the cluster domain and provides brief descriptions. For information about Oracle ACFS in the cluster domain and Oracle ACFS remote service, refer to About Oracle ACFS in the Cluster Domain.
For more information about running Oracle ACFS commands, refer to About Using Oracle ACFS Command-Line Tools.
Table 16-104 Summary of commands for Oracle ACFS in the cluster domain
| Command | Description |
|---|---|
|
Checks whether your current node has the Oracle ACFS remote service drivers and any applicable system transports installed. |
|
|
Checks the status of system resources to determine if Oracle ACFS remote service is loaded. |
|
|
Checks to ensure that your current node is supported for Oracle ACFS remote service. |
|
|
Generates, updates, and imports the Oracle ACFS remote service credentials. |
|
|
Displays the information on the type of cluster and internal information for the running cluster. |
|
|
Clears the Oracle ACFS remote attribute from a file. |
|
|
Sets a file attribute as Oracle ACFS remote. |
|
|
Creates the exports for a cluster and allocates their initial storage. |
|
|
Queries information for export management. |
|
|
Displays active files for all repositories or in a single repository. |
|
|
Reexports all exports or only exports for a particular cluster. |
|
|
Removes the configuration metadata of an export. |
|
|
Resizes storage to the underlying backing file for an export. |
|
|
Lists the current state and description of Oracle ACFS remote service sessions on the Oracle Database member cluster. |
|
|
Creates a transport on the Domain Services Cluster (DSC). |
|
|
Displays the configured transports on the system. |
|
|
Removes a transport. |
acfsremote installed
Purpose
Checks whether your current node has the Oracle ACFS remote service drivers installed.
Syntax and Description
acfsremote installed -h
acfsremote installed [-trace trace_level] [-member] [-domain]The following table contains the options available with the acfsremote installed command.
Table 16-105 Options for the acfsremote installed command
| Option | Description |
|---|---|
|
|
Specifies the trace level. |
|
|
Specifies to check the member cluster |
|
|
Specifies to check the Domain Services Cluster (DSC). |
acfsremote installed checks whether your current node has the Oracle ACFS remote service drivers and any applicable system transports installed.
This command is applicable on both member clusters and Domain Services Clusters (DSC).
Example 16-100 Using acfsremote installed
In this example the Oracle ACFS remote service drivers and an iSCSI transport have been installed.
#acfsremote installed ACFS-9843: ACFS Remote installed: True ACFS-9844: iSCSI installed: True
acfsremote loaded
Purpose
Checks the status of system resources to determine if Oracle ACFS remote service is loaded.
Syntax and Description
acfsremote loaded -h
acfsremote loaded [-trace trace_level] [-member] [-domain]The following table contains the options available with the acfsremote loaded command.
Table 16-106 Options for the acfsremote loaded command
| Option | Description |
|---|---|
|
|
Specifies the trace level. |
|
|
Specifies to check the member cluster |
|
|
Specifies to check the Domain Services Cluster (DSC). |
acfsremote loaded checks the status of system resources to determine if Oracle ACFS remote service is loaded. If all services are loaded, then Oracle ACFS remote service is loaded and running correctly. If a transport is not used or configured, then it may show as False.
This command is applicable on both member clusters and Domain Services Clusters (DSC).
Example 16-101 Using acfsremote loaded
In the following example, Oracle ACFS remote service drivers and configuration are determined to be correct and running. However, there are no iSCSI transports currently configured, so iSCSI has not been started.
#acfsremote loaded ACFS-9846: ACFS Remote loaded: True ACFS-9847: iSCSI loaded: False
acfsremote supported
Purpose
Checks to ensure that your current node is supported for Oracle ACFS remote service.
Syntax and Description
acfsremote supported -h
acfsremote supported [-trace trace_level] [-member] [-domain]The following table contains the options available with the acfsremote supported command.
Table 16-107 Options for the acfsremote supported command
| Option | Description |
|---|---|
|
|
Specifies the trace level. |
|
|
Specifies to check the member cluster |
|
|
Specifies to check the Domain Services Cluster (DSC). |
acfsremote supported checks to ensure that your current node is supported for Oracle ACFS remote service.
This command is applicable on both member clusters and Domain Services Clusters (DSC).
Example 16-102 Using acfsremote supported
In this example, the node is supported for Oracle ACFS remote service with the correct kernels and package requirements, and also supported for the iSCSI transport.
#acfsremote supported ACFS-9840: ACFS Remote supported: True ACFS-9841: iSCSI supported: True
acfsutil cluster credential
Purpose
Generates, updates, or imports the Oracle ACFS remote service credentials.
Syntax and Description
acfsutil cluster credential -h
acfsutil cluster credential { [-n] |
-l [cluster_name] [-n] |
-g cluster_name -o cluster_manifest_file [-c version] |
-r cluster_name [-f] |
-s user_name:group_name |
-i cluster_manifest_file
}
The following table contains the options available with the acfsutil cluster credential command.
Table 16-108 Options for the acfsutil cluster credential command
| Option | Description |
|---|---|
|
|
Suppresses headers when listing registered member clusters. |
|
|
Lists registered member clusters. Optionally, include a cluster name to list only a specific cluster or include the |
|
|
Generate the member cluster's credentials with specified name and export the credentials to the specified file. Optionally, add the |
|
|
Deletes the credential for the specified cluster. Optionally, use |
|
|
Adds user_name and group_name to the credential file to enable permissions for access to Oracle ACFS remote service. The user_name and group_name must specify an existing operating system user and group. |
|
|
Import the credentials contained in the cluster_manifest_file. |
acfsutil cluster credential generates or imports the Oracle ACFS remote service credentials. In most cases, this command is not directly called by an end user.
This command is applicable on all cluster types.
Example 16-103 Using acfsutil cluster credential
In the following example, acfsutil cluster credential sets up the OCR for Oracle ACFS remote service, and then imports an existing credential file into it.
#/sbin/acfsutil cluster credential -s grid_user:asm_group #/sbin/acfsutil cluster credential –s grid2:oinstall #/sbin/acfsutil cluster credential -i my_credential_file
acfsutil cluster info
Purpose
Displays information about the type of cluster and the internal information for the running cluster.
Syntax and Description
acfsutil cluster info -h acfsutil cluster info
acfsutil cluster info displays information about the type of cluster and the internal information for the running cluster. The command can be used to ensure that the kernel Oracle ACFS cluster is in sync with Oracle ASM. This command is applicable on all cluster types.
Example 16-104 Using acfsutil cluster info
# /sbin/acfsutil cluster info Node Count: 2 Rebuild Master: 2 Local Node: 1 Current Incarnation: 10 ACFS DLM Interfaces: ENABLED OKS DLM Interfaces: ENABLED Cluster State: [ NORMAL_OPERATION ] ACFS Remote mode: [DOMAIN SERVICES] ASM Storage mode: [LOCAL] Oracle Appliance: [NONAPP] Nodes: Node 1 - IP 10.0.0.2 – node1 Node 2 - IP 10.0.0.3 - node2
The output from the acfsutil cluster info command includes the following information about the current cluster.
-
Node Count: Number of nodes in the cluster.
In this example, this is a 2–node cluster.
-
Rebuild Master: Rebuild master node.
In this example, node 2 is in charge of rebuilding the cluster.
-
Current Incarnation: An incarnation is any significant membership change in the cluster.
In this example, there have been 10 incarnations of the cluster.
-
Cluster State: NORMAL_OPERATION, MIGRATION, UNKNOWN
In this example, the cluster is operating normally.
-
ACFS Remote mode:
-
MEMBER – a member cluster
-
DOMAIN SERVICES – a domain services cluster
In this example, the ACFS remote mode is set to a domain services cluster,
-
OFF – a standalone cluster
-
-
ASM Storage Mode:
-
LOCAL – the cluster has locally attached storage
In this example, the ASM Storage mode is set to local attached storage.
-
REMOTE – the cluster is using storage served from a REMOTE Domain Services Cluster. REMOTE should only display when Oracle ACFS Remote mode is MEMBER.
-
acfsutil remote clear
Purpose
Clears the Oracle ACFS remote attribute from a file.
Syntax and Description
acfsutil remote clear -h
acfsutil remote clear path_nameThe following table contains the options available with the acfsutil remote clear command.
Table 16-109 Options for the acfsutil remote clear command
| Option | Description |
|---|---|
|
|
Specifies the location of the file. |
acfsutil remote clear clears the Oracle ACFS remote attribute from a file identified by the specified path name. Clearing the remote attribute allows the file on disk to be removed or truncated by a system administrator.
Example 16-105 Using acfsutil remote clear
$ acfsutil remote clear my_remote_file
acfsutil remote set
Purpose
Sets a file attribute as Oracle ACFS remote.
Syntax and Description
acfsutil remote set -h
acfsutil remote set path_nameThe following table contains the options available with the acfsutil remote set command.
Table 16-110 Options for the acfsutil remote set command
| Option | Description |
|---|---|
|
|
Specifies the location of the file. |
acfsutil remote set sets the Oracle ACFS remote attribute on a file identified by the specified path name. Setting the remote attribute prevents the file on disk from being removed or truncated by a system administrator.
Example 16-106 Using the acfsutil remote set command
$ acfsutil remote set my_remote_file
advmutil export create
Purpose
Creates exports and allocates their initial storage.
Syntax and Description
advmutil export create -h advmutil export create -n export_name -c cluster_name -p storage_repos {-s file_size | -f}
The following table contains the options available with the advmutil export create command.
Table 16-111 Options for the advmutil export create command
| Option | Description |
|---|---|
|
|
Specifies the export name. |
|
|
Specifies the member cluster name. |
|
|
Specifies the location of the repository where the backing file is stored. |
|
|
Specifies the file size in the format n{K|M|G|T|P|E}. The units are K (Kilobytes), M (Megabytes), G (Gigabytes), T (Terabytes), P (Petabytes) or E (Exabytes). |
|
|
Specifies to reuse an existing storage repository. |
advmutil export create manages the exports for a cluster. It is responsible for creating exports and allocating their initial storage. When creating an export, a fully-allocated (non-sparse) file is allocated for performance reasons.
When creating an export, the name provided with -n option also becomes the name of the volume on the member cluster. If -n expvol1 is provided, then that would result in device /dev/asm/expvol1-000 created on the member cluster.
The -p option must specify an Oracle ACFS file system for the storage repository. If an Oracle ACFS clusterware (CRS) resource exists, then it is modified to depend on any transport VIP resources registered to the cluster.
If the backing file already exists in a repository, then the -f option must be provided. After a backing file is created, Oracle ACFS lists it as in-use by Oracle ACFS remote service (with the Remote flag) and prevents various actions against the file.
Snapshots of exports are on the DSC only. Snapshots created on the member cluster of the Oracle ACFS file system mounted on the member cluster are accessible on the member cluster only.
This command is only applicable to the Domain Services Cluster (DSC).
Example 16-107 Using advmutil export create
In the following example, export1 is created on cluster1 with the repository located at /repository1 and the size allocated is 512 M.
#/sbin/advmutil export create -n export1 -c cluster1 -p /repository1 -s 512M Creating File Backed Volume. Export and backing store for volume 'export1' for cluster 'cluster1' created.
To use Oracle ACFS remote service repositories with Oracle ACFS snapshots of the DSC repository, some manual steps must be performed on the DSC. When snapping a DSC repository, all backing files in the repository are snapped.
In the following example, a snapshot is exported to the same member cluster.
-
Create a backing file.
#/sbin/advmutil export create -c mc1 -p /repo -n vol1 -s 2G
-
Snap the backing file.
$/sbin/acfsutil snap create -w snap1 /repo
-
Create a snapshot link in the root of the repository:
$/sbin/acfsutil snap link -s snap1 /repo/snap1_link
-
Export the snap, using the -f option.
#/sbin/advmutil export create -f -n vol1 -p /repo/snap1_link -c mc1
In the following example, a snapshot is exported to a different member cluster.
-
Create a backing file.
#/sbin/advmutil export create -c mc1 -p /repo -n vol1 -s 2G
-
Snap the backing file.
$/sbin/acfsutil snap create -w snap3 /repo
-
Create a snapshot link in the root of the repository:
$/sbin/acfsutil snap link -s snap3 /repo/snap3_link
-
Use
lnto link to the file from the new member cluster repository.Note that f903… is the GUID of the old member cluster and 54633… is the GUID of the new member cluster.
$ln -sf /repo/54633dd2059d6f2cbff1217a6054564b/vol1 /repo/snap3_link/f9038b6ff0d64f36fff4d345803dfacd/vol1
-
Add the new snapshot to the new member cluster.
#/sbin/advmutil export create -f -n vol1 -p //repo/ -c mc2
advmutil export list
Purpose
Displays information about exports and member clusters.
Syntax and Description
advmutil export list -h advmutil export list [-c cluster_name] [-o options] [-g group_type] [-a] [-n]
The following table contains the options available with the advmutil export list command.
Table 16-112 Options for the advmutil export list command
| Option | Description |
|---|---|
|
|
Specifies the name of the member cluster. |
|
|
Specifies an options list, comma separated, with no spaces. The options are clientDev,clusterGUID,clusterName,storageRepo,exportName,filePath,state,exportSize,active,domainNode, and minor. |
|
|
Specifies the group type by clusterName, clusterGUID, or storageRepo. |
|
|
Displays only active exports. |
|
|
Specifies not to print column headers. |
advmutil export list is a powerful query command for export management. It contains a default view that displays basic information, but can also be used to sort by different groups, and to display different pieces of information on different clusters.
By default, advmutil export list sorts by cluster name (the clusterName group sort option). Exports can also be sorted by storage repository (storageRepo) or by cluster GUID (clusterGUID).
The default view of the exports is meant to be easily readable with appropriate headers and informational queues. You can use the -n option to display all output on a single line with no headers so that the information can be used in a script.
The default view includes the clientDev option which displays the pathname to the device on the member cluster system. This default view can be provided to member cluster administrators to describe the information the administrators require to administer their systems.
This command is only applicable to the Domain Services Cluster (DSC).
Example 16-108 Using advmutil export list
The following example lists the export name, storage size, export minor, storage repository, and client ADVM volume device for the member cluster cluster1. Note the client ADVM volume device is displayed by default.
#/sbin/advmutil export list -c cluster1 -o exportSize,minor,storageRepo clusterName: cluster1 exportName storageSize exportMinor storageRepository (client ADVM device) ------------------------------------------------------------------------- exporta 512.00M 0 /repo (/dev/asm/exporta-000) exportb 512.00M 1 /repo (/dev/asm/exportb-001) exportc 512.00M 2 /repo (/dev/asm/exportc-002)
advmutil export lsof
Purpose
Lists active files for in repositories.
Syntax and Description
advmutil export lsof -h
advmutil export lsof [-p path] [-a]
The following table contains the options available with the advmutil export lsof command.
Table 16-113 Options for the advmutil export lsof command
| Option | Description |
|---|---|
|
|
Specifies the location of the directory or file. |
|
|
Displays only active exports. |
advmutil export lsof shows active files for all repositories, or a specified file or directory in a single repository.
This command is only applicable to the Domain Services Cluster (DSC).
Example 16-109 Using advmutil export lsof
In the following example, the active files are displayed for the member cluster cluster1.
#/sbin/advmutil export lsof EXPORT_NAME STATE CLUSTER_NAME REPO_ID REPO_PATH exporta unknown cluster1 45057_2 /repo exportb unknown cluster1 45057_2 /repo exportc unknown cluster1 45057_2 /repo
advmutil export mapping
Purpose
Reexports all exports or only exports for a particular cluster.
Syntax and Description
advmutil export mapping -h
advmutil export mapping [-c cluster_name]
The following table contains the options available with the advmutil export mapping command.
Table 16-114 Options for the advmutil export mapping command
| Option | Description |
|---|---|
|
|
Specifies the name of the member cluster. |
advmutil export mapping reexports all exports or only exports for a specified member cluster. It can be used to force Oracle ACFS remote service to reexport all configured exports in the event of a system administrator action that has removed access to a particular export.
This command is only applicable to the Domain Services Cluster (DSC).
Example 16-110 Using advmutil export mapping
In the following example, exports are reexported for the member cluster cluster1.
#/sbin/advmutil export mapping -c cluster1
advmutil export remove
Purpose
Removes the configuration metadata of an export.
Syntax and Description
advmutil export remove -h advmutil export remove -c cluster_name [-p storage_repos -n export_name] [-f] [-b] [-y]
The following table contains the options available with the advmutil export remove command.
Table 16-115 Options for the advmutil export remove command
| Option | Description |
|---|---|
|
|
Specifies the member cluster name. |
|
|
Specifies the location of the repository where the backing file is stored. |
|
|
Specifies the export name. |
|
|
Forces removal whether or not export mapping is active. |
|
|
Removes the backing file for this mapping. |
|
|
Does not prompt when removing the backing file for cluster. |
advmutil export remove removes the configuration metadata of an export.
By default, the backing file remains after the removal operation. This file can be reused by running advmutil export create with the -f option. If the backing file is no longer required, then you can use the -b option to delete the backing file and return the storage space to the repository.
This command is only applicable to the Domain Services Cluster (DSC).
Example 16-111 Using advmutil export remove
In the following example, the metadata for export1 is removed.
#/sbin/advmutil export remove -c cluster1 -p /repository1 -n export1
advmutil export resize
Purpose
Adds storage to the underlying backing file for an export.
Syntax and Description
advmutil export resize -h advmutil export resize -c cluster_name -p storage_repos -n export_name -s file_size
The following table contains the options available with the advmutil export resize command.
Table 16-116 Options for the advmutil export resize command
| Option | Description |
|---|---|
|
|
Specifies the member cluster name. |
|
|
Specifies the location of the repository where the backing file is stored. |
|
|
Specifies the export name. |
|
|
Specifies the file size in the format n{K|M|G|T|P|E}. The units are K (Kilobytes), M (Megabytes), G (Gigabytes), T (Terabytes), P (Petabytes) or E (Exabytes). |
advmutil export resize adds storage to the underlying backing file for an export. After the backing file is grown, the device on the member cluster is also resized. To use the new size, an administrator must run acfsutil size on the member cluster mounted file system that is using the newly-sized device. Optionally, the new storage is used when needed if Oracle ACFS automatic resize functionality is configured on the mounted member cluster Oracle ACFS file system that is associated with this device.
To shrink a device, you must run acfsutil size on the member cluster to decrease the size of the file system. This action also shrinks the size of the associated backing file.
You can run advmutil volinfo on the member cluster to display the size of the underlying volume. However, this may be different than the size of the current Oracle ACFS file system that is using this device.
This command is only applicable to the Domain Services Cluster (DSC).
Example 16-112 Using advmutil export resize
In the following example, the size of the backing file for export1 has been increased to 1 G.
#/sbin/advmutil export resize -c cluster1 -p /repository1 -n export1 -s 1G
advmutil session list
Purpose
Lists the current state and description of Oracle ACFS remote service sessions on the Oracle Database member cluster.
Syntax and Description
advmutil session list -h advmutil session list [-n node_name] [[-i transport_id] [-v]]
The following table contains the options available with the advmutil session list command.
Table 16-117 Options for the advmutil session list command
| Option | Description |
|---|---|
|
|
Specifies the node name. |
|
|
Specifies the transport Id in the format |
|
|
Displays verbose output, including XML data. |
advmutil session list lists the current state and description of Oracle ACFS remote service sessions on the Oracle Database member cluster. This list is useful for debugging and informational purposes.
In the output of the command, the possible state value are:
-
ONLINEOracle ACFS remote service transport session is currently up and configured.
-
REFRESHOracle ACFS remote service transport session, that is associated with the configured transport of
‘transport_type.sequence_num’on the DSC, is being refreshed. A refresh logs out of all existing targets and attempts to reinitialize the underlying operating system transport sessions associated with the Oracle ACFS remote service transport configuration. -
RESCANOracle ACFS remote service transport session is currently being scanned. The rescan process only removes operating system transport sessions that no longer exist, or adds new sessions that have been added. Existing sessions are not scanned.
The advmutil session list command only applies to the Oracle Database member cluster.
Example 16-113 Using advmutil session list
In the following example, session information is displayed for Node1 and Node2 on the member cluster.
#/sbin/advmutil session list nodeName transportType sequenceNum state ----------------------------------------- Node1 iSCSI 0 ONLINE Node2 iSCSI 0 ONLINE
advmutil transport create
Purpose
Creates a transport on the Domain Services Cluster (DSC).
Syntax and Description
advmutil transport create -h advmutil transport create -c cluster_name [-b binding [-n network_num ] | [-i resource_id] [-f]
The following table contains the options available with the advmutil transport create command.
Table 16-118 Options for the advmutil transport create command
| Option | Description |
|---|---|
|
|
Specifies the member cluster name that the transport belongs to. |
|
|
Specifies the transport VIP, either the host name or the network address. |
|
|
Specifies the network number for the specified VIP. The default is |
|
|
Specifies an existing alternate resource identifier. |
|
|
Forces the acceptance of the specified existing binding. |
advmutil transport create creates a transport on the Domain Services Cluster (DSC).
The cluster name can be discovered using the crsctl query member_cluster_configuration command. The transport VIP can be an IPv4 or IPv6 address, and can be either a resolvable DNS entry, or an IP address.
When creating a transport with additional features enabled, such as multipathing and failover, multiple transports must be enabled for a single member cluster. You can create multiple transports by running the advmutil transport create command multiple times, specifying additional VIP addresses.
Member clusters may share VIPs. You can accomplish this by specifying a common VIP name when registering a transport for a new member cluster. However, all member clusters must have the advmutil transport create command run at least once to specify their transport.
Transport IDs are created for each transport with the identifier of the form cluster_name_transport_type_sequence#, where n is an number starting from 0 and increased by 1 for each transport.
This command is only applicable on the Domain Services Cluster.
Example 16-114 Using advmutil transport create
In the following example, a transport is created for member cluster cluster1 with VIP havip1 using network 2.
#/sbin/advmutil transport create –c cluster1 –b havip1 –n 2
advmutil transport list
Purpose
Displays the configured transports on the system.
Syntax and Description
advmutil transport list [-h] advmutil transport list [-c cluster_name [-i transport_id] [-v]] | [-g cluster_guid [-i transport_id [-v]]]
The following table contains the options available with the advmutil transport list command.
Table 16-119 Options for the advmutil transport list command
| Option | Description |
|---|---|
|
|
Specifies the member cluster name that the transport belongs to. |
|
|
Specifies the transport Id in the format |
|
|
Specifies the cluster Globally Unique IDentifier (GUID). |
|
|
Specifies verbose output including XML data. |
advmutil transport list displays the configured transports on the system. The command can be configured to display information about specific clusters using the -c or -g options, as well as displaying the full configuration output.
This command is only applicable on the Domain Services Cluster.
Example 16-115 Using advmutil transport list
In the following example, the output shows a single iSCSI transport configured with sequence number 0.
#/sbin/advmutil transport list clusterName: cluster1 (clusterGUID: f403401d0518ffcfff54324f2cc2f6d8) transportType sequenceNum ----------------------------------------------------------- iSCSI 0
Using the information in the output above, the sequence number (0) can be used on the member cluster to display information about a specific transport. Additionally, you can retrieve the full transport specification using the transport Id (iSCSI.0).
advmutil transport remove
Purpose
Removes a transport.
Syntax and Description
advmutil transport remove [-h] advmutil transport remove -c cluster_name -i transport_id
The following table contains the options available with the advmutil transport remove command.
Table 16-120 Options for the advmutil transport remove command
| Option | Description |
|---|---|
|
|
Specifies the member cluster name that the transport belongs to. |
|
|
Specifies the transport Id in the format |
advmutil transport remove removes a transport. This also removes any associated transport VIP resources if the transport is the last transport using this ID.
This command is only applicable on the Domain Services Cluster.
Example 16-116 Using advmutil transport remove
In the following example, the transport with transport Id iSCSI.0 is removed from cluster1.
#/sbin/advmutil transport remove -c cluster1 -I iSCSI.0