次の各項で、Oracle Tuxedoのインストール後に実行するタスクを説明します。
Oracle Tuxedoソフトウェアのインストール中に、インストーラ・プログラムによって、完全インストールの場合は次のディレクトリ構造が作成されます。完全インストールには、すべてのOracle Tuxedoサーバーおよびクライアント・ソフトウェア・コンポーネントと、リンク・レベルの暗号化(LLE)およびSecure Sockets Layer(SSL)暗号化ソフトウェア・パッケージが含まれます。
図6-1に、Oracle Tuxedo 11gリリース1(11.1.1.2.0)のディレクトリ構造を示します。
ここに示されているtuxedo
11gリリース1(11.1.1.2.0)の製品ディレクトリは、Oracle Tuxedo 11gリリース1(11.1.1.2.0)のデフォルトです。デフォルト名はインストール時に変更できます。
Oracle Tuxedoディレクトリ構造の最上位レベルのディレクトリおよびファイルについて、表6-1で簡単に説明しています。
図6-2に、Oracle Tuxedoアーキテクチャの基礎となるOracle Tuxedoのドメインを示します。
TuxedoドメインはTuxedoアプリケーションとも呼ばれ、Tuxedoシステム上に構築されたビジネス・ソフトウェア・プログラムで、1つの構成ファイルUBBCONFIG
によって定義および制御されます。Tuxedoドメインは、多数のシステム・プロセス、1つ以上のアプリケーション・クライアント・プロセス、1つ以上のアプリケーション・サーバー・プロセス、およびネットワークで接続された1つ以上のコンピュータ・マシンで構成されます。
インストール後のチェックを実行する前にOracle Tuxedoに関して知っておく必要のある重要な用語および概念について、次の各項で簡潔に説明されています。
この時点でこれらの用語について完全に理解する必要はなく、これらの項をリファレンスとして利用してください。インストール後の手順でこれらの用語が出てきたら、これらの項を参照して用語の意味を確認してください。
Tuxedoドメインは、構成ファイルによって制御され、このファイルには、インストール時の設定に基づくパラメータが定義されています。この構成ファイルのテキスト・バージョンはUBBCONFIG
と呼ばれていますが、ファイルの内容が『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のリファレンス・ページUBBCONFIG(5)の項に示されているフォーマットに従っている限り、このファイルに任意の名前を付けることができます。
TuxedoドメインのUBBCONFIG
ファイルには、アプリケーションを起動するために必要なすべての情報、たとえばリソース、マシン、グループ、サーバー、使用可能なサービスなどのリストが含まれています。9つのセクションで構成され、そのうちの5つのセクション、RESOURCES
、MACHINES
、GROUPS
、SERVERS
およびSERVICES
はすべての構成に必要です。
TuxedoドメインのMASTER
マシン、またはMASTER
ノードは、ドメインのUBBCONFIG
ファイルが格納され、UBBCONFIG
ファイルのRESOURCES
セクションでMASTER
マシンとして指定されます。Tuxedoドメインは、MASTER
マシンを使用して起動、停止、および管理します。
異なるリリースのTuxedoシステム・ソフトウェアを実行している複数のマシンで構成されるTuxedoドメインでは、MASTER
はドメイン内の最新のリリースのTuxedoシステム・ソフトウェアを実行している必要があります。
TUXCONFIG
ファイルは、UBBCONFIG
ファイルのバイナリ・バージョンです。tmloadcf(1)
コマンドの実行によって作成され、これによってUBBCONFIG
が解析され、バイナリTUXCONFIG
ファイルがTUXCONFIG
環境変数によって参照される場所にロードします。UBBCONFIG
と同様に、TUXCONFIG
ファイルには任意の名前を使用できます。
TuxedoドメインのMASTER
マシンには、TUXCONFIG
ファイルのマスター・コピーが存在します。TuxedoシステムがMASTER
マシンで起動されるたびに、TUXCONFIG
ファイルのコピーが、Tuxedoドメイン内の他のすべてのサーバー・マシン(非MASTER
マシンと呼ばれる)に伝播されます。
TUXCONFIG
環境変数により、MASTER
マシン上でtmloadcf(1)
コマンドによってバイナリTUXCONFIG
ファイルがロードされる場所が定義されます。TUXCONFIG
をロードする端末またはシステム・ファイルで終了する絶対パス名を設定する必要があります。
TUXCONFIG
パス名の値は、UBBCONFIG
ファイルのMACHINES
セクションで指定されます。MASTER
マシンおよびTuxedoドメイン内のすべての他のサーバー・マシンについて指定されます。システムの起動時にバイナリTUXCONFIG
ファイルが非MASTER
マシンに伝播されると、コピーはTUXCONFIG
パス名の値に従って非MASTER
マシンに保存されます。
TUXDIR
環境変数により、MASTER
マシン上でのOracle Tuxedoソフトウェアの製品インストール・ディレクトリが定義されます。製品インストール・ディレクトリの名前で終了する絶対パス名を設定する必要があります。
TUXDIR
パス名の値は、UBBCONFIG
ファイルのMACHINES
セクションで指定されます。MASTER
マシンおよびTuxedoドメイン内のすべての他のサーバー・マシンについて指定されます。
Oracle Tuxedo付属のクライアント・プログラムは、自分の許可を持つユーザーによって直接実行されます。さらに、ネイティブ・クライアント(サーバー・プログラムと同じマシンで実行中のクライアント)を実行するユーザーは、UBBCONFIG
ファイルにアクセスしたり、掲示板(アプリケーションを制御するパラメータおよびアプリケーションの統計情報を格納するために確保されている共有メモリーの一部)などのプロセス間通信(IPC)のメカニズムにアクセスできます。
Oracle Tuxedo機能にアクセスできるようにするために、ネイティブ・クライアントはアプリケーション管理者(tpsysadm
)のアイデンティティを使用してOracle Tuxedoアプリケーションに参加します。ただし、tpsysadm
は信頼されたユーザーであるため、この設定によってOracle Tuxedoシステムはユーザー認証プロセスを迂回することになります。
Windows 2003 Serverマシンにおけるこのセキュリティの欠如を防ぐために、次の手順を実行してください。
Oracle Tuxedoを使用してOracle Tuxedoアプリケーションを作成および実行する前に、いくつかの環境変数を設定する必要があります。表6-2、表6-3、表6-4、表6-5に、これらの環境変数の中のいくつかについて説明し、定義を示します。
Windows 2003サーバー・マシンでは、環境を設定するには表6-6の環境変数を設定する必要があります。
TUXDIR
、APPDIR
、およびTUXCONFIG
の例は次のとおりです。
TUXDIR=C:\Oracle\tuxedo11gR1
APPDIR=C:\home\me\simpapp
TUXCONFIG=%APPDIR%\tuxconfig
TUXDIR
、APPDIR
、およびTUXCONFIG
環境変数は、UBBCONFIG
ファイルのMACHINES
セクションのTUXDIR
、APPDIR
、およびTUXCONFIG
パラメータの値と一致しなければなりません。コマンドライン・シェルから環境変数を設定する代わりに、Oracle Administrationプログラムの[Environment]ページを使用する方法があります。『Windows NTでのTuxedoシステムの使用』の「環境変数を設定および修正する」を参照してください。
Windows 2003 Serverは、PATH
変数に設定されたパスを使って、動的に読込み可能な必須ライブラリ・ファイルにアクセスします。具体的には、次の順序で動的に読込み可能なライブラリ・ファイルが検索されます。
環境変数の詳細は、WindowsでのOracle Tuxedo ATMIの使用の「環境変数を設定および修正する」を参照してください。
UNIXサーバー・マシンでは、環境を設定するには表6-7の環境変数を設定し、エクスポートします。
|
||
TUXDIR
、APPDIR
、およびTUXCONFIG
の例は次のとおりです。
TUXDIR=/home/Oracle/tuxedo11gR1
APPDIR=/home/me/simpapp
TUXCONFIG=$APPDIR/tuxconfig
TUXDIR
、APPDIR
、およびTUXCONFIG
環境変数は、UBBCONFIG
ファイルのMACHINES
セクションのTUXDIR
、APPDIR
、およびTUXCONFIG
パラメータの値と一致しなければなりません。UNIXシステム上でこれらの環境変数やその他の環境変数を設定するモデルとして、Oracle Tuxedo製品ディレクトリにあるtux.env
というBourneシェル・スクリプトを使用します。
アプリケーション管理者は、アプリケーションを起動する前に、ネットワーク接続されたOracle Tuxedoアプリケーションの各マシンのtlisten
プロセスを開始する必要があります。tlisten
プロセスを使用すると、管理者とMASTER
マシンで実行中のOracle Tuxedoソフトウェアは、非MASTER
マシンで実行中のOracle Tuxedoプロセスを開始、停止、および管理することができます。たとえば、tmboot(1)
を使用すると、非MASTER
マシン上のOracle Tuxedoシステム・サーバーを開始できます。一般に、tlisten
は、サーバー・マシン上で実行中のOracle Tuxedoアプリケーションごとに1つ必要です。
Oracle Tuxedoのインストール時にポート3050でtlisten
プロセスを開始するインストーラ・プログラムに加えて、表6-8 tlistenプロセスに示されているようにtlisten
プロセスを開始できます。
Oracle Administrationプログラムの「Listener」ページ。詳細は、WindowsでのOracle Tuxedo ATMIの使用の「tlistenプロセスを自動的に起動する」を参照してください。
|
||
いずれの場合も、tlisten
の起動には同じ基本構文が使用されます。
%TUXDIR%\bin\tlisten -l
nlsaddr
[-u
appuid
] (Windows)$TUXDIR/bin/tlisten
[-d
devname
] -l
nlsaddr
[-u
appuid
] (UNIX)
-l
オプションは必須です。-l
に渡す引数は、UBBCONFIG
ファイルにあるNETWORK
セクションのNLSADDR
パラメータの値と一致していなければなりません。NLSADDR
の値の調べ方については、『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』の「UBBCONFIG(5)」を参照してください。
devname
の値はネットワーク・プロバイダのデバイス名(Starlanなど)です。tlisten
プロセスがソケットを使用して実行されている場合、-d
オプションは不要です。
appuid
の値は、Oracle Tuxedoアプリケーション管理者のユーザー識別子(UID)またはログイン名です。これは、UBBCONFIG
ファイルのRESOURCES
セクションにあるUID
パラメータの値と一致している必要があります。
注意: | UNIXシステム上でUIDを取得するには、id コマンドを実行します。 |
UNIXマシンでは、このコマンドがroot
によって実行されるインストール・スクリプトの一部である場合、-u
appuid
オプションを使用して、このマシンにインストールされているOracle Tuxedoソフトウェアのオーナーの有効なUIDでtlisten
プロセスを実行します。tlisten
がOracle Tuxedoアプリケーション管理者によってcron
ジョブとして、または手動で開始される場合、ジョブはすでに適切なアカウントによって所有されているので、-u
オプションは必要ありません。
tlisten
コマンドの詳細は、 Oracle Tuxedoコマンド・リファレンスのtlisten(1)
に関するリファレンス・ページを参照してください。Windows 2003サーバー・マシンでtlisten
プロセスを開始する手順の詳細は、 WindowsでのOracle Tuxedo ATMIの使用の tlistenプロセスを自動的に開始するための構成に関する項を参照してください。
Oracle Tuxedoでは、インストール時に指定した管理用パスワードを使用して、認可されていない管理リクエストや操作(tmboot(1)
など)から、Oracle Tuxedoがインストールされているマシンを保護します。tlisten(1)
またはwlisten(1)
ゲートウェイ・プロセスを介して管理通信情報がこのマシンに到着するたびに、Oracle Tuxedoはtlistenパスワードでそれらのアクセスを認証します。
tlisten
パスワードは、クリア・テキスト形式の英数字であることが必要です。長さは80文字までです。
Oracle Tuxedoアプリケーション内にある2台のマシンが交信するには、共通のパスワードが必要です。そのため、単一アプリケーション内にある複数のマシンにOracle Tuxedoをインストールする場合は、必ず同じパスワードを使用します。ただし、Oracle Tuxedoのインストール時にマシンごとに異なるパスワードを使用した場合は、そのマシンの交信相手となる既存のマシンのtlisten.pw
ファイルに、tlistpwd(1)
$TUXDIR
ユーティリティを使用してそのマシンのパスワードを追加する必要があります。
これらの理由から、tlisten.pw
ファイルには複数の管理用パスワードを追加できます。1つのパスワード・ファイルには、20のパスワードを1行に1つずつ格納できます。
注意: | tlisten.pw ファイルは、システムによって暗号化されています。パスワードを追加または変更するには、tlistpwd(1) ユーティリティを使用する必要があります。 |
Oracle Tuxedoアプリケーションは、構成ファイルによって制御されます。このファイルには、インストール時の設定に基づくパラメータが定義されています。Oracle Tuxedoのマニュアルではこの構成ファイルをUBBCONFIG
と呼んでいますが、ファイルの内容が『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』の「UBBCONFIG(5)」に示されているフォーマットに従っている限り、このファイルに任意の名前を付けることができます。通常、構成ファイル名は文字列ubb
で開始し、その後にわかりやすい名前を続けます。たとえば、simpleの場合はubbsimple
というファイル名にします。
Oracle Tuxedoのインストールで配布されるATMIベースの基本的なsimpapp
アプリケーションのUBBCONFIG
ファイル、ubbsimple
を例として考えてみます。Windowsシステムではこのアプリケーションはディレクトリ%TUXDIR%\samples\atmi\simpapp
にあり、UNIXシステムではディレクトリ$TUXDIR/samples/atmi/simpapp
にあります。
リスト6-1は、サンプルのubbsimple
ファイルを示しています。リスト内の例は、WindowsまたはUNIXシステムに配布されたubbsimple
ファイルから変更されて、例で示したWindowsおよびUNIXシステムのパス名の値が含まれています。
#ident “@(#)apps:simpapp/ubbsimple $Revision: 1.3 $
#Skeleton UBBCONFIG file for the Tuxedo Simple Application.
#Replace the <bracketed> items with the appropriate values.
*RESOURCES
IPCKEY <Replace with a valid IPC Key>
#Example:
#IPCKEY 123456
DOMAINID simpapp
MASTER simple
MAXACCESSERS 10
MAXSERVERS 5
MAXSERVICES 10
MODEL SHM
LDBAL N
*MACHINES
DEFAULT:
APPDIR=“<Replace with the current directory pathname>”
TUXCONFIG=“<Replace with your TUXCONFIG Pathname>”
TUXDIR=“<Directory where Tuxedo is installed>”
#Windows
#Example:
# APPDIR=“C:\home\me\simpapp”
# TUXCONFIG=“C:\home\me\simpapp\tuxconfig”
# TUXDIR=“C:\oracle\tuxedo11gR1”
#UNIX
#Example:
# APPDIR=“/home/me/simpapp”
# TUXCONFIG=“/home/me/simpapp/tuxconfig”
# TUXDIR=“/home/oracle/tuxedo11gR1”
<Machine-name> LMID=simple
#Example:
#beatux LMID=simple
*GROUPS
GROUP1
LMID=simple GRPNO=1 OPENINFO=NONE
*SERVERS
DEFAULT:
CLOPT=“-A”
simpserv SRVGRP=GROUP1 SRVID=1
*SERVICES
TOUPPER
実際の構成ファイルでは、ご使用のアプリケーションに固有の値で、大カッコ内の文字列を置き換えてください。リスト6-9は、すべての構成ファイルで定義する必要があるパラメータの例です。
APPDIR
、TUXCONFIG
、およびTUXDIR
は、Oracle Tuxedoアプリケーション内のすべてのマシンに設定する必要があります。UBBCONFIG
ファイルの編集時にほかのパラメータを確認する必要がある場合は、『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』の「UBBCONFIG(5)」を参照してください。
UBBCONFIG
ファイルの編集は、tmloadcf(1)
を実行してIPC要件を確認する前に行う必要があります。次の節を参照してください。最初にUBBCONFIG
ファイルを編集せずにtmloadcf
を実行すると、構文エラーになります。
構成ファイルにあるMACHINES
セクションのTYPE
パラメータは、異なるマシン間にメッセージが渡された際の外部データ表現(XDR)エンコード/デコード・ルーチンの呼出しを指定します。同じ種類のマシンの場合でも、各マシンのコンパイラが異なるときは、「異なる」マシンとして扱います。そのような場合は、各マシンに一意のTYPE
文字列を指定して、すべてのメッセージが強制的にエンコード/デコード・ルーチンを通過するようにします。
Oracle Tuxedoシステムでは、UNIXのプロセス間通信(IPC)資源を頻繁に使用します。大半のシステムでは、各種IPC資源のサイズと数量を制御するパラメータのデフォルト値が、小さなOracle Tuxedoアプリケーションの実行に最低限必要な値よりも低く設定されています。そのため、パラメータによってはリセットが必要なものがあります。UBBCONFIG
ファイルの編集後、アプリケーションに対してIPCリソースが適切に設定されているどうかを判断する必要があります。
この処理を実行するには、編集後のUBBCONFIG
ファイルを入力として指定して、次のtmloadcf(1)
コマンドを入力します。
tmloadcf -c UBBCONFIG
-c
オプションを使用すると、tmloadcf
プログラムではアプリケーションに必要最小限のIPCリソースのリストが出力されますが、TUXCONFIG
ファイルの作成も更新も行われません。
リスト6-2は、ubbsimple
の値に基づいた出力レポートです。
Ipc sizing (minimum /T values only)...
Fixed Minimums Per Processor
SHMMIN: 1
SHMALL: 1
SEMMAP: SEMMNI
Variable Minimums Per Processor
SEMUME, A SHMMAX
SEMMNU, * *
Node SEMMNS SEMMSL SEMMSL SEMMNI MSGMNI MSGMAP SHMSEG
------ ------ ------ ------ ------ ------ ------ ------
sftuxe 17 5 12 A + 1 13 26 75K
where 1 <= A <= 8.
The number of expected application clients per processor should be added to eachMSGMNI
value.
出力レポートでは、IPC資源が従来のUNIX名で識別されます。従来の名前とUNIXプラットフォーム固有の名前のマッピングを確認するには、「Oracle Tuxedo 11gリリース1(11.1.1.2.0)プラットフォーム・データ・シート」で該当するプラットフォームのデータ・シートを参照してください。従来の名前とWindows 2003プラットフォーム固有の名前のマッピングを確認するには、WindowsでのOracle Tuxedo ATMIの使用のWindowsシステムとUNIXシステムのIPCリソース名の対応に関する項を参照してください。
このサンプル出力レポートは、simpapp
の実行にはシステムでSEMUME
、SEMMNU
、およびSEMMNS
を少なくとも17に設定する必要があることを示しています。SEMMSL
は5以上、SEMMNI
とSEMMAP
はAの値が3であれば4以上に設定する必要があります。MSGMNI
は13以上、MSGMAP
は26以上でなければなりません。SHMMAX
とSHMSEG
の積は75 KB以上になることが必要です。
IPC値はアプリケーションによって異なるので、ここで示す数値は小さな構成での例にすぎません。IPC資源を使用する別のクライアントまたはサーバー・アプリケーションがOracle Tuxedoアプリケーションと同じシステムで実行している場合は、両方のアプリケーションの要件を満たす必要があります。アプリケーションに参加するすべてのマシンが十分なIPC資源を使用できなければなりません。
IPC資源が不十分な場合は、該当するIPCパラメータの値を大きくします。Windows 2003 Serverシステムの現在のIPC値を変更する手順については、WindowsでのOracle Tuxedo ATMIの使用のシステムのパフォーマンスが最大限になるようなIPCリソースの設定に関する項を参照してください。UNIXシステムの現在のIPC値を変更する手順については、「Oracle Tuxedo 11gリリース1(11.1.1.2.0)プラットフォーム・データ・シート」を参照してください。
グローバル・トランザクションに参加するアプリケーション内の各マシンで、汎用デバイス・リスト(UDL)を作成し、グローバル・トランザクション・ログ(TLOG)のUDLエントリを定義します。TLOGは、トランザクションが終了するまで、トランザクションに関する情報が保持されているログです。
UDLを作成し、TLOGのUDLエントリを定義する前に、グローバル・トランザクションに参加するアプリケーション内の各マシンで、UBBCONFIG
ファイルのMACHINES
セクションの以下のパラメータを設定する必要があります。
表6-10はパラメータを示します。
TUXCONFIG
ファイルとTLOGの両方を格納します。その場合、デバイスのパス名をTUXCONFIG
とFSCONFIG
環境変数に設定します。
TLOGDEVICE
のUDLエントリは、TLOGが必要な各マシンで手動で作成する必要があります。エントリを作成するのはTUXCONFIG
をロードする前でも後でもかまいませんが、アプリケーションを起動する前でなければなりません。
デバイス・リストの作成コマンドcrdl
にアクセスするには、アプリケーションがアクティブでない状態でtmadmin -c
を起動します。-c
オプションにより、tmadmin
が構成モードで起動されます。
グローバル・トランザクションに参加するアプリケーション内の各マシンで、UDLとTLOGのUDLエントリを作成するには、次の手順に従います。
MASTER
マシンにログインします。tmadmin -c
crdl -z config -b blocks
-z
config
には、UDLの格納先デバイス(TLOGの常駐先デバイス)のフルパス名を指定します。-b
blocks
には、デバイスに割り当てるブロック数を指定します。config
の値は、UBBCONFIG
ファイルにあるMACHINES
セクションのTLOGDEVICE
パラメータの値と一致していなければなりません。ブロック数は、TLOGSIZE
の値より大きくなければなりません。-z
を指定しないと、config
の値はデフォルトによってFSCONFIG
環境変数の値に設定されます。
MASTER
マシンにアプリケーション管理者としてログインして、ステップ2を繰り返します。 TLOGDEVICE
が2つのマシン間でミラーリングされる場合は、片方のマシンに対してステップ3を実行する必要はありません。TLOGを障害から回復できるようにするには、TLOGをミラーリング可能なデバイス上に配置する必要があります。
Oracle Tuxedoソフトウェアが正しくインストールされているかどうかを確認する方法の1つは、インストール時に提供される1つまたは複数のサンプル・アプリケーションを実行することです。サンプル・アプリケーションでは、ATMIおよびCORBAクライアントと、ATMIおよびCORBA C++サーバーの機能が具体的に示されます。
以下の項では、インストールしたOracle TuxedoのATMIおよびCORBA C++関連の部分を確認する手順について説明します。
simpapp
アプリケーションは非分散アプリケーションです。つまり、1台のマシン上で動作します。Oracle Tuxedoソフトウェアをインストールした数分後に起動して動作できるように設計されています。
simpapp
アプリケーションは、文字列を小文字から大文字に変換するTOUPPER
という1つのサービスを提供します。クライアントは、大文字に変換する小文字の文字列だけを引数にして呼び出されます。サーバーは変換後の文字列をクライアントに返し、クライアントはその文字列を出力します。
simpcl “hello world”
Returned string is: HELLO WORLD
simpapp
には、ATMIバージョンとCORBAバージョンがあります。ATMIバージョンは、ATMIサーバー、ATMIクライアント、およびUBBCONFIG
ファイルで構成されています。CORBAバージョンは、CORBA C++サーバーとCORBA C++クライアントで構成されています。
Oracle Tuxedo ATMIソフトウェアが正しくインストールされているかどうかを確認するには、ATMIバージョンのsimpapp
アプリケーションを実行します。このアプリケーションは、Windowsシステムではディレクトリ%TUXDIR%\samples\atmi\simpapp
にあり、UNIXシステムではディレクトリ$TUXDIR/samples/atmi/simpapp
にあります。
注意: | サンプルは、Tuxedo 11gR1インストール時にインストールすることを選択しないとインストールされません。 |
次の2つの項で示されている手順は、simpapp
ディレクトリのREADME
ファイルと、 『Oracle Tuxedo ATMIアプリケーションの開発チュートリアル』の単純なCアプリケーションsimpappのチュートリアルに関する項でも説明されています。
Windowsシステム上でATMIバージョンのsimpapp
を構成して実行するには、次の手順に従います。
Administrator
またはAdministrator
グループのメンバーとしてターゲット・マシンにログインし、コマンドライン・シェルを開きます。cd C:\home\me
mkdir atmi
cd atmi
APPDIR
とTUXCONFIG
を次のように設定します。set APPDIR=C:\home\me
\atmi
set TUXCONFIG=%APPDIR%\tuxconfig
注意: | WEBJAVADIR 環境変数を設定する必要はありません。 |
simpapp
用のファイルを作業ディレクトリにコピーします。構成ファイルとubbsimple
のいずれかを編集する必要があります。作業ディレクトリ内のすべてのファイルに対するパーミッションを確認し、必要に応じて、許可をフル・アクセスに変更します。例: copy%TUXDIR
%\samples\atmi\simpapp\*.*
*.*
attrib -R /S *.*
simpapp
クライアントおよびサーバー・プログラムをコンパイルします。buildclient -o simpcl -f simpcl.c
buildserver -o simpserv -f simpserv.c -s TOUPPER
ubbsimple
で、山かっこで囲まれた文字列をOracle Tuxedoシステムのインストール条件に合わせた値に置き換えます。ubbsimple
内のコメントには、ファイルのカスタマイズ方法が記載されています。ubbsimple
ファイルの以下のパラメータを設定します。IPCKEY
を有効なIPCキーに設定します。この値は、32,768より大きく、262,143未満でなければなりません。APPDIR
を「C:\home\me\atmi」
に設定します。
TUXCONFIG
を$APPDIR/tuxconfig
に対応するリテラル・パス名(この例では、「C:\home\me\
atmi\tuxconfig」
)に設定します。TUXDIR
を、Oracle Tuxedoソフトウェアをインストールしたマシンの製品ディレクトリの絶対パス名(「C:\oracle\tuxedo11gR1」
など)に設定します。MACHINE-NAME
をシステム名に設定します。Windowsシステムでは、MACHINE-NAME
は大文字で入力する必要があります。 注意: | ubbsimple ファイル内のAPPDIR 、TUXCONFIG 、およびTUXDIR パラメータの設定は、APPDIR 、TUXCONFIG 、およびTUXDIR 環境変数の設定に一致していなければなりません。 |
tuxconfig
というファイルを生成するtmloadcf(1)
を呼び出して、バイナリ形式の編集済み構成ファイルを作成します。このファイルは、TUXCONFIG
環境変数によって参照され、実行時にアプリケーション構成の説明をOracle Tuxedoシステムに提供します。tmloadcf -y ubbsimple
simpapp
を起動します。tmboot -y
起動が成功すると、次のような画面が表示されます。ステップ10に進みます。
リスト6-3は、tmboot -yの出力結果を示します。
Booting all admin and server processes in C:\home\me\atmi\tuxconfig
INFO: Oracle Tuxedo(r) System Release 10.3.0.0
INFO: Serial #: 000102-9125503751, Maxusers 25
Booting admin processes ...
exec BBL -A:
process id=24180 ... Started.
Booting server processes ...
exec simpserv -A :
process id=24181 ... Started.
2 processes started.
%APPDIR%
, C:\home\me\atmi
)にあるULOG.
mmddyy
というログを調べます。文字列mmddyy
は、ファイル名の末尾となる日付(現在の月、日、および年を表す数字)のプレースホルダーです。ログの最後に、can’t create enough semaphores for BB
などのメッセージがある場合は、オペレーティング・システムで構成されているプロセス間通信(IPC)リソースがsimpapp
の実行に適していないと考えられます。
これが正しいかどうかを確認するには、Oracle Tuxedoシステム・コマンドのtmloadcf(1)
を呼び出し、構成ファイルの名前を指定します。次の例を参照してください。
tmloadcf -c %APPDIR%
\ubbsimple
オペレーティング・システムで構成されている現在のIPCパラメータ値が、tmloadcf
の出力結果で示された最低限の値(VariableまたはFixed)よりも小さい場合は、そのパラメータの値を大きくする必要があります。プラットフォームの現在のIPC値の決定方法と変更方法については、WindowsでのOracle Tuxedo ATMIの使用の「システムのパフォーマンスが最大限になるようにIPCリソースを設定する」を参照してください。
simpcl “hello world”
Returned string is: HELLO WORLD
simpapp
を停止します。tmshutdown -y
UNIXシステム上でATMIバージョンのsimpapp
を構成して実行するには、次の手順に従います。
cd /home/me
mkdir atmi
cd atmi
APPDIR
とTUXCONFIG
を次のように設定します。APPDIR=/home/me/atmi
TUXCONFIG=$APPDIR/tuxconfig
export APPDIR TUXCONFIG
注意: | WEBJAVADIR 環境変数を設定する必要はありません。 |
simpapp
用のファイルを作業ディレクトリにコピーします。構成ファイルとubbsimple
のいずれかを編集する必要があります。クライアントおよびサーバー用のファイル(simpcl
とsimpserv
)が実行可能であることと、構成ファイル(ubbsimple
)が書込み可能であることを確認します。例: cp$TUXDIR
/samples/atmi/simpapp/* .
chmod 755 simpserv simpcl
chmod 644 ubbsimple
simpapp
クライアントおよびサーバー・プログラムをコンパイルします。buildclient -o simpcl -f simpcl.c
buildserver -o simpserv -f simpserv.c -s TOUPPER
ubbsimple
で、山かっこで囲まれた文字列をOracle Tuxedoシステムのインストール条件に合わせた値に置き換えます。ubbsimple
内のコメントには、ファイルのカスタマイズ方法が記載されています。ubbsimple
ファイルの以下のパラメータを設定します。IPCKEY
を有効なIPCキーに設定します。この値は、32,768より大きく、262,143未満でなければなりません。APPDIR
を「/home/me/atmi」に設定します。TUXCONFIG
を$APPDIR/tuxconfig
に対応するリテラル・パス名(この例では、「/home/me/atmi/tuxconfig」
)に設定します。TUXDIR
を、Oracle Tuxedoソフトウェアをインストールしたマシンの製品ディレクトリの絶対パス名(「/home/oracle/tuxedo11gR1」
など)に設定します。MACHINE-NAME
をシステムの名前に設定します。 UNIXマシン上でシステム名を調べるには、次のコマンドを入力します。
uname -n
注意: | ubbsimple ファイル内のAPPDIR 、TUXCONFIG 、およびTUXDIR パラメータの設定は、APPDIR 、TUXCONFIG 、およびTUXDIR 環境変数の設定に一致していなければなりません。 |
tuxconfig
というファイルを生成するtmloadcf(1)
を呼び出して、バイナリ形式の編集済み構成ファイルを作成します。このファイルは、TUXCONFIG
環境変数によって参照され、実行時にアプリケーション構成の説明をOracle Tuxedoシステムに提供します。tmloadcf -y ubbsimple
simpapp
を起動します。tmboot -y
リスト6-4は、tmboot -yの出力結果を示します。
Booting all admin and server processes in /home/me/atmi/tuxconfig
INFO: Oracle Tuxedo(r) System Release 10.3.0.0
INFO: Serial #: 000102-9125503751, Maxusers 25
Booting admin processes ...
exec BBL -A:
process id=24180 ... Started.
Booting server processes ...
exec simpserv -A :
process id=24181 ... Started.
2 processes started.
$APPDIR
, /home/me/atmi
)にあるULOG.
mmddyy
というログを調べます。文字列mmddyy
は、ファイル名の末尾となる日付(現在の月、日、および年を表す数字)のプレースホルダーです。ログの最後に、can’t create enough semaphores for BB
などのメッセージがある場合は、オペレーティング・システムで構成されているプロセス間通信(IPC)リソースがsimpapp
の実行に適していないと考えられます。
これが正しいかどうかを確認するには、Oracle Tuxedoシステム・コマンドのtmloadcf(1)
を呼び出し、構成ファイルの名前を指定します。次の例を参照してください。
tmloadcf -c $APPDIR
/ubbsimple
オペレーティング・システムで構成されている現在のIPCパラメータ値が、tmloadcf
の出力結果で示された最低限の値(VariableまたはFixed)よりも小さい場合は、そのパラメータの値を大きくする必要があります。プラットフォームの現在のIPC値の決定方法と変更方法については、「Oracle Tuxedo 11gリリース1(11.1.1.2.0)プラットフォーム・データ・シート」を参照してください。
simpcl “hello world”
Returned string is: HELLO WORLD
simpapp
を停止します。tmshutdown -y
Oracle Tuxedo CORBA C++ソフトウェアが正しくインストールされているかどうかを確認するには、CORBAバージョンのsimpapp
アプリケーションを実行します。このアプリケーションは、Windowsシステムではディレクトリ%TUXDIR%\samples\corba\simpapp
にあり、UNIXシステムではディレクトリ$TUXDIR/samples/corba/simpapp
にあります。次の2つの項で示されている手順は、simpapp
ディレクトリのREADME
ファイルと、『Oracle Tuxedo ATMIアプリケーションの開発チュートリアル』の 単純なCアプリケーションsimpappのチュートリアルに関する項でも説明されています。
Windowsシステム上でCORBAバージョンのsimpapp
を構成して実行するには、次の手順に従います。
Administrator
またはAdministrator
グループのメンバーとしてターゲット・マシンにログインし、コマンドライン・シェルを開きます。cd C:\home\me
mkdir corba
cd corba
TUXDIR
環境変数で設定されていることを確認します。たとえば、ソフトウェアをC:\oracle\tuxedo11gR1ディレクトリにインストールした場合は、TUXCONFIG
を次のように設定します。set TUXDIR=C:\oracle\tuxedo11gR1
simpapp
ファイルを作業ディレクトリにコピーし、すべてのファイルに対する許可をフル・アクセスに変更します。例: copy%TUXDIR
%\samples\corba\simpapp\*.*
*.*
attrib -R /S *.*
nmake
がパスに含まれていることを確認します。simpapp
を自動的に実行するには、runme
を入力します。simpapp
アプリケーションが起動し、次のメッセージが表示されます。 Testing simpapp
cleaned up
prepared
built
loaded ubb
booted
ran
shutdown
saved results
PASSED
UNIXシステム上でCORBAバージョンのsimpapp
を構成して実行するには、次の手順に従います。
prompt> cd /home/me
prompt> mkdir corba
prompt> cd corba
TUXDIR
環境変数で設定されていることを確認します。たとえばソフトウェアを/home/oracle/tuxedo11gR1ディレクトリにインストールした場合は、TUXCONFIG
を次のように設定してエクスポートします。prompt> TUXDIR=/home/oracle/tuxedo11gR1
prompt> export TUXDIR
simpapp
ファイルを作業ディレクトリにコピーし、すべてのファイルに対する許可をフル・アクセスに変更します。例: prompt> cp $TUXDIR/samples/corba/simpapp/* .
prompt> chmod 777 *
make
がパスに含まれていることを確認します。simpapp
を自動的に実行するには、. ./runme.ksh
と入力します。simpapp
アプリケーションが起動し、次のメッセージが表示されます。 Testing simpapp
cleaned up
prepared
built
loaded ubb
booted
ran
shutdown
saved results
PASSED
simpapp
を手動で実行してプロセスの開始と停止を確認するには、次の手順に従います。
分散トランザクションおよびXA準拠のリソース・マネージャを使用するOracle Tuxedoアプリケーションの場合、buildtms
コマンドを使用して、トランザクション・マネージャ・サーバー・ロード・モジュールを構築する必要があります。この作業は、Windows 2003 ServerおよびUNIXシステムで必要です。モジュールを作成したら、Windows 2003 Serverシステムでは%TUXDIR%\bin
に、UNIXシステムでは$TUXDIR/bin
に格納します。
CORBA C++ Universityサンプル・アプリケーションを実行すると、各サンプルのmakefileによって、tms_ora.exe
というTMSロード・モジュールが作成されます。したがって、buildtms
を別個の操作として実行する必要があるのは、これらのサンプル・アプリケーションを実行しない場合だけです。
Oracle Tuxedoアプリケーションに対するbuildtms
コマンドについては、『Tuxedoコマンド・リファレンス』の「buildtms(1)」
を参照してください。
Oracle Tuxedo11gリリース1(11.1.1.2.0)、10.0、9.1、9.0、8.1または8.0をアンインストールする場合、関連付けられているOracleホーム・ディレクトリが削除されるのではなく、インストーラ・プログラムによってインストールされたすべてのOracle Tuxedoコンポーネントが削除されます。また、以下のいずれにも該当しない場合は、関連付けられている製品ディレクトリも削除されます。
Oracle Tuxedo 11gリリース1(11.1.1.2.0)をアンインストールするには、表6-11の該当するプラットフォームの手順を実行します。Oracle Tuxedo 9.1または10.0をアンインストールする場合は、表6-11の「Tuxedo 11gリリース1(11.1.1.2.0)」を「Tuxedo 9.1または10.0」に置き換えてください。
Oracleインストール・プログラムの「アンインストーラ」ウィンドウが表示されます。 |
|
|
Oracle Tuxedoがすでにインストールされているシステム上でOracle Tuxedoのインストール・プログラムを起動すると、インストール・プログラムは既存のOracle Tuxedoホーム・ディレクトリを検出し、以下の処理を行うかどうかをたずねてきます。
表6-12に、再インストール画面を示します。
インストール・プログラムを終了し、以前のインストール内容をアンインストールします。「Oracle Tuxedoのアンインストール」で説明したようにアンインストール・プログラムを呼び出すことも、以下の項で説明したようにソフトウェアを再インストールすることもできます。
|