Installation Guide

Procedure

1. Open a browser and log in to the Red Hat Customer Portal.
2. Click Downloads.
3. Click Red Hat JBoss Web Server in the Product Downloads list.
4. Select the correct JBoss Web Server version from the Version drop-down menu.

5. Click Download for each of the following files, ensuring that you select the correct platform and architecture for your system:

   • The Red Hat JBoss Web Server 5.6 Application Server (jws-5.6.0-application-server.zip).
   • The Red Hat JBoss Web Server 5.6 Native Components for RHEL (jws-5.6.0-application-server-<platform>-<architecture>.zip).

6. Unzip the downloaded archive files to your installation directory.

   For example:

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

   Copy to Clipboard Toggle word wrap

Procedure

1. To determine which system daemon is running, enter the following command:

   $ ps -p 1 -o comm=

   Copy to Clipboard Toggle word wrap

   If systemd is running, the following output is displayed:

   systemd

   Copy to Clipboard Toggle word wrap

2. To set up the JBoss Web Server for systemd, run the .postinstall.systemd script as the root user:

   # cd JWS_HOME/tomcat
   # sh .postinstall.systemd

   Copy to Clipboard Toggle word wrap

3. To control the JBoss Web Server with systemd, you can perform any of the following steps as the root user:

   • To enable the JBoss Web Server services to start at system startup by using systemd:

     # systemctl enable jws5-tomcat.service

     Copy to Clipboard Toggle word wrap

   • To start the JBoss Web Server by using systemd:

     # systemctl start jws5-tomcat.service

     Copy to Clipboard Toggle word wrap
     Note

     The SECURITY_MANAGER variable is now deprecated for JBoss Web Server configurations that are based on archive file installations. Consider the following deprecation comment:

     # 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

   • To stop the JBoss Web Server by using systemd:

     # systemctl stop jws5-tomcat.service

     Copy to Clipboard Toggle word wrap

   • To verify the status of the JBoss Web Server by using systemd:

     # systemctl status jws5-tomcat.service

     Copy to Clipboard Toggle word wrap
     Note

     Any user can run the status operation.

Procedure

1. Log in to the Red Hat Subscription Management web page.
2. Click the Systems tab.
3. Click the Name of the system that you want to add the subscription to.
4. Change from the Details tab to the Subscriptions tab, then click Attach Subscriptions.
5. Select the check box next to the subscription you want to attach, and then click Attach Subscriptions.

Verification

1. Log in to the Red Hat Subscriptions web page.
2. In the Subscription Name column, click the subscription that you want to select.

3. Under Products Provided, you require both of the following:

   • JBoss Enterprise Web Server
   • Red Hat JBoss Core Services

Procedure

1. To subscribe to the JBoss Web Server CDN repositories for your operating system version, enter the following command:

   # subscription-manager repos --enable <repository>

   Copy to Clipboard Toggle word wrap
   Note

   In the preceding command, replace <repository> with the following values:
   

   • On Red Hat Enterprise Linux 7, replace <repository> with jws-5-for-rhel-7-server-rpms and jb-coreservices-1-for-rhel-7-server-rpms.
   • On Red Hat Enterprise Linux 8, replace <repository> with jws-5-for-rhel-8-x86_64-rpms.

2. To install JBoss Web Server, enter the following command as the root user:

   # yum groupinstall jws5

   Copy to Clipboard Toggle word wrap
   Important

   When you install JBoss Web Server from RPM packages, the JWS_HOME folder is /opt/rh/jws5/root/usr/share.

Procedure

1. To access the Oracle website, open a browser window and enter the following URL:

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

2. Download the Oracle JDK for your operating system and architecture.
3. Double-click the downloaded file to start the installation.
4. Proceed as instructed in the installation window.

Procedure

1. Open a browser and log in to the Red Hat Product Downloads page.
2. In the Product Downloads list, click Red Hat JBoss Web Server.
3. In the Software Downloads page, select the correct JBoss Web Server version from the Version drop-down menu.

4. In the Download File table, click Download next to each of the following files:

   • The Red Hat JBoss Web Server 5.6 Application Server (jws-5.6.0-application-server.zip).

   • The Red Hat JBoss Web Server 5.6 Native Components for Windows Server (jws-5.6.0-application-server-<platform>-<architecture>.zip).

     Note

     Ensure that you select the correct file that matches the platform and architecture in your system.

5. Unzip the downloaded archive files to your installation directory.

Procedure

1. Get the Hibernate JAR files from the JBoss Web Server Maven Repository.
2. Add the Hibernate JAR files to your deployment WAR file.

Procedure

1. Open the /META-INF/context.xml file.

2. Modify the JDBC connection pools that are available to applications.

   For example:

   <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

Procedure

1. Open the /WEB-INF/classes/META-INF/persistence.xml file.

2. Configure Hibernate to consume connections from Tomcat.

   For example:

   <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

Procedure

1. Open the /WEB-INF/web.xml file.

2. Configure JDBC datasources with the resource-env-ref element.

   For example:

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

   The preceding example uses a a jdbc/DsWebAppDB data source.

Procedure

1. Open the JWS_HOME/tomcat/conf/server.xml configuration file.

2. In the server.xml file, add the HTTP/2 upgrade protocol to the connector.

   For example:

   <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

   The server.xml file contains an example connector definition for the APR protocol with the upgrade protocol set to HTTP/2.

   For example:

   <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. To apply the configuration updates, restart the Red Hat JBoss Web Server as the root user.

   • To restart JBoss Web Server on Red Hat Enterprise Linux by using systemd, enter the following command:

     # systemctl restart jws5-tomcat.service

     Copy to Clipboard Toggle word wrap

   • To restart JBoss Web Server on Red Hat Enterprise Linux by using startup.sh, enter the following commands:

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

     Copy to Clipboard Toggle word wrap

   • To restart JBoss Web Server on Microsoft Windows, enter the following command:

     # net restart tomcat9

     Copy to Clipboard Toggle word wrap

Procedure

1. To check that the HTTP/2 protocol is active, enter the following command:

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

   Copy to Clipboard Toggle word wrap
   Note

   In the preceding example, replace <JBoss_Web_Server> with the URI of the modified connector, such as example.com. The port number is dependent on your configuration.

Procedure

1. Stop Tomcat if it is already running.
2. Open the JWS_HOME/tomcat/conf/catalina.properties file.

3. In the catalina.properties file, enter the following line:

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

   Copy to Clipboard Toggle word wrap
   Note

   In the preceding example, replace JWS_HOME with the path to your JBoss Web Server installation. The paths shown in this example use a forward slash (/) for directory separators.

Procedure

1. Go to the JWS_HOME/tomcat/conf/ directory.
2. Create a file named vault.properties.

3. In the vault.properties file, enter the vault configuration properties that you specified when you initialized the password vault for Tomcat.

   For example:

   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

Procedure

1. Open the Tomcat configuration file that contains the sensitive string.

2. Replace the sensitive string with the attribute name for the string, and ensure that you enter the attribute name in the following format: ${VAULT::block_name::attribute_name::}

   For example:

   Consider the following example file entry for the secured string, P@SSW0#D:

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

   Copy to Clipboard Toggle word wrap

   If the secured string, P@SSW0#D, has the attribute name, manager_password, replace the secured string with the following value:

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

   Copy to Clipboard Toggle word wrap