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.
|
Creates an Oracle ADVM
volume in the specified disk group.
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.
|
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:
Deletes an Oracle ADVM
volume.
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
Disables Oracle ADVM
volumes in mounted disk groups and removes the volume device on the local node.
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
Enables Oracle ADVM
volumes in mounted disk groups.
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
Displays information
about Oracle ADVM volumes.
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
Resizes an Oracle ADVM
volume.
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
Sets attributes of an
Oracle ADVM volume in mounted disk groups.
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
Reports I/O statistics
for Oracle ADVM volumes.
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
