|
|
tuxwsvr(1)
名前
tuxwsvr-BEA Tuxedo Administration Consoleで使用するミニ・ウェブ・サーバ
形式
tuxwsvr -l nlsaddr [-d device] [-L logfile] [-F]
-i initialization_file
機能説明
tuxwsvr は World Wide Web サーバ・プロセスです。これを使用すれば、顧客は BEA Tuxedo Administration Console プロセスが動作するマシン上に商用 Web サーバまたはパブリック・ドメイン Web サーバを設置していなくても、BEA Tuxedo Administration Console プロセスをサポートすることができます。tuxwsvr は、特にその他の指定がない限り、起動後はバックグラウンドで動作し、マシンがシャットダウンするか、オペレーティング・システム・コマンドを使用して tuxwsvr プロセスが強制終了されるまで実行を継続します。
tuxwsvr は、BEA Tuxedo Administration Console のサポートに必要なすべての機能を含んでいますが、事前分岐プロセス、サーバ側の HTML インクルード (.shtml ファイル)、デフォルトのディレクトリ・インデックス、https 接続など、商用 Web サーバ用の多数の機能は含まれていません。ただし、BEA Tuxedo Administration Console は、独自の暗号化プロトコルを実装しているため、https 接続がなくても安全なモードで実行することができます。性能上の理由から、一般的な Web サーバでは、受信された要求に対する DNS 逆ルックアップは実行されません。
tuxwsvr で使用されるコマンド行オプションには、以下のものがあります。
"//#.#.#.#:port_number"
初期化ファイルの形式
初期化ファイルには、Web サーバで必要となるディレクトリへのマッピングが含まれます。また、いくつかのコメント行が含まれる場合もあります。コメント行の先頭には # 記号が付きます。コメント行以外の行は、空白で区切られた 3 つのフィールドで構成されます。
フィールド |
内容 |
---|---|
1 |
HTML または CGI。この行で記述されたディレクトリ内のファイルの種類 (HTML ファイルまたは実行可能な CGI プログラム) を示します。 |
2 |
パスの接頭辞。特定の要求が複数の接頭辞に一致する場合は、最初に一致した接頭辞が選択されます。 |
3 |
パスの接頭辞 (フィールド 2) のマッピング先となるディレクトリまたはファイル。 |
初期化ファイルでコメント行以外の最後の行には、接頭辞 "/" が必要です。これよりも前の行に接頭辞 "/" が付いていると、警告メッセージが生成されます。 初期化ファイルを変更する際の注意 初期化ファイルは、起動時に 1 回読み取られます。したがって、このファイルに何らかの変更を加えた場合は、変更を有効にする前に tuxwsvr を停止して再起動する必要があります。 UNIX システムの初期化ファイルの例 次に UNIX システムの初期化ファイルの例を示します。 次のようなマシンのポート 8080 で Web サーバが稼動しているとします。 以下のいずれかの URL への要求を入力します。 この要求により、以下の 2 つの処理が行われます。CGI /cgi-bin /home/tuxedo/udataobj/webgui/cgi-bin
CGI /webgui /home/tuxedo/udataobj/webgui/cgi-bin
HTML /java /home/tuxedo/udataobj/webgui/java
HTML /doc /home/tuxedo/doc
HTML / /home/tuxedo/udataobj/webguituxmach.acme.com
http://tuxmach.acme.com:8080/cgi-bin/tuxadm?TUXDIR=/home/tuxedohttp://tuxmach.acme.com:8080/webgui/tuxadm?TUXDIR=/home/tuxedo
/home/tuxedo/udataobj/webgui/tuxadm
初期化ファイルの CGI ディレクトリの値として $TUXDIR/bin を指定することはお勧めできません。このように指定すると、Web ユーザが BEA Tuxedo の実行可能ファイルを起動してしまう可能性があります。ただし、このようなユーザによって、tuxadm 以外の実行可能ファイルの結果が参照されることはありません。これらの実行可能ファイルは CGI プログラムとして記述されていないからです。
また、前の例では、最初の HTML 行は、2 つ目の HTML 行でサブディレクトリの /java を同じパスにマッピングしているため重複しています。この最初の行を含める理由は、ユーザによっては HTML ドキュメントを格納している場所とは別の場所にJava クラス・ファイルを配置することがあるからです。
Windows の初期化ファイルの例
次に Windows システムの初期化ファイルの例を示します。
HTML /tuxedo/webgui D:¥tuxedo¥htmldocs
CGI /cgi-bin C:¥cgi-bin
HTML /java D:¥tuxedo¥udataobj¥webgui¥¥java
HTML / D:¥tuxedo¥udataobj¥webgui
マシン ntsvr1 のポート 80 で Web サーバが稼動しているとします。次の URL を入力します。
http://ntsvr1/tuxedo/webgui/page1.html
次のファイルが検索されます。
D:¥tuxedo¥htmldocs¥page1.html
おそらくこのファイルは、Administration Consoleを起動する、顧客によって作成されたページです。
終了方法
tuxwsvr プロセスを正常に終了する唯一の方法は、プロセスに SIGTERM シグナルを送ることです。
推奨される使用法
BEA Tuxedo システムの現在のリリースでは、tuxwsvr プロセスは、商用 Web サーバを設置していない顧客向けに、BEA Tuxedo 管理 GUI 用の Web サーバとして提供されています。UNIX システムの場合は、次の形式のコマンド行を UNIX の初期化スクリプトに追加して、Web サーバが自動的に起動するようにすることをお勧めします。
TUXDIR=tuxdir_path_name $TUXDIR/bin/tuxwsvr -l nlsaddr -i initialization_file
tuxdir_path_name は、BEA Tuxedo システム・ソフトウェアの場所への絶対パス名を表します。nlsaddr は、この tuxwsvr プロセスによって使用される、ネットワーク上のアドレスです。
tuxwsvr プロセスを起動する別の方法として、上記の推奨コマンド行を使用して手動で起動する方法があります。また、cron ジョブを使用して定期的 (毎日またはそれより頻繁) に tuxwsvr プロセスを起動する方法もあります。同じネットワーク・アドレスを使用して tuxwsvr コマンドを重複して呼び出すと、コマンドは自動的に終了し、状況に応じてメッセージが記録されます。
ネットワーク・アドレス
アプリケーション管理者が tuxwsvr プロセスにネットワーク・アドレスを指定する場合、指定されたネットワーク上で一意なネットワーク・アドレスを指定しなければならないという制約が 1 つだけあります。STARLAN ネットワークの場合は、推奨するアドレス uname.tuxwsvr が通常一意の名前となります。TCP/IP の場合は、アプリケーション管理者が選択した一意なポートとローカル・マシンのノード識別子をペアにした 0x0002ppppnnnnnnnn の形式のアドレスになります。特定のマシン (pppp) で使用する一意なポート値は、ネットワークとマシンの組み合わせを考慮してユーザ間で取り決める必要があります。低いポート番号はシステム関連のサービスで使用されることが多いため、一般には高いポート番号が有効です。ノード・フィールド (nnnnnnnn) に適切な値は、以下の手順を実行して /etc/hosts ファイルから見つけることができます。
node_name が返されます。
182.11.108.107 node_name が返されます。
ネットワーク・アドレスの例
たとえば、tuxwsvr を実行しているローカル・マシンで TCP/IP アドレス指定機能を使用している場合を考えます。マシン名は backus.company.com、アドレスは 155.2.193.18、tuxwsvr が要求を受け取るポート番号は 2334 であるとします。また、ポート番号 2334 は bankapp-tuxwsvr という名前のネットワーク・サービス・データベースに追加されていると仮定します。-l オプションで指定するアドレスは次に示す方法で表現できます。
最後に示す行は、アドレスを 16 進数形式で表したものです。0002 は TCP/IP アドレスの先頭部分、091E はポート番号 2334 を 16 進数に変換したもの、および 9B02C112 は IP アドレス 155.2.193.18 を 16 進数に変換したものです。最後の変換部分については、155 は 9B、2 は 02 のように変換されています。
STARLAN ネットワークの場合は、通常、推奨アドレス uname.tuxwsvr が一意の名前になります。
関連項目
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|