1. Administrator's Guide
  2. Oracle ASM Instances and Disk Groups
  3. Managing Oracle ASM with ASMCMD
  4. ASMCMD Client Cluster Management Commands

ASMCMD Client Cluster Management Commands

This topic provides a summary of the ASMCMD client cluster management commands that are used with Oracle ASM remote instances.

Unless otherwise specified, the ASMCMD cluster management commands should be executed in the Oracle ASM-CSS cluster.

For information about Oracle Flex ASM, refer to "Managing Oracle Flex ASM".

Table 10-23 lists the ASMCMD client cluster management commands with brief descriptions.

Table 10-23 Summary of ASMCMD client cluster management commands

Command Description

mkcc

Creates a configuration for a member cluster.

lscc

Lists the configured member clusters.

rmcc

Removes the configuration for a member cluster.

lscc

Purpose

Lists the configured member clusters.

Syntax and Description

lscc [--suppressheader] [-l] [cluster_name]

The following table lists the options for the lscc command.

Table 10-24 Options for the lscc command

Option Description

–suppressheader

Suppresses column headings from the output.

-l

Displays all details.

cluster_name

Specifies the name of the client cluster.

Examples

The following example lists the configured client clusters.

Example 10-29 Using the ASMCMD lscc command

ASMCMD [+] > lscc
--------------------------------------------------------------------------------
           NAME        VERSION GUID
================================================================================
 ClientCluster1     12.2.0.0.0 78015b1e78756f88bf119fd8e5146df4
 Clientcluster2     12.2.0.0.0 3de3bbd75e9a7f17bfe027b477b5bcae
================================================================================

ASMCMD [+] > lscc -l
--------------------------------------------------------------------------------
           NAME        VERSION GUID                             ASM GIMR TFA RHP
================================================================================   
 ClientCluster1     12.2.0.0.0 78015b1e78756f88bf119fd8e5146df4 YES  YES YES YES
 Clientcluster2     12.2.0.0.0 3de3bbd75e9a7f17bfe027b477b5bcae YES  YES YES  NO
================================================================================

ASMCMD [+] > lscc ClientCluster1 --suppressheader
 ClientCluster1     12.2.0.0.0 78015b1e78756f88bf119fd8e5146df4

ASMCMD [+] > lscc ClientCluster1 --suppressheader -l
 ClientCluster1     12.2.0.0.0 78015b1e78756f88bf119fd8e5146df4 ASM,GIMR,TFA,RHP

mkcc

Purpose

Creates the configuration for a member cluster.

Syntax and Description

mkcc cluster_name wrap [--direct] [--version client_cluster_version] [--asm] [--gimr] [--rhp] [--tfa]

The following table lists the options for the mkcc command.

Table 10-25 Options for the mkcc command

Option Description

cluster_name

Specifies the name of the client cluster.

wrap

Specifies the full path of the XML file to export the credentials.

--direct

Specifies direct storage access. If not specified, the storage access is indirect.

--version client_cluster_version

Specifies the five digit client cluster version if it is different than the storage server version. The storage server version is used if not specified.

--asm

Generate credentials and configuration for an Oracle ASM client cluster.

–-gimr

Generate credentials and configuration for an Oracle GIMR client cluster.

–-rhp

Generate credentials and configuration for an Oracle RHP client cluster.

--tfa

Generate credentials and configuration for an Oracle TFA client cluster.

The client cluster name must conform to the same rules as a cluster name. The name must be unique across your enterprise, must be at least one character long and no more than 15 characters in length, must be alphanumeric, cannot begin with a numeral, and may contain hyphens (-). Underscore characters (_) are not allowed.

If no component options are specified, the default is to configure all of the components and store their credentials in the same manifest file.

GNS credentials are not generated by the asmcmd mkcc command. To configure the member cluster as a GNS Client, run the following command as a privileged user to export the GNS instance client data configuration to the cluster manifest file: 

srvctl export gns -clientdata wrap -role CLIENT

Examples

The following example creates credentials for a client cluster.

Example 10-30 Using the ASMCMD mkcc command

ASMCMD [+] > mkcc clientcluster1 /tmp/client_cluster1.xml --version 12.2.0.0.0

See Also:

Oracle Grid Infrastructure Installation and Upgrade Guide for information about cluster name requirements

rmcc

Purpose

Removes the configuration for a member cluster.

Syntax and Description

rmcc cluster_name [-f]

The following table lists the options for the rmcc command.

Table 10-26 Options for the rmcc command

Option Description

cluster_name

Specifies the name of the client cluster.

-f

Specifies to force the removal of client cluster credentials.

Examples

The following example removes the configuration for a client cluster.

Example 10-31 Using the ASMCMD rmcc command

ASMCMD [+] > rmcc clientcluster1