製品組込み手順書
Oracle Tuxedo (Windows 版)
作成日: Apr 16, 2009
更新日: May 18 2009
目次
はじめに...1 目的...1 環境...1 関連文書...2 作業概要...2 作業内容...2 作業フロー...2 作業ステップ詳細...2 作業ステップ詳細...3 管理対象...3 ファイル...3 プロセス...3 環境変数...4 留意点...4 運用関連...4 運用スクリプト作成...4 概要...5 必要なスクリプト...5 ドメイン起動スクリプトの内容...5 ドメイン停止スクリプトの内容...5 アプリケーション実行スクリプトの内容...5 アンインストールスクリプトの内容...5 サンプル...6 インストールスクリプトの作成...7 概要...7はじめに
目的
本書は、ハードウェアベンダー様、ソフトフェアベンダー様において、Oracle Tuxedo（以下 Tuxedo）を対象の製品に組み込む際のガイドライン及び注意事項を記 載するものです。環境
本書では、以下の環境を利用します。 一覧 製品 バージョン 備考Microsoft Windowx XP Professional Version 2002 Service Pack 3
本来、WindowsXPではTuxedoのクライ
アント機能のみをサポート Microsoft Visual C++ 2005 Express
Edition API開発時に必要
Microsoft Platform SDK for Windows Server 2003
SP1 API開発時に必要
Oracle Tuxedo 10.0 今回はATMIアプリケーションを作成
OS
ATMI
ATMI
クライアントアプ
リケーション
サービス
Tuxedoクライアント
Tuxedoサーバ
通信 今回はこのような構成をパッケージングします。関連文書
No 関連文書 備考 1 tuxedo_sample_linux.zip サンプル・スクリプト作業概要
以下に、Tuxedo をパッケージングし、組込み製品を作成する一般的な手順を記載します。作業内容
作業フロー 環境検討／構築 アプリケーション 作成 運用スクリプト作成 設定ファイル作成 サイレントインスト ールスクリプト作成 パッケージ作成 インストールテンプ レートファイル作成 作業ステップ詳細 1. 環境検討／構築 最終的な製品の想定されるシステム構成及び環境を検討し、構築します。 2. アプリケーション作成／配置 サービス及び製品機能を開発し、環境へ配置します。 3. 運用スクリプト作成 各種運用スクリプトを作成します。 4. インストールテンプレートファイルの作成 システム構成にあわせたインストールテンプレートファイルを作成します。 Tuxedoをサイレントインストールする時に、システム構成やインストールコンポーネントを指定するために使用するファイルです。 設定方法の詳細については、OTNのマニュアルを参照してください。 http://otndnld.oracle.co.jp/document/products/tuxedo/tux100/index.html 5. 設定ファイルの作成 アプリケーションドメインを起動する時の設定を、UBBCONFIGファイルとして作 成します。 Tuxedo組込み製品をインストールするマシン名がパッケージング前に分からない 場合は、インストール時にUBBCONFIGファイルの内容を編集する必要があります。 設定方法の詳細については、OTNのマニュアルを参照してください。 http://otndnld.oracle.co.jp/document/products/tuxedo/tux100/index.html 6. スクリプトの作成 サイレントインストール用のスクリプトを作成します。 7. パッケージの作成 サイレントインストールスクリプトに合わせた形で、各バイナリファイル、設定フ ァイル、スクリプトファイルを配置し、パッケージとしてCDやDVD、アーカイブ ファイル等を作成します。 作業ステップ詳細 1. インストールテンプレートファイルのマシン名は、大文字にする必要があります。
管理対象
以下に、運用中に管理すべきファイル及び監視すべきプロセス等を記載します。 ファイル No ファイル名 備考 1 <TUXDIR>/ULOG.xxxxxx tuxedoログファイル 2 <APPDIR>/ULOG.xxxxxx アプリケーションログファイル。パス及び接頭語は、 UBBCONFIGファイルで変更可能 3 UBBCONFIG TUXCONFIGファイルの元となるテキストファイル。 アプリケーションドメインの設定をする。詳細はマニ ュアルを参照 4 installer.properties サイレントインストールに使用される設定ファイル。 詳細はマニュアルを参照 プロセス No プロセス名 備考No プロセス名 備考 1 tuxipc.exe プロセス間通信用プロセス 2 tlisten.exe リスナープロセス 3 各アプリケーションのプロセス 4 環境変数 No プロセス名 備考 1 TUXDIR Tuxedoインストールフォルダのパス 2 APPDIR アプリケーションフォルダのパス 3 TUXCONFIG TUXCONFIGファイルの完全修飾名
4 WEBJAVADIR Administration Console用Javaの絶対パス
5 PATH サーチパス。<APPDIR>、<TUXDIR>/binを含める
留意点
以下に、製品を作成／パッケージングする際、及び運用に伴う考慮点などを記載 します。 運用関連 Tuxedo ログファイル 運用時に記録されるログファイルは、”ULOG.031009”というように末尾に日付が続 くファイル名で残されます。必要なくなったログファイルは適宜、移動・削除して ください。 アプリケーションログファイル UBBCONFIG ファイルの ULOGPFX 属性によって、ログファイルのパスと接頭語 を設定できます。デフォルトは、<APPDIR>/ULOG です。また、Tuxedo ログファイ ルと同じく、”ULOG.031009”というように末尾に日付が続くファイル名で残されます。 必要なくなったログファイルは適宜、移動・削除してください。運用スクリプト作成
製品に組み込んだ Tuxedo アプリケーションを運用する為のスクリプトを作成する方法に ついて記載します。概要
Tuxedo アプリケーションを実行するには、リスナーとアプリケーションドメイン を起動する必要があります。また、プロセス間通信を制御するプロセスも必要です が、これはサービスによって自動的に起動されます。 必要なスクリプトとその内容を以下に記します。 必要なスクリプト 1. ドメイン起動スクリプト リスナー、アプリケーションドメインを起動するスクリプト 2. ドメイン停止スクリプト アプリケーションドメインを停止するスクリプト 3. アプリケーション実行スクリプト（必要に応じたアプリケーション実行） アプリケーションを実行するためのスクリプト 4. Tuxedoアンインストールスクリプト Tuxedoをマシン上からアンインストールするスクリプト ドメイン起動スクリプトの内容 1. 環境変数をセットします。 2. リスナーを起動します。（tlisten –l “マシン名:ポート”） 3. アプリケーションドメインを起動します。（tmboot -y） ドメイン停止スクリプトの内容 1. 環境変数をセットします。 2. アプリケーションドメインを停止します。（tmshutdown -y） 3. 必要ならリスナープロセスをkillします。（kill） アプリケーション実行スクリプトの内容 1. 環境変数をセットします。 2. 必要に応じてアプリケーションを呼び出します。 アンインストールスクリプトの内容 1. 環境変数をセットします。2. Tuxedoのアンインストーラを起動します。 アンインストーラは、
<TUXDIR>/uninstaller/Uninstall Tuxedo 10.0 with VS2005.exe にあります。 3. 必要の無いフォルダを削除します。 サンプル silent_boot.bat（ドメイン起動スクリプト） echo off echo; echo 環境変数を設定 call set_env.bat echo; echo tlistenプロセスを開始します tlisten -l "//MachineName:3050" echo; echo Tuxedoアプリケーションを開始します。 tmboot –y echo on pause silent_shutdown.bat（ドメイン停止スクリプト） echo off echo; echo 環境変数を設定します call set_env.bat echo; echo Tuxedoアプリケーションを終了します。 tmshutdown –y echo ; echo tlistenプロセスを終了します。 taskkill /IM tlisten.exe /F
echo on pause exec_service.bat（アプリケーション実行スクリプト） echo off call set_env.bat echo on simpcl "hello" pause silent_unsinstall.bat（アンインストールスクリプト） echo off echo;
echo 環境変数をセットします call set_env.bat
echo;
echo Tuxedo 10.0をアンインストールします
"%TUXDIR%¥uninstaller¥Uninstall Tuxedo 10.0 with VS2005.exe" echo; echo 不要なフォルダを削除します RMDIR /S /Q "C:¥bea" echo on pause set_env.bat（環境変数設定スクリプト） set TUXDIR=C:¥bea¥tuxedo10.0 set APPDIR=C:¥bea¥apps¥simpapp set TUXCONFIG=C:¥bea¥apps¥tuxconfig set WEBJAVADIR=%TUXDIR%¥udataobj¥java set PATH=%APPDIR%;%TUXDIR%¥bin;¥bin;%PATH%
インストールスクリプトの作成
対象の製品と Tuxedo をパッケージングし、インストールスクリプトを作成する方法を記 載します。概要
Tuxedo をパッケージングする際には、必要なインストール・プロセスをスクリプ ト（バッチファイル、シェルスクリプト等）に実装する必要があります。 必要なコンポーネントと作業手順を以下に記します。 必要なコンポーネント 1. Tuxedoメディアファイル（弊社提供） tuxedo100_32_win_2k3_x86_VS2005.exe（Windows2003 Server用） tuxedo100_32_win_xp_x86_VS2005.exe（WindowsXP用 クライアントのみ） 2. 各種設定ファイル installer.properties（インストールテンプレートファイル） ubbconfig（アプリケーションドメイン設定ファイル）※名前は任意 3. インストール・スクリプト silent_install.bat（サイレントインストールスクリプト） set_env.bat（環境変数設定用スクリプト）※他のスクリプトから利用 4. 各種運用スクリプト silent_boot.bat（リスナー、アプリケーションドメイン起動スクリプト）silent_shutdown.bat（アプリケーションドメイン停止スクリプト） exec_service.bat（アプリケーションの実行スクリプト） silent_unsinltall.bat（Tuxedoアンインストールスクリプト） 5. アプリケーションプログラム コンパイル済みバイナリー simpcl.exe ※名前は任意 simpserv.exe ※名前は任意 ……… インストール・プロセス 1. インストールテンプレートファイル（installer.properties）を編集します。 2. Silentモードでインストーラを起動し、製品をインストールします。 その際に、インストールテンプレートファイルを入力ファイルとして指定します。 3. 環境変数をセットします。 4. Tuxedoアプリケーション及びUBBCONFIGファイルをコピーします。Tuxedoアプリ ケーションは、環境変数APPDIRで指定したフォルダに置かなければなりません。 5. ライセンスファイルを適切なフォルダにコピーします。 6. 各種スクリプトを任意のフォルダへコピーします。 7. インストール環境に合わせてUBBCONFIGファイルを編集します。 サーバマシン名が事前に把握できない場合、MACHINESのADDRESSを編集する必 要があります。 8. UBBCONFIGファイルを元に、TUXCONFIGファイルを生成します。 TUXCONFIGファイルは環境変数TUXCONFIGで指定される場所に作成されます。 9. マシンを再起動します。 注意及び考慮点 利用するUBBCONFIGはインストールする環境に合わせ、編集する必要があります。 編集を行う方法に指定はありませんが、自動スクリプトもしくはウィザードの作りこ みで、環境に合わせたUBBCONFIGの編集を行って下さい。 サンプル silent_install.bat（インストールスクリプト） echo off echo;
echo Tuxedo 10.0をインストールします tuxedo100_32_win_2k3_x86_VS2005.exe -f ./installer.properties echo; echo 環境変数をセットします call set_env.bat echo; echo Tuxedoアプリケーションをコピーします mkdir c:¥bea¥apps
xcopy apps c:¥bea¥apps /E /Y echo;
echo ライセンスファイルをコピーします copy Lic.txt %TUXDIR%¥udataobj¥lic.txt
rem ここにUBBCONFIGファイル編集の処理を入れたい echo; echo TUXCONFIGファイルを生成します tmloadcf -y %APPDIR%¥ubbsimple echo on pause set_env.bat（環境変数設定スクリプト） set TUXDIR=C:¥bea¥tuxedo10.0 set APPDIR=C:¥bea¥apps¥simpapp set TUXCONFIG=C:¥bea¥apps¥tuxconfig set WEBJAVADIR=%TUXDIR%¥udataobj¥java set PATH=%APPDIR%;%TUXDIR%¥bin;¥bin;%PATH%
日本オラクル株式会社
Copyright © 2009 Oracle Corporation Japan. All Rights Reserved. 無断転載を禁ず
この文書はあくまでも参考資料であり、掲載されている情報は予告なしに変更されること があります。日本オラクル社は本書の内容に関していかなる保証もいたしません。また、本 書の内容に関連したいかなる損害についても責任を負いかねます。
Oracle は米国 Oracle Corporation の登録商標です。文中に参照されている各製品名及びサ ービス名は米国Oracle Corporation の商標または登録商標です。その他の製品名及びサービ ス名はそれぞれの所有者の商標または登録商標の可能性があります。
