Shell Commands › Volume Management › import (Volume Management)--Import Volume

import (Volume Management)--Import Volume

Import a volume to an application

Syntax

vol import name image file [prop=val]* [--overwrite[--force]] [ -n]  

Parameters

name

Name of the volume to import. The format of name is the following:

application:[class.]volume - application user volume or application singleton class volume

_GLOBAL:volume - global volume

_GLOBAL_RO:volume - global read-only volume

image file

Name of the volume image residing within the root directory of the /vol/_impex folder or a URL in the following format: http://path.

Compressed image files should have a .gz extension. If the image file does not have a .gz extension, then it is assumed that the image is not compressed.

prop=val

Volume parameters. The following parameters may be set:

size - optional volume size, units may be specified (for example, 128M[B], 2G[B]). If units are not specified, it is assumed that the value is in MB.

This parameter is useful when importing large compressed images so that the image does not have to be downloaded and uncompressed twice (once to determine the size of the actual image and once for the actual import operation).

comment - (optional) volume comment

mirrored - (optional) volume is mirrored

user - (optional) user name to use for authentication when importing the volume from a URL. If not specified, then it is assumed that there is no authentication.

pwd=- - (Optional) Prompt for password to use for authentication purposes when importing the volume from a URL. If the standard input is not a terminal device, it will not print a prompt and expect only one copy of the password on 'stdin' (this can be used for batch operations, to set the password from a file).

--overwrite

Overwrite existing volume.

--force

Do not prompt for confirmation of overwrite

-n

Skip verification that volume reference is in the class descriptor if adding an application singleton class volume.

Examples

vol import myapp:myvol myvol.img.gz size=1G

import an application user volume stored from the impex volume and specify a size so that the image does not have to be downloaded and uncompressed twice (see note below).

vol import myapp:myclass.cdrom os.iso

import an operating system ISO image to an application singleton class volume from the impex volume.

vol import myapp:myclass.cdrom http://mydomain.com/os.iso

import an operating system ISO image to an application singleton class volume from a URL.

Notes:

• A specification of the naming convention for CA 3Tera AppLogic entities can be found here.
• Only maintainers may import a global read-only volume.
• The volume size should be specified when importing a compressed volume from a URL. If a volume size is not specified, the image is essentially downloaded and uncompressed twice - once to get the uncompressed size and once to transfer the actual data.
• If the --overwrite option is specified, the existing volume and the volume to be imported must be the same size.
• The volume size should be specified when importing a compressed volume from a URL. If a volume size is not specified, the image is essentially downloaded and uncompressed twice - once to get the uncompressed size and once to transfer the actual data.

If the volume image is compressed, it is advisable to specify the size argument so that the image file does not have to be downloaded and uncompressed twice (once to determine the size of the actual image and once for the actual import operation).