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.

AppservPasswordLoginModule referenced as AbstractPasswordLoginModule in documentation (ID 6229682)

The Realm Configuration in Sun Java System Application Server Platform Edition 8.2 Developer’s Guide section in Chapter Chapter 2, Securing Applications, in Sun Java System Application Server Platform Edition 8.2 Developer’s Guide in theSun Java System Application Server Platform Edition 8.2 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.

Incorrect -W short option for --passwordfile in 8.2 PE man pages. (ID 6373588)

There should be no short option for --passwordfile. Currently -W --passwordfile is documented in the man pages. This is incorrect.

Solution

Do not attempt to use the —W option with --passwordfile with Application Server 8.2 Platform Edition. The short option is scheduled to be added to a future Application Server release.

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.2 Developer’s Guide section of Chapter 11, Using the JDBC API for Database Access, in Sun Java System Application Server Platform Edition 8.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);