Ce contenu n'est pas disponible dans la langue sélectionnée.
2.0.0 Release Notes
Red Hat JBoss Web Server 2
Release Notes for Red Hat JBoss Web Server 2.0.0
Edition 2
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 Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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.
1.2. Product Documentation Locations Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
JBoss Enterprise Web Server includes multiple types of documentation, as follows:
- The JBoss Enterprise Web Server Product Documentation. This documentation is available at the Red Hat Customer Support Portal's JBoss Enterprise Web Server page.
- The
jboss-ews-docs-2.0.0.zip
file contains documentation about the following:- httpd
- mod_auth_kerb
- mod_cluster
- mod_jk
- openssl
- tomcat6
- tomcat7
- tomcat-native
- mod_ssl documentation is also available at the location
doc/httpd/mod/
mod_ssl.html
.
Chapter 2. New Features Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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
andcatalina-ha.jar
files have been removed. This eliminates the possibility of session replication.
3.2. Removed Items Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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 Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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, thecatalina.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
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 Copied! Toggle word wrap Toggle overflow - 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.
[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 Copied! Toggle word wrap Toggle overflow This occurs due to an old version of theapr
library available in Red Hat Enterprise Linux 6. As a workaround, use RHN to get the packageapr-devel-1.3.9-5.el6_2
or newer, which fixes this problem. Users without access to RHN cannot access theapr
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
/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 Copied! Toggle word wrap Toggle overflow 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
Invalid JVM name specified server Cannot locate JVM library file Service exit with a return value of 1
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 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 whenrecover_time
is set to a value greater than60
seconds and is greater than the value ofworker.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 theworker.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]
/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 Copied! Toggle word wrap Toggle overflow As a workaround for this issue, copyjsvc
fromjboss-ews-2.0/sbin/jsvc
tojboss-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
cmd=update&mime=prop&w=router&att=vwa&val0=1&val1=1
Copy to Clipboard Copied! Toggle word wrap Toggle overflow 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 calledjasper-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
andtomcat%{name}-el-api-%{version}.jar
point to a common target within the tomcat libraries in/usr/share/java
. As a result, thealternatives
package points to theEL API
library in/usr/share/java
as does the link from/usr/share/tomcat${version}/lib
.Tomcat%{version} installsel_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 theel_api
that is different from the one they expect.This does not affect theel-api
library used by tomcat%{version}, but does affect users ofalternatives/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 themanager.xml
andhost-manager.xml
files. This occurs because the parent directory of these files (/etc/tomcat6/Catalina/localhost
) is owned by the userroot
instead of the expected usertomcat
.A workaround for this issue is to modify permissions for theCatalina
directory as follows:cd /etc/tomcat6; chmod -R tomcat Catalina
# cd /etc/tomcat6; chmod -R tomcat Catalina
Copy to Clipboard Copied! Toggle word wrap Toggle overflow After successfully changing the permissions for the directory, run the commandservice 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
:
inserver.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 setmaxKeepAliveRequests="1"
inserver.xml
, setsmax
to0
in mod_cluster worker configuration, setSetEnv proxy-nokeepalive 1
andSetEnv proxy-initial-not-pooled 1
in your httpd configuration.
4.2. Known Issues for the JBoss Operations Network Plugin Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 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:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 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:
Copy to Clipboard Copied! Toggle word wrap Toggle overflow - 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 theoption in the menu does not result in any updates to the
agent.log
file or theserver.xml
file.This occurs because theStoreConfig
MBean used to persist changes toserver.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 thestoreConfig
method from the storeConfig MBean.
Appendix A. Revision History Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
Revision History | |||
---|---|---|---|
Revision 2-1.29 | Wed Feb 11 2015 | ||
| |||
Revision 2-1.28 | Tue Nov 6 2012 | ||
|
Legal Notice Copier lienLien copié sur presse-papiers!
Copier lienLien copié sur presse-papiers!
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.