バックアップとリストア

外部バックアップ

外部バックアップは、現時点でデータベース全体のバックアップに推奨される最適な方法です。外部バックアップは、既存のシステム・バックアップ手順に簡単に統合でき、通常はダウンタイムなしでバックアップできることを見越しておけます。外部バックアップは主に、論理ディスク・ボリュームの有効な “スナップショット” を迅速に作成するテクノロジと共に使用します。このようなテクノロジは、ストレージアレイからオペレーティング・システム、ディスクの単純なミラーリングに至るまで、さまざまなレベルで存在します。このセクションでは、スナップショット・テクノロジが使用できないシステムに関する特別な考慮事項についても説明します。

スナップショットの整合性を確保するために、InterSystems IRIS には、スナップショットの作成中にデータベースへの書き込みをフリーズする方法があります。スナップショットの作成中は、データベース・ファイルへの物理的な書き込みのみがフリーズされ、ユーザ・プロセスによるメモリ内の更新は引き続き実行できます。このスナップショットは通常、システムで使用中のファイル・システムすべてのスナップショットになります。このスナップショットには、少なくとも InterSystems IRIS データベースが使用するすべてのディレクトリが何らかの形で収録されています。このディレクトリには、インストール・ディレクトリ、データベース・ディレクトリ、ジャーナル・ディレクトリおよび代替ジャーナル・ディレクトリ、WIJ ディレクトリ、システムで使用する外部ファイルを格納したあらゆるディレクトリなどがあります。書き込みができるようになったら、スナップショットをバックアップすることができます。その後、プロダクションに再結合するか、またはウォーム・バックアップとしてオンラインのままにしておくことができます (使用されている具体的なテクノロジによって異なる)。

以下の表に、外部バックアップ方法のメリットとデメリットを示します。

データベースをフリーズするクラス・メソッドは Backup.General.ExternalFreeze()Opens in a new tab で、フリーズを解除するクラス・メソッドは Backup.General.ExternalThaw()Opens in a new tab です。書き込みの停止に加えて、フリーズする方法では、ジャーナル・ファイルの切り替えやジャーナルへのバックアップ・マーカの書き込みも処理されます。データベースの物理的な書き込みがフリーズされている間も、ジャーナル・ファイルには引き続き正常に書き込まれます。データベースの物理的な書き込みがフリーズしている間にシステムがクラッシュした場合、通常どおり起動時にジャーナルからデータがリカバリされます。

外部バックアップを設定するには、以下の手順を実行するスクリプトを記述します。

1. Backup.General.ExternalFreeze()Opens in a new tab メソッドを使用して、データベースへの書き込みをフリーズします。このメソッドをさまざまなプラットフォームで使用する例が、クラス・ドキュメントに含まれています。

   Note:

   セキュリティ構成で、バックアップ・スクリプトがデータベース資格情報を提供するように求められる場合、必要な資格情報が含まれているファイルから入力をリダイレクトすることにより、これを実行できます。あるいは、OS レベルの認証を有効にし、スクリプトを実行している OS ユーザの InterSystems IRIS アカウントを作成できます。

2. 外部のスナップショット・ユーティリティを使用して、ファイル・システムのスナップショットを作成します。

3. Backup.General.ExternalThaw()Opens in a new tab メソッドを使用して、データベース書き込みを再開します。

   Note:

   Backup.General.ExternalThaw()Opens in a new tab メソッドでライト・デーモンが再開されず、インスタンスのフリーズが解除されない場合、-W オプションを指定して irisstat コマンドOpens in a new tab を発行することで、これを行うことができます (このオプションでは、バックアップ以外が原因で発生したハングまたは一時停止の場合、ライト・デーモンのフリーズは解除されません)。

4. バックアップ・メディアにスナップショットをコピーします。

5. バックアップが完了したら、Backup.General.ExternalSetHistory()Opens in a new tab メソッドを使用して、バックアップをバックアップ履歴に記録できます。これにより、[ジャーナル設定] ページの [ジャーナルファイルを削除するタイミング]→[この回数のバックアップ成功後] の設定 (既定値は 2) によっては、バックアップを記録することでジャーナルの削除がトリガされる可能性があることに注意してください。詳細は、このドキュメントの “ジャーナリング” にある "ジャーナル設定の構成" を参照してください。

これらのメソッドのプラットフォーム固有の例については、"インターシステムズ・クラス・リファレンス" の "Backup.GeneralOpens in a new tab" クラスのドキュメントを参照してください。

スナップショット・テクノロジが使用できないシステムの場合、上記のスナップショットの作成をファイル・システムのコピーに置き換えることにより、外部バックアップ・アプローチで低速のファイル・システム・コピーを使用できます。これは以下のいずれかの方法で実行するか、または必要に応じてオンライン・バックアップを代替手段として使用することができます。

• ダウンタイムの追放 ：Backup.General.ExternalFreeze()Opens in a new tab を呼び出すときに ExternalFreezeTimeOut パラメータの値を指定し、フリーズ中でもデータベースの更新をメモリのバッファに格納できるように、十分なデータベース・キャッシュを構成しておきます。この場合、ユーザは物理的な書き込みがフリーズしている間に、最大で ExternalFreezeTimeOut に指定した値まで操作を続行できます。ジャーナリングは、書き込みがフリーズされている間にシステム・クラッシュが発生した場合に、データが失われないようにするうえで重要です。クラッシュが発生した場合は、通常よりもシステムの起動に時間がかかる可能性があります。[エラー発生時に凍結する] に対するジャーナルの設定は、[はい] に設定する必要があります (詳細は、このドキュメントの “ジャーナリング” の章の "ジャーナル入出力エラー" のセクションを参照)。

• ユーザ操作の停止：フリーズ時間として想定する時間の既定値を 10 分にします。この時間が経過すると、Backup.General.ExternalThaw()Opens in a new tab が呼び出されるまで、ユーザの操作は一時停止状態になります。

オンライン・バックアップ

InterSystems IRIS には、プロダクション・システムのユーザにダウンタイムがほとんど、またはまったく発生しないよう設計された、専用のバックアップ・メカニズムが実装されています。オンライン・バックアップでは、IRIS.DAT ファイルのデータのみがバックアップされ、データベース内でデータに割り当てられているブロックがすべて取得されます。シーケンシャル・ファイルに出力されます。このバックアップ方法は、システム・バックアップと連係させて、オンライン・バックアップの出力ファイルを、他のファイルと共にバックアップ・メディアにコピーする必要があります。このシステム・バックアップには、システムで使用されているすべてのファイル・システム (IRIS.DAT ファイルは除く) を含める必要があります。少なくとも、インストール・ディレクトリ、ジャーナル・ディレクトリと代替ジャーナル・ディレクトリ、Web ゲートウェイ・ファイル、および InterSystems IRIS で使用される外部ファイルを格納したあらゆるディレクトリを含める必要があります。IRIS.DAT ファイルは含めないでください。

オンライン・バックアップ・プロシージャでは、複数のパスを使用してデータがコピーされます。前のパスにある間に変更されたデータ・ブロックのリストがコピーされますが、連続的なパスを経るにつれ、通常、このリストはしだいに小さくなります。一般に、バックアップを完了するには 3 つのパスで十分です。最終パスの期間全体と、先行する各パスにある間の短期間、データベースへの書き込みが停止されます。バックアップの際にデータベースへの物理的な書き込みが一時停止している間も、ユーザ・プロセスによるメモリ内の更新は引き続き実行できます。

今日の外部バックアップ・オプションの機能を考えると、通常は、オンライン・バックアップよりもニーズに合った外部バックアップ・アプローチを見つけることができます。以下の表に、オンライン・バックアップ方法のメリットとデメリットを示します。

オンライン・バックアップには以下の種類があります。これらを組み合わせることによって、バックアップ出力のサイズとバックアップからの回復に要する時間のバランスを調整できます。

• フル・バックアップ — 使用中のすべてのブロックのイメージをバックアップ・メディアに書き込みます。

• 累積バックアップ — 最後のフル・バックアップ以降に変更されたすべてのブロックを書き込みます。以前のフル・バックアップと共に使用する必要があります。

• インクリメンタル・バックアップ — タイプに関係なく最後に行われたバックアップ以降に変更されたすべてのブロックを書き込みます。以前のフル・バックアップと共に使用する必要があります。また、必要に応じてそのフル・バックアップ以降に実行した累積バックアップあるいはインクリメンタル・バックアップも使用します。

オンライン・バックアップを使用する場合は、最初にフル・バックアップを実行する必要があります。累積バックアップおよびインクリメンタル・バックアップ (またはこのいずれか) は、その後で実行できます。

オンライン・バックアップでは、すべてのデータベース・ブロックがインターリーブ方式で 1 つのファイルに書き込まれます。極端に大きいデータをオンライン・バックアップでバックアップした場合、リストアは煩雑になる可能性があります。このような場合は、バックアップ方法の計画時に対応を検討します。

リストア検証プロセスでは、リストアされたデータベースのコピーがオンラインで提供されるため、制約の解消に役立ちます。このバックアップ検証方法は、インクリメンタル・バックアップや累積バックアップにも使用されます。インクリメンタル・バックアップまたは累積バックアップは、それぞれ実行後に直ちに代替サーバにリストアできます。例えば、フル・バックアップを毎週行い、インクリメンタル・バックアップを毎日行う計画を立てたとします。毎日のバックアップそれぞれには、その日に変更されたブロックのみが含まれているので、問題は発生しません。この方法を使用すると、毎日そのインクリメンタル・バックアップを代替サーバにリストアし、リストアされたデータベースの整合性を確認する必要があります。

現在検証中のバックアップをリストアする際は、健全性が確認された最新のバックアップのウォーム・コピーを上書きしないようにする必要があります。また、既存のリストアされたデータベースにインクリメンタル・バックアップをリストアする場合にもこれに注意する必要があります。バックアップが最新で健全性にも問題がないと判定された時点から、それに次の日のインクリメンタル・バックアップまたは累積バックアップを適用するまでの間は、それ以降のインクリメンタル・リストアに失敗した場合に備えて、コピーを保存し、最新の健全なバックアップを常にオンラインで使用できるようにしておく必要があります。リストアしたバックアップで整合性の問題が検出された場合は、そのバックアップを破棄しなければいけません。以降のインクリメンタル・リストアのターゲットに使用することはできません。

オンライン・バックアップからシステムをリストアする場合は、最初に最新のフル・バックアップを、次に最新の累積バックアップを、その後で、その累積バックアップ以降に行ったすべてのインクリメンタル・バックアップをリストアします。

オンライン・バックアップの構成の詳細は、この章の "オンライン・バックアップ設定の構成" を参照してください。オンライン・バックアップの実行の詳細は、この章の "オンライン・バックアップの管理" を参照してください。

コールド・バックアップ

コールド・バックアップとは、データベースが正常にシャットダウンされたときに行われる、システムの外部バックアップのことです。このバックアップは通常、システムで使用されているファイル・システムすべてのバックアップです。このスナップショットには、少なくとも InterSystems IRIS が使用するすべてのディレクトリが何らかの形で収録されています。このディレクトリには、インストール・ディレクトリ、データベース・ディレクトリ、ジャーナル・ディレクトリおよび代替ジャーナル・ディレクトリ、WIJ ディレクトリ、データベースで使用する外部ファイルを格納したあらゆるディレクトリなどがあります。この方法は、InterSystems IRIS が通常夜間に停止されるシステムに適しています。

以下の表に、コールド・バックアップ方法のメリットとデメリットを示します。

並行外部バックアップ

並行外部バックアップ方法 ("ダーティ・バックアップ" とも呼ばれる) は、ダウンタイムなしのバックアップが必要だが、導入の状況により、標準のダウンタイムなしの外部バックアップも、ダウンタイムなしのオンライン・バックアップも不可能な場合に使用できます。この方法の一般的なシナリオとしては、例えば、スナップショット・テクノロジが使用できないうえ、データベースがきわめて大規模なため、以下の両方が当てはまる状況が考えられます。

• 外部バックアップを使用すると、(データベースのコピー中に) ユーザに影響が及ぶほど長い間書き込みがフリーズする。

• オンライン・バックアップの使用は実用的ではない。

並行外部バックアップ方法は、通常のデータベースの書き込みが行われている間にシステムの外部バックアップを実行できるようにすることによって機能します。この方法で取得したデータベースのコピーは、破損している (“ダーティ” である) と予想されます。このコピーの後にインクリメンタル・オンライン・バックアップを行います。これにより、コピーが行われている間に変更されたすべてのデータベース・ブロックが取得されます。バックアップのリストア時には、まずデータベースのコピーをリストアし、続いてインクリメンタル・バックアップをリストアします。詳細な手順は以下のとおりです。

1. 最新のバックアップ以降に変更されたデータベース・ブロックのリストを削除します。

    Do CLRINC^DBACK("QUIET")

   

   詳細は、この章の "CLRINC^DBACK" を参照してください。

2. 選択したオペレーティング・システム、またはサードパーティのバックアップ・ユーティリティを使用して、IRIS.DAT データベース・ファイルをコピーします。

3. 外部バックアップ・ユーティリティを使用したことを示す E パラメータを使用して、$$BACKUP^DBACK を呼び出します。以下に例を示します。

    Set x=$$BACKUP^DBACK("","E","Dirty external backup - incrementals must be applied.","","","")

   

   詳細は、この章の "BACKUP^DBACK" を参照してください。

4. インクリメンタル・バックアップを実行します。これによって、IRIS.DAT ファイルのコピー中に変更されたブロックがすべてコピーされます。構成によっては、このときにごく短時間ですがユーザ・プロセスが一時停止する場合があります。

    Set x=$$BACKUP^DBACK("","I","Nightly","test.bck","N","bck.log","QUIET","N","Y")
   

   

   詳細は、この章の "BACKUP^DBACK" を参照してください。

以下の表に、並行外部バックアップ方法のメリットとデメリットを示します。

バックアップ・リストアのシナリオ

バックアップ・リストアを実行するには、さまざまなシナリオがあります。多くの場合、一連の固有の要件やリストア手順があります。このセクションでは、各種バックアップ方法のバリエーションを含め、以下の一般的なリストア・シナリオについて説明します。

• システム全体のリストア — InterSystems IRIS またはシステムで使用中のストレージのすべてまたは大部分が、全体として使用不可能になった場合に使用します。バックアップ・メディアからシステム全体のバックアップがリストア済みで、これから実働環境で使用できる状態まで InterSystems IRIS をリカバリする必要があります。

• データベースのみのリストア — InterSystems IRIS データベースの一部またはすべてが使用不可能になり、バックアップからリカバリする必要がある場合に使用します。

• 別のシステムへのデータベースのリストア/移行 — 1 つ以上のデータベースが別のシステムにリストアされる場合に使用します。ターゲット・システムでは、新しいハードウェアや異なるプラットフォームを使用することも、同一ハードウェア上にデータベースの別のインスタンスを稼働させることも可能です。ターゲット・システムでは、ファイル・システムのレイアウトが異なっていてもかまいません。これを使用して、データベースをバックアップ・メンバまたは非同期ミラー・メンバに追加できます ("高可用性ガイド" の “ミラーリング” の章を参照)。

メンテナンス・モードによる InterSystems IRIS の起動

いずれのリストア手順でも、バックアップ・リストアおよびジャーナル・リストアが完全に終了し、対象のアプリケーション・レベルの検証がすべて完了するまで、リストア中のデータベースでアプリケーションの動作が発生しないようにする必要があります。アプリケーション環境または運用環境に、データベースの起動時にユーザの操作が発生しないようなメカニズムがある場合は、そのメカニズムを利用できます。例えば、完全に Web ベースのアプリケーションを使用している場合は、Web サーバをシャットダウンすれば、リストア手順に関与している管理者のみがシステムにアクセス可能となることを保証するには十分です。

InterSystems IRIS には、メンテナンスの実行中にアクセスを制限してシステムを起動できるようにするメカニズムが用意されています。

メンテナンス・モードで InterSystems IRIS を起動するには、以下の手順で行います。

1. すべてのメンテナンス作業時に使用する一意のユーザ名とパスワードを指定し、緊急アクセス・モードで InterSystems IRIS を起動します。このユーザ名とパスワードは、どの既存ユーザも使用していないものであることが必要です。

   • Windows の場合は、インストール先の bin ディレクトリから管理者として以下のコマンドを呼び出します。

     iris start <db-instance-name> /EmergencyId=<username>,<password>
     

     

   • UNIX®/Linux および macOS の各プラットフォームでは、以下のようにコマンドを呼び出します。

     iris start <db-instance-name> EmergencyId=<username>,<password>
     

     

   詳細は、"緊急アクセス" を参照してください。

2. 使用しているリストアのシナリオの説明に従って、リストア手順の残りの部分を実行します。

3. リストア手順 (あらゆるジャーナル・リストアやアプリケーションの検証などのメンテナンス作業を含む) が完了したら、以下の手順を実行して、ユーザがシステムを使用できるようにします。

   1. データベースをシャットダウンします。

   2. EmergencyId スイッチを指定せずにデータベースを起動します。

バックアップ・リストア後のジャーナル・リストア

バックアップ・リストアに続いて、ジャーナル・ファイルを適用する必要があります。この章の "ジャーナルの重要性" のセクションの説明にあるように、通常、バックアップ以降のジャーナル・ファイルをリストア時に使用できるようにしておきます。これらのジャーナル・ファイルを適用すると、バックアップの時点から災害発生時までの間にジャーナルに記述された更新がすべてリストアされます。

また、コミットされていないトランザクションをロールバックして、リストアした (不完全なトランザクションが存在する可能性がある) データベースのトランザクションの整合性をリストアするには、ジャーナルを適用する必要があります。バックアップ直前までのジャーナル・ファイルが存在し、それ以降に新しいジャーナル・ファイルが作成されていない場合でもこの作業は必要です。

リストアを開始する際に、ジャーナル・リストアの開始点を選択する必要があります。ジャーナル・リストアでは、ジャーナル・ストリームをさかのぼって、バックアップよりも前に開始されたトランザクションの開始を検索することもできます。オンライン・バックアップを使用すると、推奨される開始点がバックアップに格納されます。^DBACK または ^BACKUP ユーティリティを使用してバックアップすると、リストア時のトランザクション・ロールバックに必要な最も古いジャーナル・ファイルに関する情報が 3 番目または最後のパスの開始時に表示されます。

バックアップ・リストア後のジャーナルの適用方法については、このドキュメントの “ジャーナリング” の章にある "^DBREST によるすべてのデータベースのリストア" および "ジャーナル・ファイルのリストア" のセクションを参照してください。

自動 WIJ およびジャーナル・リカバリを使用しない InterSystems IRIS の起動

この章で説明されているリストア手順の一部では、InterSystems IRIS の起動時にデータベースの自動リカバリが発生しないように起動する必要があります。これは、リストア手順でリカバリをすべて手動で実行することになっている手順で、起動時の自動リカバリとこの手動リカバリの結果に不整合が生じる可能性がある場合に当てはまります。

自動 WIJ およびジャーナル・リカバリを使用せずに InterSystems IRIS を起動するには、以下の手順で行います。

1. IRIS.WIJ ファイルを取り除き (ただし完全に削除はしません)、以下のように引き続き分析に使用できるようにします。

   1. 管理者ディレクトリに格納されている startup.last ファイルの wijlast= 行を確認します。

   2. この行で指定されているディレクトリに格納されている IRIS.WIJ ファイルを移動するか、名前を変更します。NULL ディレクトリが指定されている場合、IRIS.WIJ ファイルは管理者ディレクトリに格納されています。

2. すべてのメンテナンス作業時に使用する一意のユーザ名とパスワードを指定し、緊急アクセス・モードで InterSystems IRIS を起動します。このユーザ名とパスワードは、どの既存ユーザも使用していないものであることが必要です。

   • Windows の場合は、InterSystems IRIS インストールの bin ディレクトリから以下のようにコマンドを呼び出します。

     iris start <iris-instance-name> /EmergencyId=<username>,<password>
     

     

   • UNIX®/Linux および macOS の各プラットフォームでは、以下のようにコマンドを呼び出します。

     iris start <iris-instance-name> EmergencyId=<username>,<password>
     

     

   詳細は、"緊急アクセス" を参照してください。

3. ほとんどの場合、WIJ 内のジャーナル・リカバリ情報が失われているため、InterSystems IRIS は完全には起動しません。InterSystems IRIS が正常に起動する場合は、この手順の残りはスキップしてください。

4. messages.log の指示に従って、-B オプションを選択して InterSystems IRIS に入り、do ^STURECOV を実行します。

   1. オプション 8 を選択して、ジャーナル・リカバリを使用しないで起動するように InterSystems IRIS をリセットします。

   2. オプション 9 を選択して、InterSystems IRIS をシャットダウンします (表示される手順を使用)。

5. 手順 2 の説明に従って、再度 InterSystems IRIS を緊急アクセス・モードで起動します。

6. 使用しているリストアのシナリオの説明に従って、リストア手順の残りの部分を実行します。

7. リストア手順 (あらゆるジャーナル・リストアやアプリケーションの検証などのメンテナンス作業を含む) が完了したら、以下の手順を実行して、ユーザがシステムを使用できるようにします。

   1. InterSystems IRIS をシャットダウンします。

   2. EmergencyId (Windows プラットフォームの場合は /EmergencyId) スイッチを使用しないで InterSystems IRIS を起動します。

データベース・バックアップ・リストの定義

InterSystems IRIS では、バックアップの対象となるデータベースを指定するデータベース・リストが管理されます。このリストは、管理ポータルの [システム管理]→[構成]→[データベースバックアップ]→[データベース・バックアップ・リスト] ページに移動すると表示できます。

矢印ボタンを使用して、バックアップ しない データベースを [使用可能] リストに移動し、バックアップ する データベースを [選択済み] リストに移動します。[保存] をクリックします。どのデータベースも選択していない場合は、すべてのデータベースがバックアップされます。

システムに新規データベースを追加すると、そのデータベースはデータベース・リストに自動的に追加されます。その新規データベースがバックアップ対象でない場合は、[バックアップ・データベース・リスト] から必ず削除してください。

バックアップ・タスクの構成

InterSystems IRIS には、複数のタイプのバックアップ・タスクがあります。各タイプは、[データベースバックアップ設定] メニューの項目として表示されます。このバックアップ・タスクの構成とは、以下のとおりです。

• すべてのデータベースのフル・バックアップの構成

• データベース・リストのフル・バックアップの構成

• データベース・リストのインクリメンタル・バックアップの構成

• データベース・リストの累積バックアップの構成

これらは、あらかじめ定義されたバックアップ・タスクで、ポータルの [システム処理]→[バックアップ] ページから必要に応じて実行できます。タスク・マネージャを使用することで、これらのバックアップ・タスクを組み合わせてスケジュールすることもできます。詳細は、この章の "バックアップ・タスクのスケジュール" を参照してください。

これらの各タスクを構成する手順は同じです。[名前]、[説明]、および [タイプ] の各フィールドは読み取り専用であり、以下のテーブルで説明するように、選択したメニュー項目のものを反映します。

ディスク上のディレクトリにバックアップ出力を送信するには、[デバイス] フィールドでファイルのパス名を指定します。[参照] をクリックして、ディレクトリを選択します。

[バックアップ・データベース・リスト] の管理方法の詳細は、"データベース・バックアップ・リストの定義" を参照してください。

バックアップ・タスクのスケジュール

バックアップの実行スケジュールは、適切に設定する必要があります。バックアップは、システムを利用しているユーザが可能な限り少ない時間に実行します。

既定のタスクとして提供され、必要に応じて実行される 4 種類のバックアップ・タスクのほかに、これら 4 つのバックアップ・タスクに追加してバックアップ定義を作成できます。例えば、2 つのディスク・ドライブ間でバックアップする代わりに、ドライブごとにバックアップ・タスクを生成できます。

これらのバックアップ・タスクをスケジュールするには、インターシステムズのタスク・マネージャを使用します。

1. 管理ポータルで、[タスクスケジューラウィザード] に移動します ([システム処理]→[タスクマネージャ]→[新規タスク])。

2. [新規タスクスケジュール] をクリックします。

3. [タスク名]、[説明]、[タスクタイプ] を指定して、既定値に変更を加えてから [次へ] をクリックします。

4. 必要なスケジュール情報を入力して、[完了] をクリックします。

これで、[タスクスケジュール表示] ページ ([システム処理]→[タスクマネージャ]→[タスクスケジュール表示]) に目的のタスクを表示できるようになります。このタスクは、その行の [詳細] をクリックすることで他のタスクと同様に管理できます。

バックアップ・タスクの実行

管理ポータルの [バックアップ] メニュー・オプション ([システム処理]→[バックアップ]) では、4 つのタイプのバックアップ・タスクを実行でき、それぞれのタスクに専用のメニュー項目があります。

• すべてのデータベースのフル・バックアップの実行

• バックアップ・データベース・リストのフル・バックアップの実行

• バックアップ・データベース・リストのインクリメンタル・バックアップの実行

• バックアップ・データベース・リストの累積バックアップの実行

インクリメンタル・バックアップや 累積 バックアップの前には、データベースの フル バックアップを実行する必要があります。オンライン・バックアップを実行する手順は以下のとおりです。

1. 適切なバックアップ・タイプのメニュー項目をクリックします。

2. [実行バックアップ・タスク] ボックスの設定が正しいかどうかを確認します。

3. バックアップ・オプションが正しければ、[OK] をクリックしてバックアップを開始します。

   バックアップ・オプションが適切でない場合は、"オンライン・バックアップ設定の構成" の手順に従って更新してください。

4. バックアップの実行中は、[開始済みのバックアップ] の横のテキストをクリックすると、実行中のバックアップのステータスを表示できます。詳細は、"バックアップ・ステータスの表示" を参照してください。

^BACKUP ユーティリティから 1) Backup オプションを選択するか、^DBACK ユーティリティを実行することによって、最近実行された直前 3 回までのバックアップ・タスクを実行することもできます。詳細は、“^DBACK によるデータベースのバックアップ” を参照してください。

バックアップには、複数のディスク・ファイルが必要になる場合があります。現時点では、管理ポータルでマルチボリューム・バックアップを実行することはできません。マルチボリューム・バックアップが必要な場合は、^BACKUP ユーティリティを使用してください。ディスクがいっぱいになった場合、^BACKUP によって、別のディスク上の別のディスク・ファイル名を入力するように要求されます。

バックアップ中にエラーが発生した場合は、その後に続くボリュームからバックアップを再開することはできません。バックアップを最初から実行する必要があります。

これらのタスクを実行する前に、バックアップのサイズを見積もる方法については、“^DBSIZE によるバックアップ・サイズの見積もり” を参照してください。

バックアップ・ステータスの表示

バックアップ処理の進行状況を監視するには、[システム処理]→[バックアップ] ページの [バックアップステータス参照] をクリックするか、実行中のバックアップ・プロセスの [表示] をクリックします。それと同じ情報が、バックアップ処理のログ・ファイルにも記録されます。後で、[バックアップ履歴の表示] ページでこのログ・ファイルを表示できます。

バックアップを開始すると、リストの [日時] 列と [状態] 列が更新されます。[日時] 列には、バックアップの完了時ではなく、開始日時が記録されます。[状態] 列は、「実行中」と表示されます。

バックアップの終了時、再度 [状態] 列が更新され、バックアップの最終的な状態が表示されます。以下に例を示します。

• 「完了」は、バックアップが成功したことを示します。

• 「Failed」は、バックアップが実行されなかったこと、またはユーザによって停止されたことを示します。

• 「警告」は、途中で問題が発生したが、完了したことを示します。

対応するバックアップ・ログには、有益な情報が記載されています。タスクの横にある [ビュー] をクリックすると、バックアップ・ログが表示されます。

次の “実行中のバックアップの中止” では、実行中のバックアップに表示されるその他のオプションについて説明します。

実行中のバックアップの中止

実行中のバックアップを中止するには、以下の 3 つの方法を使用できます。

• [バックアップ・ステータスの表示] ページに移動し、実行中のタスクの横の [中止] をクリックしてから [OK] をクリックして、バックアップ中止の要求を確定します。

• Backup.GeneralOpens in a new tab クラスのメソッドを呼び出します。詳細は、"インターシステムズ・クラス・リファレンス" で、"Backup.General.GetAbortStatus()Opens in a new tab"、"Backup.General.ClearAbortStatus()Opens in a new tab"、および "Backup.General.AbortBackup()Opens in a new tab" のメソッドの説明を参照してください。

• ^BACKUP ルーチンで中止オプションを選択します。詳細は、“^BACKUP による実行中のバックアップの中止” を参照してください。

バックアップ履歴の表示

バックアップ処理ごとに、独立したバックアップ・ログ・ファイルが生成されます。ログは、"バックアップ・ファイル名" で説明した名前付け規約に従います。

このポータルから、完了したバックアップ・タスクのシステム・バックアップ・ログのリストを表示できます。

1. 管理ポータルの [システム処理]→[バックアップ] ページに移動します。

2. 右側の列の [バックアップ履歴の表示] をクリックして、[バックアップ履歴] ページを表示します。このページには、完了したバックアップに関する情報が一覧表示されます。

3. 特定のバックアップの結果を表示するには、該当する行の右側の列の [ビュー] をクリックします。バックアップ・ログ・ファイルの内容を表示し、そのファイル内の文字列を検索できます。

バックアップで入出力エラーが発生した場合、バックアップは中止され、バックアップ・ログ・ファイルにシステム・エラーが記録されます。これらのログ・ファイルに記録された情報を使用すると、問題の発生個所をすばやく確認し、修正できます。

バックアップが失敗する原因の 1 つは、ディスマウントされているデータベースでバックアップを実行しようとしたことです。バックアップ中にエラーが発生すると、バックアップ・ユーティリティにより、エラーが発生したデバイスでのバックアップを再試行できます。または、バックアップを中止することもできます。

^DBSIZE によるバックアップ・サイズの見積もり

InterSystems IRIS バックアップの実行直前に、^DBSIZE ユーティリティを使用して、出力のサイズを見積もることができます。バックアップが開始されると、変更されるブロック数を認識する手段がないため、このサイズは単なる推定値です。^DBSIZE 実行中にグローバル更新が行われないようにして、グローバル更新の再開前にバックアップを実行すると、取得される見積もりの精度がさらに向上します。

以下の 2 つの方法で、バックアップ・サイズを指定できます。

• ^DBSIZE のインタラクティブな実行

• ルーチンからの ^DBSIZE の呼び出し

^DBSIZE 関数の使用

ルーチンから ^DBSIZE を呼び出すこともできます。このためには、以下の関数を使用します。

$$INT^DBSIZE(backup_type)

Important:

^DBSIZE をインタラクティブに実行している場合、backup_type の値はメニュー・オプションの番号と異なります。

バックアップ・タイプ	説明
1	インクリメンタル・バックアップ
2	フル・バックアップ
3	累積インクリメンタル・バックアップ

例えば、フル・バックアップ実行のサイズ見積もりを確認する場合は以下のようになります。

%SYS>w $$INT^DBSIZE(2)
18950^5^160952320^2710^160309248^313104^313104

返り値は、キャレット (^) で区切られた 7 つの数字です。この例で、返り値 18950 は、ブロック単位のバックアップの合計見積もりサイズで、5 はバックアップ対象のデータベース・ディレクトリ数を示しています。下表は、出力の各部の内容を示しています。

出力位置	説明
部分 1	バックアップ対象のデータベース・ブロック数。 (処理中にエラーが発生した場合、または無効なパラメータがある場合は -1)
部分 2	バックアップ対象のディレクトリ数。
部分 3	メディアのバイト数 (レコード間ギャップは除外)。
部分 4	メディアのブロック数。
部分 5	ディスク・ファイルのバイト数。
部分 6	ディスク・ファイルの 512 バイト・ブロック数。

以下は、各タイプのバックアップで ^DBSIZE 関数を呼び出したときの出力を示しています。

%SYS>w $$INT^DBSIZE(1)
466^5^4157440^70^4122624^8052^8052

%SYS>w $$INT^DBSIZE(2)
18950^5^160952320^2710^160309248^313104^313104

%SYS>w $$INT^DBSIZE(3)
466^5^4157440^70^4122624^8052^8052

^BACKUP によるバックアップおよびリストアのタスクの実行

InterSystems IRIS ^BACKUP ユーティリティによって、以下の例に示すように、中央メニューから InterSystems IRIS のバックアップおよびリストアのタスクを実行できます。

%SYS>Do ^BACKUP
 
 
1) Backup
2) Restore ALL
3) Restore Selected or Renamed Directories
4) Edit/Display List of Directories for Backups
5) Abort Backup

6) Display Backup volume information
7) Monitor progress of backup or restore

Option?

対応するルーチンを開始するには、適切なメニューのオプション番号を入力します。ユーティリティを終了するには、オプションの番号を入力せずに Enter キーを押します。

このドキュメントの以降のセクションでは、対応するオプションを選択することによって開始されるユーティリティについて説明します。

1. ^DBACK によるデータベースのバックアップ

2. ^DBREST によるすべてのデータベースのリストア

3. ^DBREST による選択したデータベースのリストア

4. ^BACKUP によるバックアップに必要なディレクトリ・リストの編集/表示

5. ^BACKUP による実行中のバックアップの中止

6. ^BACKUP によるバックアップ・ボリュームに関する情報の表示

7. ^BACKUP によるバックアップまたはリストアの進行状況の監視

^DBACK によるデータベースのバックアップ

インターシステムズの ^DBACK ユーティリティによって、InterSystems IRIS データベースをバックアップできます。^DBACK ユーティリティの実行は、^BACKUP ユーティリティ・メニューからオプション 1 を選択した場合と同じです。以下は、ターミナルからユーティリティを実行する場合の例です。

1. まず、データベース・バックアップ・リストが定義されていることを確認し、バックアップ・ファイルの出力デバイスを選択します。

2. %SYS ネームスペースから、^DBACK ルーチンを実行します。

   %SYS>Do ^DBACK
    
    
                         Backup Utility
                 --------------------------
   What kind of backup:
      1. Full backup of all in-use blocks
      2. Incremental since last backup
      3. Cumulative incremental since last full backup
      4. Exit the backup program
   
   

   

3. 対応するメニュー・オプション番号を入力して、実行するバックアップ・タイプ (フル、インクリメンタル、または累積) を選択します。バックアップ実行手順は、すべてのタイプで共通です。

4. 出力デバイスとバックアップの内容を入力します。

   Specify output device (type STOP to exit)
   Device: c:\iris-install\mgr\backup\FullDBList_20081201_003.cbk =>
   
   Backing up to device: c:\iris-install\mgr\backup\FullDBList_20081201_003.cbk
   Description: Full Backup using ^DBACK
   
   

   

   前回のバックアップのデバイスが既定として取得されます。この例では、オンライン・バックアップ・デバイスの形式を使用しています。

5. 次に、バックアップ対象のデータベース・ディレクトリのリストが表示されます (データベース・バックアップ・リストに記載されているもの)。以下に例を示します。

    Backing up the following directories:
    c:\iris-install\mgr\
    c:\iris-install\mgr\irisaudit
    c:\iris-install\mgr\user\
    
   
   

   

6. 「Y」で応答するとバックアップが開始されます。ジャーナル・ファイルが切り替わり、バックアップの進捗状況が表示されます。

   Start the Backup =>  [answer Y or N] => y
   Journal file switched to:
   c:\iris-install\mgr\journal\20081201.004
   . 
   Starting backup pass 1
   

   

7. 3 番目または最後のパスの開始時に、バックアップをリストアするときのトランザクション・ロールバックに必要な最も古いジャーナル・ファイルに関する情報が表示されます。次に例を示します。

   Starting backup pass 3
    
   Journal file 'c:\intersystems\test62\mgr\journal\20180919.003' and the subsequent ones
   are required for recovery purposes if the backup were to be restored
    
   Journal marker set at
   offset 197180 of c:\intersystems\test62\mgr\journal\20180919.003
   

   

   この情報はバックアップ・ログに記録されます。

8. バックアップが正常に完了すると、以下のように表示されます。

   ***FINISHED BACKUP***
    
   Global references are enabled.
    
   Backup complete.
    
   %SYS>
   

   
   Note:

   バックアップが正常に完了すると、^DBACK がバックアップの説明をバックアップ履歴に書き込みます ("バックアップ履歴の表示" を参照)。これにより、[ジャーナル設定] ページの [ジャーナルファイルを削除するタイミング] > [この回数のバックアップ成功後] の設定 (既定値は 2) によっては、ジャーナルの削除がトリガされる可能性があることに注意してください。詳細は、このドキュメントの “ジャーナリング” の章の "ジャーナル設定の構成" を参照してください。

次の “^DBACK に対する外部エントリ・ポイント” では、指定されたエントリ・ポイントを使用してこのユーティリティを外部のバックアップ・プロシージャから呼び出す方法を説明します。

^DBACK に対する外部エントリ・ポイント

^DBACK ユーティリティに対して指定されたエントリ・ポイントは、外部バックアップ・プロシージャで使用できます。バックアップの整合性確保のため、このポイントは説明されたとおりに使用する必要があります。エントリ・ポイントはすべて、正常完了の場合は 1 を返し、失敗の場合は0 を返します。^DBACK ルーチンでは、以下の外部エントリ・ポイントを使用できます。

• BACKUP^DBACK

• LISTDIRS^DBACK

• CLRINC^DBACK (並行外部バックアップの場合のみ)

BACKUP^DBACK

このプロシージャによってバックアップが起動され、^DBACK のインタラクティブな実行の際に示される質問に対しては、渡された引数を使用して応答します。

BACKUP^DBACK(argfile,TYPE,DESC,OUTDEV,kiljrn,LOGFILE,MODE,clrjrn,swjrn,
nwjrnfil,quietimeout,taskname)

大文字で示された引数は、今回の InterSystems IRIS リリースのバックアップ・プロシージャで最も重要な引数です。ジャーナリング・メカニズムが変更されているため、バックアップ・ユーティリティでは、現在のジャーナル・ファイルの削除、現在のジャーナル・ファイルのクリア、および新しいジャーナル・ファイル名の指定はできなくなりました。このため、今回のバージョンの InterSystems IRIS では、次の表に示されるように多数の引数が無視されます。

引数	説明
argfile	使用できなくなりました。必ず NULL 値を使用します。
TYPE	バックアップのタイプ (必須) 値 ： I — インクリメンタル C — 累積 F — フル E — サードパーティ、またはオペレーティング・システムのバックアップ・ユーティリティによる外部フル・バックアップ。
DESC	バックアップ・ラベルおよびバックアップ履歴グローバルに保存されている説明。空白が許容される自由形式のテキスト文字列。

外部 (タイプ E) のバックアップでは、次の表の引数が無視されます。この表では、他のタイプのバックアップで無視されるか必須であるかについても記載されています。

引数	説明
OUTDEV	バックアップの出力ファイル名 (必須)。
kiljrn	ジャーナル・ファイルを切り替えるかどうかを指定します。 Y — ジャーナル・ファイルを切り替えます (推奨)。 N — 切り替えません。 (現在のジャーナル・ファイルを削除することはできなくなりました。)
LOGFILE	ログに記録するかどうか、および関数の出力を書き込むかどうかを指定します。 ファイル名 —ターミナルに送信されるすべてのメッセージをこのファイルに書き込みます (推奨)。 Null 値 — ログファイルがありません。
MODE	プロシージャの実行時にターミナルに書き込まれる出力を指定します。ログ・ファイルに書き込まれる内容を制御するものではありません。 値 ： “NOISY” — ターミナルのすべてのテキストを書き込みます (既定)。 “QUIET” — 異常な状態に関係するテキストのみを書き込みます。 “NOINPUT” — このプロセスにアタッチされたターミナルがないため、出力は送信されません。読み取りが必要な場合は、バックアップが中止されます。
clrjrn	ジャーナル・ファイルを切り替えるかどうかを指定します。 Y — ジャーナル・ファイルを切り替えます (推奨)。 N — 切り替えません。 (現在のジャーナル・ファイルを消去することはできなくなりました。)
swjrn	ジャーナル・ファイルを切り替えるかどうかを指定します。 Y — ジャーナル・ファイルを切り替えます (推奨)。 N — 切り替えません (clrjrn 引数または kiljrn 引数の値が Y である場合、swjrn は Y に変換し、ジャーナル・ファイルが切り替えられます)
nwjrnfil	(無視)

以下は、2 つのオプションの引数です。

引数	説明
quietimeout	システムが停止するまで待機する秒数。この秒数を経過するとバックアップが中止されます。ゼロ (0) または負の値は、無限に待機することを示します (既定 = 60)。
taskname	バックアップ・タイプ F、I、および C の場合に内部で使用されるタスク名。

これらの外部エントリ・ポイントを使用するには、すべてのモードで ^SYS グローバルへの読み取り/書き込みアクセス権が必要です。外部 (タイプ E) バックアップでは、^SYS グローバル内のディレクトリの .IND ファイル、.INE ファイル、および .INF ファイルが削除されます。また、ルーチンによって、このバックアップが LASTFULL バックアップであるという説明と共にバックアップ履歴グローバルに記録されます。

このルーチンを呼び出す際に、スイッチ 10 を設定している場合は、バックアップ全体を通じてこの設定が保持されます。スイッチ 13 を設定している場合、バックアップで必要な Set および Kill コマンドが実行される間はプロシージャによってスイッチ 10 に変換され、終了時にスイッチ 13 に復元されます。

このルーチンは、このエントリ・ポイントによって定義された変数に対しては New コマンドを実行しますが、^DBACK プロシージャの本体内で定義された変数では実行しません。このため、^DBACK の呼び出し前に呼び出されるすべてのルーチンで、その他のすべての変数を慎重に保護する必要があります。

返り値 ：

• 0 — 失敗しました。ログ・ファイルを指定している場合はこのファイルを確認してください。

• 1 – 成功

• 1, warning message string — 成功しましたが、警告があります。この警告は、文字列内でチルダ文字 (~) によって区切られています。

LISTDIRS^DBACK

このプロシージャは、出力ファイルを開き、バックアップに含まれるデータベース・ディレクトリに関するリストを書き込みます。リストが空白の場合は、すべてのデータベース・ディレクトリ (IRISTEMP、IRISLIB、および IRISLOCALDATA を除く) がプロシージャによってバックアップされます。この関数の形式は以下のとおりです。

LISTDIRS^DBACK(file,mode)

引数	説明
file	関数がバックアップ・リスト内のデータベース・ディレクトリのリストを書き込む出力ファイルの名前。
mode	このプロシージャの実行時にターミナルに書き込まれる出力内容を指定します。 “QUIET” — 返り値、および異常な状態に関係するテキストのみを表示します。 その他のすべての値 — ターミナルにディレクトリ・リストを表示します。

以下は、ターミナルに表示される出力の表示例です。

%SYS>w $$LISTDIRS^DBACK("c:\temp\listdirs.txt","NOISY")
 
List of directories to be backed up
     c:\iris-install\mgr\irisaudit\
     c:\iris-install\mgr\irislib\
     c:\iris-install\mgr\
     c:\iris-install\mgr\user\
1
%SYS>

このプロシージャに関する注意事項は以下のとおりです。

• ^SYS グローバルに対する読み取りアクセス権が必要です。

• スイッチの設定やクリアは行われません。

• すべてのローカル変数に対して New コマンドを発行します。

CLRINC^DBACK (並行外部バックアップの場合のみ)

このプロシージャを呼び出すと、バックアップ・リスト内のデータベースで変更されているブロックを示すインクリメンタル・バックアップ・ビットマップがクリアされます。同時に、先にフル・バックアップを実行しなければあらゆる種類のバックアップが実行できなくなるため、バックアップ履歴も削除されます。このプロシージャは、InterSystems IRIS 実行状態での外部フル・バックアップの実行前に使用することを目的としています。InterSystems IRIS がダウンした状態で外部バックアップを実行する場合は、システムのシャットダウン前にこのエントリ・ポイントを呼び出します。この関数の形式は以下のとおりです。

CLRINC^DBACK(mode)

引数	説明
mode	このプロシージャの実行時にターミナルに書き込まれる出力内容を指定します。 “QUIET” — 返り値、および異常な状態に関係するテキストのみを表示します。 その他のすべての値 — ディレクトリの処理時にその名前を表示します。

例 ：

%SYS>w $$CLRINC^DBACK("QUIET")
1
%SYS> 

%SYS>Do CLRINC^DBACK("NOISY")
 
     Cleared incremental backup bitmap in c:\iris-install\mgr\
     Cleared incremental backup bitmap in c:\iris-install\mgr\irisaudit\
     Cleared incremental backup bitmap in c:\iris-install\mgr\user\
%SYS>

このプロシージャに関する注意事項は以下のとおりです。

• ^SYS グローバルに対する読み取り/書き込みアクセス権が必要です。

• スイッチ 13 の状態を記録し、設定されていない場合は設定して、終了時に元の状態に復元します。

• メイン・バックアップ・プロシージャで定義されたものを除き、すべてのローカル変数に対して New コマンドを発行します。

• このルーチンの呼び出し時にディスマウントされていたディレクトリは、ディスマウントされた状態で保持されます。

^BACKUP によるバックアップに必要なディレクトリ・リストの編集/表示

InterSystems IRIS の ^BACKUP ユーティリティのオプションを使用すると、InterSystems IRIS データベースのバックアップや、既に作成されたバックアップのリストアができます。データベースのリストが作成されていない場合は、すべてのデータベースがバックアップ対象となります。リストを作成すると、スクリプト化されたバックアップの ^BACKUP ユーティリティのエントリ・ポイントの呼び出しも含めて、InterSystems IRIS バックアップ・システムのすべてに適用されます。

以下の例は、メニューの各オプションからの出力サンプルです。

1. ^BACKUP メニューから、オプション 4 を選択して、データベース・バックアップ・リストの管理メニューを表示します。

   %SYS>Do ^BACKUP
    
    
   1) Backup
   2) Restore ALL
   3) Restore Selected or Renamed Directories
   4) Edit/Display List of Directories for Backups
   5) Abort Backup
   6) Display Backup volume information
   7) Monitor progress of backup or restore
    
   Option? 4
    
   1) Add a database to the backup
   2) Remove a database from the backup
   3) Show current list of databases included in backups
   4) Show list of available databases
   5) Display last full backup information
   
   

   

2. リストにデータベースを追加するには、オプション1 を選択します。この例では、データベースが現在のリストに追加されたことを示すため、オプション 3 も使用しています。

   1) Add a database to the backup
   2) Remove a database from the backup
   3) Show current list of databases included in backups
   4) Show list of available databases
   5) Display last full backup information
    
   Option? 1
   Enter database to add? DATA
   Enter database to add?
   You've selected DATA to be added to the backups
   Are you sure you want to do this (yes/no)? y
   Completed.
    
   1) Add a database to the backup
   2) Remove a database from the backup
   3) Show current list of databases included in backups
   4) Show list of available databases
   5) Display last full backup information
    
   Option? 3
   The following 3 databases are included in backups
        IRISAUDIT               C:\iris-install\Mgr\irisaudit\
        IRISSYS                 C:\iris-install\Mgr\
        USER                    C:\iris-install\Mgr\User\
   
   

   

3. リストのデータベースを削除するには、オプション 2 を選択します。この例では、データベースが現在のリストから削除されたことを示すため、オプション 3 も使用しています。

   1) Add a database to the backup
   2) Remove a database from the backup
   3) Show current list of databases included in backups
   4) Show list of available databases
   5) Display last full backup information
    
   Option? 2
   Enter database to remove (^ when done)?  DATA
   Enter database to remove (^ when done)?
   You've removed DATA from the backups
   Are you sure you want to do this? y
   Completed.
    
   1) Add a database to the backup
   2) Remove a database from the backup
   3) Show current list of databases included in backups
   4) Show list of available databases
   5) Display last full backup information
   
   Option? 3
   The following 3 databases are included in backups
        IRISAUDIT          C:\iris-install\Mgr\irisaudit\
        IRISSYS            C:\iris-install\Mgr\
        USER               C:\iris-install\Mgr\User\
   
   

   

4. このインスタンスのすべてのデータベースのリストを表示するには、オプション 4 を選択します。

   1) Add a database to the backup
   2) Remove a database from the backup
   3) Show current list of databases included in backups
   4) Show list of available databases
   5) Display last full backup information
    
   Option? 4
   The following is a list of all databases in the configuration.
   Databases which are part of the backup are marked with (*)
        (*) IRISAUDIT           c:\iris-install\mgr\irisaudit\
            IRISLIB (Read Only) c:\iris-install\mgr\irislib\
            IRISLOCALDATA       c:\iris-install\mgr\irislocaldata\
        (*) IRISSYS             c:\iris-install\mgr\
        (*) USER                c:\iris-install\mgr\user\
    
   
   

   

5. 最新のフル・バックアップに関する情報を表示するには、オプション 5 を選択します。

   1) Add a database to the backup
   2) Remove a database from the backup
   3) Show current list of databases included in backups
   4) Show list of available databases
   5) Display last full backup information
    
   Option? 5
    
   =====Last Full Backup Information=====
    
   Date: 19 Jan 2018
   Description: Full backup of all databases that are in the backup database list.
   Device: c:\iris-install\mgr\backup\FullDBList_20180119_001.cbk
   
   

   

^BACKUP による実行中のバックアップの中止

^BACKUP ユーティリティのメニュー・オプション 5 を使用すると、実行中のバックアップを中止できます。

%SYS>Do ^BACKUP
 
 
1) Backup
2) Restore ALL
3) Restore Selected or Renamed Directories
4) Edit/Display List of Directories for Backups
5) Abort Backup
6) Display Backup volume information
7) Monitor progress of backup or restore
 
Option? 5
Are you sure you want to abort the backup operation ? <No> Yes
Backup abortion succeed.

このオプションを選択したときにバックアップが実行中でない場合は、以下のメッセージが表示されます。

No Backup operation is currently running.

^BACKUP によるバックアップ・ボリュームに関する情報の表示

以下に示すように、^BACKUP メニューからオプション 6 を選択すると、バックアップ・ファイルのパス名の入力を求めるプロンプトが表示されます。

Enter the backup volume you want to display information from
 (Type STOP to exit)
Device: c:\131u1\mgr\backup\FullAllDatabases_20180802_001.cbk =>
 
This backup volume was created by:
InterSystems IRIS for Windows (x86-64) 2018.1.1 (Build 257U) Sun Jul 1 2018 23:35:31 EDT
 
The volume label contains:
   Volume number       1
   Volume backup       AUG 2 2018 12:27PM Full
   Previous backup     AUG 2 2018 11:35AM Cumulative Incremental
   Last FULL backup    AUG 2 2018 11:24AM
   Description         Full backup of ALL databases
   Buffer Count        0
   Mirror name         JEFF122
   Failover member     NONNIE20/TEST2A   
   Journal File        c:\131u1\mgr\journal\20180802.005
   Log file            c:\131u1\mgr\Backup\FullAllDatabases_20180802_001.log
   Backup Status       Completed
 
Database                                Size(mb)  Mirror DB Name 
--------                                --------  --------------
c:\131u1\mgr\                                191
c:\131u1\mgr\irisaudit\                      11
c:\131u1\mgr\user\                          2113  MUSER
Total of 3 databases, totaling 2315 mb
Backup volume size is 2365 mb

^BACKUP によるバックアップまたはリストアの進行状況の監視

^BACKUP を使用して開始された、実行中のバックアップ・ジョブまたはリストア・ジョブの進行状況を監視するには、^BACKUP メニューからオプション 7 を選択します。バックアップ・ジョブまたはリストア・ジョブを開始する前に、別のターミナル・ウィンドウで監視を開始できます。

実行中のバックアップ・ジョブの場合、以下の情報が表示されます。

                                 Backup Status
                                 -------------
 
Status:                       Running
Backup process pid:           13052
Backup file:                  c:\132u1\mgr\stcfull.bck
Description:
Log file:                     c:\132u1\mgr\irisbackup.log
Type:                         Full
Start time:                   2018-09-05 14:09:02
Estimated finish time:        2018-09-05 14:09:45
Total time (hh:mm:ss):        00:00:18
Time remaining (hh:mm:ss):    00:00:25
Estimated backup size:        7.68GB
Current backup size:          3.12GB
Current Backup rate:          184MB/sec
% Completed                   41

実行中のリストア・ジョブの場合、以下の情報が表示されます。

                                 Restor Status
                                 -------------
 
Status:                       Running
Restore process pid:          13052
Restore file:                 c:\132u1\mgr\stcfull.bck
Description:
Type:                         Full
Start time:                   2018-09-05 14:10:49
Estimated finish time:        2018-09-05 14:12:07
Total time (hh:mm:ss):        00:00:34
Time remaining (hh:mm:ss):    00:00:44
Restore file size:            7.68GB
Restore size completed:       3.28GB
Current restore rate:         103MB/sec
% Completed                   43

^DBREST によるすべてのデータベースのリストア

^DBREST メニューから 1 を選択すると、^BACKUP メニューから 2 を選択した場合と同じになります。

以下の手順は、すべてのディレクトリをリストアする場合の概要を示す例です。リストア処理の開始プロンプトが示されます。処理を進めるにつれ、リストア・プロセスのステッピングの際に非常に個別的な質問が行われます。

1. ユーティリティ・メニューからすべてのディレクトリのリストアを選択します。このオプションでは、バックアップ・メディアにあるすべてのディレクトリがリストアされます。

   %SYS>Do ^DBREST
    
                                 DBREST Utility
            Restore database directories from a backup archive
    
   Restore: 1. All directories
            2. Selected and/or renamed directories
            3. Display backup volume information
            4. Exit the restore program
       1 => 1
   
   

   

2. すべてのディレクトリをリストアすることを確認します。

   Proceed with restoring ALL directories Yes=>
   

   

3. 次に、すべてのデータベースのリストア先にする最上位パスを入力するよう求められます。これは、リストア対象のデータベースの元のパスに接頭語として自動的に追加されます。これによって、元のディレクトリをこのディレクトリのサブディレクトリとして、すべてのデータベースがこのディレクトリの下位でリストアされます。これを無視して、データベースを元のパスでリストアするには、Enter を押します。

   Top directory for all Databases to be restored to (? for Help)?
   

   

4. リストア実行中、InterSystems IRIS 処理を一時停止するかどうかを示します。これらの処理は一時停止することをお勧めします。

   Do you want to set switch 10 so that other processes will be
   prevented from running during the restore? Yes =>
   

   

5. リストア場所から最初のファイルを指定します。Enter キーを押すと既定のファイルを指定できます。既定のファイルは、最後のフル・バックアップです。

   Specify input file for volume 1 of backup 1
    (Type STOP to exit)
   Device: c:\iris-install\mgr\backup\FullAllDatabases_20180323_001.cbk =>
   
   

   

6. バックアップの詳細が正確かどうかをチェックし、このファイルが、リストアするファイルであることを確認します。

   This backup volume was created by:
      InterSystems IRIS for Windows 2018.1.1
    
   The volume label contains:
      Volume number      1
      Volume backup      MAR 23 2018 09:52AM Full
      Previous backup    MAR 22 2018 11:00AM Incremental
      Last FULL backup   MAR 16 2018 11:00AM
      Description        Full backup of ALL databases, whether or not they are in
                         the backup database list.
      Buffer Count       0
   Is this the backup you want to start restoring? Yes =>
   
   

   

7. リストアするディレクトリがユーティリティから示され、リストア処理が進められます。

   The following directories will be restored:
   c:\iris-install\mgr\
   c:\iris-install\mgr\irisaudit\
   c:\iris-install\mgr\test\
   c:\iris-install\mgr\user\
   
    
   ***Restoring c:\iris-install\mgr\ at 10:46:01
   146045 blocks restored in 241.3 seconds for this pass, 146045 total restored.
   
   

   

8. リストアを要する次のインクリメンタル・バックアップの入力ファイルを指定します。これ以上リストアする入力ファイルがない場合は「stop」と入力します。

   Specify input file for volume 1 of backup following MAR 23 2018  09:52AM
    (Type STOP to exit)
   Device: stop
   
   

   

9. 他のバックアップをリストアするかどうかを示します。「Yes」で応答すると、このプロシージャが再び実行されます。「No」で応答すると、リストアされたデータベースがシステムによってマウントされます。

   Do you have any more backups to restore? Yes => No
   Mounting c:\iris-install\mgr\
       c:\iris-install\mgr\       ... (Mounted)
    
   Mounting c:\iris-install\mgr\irisaudit\
       c:\iris-install\mgr\irisaudit\  ... (Mounted)
     
   Mounting c:\iris-install\mgr\test\
       c:\iris-install\mgr\test\  ... (Mounted)
    
   Mounting c:\iris-install\mgr\user\
       c:\iris-install\mgr\user\  ... (Mounted)
    
   
   

   

10. リストアしたデータベースに割り当てるジャーナル・エントリと、リストアするジャーナル・ファイル名を指定します。通常は、オプション 1 を選択して、リストアしたディレクトリに影響する変更のみを適用します。

    Note:

    すべてのディレクトリまたは選択されたディレクトリのすべてのエントリとグローバルをリストアするときに何が起こるかについては、このドキュメントの “ジャーナリング” の章にある "^JRNRESTO を使用したジャーナル・ファイルからのグローバルのリストア" を参照してください。

    Restoring a directory restores the globals in it only up to the
    date of the backup.  If you have been journaling, you can apply
    journal entries to restore any changes that have been made in the
    globals since the backup was made.
     
    What journal entries do you wish to apply?
     
         1. All entries for the directories that you restored
         2. All entries for all directories
         3. Selected directories and globals
         4. No entries
     
    Apply: 1 =>
    
    

    

11. いくつかの情報の確認後に、ジャーナル・ファイルからのリストアが開始されます。

    We know something about where journaling was at the time of the backup:
    0: offset 172940 in c:\iris-install\mgr\journal\20180323.002
     
    Use current journal filter (ZJRNFILT)? No
    Use journal marker filter (MARKER^ZJRNFILT)? No
    Updates will not be replicated
     
    The earliest journal entry since the backup was made is at
    offset 172940 in c:\iris-install\mgr\journal\20180323.002
     
    Do you want to start from that location? Yes => Yes
    Final file to process (name in YYYYMMDD.NNN format): <20180323.003> [?]
          =>
     
    Prompt for name of the next file to process? No => No
     
    Provide or confirm the following configuration settings:
     
    Journal File Prefix: =>
     
    Files to dejournal will be looked for in:
         c:\iris-install\mgr\journal\
         c:\journal\altdir\
    in addition to any directories you are going to specify below, UNLESS
    you enter a minus sign ('-' without quotes) at the prompt below,
    in which case ONLY directories given subsequently will be searched
     
    Directory to search: <return when done>
    Here is a list of directories in the order they will be searched for files:
         c:\iris-install\mgr\journal\
         c:\journal\altdir\
    The journal restore includes the current journal file.
    You cannot do that unless you stop journaling or switch
         journaling to another file.
    Do you want to switch journaling? Yes => Yes
    Journaling switched to c:\iris-install\mgr\journal\20180323.004
     
    You may disable journaling the updates for faster restore.
    Do you want to disable journaling the updates? Yes => yes
    Updates will NOT be journaled
    
    

    

12. ユーティリティによって進捗状況が表示され、完了時点が示されます。

     
     
    c:\iris-install\mgr\journal\20180323.002
      61.32%  65.03%  68.44%  72.21%  75.86%  79.26%  82.73%  86.08%  89.56%  
      92.99%  96.07%  98.87%100.00%
    ***Journal file finished at 11:03:31
     
     
    c:\iris-install\mgr\journal\20180323.003
      16.17%  17.10%  17.90%  18.90%  20.05%  21.33%  22.58%  23.81%  25.15%  
      26.32%  27.65%  28.85%  30.08%  31.37%  32.59%  33.98%  35.16%  36.25%  
      37.32%  38.41%  39.55%  40.72%  41.81%  42.83%  43.85%  44.89%  46.00%  
      47.15%  48.24%  49.28%  50.32%  51.41%  52.54%  53.71%  54.76%  55.80%  
      56.85%  57.97%  59.10%  60.16%  61.17%  62.19%  63.24%  64.32%  65.18%  
      66.02%  66.87%  67.71%  68.52%  69.34%  70.14%  70.96%  71.76%  72.60%  
      73.58%  74.51%  75.43%  76.35%  77.26%  78.17%  79.07%  79.69%  80.31%  
      80.93%  81.56%  82.20%  82.83%  83.47%  84.27%  87.00%  88.57%  91.65%  
      93.03%  96.09%  97.44%  99.04%100.00%
    ***Journal file finished at 11:03:32
     
    Journal reads completed. Applying changes to databases...
      14.29%  28.57%  42.86%  57.14%  71.43%  85.71% 100.00%
     
    [journal operation completed]
    
    

    

^DBREST による選択したデータベースまたは名前を変更したデータベースのリストア

^DBREST メニューから 2 を選択すると、^BACKUP メニューから 3 を選択した場合と同じになります。このオプションでは、バックアップ・メディアからリストアするディレクトリを選択できます。また、別のディレクトリ名や別のデバイスでデータベースをリストアすることもできます。

以下の例は、選択したディレクトリまたは名前を変更したディレクトリのリストア方法を示しています。

1. ^DBREST ユーティリティからオプション 2 を選択します。

   %SYS>Do ^DBREST
    
                                 DBREST Utility
            Restore database directories from a backup archive
    
   Restore: 1. All directories
            2. Selected and/or renamed directories
            3. Display backup volume information
            4. Exit the restore program
       1 => 2
   
   

   

2. リストア実行中、InterSystems IRIS 処理を一時停止するかどうかを示します。これらの処理は一時停止することをお勧めします。

   Do you want to set switch 10 so that other InterSystems IRIS processes
   will be prevented from running during the restore? Yes =>
   

   

3. リストア場所から最初のファイルを指定します。Enter キーを押すと既定のファイルを指定できます。既定のファイルは、最後のフル・バックアップです。

   Specify input file for volume 1 of backup 1
    (Type STOP to exit)
   Device: c:\iris-install\mgr\backup\IncrementalDBList_20180323_001.cbk =>
   
   

   

4. バックアップの詳細が正確かどうかをチェックし、このファイルが、リストアするファイルであることを確認します。

   This backup volume was created by:
      InterSystems IRIS for Windows (Intel) 5.1
    
   The volume label contains:
      Volume number      1
      Volume backup      MAR 23 2018 11:03AM Full
      Previous backup    MAR 23 2018 09:52AM Full
      Last FULL backup   MAR 23 2018 09:52AM
      Description        Incremental backup of all databases that are in the backup
                         database list.
      Buffer Count       0
   Is this the backup you want to start restoring? Yes =>
   
   

   

5. ユーティリティからディレクトリ名を要求されるので、リストアするデータベースとリストア先のディレクトリを指定します。

   For each database included in the backup file, you can:
    
    -- press RETURN to restore it to its original directory;
    -- type X, then press RETURN to skip it and not restore it at all.
    -- type a different directory name.  It will be restored to the directory
       you specify.  (If you specify a directory that already contains a
       database, the data it contains will be lost).
    
   c:\iris-install\mgr\ =>
   c:\iris-install\mgr\irisaudit\ =>
   c:\iris-install\mgr\test\ =>
   c:\iris-install\mgr\user\ =>
   
   
   

   

6. ディレクトリに関するプロンプトのそれぞれに応答すると、次のプロンプトが表示されます。

   Do you want to change this list of directories? No =>
   
   

   

   選択を編集する場合は「Yes」と入力し、確定する場合は Enter キーを押します。

7. 前セクションのすべてのディレクトリのリストア手順と同様に処理が続行されます。

この手順は、リストアするシステムと異なるシステム上で実行されたバックアップのリストアに使用できます。

バックアップ履歴によるデータベースのリストア

InterSystems IRIS のバックアップ・ユーティリティでは、バックアップ履歴 が管理されるため、バックアップを論理的な順序でリストアできます。リストア・ユーティリティにより、タイプとバックアップ履歴の順序に従ってバックアップがリストアされるように要求されます。

最新のフル・バックアップをリストアした後、バックアップ履歴 の情報を使用して、リストアする次の論理バックアップが示され、履歴の最後までこれが続きます。後続のバックアップは以下の順序でリストアするように要求されます。

1. 最新のフル・バックアップの実行後に、最新の累積バックアップ (存在する場合) が要求されます。

2. 最新の累積バックアップ以降の (累積バックアップが存在しない場合は、最新のフル・バックアップ以降の) すべてのインクリメンタル・バックアップが要求されます。一番古いものから最新までの順番で、リストアを実行します。

リストア処理で、指示されたバックアップを変更できます。しかし、インクリメンタル・バックアップや累積バックアップは、データベースの完全なコピーではありません。インクリメンタル・バックアップをリストアするには、事前にフル・バックアップをリストアしておく必要があります。

^DBREST による自動リストア

InterSystems IRIS リストア・ユーティリティ ^DBREST には、外部エントリ・ポイントによる非インタラクティブな実行オプションが用意されています。

これらの 2 つのエントリ・ポイントのいずれかを呼び出すことによって、無人で実行されるリストアを実装するスクリプトを作成できます。

• EXTALL^DBREST — バックアップ・デバイスからすべてのデータベースをリストアします ("^DBREST によるすべてのデータベースのリストア" で説明されている手順と同等の自動リストア)。^DBREST ユーティリティの EXTALL エントリ・ポイントを使用する構文は、以下のようになります。

  EXTALL^DBREST(quietmode,allowupd,inpdev,dirlist,jrnopt,jrnfile,jdirglo)
  

  Note:

  ターゲット・ディレクトリが存在するが、IRIS.DAT ファイルが存在しない場合、EXTALL^DBREST は IRIS.DAT ファイルをリストアします。

• EXTSELCT^DBREST — 選択されたファイルをバックアップ・デバイスからリストアするか、またはソース・ディレクトリと異なるターゲット・ディレクトリにリストアします ("^DBREST による選択したデータベースまたは名前を変更したデータベースのリストア" で説明されている手順と同等の自動リストア)。^DBREST ユーティリティの EXTSELCT エントリ・ポイントを使用する構文は、以下のようになります。

  EXTSELCT^DBREST(quietmode,allowupd,inpdev,dirlist,jrnopt,jrnfile,jdirglo)
  

両方のエントリ・ポイントは、呼び出しの状態を返す関数です。引数はすべて入力のみです。特に指定がない限り、下表に記載された入力引数は両方の関数で使用されます。

これらの関数の呼び出しから、以下のコードが返される可能性があります。

ディレクトリ・リスト・ファイルの要件

dirlist によって示されたファイルの要件

• リストアするディレクトリごとに 1 つのレコードを含みます。

• 各フィールドをコンマで区切ります (,)。

• 各レコードの形式は、SourceDir、TargetDir、CreateDir で、これらの意味は以下のとおりです。

  引数	説明
  SourceDir	リストアするディレクトリの名前。
  TargetDir	リストア先のディレクトリの名前。ソース・ディレクトリと同じ名前のディレクトリにリストアする場合は省略します。
  CreateDir	ターゲット・ディレクトリが存在しない場合、ターゲット・ディレクトリを作成するか否か。 Y — ターゲット・ディレクトリを作成します。 N — ターゲット・ディレクトリを作成しません。

例えば、テキスト・ファイル (RestoreList.txt) を以下の文字列を含む C:\Backup\ ディレクトリに作成したと仮定します。

C:\intersystems\iris\mgr\user\,C:\intersystems\iris\mgr\,Y

以下のルーチンを %SYS ネームスペースで実行すると、C:\intersystems\iris\mgr\user\ から C:\intersystems\iris\mgr\ にデータベースをリストアできます。

set SourceDir = "C:\intersystems\iris\mgr\user\"
set BackupDir = "C:\Backup\"
set BackupListFile="C:\Backup\RestoreList.txt"
do EXTSELCT^DBREST(1,0,BackupDir_"back1.cbk",BackupListFile,4,"","")

ディレクトリとグローバルの選択条件

jdirglo によって示されたファイルの要件

• リストアするディレクトリのそれぞれのレコードが 1 つずつ格納されます。

• 各フィールドをコンマで区切ります (,)。

• 各レコードの形式は、DirName、RestAll、Globals で、これらの意味は以下のとおりです。

引数	説明
DirName	ジャーナルをリストアするディレクトリの名前。
Globals	ジャーナル・リストアのためにコンマで区切られたグローバルのリスト。RestAll が N の場合のみ使用します。グローバルのリストが大きい場合、次の行に残りのグローバル名を記述できますが、再び、ディレクトリ名に続いて、N およびグローバルのリストを指定する必要があります。
RestAll	ディレクトリ内のすべてのグローバルについてジャーナル・エントリをリストアするか否か。大文字小文字を区別しない、必須の引数です。 Y — このディレクトリ内のすべてのグローバルでジャーナルをリストアします。 N — グローバル・リストにジャーナル・リストアのためのグローバルを指定します。

異なるレコードの例を以下に示します。

DUA0:[TEST1],Y
DUA1:[TEST2],N,GLO1,GLO2,GLO3
DUA1:[TEST2],N,GLO4,GLO5,GLO6
DUA1:[TEST3],n 

そのディレクトリのジャーナルをリストアしたくない場合、最後のレコードも完全に省略できます。

ミラーリングされたデータベースの考慮事項

ミラーリングされたデータベース (ミラーリング・データベース) が InterSystems IRIS バックアップ・リストアのターゲット (対象) である場合、ソース・データベースはターゲット・データベースと一致する必要があります (つまり、同じミラーリング・データベースであることが必要です)。

ミラーでの InterSystems IRIS バックアップ・リストアの動作は、バックアップを作成したミラー・メンバでリストアしているのか、あるいは別のシステムであるかにより、以下のように異なります。

• プライマリ・フェイルオーバー・メンバ — ^DBREST ではプライマリ・フェイルオーバー・メンバのアクティブなミラーリング・データベースをリストアできません。ただし、データベースにリストアの必要がある場合は、ミラーから一時的に削除できます ("高可用性ガイド" の “ミラーリング” の章の "ミラーリングされたデータベースをミラーから削除する" を参照)。ただしデータベースはミラーリングされたデータベースとしてリストアされ (ミラーリングされたデータベースとしてバックアップされたため)、以下の各セクションで説明する機能 (ミラーにあるデータベースをアクティブ化するために必要なジャーナル・ファイルの自動リストアなど) が適用されます。

• バックアップ・フェイルオーバー・メンバ — バックアップ・フェイルオーバー・メンバで、アクティブ状態にある、もしくはバックアップのコピーよりも新しいミラーリング・データベースのリストアを行うと、以下のように警告メッセージが表示されます。

  • フルバックアップ・リストアの場合、それらのデータベースはスキップされます。

  • 選択的リストアの場合、ターゲットを上書きしていいかどうかが確認されます。