Managing Oracle ASM With ASMCA

9 Managing Oracle ASM With ASMCA

Oracle ASM Configuration Assistant (ASMCA) provides utilities for managing Oracle ASM.

Oracle ASM Configuration Assistant (ASMCA) supports installing and configuring Oracle ASM instances, Oracle ASM disk groups, Oracle ASM Dynamic Volume Manager (Oracle ADVM) volumes, and Oracle Automatic Storage Management Cluster File System (Oracle ACFS) file systems. In addition, you can use the ASMCA command-line interface.

This chapter discusses the following topics:

For information about managing Oracle ACFS and Oracle ADVM with ASMCA, refer to Managing Oracle ACFS and Oracle ADVM With ASMCA.

Note:

Some ASMCA functionality and menu options are only available in specific environments, such as an Oracle RAC configuration. For details about a specific ASMCA page, access the online help provided with the Help button.

Getting Started With the ASMCA GUI Tool

To start ASMCA, enter asmca at a command prompt inside the Oracle Grid Infrastructure home. For example:

$ asmca

The GUI tool displays and attempts to connect to the Oracle ASM instance identified with the Oracle system identifier (SID) set to +ASM.

If ASMCA detects an Oracle ASM instance that is not running, then ASMCA prompts whether you want to start the instance.

To start the command-line ASMCA, see ASMCA Command-Line Interface.

Note:

Managing Instances and Disk Groups With ASMCA

This section contains the following topics:

Note:

On Solaris and AIX, if you shut down the database instance using the SHUTDOWN ABORT command, volume device files are not removed.

Creating Oracle ASM Instances with ASMCA

Oracle ASM Configuration Assistant enables you to create an Oracle ASM instance if the Oracle ASM instance is not found on the host.

On the Create ASM page, you enter the SYS password for the administrator of the Oracle ASM instance and the password for the ASMSNMP user that can monitor this Oracle ASM instance. ASMSNMP is a less privileged user that is primarily used to monitor Oracle ASM instances.

You can select the listener with which to register this Oracle ASM instance. Click ASM Parameters to update the initialization parameters for the Oracle ASM instance.

When you can click ASM Parameters in the Create ASM page, you can update initialization parameters for an Oracle ASM instance on the Oracle ASM Configuration Assistant page.

Managing Disk Groups with ASMCA

Oracle ASM Configuration Assistant enables you to configure or create Oracle ASM disk groups with the Configure ASM Disk Groups tab.

The disk group tab displays selected details about the disk group, such as name, size, free space, usable space, redundancy level, and state of the disk group.

You can right click a selected disk group in the screen to display the configuration options menu. The menu options enable you to:

Add disks to and drop disks from the disk group
Add, drop, and list quota groups.
Add, drop, and move file groups.
Edit the disk group attributes
Manage templates for the disk group
Create an Oracle ACFS file system on the disk group for database use
Mount and dismount the disk group
Drop the disk group
Drop and clear Oracle ASM Filter Driver labels.

There are additional options for creating a disk group, mounting all disk groups, and dismounting all disk groups.

Oracle ASM Configuration Assistant enables you to create an Oracle ASM disk group by clicking Create on the Oracle ASM Configuration Assistant disk group page.

On the Create Disk Group page, you can enter a name for the disk group, select the redundancy level, change the disk discovery path to locate disks in a different directory, identify the disks to be in the disk group, enter a name for a failure group, and specify if the failure group is a quorum type.

A quorum failure group is a special type of failure group and disks in these failure groups do not contain user data and a quorum failure group is not considered when determining redundancy requirements with respect to user storage. However, a quorum failure group counts when mounting a disk group.

If Oracle ASM Filter Driver has been configured for your system, you can add Oracle ASM Filter Driver labels to disks or clear Oracle ASM Filter Driver labels from disks.

You can choose to show advanced options when creating a disk group. The advanced options section enables you to set additional options, such as disk group compatibility settings and allocation unit (AU) size. When you are finished with the create disk group specifications, click OK.

Note:

The disk group compatibility settings can only be advanced. You cannot revert to a lower compatibility setting after you advance the disk group compatibility settings.

Note:

The values for Free (GB) and Usable (GB) space are 0 if the disk group type is FLEX or EXTEND. The 0 value in this case means no value is given, not a zero amount in for Free (GB) and Usable (GB) space.

ASMCA Command-Line Interface

The ASMCA command-line interface provides non-GUI support for configuring Oracle ASM instances, Oracle ASM disk groups, volumes, and Oracle ACFS.

Running ASMCA Command-Line

The syntax for running the ASMCA command-line tool is:

asmca -silent command_name [options]

Table 9-1 contains the options available with the asmca command-line tool.

Table 9-1 Options for the ASMCA command-line tool

Option Description

Option	Description
`-silent`	Specifies to run `asmca` in command-line mode.
`command_name`	Specifies the command to run. The command can be any of the following: `-configureASM` `-configureParameter` `-deleteASM` `-createDiskGroup` `-editDiskGroupAttributes` `-addDisk` `—createLabel` `-dropLabel` `-createFileGroups` `-dropFileGroups` `—createQuotaGroups` `-dropQuotaGroups` `-createVolume` `-createACFS` `-createACFSSnapshot` `-dropACFSSnapshot` See ASMCA Commands for Instances and Disk Groups.
`options`	Specifies the options to run for a command. The options vary by command. See the individual commands described in ASMCA Commands for Instances and Disk Groups for the available options. The following list describes the options that are common for multiple commands. `-help` Displays help for running ASMCA in silent mode. `-asmsnmpPassword` `asmsnmp_password` The Oracle ASM monitor user (`ASMSNMP`) password. This is optional and only required when creating and migrating an Oracle ASM instance. `-sysAsmPassword` `sysasm_password` The `SYSASM` password for Oracle ASM instance. This option is required.

-silent

Specifies to run asmca in command-line mode.

command_name

Specifies the command to run. The command can be any of the following:

-configureASM
-configureParameter
-deleteASM
-createDiskGroup
-editDiskGroupAttributes
-addDisk
—createLabel
-dropLabel
-createFileGroups
-dropFileGroups
—createQuotaGroups
-dropQuotaGroups
-createVolume
-createACFS
-createACFSSnapshot
-dropACFSSnapshot

See ASMCA Commands for Instances and Disk Groups.

options

Specifies the options to run for a command. The options vary by command. See the individual commands described in ASMCA Commands for Instances and Disk Groups for the available options.

The following list describes the options that are common for multiple commands.

-help

Displays help for running ASMCA in silent mode.
-asmsnmpPassword asmsnmp_password

The Oracle ASM monitor user (ASMSNMP) password. This is optional and only required when creating and migrating an Oracle ASM instance.
-sysAsmPassword sysasm_password

The SYSASM password for Oracle ASM instance. This option is required.

The following is an example of the -help option.

$ asmca -help
asmca [-silent] [-sysAsmPassword <SYS user password>] [-asmsnmpPassword <ASMSNMP password>] {<command> <options>}
Please refer to the manual for details.
You can enter one of the following commands:
...

ASMCA Commands for Instances and Disk Groups

This section describes the commands that can be run with ASMCA command-line to manage Oracle ASM objects.

Configure an Oracle ASM Instance

-configureASM configures or creates an Oracle ASM instance.

Syntax

asmca -silent
     -configureASM
       [-sysAsmPassword sysasm_password ]
       [ -asmsnmpPassword asm_monitor_password ] 
       [ { -param paramname=paramvalue , ... } ]
       [ { -diskString discovery_path
        { -diskGroupName diskgroup
         { -disk disk_path [-diskName disk]  |
          -diskList disk_list 
              [-diskSize disk_size_MB] 
              [-failuregroup failure_group] 
              [-force|-noforce] 
              [-quorum|-noquorum]  }
       [ -redundancy { HIGH | NORMAL | EXTERNAL } ] } ]
       [-au_size value]
       [-compatible.asm value ]
       [-compatible.rdbms value ]
       [-compatible.advm value ] }

Table 9-2 contains the options available with the -configureASM command.

Table 9-2 Options for the -configureASM command

Option	Description
`-param` `paramname=paramvalue` , ...	Specifies a list of initialization parameters with values for the Oracle ASM instance.
`-diskString` `discovery_path`	Specifies the Oracle ASM discovery string for locating disks.
`-diskGroupName` `diskgroup`	Specifies the name of the Oracle ASM disk group to create.
`-disk` `disk_path`	Specifies the full path of the disk device.
`-diskName` `disk`	Specifies a user-supplied disk name.
`-diskList` `disk_list`	Specifies a comma-delimited list of disk names to be added to the disk group.
`-diskSize` `disk_size_MB`	Specifies the size of the disk to use for Oracle ASM storage.
`-failuregroup` `failure_group`	Specifies the failure group name.
`-force` \| `-noforce`	Specifies where to force the use of the disk.
`-quorum` \| `-noquorum`	Specifies a quorum or standard failure group.
`-redundancy` { `HIGH` \| `NORMAL` \| `EXTERNAL`}	Specifies the redundancy setting for the Oracle ASM disk group.
`-au_size`	Specifies the allocation unit size (1,2,4,8,16,32,64)
`-compatible.asm`	Specifies the attribute setting.
`-compatible.rdbms`	Specifies the attribute setting.
`-compatible.advm`	Specifies the attribute setting.

For additional options that are common to multiple commands, see Table 9-1.

Examples

To configure an Oracle ASM instance:

Example 9-1 Using asmca -silent -configureASM

asmca -silent
        -configureASM
          -diskString '/devices/disk*'
          –sysAsmPassword my_sysasm_password
          -asmsnmpPassword my_asmsnmp_passwd

Configure Parameters for a Specified Instance

-configureParameter modifies the parameters of the specified target instance.

Syntax

asmca -silent
          -configureParameter [-target {ASM|IOS|APX|ALL} ] 
          [{-param paramname=paramvalue , ... }]
          [-sysAsmPassword sysasm_password ]

Table 9-3 contains the options available with the -configureParameter command.

Table 9-3 Options for the -configureParameter command

Option	Description
`-target {ASM\|IOS\|APX\|ALL}`	Specifies the target instance of the command. If no target is specified, the default is the Oracle ASM instance.
`-param` `paramname=paramvalue` , ...	Specifies a list of initialization parameters with values for the Oracle ASM instance.

For additional options that are common to multiple commands, see Table 9-1.

Examples

To configure parameters for a specified target instance:

Example 9-2 Using asmca -silent -configureParameter

asmca -silent
        -configureParameter 
            –param 
            asm_power_limit=3
        –sysAsmPassword my_sysasm_password

Delete Oracle ASM Instances

-deleteASM deletes all the Oracle ASM instances that are present. The operation stops and an error is raised if there is a database using the Oracle ASM instance.

Syntax

asmca -silent
          -deleteASM
          [-sysAsmPassword sysasm_password ]
          [-force] 
          [-dropDiskGroups]

Table 9-4 contains the options available with the -deleteASM command.

Table 9-4 Options for the -deleteASM command

Option	Description
`-force`	Forces the deletion of an Oracle ASM instance.
`-dropDiskGroups`	Drops the disk groups on this instance.

For additional options that are common to multiple commands, see Table 9-1.

Examples

To delete an Oracle ASM instance:

Example 9-3 Using asmca -silent -deleteASM

asmca -silent
        -deleteASM
          –sysAsmPassword my_sysasm_password
          -force

Create a Disk Group

-createDiskGroup creates disk groups in an Oracle ASM instance.

Syntax

asmca -silent
     -createDiskGroup
       [ -diskString discovery_path ]
       { -diskGroupName diskgroup
         { -disk disk_path [-diskName disk]  |
          -diskList disk_list 
              [-diskSize disk_size_MB] 
              [-failuregroup failure_group] 
              [-force|-noforce] 
              [-quorum|-noquorum]  }
       [ -redundancy { HIGH | NORMAL | EXTERNAL } ] } ]
       [-au_size value]
       [-compatible.asm value ]
       [-compatible.rdbms value ]
       [-compatible.advm value ] }
       [-sysAsmPassword sysasm_password ]

Table 9-5 contains the options available with the -createDiskGroup command.

Table 9-5 Options for the -createDiskGroup command

Option	Description
`-diskString` `discovery_path`	Specifies the Oracle ASM discovery string for locating disks.
`-diskGroupName` `diskgroup`	Specifies the name of the Oracle ASM disk group to create.
`-disk` `disk_path`	Specifies the full path of the disk device.
`-diskName` `disk`	Specifies a user-supplied disk name.
`-diskList` `disk_list`	Specifies a comma-delimited list of disk names to be added to the disk group.
`-diskSize` `disk_size_MB`	Specifies the size of the disk to use for Oracle ASM storage.
`-failuregroup` `failure_group`	Specifies the failure group name.
`-force` \| `-noforce`	Specifies where to force the use of the disk.
`-quorum` \| `-noquorum`	Specifies a quorum or standard failure group.
`-redundancy` { `HIGH` \| `NORMAL` \| `EXTERNAL`}	Specifies the redundancy setting for the Oracle ASM disk group.
`-au_size`	Specifies the allocation unit size (1,2,4,8,16,32,64)
`-compatible.asm`	Specifies the attribute setting.
`-compatible.rdbms`	Specifies the attribute setting.
`-compatible.advm`	Specifies the attribute setting.

For additional options that are common to multiple commands, see Table 9-1.

For information about disk group compatibility attributes, see Disk Group Compatibility.

Examples

To create disk groups in an Oracle ASM instance:

Example 9-4 Using asmca -silent -createDiskGroup

$ asmca -silent -createDiskGroup
       -diskGroupName mynewdg
           -disk '/devices/diske*'
           -disk '/devices/diskk*'
       -redundancy NORMAL
       -au_size 64
       -compatible.asm '19.0.0.0.0'
       -compatible.rdbms '19.0.0.0.0'
       -compatible.advm '19.0.0.0.0'

DiskGroup mynewdg created successfully.

Add a Disk to a Disk Group

-addDisk add disks to an existing disk group in an Oracle ASM instance.

Syntax

asmca -silent 
        -addDisk
         [ -diskString discovery_path ]
           {-diskGroupName diskgroup
            {-disk disk_path [-diskName disk]  |
             -diskList disk_list 
                [-diskSize disk_size_MB] 
                [-failuregroup failure_group] 
                [-force|-noforce] 
                [-quorum|-noquorum]  }
         [-sysAsmPassword sysasm_password ]

Table 9-6 contains the options available with the -addDisk command.

Table 9-6 Options for the -addDisk command

Option	Description
`-diskString` `discovery_path`	Specifies the Oracle ASM discovery string for locating disks.
`-diskGroupName` `diskgroup`	Specifies the name of the Oracle ASM disk group to update.
`-diskList` `disk_list`	Specifies a comma-delimited list of disk names to be added to the disk group.
`-diskSize` `disk_size_MB`	Specifies the size of the disk to use for Oracle ASM storage.
`-failuregroup` `failure_group`	Specifies the failure group name.
`-force` \| `-noforce`	Specifies where to force the use of the disk.
`-quorum` \| `-noquorum`	Specifies a quorum or standard failure group.

For additional options that are common to multiple commands, see Table 9-1.

Examples

To add disks to an existing disk group:

Example 9-5 Using asmca -silent -addDisk

asmca -silent
        -addDisk
          -diskGroupName mynewdg 
             -disk '/devices/diskl1'
             -disk '/devices/diskl2'

Disks added successfully to diskgroup mynewdg.

Edit Oracle ASM Disk Group Attributes

-editDiskGroupAttributes updates the Oracle ASM disk group attributes.

Syntax and Description

-editDiskGroupAttributes
      (-diskGroupName disk_group)
      (-attribute value)

The following table contains the options available with the —editDiskGroupAttributes command.

Table 9-7 Options for the -editDiskGroupAttributes command

Option	Description
`-diskGroupName` `diskgroup`	Specifies the name of the Oracle ASM disk group to create.
`-attribute` `value`	Specifies the name and assigned value of an attribute.

Create Oracle ASM Filter Driver Labels

—createLabel creates Oracle ASM filter driver labels.

Syntax and Description

-createLabel
       -diskList  disk_list 
       -labelList label_list | -labelPrefix label_prefix

The following table contains the options available with the —createLabel command.

Table 9-8 Options for the —createLabel command

Option	Description
`-diskList` `disk_list`	Specifies a comma-delimited list of disk names to be labeled.
`-labelList` `label_list`	Specifies a comma-delimited list of label names.
`-labelPrefix` `label_prefix`	Specifies the label prefix to be used to create labels. If label list is specified, label prefix is ignored.

Drop Oracle ASM Filter Driver Labels

-dropLabel drops Oracle ASM filter driver labels.

Syntax and Description

-dropLabel
      -labelList label_list

The following table contains the options available with the —dropLabel command.

Table 9-9 Options for the —dropLabel command

Option	Description
`-labelList` `label_list`	Specifies a comma-delimited list of label names.

Create Oracle ASM File Groups

-createFileGroups creates Oracle ASM file groups.

Syntax and Description

-createFileGroups
     (-diskGroupName disk_group)
     (-fileGroupNames file_group_name_list)
     (-fileGroupUsages file_group_usages_list)
     (-fileGroupUsageIDs file_group_usagesID_list)

The following table contains the options available with the —createFileGroups command.

Table 9-10 Options for the -createFileGroups command

Option	Description
`-diskGroupName` `disk_group`	Specifies the name of the Oracle ASM disk group.
`-fileGroupNames` `file_group_name_list`	Specifies a comma-delimited list of file group names to be added to the disk group.
`-fileGroupUsages` `file_group_usages_list`	Specifies a comma-delimited list of file group usage strings to be processed.
`-fileGroupUsagesIDs` `file_group_usagesID_list`	Specifies a comma-delimited list of file group usage IDs to be processed.

Drop Oracle ASM File Groups

-dropFileGroups drops Oracle ASM file groups.

Syntax and Description

-dropFileGroups
      (-diskGroupName disk_group)
      (-fileGroupNames file_group_name_list)

The following table contains the options available with the —dropFileGroups command.

Table 9-11 Options for the -dropFileGroups command

Option	Description
`-diskGroupName` `disk_group`	Specifies the name of the Oracle ASM disk group to create.
`-fileGroupNames` `file_group_name_list`	Specifies a comma-delimited list of file group names to be dropped.

Create Oracle ASM Quota Groups

—createQuotaGroups creates Oracle ASM quota groups.

Syntax and Description

-createQuotaGroups
      (-diskGroupName disk_group)
      (-quotaGroupNames quota_group_name_list)
      (-quotaGroupSizes quota_group_size_list)

The following table contains the options available with the —createQuotaGroups command.

Table 9-12 Options for the -createQuotaGroups command

Option	Description
`-diskGroupName` `disk_group`	Specifies the name of the Oracle ASM disk group.
`-quotaGroupNames` `quota_group_name_list`	Specifies a comma-delimited list of quota group names to be added to the disk group.
`-quotaGroupSizes` `quota_group_size_list`	Specifies a comma-delimited list of quota group sizes to be processed.

Drop Oracle ASM Quota Groups

-dropQuotaGroups drops Oracle ASM quota groups.

Syntax and Description

-dropQuotaGroups
      (-diskGroupName disk_group)
      (-quotaGroupNames quota_group_names_list)

The following table contains the options available with the —dropQuotaGroups command.

Table 9-13 Options for the -dropQuotaGroups command

Option	Description
`-diskGroupName` `disk_group`	Specifies the name of the Oracle ASM disk group.
`-quotaGroupNames` `quota_group_name_list`	Specifies a comma-delimited list of quota group names to be dropped.