6 インストール後の作業の実行
次の各項では、Oracle Tuxedo 22cのインストール後に実行する作業について説明します。
- Oracle Tuxedoのディレクトリ構造の理解
- Oracle Service Architecture Leveraging Tuxedoディレクトリ構造の理解
- Oracle Tuxedoのアーキテクチャの理解
- UBBCONFIG File
- MASTERマシン
- TUXCONFIGファイル
- TUXCONFIG環境変数
- TUXDIR環境変数
- 環境の設定
- UNIXシステムでの環境変数の設定
- tlistenプロセスの開始
- tlistenの呼出し
- tlistenパスワード
- UBBCONFIGファイルの編集
- UBBCONFIGでのTYPEパラメータの使用
- IPC要件のチェック
- 汎用デバイス・リストとトランザクション・ログの作成
- TLOGの定義
- UDLとTLOGのUDLエントリの作成
- simpappを実行してインストールを確認する
- simpappを実行してOracle Tuxedo CORBA C++ソフトウェアのインストールを確認する
- XAリソース・マネージャを使用するOracle Tuxedoアプリケーションのbuildtmsの実行
- Oracle Tuxedoのアンインストール
- Oracle Tuxedoの再インストール
6.1 Oracle Tuxedoのディレクトリ構造の理解
Oracle Tuxedoソフトウェアのインストール中に、インストーラ・プログラムによって、完全インストールの場合は次のディレクトリ構造が作成されます。完全インストールには、すべてのOracle Tuxedoサーバーおよびクライアント・ソフトウェア・コンポーネントと、リンク・レベルの暗号化(LLE)およびSecure Sockets Layer (SSL)暗号化ソフトウェア・パッケージが含まれます。
次の図は、Oracle Tuxedo 22cのディレクトリ構造を表しています:
図6-1 Oracle Tuxedo 22cリリースのディレクトリ構造
ここに示されている製品ディレクトリは、Oracle Tuxedo 22cリリース1 (22.1.0.0.0)のデフォルトです。デフォルト名はインストール時に変更できます。Oracle Tuxedoディレクトリ構造の最上位レベルのディレクトリおよびファイルについて、次の表で簡単に説明しています:
表6-1 Oracle Tuxedoディレクトリ構造の最上位レベルのディレクトリおよびファイル
ディレクトリ名 | 説明 |
---|---|
bin |
Tuxedo、Jolt、およびSNMPエージェントの実行可能プログラムが含まれています。 |
cobinclude
|
COBOLプログラムで使用される.cbl ファイルのエントリが含まれています。
|
include
|
CおよびC++言語ヘッダー・ファイル、およびOMG IDLファイルが含まれています。サブディレクトリunicode およびxercesc が含まれており、プラットフォームによってはサブディレクトリrpc が含まれることもあります。
|
jmx |
TSAM Plusのファイルが含まれます。 |
lib
|
Oracle Tuxedoクライアントおよびサーバーの作成に必要なコンパイル済オブジェクト・ファイル(Oracle Tuxedoがダイナミック共有ライブラリを使用するプラットフォームではダイナミック共有ライブラリを含む)およびその他のオブジェクト・ファイルが含まれています。 |
locale
|
システム・メッセージのローカライゼーションをサポートするサブディレクトリが含まれています。Cサブディレクトリに、デフォルトのロケール(アメリカ英語)のメッセージ・カタログが含まれています。 |
samples ノート: サンプルは、Oracle Tuxedo 22リリースのインストール時に選択しないとインストールされません。 |
Oracle Tuxedoを使用したアプリケーション開発を学習するための、サンプル・コードおよびリソースが含まれています。samplesディレクトリには次のサブディレクトリが含まれています
|
tux.env (ファイル) |
UNIXシステムのみ: UNIXインストールのOracle Tuxedo環境変数が含まれ、それらの変数設定のモデルとなります。 |
udataobj
|
Oracle Tuxedoが必要とする他のディレクトリおよびファイルが含まれます。udataobj ディレクトリには、次のサブディレクトリおよびファイルが含まれます:
|
uninstaller |
Oracle Tuxedoソフトウェアのアンインストールに必要なコードが含まれています。 |
親トピック: インストール後の作業の実行
6.2 Oracle Service Architecture Leveraging Tuxedoディレクトリ構造の理解
SALTソフトウェアのインストール時に、すべてのSALTファイルがOracle TuxedoのTUXDIR
ディレクトリに解凍されます。
ノート:
各Oracle製品で、comps.xml
ファイル($ORACLEHOME/inventory/ContentsXML
にある)にインストール情報が示されます。
次の表で、SALTディレクトリおよびファイルについて簡単に説明します:
表6-2 SALTディレクトリおよびファイルの構造
ディレクトリ名 | 説明 |
---|---|
bin |
次のSALTの実行可能プログラムが含まれています。
|
include |
次のSALTプラグイン開発および管理開発のC言語ヘッダー・ファイルが含まれています。
|
lib |
次のSALTプラグイン開発および管理開発のC言語ヘッダー・ファイルが含まれています。
|
locale |
SALTで使用されるシステム・メッセージのローカライゼーションが含まれています。
|
samples/salt |
SALT機能を示す、単純なアプリケーションの集まりです。
ノート: samples/saltは、インストール時にリクエストした場合のみインストールされます。 |
udataobj |
SALTの次の情報ファイルが含まれています。
|
inventory |
Oracle Universal Installerで使用する、インストール済の製品に関する情報を格納します。 |
udataobj/salt |
SALTで必要とされる、次のサブディレクトリおよびファイルが含まれています。
|
親トピック: インストール後の作業の実行
6.3 Oracle Tuxedoのアーキテクチャの理解
次の図は、Oracle Tuxedoアーキテクチャの基礎であるOracle Tuxedoドメインを示しています。
図6-2 Oracle Tuxedoアーキテクチャの単純化されたビュー
TuxedoドメインはTuxedoアプリケーションとも呼ばれ、Tuxedoシステム上に構築されたビジネス・ソフトウェア・プログラムで、1つの構成ファイルUBBCONFIGによって定義および制御されます。Tuxedoドメインは、多数のシステム・プロセス、1つ以上のアプリケーション・クライアント・プロセス、1つ以上のアプリケーション・サーバー・プロセス、およびネットワークで接続された1つ以上のコンピュータ・マシンで構成されます。
この時点でこれらの用語について完全に理解する必要はなく、これらの項をリファレンスとして利用してください。インストール後の手順でこれらの用語が出てきたら、これらの項を参照して用語の意味を確認してください。
親トピック: インストール後の作業の実行
6.4 UBBCONFIGファイル
Tuxedoドメインは、構成ファイルによって制御され、このファイルには、インストール時の設定に基づくパラメータが定義されています。テキスト形式の構成ファイルはUBBCONFIGと呼ばれますが、そのファイルの内容が『Oracle Tuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のUBBCONFIGファイル・リファレンス・ページで説明されている形式に準拠している場合にかぎり、構成ファイルに任意の名前を付けることができます。
TuxedoドメインのUBBCONFIGファイルには、アプリケーションを起動するために必要なすべての情報、たとえばリソース、マシン、グループ、サーバー、使用可能なサービスなどのリストが含まれています。9つのセクションで構成され、そのうちの5つのセクション、RESOURCES
、MACHINES
、GROUPS
、SERVERS
およびSERVICES
はすべての構成に必要です。
親トピック: インストール後の作業の実行
6.5 MASTERマシン
TuxedoドメインのMASTER
マシン、またはMASTER
ノードは、ドメインのUBBCONFIGファイルが格納され、UBBCONFIG
ファイルのRESOURCES
セクションでMASTER
マシンとして指定されます。Tuxedoドメインは、MASTER
マシンを使用して起動、停止、および管理します。
異なるリリースのTuxedoシステム・ソフトウェアを実行している複数のマシンで構成されるTuxedoドメインでは、MASTER
はドメイン内の最新のリリースのTuxedoシステム・ソフトウェアを実行している必要があります。
親トピック: インストール後の作業の実行
6.6 TUXCONFIGファイル
TUXCONFIG
ファイルは、UBBCONFIG
ファイルのバイナリ・バージョンです。tmloadcf(1)
コマンドの実行によって作成され、これによってUBBCONFIG
が解析され、バイナリTUXCONFIG
ファイルがTUXCONFIG環境変数によって参照される場所にロードします。UBBCONFIG
と同様に、TUXCONFIG
ファイルには任意の名前を使用できます。
TuxedoドメインのMASTER
マシンには、TUXCONFIG
ファイルのマスター・コピーが存在します。TUXCONFIG
ファイルのコピーは、他のすべてのサーバー・マシン(非MASTER
マシンと呼ばれる)に伝播されます。TuxedoシステムはMASTER
マシンで起動されます。
親トピック: インストール後の作業の実行
6.7 TUXCONFIG環境変数
TUXCONFIG
環境変数により、MASTER
マシン上でtmloadcf(1)
コマンドによってバイナリTUXCONFIG
ファイルがロードされる場所が定義されます。TUXCONFIG
をロードする端末またはシステム・ファイルで終了する絶対パス名を設定する必要があります。
TUXCONFIG
パス名の値は、UBBCONFIG
ファイルのMACHINES
セクションで指定されます。これはMACHINES
マシンおよびTuxedoドメイン内のすべての他のサーバー・マシンについて指定されます。システムの起動時にバイナリTUXCONFIG
ファイルが非MASTER
マシンに伝播されると、コピーはTUXCONFIG
パス名の値に従って非MASTER
マシンに保存されます。
親トピック: インストール後の作業の実行
6.8 TUXDIR環境変数
TUXDIR
環境変数により、MASTER
マシン上でのOracle Tuxedoソフトウェアの製品インストール・ディレクトリが定義されます。製品インストール・ディレクトリの名前で終了する絶対パス名を設定する必要があります。
TUXDIR
パス名の値は、UBBCONFIG
ファイルのMACHINES
セクションで指定されます。MASTER
マシンおよびTuxedoドメイン内のすべての他のサーバー・マシンについて指定されます。
親トピック: インストール後の作業の実行
6.9 環境の設定
Oracle Tuxedoを使用してOracle Tuxedoアプリケーションを作成および実行する前に、いくつかの環境変数を設定する必要があります(表6-3、表6-4、表6-5および表6-6)。
表6-3 Oracle Tuxedoコア環境変数
環境変数 | 説明 |
---|---|
TUXDIR
|
このマシンでOracle Tuxedoソフトウェアをインストールした製品ディレクトリの絶対パス名。TUXDIR は、サーバーとクライアントのみのマシンの両方で設定する必要があります。
|
APPDIR
|
このサーバー・マシンでアプリケーションおよび管理サーバーが起動するアプリケーション・ディレクトリの絶対パス名。APPDIR は、1つまたは複数のディレクトリに設定することができます。
|
TUXCONFIG
|
バイナリ形式のTUXCONFIG ファイルが置かれているサーバー・マシン上のファイルまたはデバイスの絶対パス名。TUXCONFIG を作成するには、UBBCONFIG 構成ファイルに対してtmloadcf(1) コマンドを実行します。
|
表6-4 Oracle Tuxedoクライアント専用環境変数
環境変数 | 説明 |
---|---|
WSENVFILE
|
Tuxedo ATMIワークステーション(/WS)・クライアント: このワークステーションに対して設定するすべての環境変数を収めたファイルの名前。この変数のデフォルト値はありません。 |
TOBJADDR
|
TuxedoリモートCORBAクライアント: Tuxedoサーバー・マシンのリスナーのアドレスです。サーバーのUBBCONFIG ファイルで指定したホストおよびポートと、大文字と小文字の違いも含めて正確に一致する必要があります。
|
表6-5 COBOL環境変数
環境変数 | 説明 |
---|---|
COBCPY
|
コンパイラで使用されるCOBOL COPY の各ファイルが置かれたディレクトリ。
|
COBOPT
|
コンパイルのコマンド行で使用する引数。 |
次の表に、Java環境変数を示します。
表6-6 Java環境変数
環境変数 | 説明 |
---|---|
JAVA_HOME
|
このマシンでJava Development Kit (JDK) 1.8.xをインストールしたディレクトリの絶対パス名。Javaアプリケーションのビルドと実行に必要です。* |
JDKDIR
|
JAVA_HOME 値に設定します。
|
CLASSPATH
|
このマシン上のクラスおよびJavaアーカイブ・ファイルの絶対パス名。Javaアプリケーションの実行に必要です。 |
ノート:
Oracle Tuxedo 22c配布キットにはJDKは含まれていません親トピック: インストール後の作業の実行
6.10 UNIXシステムでの環境変数の設定
UNIXサーバー・マシンで、環境を設定するには、次の表の環境変数を設定してエクスポートします:
表6-7 環境変数
環境変数 |
---|
TUXDIR=pathname_of_Oracle_Tuxedo_product_directory |
APPDIR=pathname_of_Oracle_Tuxedo_application_directory |
TUXCONFIG=pathname_of_TUXCONFIG_file |
PATH=$APPDIR:$TUXDIR/bin:/bin:$PATH |
LD_LIBRARY_PATH=$APPDIR:$TUXDIR/lib:/lib:/usr/lib:$LD_LIBRARY_PATH |
export TUXDIR APPDIR TUXCONFIG WEBJAVADIR PATH LD_LIBRARY_PATH |
TUXDIR
、APPDIR
、およびTUXCONFIG
の例は次のとおりです。
TUXDIR=/home/Oracle/tuxedo22cR1
APPDIR=/home/me/simpapp
TUXCONFIG=$APPDIR/tuxconfig
TUXDIR
、APPDIR
およびTUXCONFIG
環境変数は、 UBBCONFIG
ファイルのMACHINES
セクションのTUXDIR
、APPDIR
およびTUXCONFIG
パラメータの値と一致する必要があります。UNIXシステム上でこれらの環境変数やその他の環境変数を設定するモデルとして、Oracle Tuxedo製品ディレクトリにあるtux.env
というBourneシェル・スクリプトを使用します。
親トピック: インストール後の作業の実行
6.11 tlisten
プロセスの開始
アプリケーション管理者は、アプリケーションを起動する前に、ネットワーク接続されたOracle Tuxedoアプリケーションの各マシンのtlisten
プロセスを開始する必要があります。tlisten
プロセスを使用すると、管理者とMASTER
マシンで実行中のOracle Tuxedoソフトウェアは、非MASTER
マシンで実行中のOracle Tuxedoプロセスを開始、停止、および管理することができます。たとえば、tmboot(1)
を使用すると、非MASTER
マシン上のOracle Tuxedoシステム・サーバーを開始できます。一般に、tlisten
は、サーバー・マシン上で実行中のOracle Tuxedoアプリケーションごとに1つ必要です。
Oracle Tuxedoのインストール時にポート3050でtlisten
プロセスを開始するインストーラ・プログラムに加え、次の表に示されているようにtlisten
プロセスを開始できます。
表6-8 tlistenプロセス
マシン | 管理者 | 方法 |
---|---|---|
UNIXサーバー | UNIXシステム管理者 | コマンドライン・シェルからtlisten プロセスを手動で開始します。
|
UNIXサーバー | Oracle Tuxedoアプリケーション管理者 | cron ジョブとして開始します
|
Oracle Tuxedoアプリケーション管理者 | コマンド行シェルからtlisten プロセスを手動で開始します。
|
親トピック: インストール後の作業の実行
6.12 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
の値の調べ方については、『OracleTuxedoファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』のリファレンス・ページUBCONFIG(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(1)コマンドの詳細は、『Oracle Tuxedoコマンド・リファレンス』のリファレンス・ページを参照してください。
親トピック: インストール後の作業の実行
6.13 tlisten
パスワード
Oracle Tuxedoでは、インストール時に指定した管理用パスワードを使用して、認可されていない管理リクエストや操作( tmboot(1)
など)から、Oracle Tuxedoがインストールされているマシンを保護します。tlisten(1)
ゲートウェイ・プロセスを介して管理通信情報がこのマシンに到着するたびに、Oracle Tuxedoはtlistenパスワードでそれらのアクセスを認証します。
tlisten
パスワードをクリアテキスト形式にすることはできません。次のコマンドを実行して、tlisten
パスワードを生成できます:
- Unix/Linux:
tlistpwd $TUXDIR
- Windows:
tlistpwd %TUXDIR%
Oracle Tuxedoアプリケーションにある2台のマシンが正常に通信するには、共通のパスワードが必要です。そのため、単一アプリケーション内にある複数のマシンにOracle Tuxedoをインストールする場合は、必ず同じパスワードを使用します。ただし、Oracle Tuxedoのインストール時に1つのマシンに異なるパスワードを使用した場合は、tlistpwd(1) $TUXDIR
ユーティリティを使用して、そのマシンが相互に通信する各マシンのtlisten.pw
ファイルにそのマシンのパスワードを追加する必要があります。
これらの理由から、tlisten.pw
ファイルには複数の管理用パスワードを追加できます。1つのパスワード・ファイルには、20のパスワードを1行に1つずつ格納できます。
ノート:
tlisten.pw
ファイルは、システムによって暗号化されています。パスワードを追加または変更するには、tlistpwd(1)
ユーティリティを使用する必要があります。
親トピック: インストール後の作業の実行
6.14 UBBCONFIGファイルの編集
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
にあります。
次の例のubbsimple
ファイルは、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>”
#UNIX
#Example:
# APPDIR=“/home/me/simpapp”
# TUXCONFIG=“/home/me/simpapp/tuxconfig”
# TUXDIR=“/home/oracle/tuxedo12cR1”
<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 パラメータの例
パラメータ | 指定内容 |
---|---|
IPCKEY
|
アプリケーションによって使用される構造体が存在する共有メモリー・セグメントを識別する数値キー。値は32,768より大きく、262,143未満である必要があります。 |
machine_name |
マシンのノード名。Windows 2003 Serverシステムでノード名を取得するには、システム管理者に問い合せてください。UNIXシステムでノード名を取得するには、uname-n コマンドを実行します。
|
APPDIR = string |
このマシンでアプリケーションおよび管理サーバーが起動される1つ以上のディレクトリのリスト。Windowsの場合、stringの値は1つのディレクトリの絶対パス名で、オプションで、マシン上に定義されている他のディレクトリのパス名をセミコロンで区切ったリストが続きます。UNIXの場合、stringの値は1つのディレクトリの絶対パス名で、オプションで、マシン上に定義されている他のディレクトリのパス名をコロンで区切ったリストが続きます。 |
TUXCONFIG = string |
バイナリ形式のTUXCONFIGファイルを作成するマシン上のファイルまたはデバイスの絶対パス名。 TUXCONFIG を作成するには、UBBCONFIG ファイルに対してtmloadcf(1) コマンドを実行します。
|
TUXDIR = string |
Oracle Tuxedoソフトウェアがインストールされているマシンの製品ディレクトリの絶対パス名。 |
APPDIR
、TUXCONFIG
、およびTUXDIR
は、Oracle Tuxedoアプリケーション内のすべてのマシンに設定する必要があります。UBBCONFIG
ファイルの編集時にほかのパラメータを確認する必要がある場合は、『ファイル形式、データ記述、MIBおよびシステム・プロセス・リファレンス』の「UBBCONFIG(5)」
を参照してください。
UBBCONFIG
ファイルの編集は、tmloadcf(1)
を実行してIPC要件を確認する前に行う必要があります。次の節を参照してください。最初にUBBCONFIG
ファイルを編集せずにtmloadcf
を実行すると、構文エラーになります。
親トピック: インストール後の作業の実行
6.15 UBBCONFIGでのTYPE
パラメータの使用
構成ファイルにあるMACHINES
セクションのTYPE
パラメータは、異なるマシン間にメッセージが渡された際の外部データ表現(XDR)エンコード/デコード・ルーチンの呼出しを指定します。同じ種類のマシンの場合でも、各マシンのコンパイラが異なるときは、「異なる」マシンとして扱います。そのような場合は、各マシンに一意のTYPE
文字列を指定して、すべてのメッセージが強制的にエンコード/デコード・ルーチンを通過するようにします。
親トピック: インストール後の作業の実行
6.16 IPC要件のチェック
Oracle Tuxedoシステムでは、プロセス間通信(IPC)リソースを頻繁に使用します。大半のシステムでは、各種IPCリソースのサイズと数量を制御するパラメータのデフォルト値が、小さなOracle Tuxedoアプリケーションの実行に最低限必要な値よりも低く設定されています。そのため、パラメータによってはリセットが必要なものがあります。UBBCONFIG
ファイルの編集後、アプリケーションに対してIPCリソースが適切に設定されているどうかを判断する必要があります。
この処理を実行するには、編集後のUBBCONFIG
ファイルを入力として指定して、次のtmloadcf(1)
コマンドを入力します。
tmloadcf -c UBBCONFIG
-c
オプションを使用すると、tmloadcf
プログラムではアプリケーションに必要最小限のIPCリソースのリストが出力されますが、TUXCONFIG
ファイルの作成も更新も行われません。次に示すのは、ubbsimple
の値に基づいた出力レポートです。
Output Produced by tmloadcf -c
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 each MSGMNI value.
出力レポートでは、IPCリソースが従来のUNIX名で識別されます。従来の名前とUNIXプラットフォーム固有の名前を突き合せるには、Oracle Tuxedo 22cリリースのプラットフォーム・データ・シートで該当プラットフォームのデータ・シートを参照してください。
このサンプル出力レポートは、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パラメータの値を大きくします。
UNIXシステムの現在のIPC値を変更する手順については、Oracle Tuxedo 22cリリースのプラットフォーム・データ・シートで該当プラットフォームのデータ・シートを参照してください。
親トピック: インストール後の作業の実行
6.17 汎用デバイス・リストとトランザクション・ログの作成
グローバル・トランザクションに参加するアプリケーション内の各マシンで、汎用デバイス・リスト(UDL)を作成し、グローバル・トランザクション・ログ(TLOG)のUDLエントリを定義します。TLOGは、トランザクションが終了するまで、トランザクションに関する情報が保持されているログです。
親トピック: インストール後の作業の実行
6.18 TLOGの定義
UDLを作成し、TLOGのUDLエントリを定義する前に、グローバル・トランザクションに参加するアプリケーション内の各マシンで、UBBCONFIG
ファイルのMACHINES
セクションの以下のパラメータを設定する必要があります。次の表にパラメータを示します:
表6-10 パラメータ
パラメータ | 説明 |
---|---|
TLOGDEVICE = string |
このマシン用の分散トランザクション処理(DTP) TLOGを格納するOracle Tuxedoファイル・システム。このパラメータを指定しないと、マシンにはTLOGがないものと見なされます。 |
TLOGOFFSET = offset |
デバイスの先頭からOracle Tuxedoファイル・システムの開始点(このマシンのDTPトランザクション・ログを格納)までのページ単位の数値のオフセット。デフォルトは0です。 |
TLOGNAME = string |
このマシンのDTPトランザクション・ログの名前を指定します。値を指定しない場合は、デフォルトのTLOGが指定されます。 |
TLOGSIZE = size |
このマシンのDTPトランザクション・ログのサイズ(ページ単位)。指定しない場合、デフォルト値は100ページです。 |
TLOGが100ブロック(ページ)を超えることはほとんどありません。また、ディスク・パーティションはTLOGよりはるかに大きいので、同じデバイス上にTUXCONFIG
ファイルとTLOGの両方を格納します。その場合、デバイスのパス名をTUXCONFIG
とFSCONFIG環境変数に設定します。
親トピック: インストール後の作業の実行
6.19 UDLとTLOGのUDLエントリの作成
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をミラーリング可能なデバイス上に配置する必要があります。
親トピック: インストール後の作業の実行
6.20 simpappを実行してインストールを確認する
Oracle Tuxedoソフトウェアが正しくインストールされているかどうかを確認する方法の1つは、インストール時に提供される1つまたは複数のサンプル・アプリケーションを実行することです。サンプル・アプリケーションでは、ATMIおよびCORBAクライアントと、ATMIおよびCORBA C++サーバーの機能が具体的に示されます。
以下の節では、インストールしたOracle Tuxedo ATMIおよびCORBA C++関連の部分を確認する手順について説明します。
- simpappを実行してOracle Tuxedo ATMIソフトウェアのインストールを確認する
- simpappを実行してOracle Tuxedo 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++クライアントで構成されています。
親トピック: インストール後の作業の実行
6.21 simpapp
を実行してOracle Tuxedo CORBA C++ソフトウェアのインストールを確認する
Oracle Tuxedo CORBA C++ソフトウェアが正しくインストールされているかどうかを確認するには、CORBAバージョンのsimpapp
アプリケーションを実行します。このアプリケーションは、UNIXシステムではディレクトリ $TUXDIR/samples/corba/simpapp
にあります。次の2つの項で示されている手順は、simpapp
ディレクトリのREADMEファイルと、『Oracle Tuxedo Oracle Tuxedo ATMIアプリケーション開発のためのチュートリアル』の単純なCアプリケーションsimpappのチュートリアルでも説明されています。
6.21.1 UNIXシステム上でsimpappを実行してOracle Tuxedo CORBA C++ソフトウェアのインストールを確認する
UNIXシステム上でCORBAバージョンのsimpapp
を構成して実行するには、次のステップに従います。
- Oracle Tuxedoアプリケーション管理者としてターゲット・マシンにログインし、コマンド行シェルを開きます。
- サンプル・アプリケーション用の作業ディレクトリを作成し、そのディレクトリに移動します。
prompt> cd /home/me prompt> mkdir corba prompt> cd corba
- Oracle Tuxedoソフトウェアをインストールした製品ディレクトリがTUXDIR環境変数で設定されていることを確認します。たとえば、ソフトウェアを
/home/oracle/tuxedo12cR1
ディレクトリにインストールした場合は、TUXCONFIG
を次のように設定してエクスポートします:prompt> TUXDIR=/home/oracle/tuxedo12cR1 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
を手動で実行してプロセスの開始と停止を確認するには、次のステップに従います。- prompt>
ksh
- prompt>
../results/setenv.ksh
- prompt>
tmboot -y
アプリケーションが複数のプロセスを開始します。
- prompt>
simple_client
プロンプト
String?
が表示されます。 - prompt>
enter_a_word_in_lowercase_letters
アプリケーションがその文字列を大文字に変換してから小文字に変換し、結果を表示します。
- prompt>
tmshutdown -y
- アプリケーションがプロセスを停止します。
- prompt>
- ディレクトリを元の状態に復元するには、次のステップに従います。
- prompt>
../results/setenv.ksh
- prompt>
make -f makefile.mk
clean
- prompt>
6.22 XAリソース・マネージャを使用するOracle Tuxedoアプリケーションのbuildtmsの実行
分散トランザクションおよびXA準拠のリソース・マネージャを使用するOracle Tuxedoアプリケーションの場合、buildtms
コマンドを使用して、トランザクション・マネージャ・サーバー・ロード・モジュールを構築する必要があります。この要件はUNIXシステムにのみ存在します。作成されたモジュールは、UNIXシステムの$TUXDIR/bin
ディレクトリに格納する必要があります。
CORBA C++ Universityサンプル・アプリケーションを実行すると、各サンプルのmakefile
によって、tms_ora.exe
というTMSロード・モジュールが作成されます。したがって、buildtms
を別個の操作として実行する必要があるのは、これらのサンプル・アプリケーションを実行しない場合だけです。
Oracle Tuxedoアプリケーションに対するbuildtms
コマンドについては、『Oracle Tuxedoコマンド・リファレンス』の「buildtms(1)」
を参照してください。
6.22.1 simpappを実行してOracle Tuxedo ATMIソフトウェアのインストールを確認する
Oracle Tuxedo ATMIソフトウェアが正しくインストールされているかどうかを確認するには、ATMIバージョンのsimpapp
アプリケーションを実行します。このアプリケーションは、UNIXシステムではディレクトリ$TUXDIR/samples/atmi/simpapp
にあります。
ノート:
サンプルは、Oracle Tuxedo 22cリリース1 (22.1.0.0.0)インストール時に選択しないとインストールされません。次の2つの項で示されている手順は、simpappディレクトリのREADMEファイルと、単純なCアプリケーションsimpappのチュートリアルでも説明されています。Oracle Tuxedo Oracle Tuxedo ATMIアプリケーション開発のためのチュートリアル
6.22.1.1 UNIXシステム上でsimpapp
を実行してOracle Tuxedo ATMIソフトウェアのインストールを確認する
UNIXシステム上でATMIバージョンのsimpapp
を構成して実行するには、次のステップに従います。
- Oracle Tuxedoアプリケーション管理者としてターゲット・マシンにログインし、コマンド行シェルを開きます。
- サンプル・アプリケーション用の作業ディレクトリを作成し、そのディレクトリに移動します。
cd /home/me mkdir atmi cd atmi
- Oracle Tuxedoシステムが使用する環境変数を設定してエクスポートします。「UNIXシステムでの環境変数の設定」を参照してください。
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/tuxedo12cR1
など)に設定します。MACHINE-NAME
をシステムの名前に設定します。UNIXマシン上でシステム名を調べるには、次のコマンドを入力します。uname -n
ノート:
ubbsimple
ファイル内のAPPDIR
、TUXCONFIG
、およびTUXDIR
パラメータの設定は、APPDIR
、TUXCONFIG
、およびTUXDIR
環境変数の設定に一致していなければなりません。
invokingtmloadcf(1)
を使用して、編集した構成ファイルのバイナリ・バージョンを作成します。tuxconfig
という名前のファイルが生成されます。このファイルは、TUXCONFIG環境変数によって参照され、実行時にアプリケーション構成の説明をOracle Tuxedoシステムに提供します。tmloadcf -y ubbsimple
- 次のコマンドを入力して
simpapp
を起動します。tmboot -y
起動が成功すると、次のような画面が表示されます。ステップ10に進みます。次に示すのは、
tmboot -y
によって生成される出力です:Booting all admin and server processes in /home/me/atmi/tuxconfig INFO: Oracle Tuxedo , Version 22.1.0.0.0 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 22cリリースのプラットフォーム・データ・シートで該当プラットフォームのデータ・シートを参照してください。 - 起動が成功した場合は、クライアントを呼び出すことができます。たとえば、次のコマンドを入力します。
simpcl “hello world”
次が表示されます。Returned string is: HELLO WORLD
- 操作が終了したら、次のコマンドで
simpapp
を停止します。tmshutdown -y
6.23 Oracle Tuxedoのアンインストール
Oracle Tuxedo 22cリリース1 (22.1.0.0.0)をアンインストールしても、インストールと関連付けられているOracleホーム・ディレクトリは削除されませんが、インストーラ・プログラムによってインストールされたすべてのOracle Tuxedoコンポーネントは削除されます。また、アンインストールによって、インストールと関連付けられている製品ディレクトリも削除されます。
OUIを起動すると、「ようこそ」画面が表示されます。「製品の削除」をクリックします。「インベントリ」パネルの「内容」タブから削除対象製品を選択してから、「削除」をクリックします。
同じ方法でOracleホームも削除できます。Oracleホームを削除した後、その名前と場所を再利用して、他の製品をインストールできます。そして、アンインストールを確認します。選択された製品がアンインストールされると、「インベントリ」パネルが表示されます。
親トピック: インストール後の作業の実行
6.24 Oracle Tuxedoの再インストール
Oracle TuxedoがインストールされているシステムでOracle Tuxedoインストール・プログラムを起動すると、インストール・プログラムは既存のOracle Tuxedoホーム・ディレクトリを検出し、TuxedoがインストールされているORACLE_HOMEが選択されていることを示す警告が表示されます。インストールを続行する場合、選択されたORACLE_HOMEに存在しないコンポーネントはインストールされます。既存のTuxedoコンポーネントはデフォルトでは再インストールされません。
親トピック: インストール後の作業の実行