Home > Veritas Storage Foundation™ for DB2 Manual Pages

DBDST_ADDVOL (1)

User Commands

Table of contents


NAME

dbdst_addvol - add a new volume to DBDST ready Filesystem.

SYNOPSIS

dbdst_addvol -D DB2DATABASE \[ -I DB2INSTANCE -M mount_device

     -v vol:class,vol:class,


AVAILABILITY

This command is part of Veritas Storage Foundation for DB2. To determine whether this product is installed on an \1 system, type:

lslpp -L VRTSdb2ed


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:
.\" $Id: dbdst_options.inc,v 1.1 2006/02/16 01:33:08 susanl Exp $
-D DB2DATABASE Specifies the name of the DB2 database for which information will be retrieved.
-I DB2INSTANCE
Specifies the name of the DB2 instance. If the instance is not specified, the current user will be used as the instance name.
-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 -D PROD -M  /dev/vx/dsk/db2dg/arch   -v new_vol1:GOLD,new_vol2:GOLD

NOTES

This command must be run as DB2 instance owner. This command can be executed when the database is online. db2ed_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.


ENVIRONMENT

Please set LIBPATH to include /opt/VRTSdbms3/lib32


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

SEE ALSO

dbdst_classify(1M), dbdst_admin(1M), dbdst_convert(1M), dbdst_file_move(1M), dbdst_fstat(1M), dbdst_makelbfs(1M), dbdst_partition_move(1M), dbdst_preset_policy(1M), dbdst_report(1M), dbdst_rmvol(1M), dbdst_show_fs(1M), dbdst_tbs_move(1M), db2_edition(7)

Veritas Storage Foundation for DB2 Administrator's Guide

Last updated: 15 Jan 2006
Copyright ©2009 Symantec Corporation
All rights reserved.