インストールガイド
Red Hat JBoss Web Server 3.1 のインストールおよび設定
概要
第1章 はじめに リンクのコピーリンクがクリップボードにコピーされました!
1.1. Red Hat JBoss Web Server リンクのコピーリンクがクリップボードにコピーされました!
Red Hat JBoss Web Server は、Java Web アプリケーションをホストするための完全に統合され認定されたコンポーネントセットです。これは、Web サーバー (Apache HTTP Server)、アプリケーションサーバー (Apache Tomcat Servlet コンテナー)、ロードバランサー (mod_jk および mod_cluster)、および Tomcat ネイティブライブラリーで構成されます。
このインストールガイドには、サポートされるオペレーティングシステム上で JBoss Web Server から Tomcat サーバーをインストール、マイナーアップグレード、および基本設定する手順が含まれています。Apache HTTP Server のインストールおよび設定手順は、JBoss Core Services のドキュメント を参照してください。
1.2. コンポーネント リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server は以下のコンポーネントで構成されています。
- Apache Tomcat は、Java Servlet Specification に準拠するサーブレットコンテナーです。JBoss Web Server には、Apache Tomcat 7 と Apache Tomcat 8 が含まれています。
- Apache Tomcat Native Library は Tomcat ライブラリーで、Tomcat のスケーラビリティー、パフォーマンス、ネイティブサーバー技術との統合が改善されます。
- Apache Tomcat Connectors (mod_jk, mod_cluster)は、Apache HTTP Server と Apache Tomcat 間のコネクターです。デフォルトは mod_cluster であることに注意してください。これは JBoss ネイティブロードバランサーであり、mod_jk よりも効率的で信頼性があり、拡張可能であるためです。JBoss Web Server 3.1 より、mod_jk および mod_cluster コネクターは JBoss Core Services の一部として提供されます。これら 2 つのモジュールのインストールと設定の詳細は、『 HTTP Connectors and Load Balancing Guide 』を参照してください。
- Apache HTTP Server は、Apache Software Foundation により開発されたオープンソースの Web サーバーです。この実装は、現在の HTTP 標準に準拠します。JBoss Web Server 3.1 では、Apache HTTP Server は JBoss Core Services の一部として提供されます。http サーバーのインストールおよび設定に関する詳細は、JBoss Core Services Documentation を参照してください。
- Hibernate はオブジェクト関係マッピングフレームワークです。JBoss Web Server に含まれる Hibernate には、JPA 1.0 API を使用する Hibernate Core、Hibernate Annotations、および Hibernate EntityManager が含まれます。
JBoss Web Server 3.1 に含まれるコンポーネントバージョンの詳細な一覧は、https://access.redhat.com/articles/111723 を参照してください。
Tomcat クラスタリングは JBoss Web Server 3.1 から削除されました。Java アプリケーションのクラスタリングまたはセッションレプリケーションのサポートが必要な場合、Red Hat は Red Hat JBoss Enterprise Application Platform(JBoss EAP)の使用を推奨します。
1.3. サポート対象オペレーティングシステムおよび設定 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server のサポートされるオペレーティングシステムおよび設定に関する詳細は、https://access.redhat.com/articles/1377603 を参照してください。
1.4. インストール方法 リンクのコピーリンクがクリップボードにコピーされました!
各プラットフォームで利用可能な ZIP インストールファイルを使用して、サポートされる Red Hat Enterprise Linux、Microsoft Windows、および Solaris システムに JBoss Web Server をインストールできます。RPM パッケージを使用して、サポートされる Red Hat Enterprise Linux システムに JBoss Web Server をインストールすることもできます。
ZIP インストールの場合、JBoss Web Server インストールのコア部分を形成する ZIP ファイルに含まれるコンポーネントの概要を以下に示します。
jws-application-servers-3.1.0-<platform>-<architecture>.zip- Tomcat 7
- Tomcat 8
- プラットフォーム固有のユーティリティー
1.5. JBoss Web Server のアップグレード リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server のアップグレードはサポートされていません。以前のバージョンから JBoss Web Server 3.1 にアップグレードする場合は、新規インストールが推奨されます。
RPM を使用して JBoss Web Server 1.x または 2.x をインストールする場合は、JBoss Web Server 1.x または 2.x を削除して、同じマシンに JBoss Web Server 3.1 をインストールすることはできません。古いパッケージの多くの設定ファイルはシステム上に残り、新しい RPM パッケージとの互換性の問題を作成します。同じ理由で、古い RPM を手動で削除し、新しい RPM のインストールもサポートされていません。
ZIP を使用して JBoss Web Server 1.x または 2.x がインストールされているシステムでは、以前のバージョンを削除して、同じシステムに JBoss Web Server 3.1 をインストールすることができます。
1.6. コンポーネントドキュメントバンドル リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server には、各コンポーネントの元のベンダードキュメントが含まれる追加のドキュメントバンドルが含まれています。このドキュメントバンドル jws-docs-3.1.0.zip は Red Hat カスタマーポータルから入手できます。これには、以下の追加のドキュメントが含まれています。
- mod_cluster
- openssl
- tomcat7
- tomcat8
- tomcat-native
第2章 Red Hat Enterprise Linux への JBoss Web Server のインストール リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server は、以下のいずれかの方法を使用して Red Hat Enterprise Linux にインストールできます。
選択した方法に関係なく、最初に サポートされる Java Development Kit(JDK)をインストール する必要があります。
2.1. 前提条件 リンクのコピーリンクがクリップボードにコピーされました!
2.1.1. Java Development Kit (JDK) のインストール リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server をインストールする前に、サポートされる Java Development Kit (JDK) を最初にインストールする必要があります。
Red Hat Enterprise Linux システムを適切なチャンネルにサブスクライブします。
OpenJDK:
- rhel-7-server-rpms
Oracle:
- rhel-7-server-thirdparty-oracle-java-rpms
IBM:
- rhel-7-server-supplementary-rpms
Red Hat Enterprise Linux 6 はサポートされなくなり、その後ドキュメントから削除されました。
+ .root ユーザーとしてコマンドを実行し、1.7 または 1.8 JDK: をインストールします。JDK 1.7 の場合:
+
yum install java-1.7.0-<VENDOR>-devel
# yum install java-1.7.0-<VENDOR>-devel
+ < ;VENDOR& gt; を oracle、ibm、または openjdk に置き換えます。JDK 1.8 の場合:
+
yum install java-1.8.0-<VENDOR>-devel
# yum install java-1.8.0-<VENDOR>-devel
+ < VENDOR> を oracle、ibm、または openjdk に置き換えます。
root ユーザーとして以下のコマンドを実行し、正しい JDK が使用されていることを確認します。
alternatives --config java
# alternatives --config javaCopy to Clipboard Copied! Toggle word wrap Toggle overflow alternatives --config javac
# alternatives --config javacCopy to Clipboard Copied! Toggle word wrap Toggle overflow これらのコマンドは、利用可能な JDK バージョンと、プラス (
+) 記号の付いた選択したバージョンの一覧を返します。選択した JDK が必要な JDK ではない場合は、シェルプロンプトで指示されたように、必要な JDK に変更します。重要javaコマンドおよびjavacコマンドを使用するすべてのソフトウェアは、alternativesによって設定された JDK を使用します。Java の代替の変更は、他のソフトウェアの実行に影響を及ぼす可能性があります。
2.1.2. Red Hat Enterprise Linux パッケージの要件 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Enterprise Linux に JBoss Web Server をインストールする前に、以下の前提条件を満たしていることを確認してください。
- サポートされる JDK がインストールされている。
-
tomcat-nativeパッケージをインストールする前に、tomcatjssパッケージを削除する必要があります。tomcatjssパッケージは、OpenSSL セキュリティーモデルではなく、基礎となる NSS セキュリティーモデルを使用します。
tomcatjss パッケージの削除
root ユーザーとして以下のコマンドを実行し、
tomcatjssを削除します。yum remove tomcatjss
# yum remove tomcatjssCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2. ZIP インストール リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server をインストールする前に、すべての 前提条件を満たし ていることを確認してください。
2.2.1. JBoss Web Server のダウンロードおよび拡張 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server をインストールするには、インストール ZIP ファイルをダウンロードし、展開します。
JBoss Web Server のダウンロード
- ブラウザーを開き、Red Hat カスタマーポータル にログインします。
- ダウンロードをクリックします。
- 製品のダウンロード リストの Red Hat JBoss Web Server をクリックします。
- Version ドロップダウンメニューから正しい JBoss Web Server バージョンを選択します。
以下の各ファイルの Download をクリックし、システムのプラットフォームおよびアーキテクチャーが正しく選択されていることを確認します。
-
Red Hat JBoss Web Server 3.1 Application Server(
jws-application-servers-3.1.0- <platform> - <architecture& gt; .zip)
-
Red Hat JBoss Web Server 3.1 Application Server(
JBoss Web Server の抽出
ダウンロードした ZIP ファイルをインストールディレクトリーに展開します。
ZIP アーカイブを展開して作成したディレクトリーは、JBoss Web Server の最上位ディレクトリーになります。これは
JWS_HOMEと呼ばれます。
2.2.2. JBoss Web Server インストールの設定 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を実行する前に一部の設定が必要になります。本セクションには、以下の設定手順が含まれています。
- JAVA_HOME 環境変数の設定
- 簡単でセキュアなユーザー管理のための tomcat ユーザーの作成: Tomcat ユーザーの作成
- Tomcat の log4j ロギングの有効化
JAVA_HOME 環境変数の設定
JBoss Web Server を実行する前に、Tomcat の JAVA_HOME 環境変数を設定する必要があります。
Tomcat の bin ディレクトリー( JWS_HOME/tomcat7/bin または JWS_HOME/tomcat8/bin)で、setenv.sh という名前のファイルを作成し、JAVA_HOME パス定義を挿入します。
例: JAVA_HOME=/usr/lib/jvm/jre-1.7.0-openjdk.x86_64
Tomcat ユーザーの作成
以下の手順に従って、tomcat ユーザーと親グループを作成します。
-
root ユーザーとしてシェルプロンプトで、
JWS_HOMEディレクトリーに移動します。 以下のコマンドを実行して
tomcatユーザーグループを作成します。groupadd -g 53 -r tomcat
# groupadd -g 53 -r tomcatCopy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して、
tomcatユーザーグループにtomcatユーザーを作成します。useradd -c "Tomcat" -u 53 -g tomcat -s /bin/sh -r tomcat
# useradd -c "Tomcat" -u 53 -g tomcat -s /bin/sh -r tomcatCopy to Clipboard Copied! Toggle word wrap Toggle overflow tomcatユーザーグループとtomcatユーザーが正しく作成されていることを確認します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow JWS_HOMEから次のコマンドを実行して 、Tomcat ディレクトリーの所有権をユーザーに割り当てて、tomcatユーザーが Tomcat サービスを実行できるようにします。chown -R tomcat:tomcat tomcat<VERSION>
# chown -R tomcat:tomcat tomcat<VERSION>Copy to Clipboard Copied! Toggle word wrap Toggle overflow <
;VERSION> をそれぞれの Tomcat バージョン番号(7または8)に置き換えます。ls -lを使用して、tomcatユーザーがディレクトリーの所有者であることを確認できます。tomcatユーザーに、すべての親ディレクトリーへの実行権限があることを確認します。以下に例を示します。chmod -R u+X tomcat<VERSION>
# chmod -R u+X tomcat<VERSION>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Tomcat の Apache Log4j ロギングの有効化
Apache Log4j でのロギングを有効にするには、以下を実行します。
JWS_HOME/extras/ディレクトリーに移動します。cd JWS_HOME/extras/
# cd JWS_HOME/extras/Copy to Clipboard Copied! Toggle word wrap Toggle overflow log4j-eap6.jarおよびlog4j.propertiesをJWS_HOME/extras/からJWS_HOME/libにコピーします。cp log4j.properties log4j-eap6.jar ../tomcat<VERSION>/lib/
# cp log4j.properties log4j-eap6.jar ../tomcat<VERSION>/lib/Copy to Clipboard Copied! Toggle word wrap Toggle overflow <
;VERSION> を Tomcat バージョン番号(7または8)に置き換えます。JWS_HOME/tomcat<VERSION>/extras/ ディレクトリーに移動します。cd ../tomcat<VERSION>/extras/
# cd ../tomcat<VERSION>/extras/Copy to Clipboard Copied! Toggle word wrap Toggle overflow tomcat-juli-adapters.jarをJWS_HOME/tomcat<VERSION>/extras からコピーします。JWS_HOME/tomcat<VERSION>/lib にcp tomcat-juli-adapters.jar ../lib/
# cp tomcat-juli-adapters.jar ../lib/Copy to Clipboard Copied! Toggle word wrap Toggle overflow JWS_HOME/tomcat<VERSION>/bin/tomcat-juli.jarをJWS_HOME/tomcat<VERSION>/extras/tomcat-juli.jar に置き換えます。cp tomcat-juli.jar ../bin/
# cp tomcat-juli.jar ../bin/Copy to Clipboard Copied! Toggle word wrap Toggle overflow
2.2.3. JBoss Web Server の起動 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を起動するには、以下を開始する必要があります。
- Tomcat(7 または 8)
Tomcat を起動する前に、以下の前提条件を満たしていることを確認してください。
Tomcat の起動
各 Tomcat バージョン(
7または8)で、tomcatユーザーとして以下のコマンドを実行します。sh JWS_HOME/tomcat<VERSION>/bin/startup.sh
$ sh JWS_HOME/tomcat<VERSION>/bin/startup.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow 重要Tomcat を起動する方法は複数ありますが、
startup.shスクリプトを使用することが推奨されます。Jsvc を使用して Tomcat をサービスとして起動するには、Jsvc の 章を 参照してください。
2.2.4. JBoss Web Server の停止 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を停止するには、以下を停止する必要があります。
- Tomcat(7 または 8)
Tomcat の停止
Tomcat を停止するには、それぞれの Tomcat バージョン(
7または8)で root ユーザーとして以下のコマンドを実行します。sh JWS_HOME/tomcat<VERSION>/bin/shutdown.sh
# sh JWS_HOME/tomcat<VERSION>/bin/shutdown.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow
2.3. RPM インストール リンクのコピーリンクがクリップボードにコピーされました!
RPM パッケージから JBoss Web Server をインストールすると、Tomcat がサービスとしてインストールされ、そのリソースを絶対パスにインストールします。RPM インストールオプションは、Red Hat Enterprise Linux 7 でのみ利用できます。
JBoss Web Server の RPM インストールパッケージは、Red Hat Subscription Management から入手できます。
Red Hat Satellite を使用して JBoss Web Server のインストールを管理するユーザーの場合: Red Hat Satellite 6 は JBoss Web Server 3.1 インストールの管理に推奨されますが、Satellite 5 ユーザー向けに以下の Red Hat Network(RHN)チャンネルも提供されています。
Red Hat Enterprise Linux 7 の場合:
- jws-3-x86_64-server-7-rpm
Red Hat Satellite 6 ユーザーは、Red Hat コンテンツ配信ネットワーク(CDN)リポジトリー を使用できます。
Red Hat Enterprise Linux 6 はサポートされなくなり、その後ドキュメントから削除されました。
RPM パッケージから JBoss Web Server をインストールすると、Java ライブラリーファイルが他のアプリケーションと共有されます。RPM パッケージを使用して JBoss Web Server 3 と JBoss EAP 6 の両方を同じマシンにインストールすると、ライブラリーバージョンの競合が発生します。この問題を回避するには、RPM インストール手法を使用して JBoss Web Server 3 または JBoss EAP 6 をインストールし、ZIP インストール方式を使用してもう 1 つをインストールできます。
2.3.1. RPM パッケージからの JBoss Web Server のインストール リンクのコピーリンクがクリップボードにコピーされました!
RPM パッケージをダウンロードしてインストールする前に、システムを Red Hat Subscription Management に登録し、該当する Content Delivery Network (CDN) リポジトリーをサブスクライブする必要があります。
Red Hat Enterprise Linux の登録に関する情報は、「 The Subscription Manager for Red Hat Enterprise Linux 7 」を参照してください。
Red Hat Enterprise Linux へのサブスクリプションの割り当て (必要な場合)
システムに JBoss Web Server を提供するサブスクリプションが割り当てられていない場合は、以下を行います。
- Red Hat Subscription Manager にログインします。
- Systems タブをクリックします。
-
システムの
Nameをクリックして、サブスクリプションを追加します。 -
Details タブから Subscriptions タブに移動し、
Attach Subscriptionsをクリックします。 -
アタッチするサブスクリプションの横にあるチェックボックスを選択してから、
Attach Subscriptionsをクリックします。
サブスクリプションが必要な CDN リポジトリーを提供していることを確認するには、以下を行います。
- https://access.redhat.com/management/subscriptions にログインします。
-
Subscription Nameをクリックします。 Products Provided には以下が必要です。
- JBoss Enterprise Web Server
- Red Hat JBoss Core Services
YUM を使用した RPM パッケージからの JBoss Web Server のインストール
コマンドラインで、
subscription-managerを使用して、お使いのオペレーティングシステムバージョンの JBoss Web Server CDN リポジトリーにサブスクライブします。subscription-manager repos --enable <repository>
# subscription-manager repos --enable <repository>Copy to Clipboard Copied! Toggle word wrap Toggle overflow Red Hat Enterprise Linux 7 の場合:
- jws-3-for-rhel-7-server-rpms
- jb-coreservices-1-for-rhel-7-server-rpms
Red Hat Enterprise Linux 6 はサポートされなくなり、その後ドキュメントから削除されました。
root ユーザーとして以下のコマンドを実行し、JBoss Web Server をインストールします。
yum groupinstall jws3
# yum groupinstall jws3Copy to Clipboard Copied! Toggle word wrap Toggle overflow 注記- 推奨されませんが、group install を使用する代わりに、各パッケージと依存関係を個別にインストールできます。
- JBoss Web Server のインストールには、上記の Red Hat JBoss Core Services リポジトリーが必要です。
2.3.2. JBoss Web Server Plus グループのインストール リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server Plus グループには、主に Hibernate とその依存関係の追加に関する追加のパッケージが含まれます。
JBoss Web Server Plus グループパッケージをインストールするには、root で以下のコマンドを実行します。
yum groupinstall jws3plus
# yum groupinstall jws3plus
2.3.3. JBoss Web Server の起動 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を起動するには、以下を開始する必要があります。
- Tomcat(7 または 8)
Tomcat の起動
root ユーザーとしてシェルプロンプトで、Tomcat サービスを起動します。<
;VERSION> を必要な Tomcat バージョン(7または8)に置き換えます。Red Hat Enterprise Linux 7 の場合:
systemctl start tomcat<VERSION>.service
# systemctl start tomcat<VERSION>.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
これは、RPM インストール用に Tomcat を起動するのにサポートされる唯一の方法です。
Tomcat が稼働していることを確認するには、service
statusコマンドの出力を確認する必要があります。これは、任意のユーザーとして実行できます。Red Hat Enterprise Linux 7 の場合:
systemctl status tomcat<VERSION>.service
# systemctl status tomcat<VERSION>.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Red Hat Enterprise Linux 6 はサポートされなくなり、その後ドキュメントから削除されました。
2.3.4. JBoss Web Server の停止 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を停止するには、Tomcat サービスを停止します。
Tomcat の停止
root ユーザーとしてシェルプロンプトで、Tomcat サービスを停止します。<
;VERSION> を必要な Tomcat バージョン(7または8)に置き換えます。Red Hat Enterprise Linux 7 の場合:
systemctl stop tomcat<VERSION>.service
# systemctl stop tomcat<VERSION>.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Tomcat が実行しなくなったことを確認するには、service
statusコマンドの出力を確認する必要があります。これは、任意のユーザーとして実行できます。Red Hat Enterprise Linux 7 の場合:
systemctl status tomcat<VERSION>.service
# systemctl status tomcat<VERSION>.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Red Hat Enterprise Linux 6 はサポートされなくなり、その後ドキュメントから削除されました。
2.3.5. 起動時に開始する JBoss Web Server サービスの設定 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server は起動時に起動するように設定できます。
以下のコマンドを使用して、JBoss Web Server サービスが起動時に開始できるようにします。< ;VERSION> を必要な Tomcat バージョン(7 または 8)に置き換えます。
Red Hat Enterprise Linux 7 の場合:
systemctl enable tomcat<VERSION>.service
# systemctl enable tomcat<VERSION>.serviceCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Red Hat Enterprise Linux 6 はサポートされなくなり、その後ドキュメントから削除されました。
2.4. SELinux ポリシー リンクのコピーリンクがクリップボードにコピーされました!
2.4.1. SELinux ポリシー情報 リンクのコピーリンクがクリップボードにコピーされました!
以下の表には、tomcat <version> -selinux パッケージで提供される SELinux ポリシーに関する情報をまとめています。
| 名前 | ポート情報 | ポリシー情報 |
|---|---|---|
| tomcat<version> |
|
Tomcat < |
SELinux およびその他の Red Hat Enterprise Linux セキュリティー情報の使用に関する詳細は『Red Hat Enterprise Linux Security Guide』を参照してください。
2.4.2. RPM インストール用の SELinux ポリシー リンクのコピーリンクがクリップボードにコピーされました!
各 Tomcat の SELinux ポリシーは、独自の Tomcat サブパッケージから提供されます( tomcat7-selinux および tomcat8-selinux )。これらのパッケージは JWS チャネルで利用できます。
-
Tomcat 7 で SELinux ポリシーを有効にするには、
tomcat7-selinuxパッケージをインストールします。 -
Tomcat 8 で SELinux ポリシーを有効にするには、
tomcat8-selinuxパッケージをインストールします。
2.4.3. ZIP インストールの SELinux ポリシー リンクのコピーリンクがクリップボードにコピーされました!
本リリースでは、SELinux ポリシーは ZIP パッケージで提供されます。SELinux セキュリティーモデルはカーネルにより適用され、アプリケーションがファイルシステムの場所やポートなどのリソースに限定的なアクセスを行えるようにします。これにより、誤ったプロセス (危険にさらされるか、設定されていないかのいずれか) が制限され、場合によっては実行できないようにすることが可能になります。.postinstall.selinux ファイルは各 tomcat フォルダーに含まれます。必要に応じて、.postinstall.selinux スクリプトを実行できます。
ZIP を使用して SELinux ポリシーをインストールするには、以下を実行します。
selinux-policy-develパッケージをインストールします。yum install -y selinux-policy-devel
yum install -y selinux-policy-develCopy to Clipboard Copied! Toggle word wrap Toggle overflow .postinstall.selinuxスクリプトを実行します。cd <JWS_home>/tomcat<version> sh .postinstall.selinux
cd <JWS_home>/tomcat<version> sh .postinstall.selinuxCopy to Clipboard Copied! Toggle word wrap Toggle overflow ここで、
tomcat<version> はtomcat7またはtomcat8を参照します。SELinux モジュールを作成してインストールします。
cd selinux make -f /usr/share/selinux/devel/Makefile semodule -i tomcat<version>.pp
cd selinux make -f /usr/share/selinux/devel/Makefile semodule -i tomcat<version>.ppCopy to Clipboard Copied! Toggle word wrap Toggle overflow JBoss Web Server の SELinux コンテキストを適用します。
restorecon -r <JWS_home>/tomcat<version>/
restorecon -r <JWS_home>/tomcat<version>/Copy to Clipboard Copied! Toggle word wrap Toggle overflow JBoss Web Server の必要なポートへのアクセスパーミッションを追加します。
semanage port -a -t http_port_t -p tcp 8005 semanage port -a -t http_port_t -p tcp 8080 semanage port -a -t http_port_t -p tcp 8009 semanage port -a -t http_port_t -p tcp 8443
semanage port -a -t http_port_t -p tcp 8005 semanage port -a -t http_port_t -p tcp 8080 semanage port -a -t http_port_t -p tcp 8009 semanage port -a -t http_port_t -p tcp 8443Copy to Clipboard Copied! Toggle word wrap Toggle overflow Tomcat サービスを起動します。
<JWS_home>/bin/startup.sh
<JWS_home>/bin/startup.shCopy to Clipboard Copied! Toggle word wrap Toggle overflow tomcat_<version>__tが予想される実行中のプロセスのコンテキストを確認します。ps -eZ | grep tomcat | head -n1
ps -eZ | grep tomcat | head -n1Copy to Clipboard Copied! Toggle word wrap Toggle overflow Tomcat ディレクトリーのコンテキストを確認するには、以下のように設定します。
ls -lZ <JWS_home>/tomcat<version>/logs/
ls -lZ <JWS_home>/tomcat<version>/logs/Copy to Clipboard Copied! Toggle word wrap Toggle overflow
デフォルトでは、提供される selinux ポリシーがアクティブではなく、Tomcat プロセスが unconfined_java_t ドメインで実行されます。このドメインはプロセスに制限されず、提供される selinux ポリシーを有効にしない場合は、以下のセキュリティー対策を実行することが推奨されます。
-
tomcatユーザーのファイルアクセスを JBoss Web Server ランタイムに必要なファイルおよびディレクトリーのみに制限します。 -
rootユーザーで Tomcat を実行しないでください。
第3章 Microsoft Windows への JBoss Web Server のインストール リンクのコピーリンクがクリップボードにコピーされました!
3.1. Java Development Kit (JDK) のインストール リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を Microsoft Windows にインストールする前に、最初にサポートされる Java Development Kit (JDK) をインストールする必要があります。
サポートされる構成の一覧は、Red Hat カスタマーポータルのアーティクル「 JBoss Web Server 3 Supported Configurations 」を参照してください。
IBM JDK のインストール方法は、https://www.ibm.com/developerworks/java/jdk/ を参照してください。
Oracle Java Development Kit をインストールするには、以下を実行します。
- オペレーティングシステムおよびアーキテクチャー用の Oracle JDK 1.7 または 1.8 をダウンロードします。JDK インストールファイルは、Oracle の Web サイト http://www.oracle.com/technetwork/java/javase/downloads/index.html からダウンロードできます。
- ダウンロードしたファイルをダブルクリックしてインストールを開始します。
- インストールウィンドウで指示どおりに続行します。
3.2. JBoss Web Server のダウンロードおよび拡張 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server をインストールするには、インストール ZIP ファイルをダウンロードし、展開します。
JBoss Web Server のダウンロード
- ブラウザーを開き、Red Hat カスタマーポータル にログインします。
- ダウンロードをクリックします。
- 製品のダウンロード リストの Red Hat JBoss Web Server をクリックします。
- Version ドロップダウンメニューから正しい JBoss Web Server バージョンを選択します。
以下の各ファイルの Download をクリックし、システムのプラットフォームおよびアーキテクチャーが正しく選択されていることを確認します。
-
Red Hat JBoss Web Server 3.1 Application Server(
jws-application-servers-3.1.0- <platform> - <architecture& gt; .zip)
-
Red Hat JBoss Web Server 3.1 Application Server(
JBoss Web Server の抽出
ダウンロードした ZIP ファイルをインストールディレクトリーに展開します。
ZIP アーカイブを展開して作成したディレクトリーは、JBoss Web Server の最上位ディレクトリーになります。これは
JWS_HOMEと呼ばれます。
3.3. JBoss Web Server インストールの設定 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を実行する前に一部の設定が必要になります。本セクションには、以下の設定手順が含まれています。
環境変数の設定
- ローカル管理者権限を持つアカウントにログインします。
- コントロールパネル → システム と選択します。
- Advanced タブをクリックします。
- 環境変数 ボタンをクリックします。
- システム変数 の 新規 ボタンをクリックします。
-
JAVA_HOME、TMP、TEMPに、システムに適切な名前と値のペアを入力します。 -
SSL コネクターが機能するには、サービスを実行するユーザーの
PATH環境変数にJWS_HOME\binを追加する必要があります。このユーザーは、デフォルトでSYSTEMです。
インストール後のスクリプトの実行
管理者権限でコマンドプロンプトを開き、JBoss Web Server インストールの
etcディレクトリーに移動します。cd /D "JWS_HOME\etc"
cd /D "JWS_HOME\etc"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを使用して、インストール後に Tomcat を実行します。
call postinstall.tomcat.bat
call postinstall.tomcat.batCopy to Clipboard Copied! Toggle word wrap Toggle overflow このスクリプトは、一時的なロギングと設定ディレクトリーに必要なシンボリックリンク(詳細ポイント)を作成します。
Tomcat サービスのインストール
管理者権限でコマンドプロンプトを開き、Tomcat バージョンの
binフォルダーに移動します。cd /D "JWS_HOME\share\tomcat<VERSION>\bin"
cd /D "JWS_HOME\share\tomcat<VERSION>\bin"Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを使用して、Tomcat サービスをインストールします。
call service.bat install
call service.bat installCopy to Clipboard Copied! Toggle word wrap Toggle overflow
Tomcat の log4j ロギングの有効化
-
管理者権限でコマンドプロンプトを開き、
JWS_HOME\share\extras\に変更します。 log4j ファイルを Tomcat バージョンの
libフォルダーにコピーします。copy log4j-eap6.jar log4j.properties tomcat-juli-adapters.jar ..\tomcat<VERSION>\lib
copy log4j-eap6.jar log4j.properties tomcat-juli-adapters.jar ..\tomcat<VERSION>\libCopy to Clipboard Copied! Toggle word wrap Toggle overflow Tomcat
binディレクトリーのtomcat-juli.jarファイルをJWS_HOME\share\extras\のtomcat-juli.jarファイルに置き換えます。copy tomcat-juli.jar ..\tomcat<VERSION>\bin
copy tomcat-juli.jar ..\tomcat<VERSION>\binCopy to Clipboard Copied! Toggle word wrap Toggle overflow
JBoss Web Server サービスのフォルダーパーミッションの設定
以下の手順に従って、サービスの実行に使用するアカウントが JWS_HOME フォルダーとそのすべてのサブフォルダーを完全に制御できるようにします。
-
JWS_HOMEディレクトリーを右クリックし、Properties をクリックします。 - Security タブを選択します。
- Edit ボタンをクリックします。
- Add ボタンをクリックします。
-
テキストボックスに
LOCAL SERVICEを入力します。 -
LOCAL SERVICEアカウントの Full Control チェックボックスを選択します。 - OK をクリックします。
- Advanced ボタンをクリックします。
-
Advanced Security Settings ダイアログ内で
LOCAL SERVICEを選択し、Edit をクリックします。 - Replace all existing inheritable permissions on all descendants with inheritable permissions from this object オプションの横にあるチェックボックスを選択します。
- 開いているすべてのフォルダープロパティーウィンドウで OK をクリックして設定を適用します。
3.4. JBoss Web Server の起動 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を起動するには、以下を開始する必要があります。
- Tomcat(7 または 8)
コマンドプロンプトまたは Computer Management ツールを使用してサービスを起動できます。
コマンドプロンプトからの JBoss Web Server の起動
- 管理者権限でコマンドプロンプトを開きます。
Tomcat サービスを起動します。
net start tomcat<VERSION>
net start tomcat<VERSION>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Computer Management Tool からの JBoss Web Server の起動
- Start → Administraative Tools → Services と選択します。
-
Services 一覧で、サービス名(
tomcat)を右クリックし、Start をクリックします。
一部のサードパーティーアプリケーションは、Windows のシステムディレクトリーにライブラリーを追加します。これは、検索時に Tomcat ライブラリーよりも優先されます。つまり、これらのサードパーティーライブラリーの名前が Tomcat ネイティブライブラリーで使用されるものと同じ場合は、JBoss Web Server と配布されるライブラリーの代わりにロードされます。
この場合、Tomcat は起動しない可能性があり、Windows イベントログまたは Tomcat ログファイルにエラーメッセージを記録しません。エラーが発生するのは、catalina.bat run の使用した場合のみです。
この動作が発生した場合は、C:\windows\System32\ ディレクトリーおよびその他の PATH ディレクトリーの内容を検査し、JBoss Web Server に同梱される DLL がないことを確認します。特に、libeay32.dll、ssleay32.dll、libssl32.dll を検索します。
3.5. JBoss Web Server の停止 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を停止するには、以下を停止する必要があります。
- Tomcat
コマンドプロンプトまたは Computer Management ツールを使用してサービスを停止できます。
コマンドプロンプトからの JBoss Web Server の停止
- 管理者権限でコマンドプロンプトを開きます。
Tomcat サービスを停止します。
net stop tomcat<VERSION>
net stop tomcat<VERSION>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Computer Management Tool からの JBoss Web Server の停止
- Start → Administraative Tools → Services と選択します。
-
Services 一覧で、サービス名(
tomcat)を右クリックし、Stop をクリックします。
第4章 Solaris への JBoss Web Server のインストール リンクのコピーリンクがクリップボードにコピーされました!
4.1. Java Development Kit (JDK) のインストール リンクのコピーリンクがクリップボードにコピーされました!
Solaris に JBoss Web Server をインストールする前に、最初にサポートされる Java Development Kit(JDK)をインストールする必要があります。
サポートされる構成の一覧は、Red Hat カスタマーポータルのアーティクル「 JBoss Web Server 3 Supported Configurations 」を参照してください。
Java Development Kit (JDK) のインストール
root ユーザーとしてコマンドラインで Oracle JDK をインストールします。
pkg install jdk-<version>
# pkg install jdk-<version>
<version> は、インストールする JDK のバージョンです( jdk-8など)。
別の方法: Solaris での Java 開発キットのダウンロードおよびインストール
- オペレーティングシステムおよびアーキテクチャー用の Oracle JDK をダウンロードします。JDK インストールファイルは、Oracle の Web サイト http://www.oracle.com/technetwork/java/javase/downloads/index.html からダウンロードできます。
- JDK インストールファイルを実行します。
シェルプロンプトで
/usrを開き、以下のコマンドを実行して現在の Java シンボリックリンクを表示します。ls -lad java
ls -lad javaCopy to Clipboard Copied! Toggle word wrap Toggle overflow リンクを削除します。
rm java
rm javaCopy to Clipboard Copied! Toggle word wrap Toggle overflow 新たにインストールした JDK への Java シンボリックリンクを新たに作成します。
ln -sf /usr/jdk/<JDK>
ln -sf /usr/jdk/<JDK>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.2. JBoss Web Server のダウンロードおよび拡張 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server をインストールするには、インストール ZIP ファイルをダウンロードし、展開します。
JBoss Web Server のダウンロード
- ブラウザーを開き、Red Hat カスタマーポータル にログインします。
- ダウンロードをクリックします。
- 製品のダウンロード リストの Red Hat JBoss Web Server をクリックします。
- Version ドロップダウンメニューから正しい JBoss Web Server バージョンを選択します。
以下の各ファイルの Download をクリックし、システムのプラットフォームおよびアーキテクチャーが正しく選択されていることを確認します。
-
Red Hat JBoss Web Server 3.1 Application Server(
jws-application-servers-3.1.0- <platform> - <architecture& gt; .zip)
-
Red Hat JBoss Web Server 3.1 Application Server(
JBoss Web Server の抽出
ダウンロードした ZIP ファイルをインストールディレクトリーに展開します。
ZIP アーカイブを展開して作成したディレクトリーは、JBoss Web Server の最上位ディレクトリーになります。これは
JWS_HOMEと呼ばれます。
4.3. JBoss Web Server インストールの設定 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を実行する前に一部の設定が必要になります。本セクションには、以下の設定手順が含まれています。
インストール後のスクリプトの実行
-
シェルプロンプトを開き、
JWS_HOME/etcディレクトリーに移動します。 root ユーザーとして、インストール後のスクリプトを実行します。
sh .postinstall.tomcat
# sh .postinstall.tomcatCopy to Clipboard Copied! Toggle word wrap Toggle overflow インストール後のスクリプトは、Tomcat ユーザーおよびグループを作成します。
JAVA_HOME 環境変数の設定
JBoss Web Server を実行する前に、Tomcat の JAVA_HOME 環境変数を設定する必要があります。
Tomcat 設定ファイルを開きます。
-
Tomcat 7 の場合:
JWS_HOME/etc/sysconfig/tomcat7 -
Tomcat 8 の場合:
JWS_HOME/etc/sysconfig/tomcat8
-
Tomcat 7 の場合:
以下の行の最初にハッシュ(
#)を削除します。JAVA_HOME="/usr/java"
# JAVA_HOME="/usr/java"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
Tomcat の log4j ロギングの有効化
必要な場合は、以下の手順にしたがって log4j ロギングを Tomcat に追加します。
-
シェルプロンプトを開き、
JWS_HOME/share/extras/ディレクトリーに移動します。 log4j-eap6.jar、log4j.properties、およびtomcat-juli-adapters.jarファイルを Tomcat ディレクトリーのlibディレクトリーにコピーします。以下に例を示します。
cp log4j.properties ../tomcat<VERSION>/lib/
# cp log4j.properties ../tomcat<VERSION>/lib/Copy to Clipboard Copied! Toggle word wrap Toggle overflow cp log4j-eap6.jar ../tomcat<VERSION>/lib/
# cp log4j-eap6.jar ../tomcat<VERSION>/lib/Copy to Clipboard Copied! Toggle word wrap Toggle overflow cp tomcat-juli-adapters.jar ../tomcat<VERSION>/lib/
# cp tomcat-juli-adapters.jar ../tomcat<VERSION>/lib/Copy to Clipboard Copied! Toggle word wrap Toggle overflow <
;VERSION> をそれぞれの Tomcat バージョン番号(7または8)に置き換えます。Tomcat
binディレクトリーのtomcat-juli.jarファイルをJWS_HOME/share/extras/のtomcat-juli.jarファイルに置き換えます。cp tomcat-juli.jar ../tomcat<VERSION>/bin/
# cp tomcat-juli.jar ../tomcat<VERSION>/bin/Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.4. JBoss Web Server の起動 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を起動するには、以下を開始する必要があります。
- Tomcat(7 または 8)
Tomcat の起動
root ユーザーとして、それぞれの Tomcat バージョン(
7または8)で以下のコマンドを実行します。sh JWS_HOME/share/apache-tomcat-<VERSION>/bin/daemon.sh start
# sh JWS_HOME/share/apache-tomcat-<VERSION>/bin/daemon.sh startCopy to Clipboard Copied! Toggle word wrap Toggle overflow 重要Tomcat の起動方法は複数ありますが、
daemon.shスクリプトを使用することが推奨されます。Jsvc を使用して Tomcat をサービスとして起動するには、Jsvc の 章を 参照してください。
4.5. JBoss Web Server の停止 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server を停止するには、以下を停止する必要があります。
- Tomcat(7 または 8)
Tomcat の停止
Tomcat を停止するには、root ユーザーとしてシェルプロンプトで、それぞれの Tomcat バージョン(
7または8)を指定して以下のコマンドを実行します。sh JWS_HOME/share/apache-tomcat-<VERSION>/bin/daemon.sh stop
# sh JWS_HOME/share/apache-tomcat-<VERSION>/bin/daemon.sh stopCopy to Clipboard Copied! Toggle word wrap Toggle overflow
第5章 Jsvc を使用した Tomcat の起動 リンクのコピーリンクがクリップボードにコピーされました!
Jsvc は、Linux、UNIX、および同様のオペレーティングシステムで Java アプリケーションの実行を容易にするライブラリーとアプリケーションのセットです。JBoss Web Server で Jsvc を使用すると、Tomcat はアイデンティティーを切り換えることができます。Jsvc を使用すると、Tomcat はルートレベルの操作を実行してから、非特権ユーザーに戻すことができます。Jsvc は主に Tomcat をサービスとして実行するために使用されます。
Jsvc ファイルは以下の場所にあります。
Red Hat Enterprise Linux の場合:
-
JWS_HOME/extras/jsvc JWS_HOME/tomcat<VERSION>/bin/jsvc注記JWS_HOME/tomcat <VERSION> /bin/jsvcはJWS_HOME/extras/jsvcへのシンボリックリンクです。
-
Solaris の場合:
-
JWS_HOME/sbin/jsvc JWS_HOME/share/apache-tomcat-<VERSION>/bin/jsvc注記JWS_HOME/share/apache-tomcat- <VERSION> /bin/jsvcはJWS_HOME/sbin/jsvcへのシンボリックリンクです。
-
5.1. Jsvc を使用した Tomcat の起動 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Enterprise Linux で Jsvc を使用した Tomcat の起動
以下のコマンドを実行して、Red Hat Enterprise Linux で Jsvc を使用して Tomcat を起動します。
JWS_HOME/tomcat<VERSION>/bin/daemon.sh start
JWS_HOME/tomcat<VERSION>/bin/daemon.sh start
Solaris での Jsvc を使用した Tomcat の起動
以下のコマンドを実行し、Solaris で Jsvc を使用して Tomcat を起動します。
JWS_HOME/share/tomcat<VERSION>/bin/daemon.sh start
JWS_HOME/share/tomcat<VERSION>/bin/daemon.sh start
5.2. Jsvc を使用した Tomcat の停止 リンクのコピーリンクがクリップボードにコピーされました!
Stop Tomcat Using Jsvc on Red Hat Enterprise Linux
以下のコマンドを実行して、Red Hat Enterprise Linux で Jsvc を使用して開始された Tomcat を停止します。
JWS_HOME/tomcat<VERSION>/bin/daemon.sh stop
JWS_HOME/tomcat<VERSION>/bin/daemon.sh stop
Solaris での Jsvc を使用した Tomcat の停止
以下のコマンドを実行して、Solaris で Jsvc を使用して起動した Tomcat を停止します。
JWS_HOME/share/tomcat<VERSION>/bin/daemon.sh stop
JWS_HOME/share/tomcat<VERSION>/bin/daemon.sh stop
5.3. Jsvc パラメーター リンクのコピーリンクがクリップボードにコピーされました!
daemon.sh スクリプトの実行時に以下のパラメーターを設定できます。
| パラメーター名 | Environment Variable | デフォルト値 | 詳細 |
|---|---|---|---|
|
|
|
| Java ホームディレクトリーの場所。 |
|
|
| スクリプトの場所により決定されます。 | Tomcat インストールディレクトリーの場所。 |
|
|
|
| 複数のサーバーが同じインストールを使用している場合は、特定の設定および設定情報が含まれるディレクトリー。 |
|
| - |
| Tomcat の実行中のインスタンスのプロセス ID(PID)が保存されるファイル。 |
|
| - |
| Tomcat が使用するユーザー。 |
|
| - |
|
第6章 JBoss Web Server の Hibernate リンクのコピーリンクがクリップボードにコピーされました!
Hibernate はオブジェクト関係マッピングフレームワークです。これは JBoss Web Server とは別にパッケージ化されます。このパッケージバージョンは、サポートされるすべてのプラットフォームで使用されます。
Hibernate は、通常の Tomcat インストールに使用されるのと同じ方法で使用されます。Hibernate JAR ファイルはデプロイメント WAR ファイルに追加されます。Tomcat は、context.xml で定義されるデフォルトの接続プールメカニズムを提供します。ただし、persistence.xml および web.xml も必要になります。以下の例は、Tomcat 接続プールメカニズムの設定を示しています。
/META-INF/context.xmlは Tomcat が作成する接続プールを定義します。context.xml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /WEB-INF/classes/META-INF/persistence.xmlは JPA 設定ファイルです。これは、アプリケーションが Tomcat プールからの接続を消費するように Hibernate を設定する方法を定義します。Hibernate API を直接使用する場合は、hibernate.cfg.xmlに表示される同様の設定を使用します。persistence.xml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow /WEB-INF/web.xmlは通常の Web アプリケーションのデプロイメントファイルで、使用するデータソースを Tomcat に指示します。以下の例では、データソースはjdbc/DsWebAppDBです。web.xml
Copy to Clipboard Copied! Toggle word wrap Toggle overflow
詳細は、JBoss Web Server の Hibernate ドキュメント を参照してください。
第7章 JBoss Operations Network(ON)を使用した JBoss Web Server の監視 リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server は Red Hat JBoss Operations Network(JBoss ON)によって監視および管理できます。
JBoss ON を使用して JBoss Web Server を監視するには、JBoss ON サーバーに Web Server Plugin Pack をインストールし、JBoss Web Server で Tomcat を監視するように設定する必要があります。
7.1. JBoss ON の Web サーバープラグインパックのダウンロード リンクのコピーリンクがクリップボードにコピーされました!
JBoss ON を使用して JBoss Web Server を監視するには、まず Web Server プラグインパック を JBoss ON サーバーにダウンロードしてインストールする必要があります。
- Web ブラウザーを開き、Red Hat カスタマーポータル( http://access.redhat.com )にログインします。
- ダウンロードをクリックします。
- 製品のダウンロード リストの Red Hat JBoss Web Server をクリックします。
- Product ドロップダウンメニューで JBoss ON for Web Server を選択します。
- リストで Red Hat JBoss Operations Network の Web Server プラグインパック を見つけ、Download をクリックします。
JBoss ON サーバーにプラグインをインストールする方法については、JBoss ON ドキュメントを参照してください。
7.2. JBoss ON Monitoring 用の Tomcat の設定 リンクのコピーリンクがクリップボードにコピーされました!
JBoss ON が JBoss Web Server で Tomcat を監視できるようにするには、JBoss ON 検出を許可するように Tomcat を設定し、JBoss ON に必要なアクセスを提供する必要があります。
Linux オペレーティングシステムでのユーザーパーミッションの設定
Microsoft Windows の場合は、この手順を省略し、JBoss ON Monitoring の Tomcat の設定に進みます。
JBoss ON エージェントには、Tomcat ディレクトリーへの読み取りおよび書き込みパーミッションが必要です。root 権限を持つユーザーとして以下のコマンドを実行し、JBoss ON Agent を実行するユーザーを tomcat グループに追加します。
usermod -aG tomcat <JBOSSON_AGENT_USER>
# usermod -aG tomcat <JBOSSON_AGENT_USER>
JBoss ON Monitoring 用の Tomcat の設定
JBoss Web Server インスタンスは、Linux プラットフォームおよび Unix プラットフォームで自動検出されます。ただし、認証と正確な Tomcat 監視を適切に処理できるように、インスタンスの JMX を設定する必要があります。
認証を処理するように JMX を設定するには、以下を行います。
編集する JBoss Web Server インスタンスの
startupまたはsetenvファイルを開きます。-
ZIP ファイルからインストールされた Red Hat Enterprise Linux で、
JWS_HOME/tomcat <VERSION> /bin/setenv.shを開きます。 -
RPM からインストールした Red Hat Enterprise Linux で、
/usr/sbin/tomcat <VERSION> を開きます。 -
Microsoft Windows で
JWS_HOME\share\tomcat <VERSION> \bin\setenv.batを開いてください。 -
daemon.shを使用して Tomcat を起動する Solaris でJWS_HOME/tomcat <VERSION> /bin/setenv.shを開きます。
-
ZIP ファイルからインストールされた Red Hat Enterprise Linux で、
JMX 監視に使用できるポートを定義します。ポートがファイアウォールによってブロックされていないことを確認します。
Red Hat Enterprise Linux および Solaris の場合:
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.port=PORT_NUMBER -Djava.rmi.server.hostname=IP_ADDRESS"JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.port=PORT_NUMBER -Djava.rmi.server.hostname=IP_ADDRESS"Copy to Clipboard Copied! Toggle word wrap Toggle overflow Microsoft Windows の場合:
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.port=PORT_NUMBER -Djava.rmi.server.hostname=IP_ADDRESS"
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.port=PORT_NUMBER -Djava.rmi.server.hostname=IP_ADDRESS"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
実稼働環境では、以下の行を起動ファイルの JAVA_OPTS 変数に追加し、SSL で JMX をセキュアにし、ファイアウォールでアクセスを制限します。
Red Hat Enterprise Linux および Solaris の場合:
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.access.file=JWS_HOME/jmxremote.access" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.password.file=JWS_HOME/jmxremote.password"JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.access.file=JWS_HOME/jmxremote.access" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.password.file=JWS_HOME/jmxremote.password"Copy to Clipboard Copied! Toggle word wrap Toggle overflow Microsoft Windows の場合:
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.access.file=JWS_HOME\jmxremote.access" set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.password.file=JWS_HOME\jmxremote.password"
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.access.file=JWS_HOME\jmxremote.access" set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.password.file=JWS_HOME\jmxremote.password"Copy to Clipboard Copied! Toggle word wrap Toggle overflow
注記開発目的で認証および SSL を無効にする場合は、スタートアップファイルの JAVA_OPTS 変数に以下の行を追加します。
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.ssl=false" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.authenticate=false"JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.ssl=false" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.authenticate=false"Copy to Clipboard Copied! Toggle word wrap Toggle overflow Tomcat サーバーリソースを検出し、JBoss ON インベントリーにインポートしたら、新しいリソースの接続設定を更新する必要がある場合があります。
- JBoss ON インターフェースでは、新たにインポートされた Tomcat サーバーリソースの Connection Settings。
Manager URL プロパティーの値を RMI URL に確認し、Tomcat サーバー起動ファイルで定義されている正しい JMX ホスト名とポート番号を使用していることを確認します。この値の例を以下に示します。
service:jmx:rmi:///jndi/rmi://$IP_ADDRESS:$PORT/jmxrmi
service:jmx:rmi:///jndi/rmi://$IP_ADDRESS:$PORT/jmxrmiCopy to Clipboard Copied! Toggle word wrap Toggle overflow
7.2.1. RPM から Tomcat Installed の JBoss ON Monitoring の設定 リンクのコピーリンクがクリップボードにコピーされました!
- シェルプロンプトでは、root ユーザーになります。
start セクションおよび
セクションのstart-security/usr/sbin/tomcat <VERSION>ファイルで JMX JAVA_OPTS プロパティーを設定します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 以下のコマンドを実行して Tomcat を起動します。
service tomcat<VERSION> start
service tomcat<VERSION> startCopy to Clipboard Copied! Toggle word wrap Toggle overflow - JBoss ON エージェントを起動します。
- JBoss ON Web UI で、JBoss ON エージェントおよび Tomcat をインポートします。
- JBoss ON Web UI で、Tomcat 接続設定(プリンシパルおよび認証情報)を設定します。
JBoss ON Web UI で、Tomcat コントロール メソッド設定を RPM System V init スクリプト に設定します。
注記Tomcat プラグインは RPM System V init スクリプト設定に対して
サービス tomcat <VERSION > start/stopコマンドを常に実行されるため、Start スクリプトおよび Shutdown スクリプト 設定は設定されません。
7.2.2. Windows サービスとしてインストールされた Tomcat の JBoss ON Monitoring の設定 リンクのコピーリンクがクリップボードにコピーされました!
-
C:\jmxディレクトリーにcontrolRole readwriteでjmxremote.accessファイルを作成します。 C:\jmxディレクトリーにcontrolRole pwdを指定してjmxremote.passwordファイルを作成します。注記jmxremote.accessおよびjmxremote.passwordの所有者を SYSTEM に設定し、jmxremote.passwordのアクセスを SYSTEM だけに制限します。SYSTEM ユーザーは読み取りアクセスのみを持っている必要があります。Tomcat Windows サービスで JMX を有効にします。
JWS_HOME\sbin\tomcat<VERSION>.exe //US//Tomcat<VERSION> ++JvmOptions="-Dcom.sun.management.jmxremote.port=8100;-Dcom.sun.management.jmxremote.access.file="C:\jmx\jmxremote.access";-Dcom.sun.management.jmxremote.password.file="C:\jmx\jmxremote.password";-Dcom.sun.management.jmxremote.ssl=false;-Dcom.sun.management.jmxremote.authenticate=true"
JWS_HOME\sbin\tomcat<VERSION>.exe //US//Tomcat<VERSION> ++JvmOptions="-Dcom.sun.management.jmxremote.port=8100;-Dcom.sun.management.jmxremote.access.file="C:\jmx\jmxremote.access";-Dcom.sun.management.jmxremote.password.file="C:\jmx\jmxremote.password";-Dcom.sun.management.jmxremote.ssl=false;-Dcom.sun.management.jmxremote.authenticate=true"Copy to Clipboard Copied! Toggle word wrap Toggle overflow - Tomcat Windows サービスを起動し、それが稼働していることを確認します。
-
JBoss ON エージェントをインストールして設定します。エージェントプロンプトで
discoveryと入力して、Tomcat Windows サービスを検出します。 - JBoss ON Web UI で Inventory をクリックし、Discovery Queue をクリックし、import Tomcat および RHQ エージェント を選択します。
- JBoss ON Web UI で、プラットフォーム に移動 し、エージェント名を検索します。エージェントをクリックします。
- Agent ページで、Tomcat Server が一覧表示されます。Tomcat サーバーをクリックして選択します。
- JBoss ON Web UI で Inventory タブをクリックしてから、Connection Settings で Tomcat Server を設定します。
-
Principal および Credentials 情報を入力します。
jmxremoteファイルに設定されているcontrolRoleおよび password を使用します。 制御メソッドを RPM System V init スクリプト に設定します。
注記Start および Shutdown スクリプトフィールドは設定できません。
- 保存 をクリックします。
- Tomcat Server JVM の接続設定を更新し、Principal および Credentials を設定します。
第8章 Red Hat JBoss Web Server 3 でのパスワード vault の使用 リンクのコピーリンクがクリップボードにコピーされました!
8.1. Red Hat JBoss Web Server 3 でのパスワード vault の使用 リンクのコピーリンクがクリップボードにコピーされました!
パスワード vault は、パスワードやその他の機密文字列をマスクし、暗号化された Java キーストアに保存するために使用されます。Tomcat は vault を使用してキーストアからパスワードやその他の機密文字列を検索することができるため、Tomcat 設定ファイルにクリアテキストのパスワードの保存をなくすことができます。
以下の例とコマンドは、JWS_HOME を JBoss Web Server インストールディレクトリーとして使用します。JWS_HOME を JBoss Web Server インストールへのパスに置き換えます。また、以下のパスではディレクトリー区切り文字として / が使用されます。
8.1.1. JBoss Web Server パスワード vault のインストール リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server パスワード vault をインストールする方法は 2 つあります。
-
RPM から Red Hat Enterprise Linux に JBoss Web Server パスワード vault をインストールする(
yumを 使用して JBoss Web Server がインストールされている Red Hat Enterprise Linux システムの場合)。 - .zip アーカイブからの Vault ファイルのダウンロードおよび 拡張(すべての JBoss Web Server インストールに利用可能)
8.1.1.1. RPM からの Red Hat Enterprise Linux への JBoss Web Server パスワード vault のインストール リンクのコピーリンクがクリップボードにコピーされました!
JBoss Web Server が Red Hat Enterprise Linux の RPM からインストールされている場合は、以下のコマンドを実行してパスワード vault を root ユーザーとしてインストールします。
yum install tomcat-vault tomcat-vault-tomcat<VERSION>
yum install tomcat-vault tomcat-vault-tomcat<VERSION>
ここで 、<VERSION > は tomcat 7 (tomcat-vault-tomcat7)または tomcat 8 (tomcat-vault-tomcat8)の場合は 8 になります。
tomcat-vault RPM インストールでは、vault jar は /usr/share/java/vault-tomcat- <VERSION> -jar-with-dependencies.jar にあります。この jar は JWS zip インストールで使用できます( JWS_HOME/tomcat_<VERSION>_/lib/ の場合は JWS RPM インストールの場合: /usr/share/tomcat<VERSION>/lib )。
8.1.1.2. .zip アーカイブからの Vault ファイルのダウンロードおよび拡張 リンクのコピーリンクがクリップボードにコピーされました!
- Tomcat が実行されている場合は停止します。
-
vault zip の内容を
JWS_HOMEディレクトリーに展開します。このトピックでは、JWS_HOME/tomcat-vaultは展開した vault ディレクトリーを参照します。 -
JWS_HOME/tomcat-vault/modules/system/layers/base/tomcat-vault/main/tomcat-vault.jarをJWS_HOME/tomcat<VERSION>/lib/にコピーします。JWS_HOME/tomcat<VERSION>/conf/catalina.propertiesを編集し、以下の行を追加します。
org.apache.tomcat.util.digester.PROPERTY_SOURCE=org.apache.tomcat.vault.util.PropertySourceVault
org.apache.tomcat.util.digester.PROPERTY_SOURCE=org.apache.tomcat.vault.util.PropertySourceVault
8.1.2. Java キーストアの作成 リンクのコピーリンクがクリップボードにコピーされました!
パスワード vault を使用するには、最初に Java キーストアを作成する必要があります。これは、keytool -genseckey コマンドを使用して実行できます。以下に例を示します。
keytool -genseckey -keystore JWS_HOME/tomcat/vault.keystore -alias my_vault -storetype jceks -keyalg AES -keysize 128 -storepass <vault_password> -keypass <vault_password> -validity 730
$ keytool -genseckey -keystore JWS_HOME/tomcat/vault.keystore -alias my_vault -storetype jceks -keyalg AES -keysize 128 -storepass <vault_password> -keypass <vault_password> -validity 730
上記の値は例です。ご使用の環境に固有の値に置き換えてください。
パラメーターの説明は、keytool -genseckey -help コマンドを使用します。
8.1.3. JWS_HOME ディレクトリー外での tomcat-vault vault.properties ファイルの保存 リンクのコピーリンクがクリップボードにコピーされました!
この機能は JBoss Web Server 3.1 Service Pack 2 によって導入されました。
tomcat-vault の vault.properties ファイルは、CATALINA_BASE/conf/ ディレクトリーの JWS_HOME/tomcat<VERSION>/conf/ の外に保存できます(設定されている場合)。
CATALINA_BASE ディレクトリーを設定するには、Apache Tomcat Web サイトにある『 Running The Apache Tomcat 8.0 Servlet/JSP Container』の「Advanced Configuration - Multiple TomcatInstances 」セクションの説明に従います。
CATALINA_BASE のデフォルトの場所は JWS_HOME/tomcat<VERSION& gt;/(別名 CATALINA_HOME)です。
CATALINA_BASE の設定に関する詳細は、以下を参照してください。
8.1.4. パスワード vault の初期化 リンクのコピーリンクがクリップボードにコピーされました!
vault は機密文字列の保存に使用する前に初期化する必要があります。これは、JWS_HOME/tomcat-vault/bin/tomcat-vault.sh vault スクリプトを使用して行われます。Microsoft Windows の場合、スクリプトは tomcat-vault.bat です。
スクリプトは対話的または非対話的に実行できます。以下は、前の手順でキーストアの例を使用して、パスワード vault を初期化するスクリプトのインタラクティブな実行例です。
8.1.4.1. Apache Tomcat の Vault の対話的な初期化 リンクのコピーリンクがクリップボードにコピーされました!
以下の値は例としてのみ使用されます。ご使用の環境に適切な値に置き換えてください。
Tomcat プロパティーファイルの出力に注意してください。これは、Tomcat が vault を使用するように設定する必要があるためです。
パスワード vault を使用するように Tomcat を設定する
JWS_HOME/tomcat<VERSION>/conf/ で、vault の初期化時に生成された vault 設定を含む vault.properties という名前のファイルを作成します。以下の値は、前の手順で初期化された vault の例を使用します。
KEYSTORE_PASSWORD には vault の初期化時に生成されたマスクされた値を使用する必要があります。
8.1.4.2. Apache Tomcat の Vault の非対話的な初期化 (サイレント設定) リンクのコピーリンクがクリップボードにコピーされました!
Apache Tomcat の Vault は、tomcat-vault.sh スクリプトに必要な入力を引数として提供して非対話的に作成できます。vault.properties ファイルは、-g, --generate-config オプションが使用される場合に tomcat-vault.sh スクリプトの出力としても作成されます。
以下の値は例としてのみ使用されます。ご使用の環境に適切な値に置き換えてください。
8.1.5. パスワード Vault への Sensitive 文字列の格納 リンクのコピーリンクがクリップボードにコピーされました!
前の手順で使用した vault スクリプトは、機密文字列をパスワード vault に保存するためにも使用されます。スクリプトは対話的または非対話的に実行できます。
文字列をパスワード vault に追加する場合、機密文字列には参照される名前が必要です。パスワード vault では、この名前は attribute name と呼ばれ、パスワード自体は secured attribute と呼ばれます。
以下の例は、vault スクリプトを非対話的に使用してパスワードを保存する方法を示しています。前の手順で初期化された vault を使用し、機密文字列 P@SSW0#D を属性名 manager_password で保存します。
JWS_HOME/tomcat-vault/bin/tomcat-vault.sh --keystore JWS_HOME/tomcat-vault/vault.keystore --keystore-password <vault_password> --alias my_vault --enc-dir JWS_HOME/tomcat-vault/ --iteration 120 --salt 1234abcd --vault-block my_block --attribute manager_password --sec-attr P@SSW0#D
$ JWS_HOME/tomcat-vault/bin/tomcat-vault.sh --keystore JWS_HOME/tomcat-vault/vault.keystore --keystore-password <vault_password> --alias my_vault --enc-dir JWS_HOME/tomcat-vault/ --iteration 120 --salt 1234abcd --vault-block my_block --attribute manager_password --sec-attr P@SSW0#D
オプションで、パスワードを保存する vault ブロックを指定できます。ブロックを指定しないと、自動的に作成されます。上記の例では、my_block が使用されます。
8.1.6. Tomcat 設定で保存された機密文字列の使用 リンクのコピーリンクがクリップボードにコピーされました!
パスワード vault に機密文字列を保存したら、保存された文字列の属性を ${VAULT::block_name::attribute_name::} として入力して設定ファイルで参照できます。
たとえば、前の手順で保存されたパスワードを使用するには、以下を置き換えます。
<user username="manager" password="P@SSW0#D" roles="manager-gui"/>
<user username="manager" password="P@SSW0#D" roles="manager-gui"/>
上記の行を、以下のように置き換えます。
<user username="manager" password="${VAULT::my_block::manager_password::}" roles="manager-gui"/>
<user username="manager" password="${VAULT::my_block::manager_password::}" roles="manager-gui"/>
その結果、Tomcat 設定ファイルに、パスワードへの参照のみが表示され、実際のパスワードはパスワード vault にのみ保存されます。
第9章 WebSocket を使用した JWS クライアントサーバー通信の設定 リンクのコピーリンクがクリップボードにコピーされました!
9.1. WebSocket について リンクのコピーリンクがクリップボードにコピーされました!
WebSocket は、双方向で完全な duplex メッセージを提供し、1 つの TCP ソケット接続上でクライアントとサーバー間で即時に分散される Web 技術です。完全な duplex 通信は、双方向通信を同時に許可します。
コンテナーは WebSockets 1.0 JSR 356 API の実装を提供します。API を使用するには、Java 7 以降を実行し、Web コンテナーの APR または NIO2 HTTP/1.1 コネクターを設定する必要があります。
JSR 356 は、Java 向け WebSocket API の標準です。開発者は JSR 356 API を使用して、実装とは関係なく WebSocket アプリケーションを作成できます。WebSocket API は純粋にイベント駆動型です。
開発者は、WebSocket 用に JSR 356 Java API を使用して、サーバー側およびクライアント側で WebSocket をアプリケーションに統合できます。Tomcat 7 および 8 は、JSR-356 標準仕様に準拠する WebSocket プロトコルを実装します。
Java クライアントは JSR 356 準拠のクライアント実装を使用して WebSocket サーバーに接続します。Web クライアントでは、WebSocket JavaScript API を使用して WebSocket サーバーと通信できます。WebSocket クライアントとサーバー間の唯一の違いは、WebSocket クライアントと WebSocket サーバーが接続されている方法です。WebSocket クライアントは、ピアへの接続元となる WebSocket ポイントです。WebSocket サーバーはすでにパブリッシュされ、ピアからの接続を待機する WebSocket エンドポイントです。
WebSocket が使用できる例には、銀行、チャット、マルチプレーヤー、ソーシャルネットワークアプリケーションなどがあります。
9.2. Tomcat での WebSocket の実装 リンクのコピーリンクがクリップボードにコピーされました!
Tomcat で WebSocket を設定するには、以下の個別の設定が必要です。
9.2.1. 書き込みタイムアウトの設定 リンクのコピーリンクがクリップボードにコピーされました!
org.apache.tomcat.websocket.BLOCKING_SEND_TIMEOUT プロパティーを使用すると、ブロックモードで書き込みタイムアウトを変更できます。このプロパティーはミリ秒単位の値を受け入れます。デフォルト値は 20000 (20 秒)です。
9.2.2. 着信バイナリーメッセージの設定 リンクのコピーリンクがクリップボードにコピーされました!
受信バイナリーメッセージを設定するには、MessageHandler.Partial を定義する必要があります。MessageHandler.Partial が定義されていない場合は、メッセージ全体が MessageHandler.Whole への単一呼び出しで配信されるように、受信バイナリーメッセージをバッファーする必要があります。
バイナリーメッセージのデフォルトのバッファーサイズは 8192 バイトです。web アプリケーションのバッファーサイズは、サーブレットコンテキストの初期化パラメーター org.apache.tomcat.websocket.binaryBufferSize の値を変更することで変更できます。
9.2.3. 着信テキストメッセージの設定 リンクのコピーリンクがクリップボードにコピーされました!
受信テキストメッセージを設定するには、MessageHandler.Partial を定義する必要があります。MessageHandler.Partial が定義されていない場合、受信メッセージ全体が MessageHandler.Whole への単一呼び出しで配信されるようにバッファーする必要があります。
テキストメッセージのデフォルトのバッファーサイズは 8192 バイトです。web アプリケーションのバッファーサイズは、サーブレットコンテキストの初期化パラメーター org.apache.tomcat.websocket.textBufferSize の値を変更することで変更できます。
9.2.4. 追加のプログラムによるデプロイメントの設定 リンクのコピーリンクがクリップボードにコピーされました!
Java WebSocket 1.0 仕様では、最初のエンドポイントが WebSocket ハンドシェイクを開始した後にプログラムによるデプロイメントが許可されません。ただし、デフォルトで Tomcat では、追加のプログラムによるデプロイメントが可能です。追加のプログラムによるデプロイメントは、サーブレットコンテキスト初期化パラメーター org.apache.tomcat.websocket.noAddAfterHandshake を使用して実行できます。
システムプロパティー org.apache.tomcat.websocket.STRICT_SPEC_COMPLIANCE を true に設定して、デフォルト設定を変更します。
9.2.5. 非同期書き込みのコールバックの設定 リンクのコピーリンクがクリップボードにコピーされました!
非同期書き込みのコールバックは、書き込みを開始したスレッドに対して別のスレッドで実行する必要があります。コンテナースレッドプールは Servlet API 経由で公開されません。そのため、WebSocket の実装は独自のスレッドプールを提供する必要があります。
以下のサーブレットコンテキストの初期化パラメーターは、スレッドプールを制御します。
org.apache.tomcat.websocket.executorCoreSize-
エグゼキュータースレッドプールのコアサイズ。設定されていない場合、デフォルトの
0(ゼロ)が使用されます。 org.apache.tomcat.websocket.executorMaxSize-
エグゼキュータースレッドプールの最大許容サイズ。設定されていない場合は、デフォルトの
10が使用されます。 org.apache.tomcat.websocket.executorKeepAliveTimeSeconds-
アイドルスレッドが終了までエグゼキュータースレッドプールに留まる最大時間。指定のない場合は、デフォルトの
60秒が使用されます。
9.2.6. IO 操作のタイムアウトの設定 リンクのコピーリンクがクリップボードにコピーされました!
接続の確立中の IO 操作のタイムアウトは、提供された javax.websocket.ClientEndpointConfig の userProperties によって制御されます。org.apache.tomcat.websocket.IO_TIMEOUT_MS プロパティーを変更すると、タイムアウトを変更できます。このプロパティーは値をミリ秒単位で受け入れます。デフォルト値は 5000 (5 秒) です。
WebSocket クライアントに接続してサーバーエンドポイントのセキュリティーを保護するには、クライアント SSL 設定は、提供された javax.websocket.ClientEndpointConfig の userProperties によって制御されます。
以下のユーザープロパティーがサポートされます。
-
org.apache.tomcat.websocket.SSL_CONTEXT -
org.apache.tomcat.websocket.SSL_PROTOCOLS -
org.apache.tomcat.websocket.SSL_TRUSTSTORE -
org.apache.tomcat.websocket.SSL_TRUSTSTORE_PWD
デフォルトのトラストストアのパスワードは changeit です。org.apache.tomcat.websocket.SSL_TRUSTSTORE および org.apache.tomcat.websocket.SSL_TRUSTSTORE_PWD プロパティーは、org.apache.tomcat.websocket.SSL_CONTEXT プロパティーが設定されている場合は無視されます。
付録A Java IPv4/IPv6 プロパティー リンクのコピーリンクがクリップボードにコピーされました!
Java プロパティーの設定
Java では、r は IPv4 と IPv6 の設定に使用される 2 つのプロパティーです。これらは java.net.preferIPv4Stack および java.net.preferIPv6Addresses です。
java.net.preferIPv4Stack (default: false)
IPv6 が利用できる場合は、デフォルトで基礎となるネイティブソケットが IPv6 ソケットになります。このソケットにより、アプリケーションが IPv4 および IPv6 ホストからの接続を許可できるようになります。アプリケーションが IPv4 ソケットのみを使用する場合は、このプロパティーを true に設定します。ただし、アプリケーションが IPv6 のみのホストと通信することはできません。
java.net.preferIPv6Addresses (デフォルト: false)
ホストに IPv4 アドレスと IPv6 アドレスの両方があり、IPv6 が利用できる場合には、デフォルトの動作では IPv6 上で IPv4 アドレスを使用します。これにより、後方互換性を維持できます。192.168.1.1. など、IPv4 アドレス表現に依存するアプリケーションの場合、可能な場合は IPv4 で IPv6 アドレスを使用するように、このプロパティーを true に設定します。
これらのプロパティーを Tomcat に渡すには、CATALINA_ HOME /bin/setenv.* ファイルに CATALINA_ OPTSを設定します。
CATALINA_HOME/bin/setenv.sh または CATALINA_HOME/bin/setenv.bat ファイルが存在しない場合は、作成する必要があります。
Linux の場合:
export "CATALINA_OPTS=-Djava.net.preferIPv4Stack=YOUR_VALUE -Djava.net.preferIPv6Addresses=YOUR_VALUE"
Windows の場合:
set "CATALINA_OPTS=-Djava.net.preferIPv4Stack=YOUR_VALUE -Djava.net.preferIPv6Addresses=YOUR_VALUE"
Tomcat バインディングの設定
Tomcat バインディングは、IPv6 アドレスを使用して CATALINA_HOME/conf/server.xml で設定できます。
Tomcat バインディングアドレスを指定します。
<Server … address="TOMCAT_BINDING_ADDRESS">HTTP コネクターアドレスを指定します。
<connector protocol="HTTP/1.1" … address="HTTP_CONNECTOR_ADDRESS">AJP コネクターアドレスを指定します。
<Connector protocol="AJP/1.3" … address="AJP_CONNECTOR_ADDRESS">