Documentation

This section describes known documentation issues and associated solutions.

Javadoc Inconsistencies (various IDs)

The Javadoc for several AMX interfaces and methods is either missing or incorrect:

• 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.

Bundled ANT throws java.lang.NoClassDefFoundError (6265624)

Description

The following exception is thrown in thread "main" java.lang.NoClassDefFoundError: org/apache/tools/ant/launch/Launcher.

Solution

Use the bundled ANT for things outside the Communications Server is not recommended.

HTTP Service Statistics attributes discrepancies (7002258)

Description

There are typographical errors in the names of two HTTP Service statistics listed in HTTP Service Statistics in Sun GlassFish Communications Server 2.0 Administration Guide.

Solution

Please note the following corrections in the list of HTTP Service statistic names:

• processing-time should be processingtime

• request-count should be requestcount

SGCS 2.0: SIP container property "Reap interval" Missing documentation (6963298)

Description

Documentation is missing for the SIP container Reap Interval property. This property is available in the Communications Server Admin Console on the Configuration→SIP Container→Manager Properties page.

Solution

For information about the Reap Interval property, refer to Manager Properties: Reap Interval in Sun GlassFish Communications Server 2.0 Performance Tuning Guide.

SGCS 2.0: SIP Tutorial Doesn't Exclude 100 Trying Response (13721197)

Description

In the section SIP Servlet Methods in The SIP Servlet Tutorial, the following text appears: “SipServlet also defines several response methods: doProvisionalResponse for SIP 100 series responses ....” This text is incorrect, because in compliance with section 21.1.1 of the SIP specification, the 100 Trying response cannot be forwarded upstream.

Solution

The text should read, “SipServlet also defines several response methods: doProvisionalResponse for SIP 100 series responses, excluding 100 Trying ....”