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:
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.
Managing Instances and Disk Groups With ASMCA
This section contains the following topics:
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.
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.
See Also:
-
Initialization Parameters for Oracle ASM Instances for information about Oracle ASM instance initialization parameters
-
Oracle Grid Infrastructure Installation and Upgrade Guide for information about installing Oracle ASM
-
Oracle Database Installation Guide for information about reviewing database accounts and passwords
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.
See Also:
-
Storing Oracle Cluster Registry and Voting Files in Oracle ASM Disk Groups for information about quorum failure groups
-
Administering Oracle ASM Filter Driver for information about Oracle ASM Filter Driver
-
Disk Group Compatibility and Overview of Disk Group Compatibility for information about disk group compatibility attributes and advancing disk group compatibility
-
Oracle ASM Disk Discovery and ASM_DISKSTRING for information about disk discovery
-
Administering Oracle ASM Disk Groups for more information about managing disk groups
-
Oracle Database Reference for descriptions of disk group information displayed in the
V$ASM_DISKGROUP
view
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 |
---|---|
|
Specifies to run |
|
Specifies the command to run. The command can be any of the following:
|
|
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.
|
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 |
---|---|
|
Specifies a list of initialization parameters with values for the Oracle ASM instance. |
|
Specifies the Oracle ASM discovery string for locating disks. |
|
Specifies the name of the Oracle ASM disk group to create. |
|
Specifies the full path of the disk device. |
|
Specifies a user-supplied disk name. |
|
Specifies a comma-delimited list of disk names to be added to the disk group. |
|
Specifies the size of the disk to use for Oracle ASM storage. |
|
Specifies the failure group name. |
|
Specifies where to force the use of the disk. |
|
Specifies a quorum or standard failure group. |
|
Specifies the redundancy setting for the Oracle ASM disk group. |
|
Specifies the allocation unit size (1,2,4,8,16,32,64) |
|
Specifies the attribute setting. |
|
Specifies the attribute setting. |
|
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 |
---|---|
|
Specifies the target instance of the command. If no target is specified, the default is the Oracle ASM instance. |
|
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 |
---|---|
|
Forces the deletion of an Oracle ASM instance. |
|
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 |
---|---|
|
Specifies the Oracle ASM discovery string for locating disks. |
|
Specifies the name of the Oracle ASM disk group to create. |
|
Specifies the full path of the disk device. |
|
Specifies a user-supplied disk name. |
|
Specifies a comma-delimited list of disk names to be added to the disk group. |
|
Specifies the size of the disk to use for Oracle ASM storage. |
|
Specifies the failure group name. |
|
Specifies where to force the use of the disk. |
|
Specifies a quorum or standard failure group. |
|
Specifies the redundancy setting for the Oracle ASM disk group. |
|
Specifies the allocation unit size (1,2,4,8,16,32,64) |
|
Specifies the attribute setting. |
|
Specifies the attribute setting. |
|
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 |
---|---|
|
Specifies the Oracle ASM discovery string for locating disks. |
|
Specifies the name of the Oracle ASM disk group to update. |
|
Specifies a comma-delimited list of disk names to be added to the disk group. |
|
Specifies the size of the disk to use for Oracle ASM storage. |
|
Specifies the failure group name. |
|
Specifies where to force the use of the disk. |
|
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 |
---|---|
|
Specifies the name of the Oracle ASM disk group to create. |
|
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 |
---|---|
|
Specifies a comma-delimited list of disk names to be labeled. |
|
Specifies a comma-delimited list of label names. |
|
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 |
---|---|
|
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 |
---|---|
|
Specifies the name of the Oracle ASM disk group. |
|
Specifies a comma-delimited list of file group names to be added to the disk group. |
|
Specifies a comma-delimited list of file group usage strings to be processed. |
|
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 |
---|---|
|
Specifies the name of the Oracle ASM disk group to create. |
|
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 |
---|---|
|
Specifies the name of the Oracle ASM disk group. |
|
Specifies a comma-delimited list of quota group names to be added to the disk group. |
|
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 |
---|---|
|
Specifies the name of the Oracle ASM disk group. |
|
Specifies a comma-delimited list of quota group names to be dropped. |