Sun Java System Application Server Platform Edition 8.2 Release Notes


The package-appclient script does not work if domain1 is not present. (ID 6171458)

By default, there is a hard-coded value in $INSTALL/lib/package-appclient.xml for the AS_ACC_CONFIG variable for domain1 that is pointed to by asenv.conf. If domain1 is deleted and a new domain created, the AS_ACC_CONFIG variable is not updated with the new domain name, which causes the package-appclient script to fail.


Do one of the following:

Cannot restore backed-up domain with another name. (ID 6196993)

Mirroring of a domain on the same Application Server installation cannot be performed using the backup-domain and restore-domain commands because the domain cannot be restored using a different name than the original, even though the asadmin restore-domain command provides an option to rename the domain. Renaming the backed-up domain appears to succeed, but attempts to start the renamed domain fail because the entries in the domain configuration are not changed, and startserv and stopserv use the original domain name to set paths.


The domain name used for restore-domain must be the same as that used for the original backup-domain command. The backup-domain and restore-domain commands in Application Server 8.2 work only for backing up and restoring the same domain on the same machine.

Starting Application Server with additional JMX Agent is not supported. (ID 6200011)

J2SE 1.4.x, 5.0, or later can be configured on the Application Server. An integral feature of J2SE 5.0 platform is the ability to start a JMX agent. This is activated when you explicitly set system properties at the server startup.

Example values include:

name="" value="true"
name="" value="9999"
name="" value="false"
name="" value="false"

After configuring JMX properties and starting the server, a new jmx-connector server is started within the Application Server VM. An undesirable side-effect of this is that the administration functions are affected adversely, and the Application Server administration GUI and CLI may produce unexpected results. The problem is that there are some conflicts between the built in jmx-connector server and the new jmx-connector server.


If using jconsole (or any other JMX-compliant client), consider reusing the standard JMX Connector Server that is started with Application Server startup.

When the server starts up, a line similar to the one shown below appears in the server.log. You can connect to the JMXServiceURL specified there and perform the same management/configuration operations after successfully providing the credentials; for example:

[#|2004-11-24T17:49:08.203-0800|INFO|sun-appserver-ee8.1|javax.enterprise.|_ThreadID=10;|ADM1501: Here is the JMXServiceURL for the 
JMXConnectorServer: [service:jmx:rmi:///jndi/rmi://hostname:8686/management/
rmi-jmx-connector]. This is where the remote administrative clients should 
connect using the JSR 160 JMX Connectors.|#]

For more information, refer to the Sun Java System Application Server 8.2 Administration Guide.

Cannot redeploy or undeploy the web module that is the default web module of any virtual server. (ID 6204799)

If the web module is specified as the default web module of a virtual server, and you try to redeploy or undeploy it, you will get the following error:

Trying to undeploy application from domain failed; Virtual Servers [server] 
have <WEB-MODULE-NAME\> as default web module. Please remove the default web
module references first. ; requested operation cannot be completed Virtual 
Servers [server] have <WEB-MODULE-NAME\> as default web module. Please
remove the default web module references first.

At this point, domain.xml is in an error state, and the Admin Console may not be able to display the table that shows the deployed web applications. The condition will persist even if the domain is stopped and started again.


Change the default web module.

ProcedureTo change the default web module

  1. Using the Admin Console, go to the virtual server page, and change the default web module to empty or specify another web module.

  2. Using the CLI, undeploy the web module by specifying domain as the target.

    # asadmin undeploy --target domain <WEB-MODULE-NAME\>

    The Admin Console should be fine now, and the web module can be deployed again, if desired.

FrameworkError exception after deploying a WAR and JAR to PE server via the AMX API in the Application Server GUI. (ID 6201462)

When an application is deployed on PE using the AMX API and not referenced, the Application Server GUI throws errors while displaying that application. AMX requires that you explicitly handle references for your applications. For example, when an application is deployed, the DeployedItemRefConfig needs to be explicitly created. To simplify the deployment process, references are assumed to be present in PE, which in turn causes the issue with Application Server GUI.


Always create the reference to a resource or application after creating it.

Java Home Setting inside Configuration does not take effect. (ID 6240672)

Application Server domains/servers do not use the JDK pointed to by java-home attribute of java-config element of associated configuration.


The JDK used by the Application Server processes for all the domains in a given server installation is determined by the appserver-installation-dir/config/asenv.conf file. The property AS_JAVA in this file determines the JDK used and is set at the time of installation. If a different JDK is to be used by Application Server processes after the installation is completed, this value can be modified to point to another JDK. Note that all domains in this installation will be affected by this change.

Note –

Manual changes to asenv.conf file are not checked for validity and hence care should be exercised while changing them. Check the product documentation for minimum JDK version requirements when modifying the value for AS_JAVA. throws IOException. App Server startup fails. (ID 6322825)

In the current JDK code, the /dev/poll Selector allocates an array of 8192 pollfd entries for use by the Selector. This is exceeds the nofiles ulimit, causing it to fail with an “invalid argument” error. This in turn causes the App Server socket service that connects to MQ during startup to fail with an IOException because the is broken.


Increase the pollfd file descriptor limit. There are two ways to do this:

  1. Execute ulimit -n 8193 on the shell as root.

  2. Increase the hard limit on the number of file descriptors to 8193 or higher:

    1. Check the hard limit with ulimit -n -H.

    2. If less than 8193, edit /etc/system, adding the set rlim_fd_max=8193 command.

    3. Reboot the machine.

Domain fails to start when create-domain master password has special characters. (ID 6345947)

Domain does not start when the domain's master password contains the percent (%) character.


The domain's master password should not contain a percent character (%). This applies when creating a new domain or changing the master password for an existing domain.

Specific Java System Properties are not handled correctly by AS 8.2 Startup. (ID 6372759)

Adding the following to the JVM proxy settings causes the server to not start:

<jvm—options> -Dhttp.proxyPort=8080</jvm—options>

Inserting a * character causes a No Class Def Found error (Exception in thread main java.lang.NoClassDefFoundError: com/sun/enterprise/security/store/IdentityManager). Inserting a | character causes the start script to timeout waiting for server to start.

This functionality is critical in order to support Application Server Deployments (and Portal deployments) that reside behind a firewall and need access to both external and internal servers. An example is the Portal Server URL Scraper. These settings are necessary in order to allow the URL Scraper to get content from external sources.


Edit install-dir/config/asenv.conf file, changing the line AS_NATIVE_LAUNCHER="true" to AS_NATIVE_LAUNCHER="false".