以前のバージョンからのアップグレード

Windows でのアップグレード手順

InterSystems IRIS の新規バージョンへのアップグレードに必要なすべての機能は、インストーラによって提供されます。代わりに、マニフェストを使用する場合に必要なサイレント・アップグレードを実行するには、このドキュメントの “Microsoft Windows への InterSystems IRIS のインストール” の章の "自動アップグレードまたは再インストールの実行" の情報を確認してください。

アップグレードを実行するには、以下の手順に従います。

1. インストーラ・ファイル (IRIS-win_x64.exe など) をダブルクリックします。

2. インストーラにより、ホスト上にある既存の InterSystems IRIS インスタンスがすべて一覧表示されます。アップグレードするインスタンスの名前を選択し、[OK] をクリックします。

3. InterSystems IRIS ライセンス・キーの入力を求められたら、[ライセンス] をクリックして新しい iris.key ファイルを参照します。インストーラによって install-dir/mgr ディレクトリで新しいキー・ファイルが検出された場合、ライセンス・キーの入力を求めるプロンプトは表示されずに次に進みます。

4. インストーラによってライセンス・キーが検証されたら、[アップグレード] をクリックします。

   Important:

   インストールの進行中にインストールを中断しないでください。エラー・メッセージが表示されてアップグレードが失敗した場合は、問題を修正して、アップグレード・インストールを再開します。

5. アップグレードが完了したら、[完了] をクリックします。

6. install-dir\mgr ディレクトリにある messages.log、iboot.log、および ensinstall.log を調べて、エラーがないことを確認します。致命的なエラーが見つかった場合、エラーを修正して、インストーラを再び実行します。

Important:

オペレーティング・システムがラージ・メモリ・ページを使用するように構成されている場合は、起動メッセージをチェックして、これらの設定に従って共有メモリが割り当てられていることを確認します。以下のようなメッセージが表示された場合は、サーバを再起動して、メモリ不足の状態に陥るのを防いでください。

Failed to allocate 592MB shared memory using large pages.  Switching to small pages.

UNIX®、Linux、および macOS でのアップグレード手順

InterSystems IRIS の新規バージョンへのアップグレードに必要なすべての機能は、インストール・スクリプト irisinstall によって提供されます。代わりにサイレント・アップグレードを実行する場合は、このドキュメントの “InterSystems IRIS の UNIX®、Linux、および macOS へのインストール” の章にある "InterSystems IRIS の自動インストール" の情報を確認してください。

アップグレードを実行するには、以下の手順に従います。

1. インストール・キットが .tar ファイルの形式である場合は、まずファイルを解凍する必要があります (このドキュメントの “InterSystems IRIS の UNIX®、Linux、および macOS へのインストール” の章にある “インストール・キットの解凍” のセクションを参照してください)。

2. root 特権を持つユーザとして、インストール・ファイルの最上位にある irisinstall スクリプトを実行し、インストール手順を開始します。

   # sudo sh /<pathname>/irisinstall
   
   

   

   ここで、<pathname> はインストール・キットの場所で、通常はキットの抽出先の一時ディレクトリです。

3. スクリプトにより、ホスト上にある既存の InterSystems IRIS インスタンスがすべて一覧表示されます。

4. [インスタンス名の入力] プロンプトで、アップグレードする InterSystems IRIS インスタンスの名前を入力して、Enter キーを押します。

5. ライセンス・キー・ファイルの入力を求められたら、「keypath\iris.key」と入力します。ここで、keypath は新しい iris.key ファイルの場所です。インストール・スクリプトによって install-dir/mgr ディレクトリで新しいライセンス・キーが検出された場合、ライセンス・キーの入力を求めるプロンプトは表示されずに次に進みます。

6. アップグレード・オプションの概要が表示され、もう一度、アップグレードを確認するよう求められます。Enter キーを押して、アップグレードを続行します。

   Important:

   インストールの進行中にインストールを中断しないでください。エラー・メッセージが表示されてアップグレードが失敗した場合は、問題を修正して、アップグレード・インストールを再開します。

7. install-dir/mgr ディレクトリにある messages.log、iboot.log、および ensinstall.log を調べて、エラーがないことを確認します。致命的なエラーが見つかった場合、エラーを修正して、インストール・スクリプトを再び実行します。

アップグレードが完了すると、インスタンスが再起動され、インストール・マニフェストが実行されます。

Important:

オペレーティング・システムがヒュージ・メモリ・ページを使用するように構成されている場合は、起動メッセージをチェックして、これらの設定に従って共有メモリが割り当てられていることを確認します。以下のようなメッセージが表示された場合は、サーバを再起動して、メモリ不足の状態に陥るのを防いでください。

Failed to allocate 1468MB shared memory using Huge Pages. Startup will retry with standard pages.

ミラーのアップグレード手順の選択

ミラーのアップグレードに適した手順を選択する際に考慮すべき主な要素は、以下の 2 つです。

• InterSystems IRIS のインストール済みバージョンのメンテナンス・リリースにアップグレードするのか、または InterSystems IRIS の新規メジャー・バージョンにアップグレードするのか。

• アップグレードにミラーリング・データベースへの変更が含まれるか。

メンテナンス・リリースにアップグレードする場合に、アプリケーション・アップグレードは行わないときは、2 番目の質問を考慮する必要はありません。常に、"メンテナンス・リリース・アップグレード" の簡単な手順を使用できます。この手順では、計画的フェイルオーバーの実行に要する時間のみ、ミラーは使用できない状態になります。

ただし、InterSystems IRIS のメジャー・バージョン間でアップグレードする場合、アプリケーション・アップグレードを実行する場合、またはその両方を行う場合は、アップグレードにミラーリング・データベースの変更が含まれる可能性があります。このような変更は、アプリケーション・アクセスが無効化されている間に、アップグレード手順の一部として、機能しているプライマリ・フェイルオーバー・メンバ上で行う必要があります。このため、アップグレードでは、ミラーリング・データベースの変更を行わない場合よりも長いダウンタイムが必要になります (その後、変更はバックアップ・メンバおよび非同期メンバ上でミラーによって複製されます)。

メジャー・リリースにアップグレードする場合、アプリケーション・アップグレードを実行する場合、またはその両方を行う場合は、以下のいずれかの条件に該当するかどうかを判断する必要があります。

• クラスとルーチンは、ミラーリングされたデータベースに保存されます。これには、アプリケーション・データも格納されています。クラスは、プライマリ上でリコンパイルする必要があります (アプリケーションがアップグレードされていない場合でも)。ルーチンについては、プライマリでのリコンパイルをお勧めします。

• アプリケーション・アップグレードに伴って、ミラーリングされたデータベース内のデータをアップグレードする必要がある場合。これらの変更は、プライマリ上で実行する必要があります。

メジャー・アップグレードまたはアプリケーション・アップグレード、あるいはその両方がこれらのいずれかの条件を満たす場合は、"メジャー・バージョン・アップグレード (ミラーリングされたデータベースの変更あり)" の手順を使用します。この手順では、計画的フェイルオーバーを実行し、ミラーリングされたデータベースに必要な変更を加える時間のみ、ミラーは使用できない状態になります。

アップグレードに、ここに挙げられているミラーリングされたデータベースの変更が含まれない場合は、"メジャー・バージョン・アップグレード (ミラーリングされたデータベースの変更なし)" の手順を検討してください。この手順では、計画的フェイルオーバーの実行に要する時間のみ、ミラーは使用できない状態になります。

計画的メンテナンスの時間が十分にあり、ミラーのダウンタイムを最小限に抑えるかどうかが重大な問題ではない場合は、代わりに "メジャー・バージョン・アップグレード (計画的ダウンタイムあり)" の簡単な手順を使用することができます。

メジャー・アップグレードの場合、ミラーの InterSystems IRIS インスタンス、アプリケーション・コード、またはその両方のアップグレードに、各手順の一般的な順序が適用されます。アップグレードする対象に合わせて、個々のステップを調整します。

アップグレード時のミラー・メンバの追加

ミラーにメンバを追加する計画がある場合、このセクションで説明するいずれかのアップグレードの実行計画を立てるまでメンバの追加を延期できます。新規バージョンのメンバをアップグレード時に追加することで、後からアップグレードを行う必要がなくなります。直ちに処理を続行し、説明どおりにアップグレードを完了させるのであれば、アップグレード中いつでも、新規バージョンのメンバをミラーに追加することができます。ただし、制約事項が 1 つあり、新規バージョンのメンバがプライマリになったら、そのメンバは、他のすべてのメンバがアップグレードされるまでプライマリであり続ける必要があります。

新規ハードウェアにミラーを移行する場合は、アップグレード中に新規メンバを追加すると非常に効果的です。いずれかのフェイルオーバー・メンバをアップグレードしてからフェイルオーバーするのではなく、ターゲット・システムに新規バージョンの新規インスタンスをインストールし、そのインスタンスを DR 非同期メンバとしてミラーに追加し、バックアップに昇格させてからフェイルオーバーすることで、ミラー・プライマリを新規システムに移行することができます。この手法を繰り返して、残りのフェイルオーバー・メンバを移行することができます。この手法を説明するため、このセクションの手順には、既存のバックアップをアップグレードする代わりに、新規バージョンの新規バックアップを追加するステップが含まれます。

ミラーのアップグレードの用語

このセクションの手順では、以下の用語が使用されています。

ミラーのアップグレード手順

4 つのミラー・アップグレード・パスの中から選択できます。どの手順を実行する必要があるかは、"ミラーのアップグレード手順の選択" のセクションの各要素を参照して決定してください。4 つの手順は、以下のとおりです。

• メンテナンス・リリース・アップグレード

• メジャー・バージョン・アップグレード (ミラーリング・データベースの変更あり)

• メジャー・バージョン・アップグレード (ミラーリング・データベースの変更なし)

• メジャー・バージョン・アップグレード (計画的ダウンタイムあり)

最初の 3 つの手順は、可能な限り短いアプリケーション・ダウンタイムで必要なアップグレードを実行できるよう設計されています。これらの手順は、アップグレードのさまざまな状況に対応するために異なります。最後の手順は、やや簡易な手順であり、ダウンタイムの最小化が優先事項でない場合に、任意のタイプのアップグレードに使用できます。

メンテナンス・リリースのアップグレード後のタスク

アップグレードの完了後、システムでプロダクションを実行している場合は、"プロダクションの管理" の “プロダクションの開始と停止” の章にある "プロダクションの開始" のセクションの手順に従ってプロダクションを再開します。

通常、メンテナンス・リリース・アップグレードでは、外部ファイルやクライアントを変更したり、クラスやルーチンをリコンパイルしたりする必要はありません。ただし、クライアント上のスタジオ・バージョンは、接続先の InterSystems IRIS サーバ・バージョンと同じかそれ以降である必要があります。

リコンパイルする場合は、"メジャー・バージョンのインストール後のタスク" のセクションの情報を参照してください。

メジャー・バージョンのインストール後のタスク

InterSystems IRIS を新規メジャー・バージョンにアップグレードした後は、"リリース・ノート" の "アップグレードの一般情報" に示されているガイダンスに従うことが重要です。以下のタスクも実行する必要があります (この章の前の手順の一部として実行していない場合)。

• クラスおよびルーチンのリコンパイル — 各ネームスペースに含まれるすべてのクラスとすべてのルーチンをリコンパイルすることをお勧めします。手順については、"ネームスペースのコンパイル方法" を参照してください。アップグレードするインスタンスに固有の依存関係およびその他のニーズを考慮して、そのための独自のツールや手順を使用できます。

• プロキシ・クラスの再生成 — アップグレードしたインスタンスで生成されていたプロキシ・クラスはすべて、"InterSystems IRIS 言語バインディング" セットの該当するガイドの手順に従って再生成する必要があります。

  この項目は Web サービスおよび Web クライアントには適用されません。Web サービス定義 (WSDL) ファイルを再インポートする必要はありません。

• ブラウザ・キャッシュのクリア — ブラウザ・キャッシュに、インストール済みバージョンの InterSystems IRIS との互換性がなくなった JavaScript ファイルが含まれていると、エラーが発生することがあります。アップグレードの完了後、直ちにブラウザ・キャッシュをクリアしてください。

お使いの環境および使用するコンポーネントによっては、以下のタスクが必要になることがあります。

• クエリ・プランの確認。新しいメジャー・バージョンにアップグレードするときに、既存のクエリ・プランは自動的に凍結されます。これにより、ソフトウェアのメジャー・アップグレードによって既存のクエリのパフォーマンスが低下することがなくなります。パフォーマンスが重要なクエリの場合、パフォーマンスの改善が達成できたかどうかをテストする必要があります。

• プロダクションの再開 — システムでプロダクションを実行している場合は、"プロダクションの管理" の “プロダクションの開始と停止” の章にある "プロダクションの開始" のセクションの手順に従ってください。

• スタジオ・クライアントのアップグレード — クライアント上のスタジオ・バージョンは、接続先の InterSystems IRIS サーバ・バージョンと同じかそれ以降である必要があります。

• Web ゲートウェイのアップグレード — Web ゲートウェイがアップグレードしている InterSystems IRIS サーバとは別個のマシン上にある場合、その別個のマシン上の Web ゲートウェイもアップグレードする必要があります。これを行うには、この章の "Windows でのアップグレード手順" に従うか、このドキュメントの “Microsoft Windows への InterSystems IRIS のインストール” の章にある "自動インストールの実行" のセクションの説明に従って、ADDLOCAL プロパティを使用してサイレント・インストールを実行します。

• Web サーバ・ファイルの更新 — アップグレード後、サイトで確立されている手法を使用して、これらを導入する必要があります。

ネームスペースのコンパイル方法

アップグレード後、各ネームスペース内のコードをコンパイルして、新規バージョンの InterSystems IRIS で実行されるようにする必要があります。コンパイラでエラーが検出された場合、コンパイラですべての依存関係を解決するために、1 回または複数回のリコンパイルが必要になることがあります。

追加の環境でアップグレードを実行する必要がある場合は、コードが正常にコンパイルされた後、更新済みのクラスまたはルーチンをエクスポートできます。今後アップグレードを行う際にこれらのクラスまたはルーチンをインポートすると、ダウンタイムを最小限に抑えて、迅速にコードを更新することができます。

Note:

アップグレード・プロセスの一部としてマニフェストを使用する場合は、マニフェストからコードをコンパイルすることができます。手順については、このドキュメントの付録 "インストール・マニフェストの作成および使用" の "アップグレード後のタスクの実行" のセクションを参照してください。

クラスのコンパイル

ターミナルからすべてのネームスペース内のクラスをコンパイルするには ：

do $system.OBJ.CompileAllNamespaces("u")

ターミナルから 1 つのネームスペース内のクラスをコンパイルするには ：

set $namespace = "<namespace>"
do $system.OBJ.CompileAll("u")

Note:

ネームスペースに、マップされたクラスが含まれる場合は、CompileAllNamespaces() または CompileAll() の呼び出しに /mapped 修飾子を含めます。

do $system.OBJ.CompileAllNamespaces("u /mapped")
do $system.OBJ.CompileAll("u /mapped")

クラス・コンパイラ・バージョン・ユーティリティ

ネームスペース内のクラスがどのクラス・コンパイラ・バージョンを使用してコンパイルされているかをお客様が判断するのを支援するため、インターシステムズでは 2 つの支援を提供しています。

• メソッド – $System.OBJ.CompileInfoClass(<classname>)

  このメソッドは、この <classname> のコンパイルに使用されたクラス・コンパイラのバージョンとこのクラスがコンパイルされた日時を返します。

• クエリ – $System.OBJ.CompileInfo(<sortby>)

  このクエリは、すべてのクラス、各クラスをコンパイルするのに使用されたコンパイラのバージョン、各クラスがコンパイルされた日時が含まれる、現在のネームスペースのレポートを生成します。最初の引数 <sortby> は、以下の値を取ることができます。

  • 0 – クラスがコンパイルされた時間

  • 1 – クラス名

  • 2 – クラスがコンパイルされた InterSystems IRIS のバージョン

ルーチンのコンパイル

ターミナルからすべてのネームスペース内のルーチンをコンパイルするには ：

do ##Class(%Routine).CompileAllNamespaces()

ターミナルから 1 つのネームスペース内のルーチンをコンパイルするには ：

set $namespace = "<namespace>"
do ##Class(%Routine).CompileAll()