Novell
exteNd Application Server

5.2.1 RELEASE NOTES

March 2005

Welcome to Novell® exteNdTM Application Server (Version 5.2.1). These release notes include the following sections:

Important note about
5.2.1 documentation
Where to find information about Version 5.2.1 of Novell exteNd
Installing exteNd Application Server How to prepare for installing the Novell exteNd Application Server
J2EE compatibility Information on the J2EE compatibility of the Novell exteNd Application Server
Novell product compatibility Information on compatibility between the Novell exteNd Application Server and other Novell products
System requirements Software and hardware needed to run the Novell exteNd Application Server features
Supported databases Database types and versions supported by the Novell exteNd Application Server
What's new in 5.2 New features in Version 5.2 of the Novell exteNd Application Server
What's new in 5.2.1 New features in Version 5.2.1 of the Novell exteNd Application Server
Upgrade notes Server changes that may affect you when upgrading to the latest version
Documentation updates Updates to the documentation for the Novell exteNd Application Server
Known issues Known problems with this version of the Novell exteNd Application Server
Problems fixed in Version 5.2 Problems that have been fixed in 5.2, including problem numbers
Problems fixed in Version 5.2.1 Problems that have been fixed in 5.2.1, including problem numbers

Release note updates   To check for updates to these release notes, click here.

Important note about 5.2.1 documentation

Documentation specific to the 5.2.1 maintenance release of exteNd is provided in the product release note files:

These files include:

The other exteNd help and PDF files are still primarily at the 5.2 level; they have not been updated to reflect 5.2.1 product changes (except where noted).

Installing exteNd Application Server

For a complete guide to installing the exteNd Application Server and the exteNd 5 Suite, see Installing Novell exteNd in the exteNd 5 Suite help.

J2EE compatibility

This version of the Novell exteNd Application Server is compatible with Java 2 Platform, Enterprise Edition 1.3 (J2EE 1.3).

To learn the details about J2EE compatibility, see the J2EE Compatibility Web site hosted by Sun at java.sun.com/j2ee/compatibility.html. It lists products that are certified to be J2EE compatible, explains how they are tested, and describes the benefits of ensuring J2EE compatibility.

Novell product compatibility

To learn about compatibility between the Novell exteNd Application Server and other Novell products:

  1. Go to the Novell support Web site: support.novell.com

  2. See the following document:

    Document title

    Solution ID

    exteNd Application Server on NetWare NOVL87857

System requirements

This section describes the software and hardware needed to run these product features:

Novell exteNd Application Server

System requirements for the server environment are listed in the exteNd Suite Release Notes, which also includes information on:

SilverJ2EEClient

SilverJ2EEClient is the J2EE application client container for the Novell exteNd Application Server. The SilverJ2EEClient installers are available for download at developer.novell.com/ndk/j2eeclient.htm. After downloading, copy the installers to the Novell exteNd AppServer\Resources\SilverJ2EEClientInstall directory on your application server host machine.

This version of the application server does not support access by earlier versions of SilverJ2EEClient; you must use the current version of SilverJ2EEClient. The current version of SilverJ2EEClient cannot access earlier versions of the application server.

Novell has a two-tier approach to platform support for SilverJ2EEClient:

Tier

Description

1 The platforms for which Novell tests and supports SilverJ2EEClient, and provides installers:
  • Windows
  • Solaris
  • Linux
2 The platforms for which SilverJ2EEClient should work but that Novell will not test. They include:
  • NetWare

If you encounter a problem trying to use SilverJ2EEClient on these platforms, Novell will attempt to fix it; but the problem is likely VM-related and beyond the control of Novell. SilverJ2EEClient installers for these platforms are not provided.

To run SilverJ2EEClient, you must have the following hardware and software installed:

Component

Description

Java 2 JRE Installed with SilverJ2EEClient
Minimum RAM (memory) 40 MB and up for SilverJ2EEClient (in addition to memory required for OS and other applications)
Minimum disk space (if installed alone) 50 MB, including the JRE

UDDI Services

You can add UDDI (Universal Description, Discovery, and Integration) capabilities to the application server by using UDDI Services. This facility is a lightweight edition of the Novell Nsure UDDI Server that comes with its own lightweight LDAP server. It supports Web Service development by providing a UDDI 2.0 test registry where you can publish and find components (using Novell exteNd Director™ or Novell exteNd Composer™) before production (when you can publish to the Novell Nsure UDDI Server).

UDDI Services is implemented as a J2EE Web application that you deploy to the application server. Everything you need to deploy UDDI Services is provided in the application server's UDDI subdirectory, along with deployment instructions and other UDDI Services documentation. The UDDI subdirectory and its files are copied to your file system during the Novell exteNd Application Server install.

Note that the exteNd Suite also contains a separate copy of the same lightweight LDAP server for test and tutorial purposes. If you run both at the same time, you may have conflicts.

Supported databases

Database types and versions supported by the Novell exteNd Application Server are listed in the exteNd Suite Release Notes.

What's new in 5.2

For information about new 5.2 features, see What's New in the application server's help.

What's new in 5.2.1

This section describes the new features of the exteNd Application Server for 5.2.1:

client_throttle_size property for performance tuning

The following property has been added to the application server's httpd.props file to help you tune performance:

   http-server.com.sssw.srv.http.client_throttle_size=0

This property specifies the server's HTTP client-request throttle size (the maximum number of HTTP client requests that can be run concurrently). The default is 0, which disables the throttle (same as before this performance enhancement was added).

The client_throttle_size property can help reduce Java lock contention on objects that are read/written by multiple Java threads. You might start with a setting of 24, then increase or decrease to see the effect on performance.

The reason you may need to throttle concurrency in HTTP request handling is that, in high thread/load environments, the Java scheduler can be unfair; it randomly picks the next thread to get a lock, even though this may be the same thread that just had the object lock previously. Threads that have been waiting several seconds for access to the lock may wait while other threads get the lock repeatedly.

Java applications that do not share objects between Java threads will not be helped by this property. Most Java applications do share objects between Java threads. (PPR 48543)

nocheckcase parameter for tuning LDAP login performance

SilverServer now provides a new optional startup parameter to help you tune login performance for an LDAP security provider:

   +Dsssw.ldap.nocheckcase

By default, when a user logs in through the application server for the first time, a search of all users in the context is performed to check for the correct case of the username. This search can be very expensive in a large environment, resulting in slower login performance. By specifying the nocheckcase startup parameter, you can prevent the username case check and associated search. (PPR 48793)

poolsize parameter for Dispatcher performance tuning

The Dispatcher (SilverDispatcher) now provides a new optional startup parameter to help you tune performance:

   +Dnovell.dispatcher.poolsize=NNN

You can use this parameter to change the client pool size (default is 50). For example, to set the client pool size to 100:

   SilverDispatcher [other parameters] +Dnovell.dispatcher.poolsize=100

When traffic is very heavy and end users get errors hitting the Dispatcher, try using this parameter to increase the pool size. (PPR 48515)

Support for SMC help on Linux

In the SMC (Server Management Console), you can display help by selecting Help>Help Topics or pressing F1. If you use the SMC on Linux, SMC help requires one of the following browsers in order to display:

Make sure that the browser's executable is on your path. (PPR 45181)

Upgrade notes

This section lists server changes that may affect you when upgrading to the latest version.

Rebranding

As of Version 5.0, this product is branded Novell exteNd Application Server. Earlier versions were branded SilverStream® eXtend Application Server. If you are upgrading from one of those earlier versions, note that the following changes have been made for the product's rebranding:

J2EE

Database

Configuration

General

Legacy

Documentation updates

The following updates apply to the documentation and help for the exteNd Application Server:

Running the application server as a UNIX/Linux daemon

When you set up the Novell exteNd Application Server (or cluster) to run as a daemon in UNIX or Linux, note that the startup scripts you need are provided in the following directory (assuming that you install exteNd to the default path /opt/novell/exteNd5):

   /opt/novell/exteNd5/AppServer/etc/

Keep this in mind when reading the exteNd installation documentation, which is vague on the script location. (PPR 48626)

Known issues

Here are some noteworthy issues or problems that apply to this version of the Novell exteNd Application Server.

Install issues

Database issues

Administration issues

Deployment issues

Runtime issues

EJB issues

Web Service issues

Problems fixed in Version 5.2

Number

Description

42251 HTTP - Calling setMaxInactiveInterval method on session doesn't timeout session
43858 HTTP - client debug HTTP headers get mixed up in server console
45603 HTTP - getServletContext() throws Exception
36626 JNDI - Unexpected behavior when looking up java:comp/env
42078 Security - Provide cache for NT System info
44189 Security - Unable to set a default NT domain if user is logged on as a local user
45108 Security - Allow non-default property values for Ldap jndi service provider
40816 Server General - Missing timestamps in error log when logging to file
44749 Server General - Ring buffer file processing does not increment file when max size reached
44750 Server General - Ring buffer feature file handling processing makes data hard to read
36579 Servlets - ServletContext temp directory creation can remove other temp dirs
39588 Servlets - web.xml session-timeout setting doesn't work if value greater than SMC timeout
43254 Servlets - response.setStatus(response.SC_NOT_FOUND) not handled properly
44065 Servlets - HttpServletRequest.getContextPath() returns null when executed in AgiExecutor
45284 Servlets - Mapping of error pages to Exception does not work.
40343 SilverCmd - SilverCmd errors are directed to wrong output in Linux platform
40786 SilverCmd - SilverCmd fails with unsecured silvermaster

Problems fixed in Version 5.2.1

Number

Description

46743 Administer Server/SMC - Add Users to Group Clear All button in Japanese is truncated.
46891 Administer Server/SMC - DEFECT000375350 SMC : Log Chart Data dialog contains truncated cancel button
47655 Administer Server/SMC - SMC - Log chart data to file: is truncated in Japanese. The value is missing
46890 Administer Server/SMC - DEFECT000372409 SMC - add security provider server dialog - truncated text
46766 Administer Server/SMC - DEFECT100367298 Pools can't be restarted after shutdown on Linux
46646 Administer Server/SMC - DEFECT100367279 - Can't Login after a Logout.
45181 Administer Server/SMC - On Linux, SMC context help doesn't launch browser
44018 Administer Server/SMC - Remote server console does not show output
39390 DB-MySQL -MySQL database server crashed during silvermasterinit
35400 Docs & Help (AppServ) - Need doc for new "dynamic connection pool limit" per-server property
37505 EJB - Entity Beans (AppServer) - Concurrency violation on update and delete to MySQL
41177 HTTP (AppServer) - "trace client 0" doesn't disable http session manager debug output
46918 Internationalization (AppServer) - Japanese Linux only: Truncations in SMC
46407 Internationalization (AppServer) - DEFECT100353819 truncated cancel button in SMC chart "reload statistics" dialog
46790 Internationalization (AppServer) - DEFECT100353785: Japanese/SMC chopped text on add database dialog
46791 Internationalization (AppServer) - DEFECT000373246: Japanese/SMC: Truncated Cancel button on Clipher suites Dialog
45816 Internationalization (AppServer) - error msg displayed on server console (or stored in log file) multi-lang problem
35079 JBroker Web - chinese characters displayed as ??? - jBrokerWeb doesn't support MBCS
46552 Localization (AppServer) - DEFECT000372410 SMC - group additional attribute - truncated text
47183 Localization (AppServer) - MBCS character string is corrupt in errlog file
47559 Security (AppServer) - NameNotFoundException exception when assigning Locksmith to LDAP user in SMC
47775 Security (AppServer) - Can not login LDAP from SMC
47151 Security (AppServer) - new SilverCmd to get/set properties on a running server or cluster
47617 Server General (AppServer) - fix appserver wrapper to pass flag to work around issue on 2.6 kernal
40927 Server General (AppServer) - sminit failure on upgrade
36152 Server General (AppServer) - NW: Unable to pass server startup parameters on Nakoma

Copyright © 2004-2005 Novell, Inc. All rights reserved. Copyright © 1997, 1998, 1999, 2000, 2001, 2002, 2003 SilverStream Software, LLC. All rights reserved.