|
|
tmshutdown(1)
名前
tmshutdown-BEA Tuxedo サーバをシャットダウン
形式
tmshutdown [options]
機能説明
tmshutdown は、サーバの実行を停止させたり、コンフィギュレーション・ファイルに記述されているサービスの宣言を除去したりします。このコマンドを呼び出せるには、掲示板の管理者 (コンフィギュレーション・ファイルの UID パラメータで指定されている) あるいは root だけです。また、tmshutdown は、コンフィギュレーション・ファイルの RESOURCES セクションで MASTER として指定されているマシン、あるいは MASTER として働くバックアップ・マシン (つまり、tmadmin(1) の master コマンドにより DBBL が既に稼働状態である) 上でしか呼び出せません。tmshutdown ただし、分断プロセッサに対して -P オプションが使用されている場合を除きます (下記参照)。
オプションなしの場合、tmshutdown はすべての管理サーバ、TMS、ゲートウェイ・サーバ、および TUXCONFIG 環境変数に指定されているコンフィギュレーション・ファイルの SERVERS セクションに記述されているサーバを停止させ、それらの関連 IPC 資源を除去します。各グループごとに、SERVERS セクションの全サーバ、関連するゲートウェイ・サーバ (外部グループの)、そして TMS サーバがこの順序でシャットダウンされます。管理サーバは最後にシャットダウンされます。
SEQUENCE パラメータの指定がないアプリケーション・サーバは、コンフィギュレーション・ファイル内のサーバ・エントリの順序とは逆に最初にシャットダウンされ、SEQUENCE パラメータの指定されたアプリケーション・サーバはその後、順序番号の大きい方から低い方に向けて順にシャットダウンされます。コンフィギュレーション・ファイルの SERVERS セクションのサーバが複数同じ SEQUENCE パラメータを設定されている場合、tmshutdown はこれらのサーバを同時にシャットダウンします。SERVERS セクションの各エントリには、任意に MIN および MAX パラメータを指定することができます。tmshutdown は、-i オプションが指定されていないかぎり、各サーバ・エントリごとにそのサーバの全オカレンス (MAX 個まで) をシャットダウンします。-i オプションを使用すると、個々のオカレンスをシャットダウンできます。
あるサーバをシャットダウンできない場合、あるいはサービス宣言を除去できない場合、中央のイベント・ログに診断が書き出されます (userlog(3c))。次に、すべてのオプションについて個々に説明します。
注記 -w オプションが適用されるサーバは、UNIX System のシグナル SIGTERM を捕捉できません。
注記 SIGKILL シグナルの受信に基づいてサーバがシャットダウンされる場合、エントリは掲示板に残ります。BBL がシャットダウンされる場合、これらのエントリが検出され、BBL はシャットダウンしません。システムのシャットダウンを完了するには、再度 tmshutdown コマンドを使用しなければならない場合もあります。
注記 このオプションは、UNIX シグナルの SIGTERM と SIGKILL をサポートするシステムでは、これらにマップされます。デフォルトでは、SIGTERM は BEA Tuxedo サーバで順序立てたシャットダウンを開始します。SIGTERM をアプリケーションでリセットすると、BEA Tuxedo システムがサーバをシャットダウンできなくなることがあります。
注記 SIGKILL シグナルの受信に基づいてサーバがシャットダウンされる場合、エントリは掲示板に残ります。BBL がシャットダウンによる場合、これらのエントリが検出され、BBL はシャットダウンしません。システムのシャットダウンを完了するには、再度 tmshutdown コマンドを使用しなければならない場合もあります。
-l、-g、-s および -T オプションを使用すると、TMS サーバがシャットダウンされます。また、-l、-g および -s オプションを使用すると、ゲートウェイ・サーバがシャットダウンされます。-l、-g、-i、-s、-o および -S オプションはアプリケーション・サーバに適用されます。-A、-M および -B オプションは、管理プロセスにのみ適用されます。-l、-g、-i、-o および -s オプションを組み合わせて使用すると、指定された修飾条件をすべて満たすサーバのみがシャットダウンされます。
サーバのシャットダウン時にグローバル・トランザクションが稼働しているといったように分散トランザクション処理機能を使用しようとする場合には、プリコミット後のコミットが記録される場所まで処理が進んでいなかったトランザクションは、アボートします。一方、コミット点まで進んでいたトランザクションは、サーバ (たとえば、TMS) が再度ブートされた時点で処理が完了されます。
相互運用性
tmshutdown はマスタ・ノード上で実行しなければなりません。相互運用アプリケーションでは、マスタ・ノードは最新のリリースでなければなりません。tmshutdown は、リリース 4.1 サイトでリリース 4.2 管理サーバをシャットダウンさせることにつながるコンフィギュレーション・ファイル内の条件を検出し報告します。
移植性
tmshutdown は、BEA Tuxedo サーバ環境がサポートされるプラットホームで実行できます。
診断
tmshutdown は、サーバのシャットダウンに失敗した場合や致命的エラーが発生した場合には、終了コード 1 を返して終了します。詳細については、ユーザ・ログを調べてください。正常に実行できた場合には、終了コード 0 で終了します。
tmshutdown がマスタ・ノードでないアクティブ・ノード上で実行されると、次のような致命的エラー・メッセージが出されます。
tmshutdown cannot run on a non acting-master node in an active application.
プロセスをシャットダウンすることでアクティブ・プロセスが DBBL から分断されると、次のようなエラー・メッセージが出されます。
cannot shutdown, causes partitioning.
サーバが異常終了した場合には、次のような幾分不明瞭なメッセージが出されます。
CMDTUX_CAT:947 Cannot shutdown server GRPID
使用例
システム全体をシャットダウンして、BEA Tuxedo の IPC 資源をすべて削除するには、次のコマンドを実行します。30 秒間確認が得られないと強制的に実行されます。
tmshutdown -w 30
lmid の値が CS1 に設定されているマシン上のサーバだけをシャットダウンするには、次のコマンドを入力します。
tmshutdown -l CS1
-l オプションは SERVERS セクションにリストされているサーバのみにアクションを制限するものであるため、CS1 上の BBL はシャットダウンされません。
注意事項
tmshutdown コマンドは、ハングアップ・シグナル (SIGHUP) を無視します。シャットダウン中にシグナルが検出されても、プロセスは継続します。
関連項目
tmadmin(1)、tmboot(1)、UBBCONFIG(5)
『BEA Tuxedo アプリケーション実行時の管理』
|
Copyright © 2001 BEA Systems, Inc. All rights reserved.
|