Previous Topic: export (Volume Management)--Export VolumeNext Topic: Catalog Management

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

import (Volume Management)--Import Volume

Import a volume into an application (application or singleton class volume) or import a global volume.

Syntax 
vol import name image file [prop=val]* [--overwrite[--force]] [ -n]  
vol import name local_ip=local remote_ip=remote
                         migrating_class=class encr_key=encr_key
                         [ <prop>=<val> ]* [ --overwrite [ --force]] [ -n ]
vol import name --abort
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 must 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 - volume size (recommended when importing a compressed volume from a URL). Units may be specified (e.g., 128M[B], 2G[B]). If units are not specified, it is assumed that the value is in MB. This parameter must be specified when importing a volume using a migrating class.

fs - Filesystem type. This parameter must be specified when importing a volume using a migrating class.

fs_options - Additional filesystem options used to format the volume (See notes below for specifics).

comment - (optional) volume comment

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).

local

IP information to be used for the migrator application on the local grid. The value has the following format:

                     [_vlan.][<vlan id>.]<ip address> | _net.<network name>.<ip_address>
remote

IP information to be used for communicating with the the migrator application on the remote grid. The value has the following format:

                     [_vlan.][<vlan id>.]<ip address> | _net.<network name>.<ip_address>
class

Specifies the assembly to use in building the local migrator application. This class may be from a catalog or application. If class is "default" or migrating_class not specified then "Filer_Linux_ADMI" will be used to do a file system levelcopy.

encr_key

Specifies the volume containing fixed encryption keys to be supplied to the migrating application. This argument is required only when migration is between two grids.

--abort

Abort a volume import operation. This option is only valid when importing a volume using a migrating class.

--overwrite

Overwrite existing volume.

--force

Do not prompt for confirmation of volume overwrite

-n

Skip verification that a volume reference is in the class descriptor if importing 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 size-2G

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

vol import _GLOBAL:my-iso http://mysrv.com/os.iso size=2G

import an ISO image into a global volume from an HTTP server that does not require authentication..

Notes: