2 ノード・マネージャの概要

この章では、WebLogic Serverユーティリティの1つであるノード・マネージャについて紹介します。また、ノード・マネージャが管理サーバーと管理対象サーバーをコントロールする仕組みについても説明します。

この章には次の項が含まれます:

概要
ノード・マネージャのバージョン
ノード・マネージャへのアクセス
ノード・マネージャの機能
WebLogic Server環境でのノード・マネージャの機能
ノード・マネージャとシステム・クラッシュのリカバリ
ノード・マネージャの構成ファイルとログ・ファイル

はじめに

WebLogic Serverの本番環境では、サーバー・インスタンスが複数のドメイン、マシン、および地理的な場所にまたがって分散することがよくあります。ノード・マネージャは、離れた場所から管理サーバー・インスタンスや管理対象サーバー・インスタンスを起動、停止、および再起動できるWebLogic Server付属のユーティリティです。ノード・マネージャは任意指定の機能ですが、高可用性が要求されるアプリケーションをWebLogic Server環境でホストする場合には使用することをお薦めします。

以前のリリースでは、ノード・マネージャ・プロセスは特定のWebLogicドメインではなくホスト・マシンに関連付けられていました。サーバー・インスタンスがノード・マネージャ・プロセスと同じマシン上に存在しているかぎり、同じノード・マネージャ・プロセスを使用して任意のWebLogicドメインのサーバー・インスタンスを制御しており、マシンにスコープ指定されたホストごとのノード・マネージャでした。　このリリースのWebLogic Serverでは、デフォルトでJavaバージョンのノード・マネージャが、同じドメインに属するすべてのサーバー・インスタンスを制御するように構成されており、ドメインごとのノード・マネージャになります。サーバー・インスタンスは同じマシンに存在する必要はありません。ドメイン固有のJavaベースのノード・マネージャを、それぞれ異なる構成で実行できるようになりました。詳細は、「ノード・マネージャのデフォルト構成」を参照してください。

ノード・マネージャは、ノード・マネージャを使用して制御するWebLogic Serverインスタンス(管理サーバーまたは管理対象サーバー)をホストするコンピュータごとに実行する必要があります。

ノード・マネージャのバージョン

WebLogic Serverには、Javaベースのノード・マネージャとスクリプト・ベースのノード・マネージャという、同じような機能を持つ2つのバージョンのノード・マネージャが用意されています。ただし、それぞれのバージョンでは、構成とセキュリティに関する考慮事項が異なっています。

Javaベースのノード・マネージャ

Javaベースのノード・マネージャは、Java仮想マシン(JVM)プロセスで動作します。ノード・マネージャは、WindowsプラットフォームではWindowsサービスとして、UNIXプラットフォームではオペレーティング・システムのサービスとして実行することをお薦めします。これにより、システムの再起動時にノード・マネージャを自動的に再起動できるようになります。

Oracleでは、Windows、Solaris、Linux on Intel、Linux on Z-SeriesおよびAIXオペレーティング・システム用のネイティブ・ノード・マネージャ・ライブラリを提供しています。

注意:

ノード・マネージャは、Open VMS、OS/390、AS400、UnixWare、またはTru64 UNIXではサポートされていません。

このバージョンのノード・マネージャの構成は、nodemanager.propertiesファイルで指定されます。「nodemanager.propertiesのレビュー」を参照してください。

Javaベースのノード・マネージャは、スクリプト・ベースのノード・マネージャよりセキュリティ面で優れています。「Javaベースのノード・マネージャのセキュリティの構成」を参照してください。

スクリプト・ベースのノード・マネージャ

UNIXおよびLinuxシステムに対しては、スクリプト・ベース・バージョンのノード・マネージャが提供されます。このスクリプトはUNIXシェル・スクリプトに基づいていますが、セキュリティ向上のためにSSHを使用します。SSHではユーザーIDベースのセキュリティが使用されます。

スクリプト・バージョンのノード・マネージャの構成については、「スクリプト・ノード・マネージャの構成」を参照してください。

このバージョンのノード・マネージャでは、Javaベースのノード・マネージャほどのセキュリティは提供されません。しかし、スクリプト・ベースのノード・マネージャの利点は、SSHを使用するように構成されたネットワーク上でサーバーをリモート管理できることです。サーバーを追加でインストールする必要はありません。スクリプトをリモート・マシンにコピーするだけです。

注意:

スクリプト・ベースのノード・マネージャは、オペレーティング・システムのサービスとして実行することをお薦めします。これにより、システムの再起動時にノード・マネージャを自動的に再起動できるようになります。

使用するノード・マネージャ・バージョンの決定

どのバージョンのノード・マネージャを使用するかは、お使いのWebLogic Server環境の要件によって異なります。現在の環境に最適なバージョンを判断する際は、以下の点を考慮してください。

WebLogic ServerをWindowsシステムにインストールしている場合は、Javaバージョンのノード・マネージャを使用する必要があります。スクリプト・バージョンのノード・マネージャは、Windowsではサポートされません。
コンセンサス・リースを使用する場合は、Javaバージョンのノード・マネージャを使用するとパフォーマンスが向上する可能性があります。
スクリプト・ベースのノード・マネージャの場合は、セキュリティ構成をJavaバージョンよりもかなり単純にする必要があります。RSHおよびSSHは、Javaバージョンのノード・マネージャで使用するSSLよりも一般的で構成も容易なセキュリティ手法です。スクリプト・バージョンのノード・マネージャの場合は、必要なサイズもJavaバージョンに比べて小さくなります。
Javaバージョンのノード・マネージャは、サポートされるUNIXシステムでinetdと組み合わせて使用できます。inetdを使用すると、構成されたポートでリクエストを受信したときにノード・マネージャを自動的に再起動できます。

ノード・マネージャへのアクセス

ノード・マネージャ・クライアントは、通信するノード・マネージャのローカルにあってもリモートにあってもかまいません。以下のクライアントから、Javaバージョンまたはスクリプト・ベース(SSH)バージョンのノード・マネージャのうち、いずれかにアクセスします(また、スクリプト・ベースのノード・マネージャで使用するための、シェル・コマンド・テンプレート形式によるSSHクライアントが用意されています)。

管理サーバー
- 管理コンソールの「環境」>「マシン」>「構成」>ノード・マネージャページ
たとえば、管理サーバーに通信してServerLifeCycleRuntimeMBeanに対する操作を実行するJMXユーティリティを作成できます。このServerLifeCycleRuntimeMBeanは、内部でノード・マネージャを使用して、操作を実行します。JMXの詳細は、『Oracle WebLogic Server JMXによるカスタム管理ユーティリティの開発』を参照してください。
WLSTコマンドおよびスクリプト - WLSTオフラインは実行中の管理サーバーが存在しない場合に実行可能なノード・マネージャ・コマンド・ライン・インタフェースとして機能します。WLSTコマンドを使用すると、管理サーバーに接続せずにサーバー・インスタンスの起動、停止、および監視を行うことができます。管理サーバーの起動が、スタンドアロン・クライアントの主な目的です。ただし、次の目的にも使用できます。
- ノード・マネージャを使用して起動されたサーバー・インスタンスの停止
- 管理対象サーバーの起動
- ノード・マネージャのログ・ファイルの内容へのアクセス
- ノード・マネージャで起動されたサーバーのステータスの取得
- サーバー出力ログの内容の取得

WLSTおよびノード・マネージャを使用したサーバーの制御の詳細は、「ノード・マネージャを使用したサーバーの制御」を参照してください。

ノード・マネージャの機能

次の項では、基本的なノード・マネージャの機能について説明します。

管理サーバーの起動、停止、および再起動

WebLogic Scripting Tool(またはスクリプト・ベースのノード・マネージャを使用する場合のみSSHクライアント)を使用して、管理サーバーをホストするマシン上のノード・マネージャ・プロセスに接続し、管理サーバーを起動、停止または再起動するためのコマンドを発行します。管理サーバーとノード・マネージャの関係は、シナリオに応じて異なります。

管理サーバーをノード・マネージャの制御下に置くことができます。ノード・マネージャを使用して管理サーバーを起動、モニター、および再起動できます。
管理サーバーをノード・マネージャ・クライアントにできます。管理コンソールから管理対象サーバーを起動または停止するときには、管理サーバーを使用してノード・マネージャにアクセスしています。
管理サーバーではノード・マネージャを使用して管理対象サーバーを起動するプロセスがサポートされています。ノード・マネージャを使用して管理対象サーバーを起動するときには、管理対象サーバーは管理サーバーにアクセスして未処理の構成の更新を取得します。

管理対象サーバーの起動、停止、一時停止、および再起動

WebLogic Server Scripting Tool (WLST)コマンド・ラインまたはスクリプトを使用してノード・マネージャにコマンドを発行し、管理対象サーバー・インスタンスやクラスタを起動、停止、一時停止、および再起動できます。

ノード・マネージャは、管理サーバーにアクセスできない場合でも管理対象サーバー独立(MSI)モードが有効になっていれば、管理対象サーバー・インスタンスを障害後に再起動できます。デフォルトでは、これは有効になっています。

注意:

ノード・マネージャは、最初からMSIモードで管理対象サーバーを起動することはできません。管理対象サーバーが自身の構成を設定を取得するには、ドメインの管理サーバーにアクセスできなくてはならないからです。

注意:

ノードマネージャは、スクリプトまたはコマンドラインで管理対象サーバーを起動するときに指定するものと同じコマンド引数を使用します。起動引数の詳細は、『Oracle WebLogic Serverコマンド・リファレンス』のweblogic.Serverコマンド・ライン・リファレンスに関する項を参照してください。

管理サーバーおよび管理対象サーバーの再起動

ノード・マネージャを使用して起動されたサーバー・インスタンスに障害が発生した場合、ノード・マネージャはそのインスタンスを自動的に再起動します。

注意:

ノード・マネージャは、ノード・マネージャを使用して起動されたサーバーのみを再起動できます。

再起動機能は構成可能です。ノード・マネージャのデフォルトの動作は、以下のとおりです。

障害の発生した、制御下にあるサーバー・インスタンスを自動的に再起動します。この機能は無効にできます。
障害の発生したサーバー・インスタンスを特定の回数まで再起動します。再起動の回数は、ノード・マネージャのstartup.propertiesファイルでRestartMaxプロパティを設定して定義します。

ノード・マネージャに障害が発生した場合や、ノード・マネージャが明示的に停止された場合、ノード・マネージャは再起動時に前回の終了時に制御下にあったサーバー・インスタンスを判別します。ノード・マネージャは必要に応じて障害の発生したサーバー・インスタンスを再起動できます。

注意:

ノード・マネージャをオペレーティング・システムのサービスとして実行することをお薦めします。これにより、ホスト・マシンの再起動時にノード・マネージャを自動的に再起動できるようになります。

サーバーのモニターとログ・データの表示

ノード・マネージャは、ノード・マネージャ・プロセスのログ・ファイルと、自身が制御する各サーバー・インスタンスのサーバー出力ログ・ファイルを作成します。これらのログ・ファイルは、サーバー・インスタンスのログ・ファイルと同様に管理コンソールまたはWLSTまたはコマンドを使用して表示できます。詳細は、「ログ・ファイル」を参照してください。

WebLogic Server環境でのノード・マネージャの機能

次の項では、ノード・マネージャがサーバーとの通信に使用するプロセスの図および説明と合わせて、ノード・マネージャの役割のWebLogic Server環境における「全体像」を示します。

ノード・マネージャとサーバーの図
ノード・マネージャが管理サーバーを起動する仕組み
ノード・マネージャが管理対象サーバーを起動する仕組み
ノード・マネージャが管理サーバーを再起動する仕組み
ノード・マネージャが管理対象サーバーを再起動する仕組み
ノード・マネージャがサーバー・インスタンスを停止する仕組み

ノード・マネージャとサーバーの図

図2-1は、ノード・マネージャ、ノード・マネージャのクライアント、およびノード・マネージャが制御するサーバー・インスタンスの関係を示します。

図2-1 WebLogic Server環境でのノード・マネージャ

「図2-1 WebLogic Server環境でのノード・マネージャ」の説明

ノード・マネージャが管理サーバーを起動する仕組み

図2-2は、ノード・マネージャによる管理サーバー起動プロセスを示します。

この項では、すでに管理サーバーをインストールし、構成ウィザードを使用してドメイン・ディレクトリを作成していることを前提としています。

ノード・マネージャは、管理サーバーをホストするマシンAで実行されています。スタンドアロンのノード・マネージャ・クライアントはリモートにあります。

図2-2 管理サーバーの起動

「図2-2 管理サーバーの起動」の説明

認可されたユーザーは、WLSTオフライン・コマンドnmConnectを発行し、管理サーバーをホストするマシン上のノード・マネージャ・プロセスに接続します。(ノード・マネージャ・インスタンスがSSHバージョンである場合は、ユーザーはSSHクライアントを使用して接続できます)。nmConnectコマンドによってノード・マネージャのユーザー名とパスワードが提供され、これらを使用してユーザーはノード・マネージャの認証を受けます。

次に、ユーザーはnmStartコマンドを発行し、管理サーバーを起動するための資格証明を提供します。例:

prps = makePropertiesObject("AdminURL=http://listen_address:listen_port;Username=username;Password=password")
nmStart("AdminServer",props=prps)

注意:

ユーザーが以前にノード・マネージャに接続したことがある場合にはboot.propertiesファイルが存在するので、ユーザーはユーザー名とパスワードを指定する必要はありません。

nmStartコマンドは、起動するドメインおよびサーバー・インスタンスを識別します。

ノード・マネージャがnodemanager.domainsでドメイン・ディレクトリをルックアップし、暗号化されたユーザー名とパスワードを格納するローカル・ファイルを使用してユーザーの資格証明を認証します。
ノード・マネージャは、管理サーバーの起動プロパティを取得します。
ノード・マネージャが管理サーバーのプロセスを作成します。
管理サーバーが、そのconfigディレクトリからドメイン構成を取得します。

注意:

管理サーバーの実行後、WLSTオンライン・コマンド(nmGenBootStartupProps)を使用して、ユーザー資格証明と起動プロパティを更新できます。

あるいは、管理サーバーとノード・マネージャの実行時に、AdminServer > 「構成」 > 「サーバーの起動」ページで、管理コンソールにユーザー資格証明と起動プロパティを更新できます。管理サーバーは、実行中のノード・マネージャに更新内容をプッシュし、ノード・マネージャは情報をディスクに書き込みます。

ノード・マネージャが管理対象サーバーを起動する仕組み

図2-3は、ノード・マネージャによる管理対象サーバー起動プロセスを示します。

ノード・マネージャは、管理対象サーバー1をホストするマシンBで実行されています。ドメインの管理サーバーはマシンAで実行されています。

図2-3 管理対象サーバーの起動

「図2-3 管理対象サーバーの起動」の説明

ユーザーが、管理コンソールから管理対象サーバー1の起動コマンドを発行します。

注意:

スタンドアロン・クライアントは、管理対象サーバーの起動コマンドを発行することもできます。
管理サーバーが、管理対象サーバー1用に構成されたリモート起動プロパティを指定して、マシンB上のノード・マネージャに管理対象サーバー1の起動コマンドを発行します。引数とその指定方法の詳細は、「ステップ5: リモート起動引数の構成」を参照してください。
ノード・マネージャが管理対象サーバー1を起動します。

ノード・マネージャは、ノード・マネージャ・プロセスが実行されているものと同じルート・ディレクトリを使用してその管理対象サーバーを起動します。別のディレクトリで管理対象サーバーを実行するには、管理コンソール・ページで「サーバー」>「構成」>「サーバーの起動」の「ルート・ディレクトリ」の属性を設定します。
管理対象サーバー1が管理サーバーにアクセスし、構成情報の更新をチェックします。
ドメイン構成に未処理の変更がある場合、管理対象サーバー1は構成データのローカル・キャッシュを更新します。

ノード・マネージャが管理サーバーを再起動する仕組み

図2-4は、ノード・マネージャによる管理サーバー再起動プロセスを示します。

ノード・マネージャは、管理サーバーをホストするマシンで実行されています。ノード・マネージャを使用して最初に起動された管理サーバーはすでに終了しています。管理サーバーのAutoRestart属性はtrueに設定されています。

注意:

サーバー・インスタンスのAutoRestart属性がfalseに設定されている場合、ノード・マネージャはそのインスタンスを再起動しません。ただし、クラッシュ・リカバリのシナリオにおいて、CrashRecoveryEnabledプロパティは、AutoRestartプロパティよりも優先されます。たとえば、サーバー・インスタンスにAutoRestart=falseとCrashRecoveryEnabled=trueが設定されている場合、ノード・マネージャは再起動後にサーバー・インスタンスのリカバリを試みます(ノード・マネージャが実行されていないときにサーバーに障害が発生した場合)。

図2-4 管理サーバーの再起動

「図2-4 管理サーバーの再起動」の説明

ノード・マネージャが管理サーバー・プロセスの終了コードから再起動が必要であると判断します。
ノード・マネージャがboot.propertiesファイルから管理サーバーの起動に使用するユーザー名とパスワードを取得し、server_name/data/nodemanager/startup.propertiesファイルからサーバーの起動プロパティを取得します。
ノード・マネージャが管理サーバーを起動します。
管理サーバーがその構成データを読み込み、起動します。

ノード・マネージャが管理対象サーバーを再起動する仕組み

図2-5は、ノード・マネージャによる管理対象サーバー再起動プロセスを示します。

ノード・マネージャは、管理対象サーバー1をホストするマシンBで実行されています。ノード・マネージャを使用して最初に起動された管理対象サーバー1はすでに終了しています。管理対象サーバー1のAutoRestart属性はtrueに設定されています。

注意:

図2-5 管理対象サーバーの再起動

「図2-5 管理対象サーバーの再起動」の説明

ノード・マネージャが管理対象サーバー1の最新の既知の状態から再起動が必要であると判断します。
ノード・マネージャがboot.propertiesファイルから管理対象サーバー1の起動に使用するユーザー名とパスワードを取得し、startup.propertiesファイルからサーバーの起動プロパティを取得します。これらのサーバー固有のファイルは、管理対象サーバー1のserver_name/data/nodemanager/ディレクトリにあります。

ノード・マネージャが管理対象サーバー1を起動します。

注意:

ノード・マネージャは、サーバー・インスタンスに障害が発生した後からRestartDelaySecondsで指定された秒数待機してから再起動を行います。

管理対象サーバー1が管理サーバーにアクセスし、構成データの更新をチェックします。管理サーバーにアクセスし、構成データの更新を取得すると、管理対象サーバー1はconfigディレクトリのローカル・キャッシュを更新します。
管理対象サーバー1が管理サーバーにアクセスできなかった場合に管理対象サーバー独立(MSI)モードが有効になっていると、管理対象サーバー1はローカルにキャッシュされた構成データを使用します。

注意:

デフォルトでは、管理対象サーバー独立モードは有効になっています。

ノード・マネージャがサーバー・インスタンスを停止する仕組み

図2-6は、ノード・マネージャの制御下にある管理対象サーバーの停止に伴う通信について説明しています。管理対象サーバーの状態と可用性によっては、ノード・マネージャは別の方法で停止を始める必要があります。

ノード・マネージャは、管理対象サーバー1をホストするマシンBで実行されています。

図2-6 ノード・マネージャの制御下にあるサーバー・インスタンスの停止

「図2-6 ノード・マネージャの制御下にあるサーバー・インスタンスの停止」の説明

認可されたユーザーが、管理コンソールを使用して管理対象サーバー1の停止コマンドを発行します。
管理サーバーは管理対象サーバー1に直接シャットダウン・コマンドを発行します。管理対象サーバー1へのアクセスが成功すると、管理対象サーバー1は、『Oracle WebLogic Serverサーバーの起動と停止の管理』の正常な停止に関する項で説明されている停止シーケンスを実行します。
前の手順で管理対象サーバー1へのアクセスが失敗した場合、管理サーバーはマシンB上のノード・マネージャに管理対象サーバー1の停止コマンドを発行します。
ノード・マネージャが、オペレーティング・システムに管理対象サーバー1を強制停止するようにリクエストを発行します。
オペレーティング・システムが管理対象サーバー1のプロセスを終了させます。

ノード・マネージャとシステム・クラッシュのリカバリ

システム・クラッシュの後に、ノード・マネージャによってサーバーが確実に再起動されるようにするには、以下を実行する必要があります。

Javaベースのノード・マネージャの場合、CrashRecoveryEnabledがtrueに設定されていることを確認します。

CrashRecoveryEnabled構成プロパティを使用すると、ノード・マネージャがシステム・クラッシュの後にサーバーを再起動できます。このプロパティは、デフォルトでは有効になっていません。

注意:

クラッシュ・リカバリのシナリオにおいて、CrashRecoveryEnabled構成プロパティは、AutoRestartサーバー起動プロパティよりも優先されます。たとえば、サーバー・インスタンスにAutoRestart=falseとCrashRecoveryEnabled=trueが設定されている場合、ノード・マネージャは再起動後にサーバー・インスタンスのリカバリを試みます(ノード・マネージャが実行されていないときにサーバーに障害が発生した場合)。

スクリプト・ベースのノード・マネージャの場合、この行をマシン起動スクリプトに配置するか、必要に応じて指定スケジュールで定期的に実行します。
```
wlscontrol.sh -d domain_name CRASHRECOVERY
```
管理サーバーをノード・マネージャを使用して起動します。
すべての管理対象サーバーを管理サーバーを使用して起動します。この操作は、WLSTまたは管理コンソールで実行できます。

システムの再起動後、ノード・マネージャはnodemanager.domainsファイルで指定された各管理対象ドメインをチェックして、停止に問題のあったサーバー・インスタンスがあるかどうかを判断します。これは、WebLogic Serverプロセスの作成時にノード・マネージャによって作成されたロック・ファイルが存在するかどうかによって決まります。このロック・ファイルには、WebLogic Server起動スクリプトのプロセス識別子が含まれています。ロック・ファイルが存在するが、プロセスIDが実行されていない場合、ノード・マネージャは自動的にサーバーを再起動しようとします。

プロセスが実行中であれば、ノード・マネージャはさらにチェックを行ってプロセス内で実行されている管理サーブレットにアクセスし、プロセスIDに対応するプロセスが、WebLogic Serverインスタンスであることを確認します。

注意:

ノード・マネージャがチェックを実行して管理サーブレットにアクセスする際、不適切な資格証明に関し、サーバー・ログ内にアラートが示されることがあります。

ノード・マネージャの構成ファイルとログ・ファイル

複数のサーバーを管理する場合、ノード・マネージャは、図2-7に示すように複数の構成ファイルを使用し、複数のディレクトリにログ・ファイルを出力します。

図2-7 ノード・マネージャの構成とロギングの環境

「図2-7 ノード・マネージャの構成とロギングの環境」の説明

以下の項では、ノード・マネージャの構成ファイルとログ・ファイルについて説明します。

構成ファイル
ログ・ファイル

構成ファイル

言及されていない限り、構成ファイルはJavaベースのノード・マネージャとスクリプト・ベースのノード・マネージャの両方に適用されます。

nodemanager.properties

Javaベースのノード・マネージャによって使用される構成ファイルです。「nodemanager.propertiesのレビュー」を参照してください。

デフォルトでは、このファイルはNodeManagerHome(通常ORACLE_HOME\user_projects\domains\domain_name\nodemanager)にあります。ここでORACLE_HOMEは、WebLogic Serverのインストール時にOracleホームとして指定した場所です。

nodemanager.domains

このファイルには、ノード・マネージャによって管理されるドメインの名前と、それに対応するディレクトリのマッピングが格納されます。「ステップ4: nodemanager.domainsファイルの構成」を参照してください。

Javaベースのノード・マネージャの場合、このファイルはNodeManagerHome(通常ORACLE_HOME\user_projects\domains\domain_name\nodemanager)にあります。

スクリプトベースのノード・マネージャの場合、このファイルのデフォルトのNodeManagerHomeの場所はWL_HOME/common/nodemanagerです。ここでWL_HOMEは、WebLogic Serverをインストールした場所(ORACLE_HOME/wlserverなど)です。

nm_password.properties

このファイルは、ノード・マネージャのユーザー名とパスワードを保存します。「ステップ2: ノード・マネージャのユーザー名およびパスワードの指定」を参照してください。

このファイルは、DOMAIN_HOME/config/nodemanagerにあります。ここでDOMAIN_HOMEは、WebLogicドメインの場所(通常ORACLE_HOME\user_projects\domains\domain_name)です。