ヘッダーをスキップ
Oracle® Fusion Middleware Oracle WebLogic Serverノード・マネージャの管理
12c (12.1.2)
E48063-02
  目次へ移動
目次
前
前 		 次
次		  

3 ノード・マネージャの一般的な構成

この章では、ノード・マネージャ構成プロセスと、Javaバージョンおよびスクリプトベース・バージョンのノード・マネージャに適用される一般的な手順について説明します。

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

ノード・マネージャの構成の概要

この項では、ノード・マネージャの一般的な構成手順について説明します。この項の内容は、Javaバージョンおよびスクリプト・バージョンのノード・マネージャに適用されます。ノード・マネージャの一般的な構成を実施した後は、使用するノード・マネージャのバージョンに応じて、第4章「Javaノード・マネージャの構成」または第5章「スクリプト・ノード・マネージャの構成」の構成手順を実施する必要があります。

このリリースでは、Javaベース・バージョンのノード・マネージャには、簡素化され、すぐに使用できる構成があります。詳細は、「ノード・マネージャのデフォルト構成」を参照してください。

WLSTを使用したノード・マネージャの制御および構成

WebLogic Scripting Tool (WLST)は、システム管理者やオペレータが、WebLogic Serverインスタンスおよびドメインの監視と管理に使用する、コマンド・ライン・スクリプト・インタフェースです。WLSTをノード・マネージャ・クライアントとして使用することで、サーバー・インスタンスをリモートまたはローカルで起動、停止、および再起動できます。加えて、WLSTではサーバーのステータスを取得し、サーバー出力のログとノード・マネージャのログの内容を取得できます。WLSTノード・マネージャ・コマンドの詳細は、『WebLogic Server WLSTコマンド・リファレンス』のWLSTコマンドおよび変数リファレンスに関する項を参照してください。

ステップ1: ノード・マネージャを実行するためのコンピュータの構成

ノード・マネージャは、ノード・マネージャを使用して制御するWebLogic Serverインスタンスをホストする各コンピュータ上で実行する必要があります。理想としては、システム障害の発生時や再起動時にノード・マネージャが自動的に再起動されるように、ノード・マネージャはオペレーティング・システムのサービスまたはデーモンとして実行する必要があります。

デフォルトでオペレーティング・システム・サービスは、ノード・マネージャを起動しlocalhost:5556でリスニングします。ノード・マネージャでリモート・システムからのコマンドを受け付けるようにする場合は、localhost以外のリスニング・アドレスでリスニングするようにスクリプトを編集します。詳細は、「起動サービスとしてのノード・マネージャの実行」を参照してください。


注意:

UNIXプラットフォームでは、ノード・マネージャのrootユーザーとしての実行はお薦めしません。ただし、バインド後のグループIDを取得するには、ノード・マネージャをrootユーザーとして実行する必要があります。バインド後のグループIDを使用すると、ご使用のマシンで稼働するサーバーが、すべての権限のある起動アクションの実行後に、UNIXグループID (GID)にバインドできるようになります。

ステップ2: ノード・マネージャのユーザー名およびパスワードの指定

nm_password.propertiesファイルには、ノード・マネージャのユーザー名とパスワードが含まれます。ユーザー名とパスワードは、クライアント(たとえば管理サーバー)とノード・マネージャの間の接続を認証するために使用します。


注意:

このユーザー名とパスワードは、ノード・マネージャとクライアントの間の接続の認証にのみ使用されます。サーバー管理IDとパスワードとは別のものです。

このファイルは、ドメインの作成時または構成ウィザードの使用時に、nmEnrollを使用して必要な構成ファイルをあるマシンから別のマシンにコピーするときに作成されます。ファイルは、DOMAIN_HOME/config/nodemanagerにあります。ここでDOMAIN_HOMEは、WebLogicドメインの場所(通常ORACLE_HOME\user_projects\domains\domain_name)です。

構成ウィザードから、初期構成用のノード・マネージャのユーザー名とパスワードを求められます。この値は、必要なファイルにローカルに移入されますが、リモートに配布するためにはnmEnrollコマンドを使用する必要があります。

nm_password.propertiesが作成されたら、管理コンソールを使用してノード・マネージャのパスワードやプロパティの値を変更できます。変更は、nm_password.propertiesファイルに伝播され、ノード・マネージャによって使用されます。

次の手順を使用して、ノード・マネージャの資格証明を変更できます。

  1. 管理サーバーを起動します。

  2. 管理コンソールを使用し、「domain_name」→「セキュリティ」→「全般」の「詳細」オプションを使用してノード・マネージャの資格証明を更新します。

  3. WLSTを呼び出し、connectコマンド使用して管理サーバーに接続します。詳細は、『WebLogic Scripting Toolの理解』のWebLogic Scripting Toolの使用に関する項を参照してください。

  4. 以下の構文を使用してnmEnrollを実行します。

    nmEnroll([domainDir], [nmHome])

    次に例を示します。

    nmEnroll('C:/oracle/user_projects/domains/prod_domain',
'C:/oracle/user_projects/domains/prod_domain/nodemanager')

    nmEnroll()を実行すると、各管理対象サーバーへ、確実に正しいノード・マネージャのユーザーおよびパスワード・トークンが提供されます。


    注意:

    管理対象サーバーを実行している各マシン上でnmEnrollを実行する必要があります。加えて、各マシン上の各ドメイン・ディレクトリについて、nmEnrollを実行することが必要です。


注意:

nm_password.propertiesを手動で編集した場合(非推奨)、変更が反映されるようにノード・マネージャを再起動する必要があります。ノード・マネージャを実行している状態で管理コンソールを使用して値を変更した場合は、再起動は必要ありません。

nm_password.propertiesファイルは、ノード・マネージャを実行する各物理マシンのドメイン・ディレクトリに存在している必要があります。ドメインのノード・マネージャのユーザー名とパスワードを変更した場合、nm_password.propertiesファイルを同期させるために各マシンでnmEnrollを実行する必要があります。マシンに複数のドメインを構成した場合、各ドメインで異なるノード・マネージャのユーザー名とパスワードを使用できます。

ステップ3: ノード・マネージャを使用するためのマシンの構成

WebLogic Serverマシン・リソースでは、特定のマシンとそれがホストするサーバー・インスタンスを関連付け、そのシステム上のノード・マネージャ・プロセスの接続属性を指定します。

管理コンソールの「環境」>「マシン」>machine_name>ノード・マネージャページを使用して、ノード・マネージャ・プロセスを実行するマシンごとにマシン定義を構成します。「リスニング・アドレス」フィールドに、ノード・マネージャがリスニングするDNS名またはIPアドレスを入力します。


注意:

指定するリスニング・アドレスは、ノード・マネージャSSLサーバーのデジタル証明書のサブジェクトDNのCNコンポーネントに表示されるホスト名と正確に一致する必要があります。

各コンピュータを1つのマシン・リソースとして構成した後、ノード・マネージャを使用して制御する各サーバー・インスタンスを、ノード・マネージャが実行されるマシンに割り当てる必要があります。

  1. 管理コンソールの「環境」→「サーバー」→「server_name」→「構成」→「全般」を選択します。

  2. 「マシン」フィールドで、サーバーを割り当てるマシンを選択します。


注意:

管理サーバーのマシンは、管理コンソールを使用して変更できません。実行中のサーバーのクラスタおよびマシンは変更できません。

ステップ4: nodemanager.domainsファイルの構成

nodemanager.domainsファイルには、ノード・マネージャ・インスタンスが制御するドメインを指定します。このため、スタンドアロンのクライアントではドメイン・ディレクトリを明示的に指定する必要はありません。

このファイルには、ノード・マネージャ・インスタンスが制御する各ドメインのドメイン・ディレクトリを次の形式で指定するエントリが含まれている必要があります。

domain-name=domain-directory

ユーザーがドメインに対してコマンドを発行すると、ノード・マネージャはnodemanager.domainsからドメイン・ディレクトリをルックアップします。

このファイルではノード・マネージャ・クライアントのアクセスがファイル内に表示されたドメインに制限されるので、セキュリティがさらに強化されます。クライアントは、nodemanager.domainsに表示されたドメインに対してのみコマンドを実行できます。

Javaベースのノード・マネージャの場合、このファイルは通常、ORACLE_HOME\user_projects\domains\domain_name\nodemanagerにあります。スクリプトベースのノード・マネージャの場合、このファイルのデフォルトの場所はWL_HOME/common/nodemanagerです。ここでWL_HOMEは、WebLogic Serverをインストールした場所(ORACLE_HOME/wlserverなど)です。

構成ウィザードを使用してドメインを作成した場合は、nodemanager.domainsファイルは自動的に作成されています。ただし、WebLogic Serverのこのリリースでは、スクリプト・バージョンのノード・マネージャを使用している場合、ノード・マネージャ・インスタンスで制御するドメインを指定するnodemanager.domainsファイルを、NodeManagerHomeに作成またはコピーする必要があります。あるいは、WLSTコマンドnmEnrollを使用して、WebLogicドメインをスクリプトベースのノード・マネージャに登録することも可能です。

ドメインごとのノード・マネージャではなく、ホストごとのノード・マネージャを構成する場合は、nodemanager.domainsファイルを、ORACLE_HOME\oracle_common\common\nodemanagerの下のホストごとのNodeManagerHomeの場所に手動で作成またはコピーする必要があります。詳細は、「ノード・マネージャのデフォルト構成」を参照してください。

必要に応じて、nodemanager.domainsを手動で編集し、ドメインを追加できます。


注意:

nodemanager.domainsでバックスラッシュ文字(\)を使用している場合は、(\\)としてエスケープする必要があります。

例3-1 nodemanager.domainsファイル

#Domains and directories created by Configuration Wizard
#Mon Jan 07 10:57:18 EST 2013
base_domain=C\:\\Oracle\\Middleware\\Oracle_Home\\user_projects\\domains\\base_domain
prod_domain=C\:\\Oracle\\Middleware\\Oracle_Home\\user_projects\\domains\\prod_domain

ステップ5: リモート起動引数の構成

管理コンソールで、管理対象サーバーの「サーバー」>「構成」>サーバーの起動のページで、ノード・マネージャが管理対象サーバーの起動に使用する起動引数を指定します。管理対象サーバーの起動引数を指定しない場合、ノード・マネージャは独自のプロパティをデフォルトとして使用して管理対象サーバーを起動します。詳細は、「nodemanager.propertiesのレビュー」を参照してください。管理対象サーバーを起動するにはこれらのデフォルトで十分ですが、起動プロセスの一貫性と信頼性を確保するには、管理対象サーバーのインスタンスごとに起動引数を構成してください。指定された起動引数は管理対象サーバーの起動にのみ使用されます。ノード・マネージャによって起動される管理サーバー・インスタンスで使用されることはありません。

「起動サービスとしてのノード・マネージャの実行」に説明されているように、ノード・マネージャをWindowsサービスとして実行する場合は、ノード・マネージャの制御下に置かれる管理対象サーバーごとに-Xrs JVMプロパティを構成する必要があります。

このオプションを設定しない場合、ノード・マネージャはシステムの再起動後に管理対象サーバーを再起動できません。それは、次のような一連のイベントが発生するためです。

  1. 再起動が行われると、ノード・マネージャ・サービスと管理サーバーのオペレーティング・システム・サービスが停止される前に、実行中の管理対象サーバーが強制終了されます。

  2. 管理対象サーバーの強制終了と、ノード・マネージャ・サービスの停止の間の間隔に、ノード・マネージャは継続して管理対象サーバーをモニターし、それが強制終了されたことを検出し、再起動を行おうとします。

  3. マシンが停止しようとしているので、オペレーティング・システムは管理対象サーバーの再起動を許可しません。

  4. ノード・マネージャは障害が発生したものとして管理対象サーバーにマークを付け、マシンが再起動したときにそのサーバーを起動しません。

-Xrsオプションまたは-Xnohup オプションを使用して管理対象サーバーを起動すると、マシンの停止時に管理対象サーバーを即座に停止しないようになり、このような一連のイベントが回避されます。

ステップ6: サーバーの起動プロパティの設定

ノード・マネージャを使用して、サーバーの起動プロパティを設定できます。これらのプロパティは、startup.propertiesで定義することも、WLSTなどの管理ユーティリティを使用してオブジェクトとして渡すこともできます。起動プロパティと、その有効な値を設定する方法を、次の項で概説します。

startup.properties

ノード・マネージャは、startup.propertiesファイルを使用して、サーバー起時の起動構成を決定します。このファイルは、サーバー・インスタンスごとに定義されており、下記の場所に置かれています。DOMAIN_HOME/servers/server_name/data/nodemanager/startup.properties

startup.propertiesの内容はサーバーMBeanから派生するか、サーバーがクラスタの一部である場合は、クラスタMBeanから派生します。詳細は、Oracle WebLogic Server MBeanリファレンスを参照してください。

WLSTを使用して起動プロパティを設定する

WLSTのnmStartコマンドを使用する場合、サーバーの構成は、直接決定できません。したがって、サーバーの起動プロパティをWLSTプロパティ・オブジェクトとしてnmStartコマンドに渡す必要があります。

サーバーの起動プロパティ

以下のサーバーの起動プロパティを、ノード・マネージャを使用して起動する際にサーバーに渡すことができます。

表3-1 サーバーの起動プロパティ

プロパティ 説明

JavaHome

サーバーを起動する際に使用されるJavaホーム・ディレクトリを定義します。

Arguments

サーバーを起動する際に使用される引数。

SSLArguments

これらの引数は、ドメイン全体の管理ポートを有効化した場合に使用されます。

RestartInterval

ノード・マネージャが、障害の発生したサーバーの再起動を試行し続ける期間。この期間中、ノード・マネージャはRestartMaxで定義された回数まで、障害の発生したサーバーを再起動しようとします。デフォルトでは、ノード・マネージャはFAILED_NOT_RESTARTABLE状態に到達するまで、無期限にサーバーの再起動を試行します。

RestartMax

ノード・マネージャが、RestartIntervalで定義した間隔内で障害の発生したサーバーの再起動を試行する回数。RestarMaxは、RestartIntervalが定義されている場合のみ認識されます。

RestartDelaySeconds

ノード・マネージャがサーバーの再起動を試行するまでに待機する秒数。

ClassPath

サーバーを起動する際に使用されるクラスパス。

OracleHome

サーバーを起動する際に使用されるOracleホーム・ディレクトリ。

AdminURL

管理サーバーのURL。

注意:この値は、管理対象サーバーのstartup.propertiesファイルにおいてのみ指定します。

AutoRestart

このサーバーで障害が発生した場合に、ノード・マネージャが自動的にそれを再起動できるかどうかを指定します。

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

AutoKillIfFailed

サーバーのステータスがfailedになった場合に、ノード・マネージャで自動的にサーバーを強制終了するかどうかを指定します。

SecurityPolicyFile

このサーバーを起動する際に使用するセキュリティ・ポリシー・ファイルを指定します。

ServerIP

サーバーのIPアドレス。

ステップ7: 管理サーバー・アドレスの定義

ノード・マネージャ・プロセスに接続する各管理サーバーのリスニング・アドレスを確実に定義する必要があります。管理サーバーのリスニング・アドレスが定義されていない場合、ノード・マネージャは、管理対象サーバーの起動時に、その管理対象サーバーに対してlocalhostにアクセスして構成情報を取得するように指示します。

リスニング・アドレスは、管理コンソールの「サーバー」>「構成」>「一般」ページで設定します。

ステップ8(オプション): ノード・マネージャ環境変数の設定

デフォルトでは、ノード・マネージャを起動する前に追加の環境変数を設定する必要はありません。WebLogic Serverとともに提供されるノード・マネージャのサンプル起動スクリプトおよびインストール・サービス・スクリプトでは、必須の変数が設定され、ノード・マネージャのデフォルト・アドレスlocalhostへのリスニングを開始します。

デフォルト以外のアドレスでノード・マネージャのリスニングを開始するには、次のいずれかの方法を使用します。

本番環境では、ノード・マネージャに対してデフォルト以外のリスニング・アドレスを構成すると、他のマシンからのトラフィックがノード・マネージャまで到達しやすくなります。また、マルチホーム・マシンや複数のネットワーク・インタフェース・カードがあるマシンでは、ノード・マネージャはマシン上のいずれかのアドレスをリスニングできます。

表3-2 ノード・マネージャの環境変数

環境変数 説明 
JAVA_HOME

ノード・マネージャで使用されるJDKルート・ディレクトリ。例:

set JAVA_HOME=c:\jdk1.7.0_06

ノード・マネージャには、WebLogic Serverと同じJDKのバージョンに関する必要条件があります。

 
WL_HOME

WebLogic Serverのインストール・ディレクトリ。例:

set WL_HOME=c:\Oracle\Middleware\Oracle_Home\wlserver

PATH

WebLogic ServerのbinディレクトリとJava実行ファイルのパスを指定する必要があります。例:

set PATH=%WL_HOME%\server\bin;%JAVA_HOME%\bin;%PATH%

LD_LIBRARY_PATH

(UNIXおよびLinux)

Solarisシステムの場合、ネイティブ・ノード・マネージャ・ライブラリのパスを指定する必要があります。

Solarisの例:

LD_LIBRARY_PATH:$WL_HOME/server/lib/solaris:$WL_HOME/server/lib/solaris/oci816_8

Linuxの例:

LD_LIBRARY_PATH:$WL_HOME/server/native/linux:$WL_HOME/server/native/linux/i686

注意: Linuxはi686、ia64、またはx86_64アーキテクチャが可能です。該当するアーキテクチャに応じてパスは変わる可能性があります。

 
CLASSPATH

ノード・マネージャCLASSPATHは、ノード・マネージャを起動するためのjavaコマンド・ラインのオプション、または環境変数として設定できます。

Windows NTの例:

set CLASSPATH=.;%WL_HOME%\server\lib\weblogic_sp.jar;%WL_HOME%\server\lib\
weblogic.jar

  前
前 		 次
次
  目次へ移動
目次