Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

2.0.0 Release Notes

Red Hat JBoss Web Server 2

Release Notes for Red Hat JBoss Web Server 2.0.0

Edition 2

Misha Husnain Ali

Abstract

These release notes contain important information related to Red Hat JBoss Web Server 2.0.0. Read these Release Notes in their entirety before installing Red Hat JBoss Web Server 2.0.0.

Chapter 1. Introduction
Copy link

These release notes contain important information related to JBoss Enterprise Web Server 2.0. New features, known problems, resources, and other current issues are addressed here.

1.1. Overview
Copy link

JBoss Enterprise Web Server is a fully-integrated and certified set of components for hosting Java web applications. It is comprised of the industry's leading web server (Apache HTTP Server), the popular Apache Tomcat Servlet container as well as load balancers (mod_jk and mod_cluster), Hibernate, the Tomcat Native library and others.
Supported Configurations

For a comprehensive list of supported configurations for JBoss Enterprise Web Server 2.0, refer to the JBoss Enterprise Web Server Supported Configurations page.

Chapter 2. New Features
Copy link

The following is a list of new features available in JBoss Enterprise Web Server 2.0:
  • The inclusion of Tomcat 7.
  • The inclusion of Hibernate.
  • SELinux policies for Apache HTTPD and Tomcat 6 and 7.
  • Updated versions of Apache HTTPD and Tomcat 6.
  • An updated version of the mod_cluster connector.
  • Support for Solaris 11.
  • The addition of mod_auth_kerb for better integration with Red Hat Enterprise Linux and Solaris.

Chapter 3. Excluded and Removed Items
Copy link

This section outlines the items which are excluded from this release, deprecated or removed. In order to maintain a high level of backwards compatibility and customer service, an item will usually be deprecated before it is removed from a release.

Note

The difference between an excluded item and a removed item is that an excluded item is one that is commonly a part of a component of the JBoss Enterprise Web Server but has never featured within a JBoss Enterprise Web Framework release. However, a removed item is one that has previously been in a release of the JBoss Enterprise Web Server and is no longer included.

3.1. Excluded Items
Copy link

The following items have been excluded from this release of the JBoss Enterprise Web Server:
  • Tomcat Clustering has been excluded from the Apache Tomcat 6 and 7 component. Specifically the catalina-tribes.jar and catalina-ha.jar files have been removed. This eliminates the possibility of session replication.

3.2. Removed Items
Copy link

The following http modules have been removed from the Red Hat Enterprise Linux 5 and 6 distribution of this release of JBoss Enterprise Web Server:
  • mod_file_cache
  • mod_imagemap
  • mod_mem_cache
  • Tomcat 5 (this has been removed and replaced with Tomcat 7)

Note

mod_disk_cache can be used instead of mod_file_cache and mod_mem_cache.

Chapter 4. Known Issues
Copy link

This chapter contains a description of known issues in JBoss Enterprise Web Server 2.0. Where available, these issues include workarounds.

4.1. General Known Issues
Copy link

The following is a list of known issues in JBoss Enterprise Web Server 2:
JBPAPP-10084 - IPv6 :: address slowing down Tomcat6/7 on MS Windows
When an IPv6 address is used to start Tomcat 6 or 7 on Windows (for example <Connector port="8080" protocol="HTTP/1.1" address="::" />) and results in a significantly slower shutdown process when the user shuts down Tomcat. During the shutdown process, the catalina.log file logs a warning for this shutdown: 
WARNING: Acceptor thread [http-0%3A0%3A0%3A0%3A0%3A0%3A0%3A0-8080-Acceptor-0] failed to unlock. Forcing hard socket shutdown
Copy to Clipboard Toggle word wrap
JBPAPP-3628 - /host-manager application doesn't persist newly created virtual hosts
When a virtual host is created using the /host-manager/html application, all actions work as expected, but the newly created host is not persistently added to the Tomcat configuration. Only the localhost is listed after server restart.
As a workaround for persistence issues, virtual hosting can be managed manually.
JBPAPP-10131 - mod_jk doesn't support IPv6
The version of mod_jk included with JBoss Enterprise Web Server 2 does not support IPv6. This is an upstream bug.
JBPAPP-10112 - mod_cluster: advertising doesn't work in mixed IPv4/IPv6 setting
When using JBoss Enterprise Web Server with Red Hat Enterprise Linux 5 and 6, advertising using mod_cluster fails when IPv6 is used by itself and when a mixed protocol setting (IPv4 and IPv6) is used. The following error message displays in the error_log: 
[error] (22)Invalid argument: mod_advertise: ma_group_join apr_mcast_hops failed
[error] (22)Invalid argument: mod_advertise: multicast join failed for ff01::1:25533.
Copy to Clipboard Toggle word wrap
This occurs due to an old version of the apr library available in Red Hat Enterprise Linux 6. As a workaround, use RHN to get the package apr-devel-1.3.9-5.el6_2 or newer, which fixes this problem. Users without access to RHN cannot access the apr package version that fixes this problem
JBPAPP-10235 - Tomcat[6,7]: Start with security manager fails on RHEL with jdk-ibm16,ibm17
When using JBoss Enterprise Web Server with Red Hat Enterprise Linux with either the IBM JDK 1.6 or 1.7, the startup.sh -security command does not start tomcat (6 or 7) as expected and produces exceptions in the logs.
JBPAPP-10280 - Jsvc doesn't work with ibm jdk
Attempting to start jsvc on JBoss Enterprise Web Server using Red Hat Enterprise Linux 5 or 6 with the IBM JDK 1.6 or 1.7 fails. Specifically the failure occurs when jsvc is started using a command similar to the following: 
/opt/ews/workspace/jboss-ews-2.0/extras/jsvc   -showversion -cp /opt/ews/workspace/jboss-ews-2.0/tomcat6/bin/bootstrap.jar  -outfile /opt/ews/workspace/jboss-ews-2.0/tomcat6/logs/catalina.out -errfile /opt/ews/workspace/jboss-ews-2.0/tomcat6/logs/catalina.err -pidfile /opt/ews/workspace/jboss-ews-2.0/tomcat6/tomcat6.pid   -user hudson  -Dcatalina.home=/opt/ews/workspace/jboss-ews-2.0/tomcat6 -Djava.io.tmpdir=/opt/ews/workspace/jboss-ews-2.0/tomcat6/temp -jvm server org.apache.catalina.startup.Bootstrap
Copy to Clipboard Toggle word wrap
In the error file (specified by the -errfile option in the command), the following error appears: 
Invalid JVM name specified server
Cannot locate JVM library file
Service exit with a return value of 1
Copy to Clipboard Toggle word wrap
JBPAPP-9704 - Mod_jk: recover_time is not properly used
The recover_time value is only applied correctly once (the first time). The problem manifests when recover_time is set to a value greater than 60 seconds and is greater than the value of worker.maintain. After the first recover attempt passes and the worker errors back out to its global error state, the worker will be placed in recovery mode again on the next invocation of the worker.maintain method.
JBPAPP-9814 - Tomcat7: daemon.sh startup error
When using JBoss Enterprise Web Server with Red Hat Enterprise Linux, starting tomcat7 as a jsvc service using the daemon.sh script fails and displays the following error: 
/opt/jboss-ews-2.0/share/tomcat7/bin/daemon.sh[186]: /opt/jboss-ews-2.0/share/tomcat7/bin/jsvc: not found [No such file or directory]
Copy to Clipboard Toggle word wrap
As a workaround for this issue, copy jsvc from jboss-ews-2.0/sbin/jsvc to jboss-ews-2.0/share/tomcat7/bin.
JBPAPP-9703 - JK status manager - mass nodes handling works strange
Attempts to manage multiple nodes using the status manager URL such as the following does not work correctly: 
cmd=update&mime=prop&w=router&att=vwa&val0=1&val1=1
Copy to Clipboard Toggle word wrap
As a workaround for this problem, use the status manager's web interface instead.
JBPAPP-10316 - hibernate-dist.zip contains different hibernate-release-4.1.3.Final-redhat-1/lib/required/ant-antlr.jar
The ant-antlr.jar file, while packaged and shipped in the ZIP installation files, is not supported in JBoss Enterprise Web Server 2.0.
JBPAPP-10311 - jaspter-jdt.jar
The file jaspter-jdt.jar is packaged in JBoss Enterprise Web Server's Tomcat 7 library for Windows and Solaris and Red Hat Enterprise Linux 6 ZIP installation files. Additionally, in the Red Hat Enterprise Linux 5 ZIP files, the file is included in both the Tomcat 6 and 7 libraries. jaspter-jdt.jar should be called jasper-jdt.jar but the spelling error does not affect its function in JBoss Enterprise Web Server.
JBPAPP-10315 - Tomcat6 el-api.jar is linked to Tomcat7 version
In JBoss Enterprise Web Server, both alternatives/el_api and tomcat%{name}-el-api-%{version}.jar point to a common target within the tomcat libraries in /usr/share/java. As a result, the alternatives package points to the EL API library in /usr/share/java as does the link from /usr/share/tomcat${version}/lib.
Tomcat%{version} installs el_api in alternatives using the same name: el_api. Therefore, either can overwrite the other without the user knowing it. As a result, alternatives/el_api users may receive a version of the el_api that is different from the one they expect.
This does not affect the el-api library used by tomcat%{version}, but does affect users of alternatives/el_api.
JBPAPP-10334 - Problem with manager, host-manager in Tomcat6 installed from EWS2.0 RPMs
When JBoss Enterprise Web Server 2.0 is installed using RPMs in Red Hat Enterprise Linux 5 or 6 and Tomcat 6 is started, deployment of the manager and host-manager fail with a Permission denied error for the manager.xml and host-manager.xml files. This occurs because the parent directory of these files (/etc/tomcat6/Catalina/localhost) is owned by the user root instead of the expected user tomcat.
A workaround for this issue is to modify permissions for the Catalina directory as follows: 
# cd /etc/tomcat6; chmod -R tomcat Catalina
Copy to Clipboard Toggle word wrap
After successfully changing the permissions for the directory, run the command service tomcat6 start to run Tomcat 6.
JBPAPP-9958 - Tomcat6/7 doesn't allow character ':' in several properties (server.xml)
JBoss Enterprise Web Server's version of Tomcat6/7 does not allow the character : in server.xml for hostname specifications. Normally, the character is used as a delimiter for IPv6 addresses.
JBPAPP-10321 - mod_cluster returns "Bad Gateway" HTTP ErrorCode 502 with https
mod_cluster returns a HTTP error 502 (Bad Gateway) after a period of inactivity if only HTTPS connector is enabled for balancer-worker communication. Httpd tries to re-use a connection that has already been closed already. SSL handshake fails and HTTP error is triggered.
As a workaround, either allow AJP connector on all workers or set maxKeepAliveRequests="1" in server.xml, set smax to 0 in mod_cluster worker configuration, set SetEnv proxy-nokeepalive 1 and SetEnv proxy-initial-not-pooled 1 in your httpd configuration.
The following is a list of known issues in JBoss Enterprise Web Server 2 for the JBoss Operations Network plugin:
BZ-865460 - Cannot add a Group to tomcat7's UserDatabase
Adding a User Group using the JBoss Operations Network (JON) interface in JBoss Enterprise Web Server results in the following error in the agent's log: 
2012-10-11 09:35:28,596 DEBUG [ResourceFactory.executor-1] (rhq.core.pc.inventory.CreateResourceRunner)- Throwable was found in creation report for request [10083].
java.lang.IllegalStateException: Name [roles] specified for parameter of operation [createGroup] on MBean [Users:type=UserDatabase,database=UserDatabase] is invalid. The MBean operation does not take a parameter by that name.
	at org.rhq.plugins.jmx.MBeanResourceComponent.invokeOperation(MBeanResourceComponent.java:576)
	at org.rhq.plugins.jmx.MBeanResourceComponent.invokeOperation(MBeanResourceComponent.java:524)
	at org.jboss.on.plugins.tomcat.TomcatUserDatabaseComponent.createResource(TomcatUserDatabaseComponent.java:68)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:616)
	at org.rhq.core.pc.inventory.ResourceContainer$ComponentInvocationThread.call(ResourceContainer.java:634)
	at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:334)
	at java.util.concurrent.FutureTask.run(FutureTask.java:166)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1110)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:603)
	at java.lang.Thread.run(Thread.java:679)
Copy to Clipboard Toggle word wrap
BZ-865403 - Cannot add a User to tomcat6's UserDatabase
Adding a user using the JBoss Operations Network (JON) interface used in JBoss Enterprise Web Server results in the following error in the agent log: 
2012-10-11 06:58:40,373 DEBUG [ResourceFactory.executor-1] (rhq.core.pc.inventory.CreateResourceRunner)- Throwable was found in creation report for request [10032].
java.lang.IllegalStateException: Name [roles] specified for parameter of operation [createUser] on MBean [Users:type=UserDatabase,database=UserDatabase] is invalid. The MBean operation does not take a parameter by that name.
	at org.rhq.plugins.jmx.MBeanResourceComponent.invokeOperation(MBeanResourceComponent.java:576)
	at org.rhq.plugins.jmx.MBeanResourceComponent.invokeOperation(MBeanResourceComponent.java:524)
	at org.jboss.on.plugins.tomcat.TomcatUserDatabaseComponent.createResource(TomcatUserDatabaseComponent.java:68)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:616)
	at org.rhq.core.pc.inventory.ResourceContainer$ComponentInvocationThread.call(ResourceContainer.java:634)
	at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:334)
	at java.util.concurrent.FutureTask.run(FutureTask.java:166)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1110)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:603)
Copy to Clipboard Toggle word wrap
BZ-865454 - Cannot manage tomcat7's deployed web applications
For the ZIP version of JBoss Enterprise Web Server, all deployed web applications unexpectedly appear "unavailable" and management operations applies to them are ineffective. As an example, a stop operation on a running web application results in the following error: 
java.lang.IllegalStateException: Could not find MBean for WAR '//localhost/my-simple-webapp'.
	at org.jboss.on.plugins.tomcat.TomcatWarComponent.invokeOperation(TomcatWarComponent.java:350)
	at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
	at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
	at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
	at java.lang.reflect.Method.invoke(Method.java:616)
	at org.rhq.core.pc.inventory.ResourceContainer$ComponentInvocationThread.call(ResourceContainer.java:634)
	at java.util.concurrent.FutureTask$Sync.innerRun(FutureTask.java:334)
	at java.util.concurrent.FutureTask.run(FutureTask.java:166)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1110)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:603)
	at java.lang.Thread.run(Thread.java:679)
Copy to Clipboard Toggle word wrap
BZ-583996 - EWS Tomcat: "Store Configuration" operation doesn't appear to do anything?
In a running implementation of JBoss Enterprise Web Server on Solaris, selecting the Store Configuration option in the Operations menu does not result in any updates to the agent.log file or the server.xml file.
This occurs because the StoreConfig MBean used to persist changes to server.xml is not included in the version of Tomcat that ships with JBoss Enterprise Web Server.
JBPAPP-10181 - javax.management.InstanceNotFoundException: Catalina:type=StoreConfig
When using Tomcat 6 and 7 in JBoss Enterprise Web Server, configuration changes made using the JBoss Operations Network (JON) agent do not persist into XML. Configuration changes made through a remote JMX interface also do not persist to server.xml because this requires calling the storeConfig method from the storeConfig MBean.

Appendix A. Revision History
Copy link

Revision History
Revision 2-1.29Wed Feb 11 2015Lucas Costi
Updated the Product Name to reflect the new name grouping for the product. No update was made to details in the guide.
Revision 2-1.28Tue Nov 6 2012Misha Husnain Ali
Updated supported configuration page link.

Legal Notice
Copy link

Copyright © 2011 Red Hat, Inc.
This document is licensed by Red Hat under the Creative Commons Attribution-ShareAlike 3.0 Unported License. If you distribute this document, or a modified version of it, you must provide attribution to Red Hat, Inc. and provide a link to the original. If the document is modified, all Red Hat trademarks must be removed.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat Software Collections is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat