安装指南

步骤

1. 打开浏览器并登录 红帽客户门户。
2. 点 Downloads 选项卡。
3. 从 Product Downloads 列表中，选择 Red Hat JBoss Web Server。
4. 在 Software Downloads 页面上，从 Version 下拉列表中选择适当的 JBoss Web Server 版本。

5. 点 Red Hat JBoss Web Server 6.1.0 Application Server 文件旁边的 Download。

   下载的文件在本地主机上命名为 jws-6.1.0-application-server.zip。

6. 如果您还想下载适用于您的操作系统的原生 JBoss Web Server 组件，请点击 Red Hat JBoss Web Server 6.1.0 Optional Native Components for < platform> < architecture&gt ; 文件旁边的 Download。在这种情况下，请确保选择与系统的平台和架构匹配的正确文件。

   下载的文件名为 jws-6.1.0-optional-native-components- <platform>- &lt;architecture > .zip （例如： jws-6.1.0-optional-native-components-RHEL8-x86_64.zip）。

7. 将下载的存档文件提取到您的安装目录中。

   例如：

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

   Copy to Clipboard

流程

1. 打开浏览器并登录 红帽客户门户。
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.1 Update XX Application Server 文件旁边的 Download。

   下载的文件在本地主机上命名为 jws-6.1.x-application-server.zip。

7. 如果您还想下载适用于您的操作系统的原生 JBoss Web 服务器组件，请点击最新 Red Hat JBoss Web Server 6.1 Update XX Optional Native Components for < platform> < architecture&gt ; 文件旁边的 Download。在这种情况下，请确保选择与系统的平台和架构匹配的正确文件。

   下载的文件名为 jws-6.1.x-optional-native-components- <platform>-<architecture > .zip （如 jws-6.1.x-optional-native-components-RHEL8-x86_64.zip）。

8. 将下载的存档文件提取到您的安装目录中。

   例如：

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

   Copy to Clipboard

步骤

1. 要确定哪个系统守护进程正在运行，请输入以下命令：

   $ ps -p 1 -o comm=

   Copy to Clipboard

   如果 systemd 正在运行，则会显示以下输出：

   systemd

   Copy to Clipboard

2. 要为 systemd 设置 JBoss Web 服务器，以 root 用户身份运行 .postinstall.systemd 脚本：

   # cd JWS_HOME/tomcat
   # sh .postinstall.systemd

   Copy to Clipboard

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

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

     # systemctl enable jws6-tomcat.service

     Copy to Clipboard

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

     # systemctl start jws6-tomcat.service

     Copy to Clipboard
     注意

     现在，基于归档文件安装的 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

   • 使用 systemd 停止 JBoss Web 服务器：

     # systemctl stop jws6-tomcat.service

     Copy to Clipboard

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

     # systemctl status jws6-tomcat.service

     Copy to Clipboard
     注意

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

流程

1. 如果 JBoss Web Server 已在运行，以 tomcat 用户身份停止 JBoss Web Server。如需更多信息，请参阅从 存档文件安装时从命令行停止 JBoss Web Server。

2. 要查看 tomcat 用户和组的当前 UID 和 GID，请以 root 用户身份输入以下命令：

   id tomcat

   Copy to Clipboard

   前面的命令显示用户帐户和组详细信息。例如：

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

   Copy to Clipboard

3. 要为 tomcat 组分配一个新的 GID，请以 root 用户身份输入以下命令：

   groupmod -g <new_gid> tomcat

   Copy to Clipboard

   例如：

   groupmod -g 410 tomcat

   Copy to Clipboard

4. 要为 tomcat 用户分配一个新的 UID，请以 root 用户身份输入以下命令：

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

   Copy to Clipboard

   例如：

   usermod -u 401 -g 410 tomcat

   Copy to Clipboard

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

   在前面的命令中，将 < 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

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

   在前面的命令中，将 < 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
7. 要以 tomcat 用户身份重启 JBoss Web Server，请参阅 从存档文件 安装时从命令行启动 JBoss Web Server。

流程

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

验证

1. 登录到 Red Hat Subscriptions 网页。
2. 在 Subscription Name 列中，点击您要选择的订阅。

3. 在 Provided 下，您需要以下任一操作：

   • JBoss Enterprise Web Server
   • Red Hat JBoss Core Services

流程

1. 要为您的操作系统版本订阅 JBoss Web Server CDN 软件仓库，请输入以下命令：

   # subscription-manager repos --enable <repository>

   Copy to Clipboard
   注意

   在前面的命令中，将 < 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 服务器，请以 root 用户身份输入以下命令：

   # dnf groupinstall jws6

   Copy to Clipboard
   重要

   从 RPM 软件包安装 JBoss Web 服务器时，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. 从 Product Downloads 列表中，选择 Red Hat JBoss Web Server。
4. 在 Software Downloads 页面上，从 Version 下拉列表中选择适当的 JBoss Web Server 版本。

5. 点 Red Hat JBoss Web Server 6.1.0 Application Server 文件旁边的 Download。

   下载的文件在本地主机上命名为 jws-6.1.0-application-server.zip。

6. 如果您还想下载适用于您的操作系统的原生 JBoss Web Server 组件，请单击 Red Hat JBoss Web Server 6.1.0 Optional Native Components for Windows x86_64 文件旁边的 Download。

   下载的文件名为 jws-6.1.0-optional-native-components-win6-x86_64.zip。

7. 将下载的存档文件提取到您的安装文件夹。

流程

1. 打开浏览器并登录 红帽客户门户。
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.1 Update XX Application Server 文件旁边的 Download。

   下载的文件在本地主机上命名为 jws-6.1.x-application-server.zip。

7. 如果您还想下载适用于您的操作系统的原生 JBoss Web 服务器组件，请单击最新 Red Hat JBoss Web Server 6.1 Update XX Optional Native Components for Windows x86_64 文件旁边的 Download。

   下载的文件名为 jws-6.1.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

3. 要应用任何配置更新，请以 root 用户身份重启 Red Hat JBoss Web Server。

   • 要使用 systemd 在 Red Hat Enterprise Linux 上重启 JBoss Web Server，请输入以下命令：

     # systemctl restart jws6-tomcat.service

     Copy to Clipboard

   • 要使用 start .sh 在 Red Hat Enterprise Linux 上重启 JBoss Web Server，请输入以下命令：

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

     Copy to Clipboard

   • 要在 Windows Server 上重启 JBoss Web Server，请输入以下命令：

     # net restart tomcat10

     Copy to Clipboard

步骤

1. 要检查 HTTP/2 协议是否活跃，请输入以下命令：

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

   Copy to Clipboard
   注意

   在前面的示例中，将 &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
   注意

   在前面的示例中，将 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

流程

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

步骤

1. 打开包含敏感字符串的 Tomcat 配置文件。

2. 将敏感字符串替换为字符串的属性名称，并确保以以下格式输入属性名称 ：${VAULT::block_name::attribute_name::}

   例如：

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

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

   Copy to Clipboard

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

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

   Copy to Clipboard