次の各項で、Oracle TuxedoまたはOracle WebLogic EnterpriseアプリケーションをOracle Tuxedo 12c リリース2 (12.1.3)にアップグレードする場合の、簡易アップグレードおよびホット・アップグレードの手順を説明します。
Oracle Tuxedo 12c リリース2 (12.1.3)ソフトウェアをマシンにインストールする前に、必要なバージョンのオペレーティング・システムおよびコンパイラがインストールされていることを確認します。それぞれのサポートされているプラットフォームでのオペレーティング・システムおよびコンパイラの要件は、「Oracle Tuxedo 12cリリース2 (12.1.3)プラットフォーム・データ・シート」を参照してください。
Oracle Tuxedo 12c リリース2 (12.1.3)をインストールするプラットフォームに旧リリースのOracle TuxedoソフトウェアまたはOracle WebLogic Enterpriseソフトウェアがインストールされている場合、次の手順を熟読してください。
アップグレードの際にアプリケーションの停止が可能であれば、アプリケーションを停止して簡易アップグレードを実行します。簡易アップグレードを実行する手順は、「簡易アップグレードの実行」を参照してください。
アップグレードのためにアプリケーションを停止できない場合、次のいずれかのソフトウェア製品であれば、エンタープライズを停止せずに、Oracle Tuxedo 12c リリース2 (12.1.3)へのホット・アップグレードを実行できます。
既存のアプリケーションを停止せずに、Oracle Tuxedo 12c リリース2 (12.1.3)ソフトウェアを既存のOracle TuxedoまたはOracle WebLogic Enterpriseドメインに追加したり、既存のアプリケーションを停止せずに、新規のOracle Tuxedo 12c リリース2 (12.1.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管理コンソール・サーバーおよび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
ディレクトリに追加したファイルを一時的な場所に移動します。
DMTLOG
およびTLOG
がすでに存在する場合は、保留中のトランザクション・ログがないことを確認してください。tmunloadcf(1)
コマンドを実行し、MASTER
マシンの構成ファイルのテキスト・バージョンを更新します。MASTER
マシンおよびバックアップMASTER
マシンにOracle Tuxedo 12c リリース2 (12.1.3)ソフトウェアをインストールします。tmloadcf(1)
コマンドをMASTER
マシンで実行し、構成ファイルのテキスト・バージョンを再ロードします。DMTLOG
およびTLOG
がすでに存在する場合、それらを削除します。
Oracle WebLogic EnterpriseまたはOracle Tuxedo 12c リリース2 (12.1.3)またはそれ以前のソフトウェアが実行されているWindowsマシンの場合、クリーンなシステムで起動するよう、Oracle Tuxedo 12c リリース2 (12.1.3)ソフトウェアをインストールする前に次の追加手順を実行してください。
procMGR
サービスを停止します。「スタート」メニューから、「スタート」「すべてのプログラム」「管理ツール」「サービス」をクリックします。「サービス」ウィンドウが開きます。注: | Oracle Tuxedo procMGR サービスは、Oracle Tuxedo 6.5またはOracle WebLogic Enterprise 5.1ではIPC Helperと呼ばれています。 |
注: | WebLogic Enterprise 5.1のC++コンポーネントとJavaコンポーネントの両方がインストールされている場合、C++ソフトウェアを削除する前にJavaソフトウェアを削除する必要があります。 |
旧リリースのTuxedoからTuxedo 12c リリース2 (12.1.3)にアップグレードする場合、次の点に注意してください。
servopts -t
オプションを指定する必要があります。サーバーとしては、ワークステーション・リスナー(WSL)プロセス、ドメイン・ゲートウェイ(GWTDOMAIN)プロセス、システム・プロセス、またはアプリケーション・サーバー・プロセスを使用できます。ワークステーション・リスナー・プロセスの場合は、servopts -t
オプションを使用して起動すると、すべてのワークステーション・ハンドラ(WSH)プロセスで相互運用が可能になります。詳細は、『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のGWTDOMAIN(5)
を参照してください。 パッチ・レベルを446にアップグレードしない場合は、このTuxedo 12c リリース2 (12.1.3)にドメイン・ゲートウェイのTM_GWT_OLDSECCHECK
環境変数を設定する必要があります。Oracle Tuxedo環境変数については、『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のtuxenv(5)
を参照してください。
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.1.3)に移行した後、バックアップをOracle Tuxedo 12g リリース2 (12.1.3)にアップグレードするまで、代理のバックアップを元に戻すことはできません。つまり、MASTER
マシンの移行は元に戻せません。移行が完了したら、MASTER
マシンを以前に動作していたOracle Tuxedoバージョンに戻すことはできません。
旧リリースのMASTER
のOracle Tuxedo 12c リリース2 (12.1.3)マシンでtmadmin(1)
を実行する場合、UPGRADE
ファイルはカレント・ディレクトリにある必要があります(「ホット・アップグレードの例」を参照)。このファイルがカレント・ディレクトリにあることを確認するには、たとえば、Tuxedoアプリケーション・ディレクトリ(%APPDIR%
(Windows)/ $APPDIR
(UNIX)ディレクトリ)からtmadmin
を実行します。
移行時には、Oracle Tuxedoデータ・ストレージ領域に関して次のガイドラインに従うように注意してください。
停止時間を最小限に抑えるために、Oracle Tuxedo 12c リリース2 (12.1.3)をMASTER
マシンおよびバックアップMASTER
にインストールし、旧リリースのクライアントとサーバーが作成されたディレクトリと並行して、%APPDIR%
/ $APPDIR
で定義されている各マシンのディレクトリにすべてのクライアントとサーバーを再構築することをお薦めします。つまり、各マシンに、旧リリースのアプリケーションとOracle Tuxedo 12c リリース2 (12.1.3)アプリケーションの両方が利用できます。これは要件ではなく、推奨事項です。
Oracle Tuxedoソフトウェアは、最大256バイトのデバイス・リスト・パス・エントリをサポートしています(旧リリースでは長さの制限は64バイトです。)Oracle Tuxedoの旧リリースで作成されたキュー・スペース、TLOGファイル、その他の構成ファイルは、このリリースでも認識およびサポートされます。ただし、Oracle Tuxedo 8.0以前のリリースで作成されたデバイス・リストは、パス名が64バイトに制限されています。このため、将来64バイトを超える長さのパス名を使用してキュー・スペースに新しい領域を追加しようと考えており、アップグレード時にこのようなキュー・スペースが空の場合、システム管理者はホット・アップグレード時にキュー・スペース・デバイス・リストとキュー・スペースを作成できます。多くのアプリケーションは、アップグレード中にキュー・スペースを保持する必要があり、それらを再作成できません。さらに、ほとんどのアプリケーションは将来キュー・スペースに領域を追加する必要がないか、または現在使用しているパス名以下の長さのパス名を使用して領域を追加できます。このキュー・スペースの再作成はまったくの任意であり、ここでの説明はあくまで補完的なものです。
DMTLOG
およびTLOG
がすでに存在する場合、アプリケーションをシャットダウンする前に保留中のトランザクション・ログがないことを確認し、アプリケーションのシャットダウン後にDMTLOG
およびTLOG
(存在する場合)を確実に削除するようにしてください。
この項では、ホット・アップグレードのタスクについて説明します。
MASTER
マシンを停止します。MASTER
マシンにOracle Tuxedo 12c リリース2 (12.1.3)ソフトウェアをインストールし、バックアップ・マシンを再起動します。MASTER
マシンを、Oracle Tuxedo 12c リリース2 (12.1.3)が動作するバックアップMASTER
マシンに移行します。MASTER
となったマシンを停止します。MASTER
にインストールします。ホット・アップグレードの詳細は、次項の「ホット・アップグレードの例」を参照してください。
次の例は、ホット・アップグレードのサンプル・シナリオとホット・アップグレードの実行手順を示したものです。
リスト4-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
注: | リスト4-1で説明したアップグレードをWindowsプラットフォームから実行する場合、tlisten プロセスを停止した後にOracle Tuxedo procMGR (Oracle Tuxedo 6.5またはOracle WebLogic Enterprise 5.1ではIPC Helper)サービスを停止し、tlisten プロセスを開始する前にOracle Tuxedo procMGR サービスを開始します。 |
Oracle Tuxedoソフトウェアが正しくインストールされた後、Oracle Tuxedo 12c リリース2 (12.1.3)にアップグレードしたシステム上で実行するすべてのアプリケーション・クライアントとサーバーを再ビルドする必要があります。
注: | 以前のOracle TuxedoバージョンからOracle Tuxedo 12cリリース2 (12.1.3)にアップグレードする場合は、再ビルドする必要があります。 |
注: | 以前のOracle TuxedoバージョンからOracle Tuxedo 12cリリース2 (12.1.3)にアップグレードする場合は、TMSサーバーを再ビルドする必要があります。 |
また、古いTUXCONFIG
ファイルをすべて削除し、新しくインストールされたtmloadcf(1)
を使用して、これらのファイルを再ロードする必要もあります。
Oracle Tuxedoシステム・アプリケーションが分散化されている場合、MASTER
マシンとバックアップMASTER
マシンでは、構成内のマシンの中で最も新しいリリースのOracle Tuxedoシステムを実行しなければなりません。ワークステーション・クライアントなどほかのマシンでは、以前のリリースの実行可能ファイルをそのまま使用できます。たとえば、MASTER
とバックアップMASTER
マシンでOracle Tuxedo 12c リリース2 (12.1.3)を実行していても、その他のマシンではOracle Tuxedo 6.5以降が使用されることがあります。
「最新リリースを実行する」というルールには、重要な例外が1つあります。Oracle Tuxedoシステム・サーバー・マシンをOracle Tuxedo 12c リリース2 (12.1.3)にアップグレードせずに、Oracle Tuxedo 12c リリース2 (12.1.3)をワークステーション・クライアントのみにインストールすることもできます。つまり、Oracle Tuxedo 6.5以降のすべてのリリース・レベルでは、MASTER
がOracle Tuxedo 6.5以降を実行する構成に、ワークステーション・クライアントが混在してもかまいません。
この項では、Oracle Jolt 12cリリース2 (12.1.3)を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とともに使用するユーザーを対象に追加のインストール手順を説明します。Oracle Jolt for Oracle WebLogic Serverと呼ばれるJoltクライアント・パーソナリティ・ソフトウェアをOracle WebLogic Server 9.x、10.xまたは12.1.xマシンにインストールするには、Joltクライアント・パーソナリティ・ソフトウェアをOracle Tuxedo 12cリリース2 (12.1.3)マシンからターゲットのOracle WebLogic Serverマシンにコピーします。Oracle Tuxedo 12c リリース2 (12.1.3)マシンとターゲットの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の使用」を参照してください。