Oracle Tuxedoシステムの12c リリース2 (12.2.2)へのアップグレード

次の各項で、Oracle TuxedoまたはOracle WebLogic EnterpriseアプリケーションをOracle Tuxedo 12c リリース2 (12.2.2)にアップグレードする場合の、簡易アップグレードおよびホット・アップグレードの手順を説明します。

•	アップグレード・パス

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

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

•	ファイルのバックアップ

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

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

•	旧リリースのTuxedoからTuxedo 12c リリース2 (12.2.2)へのアップグレード

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

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

•	Oracle WebLogic ServerでのOracle Jolt 12c リリース2 (12.2.2)のインストール

アップグレード・パス

図6-1に、Oracle Tuxedo 12c リリース2 (12.2.2)にアップグレードできる既存のOracle Tuxedo製品を示します。

図6-1 アップグレード・パス

アップグレードのためにドメイン(アプリケーション)を停止する場合は、ドメインを停止してから簡易アップグレードを実行する必要があります。アップグレードのためにドメインを停止できない場合は、ホット・アップグレードを実行してください(ドメインを停止せずにOracle Tuxedo 12cリリース2 (12.2.2)システム・ソフトウェアを既存のOracle TuxedoまたはOracle WebLogic Enterpriseドメインに追加します)。

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

Oracle Tuxedo 12c リリース2 (12.2.2)ソフトウェアをマシンにインストールする前に、必要なバージョンのオペレーティング・システムおよびコンパイラがインストールされていることを確認します。それぞれのサポートされているプラットフォームでのオペレーティング・システムおよびコンパイラの要件は、「Oracle Tuxedo 12c リリース2 (12.2.2)プラットフォーム・データ・シート」を参照してください。

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

Oracle Tuxedo 12c リリース2 (12.2.2)をインストールするプラットフォームに旧リリースのOracle TuxedoソフトウェアまたはOracle WebLogic Enterpriseソフトウェアがインストールされている場合、次の手順を熟読してください。

アップグレードの際にアプリケーションの停止が可能であれば、アプリケーションを停止して簡易アップグレードを実行します。簡易アップグレードを実行する手順は、「簡易アップグレードの実行」を参照してください。

アップグレードのためにアプリケーションを停止できない場合、次のいずれかのソフトウェア製品であれば、エンタープライズを停止せずに、Oracle Tuxedo 12c リリース2 (12.2.2)へのホット・アップグレードを実行できます。

•	Oracle Tuxedoのバージョン8.1、9.0、9.1、10.0、10.3、11.1.1.1.0、11.1.1.2.0、11.1.1.3.0、12.1.1.0.0および12.1.3.0.0

既存のアプリケーションを停止せずに、Oracle Tuxedo 12cリリース2 (12.2.2)ソフトウェアを既存のOracle TuxedoまたはOracle WebLogic Enterpriseドメインに追加したり、既存のアプリケーションを停止せずに、新規のOracle Tuxedo 12cリリース2 (12.2.2)アプリケーション・サーバーをこれらのドメインに追加できます。ホット・アップグレードを実行する手順は、「ホット・アップグレードの実行」を参照してください。

ファイルのバックアップ

一部のファイルは、インストール前にバックアップを取り、インストールの完了後にリストアする必要があります。これらのファイルに加えた変更は、新規のOracle Tuxedoソフトウェアがインストールされると上書きされます。

これらのファイルを再度変更することを回避するために、次の手順を実行してください。

1.	RMファイルを一時的な場所にバックアップします。RMファイルには、buildtmsおよびbuildXAJSなどのコマンドによって使用されるデータベース・ベンダー固有の設定が含まれています。tux_prod_dir/udataobjディレクトリ内にあり、tux_prod_dirはOracle TuxedoまたはOracle WebLogic Enterpriseソフトウェアがインストールされているディレクトリを示します。

2.	CATNAMES、jrepository、およびjrly.configファイルをバックアップします。CATNAMESファイルはtux_prod_dir/localeディレクトリ内にあります。jrepositoryおよびjrly.configファイルはtux_prod_dir/udataobj/joltディレクトリ構造内にあります。

3.	ユーザーがtux_prod_dirディレクトリに追加したファイルを一時的な場所に移動します。

4.	インストールが完了した後、これらのファイルを元の場所にリストアします。

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

簡易アップグレードは、次の基本的な手順で構成されます。

1.	DMTLOGおよびTLOGがすでに存在する場合は、保留中のトランザクション・ログがないことを確認してください。

2.	アプリケーションを停止します。

3.	「ファイルのバックアップ」で説明したとおりにファイルをバックアップします。

4.	tmunloadcf(1)コマンドを実行し、MASTERマシンの構成ファイルのテキスト・バージョンを更新します。

5.	構成ファイルの旧バイナリ・バージョンをバックアップします。

6.	Oracle Tuxedo 9.1マシンをアップグレードする場合、「Oracle Tuxedoのアンインストール」の説明に従ってOracle Tuxedoシステム・ソフトウェアをアンインストールします。

7.	Oracle WebLogic EnterpriseまたはOracle Tuxedo 10.0以前のソフトウェアを実行しているWindowsマシンをアップグレードする場合、「Windows Serverの追加アップグレード手順の実行」で説明する追加手順を行います。

8.	最低でもMASTERマシンおよびバックアップMASTERマシンにOracle Tuxedo 12c リリース2 (12.2.2)ソフトウェアをインストールします。

9.	tmloadcf(1)コマンドをMASTERマシンで実行し、構成ファイルのテキスト・バージョンを再ロードします。

10.	アプリケーション・プログラムを再コンパイルおよび再リンクします。

11.	DMTLOGおよびTLOGがすでに存在する場合、それらを削除します。

12.	アプリケーションを再起動します。

13.	都合のよい時間帯に、構成内の他のマシンを停止し、アップグレードします。

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

Oracle WebLogic EnterpriseまたはOracle Tuxedo 12cリリース2 (12.2.2)またはそれ以前のソフトウェアが実行されているWindowsマシンの場合、クリーンなシステムで起動するよう、Oracle Tuxedo 12cリリース2 (12.2.2)ソフトウェアをインストールする前に次の追加手順を実行してください。

1.	Tuxedo TListenおよびOracle procMGRサービスを停止します。「スタート」メニューから、「スタート」→「すべてのプログラム」→「管理ツール」→「サービス」をクリックします。「サービス」ウィンドウが開きます。

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

2.	TListenサービスのエントリまでスクロールして選択し、「停止」ボタンをクリックします。「ステータス」値が「開始」から空白に変わります。次に、Oracle procMGR (IPC Helper)サービスまでスクロールして選択し、「停止」ボタンをクリックします。エラーが発生することはありますが、サービスの「ステータス」値は「開始」から空白に変わります。「閉じる」ボタンをクリックします。

3.	Windowsの「プログラムの追加と削除」機能を実行して以前のOracle TuxedoまたはOracle WebLogic Enterpriseソフトウェア・バージョンを削除します。「スタート」メニューから、「スタート」→「設定」→「コントロール パネル」→「プログラムの追加と削除」を選択します。「プログラムの追加と削除のプロパティ」ウィンドウが表示されます。

4.	以前のOracle TuxedoまたはOracle WebLogic Enterpriseソフトウェアのエントリまでスクロールし、エントリを選択して「追加/削除」ボタンをクリックします。

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

5.	プロンプトが表示されたら、ソフトウェアのアンインストールを確認します。プログラムの完了後、「コンピュータのプログラムを削除します」ウィンドウが表示されます。

6.	一般にはインストール後にファイルを追加したことが理由で、すべてのディレクトリを削除できなかった場合は、「詳細」ボタンをクリックすると、どのディレクトリが削除されずにシステムに残っているかを確認できます。削除されなかったディレクトリに、変更済のサンプル・ファイルなど、インストール後に変更したファイルが含まれている場合は、それらを一時ディレクトリに移動します。

7.	アンインストールが終了したらシステムを再起動します。

旧リリースのTuxedoからTuxedo 12c リリース2 (12.2.2)へのアップグレード

旧リリースのTuxedoからTuxedo 12c リリース2 (12.2.2)にアップグレードする場合、次の点に注意してください。

•

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

•	Tuxedo 6.5で実行するドメイン・ゲートウェイとTuxedo 12c リリース2 (12.2.2)のドメイン・ゲートウェイ(GWTDOMAIN)との相互運用を可能にするには、Tuxedo 6.5のパッチ・レベルを446にアップグレードする必要があります。

パッチ・レベルを446にアップグレードしない場合は、このTuxedo 12c リリース2 (12.2.2)にドメイン・ゲートウェイのTM_GWT_OLDSECCHECK環境変数を設定する必要があります。Oracle Tuxedo環境変数については、『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)を参照してください。

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

•	このリリースでは、エラー発生時にtpreturn() APIメソッドで例外がスローされます。tpreturn() APIメソッドをtry-catchブロックで起動するように既存のコードを変更する必要があります。これを実行しないと、コードのコンパイルが成功せずに失敗します。

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

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

ホット・アップグレード中に、MASTERをシャットダウンし、MASTERマシンを直列的にバックアップする必要があります。残りの構成に影響はありません。

アップグレード前の注意

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

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

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

•	古いTUXCONFIGファイルを削除する指示が表示されます。TUXCONFIGファイルは、バックアップ・マシンが起動すると自動的に伝播れるので、この指示に関して何の操作も必要ありません。

•	ソフトウェアをロードするときにTLOGを作成します。すでにTLOGがある場合は削除します。

•	アプリケーションのキュー・スペースおよびキューに関しては何もしないでください。

•	ドメイン構成(BDMCONFIG)ファイルがある場合は、そのままにしておきます。

停止時間を最小限に抑えるために、Oracle Tuxedo 12c リリース2 (12.2.2)をMASTERマシンおよびバックアップMASTERにインストールし、旧リリースのクライアントとサーバーが作成されたディレクトリと並行して、%APPDIR%/ $APPDIRで定義されている各マシンのディレクトリにすべてのクライアントとサーバーを再構築することをお薦めします。つまり、各マシンに、旧リリースのアプリケーションとOracle Tuxedo 12c リリース2 (12.2.2)アプリケーションの両方が利用できます。これは要件ではなく、推奨事項です。

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

DMTLOGおよびTLOGがすでに存在する場合、アプリケーションをシャットダウンする前に保留中のトランザクション・ログがないことを確認し、アプリケーションのシャットダウン後にDMTLOGおよびTLOG (存在する場合)を確実に削除するようにしてください。

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

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

1.	次のように環境を設定する必要があります: cR2

•	構成にバックアップMASTERマシンを用意します。

•	構成内のMODELオプションをMPに設定します。

•	構成内のMIGRATEオプションを設定します。

2.	Oracle Tuxedo 9.1マシンをアップグレードする場合、「Oracle Tuxedoのアンインストール」の説明に従ってOracle Tuxedoシステム・ソフトウェアをアンインストールします。

3.	Oracle WebLogic EnterpriseまたはOracle Tuxedo 9.1以前のソフトウェアを実行しているWindowsマシンをアップグレードする場合、「Windows Serverの追加アップグレード手順の実行」で説明する追加手順を行います。

4.	バックアップMASTERマシンを停止します。

5.	バックアップMASTERマシンにOracle Tuxedo 12c リリース2 (12.2.2)ソフトウェアをインストールし、バックアップ・マシンを再起動します。

6.	旧リリースが動作するMASTERマシンを、Oracle Tuxedo 12c リリース2 (12.2.2)が動作するバックアップMASTERマシンに移行します。

7.	バックアップMASTERとなったマシンを停止します。

8.	Oracle Tuxedo 12c リリース2 (12.2.2)を古いMASTERにインストールします。

9.	Oracle Tuxedo 12c リリース2 (12.2.2)を使用して、ステップ7で停止したマシンを再起動します。

ホット・アップグレードの詳細は、次項の「?$paratext>.?」を参照してください。

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

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

UNIXプラットフォームで以下のものがあるとします。

•	MASTERとして構成され、旧リリースを実行するMACH1というマシン

•	$APPDIR1というアプリケーション・ディレクトリが対応しています。

•	$TUXCONFIG1という構成ファイルが対応しています。

•	バックアップとして構成されたMACH2というマシン

•	$APPDIR2というアプリケーション・ディレクトリが対応しています。

•	$TUXCONFIG2という構成ファイルが対応しています。

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

リスト6-1 一般的なホット・アップグレード

MACH1> tmshutdown -B MACH2 -l MACH2
MACH1> Run tmconfig to reset the APPDIR, TUXCONFIG, TUXDIR for MACH2
       MACH2> Kill tlisten process
       MACH2> Load Tuxedo 12cR2 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 12cR2 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 12cR2 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 12cR2 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

 

注意:	リスト6-1で説明したアップグレードをWindowsプラットフォームから実行する場合、tlistenプロセスを停止した後にOracle Tuxedoo procMGR (Oracle Tuxedo 6.5またはOracle WebLogic Enterprise 5.1ではIPC Helper)サービスを停止し、tlistenプロセスを開始する前にOracle Tuxedo procMGRサービスを開始します。

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

Oracle Tuxedoソフトウェアが正しくインストールされた後、Oracle Tuxedo 12c リリース2 (12.2.2)にアップグレードしたシステム上で実行するすべてのアプリケーション・クライアントとサーバーを再ビルドする必要があります。

注意:	以前のOracle TuxedoバージョンからOracle Tuxedo 12cリリース2 (12.2.2)にアップグレードする場合は、再ビルドする必要があります。

以前のOracle TuxedoバージョンからOracle Tuxedo 12c リリース2 (12.2.2)にアップグレードする場合は、TMSサーバーを再ビルドする必要があります。

また、古いTUXCONFIGファイルをすべて削除し、新しくインストールされたtmloadcf(1)を使用して、これらのファイルを再ロードする必要もあります。

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

「最新リリースを実行する」というルールには、重要な例外が1つあります。Oracle Tuxedoシステム・サーバー・マシンをOracle Tuxedo 12cリリース2 (12.2.2)にアップグレードせずに、Oracle Tuxedo 12cリリース2 (12.2.2)をワークステーション・クライアントのみにインストールすることもできます。つまり、Oracle Tuxedo 6.5以降のすべてのリリース・レベルでは、MASTERがOracle Tuxedo 6.5以降を実行する構成に、ワークステーション・クライアントが混在してもかまいません。

オブジェクト・ファイルからライブラリへの変更

Oracle Tuxedoリリース12.1.3 (以下)では、一部のOracle Tuxedo機能はオブジェクト・ファイルで提供されます。このOracle Tuxedoリリースでは、これらのオブジェクト・ファイルはライブラリにパッケージされています。対応する実行可能ファイルを再ビルドする場合、表6-1に示すように、オブジェクト・ファイルではなく関連するライブラリとリンクする必要があります。

 

表6-1 オブジェクト・ファイルからライブラリへの変更

オブジェクト・ファイル	ライブラリ	リンク・オプション(UNIX/Linux)	使用方法
cleanupsrv.o	libtux.so / libtux.dll / libtux.sl	-ltux	cleanupsrv
enqdeqmq.o	libtuxmq.so / libtuxmq.dll / libtuxmq.sl	-ltuxmq	TMQUEUE_MQM
tm_mqi.o	libtuxmq.so / libtuxmq.dll / libtuxmq.sl	-ltuxmq	TM_MQI
tm_mqi_st.o	libtuxmq.so / libtuxmq.dll / libtuxmq.sl	-ltuxmq	TM_MQI
tm_mqo.o	libtuxmq.so / libtuxmq.dll / libtuxmq.sl	-ltuxmq	TM_MQO
tgiopservice.o	liborb.so / liborb.dll / liborb.sl	-lorb	TMIFRSVR
TMQFORWARD.o	libqm.so / libqm.dll / libqm.sl	-lqm	TMQFORWARD
TMQUEUE.o	libqm.so / libqm.dll / libqm.sl	-lqm	TMQUEUE
tpfwinit.o	libnative.so / libnative.dll / libnative.sl	-lnative	TMNTS
tsam_ext.o	libtmagent.so / libtmagent.dll / libtmagent.sl	-ltmagent	tsambegin()/tsamend()を使用するTuxedoサービス。
usort.o	libusort.so / libusort.dll / libusort.sl	-lusort

Oracle WebLogic ServerでのOracle Jolt 12c リリース2 (12.2.2)のインストール

この項では、Oracle Jolt 12cリリース2 (12.2.2)をOracle WebLogic Server 9.x、10.xまたは12.1.xおよびOracle Tuxedo 9.0、9.1、10.0、10.3、11.1.1.x、12.1.1、12.1.3または12.2.2とともに使用するユーザーを対象に追加のインストール手順を説明します。Oracle Jolt for Oracle WebLogic Serverと呼ばれるJoltクライアント・パーソナリティ・ソフトウェアをOracle WebLogic Server 9.x、10.xまたは12.1.xマシンにインストールするには、Joltクライアント・パーソナリティ・ソフトウェアをOracle Tuxedo 12cリリース2 (12.2.2)マシンからターゲットのOracle WebLogic Serverマシンにコピーします。Oracle Tuxedo 12c リリース2 (12.2.2)マシンとターゲットのOracle WebLogic Serverマシンが同じマシンである場合、Joltクライアント・ライブラリ・クラス・ファイルをCLASSPATH変数設定に含める必要があるのみです。

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

Oracle WebLogic ServerでのJolt接続プールの構成については、「Oracle WebLogic ServerでのOracle Joltの使用」を参照してください。