Tuesday, November 6, 2012

ASMCMD Volume Management Commands


ASMCMD Volume Management Commands
Summary of ASMCMD volume management commands
Command
Description
volcreate
Creates an Oracle ADVM volume in the specified disk group.
voldelete
Deletes an Oracle ADVM volume.
voldisable
Disables Oracle ADVM volumes in mounted disk groups.
volenable
Enables Oracle ADVM volumes in mounted disk groups.
volinfo
Displays information about Oracle ADVM volumes.
volresize
Resizes an Oracle ADVM volume.
volset
Sets attributes of an Oracle ADVM volume in mounted disk groups.
volstat
Reports volume I/O statistics.


volcreate
Purpose
Creates an Oracle ADVM volume in the specified disk group.
Syntax and Description

volcreate -G diskgroup -s size
    [ --column number ] [ --width stripe_width ]
     [--redundancy {high|mirror|unprotected} ]
     [--primary {hot|cold}] [--secondary {hot|cold}] volume
Options for the volcreate command
Option
Description
-G diskgroup
Name of the disk group containing the volume.
-s size
Size of the volume to be created in units of K, M, G, or T. The unit designation must be appended to the number specified. No space is allowed. For example: 200M or 20G
--column number
Number of columns in a stripe set. Values range from 1 to 8. The default value is 4.
--width stripe
Stripe width of a volume. The value can range from 4 KB to 1 MB, at power-of-two intervals, with a default of 128 KB.
--redundancy {high|mirror|unprotected}
Redundancy of the Oracle ADVM volume which can be specified for normal redundancy disk groups. The range of values is as follows: unprotected for non-mirrored redundancy, mirror for double-mirrored redundancy, or high for triple-mirrored redundancy. If redundancy is not specified, the setting defaults to the redundancy level of the disk group.
--primary {hot|cold}
Intelligent Data Placement specification for primary extents, either hot or cold region.
--secondary {hot|cold}
Intelligent Data Placement specification for secondary extents, either hot or cold region.
volume
Name of the volume. Only alphanumeric characters are allowed; hyphens are not allowed. The first character must be alphabetic.

Examples
The following is an example of the volcreate command that creates volume1 in the data disk group with the size set to 10 gigabytes.
Example Using the ASMCMD volcreate command
ASMCMD [+] >  volcreate -G data -s 10G --width 64K --column 8 volume1

ASMCMD [+] > volinfo -G data volume1
Diskgroup Name: DATA

         Volume Name: VOLUME1
         Volume Device: /dev/asm/volume1-123
         State: ENABLED
         Size (MB): 10240
         Resize Unit (MB): 64
         Redundancy: MIRROR
         Stripe Columns: 8
         Stripe Width (K): 64
         Usage:
         Mountpath:


voldelete
Purpose
Deletes an Oracle ADVM volume.
Syntax and Description

voldelete -G diskgroup volume
Options for the voldelete command
Option
Description
-G diskgroup
Name of the disk group containing the volume.
volume
Name of the volume.

Using the ASMCMD voldelete command
ASMCMD [+] > voldelete -G data volume1

voldisable
Purpose
Disables Oracle ADVM volumes in mounted disk groups and removes the volume device on the local node.
Syntax and Description

voldisable { -a | -G diskgroup -a | -G diskgroup volume }
Options for the voldisable command
Option
Description
-a
When used without a disk group name, specifies all volumes within all disk groups.
When used with a disk group name (-G diskgroup -a), specifies all volumes within that disk group.
-G diskgroup
Name of the disk group containing the volume.
volume
Name of the volume.

Using the ASMCMD voldisable command
ASMCMD [+] > voldisable -G data volume1

volenable
Purpose
Enables Oracle ADVM volumes in mounted disk groups.
Syntax and Description

volenable { -a | -G diskgroup -a | -G diskgroup volume }
Options for the volenable command
Option
Description
-a
When used without a disk group name, specifies all volumes within all disk groups.
When used with a disk group name (-G diskgroup -a), specifies all volumes within that disk group.
-G diskgroup
Name of the disk group containing the volume.
volume
Name of the volume.

Using the ASMCMD volenable command
ASMCMD [+] > volenable -G data volume1

volinfo
Purpose
Displays information about Oracle ADVM volumes.
Syntax and Description

volinfo { -a | -G diskgroup -a | -G diskgroup volume }
volinfo {--show_diskgroup |--show_volume} volumedevice
Options for the volinfo command
Option
Description
-a
When used without a disk group name, specifies all volumes within all disk groups.
When used with a disk group name (-G diskgroup -a), specifies all volumes within that disk group.
-G diskgroup
Name of the disk group containing the volume.
volume
Name of the volume.
--show_diskgroup
Returns only the disk group name. A volume device name is required.
--show_volume
Returns only the volume name. A volume device name is required.
volumedevice
Name of the volume device.
Using the ASMCMD volinfo command
ASMCMD [+] > volinfo -G data volume1
Diskgroup Name: DATA
         Volume Name: VOLUME1
         Volume Device: /dev/asm/volume1-123
         State: ENABLED
         Size (MB): 10240
         Resize Unit (MB): 64
         Redundancy: MIRROR
         Stripe Columns: 8
         Stripe Width (K): 64
         Usage: ACFS
         Mountpath: /u01/app/acfsmounts/acfs1
 
ASMCMD [+] > volinfo -G data -a
Diskgroup Name: DATA
         Volume Name: VOLUME1
         Volume Device: \\.\asm-volume1-311
         State: ENABLED
         Size (MB): 1024
         Resize Unit (MB): 32
         Redundancy: MIRROR
         Stripe Columns: 4
         Stripe Width (K): 128
         Usage: ACFS
         Mountpath: C:\oracle\acfsmounts\acfs1

volresize
Purpose
Resizes an Oracle ADVM volume.
Syntax and Description

volresize -G diskgroup -s size [ -f ] volume
Options for the volresize command
Option
Description
-G diskgroup
Name of the disk group containing the volume.
-f
Forces the shrinking of a volume that is not an Oracle ACFS volume and suppresses any warning message.
volume
Name of the volume.
-s size
New size of the volume in units of K, M, G, or T.

Using the ASMCMD volresize command
ASMCMD [+] > volresize -G data -s 20G volume1

volset
Purpose
Sets attributes of an Oracle ADVM volume in mounted disk groups.
Syntax and Description

volset -G diskgroup [ --usagestring string]
        [--mountpath mount_path ]
        [--primary {hot|cold}] [--secondary {hot|cold}] volume
Options for the volset command
Option
Description
-G diskgroup
Name of the disk group containing the volume.
--usagestring string
Optional usage string to tag a volume which can be up to 30 characters. This string is set to ACFS when the volume is attached to an Oracle ACFS file system and should not be changed.
--mountpath mount_path
Optional string to tag a volume with its mount path string which can be up to 1024 characters. This string is set when the file system is mounted and should not be changed.
--primary {hot|cold}
Intelligent Data Placement specification for primary extents, either hot or cold region.
--secondary {hot|cold}
Intelligent Data Placement specification for secondary extents, either hot or cold region.
volume
Name of the volume.

Using the ASMCMD volset command
ASMCMD [+] > volset -G data --usagestring 'no file system created' volume1

volstat
Purpose
Reports I/O statistics for Oracle ADVM volumes.
Syntax and Description

volstat [-G diskgroup] [volume]

Options for the volstat command
Option
Description
-G diskgroup
Name of the mounted disk group containing the volume.
volume
Name of the volume.

The following apply when using the volstat command.
  • If the disk group is not specified and the volume name is specified, all mounted disk groups are searched for the specified volume name.
  • If the disk group name is specified and the volume name is omitted, all volumes are displayed for the named disk group.
  • If both the disk group name and the volume name are omitted, all volumes on all disk groups are displayed.
Using the ASMCMD volstat command
ASMCMD [+] > volstat -G data
DISKGROUP NUMBER / NAME:  1 / DATA
---------------------------------------
  VOLUME_NAME
     READS           BYTES_READ      READ_TIME       READ_ERRS 
     WRITES          BYTES_WRITTEN   WRITE_TIME      WRITE_ERRS
  -------------------------------------------------------------
  VOLUME1
     10085           2290573312      22923           0
     1382            5309440         1482            0
                        

No comments:

Post a Comment