製品組み込み手順書 Oracle Tuxedo (Windows版)

Transcription

1 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 作成日 : Apr 16, 2009 更新日 : May 版 : 1.1 製品組込み手順書 Oracle Tuxedo (Windows 版 )

2 目次 はじめに...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 (Windows 版 )

3 はじめに 目的 本書は ハードウェアベンダー様 ソフトフェアベンダー様において Oracle Tuxedo( 以下 Tuxedo) を対象の製品に組み込む際のガイドライン及び注意事項を記 載するものです 環境 一覧 本書では 以下の環境を利用します 製品バージョン備考 Microsoft Windowx XP Professional Version 2002 Service Pack 3 本来 WindowsXPではTuxedoのクライアント機能のみをサポート Microsoft Visual C Express API 開発時に必要 Edition Microsoft Platform SDK for SP1 API 開発時に必要 Windows Server 2003 Oracle Tuxedo 10.0 今回はATMIアプリケーションを作成 クライアントアプリケーション ATMI 通信 ATMI サービス Tuxedo クライアント Tuxedo サーバ OS 今回はこのような構成をパッケージングします 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 1

4 関連文書 No 関連文書備考 1 tuxedo_sample_linux.zip サンプル スクリプト 作業概要 以下に Tuxedo をパッケージングし 組込み製品を作成する一般的な手順を記載します 作業内容 作業フロー 環境検討 / 構築 インストールテンプレートファイル作成 アプリケーション作成 設定ファイル作成 運用スクリプト作成 サイレントインストールスクリプト作成 パッケージ作成 作業ステップ詳細 1. 環境検討 / 構築最終的な製品の想定されるシステム構成及び環境を検討し 構築します 2. アプリケーション作成 / 配置サービス及び製品機能を開発し 環境へ配置します 3. 運用スクリプト作成各種運用スクリプトを作成します 4. インストールテンプレートファイルの作成システム構成にあわせたインストールテンプレートファイルを作成します Tuxedo をサイレントインストールする時に システム構成やインストールコンポー 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 2

5 ネントを指定するために使用するファイルです 設定方法の詳細については OTN のマニュアルを参照してください 5. 設定ファイルの作成アプリケーションドメインを起動する時の設定を UBBCONFIG ファイルとして作成します Tuxedo 組込み製品をインストールするマシン名がパッケージング前に分からない場合は インストール時に UBBCONFIG ファイルの内容を編集する必要があります 設定方法の詳細については OTN のマニュアルを参照してください 6. スクリプトの作成サイレントインストール用のスクリプトを作成します 7. パッケージの作成サイレントインストールスクリプトに合わせた形で 各バイナリファイル 設定ファイル スクリプトファイルを配置し パッケージとして CD や DVD アーカイブファイル等を作成します 作業ステップ詳細 1. インストールテンプレートファイルのマシン名は 大文字にする必要があります 管理対象 以下に 運用中に管理すべきファイル及び監視すべきプロセス等を記載します ファイル No ファイル名備考 1 <TUXDIR>/ULOG.xxxxxx tuxedoログファイル 2 <APPDIR>/ULOG.xxxxxx アプリケーションログファイル パス及び接頭語は UBBCONFIGファイルで変更可能 3 UBBCONFIG TUXCONFIGファイルの元となるテキストファイル アプリケーションドメインの設定をする 詳細はマニュアルを参照 4 installer.properties サイレントインストールに使用される設定ファイル 詳細はマニュアルを参照 プロセス No プロセス名備考 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 3

6 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 というように末尾に日付が続くファイル名で残されます 必要なくなったログファイルは適宜 移動 削除してください アプリケーションログファイル UBBCONFIG ファイルの ULOGPFX 属性によって ログファイルのパスと接頭語を設定できます デフォルトは <APPDIR>/ULOG です また Tuxedo ログファイルと同じく ULOG というように末尾に日付が続くファイル名で残されます 必要なくなったログファイルは適宜 移動 削除してください 運用スクリプト作成 製品に組み込んだ Tuxedo アプリケーションを運用する為のスクリプトを作成する方法について記載します 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 4

7 概要 Tuxedo アプリケーションを実行するには リスナーとアプリケーションドメインを起動する必要があります また プロセス間通信を制御するプロセスも必要ですが これはサービスによって自動的に起動されます 必要なスクリプトとその内容を以下に記します 必要なスクリプト 1. ドメイン起動スクリプトリスナー アプリケーションドメインを起動するスクリプト 2. ドメイン停止スクリプトアプリケーションドメインを停止するスクリプト 3. アプリケーション実行スクリプト ( 必要に応じたアプリケーション実行 ) アプリケーションを実行するためのスクリプト 4. Tuxedo アンインストールスクリプト Tuxedo をマシン上からアンインストールするスクリプト ドメイン起動スクリプトの内容 1. 環境変数をセットします 2. リスナーを起動します (tlisten l マシン名 : ポート ) 3. アプリケーションドメインを起動します (tmboot -y) ドメイン停止スクリプトの内容 1. 環境変数をセットします 2. アプリケーションドメインを停止します (tmshutdown -y) 3. 必要ならリスナープロセスをkillします (kill) アプリケーション実行スクリプトの内容 1. 環境変数をセットします 2. 必要に応じてアプリケーションを呼び出します アンインストールスクリプトの内容 1. 環境変数をセットします 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 5

8 2. Tuxedo のアンインストーラを起動します アンインストーラは <TUXDIR>/uninstaller/Uninstall Tuxedo 10.0 with VS2005.exe にあります 3. 必要の無いフォルダを削除します サンプル silent_boot.bat( ドメイン起動スクリプト ) echo off echo 環境変数を設定 call set_env.bat echo tlisten プロセスを開始します tlisten -l "//MachineName:3050" echo Tuxedo アプリケーションを開始します tmboot y echo on pause silent_shutdown.bat( ドメイン停止スクリプト ) echo off echo 環境変数を設定します call set_env.bat 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 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 6

9 echo 環境変数をセットします call set_env.bat echo Tuxedo 10.0 をアンインストールします "%TUXDIR% uninstaller Uninstall Tuxedo 10.0 with VS2005.exe" 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( リスナー アプリケーションドメイン起動スクリプト ) 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 7

10 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 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 8

11 echo Tuxedo 10.0 をインストールします tuxedo100_32_win_2k3_x86_vs2005.exe -f./installer.properties echo 環境変数をセットします call set_env.bat echo Tuxedo アプリケーションをコピーします mkdir c: bea apps xcopy apps c: bea apps /E /Y echo ライセンスファイルをコピーします copy Lic.txt %TUXDIR% udataobj lic.txt rem ここに UBBCONFIG ファイル編集の処理を入れたい 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% 製品組込み手順書 Oracle Tuxedo (Windows 版 ) 9

12 日本オラクル株式会社 Copyright 2009 Oracle Corporation Japan. All Rights Reserved. 無断転載を禁ず この文書はあくまでも参考資料であり 掲載されている情報は予告なしに変更されること があります 日本オラクル社は本書の内容に関していかなる保証もいたしません また 本書の内容に関連したいかなる損害についても責任を負いかねます Oracle は米国 Oracle Corporation の登録商標です 文中に参照されている各製品名及びサービス名は米国 Oracle Corporation の商標または登録商標です その他の製品名及びサービス名はそれぞれの所有者の商標または登録商標の可能性があります 製品組込み手順書 Oracle Tuxedo (Windows 版 )