第4章 サービスとして実行するよう JBoss EAP を設定

Red Hat Enterprise Linux で JBoss EAP をサービスとして設定

1. jboss-eap.conf ファイルの起動オプションをカスタマイズします。

   起動スクリプトと関連する設定ファイルは EAP_HOME/bin/init.d/ ディレクトリーにあります。テキストエディターで jboss-eap.conf を開き、JBoss EAP インストールのオプションを設定します。

   jboss-eap.conf ファイルには複数のオプションがありますが、最低でも JBOSS_HOME と JBOSS_USER の正しい値を指定する必要があります。

   You can customize the other options provided in the configuration file by uncommenting and editing the respective lines. If you do not, the service will default to starting a standalone JBoss EAP server using the default configuration file, standalone.xml.

   注記

   If you want the service to start JBoss EAP as a managed domain, add JBOSS_MODE=domain to jboss-eap.conf.

   To specify custom domain configuration files, add JBOSS_DOMAIN_CONFIG=DOMAIN_CONFIG_FILE.xml and JBOSS_HOST_CONFIG=HOST_CONFIG_FILE.xml. By default, JBoss EAP uses domain.xml and host.xml as the domain configuration files.

2. サービスファイルをシステムディレクトリーにコピーします。

   1. 変更したサービス設定ファイルを /etc/default ディレクトリーにコピーします。

      sudo cp EAP_HOME/bin/init.d/jboss-eap.conf /etc/default

   2. サービス起動スクリプトを /etc/init.d ディレクトリーにコピーし、実行パーミッションを付与します。

      sudo cp EAP_HOME/bin/init.d/jboss-eap-rhel.sh /etc/init.d
      sudo chmod +x /etc/init.d/jboss-eap-rhel.sh

3. chkconfig サービス管理コマンドを使用して、自動的に起動されるサービスのリストに新しい jboss-eap-rhel.sh サービスを追加します。

   sudo chkconfig --add jboss-eap-rhel.sh

4. 以下のコマンドの 1 つを使用して、サービスが正しくインストールされたことをテストします。

   1. Red Hat Enterprise Linux 6 の場合

      sudo service jboss-eap-rhel.sh start

   2. Red Hat Enterprise Linux 7 の場合

      sudo service jboss-eap-rhel start

   サービスが起動します。エラーが発生した場合はエラーログを確認し、設定ファイルのオプションが正しく設定されていることを確認してください。

5. Red Hat Enterprise Linux サーバーの起動時にサービスが自動的に起動するようにするには、以下のコマンドを実行します。

   sudo chkconfig jboss-eap-rhel.sh on

Red Hat Enterprise Linux での JBoss EAP サービスの削除

1. サービスが実行中である場合は、ターミナルを開き、以下のコマンドの 1 つを使用してサービスを停止します。

   1. Red Hat Enterprise Linux 6 の場合

      sudo service jboss-eap-rhel.sh stop

   2. Red Hat Enterprise Linux 7 の場合

      sudo service jboss-eap-rhel stop

2. サービスのリストから JBoss EAP を削除します。

   sudo chkconfig --del jboss-eap-rhel.sh

3. サービス設定ファイルと起動スクリプトを削除します。

   sudo rm /etc/init.d/jboss-eap-rhel.sh
   sudo rm /etc/default/jboss-eap.conf

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.0
      │   ├── bin
      │   └── ...
      └── jbcs-jsvc-<VERSION>

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

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

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

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

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

      service.bat install /loglevel INFO

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

      Use the /host parameter to specify the name of the JBoss EAP host controller being controlled by the service. You can see valid values for the name by executing ls /host in the management CLI.

      Replace EAP_HOST_NAME in the command below with your JBoss EAP host controller name. If you specify the /host parameter without providing a JBoss EAP host controller name, the name defaults to 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

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

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

   net stop JBossEAP7

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

   service.bat uninstall

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> ディレクトリーが作成されます。例を以下に示します。

   /var/opt/
   ├── jboss-eap-7.0
   │   ├── bin
   │   └── ...
   └── jbcs-jsvc-<VERSION>

6. Jsvc を使用して JBoss EAP を起動するコマンドの例では、jboss ユーザーがすでに作成されていることを仮定します。JBoss EAP のユーザーを作成していない場合は、以下のコマンドを実行し、jboss ユーザーおよびグループを作成します。

   # groupadd -f -g 185 -r jboss
   # useradd -r -u 185 -g jboss -d EAP_HOME -s /sbin/nologin -c "JBoss" jboss

1. Red Hat サブスクリプションマネージャーにログインします。
2. Subscriber Inventory のシステムをクリックします。

3. ご使用のオペレーティングシステムバージョンとアーキテクチャーの JBoss Core Services CDN リポジトリーにサブスクライブします。

   1. Red Hat Enterprise Linux 6 の場合

      • jb-coreservices-1-for-rhel-6-server-rpms

   2. Red Hat Enterprise Linux 7 の場合

      • jb-coreservices-1-for-rhel-7-server-rpms

4. root ユーザーで以下のコマンドを実行し、Jsvc をインストールします。

   # yum groupinstall jbcs-jsvc