有効期間中、サーバは停止、起動、スタンバイ、管理、再開中、実行中など、複数の動作状態を遷移できます。サーバのライフサイクルの詳細については、『Oracle Fusion Middleware Oracle WebLogic Server サーバの起動と停止の管理』の「サーバのライフサイクルについて」を参照してください。
以下の節では、WebLogic Scripting Tool (WLST) を使用して、サーバのライフサイクルを管理およびモニタする方法について説明します。
サーバ インスタンスを起動および停止するその他の方法については、『Oracle Fusion Middleware Oracle WebLogic Server サーバの起動と停止の管理』の「サーバの起動と停止」を参照してください。
ノード マネージャは、単一の WLST セッションおよび単一のネットワーク接続を介して複数のサーバのライフサイクルを制御できるユーティリティです (障害発生後にサーバを自動的に再起動することもできます)。ノード マネージャの詳細については、『Oracle Fusion Middleware Oracle WebLogic Server ノード マネージャ管理者ガイド』を参照してください。
WLST では、ノード マネージャに関して次のことを実行できます。
ノード マネージャの起動。
ノード マネージャへの接続後の、ノード マネージャを使用したノード マネージャ マシン上のサーバの起動および停止。図 4-1 を参照してください。
ノード マネージャ プロセスは、特定の WebLogic ドメインではなく、マシンに関連付けられます。サーバ インスタンスがノード マネージャ プロセスと同じマシン上に存在している限り、同じノード マネージャ プロセスを使用して任意の WebLogic Server ドメインのサーバ インスタンスを制御できます。
ノード マネージャ クライアントとして動作しているときに WLST で使用可能なコマンドについては、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「ノード マネージャ コマンド」を参照してください。
管理サーバへの接続後の、管理サーバを使用したドメイン内のサーバの起動および停止。図 4-2 を参照してください。
このケースでは、WLST が管理サーバのクライアントで、管理サーバでは 1 つまたは複数のノード マネージャを使用して管理対象サーバを起動しています。
管理サーバ クライアントとして動作しているときに WLST で使用可能なライフサイクル コマンドについては、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「ライフサイクル コマンド」を参照してください。
WLST では、任意のマシン上で実行されているノード マネージャに接続でき、そのマシン上の 1 つまたは複数の WebLogic Server インスタンスを起動できます。この方法を使用して WLST およびノード マネージャでサーバ インスタンスを起動するために、ドメインの管理サーバが実行されている必要はありません。
WLST をノード マネージャに接続し、サーバを起動するには、次の手順を実行します。
サーバを起動するようにノード マネージャをコンフィグレーションします。
『Oracle Fusion Middleware Oracle WebLogic Server ノード マネージャ管理者ガイド』の「ノード マネージャの一般的なコンフィグレーション」を参照してください。
ノード マネージャを起動します。
通常はノード マネージャのコンフィグレーションにおいて、ホスト コンピュータの起動時にノード マネージャを自動的に起動する Windows サービスまたはデーモンを作成します。『Oracle Fusion Middleware Oracle WebLogic Server ノード マネージャ管理者ガイド』の「サービスとしてのノード マネージャの実行」を参照してください。
ノード マネージャがまだ起動していない場合、ホスト コンピュータにログオンし、WLST を使用して起動できます。
c:\>java weblogic.WLST wls:/offline> startNodeManager()
startNodeManager
の詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「startNodeManager」を参照してください。
WLST を起動します。
java weblogic.WLST
nmConnect
コマンドを入力して、WLST をノード マネージャに接続します。
wls:/offline>
nmConnect('username','password','nmHost','nmPort',
'domainName','domainDir','nmType')
次に例を示します。
nmConnect('weblogic', 'welcome1', 'localhost', '5556', 'mydomain','c:/bea/user_projects/domains/mydomain','ssl') Connecting to Node Manager ... Successfully connected. wls:/nm/mydomain>
nmConnect
コマンド引数の詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「nmConnect」を参照してください。
nmStart
コマンドを使用して、サーバを起動します。
wls:/nm/mydomain>nmStart('AdminServer')
starting server AdminServer
...
Server AdminServer started successfully
wls:/nm/mydomain>
nmServerStatus
コマンドを入力して、管理サーバのステータスをモニタします。
wls:/nm/mydomain>nmServerStatus('serverName')
RUNNING
wls:/nm/mydomain>
nmKill
コマンドを入力して、サーバを停止します。
wls:/nm/mydomain>nmKill('serverName')
Killing server AdminServer
Server AdminServer killed successfully
wls:/nm/mydomain>
WLST のノード マネージャのコマンドの詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「ノード マネージャ コマンド」を参照してください。
ノード マネージャを使用して管理対象サーバおよびクラスタを起動するには、次の手順に従います。
サーバを起動するようにノード マネージャをコンフィグレーションします。
『Oracle Fusion Middleware Oracle WebLogic Server ノード マネージャ管理者ガイド』の「ノード マネージャの一般的なコンフィグレーション」を参照してください。
ノード マネージャを起動します。
通常はノード マネージャのコンフィグレーションにおいて、ホスト コンピュータの起動時にノード マネージャを自動的に起動する Windows サービスまたはデーモンを作成します。『Oracle Fusion Middleware Oracle WebLogic Server ノード マネージャ管理者ガイド』の「サービスとしてのノード マネージャの実行」を参照してください。
ノード マネージャがまだ起動していない場合、ホスト コンピュータにログオンし、WLST を使用して起動できます。
c:\>java weblogic.WLST
wls:/offline> startNodeManager()
startNodeManager
の詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「startNodeManager」を参照してください。
管理サーバを起動します。
WLST がまだ実行されていない場合は呼び出します。次に、connect
コマンドを使用して、実行中の WebLogic 管理サーバのインスタンスに WLST を接続します。
c:\>java weblogic.WLST wls:/(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.wls:/mydomain/serverConfig>
connect
コマンド引数の詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「connect」を参照してください。
以下のいずれかを行います。
管理対象サーバを起動する。次のコマンドを入力します。
start('
managedServerName
','Server')
ここで、managedServerName
はサーバの名前です。次に例を示します。
start('managed1','Server')
クラスタを起動する。次のコマンドを入力します。
start('
clusterName
', 'Cluster')
ここで、clusterName
はクラスタの名前です。次に例を示します。
start('mycluster', 'Cluster')
詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「start」を参照してください。
以下の節では、ノード マネージャを使用せずにサーバを起動し、サーバ状態を管理する方法について説明します。
ノード マネージャを使用しないと、WLST では管理対象サーバを起動できません。サーバ インスタンスを起動および停止するその他の方法については、『Oracle Fusion Middleware Oracle WebLogic Server サーバの起動と停止の管理』の「サーバの起動と停止」を参照してください。
ノード マネージャを使用せずに管理サーバを起動するには、次の手順に従います。
まだドメインを作成していない場合は、WLST でドメインを作成します。
詳細については、「WLST オフラインを使用したドメインの作成」を参照してください。
ドメインを作成したコンピュータでシェル (コマンド プロンプト) を開きます。
ドメインを配置したディレクトリに移動します。
デフォルトでは、このディレクトリは MW_HOME
\user_projects\domains\
domain_name
です。MW_HOME
は、Oracle WebLogic 製品の最上位インストール ディレクトリです。
以下のスクリプトのいずれかを実行して、環境を設定します。
bin\setDomainEnv.cmd
(Windows の場合)
bin/setDomainEnv.sh
(UNIX の場合)
Windows の場合は、[スタート] メニューのショートカットで環境変数を設定し、WLST を呼び出すことができます ([Tools|WebLogic Scripting Tool])。
java weblogic.WLST
と入力して、WLST を呼び出します。
WLST プロンプトが表示されます。
wls:/(offline)>
WLST の startServer
コマンドを使用して、管理サーバを起動します。
startServer([adminServerName], [domainName], [url], [username], [password],[domainDir], [block], [timeout], [serverLog], [systemProperties], [jvmArgs] [spaceAsJvmArgsDelimiter])
startServer
コマンド引数の詳細については、『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「startServer」を参照してください。
次に例を示します。
wls:offline/>startServer('AdminServer','mydomain','t3://localhost:7001',
'weblogic','welcome1','c:/bea/user_projects/domains/mydomain',
'true',60000,'false')
WLST がサーバ インスタンスを起動した後は、サーバは WLST とは別個のプロセスで実行されます。WLST を終了しても、サーバは停止されません。
WLST ライフサイクル コマンドを使うと、サーバ インスタンスが遷移する状態を制御できます。『Oracle Fusion Middleware WebLogic Scripting Tool コマンド リファレンス』の「ライフサイクル コマンド」を参照してください。サーバに接続し、管理コマンドを発行する際は、ドメインの管理ポートを有効化および使用することをお勧めします。「WLST 接続の保護」を参照してください。
コード リスト 4-1 のコマンドは、RUNNING->ADMIN->RUNNING->SHUTDOWN
の順に、WebLogic Server のサーバ状態を明示的に移行させます。
このスクリプトを実行する前に、WebLogic Server を起動します。「WLST の呼び出し」を参照してください。
コード リスト 4-1 WLST ライフサイクルのコマンド
connect("username","password","t3://localhost:8001") # まず、管理ポートを有効化する。これは必須ではない。 # ドメインの管理ポートを有効化すると、WebLogic Server によって # そのコンフィグレーション ファイルでの設定が永続化される。以降の WLST セッションでは # このプロセスを繰り返す必要がない。 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")