WebLogic Scripting Tool ガイド
|
 |
 |
|
以下の節では、WebLogic Scripting Tool (WLST) を使用して WebLogic Server インスタンスを起動および停止し、サーバのライフサイクルをモニタおよび管理する方法について説明します。
有効期間中、サーバは停止、起動、スタンバイ、管理、再開中、実行中など、複数の動作状態を遷移できます。WLST コマンド (起動、中断、再開、停止など) は、サーバ インスタンスの状態に特定の変化をもたらします。
サーバのライフサイクルおよびサーバの管理の詳細については、『サーバの起動と停止の管理』の「サーバのライフサイクルについて」と「ノード マネージャを使用したサーバの制御」を参照してください。
WebLogic Server では、複数の方法でサーバ インスタンスを起動および停止できます。どの方法を選ぶかは、グラフィカル インタフェースとコマンドライン インタフェースのどちらを使用するか、およびサーバのライフサイクルの管理にノード マネージャを使用するかどうかによって決まります。
サーバ インスタンスを起動および停止する方法の概要については、『サーバの起動と停止の管理』の「サーバの起動と停止」を参照してください。
ノード マネージャを使用せずに管理サーバを起動するには、次の手順に従います。
詳細については、「WLST オフラインを使用した WebLogic ドメインの作成とコンフィグレーション」を参照してください。
デフォルトでは、このディレクトリは BEA_HOME\user_projects\domains\domain_name です。BEA_HOME は、BEA Products の最上位インストール ディレクトリです。
startServer([adminServerName], [domainName], [url], [username], [password],[domainDir], [block], [timeout], [serverLog], [systemProperties], [jvmArgs])
startServer コマンドの引数の詳細については、「startServer」を参照してください。
wls:offline/>startServer('AdminServer','mydomain','t3://localhost:7001','weblogic','weblogic','c:/bea/user_projects/domains/mydomain','true','60000','false')
このコマンドでは、ノード マネージャを使用せずに管理サーバを起動します。ただし、ノード マネージャを使用して管理サーバを起動しておけば、ノード マネージャは障害発生時に起動、停止、および再起動をサポートします。「WLST とノード マネージャを使用したサーバ管理」を参照してください。
WLST がサーバ インスタンスを起動した後は、サーバは WLST とは別個のプロセスで実行されます。WLST を終了しても、サーバは停止されません。
ノード マネージャを使用して管理対象サーバおよびクラスタを起動するには、次の手順に従います。
WebLogic Server のカスタム インストール プロセスでは、必要に応じてノード マネージャを Windows システム上の Windows サービスとしてインストールおよび起動します。『インストール ガイド』の「Windows サービスとしてのノード マネージャのインストールについて」を参照してください。手順の詳細については、『サーバの起動と停止の管理』の「ノード マネージャの起動と実行」を参照してください。
Windows の場合、ノード マネージャは [スタート] メニューのショートカット ([Tools｜ノード マネージャ]) から起動できます。
既に実行中でなければ、ノード マネージャはコマンド プロンプトで WLST を呼び出し、startNodeManager コマンドを入力することによって、手動で起動できます。
c:\>java weblogic.WLSTwls:/offline> startNodeManager()
startNodeManager の詳細については、「startNodeManager」を参照してください。
c:\>java weblogic.WLSTwls:/(offline)> connect('username','password')Connecting to weblogic server instance running at t3://localhost:7001 as username weblogic ...
Successfully connected to Admin Server 'myserver' that belongs to domain 'mydomain'.
Warning: An insecure protocol was used to connect to the server.
To ensure on-the-wire security, the SSL port or Admin port should be used instead.
connect コマンド引数の詳細については、「connect」を参照してください。
start コマンドは、ノード マネージャを使用して、ドメイン内の管理対象サーバまたはクラスタを起動します。start コマンドを使用するには、実行中の管理サーバに WLST が接続されている必要があります。実行中の管理サーバなしで管理対象サーバを起動するには、WLST がノード マネージャに接続された状態で、nmStart コマンドを使用します。「WLST とノード マネージャを使用したサーバ管理」を参照してください。
wls:/mydomain/serverConfig> start('mycluster', 'Cluster')Starting the following servers in Cluster, mycluster: MS1, MS2, MS3...
......................................................................
All servers in the cluster mycluster are started successfully.
wls:/mydomain/serverConfig>
詳細については、「start」を参照してください。
ノード マネージャは、サーバ インスタンス (管理サーバと管理対象サーバの双方) のモニタ、起動、および停止を行い、障害発生後、自動的に再起動することを可能にする、WebLogic Server インスタンスのリモート制御用ユーティリティです。ノード マネージャの詳細については、『サーバの起動と停止の管理』の「ノード マネージャを使用したサーバの制御」を参照してください。
WLST をノード マネージャ クライアントとして使用することで、サーバ インスタンスをリモートまたはローカルで起動、停止、および再起動できます。加えて、WLST ではサーバのステータスを取得し、サーバの出力ログの内容を取得できます。
ノード マネージャがサポートされているコマンドを呼び出すには、実行中のノード マネージャのインスタンスに WLST を接続します。WLST を介して発行されたノード マネージャ コマンドは、対象サーバのインスタンスをホストしているシステム上のノード マネージャによって処理されます。ノード マネージャによって認証された後は、ノード マネージャ コマンドを入力するたびに再認証する必要はありません。
また、nmEnroll コマンドを入力すると、WLST を実行するマシンを、ノード マネージャでモニタするように登録できます。このコマンドは、ドメインが管理サーバのルート ディレクトリを共有していない限り、ドメイン単位、マシン単位で 1 回ずつ実行する必要があります。このコマンドを実行するには WLST が管理サーバに接続されている必要があります。WLST がノード マネージャに接続されている必要はありません。「nmEnroll」を参照してください。
マシン上の WLST からノード マネージャ プロセスへの通信には、次のものがあります。
以下の例では、WLST ノード マネージャを使用して、管理サーバを起動、モニタ、および停止しています。
wls:/offline>nmConnect('username','password','nmHost','nmPort','domainName','domainDir','nmType')
nmConnect('weblogic', 'weblogic', 'localhost', '5556', 'mydomain','c:/bea/user_projects/domains/mydomain','ssl')
Connecting to Node Manager ...>
Successfully connected.
wls:/nm/mydomain
nmConnect コマンドの引数の詳細については、「nmConnect」を参照してください。
WLST のノード マネージャへの接続が正常に行われた後は、管理サーバおよび管理対象サーバのインスタンスを起動、モニタ、および停止できるようになります。
ノード マネージャに接続されていれば、nmStart コマンドは実行中の管理サーバがなくても管理対象サーバを起動します。
WLST のノード マネージャのコマンドの詳細については、「ノード マネージャ コマンド」を参照してください。
WebLogic Server は、サーバ インスタンスの現在の動作状態、およびサーバ インスタンスが起動してからこれまでに起こった状態の遷移に関する情報を表示および保存します。この情報は、以下の作業を行う管理者にとって有益です。
WLST を使用すると、次のようにしてサーバ インスタンスの状態を取得できます。
state コマンドを使用 - サーバまたはクラスタの状態を返す。wls:/mydomain/serverConfig> state('serverName','Server')Current state of 'managed1' : RUNNING
wls:/mydomain/serverConfig>
「state」を参照。
ServerRuntimeMBean に移動して、State 属性を表示する。 WLST サーバのモニタ、停止、および再起動の動作を調整するには、「サーバ状態をモニタするスクリプト」を参照してください。
WLST ライフサイクル コマンドを使うと、サーバ インスタンスが遷移する状態を制御できます。「ライフサイクル コマンド」を参照してください。
コード リスト 5-1 のコマンドは、RUNNING->ADMIN->RUNNING->SHUTDOWN の順に、WebLogic Server のサーバ状態を明示的に移行させます。
このスクリプトを実行する前に、WebLogic Server を起動します。「スクリプトの実行」を参照してください。
connect("username","password","t3://localhost:8001")
# まず、管理ポートを有効化する。これは必須ではない
edit()
startEdit()
cmo.setAdministrationPortEnabled(1)
activate(block="true")
# サーバの状態を確認する
state("myserver")
# ここで、サーバを RUNNING 状態から ADMIN に移行する
suspend("myserver", block="true")
# 状態を確認する
state("myserver")
# ここで、サーバを再開して RUNNING 状態にする
resume("myserver",block="true")
# 状態を確認する
state("myserver")
# ここで、サーバのスレッド ダンプを取得する
threadDump("./dumps/threadDumpAdminServer.txt")
# 最後に、サーバを停止する
shutdown(block="true")
|
|
|