安装指南

步骤

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

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

   • 红帽 JBoss Web 服务器 5.6 应用服务器(jws-5.6.0-application-server.zip)。
   • 用于 RHEL 的 Red Hat JBoss Web Server 5.6 原生组件(jws-5.6.0-application-server-<platform>-<architecture>.zip)。

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

   例如：

   Copy to Clipboard Toggle word wrap

   # unzip jws-5.5.0-application-server.zip -d /opt/
   # unzip -o jws-5.5.0-application-server-<platform>-<architecture>.zip -d /opt/

步骤

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

   Copy to Clipboard Toggle word wrap

   $ ps -p 1 -o comm=

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

   Copy to Clipboard Toggle word wrap

   systemd

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

   Copy to Clipboard Toggle word wrap

   # cd JWS_HOME/tomcat
   # sh .postinstall.systemd

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

   • 使用 systemd 在系统引导时启用 JBoss Web 服务器服务：

     Copy to Clipboard Toggle word wrap

     # systemctl enable jws5-tomcat.service

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

     Copy to Clipboard Toggle word wrap

     # systemctl start jws5-tomcat.service

     注意

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

     Copy to Clipboard Toggle word wrap

     # 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\"""

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

     Copy to Clipboard Toggle word wrap

     # systemctl stop jws5-tomcat.service

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

     Copy to Clipboard Toggle word wrap

     # systemctl status jws5-tomcat.service

     注意

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

步骤

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. 在提供产品 下，您需要以下两个内容：

   • JBoss Enterprise Web Server
   • Red Hat JBoss Core Services

步骤

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

   Copy to Clipboard Toggle word wrap

   # subscription-manager repos --enable <repository>

   注意

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

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

   Copy to Clipboard Toggle word wrap

   # yum groupinstall jws5

   重要

   从 RPM 软件包安装 JBoss Web 服务器时，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. 打开浏览器并登录 红帽产品下载页面。
2. 在产品下载 列表中，点 Red Hat JBoss Web Server。
3. 在 Software Downloads 页面中，从 Version 下拉菜单中选择正确的 JBoss Web Server 版本。

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

   • 红帽 JBoss Web 服务器 5.6 应用服务器(jws-5.6.0-application-server.zip)。

   • 用于 Windows 服务器的 Red Hat JBoss Web Server 5.6 原生组件(jws-5.6.0-application-server-<platform>-<architecture>.zip)。

     注意

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

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

步骤

1. 从 JBoss Web 服务器 Maven 存储库获取 Hibernate JAR 文件。
2. 将 Hibernate JAR 文件添加到您的部署 WAR 文件。

步骤

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

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

   例如：

   Copy to Clipboard Toggle word wrap

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

步骤

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

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

   例如：

   Copy to Clipboard Toggle word wrap

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

步骤

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

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

   例如：

   Copy to Clipboard Toggle word wrap

   <?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>

   注意

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

步骤

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

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

   例如：

   Copy to Clipboard Toggle word wrap

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

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

   例如：

   Copy to Clipboard Toggle word wrap

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

3. 要应用配置更新，请以 root 用户身份重启红帽 JBoss Web 服务器。

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

     Copy to Clipboard Toggle word wrap

     # systemctl restart jws5-tomcat.service

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

     Copy to Clipboard Toggle word wrap

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

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

     Copy to Clipboard Toggle word wrap

     # net restart tomcat9

步骤

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

   Copy to Clipboard Toggle word wrap

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

   注意

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

步骤

1. 如果已经运行，则停止 Tomcat。
2. 打开 JWS_HOME/tomcat/conf/catalina.properties 文件。

3. 在 catalina.properties 文件中，输入以下行：

   Copy to Clipboard Toggle word wrap

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

   注意

   在前面的示例中，将 JWS_HOME 替换为 JBoss Web 服务器安装的路径。本例中显示的路径使用正斜杠(/)作为目录分隔符。

步骤

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

3. 在 vault.properties 文件中，输入您在为 Tomcat 初始化密码 vault 时指定的 vault 配置属性。

   例如：

   Copy to Clipboard Toggle word wrap

   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/

步骤

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

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

   例如：

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

   Copy to Clipboard Toggle word wrap

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

   如果安全字符串 P@SSW0#D 具有属性名称 manager_password，请将受保护的字符串替换为以下值：

   Copy to Clipboard Toggle word wrap

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