migrate2osb

用途

migrate2osbツールは、データベース・バックアップをLegato Storage ManagerおよびLegato Single Server VersionからOracle Secure Backupに移行する場合に使用します。

Legato Storage ManagerおよびLegato Single Server Versionを総称してLegatoと呼びます。LegatoからOracle Secure Backupへのデータベース・バックアップの移行を想定していますが、このツールは、データベース・バックアップをサポートされるメディア管理ソフトウェアからOracle Secure Backupに移行する場合にも使用できます。

注意:

migrate2osbは、Oracle Secure Backupの標準インストールに付属していません。次のURLからダウンロードしてください。

http://www.oracle.com/technology/products/secure-backup

前提条件

次の前提条件に注意してください。

このツールは、Oracle Database 10gリリース2（10.2）、Oracle Secure Backup 10.3およびRecovery Manager（RMAN）と互換性があるメディア・マネージャと互換性があります。
migrate2osbがデータベースを識別するのに必要な環境変数ORACLE_HOME、ORACLE_SIDおよびPATHを設定する必要があります。

使用方法

migrate2osbツールは、次の相互排他モードで動作できます。

表示のみ
リストアのみ
バックアップのみ
リストアおよびバックアップ

LegatoとOracle Secure Backupの両方を同時に実行するのに十分なリソースがない場合は、バックアップを2段階で移行する必要があります。十分なリソースがある場合は、リストアおよびバックアップ・モードを使用して1段階で移行できます。

表示のみ

このモードでは、テープ上のLegatoバックアップが表示されます。--displayオプションを指定すると、ユーティリティはこのモードで実行されます。

リストアのみ

このモードでは、Legatoからディスクへのファイルのリストアのみが実行されます。--backupではなく--restoreオプションを指定すると、ユーティリティはこのモードで実行されます。

バックアップのみ

このモードでは、ディスクからOracle Secure Backupへのファイルのバックアップのみが実行されます。--restoreではなく--backupオプションを指定すると、ユーティリティはこのモードで実行されます。

リストアおよびバックアップ

このモードでは、バックアップが、まずLegatoからディスクにリストアされ、次にOracle Secure Backupにバックアップされます。--directoryオプションによってステージング領域が指定されます。このユーティリティは、--sizeオプションによってサイズを制御されるファイルのバッチ単位で移行を実行します。--backupと--restoreの両方のオプションを指定すると、ユーティリティはこのモードで実行されます。

構文

migrate2osb {
[ --restore/-r
  { all | specific | date { [ --fromdate/-f date ] [ --todate/-t date ] } }
  { --mmparms/-m media_management_parameters }
  { --directory/-d staging_directory_name }
  [ --size/-s staging_directory_size ] ]
[ --backup/-b --osbparms/-o osb_parameters ] |
[ --display/-y { --mmparms/-m media_manager_parameters } ]
}

意味

--restore/-r

Legatoから--directoryオプションによって指定されたディレクトリにバックアップ・ピースをリストアします。restore_typeプレースホルダには、次のいずれかの値を使用します。

all

Legatoを使用してバックアップされたすべてのピースを、使用可能なディスク領域に基づいてリストアします。
specific

Legatoによってバックアップされたすべてのバックアップ・ピースを表示し、リストアするピースを指定するよう求めます。
date

--fromdateおよび--todateによって指定された期間内にバックアップされたピースをリストアします。

--fromdate date

指定の日付以降に作成されたバックアップ・ピースのみをリストアします。デフォルトでは、最初のバックアップ・ピースからすべてのバックアップ・ピースがリストアされます。

--todate date

指定の日付以前に作成されたバックアップ・ピースのみをリストアします。デフォルトでは、最後のバックアップ・ピースまでのすべてのバックアップ・ピースがリストアされます。

--mmparms media_management_parameters

Legatoバックアップをリストアまたは表示するのに必要なメディア管理パラメータを指定します。これらのパラメータは、Legatoで使用したRMAN ALLOCATE CHANNELコマンドで使用されたパラメータと同一である必要があります。

たとえば、次のLegatoテープ・ライブラリをRMANスクリプトに指定するとします。

ALLOCATE CHANNEL t1 DEVICE TYPE sbt
  PARMS 'SBT_LIBRARY=/opt/nsr/libnwora.so'

--mmparmsは、次のようにmigrate2osbに設定できます。

migrate2osb --restore all
  --mmparms 'SBT_LIBRARY=/opt/nsr/libnwora.so' --directory /tmp

--directory/-d staging_directory_name

RMANバックアップ・ピースに対するディスク上のステージングの場所を指定します。このオプションは、--restoreまたは--backupを指定する場合に必須です。

--size/-s staging_directory_size

移行に使用できるディスク領域の量を指定します。staging_directory_sizeは、nB （nバイト）、nK（nKB）、nG（nGB）、nT（nTB）の形式で指定します。デフォルトでは、サイズはバイト単位とみなされます。

--sizeオプションは、--backupと--restoreの両方が指定された場合にのみ機能します。デフォルトでは、Oracle Secure Backupへのバックアップの開始前に、ディスクへの必要なバックアップ全部のリストアが試行されます。

指定されたサイズがリストア対象のバックアップをすべて保存するのに必要な容量を下回る場合、移行はバックアップ・ピースのバッチ単位で行われます。各バッチのサイズは、指定されたサイズを超えません。1つのファイルが指定されたサイズを超える場合は、メッセージが表示され、このファイルはリストアされません。すべてのファイルが指定されたサイズを超える場合は、エラーが表示され、migrate2osbは終了します。

--backup/-b

--directoryオプションによって指定されたディレクトリのバックアップ・ピースをOracle Secure Backupにリストアします。

--osbparms/-p osb_parameters

ステージングされたファイルをOracle Secure Backupにバックアップするのに必要なメディア管理パラメータを指定します。これらのパラメータは、Oracle Secure Backupで使用するRMAN ALLOCATE CHANNELコマンドで使用されるパラメータと同一である必要があります。

たとえば、次のOracle Secure Backupテープ・ライブラリをRMANスクリプトに指定するとします。

ALLOCATE CHANNEL t1 DEVICE TYPE sbt
  PARMS 'SBT_LIBRARY=usr/local/oracle/backup/lib/libobk.so'

--osbparmsは、次のようにmigrate2osbに設定できます。

migrate2osb --directory /tmp
  --backup --osbparms 'SBT_LIBRARY=usr/local/oracle/backup/lib/libobk.so'

--display/-y

Legatoのバックアップ・ピースの詳細なリストを表示します。

例

例A-3 リストアおよびバックアップ・モードでのLegatoバックアップの移行

この例では、2008年11月10日から12月10日の間に作成されたLegatoバックアップをOracle Secure backupに移行しています。また、ディレクトリ/tmpにファイルをステージングし、最大サイズを10GBに設定しています。このコマンドでは、LegatoとOracle Secure backupの両方に対するメディア管理パラメータを指定しています。

migrate2osb
  --restore date --fromdate '10/nov/08' --todate '10/dec/08'
  --mmparms 'SBT_LIBRARY=/opt/nsr/libnwora.so'
  --directory /tmp --size 10G
  --backup --osbparms 'SBT_LIBRARY=/usr/local/oracle/backup/lib/libobk.so'