test veritas logo


dbdst_addvol(1M)

NAME

dbdst_addvol - add a new volume to DBDST ready Filesystem.

SYNOPSIS

dbdst_addvol -S ORACLE_SID -M mount_device
     -v vol:class,vol:class,...

AVAILABILITY

Veritas Storage Foundation. To determine whether this product is installed on a Linux system, enter:

rpm -qa | grep VRTSdbed

DESCRIPTION

The dbdst_addvol command is used to grow an existing DBDST ready MVS filesystem by adding a new volume to the filesystem. DBA need to specify storage_class to which the new volume belongs to. This command adds the new volumes to the volume set, which is specified by the mount_device, then add the volumes to the filesystem. It also classifies the volumes to the desired class. The filesystem should be mounted and the new volumes being added should be already created when this command is executed. The new volumes should be owned by the user executing the command. If a chunksize is defined for the storage class, then the existing DST policy will be enforced for the filesystem. This command can be executed when database is online.

OPTIONS

The following options are supported:
-S ORACLE_SID
  Specifies the name of the Oracle database whose information will be retrieved.
-M mount_device
  Specifies the block device where the file system resides. This should be of the form /dev/vx/dsk/<dgname>/<vsetname>
-v vol:class,vol:class
  Specifies a comma separated list of vol:class pairs which indicate the new volume name and the storage class it belongs to. The volume specifiled by vol should be already created by sysadmin and should be owned by the user executing the command. The storage_class specified by the class must be registered earlier using dbdst_admin comand.

Real Application Clusters (RAC) Considerations

This command is supported in a RAC environment. This command can be run on any node of the RAC.

EXAMPLES

This example shows how to add two new volumes new_vol1 and new_vol2 to storage class GOLD for a filesystem on device /dev/vx/dsk/oradata/arch.


$ /opt/VRTS/bin/dbdst_addvol -S PROD -M /dev/vx/dsk/oradata/arch -v new_vol1:GOLD,new_vol2:GOLD

NOTES

This command must be run as Oracle DBA user. This command can be executed when the database is online.

dbed_update must be run at least once before this command to ensure an up-to-date repository.

dbdst_admin must be run at least once before this command to ensure storage class is registered.

The mount_device must be converted to DBDST filesystem using dbdst_convert command before this command.

If the datbabase is configured for flashsnap, make sure the snapshots are resynced before running this command.

EXIT STATUS

0 Command executed successfully.
1 An Error Occured.
101 Licence check failed.
102 No license to execute this command.
103 Invalid Storage Class
104 The device or mount point is not owned by user
105 Could not get information from Oracle Database
255 Could not load program.

SEE ALSO

RAC is not supported with some SF products/configurations. For details please refer to the Veritas Storage Foundation: Storage and Availability Management for Oracle Databases Guide

dbdst_classify(1M), dbdst_admin(1M), dbdst_convert(1M), dbdst_file_move(1M), dbdst_partition_move(1M), dbdst_preset_policy(1M), dbdst_report(1M), dbdst_rmvol(1M), dbdst_show_fs(1M), dbdst_tbs_move(1M), dbdst_obj_move(1M), dbdst_obj_view(1M), oracle_edition(7)

Veritas Storage Foundation: Storage and Availability Management for Oracle Databases


SF for Oracle dbdst_addvol(1M)