Red Hat Training
A Red Hat training course is available for Red Hat JBoss Web Server
Installation Guide
for Use with Red Hat JBoss Web Server
Edition 1.0.2
Abstract
Chapter 1. Introduction
1.1. Components
- Apache Tomcat is a servlet container in accordance with Java Servlet Specification. JBoss Enterprise Web Server contains Apache Tomcat 6 and Apache Tomcat 5.
- Apache Native is a Tomcat library, which improves Tomcat scalability, performance, and integration with native server technologies. It also contains an implementation of APR (Apache Portable Runtime). APR is a binary protocol for communication of Apache HTTP Server and Apache Tomcat.
- Apache Tomcat Connectors (mod_jk, mod_cluster) are connectors between Apache HTTP Server and Apache Tomcat. Note that mod_cluster is a JBoss native load balancer and is more efficient, reliable, and scalable than mod_jk.
- Apache HTTP Server is an open-source web server developed by the Apache Software Foundation. The implementation follows the current HTTP standards.
Note
The delivered Apache HTTP Server by default provides the support for the Secure Socket Layer (SSL) protocol. To remove it, refer to the section on removing SSL for your installation. - Hibernate is an object-relational mapping framework. The delivered Hibernate contains Hibernate Core, Hibernate Annotations, Hibernate EntityManager with JPA 1.0 APIs.
Important
Important
1.2. Supported Operating Systems
- Red Hat Enterprise Linux 6, latest update (x86, x86_64)
- Red Hat Enterprise Linux 5, latest update (x86, x86_64)
- Red Hat Enterprise Linux 4, latest update (x86, x86_64)
- Solaris 10 (x86, x86_64, SPARC64)
- Solaris 9 (x86, SPARC32, SPARC64)
- Windows Server 2008 R2 (x86, x86_64)
- Windows Server 2003 SP2 (x86, x86_64)
1.3. Supported Connector Configurations
- Apache HTTP Server + mod_cluster + JBoss EAP 5.x
- Apache HTTP Server + mod_cluster + Tomcat 6
- Apache HTTP Server + mod_jk + JBoss EAP 5.x
- Apache HTTP Server + mod_jk + Tomcat 5
- Apache HTTP Server + mod_jk + Tomcat 6
Important
1.4. Installation and Upgrade
1.5. Source Files
Part I. Installation
- for Red Hat Enterprise Linux Chapter 3, Installing Enterprise Web Server on Red Hat Enterprise Linux
Chapter 2. Prerequisites
- Enough disk space for the JBoss Enterprise Web Server installation.
- Enough space for your applications.
Chapter 3. Installing Enterprise Web Server on Red Hat Enterprise Linux
- from a ZIP file available on the Red Hat Customer Portal (refer to Section 3.2, “Installing Enterprise Web Server from a ZIP File”)
Note
With a ZIP installation, JBoss Enterprise Web Server can be extracted and installed in any location. - from RPM packages from Red Hat Network (RHN, refer to Section 3.2, “Installing Enterprise Web Server from a ZIP File”)
Note
Installation from RPM packages integrates the web server with theservice
command and installs its resources into absolute paths.
Warning
3.1. Prerequisites
- Supported Java version is installed (refer to Procedure 3.1, “Installing Java”).
- Required packages are installed (refer to Procedure 3.2, “Installing Required Packages”).
- The classpathx-jaf package is removed (refer to Procedure 3.3, “Removing classpathx-jaf”)
Procedure 3.1. Installing Java
- Subscribe your system to the appropriate channel:
- RHEL Server Supplementary for Red Hat Enterprise Linux 6
- RHEL Supplementary for Red Hat Enterprise Linux 5
- Extras for Red Hat Enterprise Linux 4
- On the command line, as the root user run the command to install Java 1.6:
- On Red Hat Enterprise Linux 5 and Red Hat Enterprise Linux 6, execute the
yum install
command:# yum install java-1.6.0-<VENDOR>-devel
Substitute <VENDOR> withsun
,ibm
, oropenjdk
. - On Red Hat Enterprise Linux 4, execute the
up2date
command:# up2date java-1.6.0-<VENDOR>-devel
Substitute <VENDOR> withsun
oribm
.
- Run the following commands as the root user (if switching from another user, make sure to run the command
su -
) to make sure the correct JDK is in use:# alternatives --config java
# alternatives --config javac
These commands return lists of available JDK versions with the version in use marked with a plus (+
) sign. If the set JDK is not the desired option, switch to the right JDK as instructed on the command line.Important
Any software that makes use of thejava
andjavac
commands is using the JDK set by alternatives. Switching java alternatives may negatively influence running of such software. - Install the required packages (refer to Procedure 3.2, “Installing Required Packages”)
Procedure 3.2. Installing Required Packages
- Depending on your operating system version, run the respective installation command as the root user:
- On Red Hat Enterprise Linux 6 and 5:
# yum install distcache pcre
- On Red Hat Enterprise Linux 4:
# up2date distcache pcre
- When prompted, press y to proceed.
- When the installation is complete, run the following command to check that the packages are installed:
# rpm -q distache pcre
If the packages are installed, the command output shows the package names with their version numbers. - Install JBoss Enterprise Web Server either from a ZIP file (Section 3.2, “Installing Enterprise Web Server from a ZIP File”) or from RPMs (Section 3.3, “Installing Enterprise Web Server from RPM Packages”).
Procedure 3.3. Removing classpathx-jaf
- At the shell prompt, become the root user.
- Depending on your Red Hat Enterprise Linux version, run the respective command to uninstall the package:
- On Red Hat Enterprise Linux 5 and 6:
# yum remove classpathx-jaf
- On Red Hat Enterprise Linux 4:
# rpm -e classpathx-jaf
3.2. Installing Enterprise Web Server from a ZIP File
3.2.1. Downloading and Extracting the ZIP File
Procedure 3.4. Downloading the Enterprise Web Server ZIP File
- Open http://access.redhat.com in your web browser.
- In the upper right corner, click the Log in button.
- Enter your login information and click Log in.
- Hover over the Downloads option in the menu bar at the top of the page and under JBoss Enterprise Middleware in the displayed menu, click Downloads.
- In the Product drop-down box column, click Web Server.
- On the Software Downloads page, select the product version in the Version drop-down box and in the Releases tab below, click the
JBoss EWS
link with the correct version. - On the Software Details page, click the Download button next to the File drop-down box.
Note
Make sure the file is intended for your operating system and architecture. - Confirm the file download.
- After the ZIP file has downloaded successfully, follow Procedure 3.5, “Extracting the ZIP File” to extract the JBoss Enterprise Web Server ZIP file.
Procedure 3.5. Extracting the ZIP File
- On the command line, change to the directory with the ZIP file.
- Run the following
unzip
command:
Substitute FILE_NAME with the name of the downloaded file and TARGET_DIRECTORY with the path to the target directory.unzip <FILE_NAME> -d <TARGET_DIRECTORY>
After the ZIP file is extracted, configure the environment properly before running JBoss Enterprise Web Server (refer to Section 3.2.2, “Configuring the Environment”).Note
The target directory and thus the installation directory of the JBoss Enterprise Web Server is referred to as$EWS_HOME
. The formatting <EWS_HOME> is used to indicate that the entire path to the directory is used; for example <EWS_HOME>/httpd could refer to the/opt/jboss-ews-1.0/httpd
path.
3.2.2. Configuring the Environment
- create apache and tomcat users to allow a secure and simple user management (refer to Procedure 3.8, “Setting the apache User” and Procedure 3.7, “Creating tomcat User”);
- remove the SSL support (refer to Procedure 3.9, “Removing SSL”);
- add log4j logging (refer to Procedure 3.10, “Configuring log4j”);
- enable mod_jk or mod_cluster (refer to Procedure 3.11, “Configuring mod_jk” and Procedure 3.12, “Configuring mod_cluster”).
Procedure 3.6. Setting JAVA_HOME
JAVA_HOME
variable of your Tomcat to point to a supported Java:
- In the
bin
directory of your Tomcat (either$EWS_HOME/tomcat5/bin
or$EWS_HOME/tomcat6/bin
), create thesetenv.sh
file (for example, issue the commandvim tomcat<VERSION>/bin/setenv.sh
). - Add the JAVA_HOME path definition into the file; for example
export JAVA_HOME=/usr/lib/jvm/jre-1.6.0-openjdk.x86_64
Procedure 3.7. Creating tomcat User
- At the shell prompt, become the root user.
- Run the following command to create the tomcat user group:
# groupadd -g 91 -r tomcat
- Go to $EWS_HOME.
- From $EWS_HOME, run the following command to create the tomcat user in the tomcat user group:
# useradd -c "Tomcat" -u 91 -g tomcat -s /bin/sh -r -d /home/tomcat tomcat
- From $EWS_HOME, run the following command to assign the ownership of the tomcat directories to the
tomcat
user and allow the user to run the tomcat service:#
chown -R tomcat:tomcat tomcat<VERSION>
Substitute <VERSION> with the respective tomcat version number (5
or6
). - From $EWS_HOME, issue the command
ls -l
and check if the tomcat user is the owner of the Tomcat directory. - Make sure that the
tomcat
user has the execution permission to all parent directories.
Procedure 3.8. Setting the apache User
- Run the following commands as the root user to create the apache user group:
# groupadd -g 48 -r apache
- Run the following command to create the apache user in the apache user group:
# useradd -c "Apache" -u 48 -g apache -s /bin/sh -r -d /home/apache apache
- Change to
$EWS_HOME
and run the following command to assign the ownership of the apache directories to theapache
user and allow the user to runhttpd
:# chown -R apache:apache httpd
- From $EWS_HOME, issue the command
ls -l
and check that theapache
user has execution permission to the respective Apache install path. Output is similar to the following:drwxrwxr-- 11 apache apache 4096 Feb 14 06:52 httpd
Procedure 3.9. Removing SSL
- Go to the
$EWS_HOME/httpd/conf.d/
directory. - Rename the SSL configuration file:
- To remove SSL, rename
ssl.conf
tossl.conf.disabled
. - To re-add SSL, rename
ssl.conf.disabled
tossl.conf
.
Procedure 3.10. Configuring log4j
log4j
logging to Tomcat:
- Go to the
$EWS_HOME/extras/
directory. - Copy the
log4j.jar
andlog4j.properties
files to thelib
directory of the Tomcat directory:- If using Tomcat 6, run the following commands:
extras]# cp log4j.jar log4j.properties ../tomcat6/lib
extras]# cp tomcat-juli-adapters.jar $EWS_HOME/tomcat6/lib
- If using Tomcat 5, run the following commands:
extras]# cp log4j.properties ../tomcat5/common/classes
extras]# cp log4j.jar ../tomcat5/common/lib
Procedure 3.11. Configuring mod_jk
- available workers (JBoss instances) in the
workers.properties
file - the mod_jk configuration file
- In the
$EWS_HOME/httpd/conf/
directory, create workers.properties - In the
$EWS_HOME/httpd/conf.d/
directory, create mod_jk.conf.Note
You can also use the template files from the jboss-ews-docs-1.0.2.zip file (the file is available at the Red Hat Customer Portal ): after you have downloaded and unzipped the file, copy the sample filesmod_jk.conf.sample
andworkers.properties.sample
from the $EWS_HOME/doc/mod_jk/ to the locations defined in Step 1 and Step 2. Rename them (drop thesample
extension) and modify their content as needed (to refer to Section 3.2.6, “Additional Resources”).
Procedure 3.12. Configuring mod_cluster
- In the
<EWS_HOME>/httpd/conf/httpd.conf
file, add the hash (#
) sign at the beginning of the following line to disable mod_proxy_balancer.so:LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
This module is incompatible with the JBoss HTTP Connector. - Configure the server to load the JBoss HTTP Connector modules:
- In the
$EWS_HOME/httpd/conf.d/
directory, create theJBoss_HTTP.conf
file. - Add the following lines to the
JBoss_HTTP.conf
file:LoadModule slotmem_module modules/mod_slotmem.so LoadModule manager_module modules/mod_manager.so LoadModule proxy_cluster_module modules/mod_proxy_cluster.so LoadModule advertise_module modules/mod_advertise.so
Procedure 3.13. Running the Post-Installation Script
- At the shell prompt, become the root user.
- Change to the
/opt/jboss-ews-2.0/httpd
directory. - Run the following command:
# ./.postinstall
Note
The system uses the /opt directory as a default directory for installing JBoss Enterprise Web Server. Make sure the /opt directory is present during installation.
3.2.3. Running Enterprise Web Server
- Tomcat (5 or 6, refer to Section 3.2.3.1, “Running Tomcat”)
- HTTP server (Section 3.2.3.2, “Running HTTP”)
3.2.3.1. Running Tomcat
Important
- The tomcat user is created (refer to Procedure 3.7, “Creating tomcat User”).
- JAVA_HOME is set correctly (refer to Procedure 3.6, “Setting JAVA_HOME”).
3.2.3.1.1. Running Tomcat as a Program
startup.sh
scriptRun the following command as the root user with the respective Tomcat version (5
or6
):# sh <EWS_HOME>/tomcat<VERSION>/bin/startup.sh
The system reads the configuration file and changes to the user and group to the tomcat user account (that is, Tomcat is always run under the tomcat user). By default,tomcat-native
is automatically added to theLD_LIBRARY_PATH
and-Djava.library.path
during Tomcat startup.catalina.sh
scriptRun the following command with the respective Tomcat version (5
or6
) :# sh <EWS_HOME>/tomcat<VERSION>/bin/catalina.sh
- custom script, which calls
catalina.sh
3.2.3.1.2. Running Tomcat as a Service
3.2.3.2. Running HTTP
<EWS_HOME>/httpd/sbin/
and run the following command as the root user:
# ./apachectl start
3.2.4. Stopping Enterprise Web Server
3.2.4.1. Stopping Tomcat
# sh <EWS_HOME>/tomcat<VERSION>/bin/shutdown.sh
3.2.4.2. Stopping HTTP
<EWS_HOME>/httpd/sbin/
and run the following command as the root user:
# apachectl stop
3.2.5. ZIP Installation Structure
`-- jboss-ews-1.0 |-- extras (includes log4j) |-- httpd (includes modules, configuration files, executable for the HTTP Server) |-- tomcat5 `-- tomcat6
3.2.6. Additional Resources
jboss-ews-docs-1.0.2.zip
and jboss-ews-src-1.0.2.zip
files available at the Red Hat Customer Portal and extract them to $EWS_HOME. On extraction, doc
and src
directories are created, which contain the documentation and examples, and source code.
3.3. Installing Enterprise Web Server from RPM Packages
3.3.1. RPM Packages
RPM Packages for Red Hat Enterprise Linux 5 and 6
- Tomcat 6:
- tomcat6tomcat6-webappstomcat6-admin-webapps
- Tomcat 5:
- tomcat5tomcat5-webappstomcat5-admin-webapps
- Tomcat Native:
- tomcat-native
- HTTP Server:
- httpd
- mod_jk:
- mod_jk-ap20
- mod_cluster:
- mod_cluster-tomcat6mod_cluster-native
- log4j:
- tomcat6-log4j
- mod_ssl:
- mod_ssl
- Hibernate:
- hibernate3
- JK Status Ant tasks:
- tomcat-jkstatus-ant
Important
In the next release, the tomcat-jkstatus-ant library will be deprecated.
RPM Packages for Red Hat Enterprise Linux 4
- Tomcat 6:
- tomcat6tomcat6-webappstomcat6-admin-webapps
- Tomcat 5:
- tomcat5tomcat5-webappstomcat5-admin-webapps
- Tomcat Native:
- tomcat-native
- HTTP Server:
- httpd22
- mod_jk:
- mod_jk-ap20
- mod_cluster:
- mod_cluster-tomcat6mod_cluster-native
- log4j:
- tomcat6-log4j
- mod_ssl:
- mod_ssl22
- Hibernate:
- hibernate3
- JK Status Ant tasks:
- tomcat-jkstatus-ant
Important
In the next release, the tomcat-jkstatus-ant library will be deprecated. - Xerces2 Java Parser:
- xerces-j2
Note
Xerces2 Java Parser is a Tomcat 5 dependency. If you are using Tomcat 6, the package is installed atomatically as a dependency. However, if you are installing only the tomcat5 package, make sure to install xerces-j2 before.
3.3.2. RHN Channels for JBoss Enterprise Web Server Installation Packages
- on Red Hat Enterprise Linux 6:
- jb-ews-1-i386-server-6-rpm
- jb-ews-1-x86_64-server-6-rpm
- on Red Hat Enterprise Linux 5:
- jb-ews-1-i386-server-5-rpm
- jb-ews-1-x86_64-server-5-rpm
- on Red Hat Enterprise Linux 4:
- jb-ews-1-i386-as-4-rpm
- jb-ews-1-x86_64-as-4-rpm
- jb-ews-1-i386-es-4-rpm
- jb-ews-1-x86_64-es-4-rpm
3.3.3. Installing Enterprise Web Server from RPM Files
Procedure 3.14. Subscribing to Red Hat Network Enterprise Channels
- Go to Red Hat Network Enterprise.
- Unsubscribe your system from the
Red Hat Application Stack
channel. - Subscribe to the JBoss Enterprise Web Server channels (refer to Section 3.3.2, “RHN Channels for JBoss Enterprise Web Server Installation Packages”).
- Ensure that
exactarch
is set to the correct value:- On Red Hat Enterprise Linux 4, skip this step and proceed to Procedure 3.15, “Installing Enterprise Web Server from RPM Packages”.
- On Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 5, open
/etc/yum.conf
for editing and set theexactarch
value to0
:exactarch=0
If the directive is not present, add it to the file.
Procedure 3.15. Installing Enterprise Web Server from RPM Packages
- At the shell prompt, become the root user.
- Depending on your operating system, run the installation command:
- On Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 5:
# yum install <LIST_OF_PACKAGES>
Substitute the <LIST_OF_PACKAGES> with names of the packages separated with spaces.To install all JBoss Enterprise Web Server packages, run this command:# yum install tomcat6 tomcat6-webapps tomcat6-admin-webapps tomcat5.noarch tomcat5-webapps.noarch tomcat5-admin-webapps.noarch tomcat-native httpd mod_jk-ap20 mod_cluster-tomcat6 mod_cluster-native tomcat6-log4j mod_ssl hibernate3 tomcat-jkstatus-ant
Note
Unless package.noarch is specified for Tomcat 5 packages, yum fetches all Tomcat 5 packages from the base channel instead of the JBoss Enterprise Web Server channel. - On Red Hat Enterprise Linux 4:
# up2date <LIST_OF_PACKAGES>
Substitute the <LIST_OF_PACKAGES> with names of the packages divided by spaces.To install all JBoss Enterprise Web Server packages, run this command:# up2date tomcat6 tomcat6-webapps tomcat6-admin-webapps xerces-j2 tomcat5 tomcat5-webapps tomcat5-admin-webapps tomcat-native httpd22 mod_jk-ap20 mod_cluster-tomcat6 mod_cluster-native tomcat6-log4j mod_ssl22 hibernate3 tomcat-jkstatus-ant
- Ensure that
exactarch
is set to the correct value:- On Red Hat Enterprise Linux 4, skip this step.
- On Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 5, open
/etc/yum.conf
for editing and set theexactarch
value to1
:exactarch=1
- Run the following command and verify the system is using the correct javac and java (for details refer to Procedure 3.1, “Installing Java”).
3.3.4. Configuring the Environment
- remove SSL (refer to Procedure 3.16, “Removing SSL”);
- add log4j logging (refer to Procedure 3.18, “Removing log4j From Tomcat 6”);
- enable mod_jk or mod_cluster (refer to Procedure 3.20, “Configuring mod_jk” and Procedure 3.21, “Configuring mod_cluster”)
Procedure 3.16. Removing SSL
- At the shell prompt, become the root user.
- Run the respective uninstall command:
- on Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 5:
# yum remove mod_ssl
- on Red Hat Enterprise Linux 4:
# rpm -e mod_ssl22
For tomcat6, the log4j support is provided by the tomcat6-log4j package and is enabled on package installation (refer to Procedure 3.15, “Installing Enterprise Web Server from RPM Packages”). To enable log4j on tomcat5, copy the respective log4j resources from the tomcat6
to the tomcat5
directory (refer to Procedure 3.17, “Adding log4j on tomcat5”)
Procedure 3.17. Adding log4j on tomcat5
- Install the
tomcat6-log4j
RPM package. - From
/usr/share/java/tomcat6/
, copy:log4j.jar
to/usr/share/tomcat5/common/lib
andlog4j.properties
to/usr/share/tomcat5/common/classes
.
Procedure 3.18. Removing log4j From Tomcat 6
- At the shell prompt, become the root user.
- Run the respective uninstall command:
- on Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 5:
# yum remove tomcat6-log4j
- on Red Hat Enterprise Linux 4:
# rpm -e tomcat6-log4j
Procedure 3.19. Removing log4j From Tomcat 5
- Remove the
log4j.jar
file from the/usr/share/tomcat5/common/lib
directory. - Remove the
log4j.properties
file from the/usr/share/tomcat5/common/classes
directory.
Procedure 3.20. Configuring mod_jk
- Install the template
mod_jk
configuration file:# cp /usr/share/doc/mod_jk-ap20-*/mod_jk.conf.sample /etc/httpd/conf.d/mod_jk.conf
- Install the template
workers.properties
file:# cp /usr/share/doc/mod_jk-ap20-*/workers.properties.sample /etc/httpd/conf/workers.properties
- Add worker mappings to
workers.properties
. For example:# Mount the Servlet context to the ajp20 worker /jmx-console=loadbalancer /jmx-console/*=loadbalancer /web-console=loadbalancer /web-console/*=loadbalancer
Note
The default configuration is adequate for low-traffic web sites. For optimization information for moderate and high-load web sites, refer to http://kbase.redhat.com/faq/docs/DOC-15836.
Procedure 3.21. Configuring mod_cluster
- In the
/etc/httpd/conf/httpd.conf
file, add the hash (#
) sign at the beginning of the following line to disable mod_proxy_balancer.so:LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
This module is incompatible with the JBoss HTTP Connector. - Configure the server to load the JBoss HTTP Connector modules:
- Create the file
/etc/httpd/conf.d/JBoss_HTTP.conf
. - Add the following lines to the
JBoss_HTTP.conf
file:LoadModule slotmem_module modules/mod_slotmem.so LoadModule manager_module modules/mod_manager.so LoadModule proxy_cluster_module modules/mod_proxy_cluster.so LoadModule advertise_module modules/mod_advertise.so
3.3.5. Setting the Service Boot Behavior
- From the command line, issue the following command with the <SERVICE_NAME> replaced with the respective service name (
tomcat6
ortomcat5
, andhttpd
orhttpd22
)chkconfig <SERVICE_NAME> on
For details refer to the chkconfig man page. - To use the Service Configuration tool, issue the command
system-config-services
and change the service setting in the displayed window.
3.3.6. Running Enterprise Web Server
- Tomcat (5 or 6, refer to Procedure 3.22, “Running Tomcat”)
- HTTP server (Procedure 3.23, “Running HTTP”)
Procedure 3.22. Running Tomcat
Important
tomcat
:
- At the shell prompt, become the root user.
- Run the following
start
command with the <VERSION> substituted with the correct Tomcat version (5
or6
):# service tomcat<VERSION> start
- Go to http://localhost:8080 in your web browser to verify that Tomcat is running. The Apache Software Foundation page appears.
Note
In JBoss Enterprise Web Server installations from the RPM packages, the only supported way of running Tomcat is the running described in this section.
Procedure 3.23. Running HTTP
httpd
:
- At the shell prompt, become the root user.
- Run the following
start
command:- On Red Hat Enterprise Linux 6 or Red Hat Enterprise Linux 5:
# service httpd start
- On Red Hat Enterprise Linux 4:
# service httpd22 start
3.3.7. Stopping Enterprise Web Server
Procedure 3.24. Stopping Tomcat
tomcat
:
- At the shell prompt, become the root user.
- Run the following
start
command with the <VERSION> substituted with the correct Tomcat version (5
or6
):# service tomcat<VERSION> stop
- Go to http://localhost:8080 in your web browser to verify that Tomcat is no longer running.
Procedure 3.25. Stopping HTTP
httpd
:
- At the shell prompt, become the root user.
- Run the following
stop
command:- On Red Hat Enterprise Linux 6 or Red Hat Enterprise Linux 5:
# service httpd stop
- On Red Hat Enterprise Linux 4:
# service httpd22 stop
3.3.8. Additional Documentation
up2date
in Red Hat Enterprise Linux 4 and yum install
in Red Hat Enterprise Linux 5 and Red Hat Enterprise Linux 6 followed by the list of required documentation packages.
- The following documentation packages are available for Red Hat Enterprise Linux 6 and Red Hat Enterprise Linux 5:
- for Tomcat 5:
- tomcat5-webapps
- for Tomcat 6:
- mod_jk-manualhttpd-manualtomcat6-docs-webapp
- The following documentation packages are available for Red Hat Enterprise Linux 4:
- for Tomcat 5:
- tomcat5-webapps
- for Tomcat 6:
- mod_jk-manualhttpd22-manualtomcat6-docs-webapp
Chapter 4. Installing Enterprise Web Server on Windows
4.1. Prerequisites
Procedure 4.1. Installing Java
- Go to the Oracle homepage.
- Download JDK 1.6 for your operating system from the web site.
- Go to the download location.
- Double-click the downloaded file to start the Java installation.
- Proceed as instructed in the displayed installation window.
4.2. Downloading and Extracting Installation File
Procedure 4.2. Downloading the Enterprise Web Service ZIP File
- Open http://access.redhat.com in your web browser.
- In the right upper corner, click the Log in button.
- Enter your login information and click Log in.
- Hover over the Downloads option in the menu bar at the top of the page and click Downloads under JBoss Enterprise Middleware in the displayed menu.
- In the Product drop-down menu, click Web Server.
- On the Releases tab, click the
JBoss EWS
link for Windows with the correct architecture and version. - On the Software Details page, click the Download button next to the File drop-down box.
Note
Make sure the file is intended for your operating system and architecture. - Confirm the file download.
Procedure 4.3. Extracting the ZIP File
- Right-click the file and select
Extract All...
. - Click Next.
- When prompted for the extract location, click Browse and navigate to
C:\Program Files
. - Click Finish.
Note
Files are extracted inC:\Program Files\Red Hat\Enterprise Web Server
. If you wish to change the httpd configuration (for example, add mod_cluster), edit thehttpd.conf
file in theC:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf
folder.
4.3. Configuring the Environment
Procedure 4.4. Setting Environment Variables
- Log in to an account with local administrator permissions.
- Go to Control Panel → System.
- Click on the Advanced tab.
- Click the Environment Variables button.
- Click the New for System Variables.
- Enter the required
JAVA_HOME
,TMP
andTEMP
name-value pairs. - You will also need to add
<EWS_HOME>\bin
to the PATH environment variable of the user the service runs under. This is SYSTEM by default. Without this, the SSL Connector will fail to work.
Procedure 4.5. Running the Post-Installation Script
- Run the Command Prompt as administrator even if you are logged in as the administrator:
- Click the Start button.
- Go to All Programs → Accessories.
- Right-click the Command Prompt and select
Run as administrator
.
Note
Windows Server 2003 does not have the User Account Control concept, therefore you only need to run the Command Prompt (cmd.exe
). - In the Command Prompt, type the following to change to the
etc
folder of your Enterprise Web Server installation:C:\> cd /D "C:\Program Files\Red Hat\Enterprise Web Server\etc"
- Issue the command
call postinstall.bat
to run the post-installation script.The script creates the required symbolic links (Junction Points) for temporary logging and configuration directories.
Procedure 4.6. Installing Tomcat
- Run the Command Prompt as administrator:
- Click the Start button.
- Go to All Programs → Accessories.
- Right-click the Command Prompt and select
Run as administrator
.Note
On 64-bit Windows, you need to use the 64-bit version of the Command Prompt (cmd.exe
). Running thecmd
command from a 32-bit application launches a 32-bit Command Prompt instance. This causes the service setup script to fail with a File Not Found warning. - Change to the
sbin
folder in the JBoss Enterprise Web Server installation folder:C:\> cd /D "C:\Program Files\Red Hat\Enterprise Web Server\sbin"
- In the Command Prompt, run the following command with the required Tomcat version (5 or 6) to install Tomcat:
call service<VERSION>.bat install
You can check the service parameters by typingtomcat<VERSION>w.exe
.Note
The tomcat<VERSION>w.exe is located inC:\Program Files\Red Hat\Enterprise Web Server\bin
Procedure 4.7. Installing HTTP
- Run the Command Prompt as administrator:
- Click the Start button.
- Go to All Programs → Accessories.
- Right-click the Command Prompt and select
Run as administrator
.
- Change to the
bin
folder of your new installation:C:\> cd /D "C:\Program Files\Red Hat\Enterprise Web Server\bin"
- In the Command Prompt, run the
install
command:httpd -k install
A Firewall security dialog prompt demanding networking access for the Apache HTTP Server service appears. Click Allow if you wish to access this service from the network.Note
By default, Apache HTTP Server is configured to listen on port 80. If you have Microsoft IIS installed, ensure the following:World Wide Web...
service is stopped and the Startup Type is set toManual
World Wide Web...
service is configured to listen on a different port
Alternatively, you can edit thehttpd.conf
file before installing the service and change theListen
directive to a port that does not collide with the Internet Information Service listening ports.
Procedure 4.8. Configuring log4j
log4j
logging in Tomcat:
- Change to
C:\Program Files\Red Hat\Enterprise Web Server\extras\
- Copy the respective log4j files to the Tomcat folder:
- If using Tomcat 6, run the following commands:
copy log4j.jar log4j.properties ..\tomcat6\lib
copy C:\Program Files\Red Hat\Enterprise Web Server\extras\tomcat-juli-adapters.jar C:\Program Files\Red Hat\Enterprise Web Server\tomcat6\lib
- If using Tomcat 5, run the following commands:
copy log4j.properties ..\tomcat5\common\classes
copy log4j.jar ..\tomcat5\common\lib
Procedure 4.9. Removing SSL
- Go to
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf.d
- Rename the SSL configuration file:
- To remove SSL, rename
ssl.conf
tossl.conf.disabled
. - To re-add SSL rename
ssl.conf.disabled
tossl.conf
.
Procedure 4.10. Configuring mod_jk
- available workers (JBoss instances) in the
workers.properties
file - the mod_jk configuration file
mod_jk.conf
- In
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf\
create workers.properties (refer to http://tomcat.apache.org/connectors-doc/reference/apache.html). - In
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf.d\
, create mod_jk.conf (refer to http://tomcat.apache.org/connectors-doc/reference/apache.html)Note
You can also use the sample filesmod_jk.conf.sample
andworkers.properties.sample
available inC:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf
: modify their content as needed and rename them tomod_jk.conf
andworkers.properties
.
Procedure 4.11. Configuring mod_cluster
- In the
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf\httpd.conf
file, add the hash (#
) sign at the beginning of the following line to disable mod_proxy_balancer.so:LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
This module is incompatible with the JBoss HTTP Connector. - Configure the server to load the JBoss HTTP Connector modules:
- Create the file
C:\Program Files\Red Hat\Enterprise Web Server\etc\httpd\conf\JBoss_HTTP.conf
. - Add the following lines to the
JBoss_HTTP.conf
file:LoadModule slotmem_module modules/mod_slotmem.so LoadModule manager_module modules/mod_manager.so LoadModule proxy_cluster_module modules/mod_proxy_cluster.so LoadModule advertise_module modules/mod_advertise.so
Procedure 4.12. Setting Security
C:\Program Files\Red Hat
folder and all of its subfolders:
- Right-click the
C:\Program Files\Red Hat
folder and clickProperties
. - Select the
Security
tab. - Click the Add.. button and type in
LOCAL SERVICE
. - Select the
Full Control
check box for the newLOCAL SERVICE
account. - Click the Advanced button.
- Inside the Advanced Security Settings for Red Hat dialog, select the
Replace permissions on all child objects...
check box and click the OK button.This procedure is intended for Windows 2003. The equivalent procedure in Windows Server 2008 and Windows Server 2008R2 can slightly differ.
4.4. Running Enterprise Web Server
Procedure 4.13. Running Enterprise Web Server from the Command Prompt
- Run the Command Prompt as administrator:
- Click the Start button.
- Go to All Programs → Accessories.
- Right-click the Command Prompt and select
Run as administrator
.
- On the Command Prompt, issue the following command to run the tomcat service:
net start tomcat<VERSION>
- On the Command Prompt, run the following command to run the httpd service:
net start httpd
Procedure 4.14. Running Enterprise Web Server from the Computer Management Tool
- Run the Command Prompt as administrator:
- Click the Start button.
- Go to All Programs → Accessories.
- Right-click the Command Prompt and select
Run as administrator
.
- Go to Start → Administrative Tools → Services
- In the Services dialog, right-click the name of the service (
httpd
ortomcat
) and click Start or Stop.
Note
catalina.bat run
.
C:\windows\System32\
directory and PATH directories, and check for DLLs library conflicting with those shipped with Enterprise Web Server. In particular, look for libeay32.dil
, ssleay32.dll
, and libssl32.dll
.
4.5. Stopping Enterprise Web Server
Procedure 4.15. Stopping Enterprise Web Server from the Command Prompt
- Run the Command Prompt as administrator:
- Click the Start button.
- Go to All Programs → Accessories.
- Right-click the Command Prompt and select
Run as administrator
.
- On the Command Prompt, issue the following command to run the tomcat service:
net stop tomcat<VERSION>
- On the Command Prompt, run the following command to run the httpd service:
net stop httpd
Procedure 4.16. Stopping Enterprise Web Server from the Computer Management Tool
- Run the Command Prompt as administrator:
- Click the Start button.
- Go to All Programs → Accessories.
- Right-click the Command Prompt and select
Run as administrator
.
- Go to Start → Administrative Tools → Services
- In the Services dialog, right-click the name of the service (
httpd
ortomcat
) and click Stop.
4.6. Folder Structure
|-- bin |-- doc |-- etc | |-- httpd | |-- postinstall.bat | |-- ssl | `-- sysconfig |-- include |-- lib[64] |-- sbin |-- share | |-- apache-tomcat-5.VERSION | |-- apache-tomcat-6.VERSION | |-- java | |-- tomcat5 | `-- tomcat6 `-- var |-- cache |-- log |-- run `-- www
- The
bin
andsbin
directories contain the executable files for Apache HTTP Server and Tomcat. - The
etc
folder contains configuration files for Apache HTTP Server and the post-installation script. - The
share
folder contains Apache Tomcat 5 and 6 installations and shared Java JARs. - The
var
contains four sub-directories:-
cache
- The
cache
contains resources cached by the server.. -
log
- This
log
folder contains the log files for HTTP Server and Tomcat. -
www
- Apache HTTP Server looks in this folder for web content in the
default
configuration. -
run
- The
run
folder contains PID files.
-
Chapter 5. Installing Enterprise Web Server on Solaris
- from a ZIP file
- from Solaris packages
5.1. Prerequisites
Procedure 5.1. Installing Java
- Go to the Oracle homepage.
- Download JDK 1.6.0 from the web site (http://www.oracle.com/technetwork/java/javase/downloads/index.html).
- Go to the download location.
- Run the Java installation file.
- Go to
usr
. - Issue the following command to display the current Java symbolic link:
ls -lad java
- Remove the link:
rm java
- Create a java symbolic link to the JDK 1.6.0:
ln -sf /usr/jdk/<JDK>
5.2. Downloading Installation Files
Procedure 5.2. Downloading Solaris Packages or ZIP Files
- Open https://access.redhat.com in your web browser.
- In the right upper corner, click the Log in button.
- Enter your login information and click Log in.
- Hover over the Downloads option in the menu bar at the top of the page and click Downloads under JBoss Enterprise Middleware in the displayed menu.
- In the Product drop-down box column of the displayed page, select Web Server wait for the page to refresh.
- On the Releases tab, click the JBoss EWS link for your operating system and architecture.
- On the Software Details page, click the Download button next to the File drop-down box.
Note
Make sure the file is intended for your operating system and architecture. - Confirm the file download.
5.3. Extracting and Installing Enterprise Web Server
Procedure 5.3. Extracting and Installing EWS from a ZIP File
- At the shell prompt, become the root user.
- Change to the directory with the ZIP file.
- Run the following command to extract the package to
opt
:# unzip <FILE_NAME> -d /opt
Substitute the <FILE_NAME> with the name of the downloaded ZIP file. - Issue the following commands to run the post-installation script:
cd /opt/redhat/ews/etc sh .postinstall
The post-installation process creates the tomcat and apache users and groups, and directories:- The users and groups
apache
with an ID of 48 andtomcat
with an ID of 91. Theapache
runshttpd
, while thetomcat
user runstomcat
. - Additional directories the
tomcat
group has write permissions to:/var/logs/tomcat5
/var/logs/tomcat6
Note
The system uses the /opt directory as a default directory for installing JBoss Enterprise Web Server. Make sure the /opt directory is present during installation.
Procedure 5.4. Extracting and Installing EWS from Solaris Packages
/opt/redhat/ews
directory. As a part of the installation, the package installer executes custom scripts, which set up the apache and tomcat user accounts.
- At the shell prompt, become the root user.
- Run the following
gunzip
andpkgadd
commands to decompress and install the package:gunzip RHATews-1.0.*
pkgadd -d RHATews-1.0.*
The command returns an output similar to the following:The following packages are available: 1 RHATews JBoss Enterprise Web Server (i386) 1.0.0,REV=2.el5 Select package(s) you wish to process (or 'all' to process all packages). (default: all) [?,??,q]:
- Type
1
or pressenter
to confirm the installation. The following information appears:JBoss Enterprise Web Server(i386) 1.0.0,REV=2.GA END USER LICENSE AGREEMENT JBOSS(r) ENTERPRISE MIDDLEWARE(tm) The end user license agreement ("EULA") governs the use of the various software modules that collectively comprise JBoss Enterprise Middleware and any related updates, source code, appearance, structure and organization, regardless of the delivery mechanism. The JBoss Enterprise Middleware EULA can be found here: http://www.redhat.com/licenses/jboss_eula.html ## Executing checkinstall script. Using </opt> as the package base directory. ## Processing package information. ## Processing system information. ## Verifying disk space requirements. ## Checking for conflicts with packages already installed. ## Checking for setuid/setgid programs. This package contains scripts which will be executed with super-user permission during the process of installing this package. Do you want to continue with the installation of <RHATews> [y,n,?]
- Type
y
and pressenter
when prompted to confirm the installation. Installation starts and the following appears:## Executing postinstall script. Apache group (id=48) already exists. +++ or created if not Apache user (id=48) already exists. Generating private RSA key ... OK Generating new (+++ user hostname displayed here) certificate ... OK Tomcat group (id=91) already exists. Tomcat user (id=91) already exists. ----------------------------------------------------------------------- NOTICE ----------------------------------------------------------------------- JAVA_HOME environment variable is not set. Either set the JAVA_HOME or edit the configuration scripts inside `/opt/redhat/ews/etc/sysconfig' directory and set the JAVA_HOME to the installed JDK location. Installation of <RHATews> was successful.
- Issue the following command to display the package information:
pkginfo -l RHATews
Note
During installation, the system generates a notice that theJAVA_HOME
environment variable is not set. You need to set this variable specifically for the Tomcat you wish to run (refer to Procedure 5.5, “Configuring Tomcat” section). - Run the following command with the respective Tomcat version to execute the
catalina.sh
script:/opt/redhat/ews/share/tomcat<VERSION>/bin/catalina.sh
Thecatalina.sh
script detects the running JVM version and adds the /opt/redhat/ews/lib path (/opt/redhat/ews/lib64 for 64 bit JVM) to the library path.
5.4. Configuring the Environment
- remove SSL (refer to Procedure 5.6, “Removing SSL”);
- add log4j logging (refer to Procedure 5.7, “Configuring log4j”);
- enable mod_jk or mod_cluster (refer to Procedure 5.8, “Configuring mod_jk” and Procedure 5.9, “Configuring mod_cluster”).
Procedure 5.5. Configuring Tomcat
JAVA_HOME
variable to point to a supported JDK (1.6.0):
- Locate the
tomcat
configuration file:- For Tomcat 5:
/opt/redhat/ews/etc/sysconfig/tomcat5
- For Tomcat 6:
/opt/redhat/ews/etc/sysconfig/tomcat6
- Open the configuration file and delete the hash (#) sign at the beginning of the following line:
# JAVA_HOME="/usr/java"
Procedure 5.6. Removing SSL
- Go to
/opt/redhat/ews/etc/httpd/conf.d
- Rename the SSL configuration file:
- To remove SSL, rename
ssl.conf
tossl.conf.disabled
. - To re-enable the SSL, rename
ssl.conf.disabled
tossl.conf
.
Procedure 5.7. Configuring log4j
log4j
logging to Tomcat:
- Go to the
/opt/redhat/ews/share/extras
directory. - Copy the
log4j.jar
andlog4j.properties
files to thelib
directory of the Tomcat directory:- If using Tomcat 6, run the following commands:
extras]# cp log4j.jar log4j.properties ../tomcat6/lib
extras] # cp tomcat-juli-adapters.jar /opt/redhat/ews/share/tomcat6/lib
- If using Tomcat 5, run the following commands:
extras]# cp log4j.properties ../tomcat5/common/classes
extras]# cp log4j.jar ../tomcat5/common/lib
Procedure 5.8. Configuring mod_jk
- available workers (JBoss instances) in the
workers.properties
file - the mod_jk configuration file mod_jk.conf
- Create a workers.properties file in
/opt/rehat/ews/etc/httpd/conf/httpd/conf/
(refer to http://tomcat.apache.org/connectors-doc/reference/apache.html). - Create a mod_jk.conf in
/opt/rehat/ews/etc/httpd/conf/httpd/conf.d/
, (refer to http://tomcat.apache.org/connectors-doc/reference/apache.html).Note
You can also copy and modify the sample filesmod_jk.conf.sample
andworkers.properties.sample
available in /opt/rehat/ews/etc/httpd/conf/httpd/conf/: modify their content as needed and rename them tomod_jk.conf
andworkers.properties
.
Procedure 5.9. Configuring mod_cluster
- From Red Hat Customer Portal, download the jboss-ep-native ZIP file for your operating system and architecture.
- Unzip the downloaded file.
- In the location, where you have extracted the file, change to
jboss-ep-<VERSION> /native/lib[64]/httpd/modules
- Run the following command to copy mod_cluster modules to
/opt/redhat/ews/lib[64]/httpd/modules
:modules]# cp mod_advertise.so mod_manager.so mod_proxy_cluster.so mod_slotmem.so -t /usr/lib[64]/httpd/modules
- In
/opt/redhat/ews/httpd/conf/httpd.conf
add a hash (#
) sign at the beginning of the following line to disable the mod_proxy_balancer module:LoadModule proxy_balancer_module modules/mod_proxy_balancer.so
This module is incompatible with the JBoss HTTP Connector. - Configure the server to load the JBoss HTTP Connector modules:
- Create the file
/opt/redhat/ews/httpd/conf.d/JBoss_HTTP.conf
. - Add the following lines to the file JBoss_HTTP.conf:
LoadModule slotmem_module modules/mod_slotmem.so LoadModule manager_module modules/mod_manager.so LoadModule proxy_cluster_module modules/mod_proxy_cluster.so LoadModule advertise_module modules/mod_advertise.so
5.5. Running Enterprise Web Server
5.5.1. Running Tomcat
Important
5.5.1.1. Running Tomcat as a Program
tomcat[5,6]
script in the sbin
directory or the catalina
script in the lib
directory:
- To start Tomcat with the tomcat script, run the following command as the root user with the respective Tomcat version (
5
or6
):/opt/redhat/ews/sbin/tomcat<VERSION> start
The system reads the configuration file and changes to the user and group of the tomcat user account (that is, Tomcat is always run under the tomcat user). By default,tomcat-native
is automatically added to theLD_LIBRARY_PATH
and-Djava.library.path
during Tomcat startup. - To start Tomcat with the
catalina.sh
script, run the following command with the respective Tomcat version (5
or6
) :/opt/redhat/ews/share/tomcat<VERSION>/bin/catalina.sh
Thecatalina.sh
script detects the running JVM version and adds the/opt/redhat/ews/lib/
path (/opt/redhat/ews/lib64
for 64 bit JVM) to the library path.
5.5.1.2. Running Tomcat as a Service
init.d
or you can create and use your own system daemon script with jsvc or tanukiwrapper.
ln -s /opt/redhat/ews/etc/init.d/tomcat<VERSION> /etc/rc3.d/S70tomcat<VERSION> ln -s /opt/redhat/ews/etc/init.d/tomcat<VERSION> /etc/rcS.d/K20tomcat<VERSION>
init
level numbers (for information on how define init
level numbers consult your Solaris documentation). The preferred method of service management is through the Solaris Service Management Facility
. In order to read more about this facility, consult the smf(5)
manual.
5.5.2. Running HTTP Server
apachectl
script, which is located inside the /opt/redhat/ews/sbin
directory. The apachectl
script uses the configuration file /opt/redhat/ews/etc/sysconfig/httpd
. In this file you can edit and select startup parameters, such as the running of mpm
.
httpd
configuration files are located inside the /opt/redhat/ews/etc/httpd
directory. By default all supported modules are loaded and enabled (refer to Appendix A, Supported HTTP Modules). To disable some of the modules, comment out the respective modules in the httpd.conf
file (for module description refer to http://httpd.apache.org/docs/2.2/mod/).
Procedure 5.10. Running HTTP Server
- Run the command line as the root user.
- Run the following command to start the HTTP Server:
sbin/apachectl start
If you want your server to continue running automatically after a system reboot, add a call to theapachectl
script to your system startup files.Note
For complete documentation on how to start and stop the HTTP Server, refer to the files,docs/httpd/invoking.html
anddocs/httpd/stopping.html
respectively.
5.6. Stopping Enterprise Web Server
Procedure 5.11. Stopping Tomcat Running a Service
- At the shell prompt, become the root user.
- Execute the following command with the respective Tomcat version (
5
or6
) to stop Tomcat started from with the Tomcat script in thebin
directory:sbin/tomcat<VERSION> stop
Procedure 5.12. Stopping Tomcat Running a Program
- At the shell prompt, change to
/opt/redhat/ews/share/tomcat<VERSION>/bin
. - Execute the following command with the respective Tomcat version (
5
or6
) to stop Tomcat started from with the Tomcat script in thebin
directory:sh shutdown.sh
Procedure 5.13. Stopping HTTP Server
- Run the command line as the root user.
- Run the following command to stop the HTTP Server:
sbin/apachectl stop
5.7. Uninstalling the Package in Solaris
- Issue the following command to uninstall the package:
pkgrm RHATews
- Remove the following directories:
/opt/redhat/ews
/var/run/tomcat5
/var/run/tomcat6
/var/cache/tomcat5
/var/cache/tomcat6
/var/log/httpd
/var/cache/mod_ssl
/var/cache/mod_proxy
5.8. Solaris Directory Structure
. |- /opt/redhat/ews/ |- bin |- doc |- etc |- lib |- lib64 (present only for x86_64 systems platforms) |- include |- README |- man |- share |- tomcat5 |- tomcat6 |- extras |- java |- sbin |- var
- Native Solaris packages require the absolute location
- Solaris (and other non-Red Hat Enterprise Linux platforms) must ship and build all the dependent components such as
openldap
,openssl
,db4
andcyrus-sasl
.
Part II. Upgrade
- for Red Hat Enterprise Linux Chapter 6, Upgrading Enterprise Web Server on Red Hat Enterprise Linux
Chapter 6. Upgrading Enterprise Web Server on Red Hat Enterprise Linux
6.1. Upgrading ZIP Installation
- Back up your applications and custom settings.
- Install the new JBoss Enterprise Web Server version (refer to Section 3.2, “Installing Enterprise Web Server from a ZIP File”).
- Copy the applications and custom settings to the directory with the new JBoss Enterprise Web Server installation.
- Make sure all applications work correctly before removing their backups.
6.2. Upgrading RPM Installation
Note
Procedure 6.1. Upgrading JBoss Enterprise Web Server on Red Hat Enterprise Linux 5
- At the shell prompt, become the root user.
- Run the following command to remove the classpathx-jaf package:
# yum remove classpathx-jaf
- Run the upgrade command:
# yum upgrade
Procedure 6.2. Upgrading JBoss Enterprise Web Server on Red Hat Enterprise Linux 4
- At the shell prompt, become the root user.
- Run the following command:
# up2date -u
Chapter 7. Upgrading Enterprise Web Server on Windows
- Back up your applications and custom settings.
- Install the new JBoss Enterprise Web Server version (refer to Chapter 4, Installing Enterprise Web Server on Windows).
- Copy the applications and custom settings to the directory with the new JBoss Enterprise Web Server installation (
C:\Program Files\Red Hat\Enterprise Web Server
). - Make sure all applications work correctly before removing the backup.
Chapter 8. Upgrading Enterprise Web Server on Solaris
- Back up your applications and custom settings.
- Install the new JBoss Enterprise Web Server version (refer to Chapter 5, Installing Enterprise Web Server on Solaris).
- Copy the applications and custom settings to the directory with the new JBoss Enterprise Web Server installation (
/opt/redhat/ews/
). - Make sure all the applications work correctly before removing the backup.
Chapter 9. Hibernate on Enterprise Web Server
context.xml
). However, persistence.xml
and web.xml
are required. The example below shows a setting with tomcat connection pooling mechanism.
/META-INF/context.xml
defines the connection pools Tomcat should create.Example 9.1. context.xml
<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>
/WEB-INF/classes/META-INF/persistence.xml
is a JPA configuration file. It defines how the application configures Hibernate to consume connections from the Tomcat pool. If you are using Hibernate API directly, use a similar configuration inhibernate.cfg.xml
.Example 9.2. persistence.xml
<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>
/WEB-INF/web.xml
is a regular web application deployment file, which tells Tomcat which datasource it consumes. In Example 9.3, “web.xml” the datasource isjdbc/DsWebAppDB
.Example 9.3. web.xml
<?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>
Chapter 10. Monitoring Enterprise Web Server with JBoss Operating Network
Procedure 10.1. Configuring User Permissions on a Unix Operating System
Note
httpd
and Tomcat directories.
- At the shell prompt, become the root user.
- Run the following command to add the user, under which JON Agent runs to the tomcat and apache user groups:
# useradd -G tomcat,apache <RHQ_AGENT_USER>
Procedure 10.2. Configuring Monitoring
- Open the
startup
file of the respective JBoss Enterprise Web Server instance for editing:- on Red Hat Enterprise Linux installed from a ZIP file open
$EWS_HOME/tomcat<VERSION>/bin/startup.sh
- on Red Hat Enterprise Linux installed from a RPM files open
/usr/sbin/tomcat<VERSION>
- on Solaris open
/opt/redhat/ews/tomcat<VERSION>/bin/startup.sh
- on Windows open
C:\Program Files\Red Hat\Enterprise Web Server\sbin\tomcat<VERSION>.sh
- Define an available port for JMX monitoring. Make sure it is not blocked by any firewall. To do so, to the JAVA_OPTS variable in the startup file, add the following line and substitute PORT_NUMBER with the number of the port dedicated to monitoring:
- on Red Hat Enterprise Linux and Solaris:
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.port=PORT_NUMBER"
- on Windows:
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.port=PORT_NUMBER"
- If you want to disable authentication and SSL for development purposes, add the following lines to the JAVA_OPTS variable in the startup file:
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.ssl=false" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.authenticate=false"
Important
In production environments, add the following lines to the JAVA_OPTS variable in the startup file to secure JMX with SSL and restrict the access with a firewall:- on Red Hat Enterprise Linux and Solaris
JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.access.file=$EWS_HOME/jmxremote.access" JAVA_OPTS="${JAVA_OPTS} -Dcom.sun.management.jmxremote.password.file=$EWS_HOME/jmxremote.password"
- on Windows:
set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.access.file=c:\Program Files\Red Hat\Enterprise Web Server\jmxremote.access" set "JAVA_OPTS=%JAVA_OPTS% -Dcom.sun.management.jmxremote.password.file=c:\Program Files\Red Hat\Enterprise Web Server\jmxremote.password"
Note
The JON httpd plugin needs a specific directory to monitor the HTTP Server:- on Solaris and Red Hat Enterprise Linux:
/etc/httpd
- on Windows:
C:\apache
If the respective directory does not exist, create it before launching the JON agent.For further information about JBoss Operating Network refer to the Discovery chapter of the Basic Administration Guide.
Appendix A. Supported HTTP Modules
- mod_filter.so
- mod_filter.so
- mod_substitute.so
- mod_version.so
- mod_usertrack.so
- mod_authn_alias.so
- mod_vhost_alias.so
- mod_headers.so
- mod_authz_host.so
- mod_dumpio.so
- mod_ssl.so
- mod_userdir.so
- mod_authn_dbd.so
- mod_env.so
- mod_ldap.so
- mod_expires.so
- mod_logio.so
- mod_authn_default.so
- mod_proxy_scgi.so
- mod_negotiation.so
- mod_disk_cache.so
- mod_authn_file.so
- mod_autoindex.so
- mod_auth_basic.so
- mod_proxy_http.so
- mod_setenvif.so
- mod_proxy.so
- mod_suexec.so
- mod_dav.so
- mod_asis.so
- mod_alias.so
- mod_proxy_balancer.so
- mod_log_forensic.so
- mod_mime_magic.so
- mod_deflate.so
- mod_proxy_connect.so
- mod_dav_fs.so
- mod_cgi.so
- mod_dbd.so
- mod_mem_cache.so
- mod_cgid.so
- mod_auth_digest.so
- mod_authz_owner.so
- mod_include.so
- mod_proxy_ajp.so
- mod_reqtimeout.so
- mod_authn_anon.so
- mod_status.so
- mod_cern_meta.so
- mod_log_config.so
- mod_cache.so
- mod_dir.so
- mod_proxy_ftp.so
- mod_ext_filter.so
- mod_authz_user.so
- mod_mime.so
- mod_unique_id.so
- mod_authz_default.so
- mod_ident.so
- mod_file_cache.so
- mod_speling.so
- mod_actions.so
- mod_authnz_ldap.so
- mod_authn_dbm.so
- mod_rewrite.so
- mod_authz_groupfile.so
- mod_imagemap.so
- mod_info.so
- mod_authz_dbm.so
Appendix B. Revision History
Revision History | |||||
---|---|---|---|---|---|
Revision 1.0.2-61 | Wed Feb 11 2015 | Lucas Costi | |||
| |||||
Revision 1.0.2-59 | Thu Sep 05 2013 | Mandar Joshi | |||
| |||||
Revision 1.0.2-53 | Thu Jul 21 2011 | Rebecca Newton | |||
| |||||
Revision 1.0.2-50 | Tue Jun 21 2011 | Rebecca Newton | |||
|