Installation Guide

1. Download the Oracle JDK for your operating system and architecture. You can download the JDK installation file from the Oracle website: http://www.oracle.com/technetwork/java/javase/downloads/index.html.
2. Double-click the downloaded file to start the installation.
3. Proceed as instructed in the installation window.

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.5 Application Server (jws-5.5.0-application-server.zip).
   • The Red Hat JBoss Web Server 5.5 Native Components for Windows Server (jws-5.5.0-application-server-<platform>-<architecture>.zip).
6. Unzip the downloaded archive files to your installation directory.

Setting Environment Variables

1. Log in to an account with local administrator permissions.
2. Go to Control Panel → System.
3. Click on the Advanced tab.
4. Click the Environment Variables button.
5. Click the New button for System Variables.
6. For JAVA_HOME, TMP, and TEMP, enter the appropriate name-value pairs for your system.
7. For the SSL Connector to work, you will also need to add JWS_HOME\bin to the PATH environment variable of the user that the services will run under. This user is SYSTEM by default.

Installing the Tomcat Service

1. Open a command prompt with administrator privileges and change to the bin folder for your Tomcat version:

   cd /D "JWS_HOME\tomcat\bin"

   Copy to Clipboard Toggle word wrap

2. Install the Tomcat service with the following command:

   call service.bat install

   Copy to Clipboard Toggle word wrap

1. Right-click the JWS_HOME folder and click Properties.
2. Select the Security tab.
3. Click the Edit button.
4. Click the Add button.
5. In the text box, enter LOCAL SERVICE.
6. Select the Full Control check box for the LOCAL SERVICE account.
7. Click OK.
8. Click the Advanced button.
9. Inside the Advanced Security Settings dialog, select LOCAL SERVICE and click Edit.
10. Select the check box next to the Replace all existing inheritable permissions on all descendants with inheritable permissions from this object option.
11. Click OK through all the open folder property windows to apply the settings.

Starting JBoss Web Server from a Command Prompt

1. Open a command prompt with administrator privileges.

2. Start the Tomcat service:

   net start tomcat9

   Copy to Clipboard Toggle word wrap

Starting JBoss Web Server from the Computer Management Tool

1. Go to Start → Administrative Tools → Services.
2. In the Services list, right-click the name of the service (Tomcat9) and click Start.

Stopping JBoss Web Server from a Command Prompt

1. Open a command prompt with administrator privileges.

2. Stop the Tomcat service:

   net stop tomcat9

   Copy to Clipboard Toggle word wrap

Stopping JBoss Web Server from the Computer Management Tool

1. Go to Start → Administrative Tools → Services.
2. In the Services list, right-click the name of the service (Tomcat9) and click Stop.

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 your deployment’s /META-INF/context.xml file for editing.

2. Modify the JDBC connection pools available to applications, as in the following 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 your deployment’s /WEB-INF/classes/META-INF/persistence.xml file for editing.

2. Configure how Hibernate consumes connections from the Tomcat, as in the following 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 your deployment’s /WEB-INF/web.xml file for editing.

2. Configure JDBC datasources with the resource-env-ref element, as in the following example that uses a jdbc/DsWebAppDB datasource:

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

Procedure

1. Stop Tomcat if it is running.

2. Edit JWS_HOME/tomcat/conf/catalina.properties, and add the following line:

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

   Copy to Clipboard Toggle word wrap