安装指南

步骤

1. 打开浏览器并登录 红帽客户门户。
2. 点 Downloads 选项卡。
3. 从产品下载列表中，选择 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&gt ; 文件旁边的 Download。在这种情况下，请确保选择与您的系统平台和架构匹配的正确文件。

   下载的文件名为 jws-6.0.0-optional-native-components- <platform>- &lt;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. 打开浏览器并登录 红帽客户门户。
2. 点 Downloads 选项卡。
3. 从产品下载列表中，选择 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&gt ; 文件旁边的 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 服务器，请以 root 用户身份运行 .postinstall.systemd 脚本：

   # cd JWS_HOME/tomcat
   # sh .postinstall.systemd

   Copy to Clipboard Toggle word wrap

3. 要使用 systemd 控制 JBoss Web 服务器，您可以以 root 用户身份执行以下步骤：

   • 使用 systemd 使 JBoss Web Server 服务在系统启动时启动：

     # systemctl enable jws6-tomcat.service

     Copy to Clipboard Toggle word wrap

   • 使用 systemd 启动 JBoss Web 服务器：

     # systemctl start jws6-tomcat.service

     Copy to Clipboard Toggle word wrap
     注意

     现在，对于基于归档文件安装的 JBoss Web 服务器配置，SECURITY_MANAGER 变量已弃用。请考虑以下弃用注释：

     # 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 服务器：

     # systemctl stop jws6-tomcat.service

     Copy to Clipboard Toggle word wrap

   • 使用 systemd 验证 JBoss Web 服务器的状态：

     # systemctl status jws6-tomcat.service

     Copy to Clipboard Toggle word wrap
     注意

     任何用户都可以 运行状态 操作。

流程

1. 如果 JBoss Web 服务器已在运行，请以 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. 要为 tomcat 组分配一个新的 GID，请以 root 用户身份输入以下命令：

   groupmod -g <new_gid> tomcat

   Copy to Clipboard Toggle word wrap

   例如：

   groupmod -g 410 tomcat

   Copy to Clipboard Toggle word wrap

4. 要为 tomcat 用户分配一个新的 UID，请以 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，并将 &lt ;new_uid& gt; 替换为新的 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，并将 &lt ;new_gid& gt; 替换为新的 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. 要以 tomcat 用户身份重新启动 JBoss Web 服务器，请参阅从存档文件安装时从命令行启动 JBoss Web Server。

流程

1. 登录到 Red Hat Subscription Management 网页。
2. 点 Systems 选项卡。
3. 点击 您要向其添加订阅的系统名称。
4. 从 Details 选项卡更改到 Subscriptions 选项卡，然后单击 Attach Subscriptions。
5. 选中您要附加的订阅旁边的复选框，然后单击 Attach Subscriptions。

验证

1. 登录到 Red Hat Subscriptions 网页。
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& gt; 替换为以下值：
   

   • 在 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 网站，请打开一个浏览器窗口并输入以下 URL：

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

2. 为您的操作系统和架构下载 Oracle JDK。
3. 双击下载的文件开始安装。
4. 按照安装窗口中的指示进行。

流程

1. 打开浏览器并登录 红帽客户门户。
2. 点 Downloads 选项卡。
3. 从产品下载列表中，选择 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. 打开浏览器并登录 红帽客户门户。
2. 点 Downloads 选项卡。
3. 从产品下载列表中，选择 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

   • 要使用 start .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
   注意

   在前面的示例中，将 &lt ;JBoss_Web_Server > 替换为修改后的连接器的 URI，如 example.com。端口号取决于您的配置。

流程

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 服务器安装的路径。本例中显示的路径对目录分隔符使用正斜杠(/)。

步骤

1. 进入 JWS_HOME/tomcat/conf/ 目录。
2. 创建名为 vault.properties 的文件。

3. 在 vault.properties 文件中，输入您在初始化 Tomcat 密码 vault 时指定的 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 脚本的目录：

   • 如果您从存档文件安装了密码库，请转至 JWS_HOME/tomcat/bin 目录。
   • 如果您从 RPM 软件包安装了密码库，请转至 /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 ::attribute_name::}

   例如：

   考虑安全字符串 P@SSW0#D 的以下示例文件条目：

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

   Copy to Clipboard Toggle word wrap

   如果安全字符串 P@SSW0#D，具有属性 name manager_password，将安全字符串替换为以下值：

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

   Copy to Clipboard Toggle word wrap