安装指南

步骤

1. 打开浏览器并登录 红帽客户门户。
2. 点 Downloads。
3. 点 产品下载 列表中的 Red Hat JBoss Web Server。
4. 从 Version 下拉菜单中选择正确的 JBoss Web Server 版本。

5. 为以下每个文件点 Download，确保为您的系统选择正确的平台和架构：

   • Red Hat JBoss Web Server 5.8 Application Server (jws-5.8.0-application-server.zip)。
   • 用于 RHEL 的 Red Hat JBoss Web Server 5.8 原生组件(jws-5.8.0-application-server- <platform> - <architecture>.zip)。

6. 将下载的存档文件解压缩到您的安装目录中。

   例如：

   # unzip jws-5.8.0-application-server.zip -d /opt/
   # unzip -o jws-5.8.0-application-server-<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 jws5-tomcat.service

     Copy to Clipboard Toggle word wrap

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

     # systemctl start jws5-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 jws5-tomcat.service

     Copy to Clipboard Toggle word wrap

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

     # systemctl status jws5-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 7 上，将 <repository > 替换为 jws-5-for-rhel-7-server-rpms 和 jb-coreservices-1-for-rhel-7-server-rpms。
   • 在 Red Hat Enterprise Linux 8 上，将 <repository > 替换为 jws-5-for-rhel-8-x86_64-rpms。
   • 在 Red Hat Enterprise Linux 9 上，将 <repository > 替换为 jws-5-for-rhel-9-x86_64-rpms。

2. 要安装 JBoss Web Server，请以 root 用户身份输入以下命令：

   # yum groupinstall jws5

   Copy to Clipboard Toggle word wrap
   重要

   从 RPM 软件包安装 JBoss Web Server 时，JWS_HOME 文件夹为 /opt/rh/jws5/root/usr/share。

步骤

1. 要访问 Oracle 网站，请打开一个浏览器窗口并输入以下 URL：

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

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

步骤

1. 打开浏览器并登录到 Red Hat Product Downloads 页面。
2. 在产品下载 列表中，单击 Red Hat JBoss Web Server。
3. 在 Software Downloads 页面中，从 Version 下拉菜单中选择正确的 JBoss Web Server 版本。

4. 在 Download File 表中，点以下每个文件旁的 Download ：

   • Red Hat JBoss Web Server 5.8 Application Server (jws-5.8.0-application-server.zip)。

   • Red Hat JBoss Web Server 5.8 Native Components for Windows Server (jws-5.8.0-application-server- <platform> - <architecture>.zip)。

     注意

     确保您选择了与系统中的平台和架构匹配的正确文件。

5. 将下载的存档文件解压缩到您的安装目录中。

流程

1. 根据您要使用的 Maven 存储库，从 jboss-web-server-X.X.x-maven-repository.zip 或 https://maven.repository.redhat.com/ga/ 获取 Hibernate JAR 文件。
2. 将 Hibernate JAR 文件添加到您的部署 WAR 文件中。

步骤

1. 打开 /META-INF/context.xml 文件。

2. 修改可供应用使用的 JDBC 连接池。

   例如：

   <Context>
     <Resource
       name="jdbc/DsWebAppDB"
       auth="Container"
       type="javax.sql.DataSource"
       username="sa"
       password=""
       driverClassName="org.h2.Driver"
       url="jdbc:h2:mem:target/test/db/h2/hibernate"
       maxActive="8"
       maxIdle="4"/>
   </Context>

   Copy to Clipboard Toggle word wrap

步骤

1. 打开 /WEB-INF/classes/META-INF/persistence.xml 文件。

2. 配置 Hibernate 以消耗来自 Tomcat 的连接。

   例如：

   <persistence version="1.0"
     xmlns="http://java.sun.com/xml/ns/persistence" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
     xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd">
   
     <persistence-unit name="dswebapp">
       <provider>org.hibernate.ejb.HibernatePersistence</provider>
       <properties>
         <property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect" />
         <property name="hibernate.connection.datasource" value="java:comp/env/jdbc/DsWebAppDB"/>
       </properties>
     </persistence-unit>
   </persistence>

   Copy to Clipboard Toggle word wrap

步骤

1. 打开 /WEB-INF/web.xml 文件。

2. 使用 resource-env-ref 元素配置 JDBC datasources。

   例如：

   <?xml version="1.0" encoding="UTF-8"?>
   <web-app version="2.5" xmlns="http://java.sun.com/xml/ns/javaee"
     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
     http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd">
   
    <resource-env-ref>
     <resource-env-ref-name>jdbc/DsWebAppDB</resource-env-ref-name>
     <resource-env-ref-type>javax.sql.DataSource</resource-env-ref-type>
    </resource-env-ref>
   </web-app>

   Copy to Clipboard Toggle word wrap
   注意

   前面的示例使用 jdbc/DsWebAppDB 数据源。

步骤

1. 打开 JWS_HOME/tomcat/conf/server.xml 配置文件。

2. 在 server.xml 文件中，将 HTTP/2 升级协议添加到连接器中。

   例如：

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

   Copy to Clipboard Toggle word wrap

   server.xml 文件包含 APR 协议的一个连接器定义示例，并将升级协议设置为 HTTP/2。

   例如：

   <Connector port="8443"
              protocol="org.apache.coyote.http11.Http11AprProtocol"
              maxThreads="150" SSLEnabled="true" >
       <UpgradeProtocol className="org.apache.coyote.http2.Http2Protocol" />
       <SSLHostConfig>
           <Certificate certificateKeyFile="conf/localhost-rsa-key.pem"
                        certificateFile="conf/localhost-rsa-cert.pem"
                        certificateChainFile="conf/localhost-rsa-chain.pem"
                        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 jws5-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 tomcat9

     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/jws5/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