About Application Server Platform Edition 8.2 2006Q1

The Sun Java System Application Server Platform Edition 8.2 2006Q1 is a J2EE 1.4 platform-compatible server for the development and deployment of J2EE applications and Java technology-based web services.

This section includes:

• What’s New in the 8.2 Release

• Bugs Fixed in the 8.2 Release

• J2EE Support

• Hardware and Software Requirements

• Switching to J2SE 5.0

• Related Documentation

What’s New in the 8.2 Release

The Sun Java System Application Server Platform Edition 8.2 2006Q1 implements many new features:

• J2EE 1.4 Platform Support– This release implements all of the specifications covered by the J2EE 1.4 platform.

• JavaServer Faces 1.1 Support– All levels of developers can quickly build web applications by assembling reusable UI components in a page, connecting these components to an application data source, and wiring client-generated events to server-side event handlers.

• Java Web Services Developer Pack 1.6 (JWDSP) Plugin Support — All JWSDP plugins are now supported.

• JavaServer Pages Standard Tag Library 1.1 Support– The Application Server supports the JavaServer Pages Standard Tag Library (JSTL) 1.1, which encapsulates core functionality common to many JSP applications.

• Administrative Tools– The Application Server includes a command-line tool and a browser-based Administration Console interface.

• High Performance Message Delivery– The Application supports concurrent message delivery with the Sun Java System Message Queue software.

• Developer Tool Integration– The Application Server supports the NetBeans IDE and Sun Java Studio Creator.

• Admin Console GUI Enhancements– The Admin Console’s new capabilities include an improved log viewer, a JNDI namespace browser, and a GUI for monitoring.

• Web Services Security– These container message security mechanisms implement message-level authentication (e.g. XML digital signature and encryption) of SOAP web services invocations using the X509 and username/password profiles of the OASIS WS-Security standard.

• WS-I Basic Profile 1.1– This release implements Web Services Interoperability (WS-I) Basic Profile 1.1 to enable interoperability for web services applications.

• Migration Tool– The migration tool helps in moving applications running on other application servers such as JBoss, WebLogic and Websphere to this release of the Sun Java System Application Server.

Bugs Fixed in the 8.2 Release

4887079

Programmatic APIs for deploying/undeploying & finding out which apps are deployed

4911462

CLI: Incorrect message when port outside of available range

4911462

CLI: Incorrect message when port outside of available range

4918535

sun-appserv-deploy doesn't take flag to support createAndDropTables

4939749

xml:lang value should not be inserted automatically by the deploytool

4946914

8.1SE/EE: Deployment support for cluster

4979136

PERF: directory based deployment copies the application in a backup directory

4987274

S1AS7: Deployment fails if remote interface for the bean is named Util

4988818

151 TP Runtime tests fail when J2SE 1.5 is used

4992295

Deploying a system component succeeds on CLI but error logged in server's log file

4994790

JSP deployed with precompilejsp=true does not use compiler flags in sun-web.xml

4996876

Verifier versus deploy with verify=true, different reports

5003356

Recent server.policy file updates are not accounted by upgrade tool

5006854

RN: asadmin deploy --virtualservers fails to deploy

5006854

RN: asadmin deploy --virtualservers fails to deploy

5007309

Inappropriate default value for HTTP listener acceptor threads

5007309

Inappropriate default value for HTTP listener acceptor threads

5008941

JSR88 start operation fails when an app is deployed again after an undeploy

5008941

jsr88 start operation fails when an app is deployed again after an undeploy

5016848

JDK's Jar file caching and unclosed files prevent some redeployments on Window

5017956

list -m at the jar module level does not list the EJB's

5030425

Deploydir ignores security-role-mapping changes

5041343

Not checking <servlet-mapping>'s <url-pattern-directory> always wrapped by /

5046120

SEVERE Log messages while deploying BV BigApps on AS 8.0 PE

6041268

No mechanism to disable HTTP TRACE

6062410

0PEUR1: i18n? - asupgrade launched in English

6067341

“deploydir” a web application with ejb-refs fails on rmic the remote interfaces

6152752

outofbound exception during SPECJ2004 test run

6154949

Connection Validation does not work with 8.1

6157310

Runtime reloads Collection field during relationship management

6165491

Failed to start a domain if it was created on a different path than the default domain

6171667

Lifecycle modules property elements are not created in domain.xml

6171729

Non-String RA ActivationSpec properties result in an IllegalArgumentException during MDB deployment

6172178

OSS/J TT TCK failed to get JMS connection factory from remote AS

6184864

EJB QL query returns no results using OR operator and expression contains null single-valued cmrs

6187224

Deployment returns undefined status code

6192538

type=bean-method,category=monitor registered before parent EJB

6197393

deploytool often won't create message-destination element in deployment descriptor

6198981

Missing xalan.jar file from CLASSPATH causes empty drop-downs and web service wizard to fail

6204799

Get guiframework exception when undeploy web-module if it is associated to virtual server

6207862

asadmin create-domain --help produces some CVS merge characters and is garbled.

J2EE Support

The Sun Java System Application Server 8.2 2006Q1 supports the J2EE 1.4 platform. The following table describes the enhanced APIs available on the J2EE 1.4 platform.

Table 1–2 Major API changes on the J2EE 1.4 Platform

API	Description
Components
Application and Application Client	Implementation of standard deployment descriptors by means of XML schemas
Enterprise JavaBeans (EJB) 2.1	Timer service and EJB Web-service endpoint
Java Servlet 2.4	Web-service endpoint filter
JavaServer Pages (JSP) 2.0 architecture	Expression language and tag library
J2EE Connector Architecture 1.5	Inbound resource adaptor and Java Message Service (JMS) pluggability
Web Services
Java Web Services Developer Pack 1.5	Integrated toolkit for building, testing and deploying XML applications, Web services, and Web applications
Java API for XML-based Remote Procedure Calls (JAX-RPC) 1.1	Mapping for WSDL and Java technology and support for development of Web-service clients and endpoints
WS-I Basic Profile 1.0	The enabling element for interoperability using WSDL and SOAP
SOAP with attachment API for Java (SAAJ) 1.2	An API for SOAP-based messaging; fosters the creation of SOAP messages with attachments
Java APIs for XML Registries (JAXR) 1.0	A uniform and standard API for accessing XML registries, such as those for Universal Description Discovery and Integration (UDDI and ebXML)
Other
J2EE Deployment 1.1	Standard APIs that enable deployments of J2EE components and applications
J2EE Management 1.0	Definitions for the information model for managing the J2EE platform
Java Management Extensions (JMX) 1.2	Standard management API
Java Authorization Contract for Containers (JACC) 1.0	Definitions of security contracts between a J2EE Application Server and the authorization policy provider
Java API for XML Processing (JAXP) 1.2	An API with which applications can parse and transform XML documents; also adds support for processing of XML schemas
JMS 1.1	A messaging standard that enables J2EE application components to create, send, receive, and read messages; also adds support for uniform APIs for queues and topics
JavaMail 1.3	A set of abstract classes that model a mail system; also includes minor updates to the APIs

Hardware and Software Requirements

This section lists the requirements that must be met before installing the Sun Java System Application Server Platform Edition 8.2 product.

• Platform Requirements

• System Virtualization Support

• Important Patch Information

• JDBC Drivers and Databases

• Configuring Oracle

• Configuring PointBase

• Web Servers

• Browsers

• Upgrading the Sun Java System Application Server

• Other Requirements

Platform Requirements

The following table lists the operating systems that are supported for Sun Java System Application Server Platform Edition 8.2 2006Q1 product.

Table 1–3 Supported Operating Systems

Operating System	Minimum Memory	Recommended Memory	Minimum Disk Space	Recommended Disk Space	JVM
Sun Solaris 8, 9, 10 (SPARC)Solaris 9, 10(x86)	256 MB	512 MB	250 MB free	500 MB free	J2SE 1.4.2_06
Sun Java Desktop System	256 MB	512 MB	250 MB free	500 MB free	J2SE 1.4.2_06
Redhat Enterprise Linux 2.1 Update 2, 3.0 Update 1	256 MB	512 MB	250 MB free	500 MB free	J2SE 1.4.2_06
Microsoft Windows 2000TM Advanced Server Service Pack 4+	256 MB	512 MB	250 MB free	500 MB free	J2SE 1.4.2_06
Microsoft Windows XPTM Professional Service Pack 1+	256 MB	512 MB	250 MB free	500 MB free	J2SE 1.4.2_06

On UNIX^TM, you can check your operating system version using the uname command. Disk space can be checked using the df command.

Solaris Patch Requirements

It is recommended that Solaris 8, 9, 10 (x86, SPARC) users have the “Sun recommended patch cluster” installed. This patch cluster is available under “Recommended and Security Patches” on the SunSolve web site.

RedHat Enterprise Linux 3.0 Additional Package Requirements

To run native components of this product, including installer, the following package, which is not part of the standard RedHat Enterprise Linux 3.0 distribution, should be installed: compat-libstdc++-7.3-2.96.118.i386.rpm

The package can be downloaded from http://rpm.pbone.net/index.php3/stat/4/idpl/843376/com/compat-libstdc++-7.3-2.96.118.i386.rpm.html

System Virtualization Support

System virtualization is a technology that enables multiple operating system (OS) instances to execute independently on shared hardware. Functionally, software deployed to an OS hosted in a virtualized environment is generally unaware that the underlying platform has been virtualized. Sun performs testing of its Sun Java System products on select system virtualization and OS combinations to help validate that the Sun Java System products continue to function on properly sized and configured virtualized environments as they do on non-virtualized systems. For information about Sun support for Sun Java System products in virtualized environments, see System Virtualization Support in Sun Java System Products.

Important Patch Information

For the current list of required patches for Sun Java System Application Server Platform Edition 8.2 go to http://sunsolve.sun.com and select either “Patches” or “Patch Portal.” Follow the Sun Java System Application Server Platform Edition 8.2 links. As operating system patch requirements change and patches to Java Enterprise System components become available, updates will be made available on SunSolve, initially in the form of recommended patch clusters.

JDBC Drivers and Databases

The Sun Java System Application Server Platform Edition is designed to support connectivity to any DBMS with a corresponding JDBC driver. For a list of components that Sun has tested and found to be acceptable for constructing J2EE-compatible database configurations, please refer to the following table:

Table 1–4 J2EE-Compatible JDBC Drivers

JDBC Vendor	JDBC Driver Type	Supported Database Server
i-net Software	Type 4	Oracle (R) 8.1.7, 9i, 9.2.0.3Sybase ASE 12.5.2Microsoft SQL Server 2000 4.0 Service Pack 1
IBM	Type 2	IBM DB2 8.1 Service Pack 3+
PointBase	Type 4	PointBase Network Server 4.8
DataDirect	Type 4	Oracle (R) 8.1.7, 9i, 9.2.0.3Sybase ASE 12.5.2Microsoft SQL ServerIBM DB2 8.1 Service Pack 3+
Oracle	Type 4, Type 2	Oracle (R) 9.2.0.3, 10G

For more information about i-net Software, see http://www.inetsoftware.de/.

For more information about DataDirect Technologies, see http://www.datadirect.com/.

Configuring Oracle

Oracle JDBC drivers must be configured properly to be compliant with J2EE 1.4. Use the following configuration for Type 2 and Type 4 drivers:

1. Use the JDBC driver from 9.2.0.3 or later.

2. The Oracle database needs to have compatible=9.0.0.0.0 or higher in its parameter ( init.ora) file.

3. Use the ojdbc14.jar file.

4. Configure the Application Server to define the following JVM property:

   -Doracle.jdbc.J2EE13Compliant=true

   In addition, for Type-2 drivers, both the ORACLE_HOME and LD_LIBRARY_PATH variables (which must include $ORACLE_HOME/lib) need to be defined in the environment in which the Application Server is started. For example, add them to the asenv.conf file and ensure they are exported.

Configuring PointBase

Many sample applications use the PointBase database server included with the Application Server. When using Application Server Enterprise Edition, you must configure the PointBase database server before using it. Before using PointBase with the Application Server, however, note the supported configuration combination.

Table 1–5 Supported J2SE/PointBase Combinations

Application Server	PointBase
Supported
J2SE 1.4 J2SE 5.0	J2SE 1.4 J2SE 1.4
Unsupported
J2SE 5.0	J2SE 5.0

There are two ways to configure PointBase:

• Set the JAVA_HOME environment variable to the location of the J2SE. The PointBase implementation bundled with Application Server 8.2 is only supported with J2SE 1.4.2.

• Edit the Application Server\qs PointBase configuration file.

  Using the first method:

To configure PointBase by setting JAVA_HOME

1. Make sure you have the J2SE installed that you want to use.

   Download J2SE 1.4.2 if you do not already have it.

2. Using the command appropriate for your operating system and shell, set the JAVA_HOME environment variable to the directory in which J2SE is installed; for example:

   % setenv JAVA_HOME "/opt/SUNWappserver/jdk"

   To use the second method, the procedure depends on the operating system.

Solaris and Linux

Edit the install_dir/pointbase/tools/serveroption/pbenv.conf configuration file, changing the line:

PB_JAVA=%%%PB_JAVA%%%

to

PB_JAVA=J2SE_location

where J2SE_location is the directory where the J2SE is installed. If you installed J2SE with Application Server, it is installed by default to install_dir/jdk. After making this change, you can start PointBase using the startserver script.

Windows

Edit the install_dir\\pointbase\\tools\\serveroption\\pbenv.bat configuration file, changing the line:

set PB_JAVA=%%%PB_JAVA%%%

to

set PB_JAVA=J2SE_location

where J2SE_location is the directory in which the J2SE is installed. If you installed J2SE with Application Server, it is installed by default to install_dir\\j2se1.4. After making this change, you can start PointBase by running startserver.bat.

Web Servers

This section lists the web servers that are supported for the Sun Java System Application Server Platform Edition 8.2 2006Q1.

Table 1–6 Supported Web Servers

Web Server	Version	Operating System
Sun Java System Web Server	6.0 Service Pack 6+	Solaris SPARC 8 9, 10Solaris x86 9, 10Red Hat Enterprise Linux 2.1 Update 2, 3.0 Update 1
Apache Web Server	1.3+, 1.4, 2.0	Solaris SPARC 9, 10 x86, Red Hat Enterprise Linux 2.1 Update 2, 3.0 Update 1
Microsoft IIS	5.0+	Windows Server 2003Windows 2000 Advanced Server Service Pack 4+

Support for additional platforms, including Windows and HP-UX, will be available at a later date.

Browsers

This section lists the browsers that are supported with the Sun Java System Application Server Platform Edition 8.2 2006Q1.

Table 1–7 Browsers Supported

Browser	Version
Mozilla	1.4, 1.5, 1.6, 1.7.x
Netscape Navigator	4.79, 6.2, 7.0
Internet Explorer	5.5 Service Pack 2, 6.0

Upgrading the Sun Java System Application Server

Refer to the Installation Guide for complete instructions for upgrading from a previous version of the Application Server to the Sun Java System Application Server Platform Edition 8.2 2006Q1.

Other Requirements

The following additional requirements should be met before installing the Sun Java System Application Server software.

• Free space– your temporary directory must have a minimum of 35MB free for Sun Java System Application Server installation, and 250 MB of free space for the SDK installation.

• Using the uninstall program– If you need to remove the Application Server from your system, it is important to use the uninstall program that is included with the software. If you attempt to use another method, problems will arise when you try to reinstall the same version, or when you install a new version.

• Free ports– You must have seven unused ports available.

  • The installation program automatically detects ports in use and suggests currently unused ports for the default settings. By default, the initial default ports are 8080 for HTTP, 8181 for HTTPS, and 4849 for the Administration Server.

  • The installation program will detect used ports and assign two others for you: Sun JavaTM System Message Queue (by default, 7676), and IIOP (by default, 3700 for IIOP and 3820 and 3890 for IIOP/SSL). If these default port numbers are in use, the installation program will assign a random port number from the dynamic port range (note that this may not be the next available port number).

  Starting previously-installed servers (UNIX) – Unless you are replacing the previously installed server, you should start it before you begin the Sun Java System Application Server 8.2 installation process. This allows the installation program to detect ports that are in use and avoid assigning them for other uses.

• Replacing previously-installed servers (UNIX) – If you have an older version on the Sun Java System Application Server installed that you wish to replace with the current Application Server, you should stop it before installing the new server. Use the installation program upgrade wizard to upgrade the server.

• Shutting down firewall (Microsoft Windows) – You must stop any firewall software before installing the Sun Java System Application Server software, because some of this software disables all ports by default. The installation program must be able to accurately determine which ports are available.

  For further compatibility information, see the Sun Java System Application Server Platform Edition 8.2 Upgrade and Migration Guide.

Switching to J2SE 5.0

Sun Java System Application Server 8.2 2006Q1 supports J2SE 5.0 as the underlying JVM, however the bundled PointBase database does not. If you want to use J2SE 5.0 instead of the bundled J2SE 1.4.2 to run the Application Server, perform the following steps (Windows and Unix):

To switch to J2SE 5.0

1. Download the J2SE 5.0 SDK (not the JRE) and install it on your system, if you have not already done so.

   The J2SE 5.0 SDK can be downloaded from http://java.sun.com/j2se/1.5.0/.

2. Completely stop the Application Server.

   You can use the following command line:

   as-install/bin/asadmin stop-domain

   or the Administration Console GUI:

   1. Click the Application Server node.

   2. Click Stop Instance.

3. Edit the install_dir /config/asenv.conf file ( asenv.bat on Windows), changing the value for AS_JAVA to point to the J2SE 5.0 home directory:

4. Edit the as-install /samples/common.properties file, changing the line beginning com.sun.aas.javaRoot... to reference the J2SE 5.0 home directory.

5. Restart the Application Server.

   as-install/bin/asadmin start-domain

   ---

   Note –

   If you are upgrading from a JDK version earlier than the bundled version (JDK 1.4.2_06) then you cannot upgrade to J2SE 5.0 using just the steps above. Specifically, in addition to the above steps, you must delete any existing domains and recreate them.

   ---

Related Documentation

In addition to these release notes, the Application Server Platform Edition 8.2 Update 2 product includes an entire set of documentation that can be found at http://docs.sun.com/app/docs/coll/1343.1.

The following table summarizes the books included in the Application Server Platform Edition 8.2 Update 2 documentation set.

Table 1–8 Books in This Documentation Set

Book Title	Description
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Quick Start Guide	How to get started with the Sun Java System Application Server product.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Installation Guide	Installing the Sun Java System Application Server software and its components.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer’s Guide	Creating and implementing Java™ 2 Platform, Enterprise Edition (J2EE™ platform) applications intended to run on the Sun Java System Application Server that follow the open Java standards model for J2EE components and APIs. Includes general information about developer tools, security, assembly, deployment, debugging, and creating lifecycle modules.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 J2EE Tutorial	Using J2EE 1.4 platform technologies and APIs to develop J2EE applications and deploying the applications on the Sun Java System Application Server.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Administration Guide	Configuring, managing, and deploying the Sun Java System Application Server subsystems and components from the Administration Console.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Administration Reference	Editing the Sun Java System Application Server configuration file, domain.xml.
Sun Java System Application Server Platform Edition 8.2 Upgrade and Migration Guide	Migrating your applications to the new Sun Java System Application Server programming model, specifically from Application Server 6.x and 7. This guide also describes differences between adjacent product releases and configuration options that can result in incompatibility with the product specifications.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Troubleshooting Guide	Solving Sun Java System Application Server problems.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Error Message Reference	Solving Sun Java System Application Server error messages.
Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Reference Manual	Utility commands available with the Sun Java System Application Server; written in manpage style. Includes the asadmin command line interface.