Oracle® Secure Backup Reference Release 10.1 Part Number B14236-03 |
|
|
View PDF |
Purpose
Use the importvol
command to move one or more volumes from the import/export mechanism of a library to storage elements. This command is supported only for libraries that have import/export slots.
The importvol
command differs from the movevol command in the following ways:
The library manager determines the destination storage elements to be used.
Tapes can be identified during the move.
A single command can move multiple tapes.
See Also:
"Library Commands" for related commandsPrerequisites
You must have the right to manage devices and change device state to use the importvol
command.
Syntax
importvol::=
imp•ortvol [ --library/-L libraryname | --drive/-D drivename ] [ --identify/-i | --import/-m | --unlabeled/-u ] [ --obtaropt/-o obtar-option ]... iee-range
Semantics
Specifies the name of the library into which tapes are to be imported. If a library is specified, all empty storage elements in the library are valid destinations. If there are insufficient destinations to fulfill the request, obtool
reports that the command could not be fully executed.
If you do not specify --library
or --drive
, then Oracle Secure Backup uses the value of the library or drive variable. Oracle Secure Backup issues a warning if it can obtain neither the library nor drive setting.
Specifies the name of a tape drive in the library into which tapes are to be imported. If a drive is specified, valid destinations are limited to the storage elements in the drive's use list.
If you do not specify --library
or --drive
, then Oracle Secure Backup uses the value of the library or drive variable. Oracle Secure Backup issues a warning if it can obtain neither the library nor drive setting.
Reads the volume label on each volume. This option is equivalent to executing the identifyvol command. This option requires specification of a tape drive.
Reads each backup image label on each volume. You can use this option if you are importing volumes from another administrative domain. This option requires specification of a tape drive.
Marks each imported volume as unlabeled. You cannot specify this option in conjunction with --identify
or --import
.
Note:
This option does not actually unlabel the volumes. It is equivalent to an insertvolunlabeled
command.Specifies obtar
options that are passed to obtar
when the volumes are read. For example -J
enables debug mode and provides more details in backup and restore transcripts. See the section entitled "obtar Options" for details on obtar
options. This option is effective only for the --identify
and --import
options.
Specifies a range of import/export elements containing the volumes to be imported. Refer to "iee-range" for acceptable values for iee-range
.
Example
Example 2-39 imports volumes from import elements iee1
, iee2
, and iee3
into tape library lib2
.
Example 2-39 Importing Volumes
ob> lsvol --long --library lib2 Inventory of library lib2: in mte: vacant in 1: vacant in 2: vacant in 3: vacant in 4: vacant in iee1: volume VOL000003, barcode DEV423, oid 111, 47711360 kb remaining, lastse 1 in iee2: unlabeled, barcode DEV424, oid 114, lastse 1 in iee3: unlabeled, barcode DEV425, oid 115, lastse 2 in dte: vacant ob> importvol --library lib2 iee1-3 ob> lsvol --long --library lib2 Inventory of library lib2: in mte: vacant in 1: volume VOL000003, barcode DEV423, oid 111, 47711360 kb remaining in 2: unlabeled, barcode DEV424, oid 114 in 3: unlabeled, barcode DEV425, oid 115 in 4: vacant in iee1: vacant in iee2: vacant in iee3: vacant in dte: vacant