サーバの起動と停止の管理

Windows サービスとしての WebLogic Server インスタンスの設定

Windows ホスト コンピュータの起動時に WebLogic Server インスタンスを自動的に起動したい場合は、そのサーバを Windows サービスとして設定できます。

WebLogic Server では、Windows サービスとして設定したサーバ インスタンスごとに、Windows レジストリ内 (HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services) にキーが作成されます。このレジストリ エントリには、サーバ名をはじめとする起動引数の情報が含まれています。

Windows ホストを起動すると、Windows オペレーティング システムの一部である Windows サービス コントロール マネージャ (SCM) が、Windows レジストリ キー内の情報を使用して weblogic.Server メイン クラスを呼び出します。Windows SCM は、ノード マネージャを使用して管理対象サーバを起動するようにコンフィグレーションすることはできません。したがって、Windows サービスとして実行しているサーバでは、ノード マネージャのモニタ機能と自動再起動機能は使用できません。

ここでは、Windows サービスとして実行する WebLogic Server インスタンスを設定および管理する手順について説明します。

Windows サービスの設定 : 主な手順

Windows サービスを設定するには、次の手順に従います。

サーバ固有のスクリプトの作成

ここで作成するスクリプトでは、サーバ固有の情報 (サーバ インスタンス名など) を特定するための変数に値を設定する必要があります。また、このスクリプトからマスタ スクリプト WL_HOME\server\bin\installSvc.cmd (WL_HOME は WebLogic Server のインストール ディレクトリ) を呼び出す必要もあります。マスタ スクリプトからは、Windows レジストリにキーを追加する beasvc ユーティリティが呼び出されます。

サーバ固有のスクリプトのサンプルについては、コード リスト 3-1 を参照してください。

サーバ固有のスクリプトを作成するには、次の手順に従います。

管理サーバへの接続のコンフィグレーション

管理対象サーバを Windows サービスとしてインストールする場合は、ドメインの管理サーバの場所を示す変数を含める必要があります。管理対象サーバのコンフィグレーション データは、管理対象サーバから管理サーバにアクセスして取得しなければなりません。

また、先に管理サーバ (サービスではなく実際のサーバ) を起動し、その後で管理対象サーバを Windows サービスとして開始する必要があります。

管理サーバへの接続をコンフィグレーションするには、次の手順に従います。

管理サーバと管理対象サーバの起動順序の強制

同じコンピュータで Windows サービスとして実行する管理サーバと管理対象サーバの両方を設定したら、管理サーバの後にのみ起動する管理対象サーバを指定できます。

管理対象サーバが、必ず管理サーバ Windows サービスの後に起動されるようにするには、次の手順に従います。

Windows コントロール パネルからの正常停止の有効化

デフォルトでは、Windows コントロール パネルを使用してサーバ インスタンスを停止すると、Windows サービス コントロール マネージャ (SCM) がそのサーバの Java 仮想マシン (JVM) を強制停止します。JVM を強制停止すると、サーバは直ちにすべての処理を終了します。セッション データはすべて失われます。サーバが config.xml ファイルへの書き込みを行っている間に管理サーバの JVM を強制停止すると、config.xml ファイルが破損するおそれがあります。

Windows コントロール パネルからの正常停止を有効にするには、次の手順に従います。

サーバ インスタンスを停止する Java クラス

以下の Java クラスでは、JMX (Java Management Extensions) を使用してサーバ インスタンスを停止します。各サーバの管理属性とオペレーションは、JMX 管理対象 Bean (MBean) を使用して公開されます。このような MBean の 1 つである ServerRuntime は、サーバを正常に停止するための shutdown() メソッドを公開します。

コード リスト 3-2 に示すクラスでは、管理 MBeanHome インタフェースを使用しています。このインタフェースを使用すると、ドメイン内のすべてのサーバ インスタンスの ServerRuntime MBean オペレーションを取得したり呼び出したりできます。

JMX プログラミングの詳細については、『JMX によるカスタム管理ユーティリティの開発』を参照してください。ServerRuntime MBean の詳細については、WebLogic Server Javadoc を参照してください。

import java.util.Set;
import java.util.Iterator;
import java.rmi.RemoteException;
import javax.naming.Context;
import javax.management.ObjectName;

import weblogic.jndi.Environment;
import weblogic.management.MBeanHome;
import weblogic.management.WebLogicMBean;
import weblogic.management.configuration.ServerMBean;
import weblogic.management.runtime.ServerRuntimeMBean;
import weblogic.management.runtime.ServerStates;
import weblogic.management.WebLogicObjectName;

public class ServerStopper {
  public static void stop() throws Exception {
    MBeanHome home = null;

    // 管理サーバの URL
    String url = "t3://qa113:7001";
    String username = "system";
    String password = "gumby1234";
    ServerRuntimeMBean serverRuntime = null;
    Set mbeanSet = null;
    Iterator mbeanIterator = null;

    try {
      // ContextClassloader を設定してアサーションを回避
      URL[] urls = { new File("/").toURL() };
      Thread.currentThread().setContextClassLoader(new
         URLClassLoader(urls));

      Environment env = new Environment();
      env.setProviderUrl(url);
      env.setSecurityPrincipal(username);
      env.setSecurityCredentials(password);
      Context ctx = env.getInitialContext();
      home = (MBeanHome)
           ctx.lookup("weblogic.management.adminhome");
      mbeanSet = home.getMBeansByType("ServerRuntime");
      mbeanIterator = mbeanSet.iterator();

      while(mbeanIterator.hasNext()) {
        serverRuntime = (ServerRuntimeMBean)mbeanIterator.next();
        if(serverRuntime.getState().equals(ServerStates.RUNNING)){
            serverRuntime.shutdown();
        }
      }

    } catch (Exception e) {
      e.printStackTrace();
    }
  }
}

標準出力および標準エラーのファイルへのリダイレクト

WebLogic Server インスタンスを Windows サービスとしてインストールする場合のデフォルトでは、サーバやその JVM から標準出力と標準エラーに出力されたメッセージは表示されません。

これらのメッセージを表示するには、標準出力および標準エラーからファイルにリダイレクトする必要があります。

サービスをインストールして Windows ホストを再起動したら、以下のいずれかの方法で、標準出力または標準エラーに書き込まれたメッセージを表示できます。

デフォルトのローテーション条件の変更

デフォルトでは、Windows サービスが 24 時間間隔で pathname-yyyy_mm_dd-hh_mm_ss という名前のファイルにメッセージをアーカイブします。新しいメッセージは、サービスの設定時に指定したファイルに収集されます。

このアーカイブの時間間隔を変更したり、ローテーションの発生を時間間隔ではなくメッセージ ファイルのサイズに基づいて設定したりできます。

Windows サービスがメッセージ ファイルをローテーションする際のデフォルト条件を変更するには、次の手順に従います。

WebLogic Server インスタンスからのスレッド ダンプは、以下のいずれかの方法で標準出力に出力できます。

次に例を示します。
D:\bea\weblogic81\server\bin\beasvc -dump -svcname:mydomain_myserver

クラスパスへのクラスの追加

クラスパスとは、JVM から呼び出すことのできる Java クラスの場所を宣言するものです。WebLogic Server マスタ スクリプトを使用してサーバ インスタンスを Windows サービスとしてインストールする場合、マスタ スクリプトにはサーバ インスタンスを実行するのに必要なすべてのクラスを指定します。独自の Java クラスを追加して WebLogic Server を拡張したい場合は、それらをクラスパスに追加する必要があります。

クラスをクラスパスに追加するには、次の手順に従います。

サーバ固有のスクリプトの実行

プロダクション環境に Windows サービスをインストールする場合は、管理者レベルの権限を持つオペレーティング システム ユーザ アカウントでサービスを実行するのは避けるようにしてください。詳細については、「サービスの実行に使用するユーザ アカウントの検証」を参照してください。

サーバ固有のスクリプトを実行するには、次の手順に従います。

設定の検証

WebLogic Server を Windows サービスとして正常に設定できたかどうかを検証するには、次の手順に従います。

設定が正常に完了している場合は、beasvc -debug コマンドを実行するとサーバが起動します。スクリプトから次のようなエラーが返された場合は、指定したサービス名が正しいかどうかを確認してください。
Unable to open Registry Key ....... System\CurrentControlSet\Services\beasvc example_examplesServer\Parameters

サービスの実行に使用するユーザ アカウントの検証

プロダクション環境で WebLogic Server Windows サービスを実行する場合は、アクセス権限が制限された特別なオペレーティング システム ユーザ アカウントで実行する必要があります。たとえば、その OS ユーザのアクセス権を、Oracle ファイルおよびドメイン ファイルに限定する必要があります。また、それらのファイルにアクセスできるアカウントを、上記の OS ユーザに限定する必要もあります。

WebLogic Server インスタンスが特別な OS ユーザ アカウントで実行されていることを確認するには、次の手順に従います。

コントロール パネルを使用したサーバ インスタンスの停止と再起動

Windows サービスとして実行するサーバ インスタンスの設定が完了したら、[サービス] コントロール パネルを使用してサーバを停止したり再起動したりできます。

デフォルトでは、Windows コントロール パネルを使用してサーバ インスタンスを停止すると、Windows サービス コントロール マネージャ (SCM) がそのサーバの Java 仮想マシン (JVM) を強制停止します。JVM を強制停止すると、サーバは直ちにすべての処理を終了します。セッション データはすべて失われます。サーバが config.xml ファイルへの書き込みを行っている間に管理サーバの JVM を強制停止すると、config.xml ファイルが破損するおそれがあります。Windows コントロール パネルから正常停止を有効にする方法については、「Windows コントロール パネルからの正常停止の有効化」を参照してください。

Windows サービスとしてインストールされている WebLogic Server インスタンスを停止または再起動するには、次の手順に従います。

Windows サービスとして設定されているサーバの削除

WebLogic Server インスタンスを実行する Windows サービスを削除する場合は、beasvc ユーティリティを使用して Windows レジストリから関連キーを削除するためのスクリプトを使用できます。Windows サービスを削除しても、ドメインのコンフィグレーション ファイルに保存されているサーバ インスタンスのコンフィグレーションには影響しません。Windows サービスを削除しても、起動スクリプトを使用して WebLogic Server インスタンスを起動できます。管理対象サーバの場合はノード マネージャも使用して起動することもできます。

スクリプトではまず、サーバ固有の情報 (サーバ インスタンスの名前など) を特定する変数の値を設定します。次に、マスタ アンインストール スクリプト WL_HOME\server\bin\uninstallSvc.cmd を呼び出します (WL_HOME は WebLogic Server のインストール ディレクトリ)。このマスタ スクリプトからは、Windows レジストリからキーを削除する beasvc ユーティリティが呼び出されます。

サーバ固有のアンインストーラ スクリプトのサンプルについては、コード リスト 3-3 を参照してください。

WebLogic Server インスタンスを実行する Windows サービスを削除するためのスクリプトを作成するには、次の手順に従います。

削除スクリプトの実行が正常に完了すると、標準出力に次のような行が出力されます。
mydomain_myserver removed.

デフォルトの標準出力は、batch ファイルを実行しているコマンド プロンプトです。

echo off
SETLOCAL

set DOMAIN_NAME=myWLSdomain 
set SERVER_NAME=myWLSserver 
call "D:\bea\weblogic81\server\bin\uninstallSvc.cmd"

ENDLOCAL

Windows サービスとして設定されているサーバの起動資格の変更

Windows サービスを変更して、別のユーザ資格で WebLogic Server インスタンスを実行できるようにするには、次のいずれか 1 つを行います。