Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Release Notes

- Previous: Deploytool
- Next: Installation

## Documentation

This section describes known documentation issues and associated solutions.

### Some documented monitoring features do not apply to Platform Edition. (ID 6202255)

The documentation for AMX (Application Server Management eXtenstions) does not specify some monitoring features that are not available in Application Server Platform Edition 8.2. Specifically, the components that cannot be monitored in the Platform Edition are as follows:

- Production Web Container (PWC):

  - PWC HTTP Service

  - PWC Connection Queue

  - PWC ThreadPool

  - PWC DNS

  - PWC KeepAlive

  - PWC File Cache

  - PWC Virtual Server

  - PWC Request

  Webmodule

  - `SessionSize`

  - `ContainerLatency`

  - `SessionPersistTime`

  - `CachedSessionsCurrent`

  - `PassivatedSessionsCurrent`

  StatefulSessionStore

  - `CheckpointCount`

  - `CheckpointSuccessCount`

  - `CheckpointErrorCount`

  - `CheckpointedBeanSize`

  - `CheckpointTime`

#### Solution

None needed. These statistics are not relevant for Platform Edition.

### The `- asadmin create-domain --help` command produces incorrect usage and an invalid option is documented (`--admin.jmxport`). (ID 6207862)

The help command for `asadmin create-domain` describes `--admin.jmxport`, which is not a valid option for this command.

#### Solution

The `--admin.jmxport` cannot be used with the `asadmin create-domain` command.

### `AppservPasswordLoginModule` referenced as `AbstractPasswordLoginModule` in documentation (ID 6229682)

The “Realms” section in Chapter 2, “Securing Applications,” in the Sun Java System Application Server Platform Edition 8.2 2006Q1 Developer’s Guide incorrectly refers to extending `com.sun.appserv.AbstractLoginModule`, however this class is now named `com.sun.appserv.AppservLoginModule`.

#### Solution

Refer to `com.sun.appserv.AppservLoginModule` instead of `com.sun.appserv.AbstractLoginModule`.

### The Javadoc for several AMX interfaces and methods is either missing or incorrect (several IDs):

- Getter methods for `NumConnAcquired` and `NumConnReleased` statistics are missing from `ConnectorConnectionPoolStats` and `AltJDBCConnectionPoolStats`. These getter methods will be added in a future release as `getNumConnAcquired()` and `getNumConnReleased()`.

- Calling the following methods in `EJBCacheStats` will throw an exception: `getPassivationSuccesses()`, `getExpiredSessionsRemoved()`, `getPassivationErrors()`, `getPassivations()`. This will be fixed in a future release.

- The AMX MBeans may require several seconds after server startup before they are all registered and available for use. A future release will make it possible to determine when the AMX MBeans are fully loaded.

- The constant `XTypes.CONNNECTOR_CONNECTION_POOL_MONITOR` is misspelled (“`NNN`”). This will be corrected in a future release.

### Documentation on getting a physical Connection from a wrapped Connection is no longer correct (ID 6486123)

As a result of other defects (possibly 6295215) the code provided in the Obtaining a Physical Connection from a Wrapped Connection in Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer’s Guide section of Chapter 11, Using the JDBC API for Database Access, in Sun Java System Application Server Platform Edition 8.1 2005Q2 Update 2 Developer’s Guide is not correct. Specifically, the line:

    Connection drivercon = ds.getConnection(con);

should now read:

    Connection drivercon = ((com.sun.gjc.spi.DataSource)ds).getConnection(con);

- Previous: Deploytool
- Next: Installation

- © 2010, Oracle Corporation and/or its affiliates