4.3. Microsoft Windows Server で JBoss EAP をサービスとして設定

前提条件

  • JBoss EAP を ZIP または インストーラー でインストールします。
  • サーバーの管理者特権。
  • JAVA_HOME システム環境変数を設定する必要があります。
  • JBoss EAP 7 サーバーインスタンスが実行されていない必要があります。
重要

set コマンドを使用して Windows Server コマンドプロンプトでシステム環境変数を設定すると、環境変数は永続的に設定されません。setx コマンドを使用するか、コントロールパネルのシステムインターフェイスを使用する必要があります。

Microsoft Windows Server で JBoss EAP をサービスとして設定

  1. 以下の 2 つのシステム環境変数を作成します。

    • JBoss EAP インストールディレクトリーを示す JBOSS_HOME
    • NOPAUSE=1

  2. JBoss Core Services Jsvc パッケージのインストール

    設定されていない場合は、JBoss Core Services Jsvc パッケージをダウンロードし、展開します。

    1. ブラウザーを開き、Red Hat カスタマーポータルで JBoss の Software Downloads ページにログインします。
    2. Product ドロップダウンメニューから Apache Jsvc を選択します。
    3. Version ドロップダウンメニューで最新のバージョンを選択します。
    4. システムのプラットフォームとアーキテクチャーに対応する Red Hat JBoss Core Services Apache Jsvc を見つけ、Download リンクをクリックします。

    5. JBoss EAP インストールディレクトリーが含まれるディレクトリーでダウンロードした ZIP ファイルを展開します。

      展開すると、JBoss EAP インストールディレクトリーと同じ階層に jbcs-jsvc-<VERSION> ディレクトリーが作成されます。例を以下に示します。 

      C:\Program Files
├── jboss-eap-7.3
│   ├── bin
│   └── ...
└── jbcs-jsvc-<VERSION>

  3. サービスのインストール

    ターミナルを開き、EAP_HOME\bin ディレクトリーに移動します。

    以下は、スタンドアロンサーバーまたは管理対象ドメインのサーバーに新しいサービスを作成する基本的な service.bat install コマンドの例になります。可能なオプションをすべて表示するには、引数を指定せずに service.bat を実行します。

    重要

    /jbossuser および /jbosspass パラメーターを指定する場合は、JBoss EAP ユーザーのパスワードにハッシュ (#) またはセミコロン (;) が含まれないようにする必要があります。

    以下のコマンドを実行します。 サービスのログレベルは必要に応じて変更してください。

    1. スタンドアロンサーバーの場合: 

      service.bat install /loglevel INFO

    2. 管理対象ドメインのサーバーの場合

      /host パラメーターを使用して、サービスによって制御されている JBoss EAP ホストコントローラーの名前を指定します。管理 CLI で ls /host を実行すると、名前の有効な値を表示できます。

      以下のコマンドの EAP_HOST_NAME は JBoss EAP ホストコントローラー名に置き換えてください。JBoss EAP のホストコントローラー名を提供せずに /host パラメーターを指定すると、デフォルトで master が名前として使用されます。 

      service.bat install /host EAP_HOST_NAME /loglevel INFO

    JBossEAP7 という名前の新しい Windows サービスが作成されます。

  4. Services コンソールでの新規サービスの検証

    Windows の Services コンソール (services.msc) を開き、サービスが作成されたことを確認します。

    デフォルトのサービス名が使用された場合は、Windows サービスのリストに新しいサービスの名前 JBoss EAP7 が表示されます。サービスコンソールからサービスを起動および停止でき、さらにサービスの起動方法および起動時に関する設定を変更できます。

  5. ターミナルから JBoss EAP サービスを起動および停止

    ターミナルからサービスを起動するには、以下のコマンドを使用します (必要な場合は、サービス名を変更します)。 

    net start JBossEAP7

    ターミナルからサービスを停止するには、以下のコマンドを使用します (必要な場合は、サービス名を変更します)。 

    net stop JBossEAP7

JBoss EAP サービスを削除する場合は、以下の手順に従います。

Microsoft Windows Server の JBoss EAP サービスの削除

  1. サービスが実行中の場合は最初にターミナルを開き、サービス名を指定して net stop コマンドを実行し、サービスを停止します。 

    net stop JBossEAP7

  2. ターミナルで、EAP_HOME\bin ディレクトリーに移動し、以下のコマンドを実行します。 

    service.bat uninstall