Tivoli Storage Manager for HP-UX Administrator's Reference

DEFINE VOLUME (Define a Volume in a Storage Pool)

Use this command to assign a random or sequential access volume to a storage pool.

For a random access storage pool, you must use this command to define volumes that create space in the pool. When defining a random access volume, you can have the server create the volume before it is assigned.

For a sequential access storage pool, you create space by defining volumes, by allowing the server to request scratch volumes as needed (the MAXSCRATCH parameter for the storage pool), or by doing both.

Attention: The size of a storage pool volume cannot be changed once it has been defined to the TSM server. If you change the size of TSM volumes by extending raw logical volumes or otherwise altering the file sizes of TSM volumes, the server may not initialize correctly and data could be lost.

Privilege Class

To issue this command, you must have system privilege, unrestricted storage privilege, or restricted storage privilege for the storage pool to which the volume is assigned.

Syntax

>>-DEFine Volume--pool_name--volume_name------------------------>
 
      .-ACCess--=--READWrite--------.
>-----+-----------------------------+--------------------------->
      '-ACCess--=--+-READWrite----+-'
                   +-READOnly-----+
                   +-UNAVailable--+
                   |         (1)  |
                   '-OFfsite------'
 
>-----+--------------------------------------------------------+>
      |            (2)                   .-WAIT--=--No------.  |
      '-Formatsize-------=--megabytes----+------------------+--'
                                         '-WAIT--=--+-No--+-'
                                                    '-Yes-'
 
>-----+-----------------------------+--------------------------><
      |          (3)                |
      '-LOcation-------=--location--'
 

Notes:

  1. This value is valid only for volumes assigned to copy storage pools.

  2. This parameter is valid only for random access volumes.

  3. This parameter is valid only for sequential access volumes.

Parameters

pool_name (Required)
Specifies the name of the storage pool to which the volume is assigned.

volume_name (Required)
Specifies the name of the storage pool volume to be defined. The volume name that you can specify depends on the type of device that the storage pool uses. See the following table.
Device Type Volume Name Requirements Example
DISK

A regular file name, or if you are using a raw logical volume, a character special file. A regular file name can be either a fully qualified path name or a path name relative to the current working directory.

Attention: The server cannot always detect if data already exists on a raw logical volume. Existing data can be destroyed if you define a TSM volume to that logical volume.

A regular file name with a fully qualified path name:

/storage/sbkup01.dsm

A character mode special file is entered in the format:

/dev/vg/rxxx

where vg is the volume group name and xxx is the logical volume name. For example:

/dev/groupa/rdsa

FILE The name of the file to contain the volume data, with either the fully qualified path name or the path name relative to the directory identified in the DIRECTORY parameter for the device class
/data/fpool01.dsm

Tape 1-6 alphanumeric characters

The server converts volume names to uppercase.

DSMT01

Optical 1-32 alphanumeric characters

The server converts volume names to uppercase.

DSM_SP001

REMOVABLEFILE 1-6 alphanumeric characters

The server converts volume names to uppercase.

DSM01

Note:Volume names cannot contain embedded blanks or equal signs.

 

ACCess
Specifies how client nodes and server processes (such as migration) can access files in the storage pool volume. This parameter is optional. The default value is READWRITE. Possible values are:

READWrite
Specifies that client nodes and server processes can read from and write to files stored on the volume.

READOnly
Specifies that client nodes and server processes can only read files stored on the volume.

UNAVailable
Specifies that neither client nodes nor server processes can access files stored on the volume.

If you define a random access volume as UNAVAILABLE, you cannot vary the volume online.

If you define a sequential access volume as UNAVAILABLE, the server does not attempt to access the volume.

OFfsite
Specifies that the volume is at an offsite location from which it cannot be mounted. You can specify this value only for volumes in copy storage pools.

Use this value to help you track volumes at offsite locations. The server treats volumes designated as offsite differently:

  • The server does not generate mount requests for volumes designated offsite
  • The server reclaims or moves data from offsite volumes by retrieving files from other storage pools
  • The server does not automatically delete empty, offsite scratch volumes from a copy storage pool

LOcation
Specifies the location of the volume. This parameter is optional. It can be specified only for volumes in sequential access storage pools. The location information can be a maximum length of 255 characters. Enclose the location in quotation marks if it contains any blank characters.

Formatsize
Specifies the size of the random access volume that is created and formatted in one step. This parameter is optional and valid only for DISK volumes. The value is specified in megabytes. Unless WAIT=YES is specified, the operation is performed as a background process.

If you do not use this parameter, you must use the DSMFMT utility to create a file for a volume before defining the volume.

Wait
Specifies whether a random access volume creation and formatting operation is performed in the foreground or background. This parameter is optional. It is ignored unless you also specify the format size parameter.

No
Specifies that a volume creation and formatting operation is performed in the background. This is the default when you also specify a format size.

Yes
Specifies that a volume creation and formatting operation is performed in the foreground.
Note:You cannot specify WAIT=YES from the server console.

Examples

Task 1

Create a new volume of 100MB in the disk storage pool named BACKUPPOOL. The volume name is /var/storage/bf.dsm. Let the volume be created as a background process.

Command:
define volume backuppool 
/var/storage/bf.dsm formatsize=100

Task 2

A storage pool named POOL1 is assigned to a tape device class. Define a volume named TAPE01 to this storage pool, with READWRITE access.

Command:
define volume pool1 tape01 access=readwrite

Task 3

A storage pool named FILEPOOL is assigned to a device class with a device type of FILE. Define a volume named filepool_vol01 to this storage pool.

Command:
define volume filepool /usr/storage/filepool_vol01

Related Commands

Table 73. Commands Related to DEFINE VOLUME

Command Description
DEFINE STGPOOL Defines a storage pool as a named collection of server storage media.
DELETE VOLUME Deletes a volume from a storage pool.
QUERY VOLUME Displays information about storage pool volumes.
UPDATE VOLUME Updates the attributes of storage pool volumes.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]