Oracle Tuxedo システムの 10g リリース 3 (10.3) へのアップグレード

以下の節では、簡易アップグレードおよびホットアップグレードの手順に従って、Oracle Tuxedo または Oracle WebLogic Enterprise アプリケーションを Oracle Tuxedo 10g リリース 3 (10.3) にアップグレードする方法について説明します。

アップグレードするためのマシンの準備作業

Oracle Tuxedo 10g リリース 3 (10.3) ソフトウェアをインストールする前に、必要なバージョンのオペレーティングシステムとコンパイラがインストールされていることを確認します。サポートされている各プラットフォームのオペレーティングシステムとコンパイラについては、「Oracle Tuxedo 10g リリース 3 (10.3) プラットフォームデータシート」を参照してください。

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

Oracle Tuxedo ソフトウェアまたは Oracle WebLogic Enterprise ソフトウェアの旧バージョンがインストールされているプラットフォームに Oracle Tuxedo 10g リリース 3 (10.3) をインストールする場合は、次の手順をよく読んでください。

アップグレードするためにアプリケーションを停止できる場合は、停止してから簡易アップグレードを実行します。簡易アップグレードの実行手順については、「簡易アップグレードの実行」を参照してください。

アップグレードするためにアプリケーションを停止できない場合は、ホットアップグレードを実行すると、以下のソフトウェア製品から Oracle Tuxedo 10g リリース 3 (10.3) にアップグレードする際にも企業内のアプリケーションを停止する必要がありません。

既存のアプリケーションを停止しなくても、Oracle Tuxedo 10g リリース 3 (10.3) ソフトウェアを既存の Oracle Tuxedo または Oracle WebLogic Enterprise ドメインに追加したり、新しい Oracle Tuxedo 10g リリース 3 (10.3) アプリケーションサーバをそれらのドメインに追加したりすることができます。ホットアップグレードの実行手順については、「ホットアップグレードの実行」を参照してください。

ファイルのバックアップ

インストール前にバックアップし、インストール後に復元しなければならないファイルがあります。こうしたファイルに対する変更はすべて、新しい Oracle Tuxedo ソフトウェアのインストールに伴って上書きされます。

これらのファイルをもう一度変更することを避けるには、次の手順に従います。

RM ファイルを一時ディレクトリにバックアップします。RM ファイルには、buildtms や buildXAJS などのコマンドが使用するデータベースベンダ固有の設定が格納されています。このファイルは、tux_prod_dir/udataobj ディレクトリにあります。ここで tux_prod_dir は Oracle Tuxedo または Oracle WebLogic Enterprise ソフトウェアをインストールしたディレクトリです。
tuxwsvr.ini ファイルと webgui.ini ファイルを一時ディレクトリにバックアップします。これらのファイルには、Oracle Tuxedo Administration Console サーバおよび GUI 用にカスタマイズした初期化情報が格納されています。tuxwsvr.ini ファイルは tux_prod_dir/udataobj ディレクトリにあり、webgui.ini ファイルは tux_prod_dir/udataobj/webgui ディレクトリにあります。
CATNAMES、jrepository、および jrly.config ファイルをバックアップします。CATNAMES ファイルは、tux_prod_dir/locale ディレクトリにあります。jrepository ファイルと jrly.config ファイルは、tux_prod_dir/udataobj/jolt ディレクトリにあります。
tux_prod_dir ディレクトリに追加したすべてのファイルを一時ディレクトリに移動します。
インストールが完了したら、これらのファイルを元の場所に戻します。

簡易アップグレードの実行

アプリケーションを停止します。
「ファイルのバックアップ」で説明したとおりにファイルをバックアップします。
tmunloadcf(1) コマンドを実行して、MASTER マシンにあるテキスト形式のコンフィグレーションファイルを更新します。
以前のバイナリ形式のコンフィグレーションファイルをバックアップします。
Oracle Tuxedo 9.1 マシンをアップグレードする場合、「Oracle Tuxedo のアンインストール」の説明に従って Oracle Tuxedo システムソフトウェアをアンインストールします。
Oracle WebLogic Enterprise または Oracle Tuxedo 10.0 以前のソフトウェアを実行している Windows マシンをアップグレードする場合、「Windows 2003 Server の追加アップグレード手順の実行」で説明する追加手順を行います。
Oracle Tuxedo 10g リリース 3 (10.3) ソフトウェアは、少なくとも MASTER マシンとバックアップ MASTER マシンにインストールします。
MASTER マシン上で tmloadcf(1) を実行して、テキスト形式のコンフィグレーションファイルを再ロードします。
必要に応じて、アプリケーションプログラムを再コンパイルおよび再リンクします。
アプリケーションを再起動します。
時間があれば、コンフィグレーション内のほかのマシンも停止してアップグレードします。

Windows 2003 Server の追加アップグレード手順の実行

Oracle WebLogic Enterprise または Oracle Tuxedo 10g リリース 3 (10.3) 以前のソフトウェアを実行している Windows 2003 マシンでは、クリーンな状態で作業を始めるために、次の手順を実行してから Oracle Tuxedo 10g リリース 3 (10.3) ソフトウェアをインストールします。

Tuxedo TListen および Oracle procMGR サービスを停止します。[スタート] メニューから、[すべてのプログラム｜管理サービス｜サービス] の順にクリックします。[サービス] ウィンドウが表示されます。

注意 :

Tuxedo Oracle procMGR サービスは、Oracle Tuxedo 6.5 または Oracle WebLogic Enterprise 5.1 では IPC Helper と呼ばれています。

TListen サービスのエントリまでスクロールして選択し、[停止] ボタンをクリックします。[状態] 値が [開始] から空白に変わります。次に、Oracle procMGR (IPC Helper) サービスまでスクロールして選択し、[停止] ボタンをクリックします。エラーが発生することはありますが、サービスの [状態] 値は [開始] から空白に変わります。[閉じる] ボタンをクリックします。
Windows の [アプリケーションの追加と削除] を使用して、前のバージョンの Oracle Tuxedo または Oracle WebLogic Enterprise ソフトウェアを削除します。[スタート] メニューから、[設定｜コントロールパネル｜アプリケーションの追加と削除] をクリックします。[アプリケーションの追加と削除のプロパティ] ウィンドウが表示されます。
前のバージョンの Oracle Tuxedo または Oracle WebLogic Enterprise ソフトウェアのエントリまでスクロールして選択し、[追加と削除] ボタンをクリックします。

注意 :

WebLogic Enterprise 5.1 の C++ コンポーネントと Java コンポーネントの両方がインストールされている場合、Java ソフトウェアを先に削除してから C++ ソフトウェアを削除する必要があります。

ソフトウェアをアンインストールするかどうかを確認するメッセージが表示されたら、[はい] を選択します。削除が終了すると、[コンピュータからプログラムを削除] ウィンドウが表示されます。
一般にはインストール後にファイルを追加したことが理由で、すべてのディレクトリを削除できなかった場合は、[詳細] ボタンをクリックすると、どのディレクトリが削除されずにシステムに残っているかを確認できます。削除されなかったディレクトリに、変更済みのサンプルファイルなど、インストール後に変更したファイルが含まれている場合は、それらを一時ディレクトリに移動します。
アンインストールが終了したらシステムを再起動します。

Tuxedo 6.5 から Tuxedo 10g リリース 3 (10.3) へのアップグレード

Tuxedo 6.5 から Tuxedo 10g リリース 3 (10.3) にアップグレードする場合、以下の点に注意してください。

Tuxedo 10g リリース 3 (10.3) サーバで Tuxedo 6.5 ソフトウェアとの相互運用を可能にするには、Tuxedo 10g リリース 3 (10.3) サーバの servopts -t オプションを指定する必要があります。サーバとしては、ワークステーションリスナ (WSL) プロセス、ドメインゲートウェイ (GWTDOMAIN) プロセス、システムプロセス、またはアプリケーションサーバプロセスを使用できます。ワークステーションリスナプロセスの場合は、servopts -t オプションを使用して起動すると、すべてのワークステーションハンドラ (WSH) プロセスで相互運用が可能になります。詳細については、『Oracle Tuxedo のファイル形式とデータ記述方法』の GWTDOMAIN(5) を参照してください。
Tuxedo 10g リリース 3 (10.3) のドメインゲートウェイ (GWTDOMAIN) と Tuxedo 6.5 で実行するドメインゲートウェイとの相互運用を可能にするには、Tuxedo 6.5 のパッチレベルを 446 にアップグレードする必要があります。

パッチレベルを 446 にアップグレードしない場合は、この Tuxedo 10g リリース 3 (10.3) にドメインゲートウェイの TM_GWT_OLDSECCHECK 環境変数を設定する必要があります。Oracle Tuxedo 環境変数については、『Oracle Tuxedo のファイル形式とデータ記述方法』の tuxenv(5) を参照してください。

COBOL アプリケーションを実行する際、Tuxedo 6.5 COBOL プログラムによって TPINITIALIZE() が呼び出される場合は、TM_CBL_IGNORE_CONTEXT 環境変数を「Y」に設定する必要があります。Oracle Tuxedo 環境変数については、『Oracle Tuxedo のファイル形式とデータ記述方法』の tuxenv(5) を参照してください。

ホットアップグレードの実行

ホットアップグレードを実行する前に、「ファイルのバックアップ」で説明したとおりにファイルをバックアップします。

ホットアップグレードでは、MASTER マシンとバックアップ MASTER マシンを順番に停止する必要がありますが、コンフィグレーション内の残りのマシンは停止する必要がありません。

アップグレード前の注意

ホットアップグレードによっていったん MASTER マシンを Oracle Tuxedo 10g リリース 3 (10.3) に移行したら、バックアップマシンを Oracle Tuxedo 10g リリース 3 (10.3) にアップグレードするまで、代理のバックアップマシンを元に戻すことはできません。つまり、MASTER マシンの移行は元に戻せません。移行が完了したら、MASTER マシンを以前に動作していた Oracle Tuxedo バージョンに戻すことはできません。

MASTER が旧リリースの Oracle Tuxedo 10g リリース 3 (10.3) マシン上で tmadmin(1) を実行する場合、UPGRADE ファイルはカレントディレクトリにある必要があります (「ホットアップグレードの例」を参照)。このファイルがカレントディレクトリにあることを確認するには、たとえば、Tuxedo アプリケーションディレクトリ (%APPDIR% (Windows)/ $APPDIR (UNIX) ディレクトリ) から tmadmin を実行します。

移行時には、Oracle Tuxedo データストレージ領域に関して次のガイドラインに従うように注意してください。

古い TUXCONFIG ファイルを削除する指示が表示されます。TUXCONFIG ファイルは、バックアップマシンが起動すると自動的に伝播れるので、この指示に関して何の操作も必要ありません。
ソフトウェアをロードするときに TLOG を作成します。既に TLOG がある場合は削除します。
アプリケーションのキュースペースおよびキューに関しては何もしないでください。
ドメインコンフィグレーション (BDMCONFIG) ファイルがある場合は、そのままにしておきます。

停止時間を最短にするために、Oracle Tuxedo 10g リリース 3 (10.3) を MASTER およびバックアップ MASTER マシンにインストールしつつ、旧リリースのクライアントおよびサーバを作成したディレクトリと並行して %APPDIR%/ $APPDIR によって定義される各マシンのディレクトリですべてのクライアントおよびサーバを再ビルドすることをお勧めします。つまり、旧リリースのアプリケーションと Oracle Tuxedo 10g リリース 3 (10.3) アプリケーションの両方を各マシンで使用できるようにします。この処理は不可欠というわけではありませんが、実行することをお勧めします。

Oracle Tuxedo ソフトウェアは、最大 256 バイトのデバイスリストパスエントリをサポートしています (旧リリースでは 64 バイト)。Oracle Tuxedo の旧リリースで作成されたキュースペース、TLOG ファイル、その他のコンフィグレーションファイルは、このリリースでも認識およびサポートされます。ただし、Oracle Tuxedo 8.0 以前のリリースで作成されたデバイスリストは、パス名が 64 バイトに制限されています。このため、将来 64 バイトを超える長さのパス名を使用してキュースペースに新しい領域を追加しようと考えており、更新時にこのようなキュースペースが空の場合、システム管理者はホットアップグレード時にキュースペースデバイスリストとキュースペースを作成できます。多くのアプリケーションは、アップグレード中にキュースペースを保持する必要があり、それらを再作成できません。さらに、ほとんどのアプリケーションは将来キュースペースに領域を追加する必要がないか、または現在使用しているパス名以下の長さのパス名を使用して領域を追加できます。このキュースペースの再作成はまったくの任意であり、ここでの説明はあくまで補完的なものです。

ホットアップグレード手順

この節では、ホットアップグレードのタスクについて説明します。

次のように環境を設定する必要があります。

コンフィグレーションにバックアップ MASTER マシンを用意します。
コンフィグレーション内の MODEL オプションを MP に設定します。
コンフィグレーション内の MIGRATE オプションを設定します。

Oracle Tuxedo 9.1 マシンをアップグレードする場合、「Oracle Tuxedo のアンインストール」の説明に従って Oracle Tuxedo システムソフトウェアをアンインストールします。
Oracle WebLogic Enterprise または Oracle Tuxedo 9.1 以前のソフトウェアを実行している Windows 2003 マシンをアップグレードする場合、「Windows 2003 Server の追加アップグレード手順の実行」で説明する追加手順を行います。
バックアップ MASTER マシンを停止します。
バックアップ MASTER マシンに Oracle Tuxedo 10g リリース 3 (10.3) ソフトウェアをインストールし、バックアップマシンを再起動します。
旧リリースが動作する MASTER マシンを、Oracle Tuxedo 10g リリース 3 (10.3) が動作するバックアップ MASTER マシンに移行します。
バックアップ MASTER となったマシンを停止します。
Oracle Tuxedo 10g リリース 3 (10.3) を古い MASTER マシンにインストールします。
Oracle Tuxedo 10g リリース 3 (10.3) を使用して、手順 7 で停止したマシンを再起動します。

ホットアップグレードの例

次の例は、ホットアップグレードのサンプルシナリオとホットアップグレードの実行手順を示したものです。

MASTER としてコンフィグレーションされ、旧リリースを実行する MACH1 というマシン

$APPDIR1 というアプリケーションディレクトリが対応しています。
$TUXCONFIG1 というコンフィグレーションファイルが対応しています。

バックアップとしてコンフィグレーションされた MACH2 というマシン

$APPDIR2 というアプリケーションディレクトリが対応しています。
$TUXCONFIG2 というコンフィグレーションファイルが対応しています。

次の手順を参照して、アプリケーションのホットアップグレードを実行します。

MACH1> tmshutdown -B MACH2 -l MACH2
MACH1> Run tmconfig to reset the APPDIR, TUXCONFIG, TUXDIR for MACH2
       MACH2> Kill tlisten process
       MACH2> Load Tuxedo 10gR3 if it is not already loaded
       MACH2> cd $APPDIR2
       MACH2> rm $TUXCONFIG2
       MACH2> >UPGRADE    # Indicator that upgrade being done
       MACH2> Reset PATH, LD_LIBRARY_PATH, TUXCONFIG, APPDIR
       MACH2> Rebuild clients and servers, create TLOG
       MACH2> Start Tuxedo 10gR3 tlisten
MACH1> >UPGRADE    # Indicator that upgrade being done
MACH1> tmboot -B MACH2 -l MACH2
       MACH2> tmadmin
              master
              y
              psr
              q
       MACH2> tmshutdown -B MACH1 -l MACH1
       MACH2> Run tmconfig to reset the APPDIR, TUXCONFIG, TUXDIR for MACH1
MACH1> Kill tlisten process
MACH1> Load Tuxedo 10gR3 if it is not already loaded
MACH1> cd $APPDIR1
MACH1> rm $TUXCONFIG1
MACH1> Reset PATH, LD_LIBRARY_PATH, TUXCONFIG, APPDIR
MACH1> Rebuild clients and servers, create TLOG
MACH1> Start Tuxedo 10gR3 tlisten
MACH1> rm UPGRADE  # Remove indicator that upgrade being done
       MACH2> rm UPGRADE  # Remove indicator that upgrade being done
       MACH2> tmboot -B MACH1 -l MACH1

アプリケーションの再ビルド

Oracle Tuxedo システムが正しくインストールされたら、Oracle Tuxedo 10g リリース 3 (10.3) にアップグレードしたシステム上で実行するすべてのアプリケーションクライアントとサーバを再ビルドする必要があります。また、古い TUXCONFIG ファイルをすべて削除し、新しくインストールされた tmloadcf(1) を使用して、これらのファイルを再ロードする必要もあります。

Oracle Tuxedo システムアプリケーションが分散化されている場合、MASTER マシンとバックアップ MASTER マシンでは、コンフィグレーション内のマシンの中で最も新しいリリースの Oracle Tuxedo システムを実行しなければなりません。ワークステーションクライアントなどほかのマシンでは、以前のリリースの実行可能ファイルをそのまま使用できます。たとえば、MASTER とバックアップ MASTER で Oracle Tuxedo 10g リリース 3 (10.3) を実行していても、そのほかのマシンでは Oracle Tuxedo 6.5 以降が使用されることがあります。

「最新リリースを実行する」というルールには、重要な例外が 1 つあります。Oracle Tuxedo システムサーバマシンを Oracle Tuxedo 10g リリース 3 (10.3) にアップグレードせずに、Oracle Tuxedo 10g リリース 3 (10.3) をワークステーションクライアントだけにインストールすることもできます。つまり、6.5 以降のリリースの場合、MASTER がリリース 6.5 以降を実行するコンフィグレーションに、ワークステーションクライアントが混在してもかまいません。

Oracle WebLogic Server への Oracle Jolt 10g リリース 3 (10.3) のインストール

この節では、Oracle WebLogic Server 6.1、7.0、8.1、および Oracle Tuxedo 6.5、7.1、8.0、8.1、9.0、9.1、10.0 で Oracle Jolt 10g リリース 3 (10.3) を使用するユーザのための補足的なインストール手順について説明します。Jolt クライアントパーソナリティソフトウェア (Oracle Jolt for Oracle WebLogic Server) を Oracle WebLogic Server 6.1、7.0、または 8.1 マシンにインストールするには、Jolt クライアントパーソナリティソフトウェアを Oracle Tuxedo 10g リリース 3 (10.3) マシンから対象 Oracle WebLogic Server マシンにコピーします。もちろん、Oracle Tuxedo 10g リリース 3 (10.3) マシンと目的の Oracle WebLogic Server マシンが同じマシンであれば、Jolt クライアントライブラリクラスファイルを CLASSPATH 変数に追加するだけで済みます。

Oracle Jolt for Oracle WebLogic Server クライアントソフトウェアは、jolt.jar、joltjse.jar、joltwls.jar の 3 つの JAR ファイルで構成されています。これらのファイルを、CLASSPATH 変数設定に追加します。

Oracle Tuxedo システムのインストール