insertvol

用途

insertvolコマンドは、ライブラリ内の指定バックアップ先にボリュームを手動で挿入したことをOracle Secure Backupに通知し、挿入したボリュームのプロパティを指定する場合に使用します。Oracle Secure Backupにより、インベントリが、指定した情報で更新されます。

関連項目:

関連コマンドについては、「ライブラリ用コマンド」を参照してください。

前提条件

insertvolコマンドを使用するには、デバイスの管理およびデバイスの状態変更（manage devices and change device state）権を備えている必要があります。

構文

構文1

次の構文は、不明かまたはラベルがないボリュームやクリーニング・テープを挿入したことを指定する場合に使用します。「構文1の意味」を参照してください。

insertvol::=

ins•ertvol [ --library/-L libraryname | --drive/-D drivename ]
{ unknown | unlabeled | clean --uses/-u n --maxuses/-m n }
se-range

構文2

次の構文は、既知かまたはラベル付きのボリュームを挿入したことを指定する場合に使用します。「構文2の意味」を参照してください。

insertvol::=

ins•ertvol [ --library/-L libraryname | --drive/-D drivename ]
{ vol-spec } se-spec

意味

構文1の意味

次のオプションにより、不明かまたはラベルがないボリュームやクリーニング・テープを挿入できます。

--library/-L libraryname

1つ以上のボリュームを挿入するライブラリの名前を指定します。

--libraryまたは--driveを指定しない場合は、libraryまたはdrive変数の値が使用されます。これらのいずれの変数値も取得できない場合は、警告が発行されます。

--drive/-D drivename

1つ以上のボリュームを挿入するライブラリにあるテープ・ドライブの名前を指定します。

unknown

挿入するボリュームのフォーマットが不明であることを示します。

unlabeled

挿入するボリュームにラベルがないかまたはそのボリュームが新しいボリュームであることを示します。

clean

挿入するボリュームがクリーニング・テープであることを示します。このオプションは、--usesや--maxusesオプションと組み合せて指定する必要があります。

--uses/-u n

クリーニング・テープの使用された回数を指定します。

--maxuses/-m m

クリーニング・テープを使用できる最大回数を指定します。クリーニング・テープの残りの使用回数は、--maxusesから--usesを差し引いた差です。

se-range

ボリュームが挿入された記憶域要素の範囲を指定します。se-rangeプレースホルダの詳細は、「se-range」を参照してください。

構文2の意味

次のオプションにより、ラベル付きまたは既知のボリュームを挿入できます。

vol-spec: 挿入するボリュームのボリュームIDを指定します。vol-specプレースホルダの詳細は、「vol-spec」を参照してください。
se-spec: ボリュームを挿入した記憶域要素を指定します。se-specプレースホルダの詳細は、「se-spec」を参照してください。

例

例2-40では、ライブラリlib1の記憶域要素2にクリーニング・テープを挿入したことをOracle Secure Backupに通知します。サンプル出力はページに収まるようにあらかじめ折り返されています。

例2-40 Oracle Secure Backupへの手動によるボリューム挿入の通知

ob> lsvol --library lib1 --long
Inventory of library lib1:
    in    mte:           vacant
    in    1:             volume VOL000001, barcode ADE201, oid 102, 48359360 kb
                         remaining
    in    2:             vacant
    in    3:             volume RMAN-DEFAULT-000002, barcode ADE202, oid 112,
                         47773408 kb remaining, content manages reuse
    in    4:             vacant
    in    iee1:          vacant
    in    iee2:          vacant
    in    iee3:          vacant
    in    dte:           vacant
ob> insertvol --library lib1 clean --uses 0 --maxuses 3 2
ob> lsvol --library lib1 --long
Inventory of library lib1:
    in    mte:           vacant
    in    1:             volume VOL000001, barcode ADE201, oid 102, 48359360 kb
                         remaining
    in    2:             barcode ADE203, cleaning tape: 0 uses, 3 remaining
    in    3:             volume RMAN-DEFAULT-000002, barcode ADE202, oid 112,
                         47773408 kb remaining, content manages reuse
    in    4:             vacant
    in    iee1:          vacant
    in    iee2:          vacant
    in    iee3:          vacant
    in    dte:           vacant