インストールガイド

手順

1. ブラウザーを開き、Red Hat カスタマーポータル にログインします。
2. Downloads タブをクリックします。
3. Product Downloads リストから Red Hat JBoss Web Server を選択します。
4. Software Downloads ページの Version ドロップダウンリストから、適切な JBoss Web Server バージョンを選択します。

5. Red Hat JBoss Web Server 6.0.0 Application Server ファイルの横にある Download をクリックします。

   ダウンロードしたファイルは、ローカルホストで jws-6.0.0-application-server.zip という名前になります。

6. オペレーティングシステム用のネイティブ JBoss Web Server コンポーネントもダウンロードする場合は、Red Hat JBoss Web Server 6.0.0 Optional Native Components for <platform> <architecture> ファイルの横にある Download をクリックします。このような場合は、システムのプラットフォームとアーキテクチャーに一致する正しいファイルを選択してください。

   ダウンロードされたファイルの名前は jws-6.0.0-optional-native-components-<platform>-<architecture>.zip (例: jws-6.0.0-optional-native-components-RHEL8-x86_64.zip) です。

7. ダウンロードしたアーカイブファイルをインストールディレクトリーに展開します。

   以下に例を示します。

   # unzip jws-6.0.0-application-server.zip -d /opt/
   # unzip -o jws-6.0.0-optional-native-compoonents-<platform>-<architecture>.zip -d /opt/

   Copy to Clipboard Toggle word wrap

手順

1. ブラウザーを開き、Red Hat カスタマーポータル にログインします。
2. Downloads タブをクリックします。
3. Product Downloads リストから Red Hat JBoss Web Server を選択します。
4. Software Downloads ページの Version ドロップダウンリストから、適切な JBoss Web Server バージョンを選択します。
5. Patches タブをクリックします。

6. 最新の Red Hat JBoss Web Server 6.0 Update XX Application Server ファイルの横にある Download をクリックします。

   ダウンロードしたファイルの名前は、ローカルホスト上の jws-6.0.x-application-server.zip です。

7. ご使用のオペレーティングシステムのネイティブ JBoss Web Server コンポーネントもダウンロードする場合は、最新の Red Hat JBoss Web Server 6.0 Update XX Optional Native Components for <platform> <architecture> の横にある Download をクリックします。このような場合は、システムのプラットフォームとアーキテクチャーに一致する正しいファイルを選択してください。

   ダウンロードされたファイルの名前は jws-6.0.x-optional-native-components-<platform>-<architecture>.zip (例: jws-6.0.x-optional-native-components-RHEL8-x86_64.zip) です。

8. ダウンロードしたアーカイブファイルをインストールディレクトリーに展開します。

   以下に例を示します。

   # unzip jws-6.0.x-application-server.zip -d /opt/
   # unzip -o jws-6.0.x-optional-native-compoonents-<platform>-<architecture>.zip -d /opt/

   Copy to Clipboard Toggle word wrap

手順

1. 実行中のシステムデーモンを特定するには、次のコマンドを入力します。

   $ ps -p 1 -o comm=

   Copy to Clipboard Toggle word wrap

   systemd が実行されている場合、次の出力が表示されます。

   systemd

   Copy to Clipboard Toggle word wrap

2. systemd 用に JBoss Web Server をセットアップするには、root ユーザーとして .postinstall.systemd スクリプトを実行します。

   # cd JWS_HOME/tomcat
   # sh .postinstall.systemd

   Copy to Clipboard Toggle word wrap

3. systemd を使用して JBoss Web Server を制御するには、root ユーザーとして次のいずれかの手順を実行できます。

   • systemd を使用してシステムの起動時に JBoss Web Server サービスを起動できるようにするには:

     # systemctl enable jws6-tomcat.service

     Copy to Clipboard Toggle word wrap

   • systemd を使用して JBoss Web Server を起動するには:

     # systemctl start jws6-tomcat.service

     Copy to Clipboard Toggle word wrap
     注記

     SECURITY_MANAGER 変数は、アーカイブファイルのインストールに基づく JBoss Web Server 設定では非推奨になりました。次の非推奨コメントを検討してください。

     # SECURITY_MANAGER has been deprecated. To run tomcat under the Java Security Manager use:
       JAVA_OPTS="-Djava.security.manager -Djava.security.policy==\"$CATALINA_BASE/conf/"catalina.policy\"""

     Copy to Clipboard Toggle word wrap

   • systemd を使用して JBoss Web Server を停止するには:

     # systemctl stop jws6-tomcat.service

     Copy to Clipboard Toggle word wrap

   • systemd を使用して JBoss Web Server のステータスを確認するには:

     # systemctl status jws6-tomcat.service

     Copy to Clipboard Toggle word wrap
     注記

     すべてのユーザーが status 操作を実行できます。

手順

1. JBoss Web Server がすでに実行されている場合は、tomcat ユーザーとして JBoss Web Server を停止します。詳細は、アーカイブファイルからインストールした場合のコマンドラインからの JBoss Web Server の停止 を参照してください。

2. tomcat ユーザーとグループの現在の UID と GID を表示するには、root ユーザーとして次のコマンドを入力します。

   id tomcat

   Copy to Clipboard Toggle word wrap

   前述のコマンドは、ユーザーアカウントとグループの詳細を表示します。以下に例を示します。

   uid=53(tomcat) gid=53(tomcat) groups=53(tomcat)

   Copy to Clipboard Toggle word wrap

3. 新しい GID を tomcat グループに割り当てるには、root ユーザーとして次のコマンドを入力します。

   groupmod -g <new_gid> tomcat

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

   groupmod -g 410 tomcat

   Copy to Clipboard Toggle word wrap

4. 新しい UID を tomcat ユーザーに割り当てるには、root ユーザーとして次のコマンドを入力します。

   usermod -u <new_uid> -g <new_gid> tomcat

   Copy to Clipboard Toggle word wrap

   以下に例を示します。

   usermod -u 401 -g 410 tomcat

   Copy to Clipboard Toggle word wrap

5. ファイルとディレクトリーのアクセス許可を新しい UID に再割り当てするには、root ユーザーとして次のコマンドを入力します。

   # find / -not -path '/proc*' -uid <original_uid> | perl -e '$ug = @ARGV[0]; foreach $fn (<STDIN>) { chomp($fn);$m = (stat($fn))[2];chown($ug,-1,$fn);chmod($m,$fn)}' <new_uid>

   Copy to Clipboard Toggle word wrap

   前述のコマンドで、<original_uid> を古い UID に置き換え、<new_uid> を新しい UID に置き換えます。たとえば、ファイルとディレクトリーのアクセス許可を UID 53 から UID 401 に再割り当てするには、次のコマンドを入力します。

   # find / -not -path '/proc*' -uid 53 | perl -e '$ug = @ARGV[0]; foreach $fn (<STDIN>) { chomp($fn);$m = (stat($fn))[2];chown($ug,-1,$fn);chmod($m,$fn)}' 401

   Copy to Clipboard Toggle word wrap

6. ファイルとディレクトリーのアクセス許可を新しい GID に再割り当てするには、root ユーザーとして次のコマンドを入力します。

   # find / -not -path '/proc*' -gid <original_gid> | perl -e '$ug = @ARGV[0]; foreach $fn (<STDIN>) { chomp($fn);$m = (stat($fn))[2];chown(-1,$ug,$fn);chmod($m,$fn)}' <new_gid>

   Copy to Clipboard Toggle word wrap

   前述のコマンドで、<original_gid> を古い GID に置き換え、<new_gid> を新しい GID に置き換えます。たとえば、ファイルとディレクトリーのアクセス許可を GID 53 から GID 410 に再割り当てするには、次のコマンドを入力します。

   # find / -not -path '/proc*' -gid 53 | perl -e '$ug = @ARGV[0]; foreach $fn (<STDIN>) { chomp($fn);$m = (stat($fn))[2];chown(-1,$ug,$fn);chmod($m,$fn)}' 410

   Copy to Clipboard Toggle word wrap
7. JBoss Web Server を tomcat ユーザーとして再起動するには、アーカイブファイルからインストールされた場合のコマンドラインからの JBoss Web Server の起動 を参照してください。

手順

1. Red Hat Subscription Management Web ページにログインします。
2. System タブをクリックします。
3. サブスクリプションを追加するシステムの Name をクリックします。
4. Details タブから Subscriptions タブに移動してから、Attach Subscriptions をクリックします。
5. アタッチするサブスクリプションの横にあるチェックボックスをオンにしてから、Attach Subscriptions をクリックします。

検証

1. Red Hat サブスクリプション Web ページにログインします。
2. Subscription Name 列で、選択するサブスクリプションをクリックします。

3. Products Provided では、次の両方が必要です。

   • JBoss Enterprise Web Server
   • Red Hat JBoss Core Services

手順

1. ご使用のオペレーティングシステムバージョンの JBoss Web Server CDN リポジトリーにサブスクライブするには、次のコマンドを入力します。

   # subscription-manager repos --enable <repository>

   Copy to Clipboard Toggle word wrap
   注記

   上記のコマンドで、<repository> を次の値に置き換えます。
   

   • Red Hat Enterprise Linux 8 では、<repository> を jws-6-for-rhel-8-x86_64-rpms に置き換えます。
   • Red Hat Enterprise Linux 9 では、<repository> を jws-6-for-rhel-9-x86_64-rpms に置き換えます。

2. JBoss Web Server をインストールするには、root ユーザーとして次のコマンドを入力します。

   # dnf groupinstall jws6

   Copy to Clipboard Toggle word wrap
   重要

   RPM パッケージから JBoss Web Server をインストールする場合、JWS_HOME フォルダーは /opt/rh/jws6/root/usr/share です。

手順

1. Oracle Web サイトにアクセスするには、ブラウザーウィンドウを開き、次の URL を入力します。

   http://www.oracle.com/technetwork/java/javase/downloads/index.html

2. オペレーティングシステムおよびアーキテクチャー用の Oracle JDK をダウンロードします。
3. ダウンロードしたファイルをダブルクリックしてインストールを開始します。
4. インストールウィンドウで指示どおりに続行します。

手順

1. ブラウザーを開き、Red Hat カスタマーポータル にログインします。
2. Downloads タブをクリックします。
3. Product Downloads リストから Red Hat JBoss Web Server を選択します。
4. Software Downloads ページの Version ドロップダウンリストから、適切な JBoss Web Server バージョンを選択します。

5. Red Hat JBoss Web Server 6.0.0 Application Server ファイルの横にある Download をクリックします。

   ダウンロードしたファイルは、ローカルホストで jws-6.0.0-application-server.zip という名前になります。

6. オペレーティングシステム用のネイティブ JBoss Web Server コンポーネントもダウンロードする場合は、Red Hat JBoss Web Server 6.0.0 Optional Native Components for Windows x86_64 ファイルの横にある Download をクリックします。

   ダウンロードされたファイルの名前は、jws-6.0.0-optional-native-components-win6-x86_64.zip です。

7. ダウンロードしたアーカイブファイルをインストールフォルダーに展開します。

手順

1. ブラウザーを開き、Red Hat カスタマーポータル にログインします。
2. Downloads タブをクリックします。
3. Product Downloads リストから Red Hat JBoss Web Server を選択します。
4. Software Downloads ページの Version ドロップダウンリストから、適切な JBoss Web Server バージョンを選択します。
5. Patches タブをクリックします。

6. 最新の Red Hat JBoss Web Server 6.0 Update XX Application Server ファイルの横にある Download をクリックします。

   ダウンロードしたファイルの名前は、ローカルホスト上の jws-6.0.x-application-server.zip です。

7. オペレーティングシステム用のネイティブ JBoss Web Server コンポーネントもダウンロードする場合は、最新の Red Hat JBoss Web Server 6.0 Update XX Optional Native Components for Windows x86_64 ファイルの横にある Download をクリックします。

   ダウンロードしたファイルの名前は jws-6.0.x-optional-native-components-win6-x86_64.zip です。

8. ダウンロードしたアーカイブファイルをインストールフォルダーに展開します。

手順

1. JWS_HOME/tomcat/conf/server.xml 設定ファイルを開きます。

2. コネクター定義で、UpgradeProtocol クラス名が org.apache.coyote.http2.Http2Protocol に設定されていることを確認します。

   以下に例を示します。

   <Connector port="8443" protocol="org.apache.coyote.http11.Http11NioProtocol"
              maxThreads="150" SSLEnabled="true"
              maxParameterCount="1000">
       <UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol" />
       <SSLHostConfig>
           <Certificate certificateKeystoreFile="conf/localhost-rsa.jks"
                        certificateKeystorePassword="changeit"
                        type="RSA" />
       </SSLHostConfig>
   </Connector>

   Copy to Clipboard Toggle word wrap

3. 設定の更新を適用するには、root ユーザーとして Red Hat JBoss Web Server を再起動します。

   • systemd を使用して Red Hat Enterprise Linux で JBoss Web Server を再起動するには、次のコマンドを入力します。

     # systemctl restart jws6-tomcat.service

     Copy to Clipboard Toggle word wrap

   • startup.sh を使用して Red Hat Enterprise Linux で JBoss Web Server を再起動するには、次のコマンドを入力します。

     # JWS_HOME/sbin/shudown.sh
     # JWS_HOME/sbin/startup.sh

     Copy to Clipboard Toggle word wrap

   • Microsoft Windows で JBoss Web Server を再起動するには、次のコマンドを入力します。

     # net restart tomcat10

     Copy to Clipboard Toggle word wrap

手順

1. HTTP/2 プロトコルが有効であることを確認するには、以下のコマンドを入力します。

   $ curl -I http://<JBoss_Web_Server>:8080/

   Copy to Clipboard Toggle word wrap
   注記

   前の例で、<JBoss_Web_Server> を example.com などの変更されたコネクターの URI に置き換えます。ポート番号は設定によって異なります。

手順

1. Tomcat がすでに実行されている場合は停止します。
2. JWS_HOME/tomcat/conf/catalina.properties ファイルを開きます。

3. catalina.properties ファイルに、次の行を入力します。

   org.apache.tomcat.util.digester.PROPERTY_SOURCE=org.apache.tomcat.vault.util.PropertySourceVault

   Copy to Clipboard Toggle word wrap
   注記

   上記の例では、JWS_HOME を JBoss Web Server インストールへのパスに置き換えます。この例に示されているパスでは、ディレクトリー区切り文字にスラッシュ (/) を使用しています。

手順

1. JWS_HOME/tomcat/conf/ ディレクトリーに移動します。
2. vault.properties という名前のファイルを作成します。

3. vault.properties ファイルに、Tomcat のパスワード vault を初期化したときに指定したボールト設定プロパティーを入力します。

   以下に例を示します。

   KEYSTORE_URL=JWS_HOME/tomcat/vault.keystore
   KEYSTORE_PASSWORD=MASK-3CuP21KMHn7G6iH/A3YpM/
   KEYSTORE_ALIAS=my_vault
   SALT=1234abcd
   ITERATION_COUNT=120
   ENC_FILE_DIR=JWS_HOME/tomcat/

   Copy to Clipboard Toggle word wrap

手順

1. tomcat-vault.sh スクリプトが含まれるディレクトリーに移動します。

   • アーカイブファイルからパスワード vault をインストールした場合は、JWS_HOME/tomcat/bin ディレクトリーに移動します。
   • RPM パッケージからパスワード vault をインストールした場合は、/opt/rh/jws6/root/usr/bin ディレクトリーに移動します。

2. 非対話モードで tomcat-vault.sh スクリプトを使用するには、次のコマンドを入力します。

   $ ./tomcat-vault.sh \
    --keystore JWS_HOME/tomcat/vault.keystore \
    --keystore-password <vault_password> \
    --alias my_vault \
    --enc-dir JWS_HOME/tomcat \
    --iteration 120 \
    --salt 1234abcd \
    --vault-block my_block \
    --attribute manager_password \
    --sec-attr P@SSW0#D

   Copy to Clipboard Toggle word wrap

手順

1. 機密文字列を含む Tomcat 設定ファイルを開きます。

2. 機密文字列を文字列の属性名に置き換え、次の形式で属性名を入力してください: ${VAULT::block_name::attribute_name::}

   以下に例を示します。

   セキュリティーで保護された文字列 P@SSW0#D の次のファイルエントリーの例を考えてみましょう。

   <user username="manager" password=*"P@SSW0#D"* roles="manager-gui"/>

   Copy to Clipboard Toggle word wrap

   保護された文字列 P@SSW0#D に属性名 manager_password がある場合、保護された文字列を次の値に置き換えます。

   <user username="manager" password=*"${VAULT::my_block::manager_password::}"* roles="manager-gui"/>

   Copy to Clipboard Toggle word wrap