Last updated 12/31/2001
This document contains the Release Notes for the WebSphere Application Server Advanced Single Server Edition Version 4.0 FixPak 2 (4.0.2) and Advanced Edition Version 4.0 FixPak 2 (4.0.2) for all platforms except for Linux on zSeries. It also contains the Release Notes for the WebSphere Application Server Advanced Edition Version 4.0 for Linux on zSeries (Linux 390), which is based on the Advanced Edition Version 4.0.2. For simplicity, the Advanced Edition Version 4.0 for Linux on zSeries release is referred to in these Release Notes as a Version 4.0.2 release.
These notes will be updated periodically. For the latest version of these Release Notes, check the IBM WebSphere Application Server InfoCenter page at http://www.ibm.com/software/webservers/appserv/infocenter.html.
These notes cover the following--
Read the license for each product that you intend to use. These licenses are provided in English only.
WebSphere Application Server Version 4.0.2 provides the following new functions:
In addition, Version 4.0.2 provides prerequisite upgrades for the following:
If you want to install the Advanced Edition for Linux on zSeries (Linux 390), see "Installing Version 4.0.2 for Linux on zSeries." Otherwise, complete the steps below.
If you have not done so already, install WebSphere Application Server Version 4.0.1 as follows:
If you are using DB2 UDB, also read "Additional instructions on setting up DB2 UDB." Similarly, if you are using Informix Dynamic Server, read "Using Informix Dynamic Server 9.30 as the database."
Finally, if you want to continue using applications or configurations created for WebSphere Application Server Version 3.x, read information on migration available in the Version 4.0 InfoCenter and in these Release Notes.
If Version 4.0.1 is installed, complete the steps below to install FixPak 2 (PTF) for WebSphere Application Server Version 4.0. Note that you cannot install FixPak 2 if your WebSphere Application Server installation includes only the Application Assembly and deployment tools; the PTF installer window exits with a message such as "Cannot detect a WebSphere server."
For the Advanced Edition:
For the Advanced Single Server Edition:
Alternatively, for both the Advanced Edition and Advanced Single Server Edition, regenerate your plug-ins by running the command-line utility GenPluginCfg. For information on the command-line utility's arguments, type GenPluginCfg.bat for Windows platforms or GenPluginCfg.sh for UNIX platforms. Or, for more detailed instructions, visit the Version 4.0 InfoCenter.
Note that, except for the Advanced Edition for Linux on zSeries, the Connector Architecture for WebSphere Application Server Advanced Edition is now part of Version 4.0.2. Installing FixPak 2 installs the Connector Architecture; you no longer must separately download and install it. However, as to the Advanced Edition for Linux on zSeries, you must go to the following Web site for a technology preview: http://www-4.ibm.com/software/webservers/appserv/support.html
The documentation for Version 4.0.2 supplements the Version 4.0 WebSphere Application Server InfoCenter, which is at http://www.ibm.com/software/webservers/appserv/infocenter.html. Topics covered in the Version 4.0.2 documentation include--
Note that, for this release, the InfoCenter has not been updated. The Version 4.0 InfoCenter remains the most current version. The documentation provided with this release adds to or corrects portions of the Version 4.0 InfoCenter.
This section contains information about known defects and the workarounds. If a problem that you encounter is not mentioned in this section, examine the TechNotes database for information on that problem.
Read the problems and fixes that apply to your situation:
If you performed a silent installation of the WebSphere Application Server Version 4.0 FixPak 2 (PTF), do not use the return code returned from the silent installation script to verify successful installation. The return codes from a silent installation are currently unpredictable and inconsistant. To verify successful installation of the PTF, examine the administrative console log and the PTF installation logs.
After applying FixPak 2 on top of a WebSphere Application Server Advanced Edition 4.0.1 system with servers that had XA resources defined, the following exception message occurs on start up of an application server:
WTRN0008W: Object cannot be deserialized.
Ignore this message. The exception does not interrupt normal operations of WebSphere Application Server. The exception message prints to the application server standard out log file or to the trace file.
If the WebSphere installation program finds a previous version of IBM HTTP Server on the system and you have selected to install the new version of this product, a warning dialog displays. The warning dialog requests that you cancel the current install, remove the older version of IBM HTTP Server, and restart the WebSphere Application Server installation program. However, the installation will continue if you click OK on this dialog, not giving you a chance to cancel the installation. Do not cancel the installation. Instead, allow the program to complete the installation and then manually remove the IBM HTTP Server files or packages. Then, run the WebSphere Application Server installation program again, selecting only IBM HTTP Server and the IBM HTTP Server plug-in for installation and configuration.
If the WebSphere Application Server Advanced Edition is installed and migrated into the same directory as a previous Advanced Single Server Edition installation, the Advanced Single Server Edition installation is no longer a valid installation. Do not run the Uninstall program, because it will uninstall the new Advanced Edition installation.
Further, if the WebSphere Application Server Advanced Edition is installed and migrated into the same directory as a previous Advanced Single Server Edition installation, the Advanced Single Server Edition property files will be lost. If you plan on manually migrating any of your property files, you should back up the Advanced Single Server Edition property files before installing the Advanced Edition.
The WebSphere Application Server installation program does not automatically upgrade the IBM HTTP Server product from an earlier version to the appropriate level that is needed for WebSphere 4.0.1. If you would like to preserve your IBM HTTP Server configuration information, do the following:
Updates to the WebSphere 4.0.1 httpd.conf file are done differently than in previous releases. In version 4.0.1, the WebSphere installation program updated the httpd.conf file with the new HTTP Transport plug-in directives. See InfoCenter section 3.2.4 for more information on WebSphere plug-in changes for 4.0.1
To use SQL Server as the WebSphere Application Server administrative repository, ensure that you have the WAS database in your SQL Server. If not, create it using the Enterprise Manager in SQL Server. To do so, go to the Enterprise Manager in SQL Server and create a user EJSADMIN for the WAS database with password EJSADMIN and database administrator privileges. Also, create a user EJB on this database with password EJB and administrative privileges. The default server in WebSphere Application Server uses these users.
Note that the above information also applies to the InfoCenter articles "6.6.46: Administering WebSphere administrative servers" and "6.6.14.5: Additional administrative tasks for specific databases."
If you want to use the JNDI client on WebSphere Application Server Version 3.5.3 or Version 3.5.4 to access a Version 4.0.x name server, you must apply efix PQ51387 to your Version 3.5.x product. This efix is available at http://www.ibm.com/software/webservers/appserv/support.html.
Follow the instructions in the readme.txt file to update the ujc.jar and ns.jar on WebSphere Application Server Version 3.5.x.
During installation, if you select Informix as the backend database and also select the remote database option, the installation program will not be able to configure the Informix database with the remote database option. To manually configure Informix, set the following property in the admin.config file after the installation completes.
com.ibm.ejs.sm.adminServer.dbifxIFXHOST=remote_host_name
The instructions in the InfoCenter on "Installing DB2 UDB 7.2" and "Configuring DB2 UDB 7.2" state that the directory used for DB2 UDB is /opt/IBMdb2/V7.2 for Solaris and /usr/lpp/db2_07_02 for AIX. The AIX installation might, in fact, use the directory /usr/lpp/db2_07_01. Similarly, the Solaris installation might use the directory /opt/IBMdb2/V7.1, which is the correct directory for installation on Solaris. For the latest product documentation, see the IBM WebSphere Application Server InfoCenter at www.ibm.com/software/webservers/appserv/infocenter.html.
When you are installing WebSphere Application Server, with the GUI installer in the Database Options panel or silently by using a response file, you are instructed to enter the path of the directory containing the database software for DBHome. This value does not work if you have chosen Informix as your administrative database. Enter the path of the directory containing the Informix Type 4 JDBC driver for DBHome field, rather than the path to the directory containing the database software.
If you installed the administrative component only, open an editor on the file WebSphere_installation_root/properties/sas.client.props and find the following line in the file:
com.ibm.CORBA.securityTraceOutput=$(WASROOT)/logs/sas.client.log
Replace $(WASROOT) with your WebSphere Application Server home directory.
If you install WebSphere Application Server on an AIX machine, and issue the
installp
command, you will receive errors for some of the installed files.
These errors do not affect the installation, running and uninstallation of
the product.
After installing, Informix IDS_2000 has a load libc_r.a problem on AIX 4.3.3
even if the software installed without problems.
If you run any Informix command, such as oninit -ivy
,
onstat -l
, or onmode
, you will receive error messages.
To work around this error condition, do one of the following:
smit
tool.mkdev -l aio0 ; chdev -P -l aio0 -a autoconfig=available
After you install WebSphere Application Server and all of its prerequisites on AIX, Netscape Communicator 4.73 (or older) may not start the next time. The following error message will indicate this failure:
Could not load program /afs/torolab.ibm.com/common/progs/netscape47/netscape_aix4: Symbol resolution failed for /usr/lib/libpthreads.a(shr.o) because: Symbol thread_unlock (number 121) is not exported from dependent module /afs/torolab.ibm.com/common/progs/netscape47/lib433/libc_r.a(shr.o). Symbol thread_waitlock (number 122) is not exported from dependent module /afs/torolab.ibm.com/common/progs/netscape47/lib433/libc_r.a(shr.o).
This error is caused because Netscape Communicator V4 uses a private copy of libc.a which must stay synchronized with other shared AIX libraries. If AIX updates are applied to your system, you may need to update the copy of libc.a used by Netscape Communicator.
You can download the updated version of libc.a and replace the one in the Netscape installation directory from the following URL:
ftp://aix.software.ibm.com/aix/efixes/netscape/aix433_libc/
Read and follow the instructions (in the README file) for downloading and replacing the libc.a in your existing Netscape installation.
If you run Netscape from AFS or DFS locations, you may not be able to do it yourself because of lack of write permission to the Netscape directory. If this is the case you need to contact your AFS/DFS administrator.
Alternatively, there is a new version (4.76i) of Netscape available for download that corrects this problem as well. You can download and install this version onto your local machine. The location for the download is:
ftp://aix.software.ibm.com/aix/efixes/netscape/aix43_installp/
As noted in the Supporting Software database for WebSphere Application Server at http://www.ibm.com/software/webservers/appserv/doc/latest/prereq.html, an HP-UX 11.11 (or 11i) system needs the patches (filesets) HWEnable11i_11.11.depot and PHKL_25368 to run DB2 properly with WebSphere Application Server. However, even with the filesets installed, the value of the msgmax kernel parameter might revert back to its original value of 8192 after a system reboot. When this happens, DB2 does not work properly. The value must be 65535.
Instructions in the InfoCenter on "Mounting a CD-ROM in HP-UX" should be changed to the following:
Determine the device address by using the command: ioscan -C disk -f -n
The output should resemble the following:
Class I H/W Path Driver S/W State H/W Type Description ======================================================= disk 0 8/0/19/0.6.0 sdisk CLAIMED DEVICE IBM DDRS-39130WS /dev/dsk/c0t6d0 /dev/rdsk/c0t6d0 disk 0 8/16/5.2.0 sdisk CLAIMED DEVICE TOSHIBA CD-ROM XM-6201TA /dev/dsk/c1t2d0 /dev/rdsk/c1t2d0
Here, the device file is /dev/dsk/c1t2d0. Thus, the mount command is:
/usr/sbin/pfs_mount /dev/dsk/c1t2d0 /cdrom
If this command does not work, which is possible on some HP_UX machines, try the mount command:
mount -F cdfs -o ro,cdcase /dev/dsk/c3t2d0 /cdrom
Step 2 in instructions in the InfoCenter on "Installing Oracle 8i Release 3 (8.1.7)" for HP-UX should not reference the SHMMIN parameter. There is no such configurable parameter in HP-UX 11.0.
If you are running WebSphere Application Server on a Solaris or HP-UX machine, you may receive the following error with a JSP file:
Failed to create a write with encoding:EUC-JP
The default EUC-JP of the converter.properties file is Cp33722C, but Solaris and HP-UX platforms do not support Cp33722C.
To work around this problem, change EUC-JP=Cp33722C
to EUC-JP = EUC-JP
.
On some installations of iPlanet on an HP-UX machine, it is necessary to manually set the SHLIB_PATH variable to /usr/lib before starting iPlanet with a plug-in configured for SSL. For example, in the korn shell, issue the following command before invoking the command to start iPlanet.
export SHLIB_PATH=/usr/lib
If your /usr partition is full, and you cannot find the IBM HTTP Server config file when installing Websphere Application Server with IBM HTTP Server and the IBM HTTP Server plugin, there might have been a problem installing IHS. Check /tmp/install.log. If you see a failure with the install_ihs_128.sh script, please check /var/adm/sw/swagent.log for errors. In that file, you will find a detailed error of what went wrong. IHS installs a 4 kilobyte file in /usr. Due to the way HP handles their partitions, you might have one megabyte of space left in /usr, and the IHS installation will still fail. If swagent.log says you are out of room in /usr while trying to install IHS, you will need to extend the /usr file system by the amount defined in /var/adm/sw/swagent.log. Once that is done, start the WebSphere Application Server installation again, and select IBM HTTP Server, and the IBM HTTP Server plug-in to install.
The Object Level Trace (OLT) and IBM Distributed Debugger install image requires that it be installed from a writable file system. Thus, on HP-UX, the default installation from the WebSphere Application Server installation program does not function.
To install the OLT/Debugger application on HP-UX, copy the install.class file in the hp/olt directory on the WebSphere CD to a writable file system. Assuming the WebSphere CD is mounted at /cdrom and the writable file system is at /tmp, the command is--
cp /cdrom/hp/olt/install.class /tmp
Next, install the OLT/Debugger using a graphical installation program or silent installation. To run the OLT/Debugger graphical installation program using the Java binary included with the WebSphere installation, enter the following command:
/cdrom/hp/java/bin/java -classpath /tmp install
To use a silent installation process:
destinationDirectory=/opt/ibm/debugger scriptPlay=true logToScreen=false
/cdrom/hp/java/bin/java -classpath /tmp install /tmp/install.script
If you install WebSphere Application Server Advanced Single Server Edition with SuSe Version 7.1 and Netscape Version 4.7.6, you must change the following Netscape configuration values in order for the tree view on the left side of the administrative console to display properly.
http://your_machine_name:9090/admin
.When running Apache HTTP Server on Redhat 7.1 Linux systems with the plug-in configured for SSL, before starting Apache you must set the LD_PRELOAD environment variable to the following value:
/usr/lib/libstdc++-libc6.1-1.so.2
For example, if you are using the korn shell, you enter the following before starting Apache HTTP Server:
export LD_PRELOAD=/usr/lib/libstdc++-libc6.1-1.so.2
The Oracle 8i distribution does not provide the JDBC 2.0 driver file classes12.zip for Linux platforms. As a workaround, download the Solaris classes12.zip file from the Oracle Web site:
Note that you can use the Java thin driver only and any attempts to use the OCI (thick) driver will result in errors. For more information on the problem, contact Oracle Technical Support.
The SSL enabled plug-in is not supported on Solaris with iPlanet Web Server.
On Solaris 2.8 systems running the Domino Web server with the plug-in configured for SSL, the server will have an exception at startup. This results from some incompatibilities with Domino and C++ code. The fix for this is to disable the SSL transports in the plugin-cfg.xml file.
This problem has not been seen on Solaris 2.7 systems.
If you are running WebSphere Application Server on a Solaris or HP-UX machine, you may receive the following error with a JSP file:
Failed to create a write with encoding:EUC-JP
The default EUC-JP of the converter.properties file is Cp33722C, but Solaris and HP-UX platforms do not support Cp33722C.
To work around this problem, change EUC-JP=Cp33722C
to EUC-JP = EUC-JP
.
The install.sh script from the Merant Sequelink Server 5.1CD for Solaris contains
the statement which NISCAT
, which might cause the script to fail
for some systems.
This script assumes that this module is available on every Solaris system. If you run the install.sh script and it fails on this command, remove the command and the Merant Sequelink Server should install correctly.
If the WebSphere Application Server prerequisite checker finds Solaris patches that are higher or lower than the required patches on your system and there are multiple versions of a particular patch installed on the same system, the prerequisite checker will show all versions of the patch found. If a higher or equal version of the patch is installed, you can ignore the warning associated with the lower-version patch entry.
If you are installing WebSphere Application Server onto a Windows platform using the Custom installation option and choose not to install IBM HTTP Server, you must manually add the path for the GSK library to the system path. This is only necessary if you want a Web server plug-in other than the IBM HTTP Server plug-in to communicate with the application server using SSL. After adding the path, reboot your system so the plug-in will load into the Web server properly. Typically, the GSK is installed on the C: drive, in which case you add 'C:\Program Files\IBM\gsk5\lib' to the system path.
If you select the Lotus Domino plug-in during WebSphere Application Server installation, the new DSAPI filter may not work properly on AIX and WIN platforms. This is because the WebSphere installation did not add the correct DSAPI filter file name.
The DSAPI filter files, which are located under the WAS_HOME/bin directory, include--
Use the following steps to enable the new DSAPI filter. (These steps assume AIX is the example operating system.)
/usr/WebSphere/AppServer/bin/libdomino5_http.a
Before installing and testing iPlanet Web Server, Enterprise Edition 4.0, ensure that your machine is using the same administrative ID that WebSphere Application Server will use and that the ID's user rights include the advanced user right "Act as part of the operating system." To check and set user IDs and user rights, go to the User Manager. (On Windows NT, select Start -> Programs -> Administrative Tools (Common) -> User Manager.) The Windows help provides information on the User Manager.
The information on installing WebSphere Application Server on Windows instructs users who have downloaded a new prereq.properties file or disabled the Prerequisite Checker to enter the command:
setup.exe -prereqfile c:\tmp\prereq.properties
The -prereqfile option is not need on Windows. Instead, enter the command:
setup.exe c:\temp\prereq.properties
The FixPak 2 installation program for WebSphere Application Server Version 4.0 updates major components such as the WebSphere Application Server, IBM Software Development Kit, IBM HTTP Server, and Connector Technology. If during the installation a failure occurs, the installation program instructs you to run the uninstallation script. The script tries to uninstall all of the major components, which might or might not have been installed. If the components were not installed, the uninstallation script will produce an error message reflecting its inability to uninstall components which were not installed. Ignore this error message.
If you install applications into the WebSphere Application Server Advanced Single Server Edition after installing Version 4.0 FixPak 2 and later uninstall FixPak 2, the server-cfg.xml file will be restored to the configuration existing prior to the installation of FixPak 2 and you will not be able to use your applications. To preserve your applications added after the installation of FixPak 2, do the following:
If you uninstall FixPak 2 of WebSphere Application Server Version 4.0 and have Java2 security enabled, you must remove the JVM Java2 properties from the server settings or change the JVM Java2 property enableJava2Security setting to false before attempting to start the application server. If you do not remove the Java2 properties or set enableJava2Security to false, the application servers will not start.
When you install WebSphere Application Server Version 4.0.1 on Linux (Intel), the packages are not registered with the RPM database. As a result, you cannot use native tools to uninstall WebSphere Application Server 4.0.1 Instead, follow the instructions in the article "Uninstalling WebSphere Application Server" to remove WebSphere Application Server from your machine. If you want to migrate an existing WebSphere Application Server installation to Version 4.0.1, refer to the Migration overview in the Version 4.0 InfoCenter for instructions.
If you attempt to uninstall the WebSphere Application Server on a Linux machine as a non-root user, the following error messages display:
Error trying to calculate for /opt/WebSphere/AppServer/properties/sas.server.props Error trying to calculate for /opt/WebSphere/AppServer/properties/sas.client.props
To avoid the errors, log in with the root
user ID and try
uninstalling the product again.
If you uninstall WebSphere Application Server on an HP-UX machine without shutting down the server or if you attempt to install the product to the same directory as an existing version, the installation fails. In these cases, when the second installation process attempts to copy over files laid down by the first install, the process finds the files locked by the operating system and the installation fails.
To work around this problem, complete the following steps:
rm -rf install_directory
,
where install_directory is the fully qualified location of the
previous WebSphere installation.After you uninstall WebSphere Application Server, if you cannot restart the iPlanet Web server or the Apache HTTP server, the problem may be that the uninstall program did not remove the plugin information from the obj.conf file.
To work around this problem for iPlanet, remove the following lines from the obj.conf file:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="full/path/to/module" Init fn="as_init" bootstrap.properties="full/path/to/plugin/config/file" Service fn="as_handler"
To work around this problem for Apache, remove the following lines from the httpd.conf or srm.conf file:
LoadModule app_server_http_module full/path/to/module Optional AddModule mod_app_server_http.c WebSpherePluginConfig full/path/to/config
Then, restart the server.
Read the problems and fixes that apply to your situation:
When migrating from WebSphere Application Server Version 3.x to 4.0.x, the migration tool uses the classpath attribute of a Web application in 3.x as a pointer to the servlet code for the Web application. The tool normally copies all files found under each path entry into the .war file's class or lib subdirectory. Included in the copying are any files that multiple Web applications use that are centrally located, provided that the files are included as a classpath path entry of the Web application.
For example, if a Web application has the following classpath path entries, the tool copies all files found under the servlets, utilities and lib directories to the .war file.
<web-application name="webApp1" action="update"> <classpath> <path value="e:\WebSphere\AppServer\hosts\default_host\webApp1\servlets"/> <path value="e:\utilities"/> <path value="e:\libraries\version2\lib"/> </classpath> <web-application name="webApp2" action="update"> <classpath> <path value="e:\WebSphere\AppServer\hosts\default_host\webApp2\servlets"/> <path value="e:\utilities"/> </classpath>
FixPak 2 of WebSphere Application Server Version 4.0 adds a new command line parameter to the WASPostUpgrade file called -webModuleAdditionalClasspath. This parameter allows you to specify the path and file names of specific files that you do not want copied into the .war file. Instead, the one or more files specified by the -webModuleAdditionalClasspath parameter are added to the Web Module's extension (ibm-web-ext.xmi) additionalClassPath attribute based on each Web application's classpath entries. In addition, you can specify directories that contain files you do not want copied into the .war file. All files in the specified directories and their subdirectories are not copied into the .war file. Instead, any jar file found in the specified directories or any of their subdirectores are added to the Web Module's additionalClassPath attribute based on each Web application's classpath entries.
Continuing the example above, suppose there is a commonUtilities.jar file under the e:\utilities directory and files under the e:\libraries\version2\lib directory that should not be saved to the .war files. You can invoke the WASPostUpgrade file by issuing the command below on Windows platforms. (Do the equivalent for UNIX platforms.) As to the command, c:\backup_directory is the migration backup directory and wsnodename is the adminNodeName. Note that the one-line command is shown here on two lines to improve readability.
WASPostUpgrade c:\backup_directory -adminNodeName wsnodename -webModuleAdditionalClasspath e:\utilities\commonUtilities.jar;e:\libraries\version2\lib
The commonUtilities.jar file and all files found under the lib directory (and its subdirectories) of the e:\libraries\version2\lib path are not copied to the .war files. Also, the following entry appears in the ibm-web-ext.xmi file of the Web Module for webapp2 migrated to Version 4.0.x:
additionalClassPath="E:\utilities\commonUtilities.jar;"
You can ignore messages such as the following displayed while WASPostUpgrade runs or found in the WASPostUpgrade.log file:
Warning: validation was turned on but an org.xml.sax.ErrorHandler was not set, which is probably not what is desired. Parser will use a default ErrorHandler to print the first 10 errors. Please call the 'setErrorHandler' method to fix this.
Note that the path separator for the additionalClassPath attribute is not operating-system specific; it is a semi-colon (;) for all operating systems. Therefore, if you are using a UNIX platform, after the migration tool runs, change the additionalClassPath attribute path separator to a ; using the Application Assembly Tool.
If you plan to migrate from WebSphere Application Server Advanced Single Server Edition to the Advanced Edition, save a copy of the following directories before starting the migration process:
\config \installableApps \installedApps \properties
After the migration is successfully performed by the install process, restore the above mentioned directories back to the Advanced Edition install directory.
The sas.server.props file contains critical information for the administrative server. Back up the sas.server.props file before migrating.
When the pre-migration process completes, a file named WAS_MIGRATION_TEMP.properties is stored in /tmp directory and is also stored in the migration backup directory specified during the pre-migration process. If you upgrade the operating system level on this machine, you need to copy this file from the migration backup directory to the /tmp directory. The /tmp directory is emptied during the operating system level upgrade.
The migration process for the WebSphere Application Server Advanced Edition updates the admin.config file in the WebSphere 4.0.x bin directory. One of the side effects of this update is that blank characters and comments are removed from the file during this processing.
After WebSphere is installed, there is a copy of the admin.config file called admin.config.bak in the bin subdirectory. However, this file is erased when the administrative server is started. It is advisable to copy the admin.config.bak file to another name before the administrative server is started. This file can then be used as a record of the original values in the installed admin.config file.
The instructions in the InfoCenter on "3.2.3: Upgrading Version 4.0 Advanced Single Server Edition" should provide as follows:
To upgrade version 4.0 of the Advanced Single Server Edition with IBM HTTP Server to version 4.0.1 of the Advanced Single Server Edition with IBM HTTP Server:
When migrating from Version 3.0.2.x to Version 4.0.x, the WASPreUpgrade program is run. The program returns java.io.FileNotFoundException messages. The file not found is content-type.properties. Ignore the exception messages.
If you are migrating WebSphere from Release 3.x to Release 4.0.x
while running the WebSphere installation program and a severe error occurs
while saving the existing Release 3.x environment, perform the steps
below to migrate the Release 3.x configuration. Note that the steps
are for Windows- based systems; for UNIX-based systems add .sh
to the
command line.
waspreupgrade c:\backup_directory c:\current_3.x.x_WebSphere_directory wssylvester
where wssylvester is the adminNodeName. Note that in some cases the waspreupgrade command may not be totally successful. To ensure that a valid configuration has been saved, verify that the file c:\backup_directory\websphere_3x_backup.xml exists. If it does not, then enter the following command from the c:\current_3.x.x_WebSphere_directory:
xmlconfig -export c:\backup_directory\websphere_3x_backup.xml -adminNodeName wssylvester
WASPostUpgrade c:\backup-directory -adminNodeName wssylvester
The migration tool does not migrate EJB files deployed in a 3.x node if the dependent-classpath attribute on that node is not empty. To deploy the EJB files on Windows, complete the steps below. (Do the equivalent for UNIX platforms.)
ejbdeploy e:\was3_backup\websphere_3x_backup.userFiles\deployedEJBs\Deployedbig3.jar e:\was3_backup e:\was3_backup\Deployedbig3.jar -cp dependent_classpath -quiet -35
where e:\was3_backup\websphere_3x_backup.userFiles\deployedEJBs\Deployedbig3.jar is the input jar file, e:\was3_backup is the working directory, e:\was3_backup\Deployedbig3.jar is the output jar file, and dependent_classpath is the dependent-classpath attribute on the node.
If your 3.x EJB files use security functions, after running the migration tool you must bind security roles to EJB 1.1 method names. Some of the method names for enterprise beans have changed with EJB 1.1. For example, ejbCreate is create in EJB 1.1, ejbRemove is remove in EJB 1.1, ejbGetEJBMetaData is getEJBMetaData in EJB 1.1, and the ejbFindBy methods are findBy in EJB 1.1. To bind security roles, you add the EJB 1.1 method name to the method permission created for the EJB 1.0 method name using the Application Assembly Tool (AAT) as follows:
A problem may occur after migrating a configuration from Release 3.x to Release 4.0.x relating to the JDBC Driver configuration. The problem shows up with an error message similar to--
javax.naming.NamingException: ClassNotFoundException: COM.ibm.db2.jdbc.DB2ConnectionPoolDataSource
This can happen if the data store in use required a prerequisite upgrade and this upgrade is stored in a different directory location than the original data store version. The problem occurs because the JDBC configuration that is defined in the Release 3.x configuration uses drivers from the original data store version and its related directory names. When this configuration is exported and then imported into the Release 4.0.1, the original directory names are used instead of the new data store version.
To correct the problem on the Advanced Edition, change the JDBC Driver Server class path entry to use the new data store directory names in the administrative console under the Resources tree.
To correct the problem on the Advanced Single Server Edition, modify the server configuration file in the config directory. The default file is server-cfg.xml but you can choose to use a different file. Modifications are required to Resource Provider stanzas to use the correct class path name. For example, if you are using DB2, change the following from:
<installedResourceProviders xmi:id="ResourceProviderRef_3" classpath="/home/ db2inst1//sqllib/java/db2java.zip" resourceProvider="JDBCDriver_3"/>
to:
<installedResourceProviders xmi:id="ResourceProviderRef_3" classpath="/home/ db2inst1//sqllib/java12/db2java.zip" resourceProvider="JDBCDriver_3"/>
The problem also may occur if you migrate and use the same directory structure. As to Windows NT, an old copy of db2java.zip remains in your lib directory. That copy is loaded instead of the one pointed to by the JDBC Driver Server class path. The solution is to remove the db2java.zip in the WebSphere lib directory.
When migrating a multi-node model-clone domain to WebSphere Application Server 4.0.x, the following error will be displayed in the output of the XMLConfig Import when the same .ear file is migrated and installed on nodes other than the first node that is migrated:
XMC0100E: Update action is not supported on this type of object. To reinstall the application, use "delete" action followed by "create" action, on enterprise-application element.
Disregard this error message.
In addition, the Web and EJB module names contained in the .ear file installed on the first node that is migrated will be included in the repository. If the Web and EJB module names contained in the same .ear file installed on subsequent nodes through migration do not match, the .ear file installed on the first node that contains those modules must be manually installed and expanded on the node where the names do not match. Complete steps such as the following (for Windows NT or Windows 2000; do the equivalent for UNIX platforms):
EARExpander -ear e:\WebSphere\AppServer\installableApps\Big3App.ear -expandDir e:\WebSphere\AppServer\installedApps\Big3App.ear -operation expand -expansionFlags war
where e:\WebSphere\AppServer\installableApps\Big3App.ear is the .ear file you want to expand and e:\WebSphere\AppServer\installedApps\Big3App.ear is the directory in which to expand the .ear file.
An error might occur if multiple ports are migrated for the same application server. Ports with duplicate entries might result. Use the WebSphere administrative console to modify the port values in the Web Services settings.
When migrating a multi-node model-clone domain to WebSphere Application Server 4.0.x, you must manually updated the Web server plug-in for each node after the final node has been inserted into the domain. To manually trigger an update of the configuration for the WebSphere plug-in, for each node:
When migrating a multi-node model-clone domain to WebSphere Application Server 4.0.x where the DefaultApplication.ear is created and installed in a server group, the following exception will be thrown when the second node and any subsequent nodes are inserted into the domain:
Exception: Failed to load other_node/defaultApplication com.ibm.ejs.sm.exception.ActiveObjectException: Failed to load "otherNode"/defaultApplication
where other_node is the nodename of the node to which the console is not connected.
Disregard this exception as the application will run on all servers.
If the following error is seen after completing migration, the server-cfg.xml file will not match up with the .ear file directories included in the installedApps directory:
Exception - No resource for object: com.ibm.ejs.models.base.config.applicationserver.impl.WebModuleRefImpl (uri: ChainTest.war) com.ibm.xmi.base.NoResourceException com.ibm.websphere.migration.exceptions. WASUpgradeInternalErrorException: MIGR0228E: Unable to save configuration files.
To correct this problem, manually delete any .ear directory found under the installedApps directory that is not listed as an installedApp in the server-cfg.xml file.
To run WASPostUpgrade more than once after migration has completed successfully and .ear files have been installed in the installedApps directory including a DefaultApplication.ear, the DefaultApplication.ear must be uninstalled before invoking WASPostUpgrade. No other .ear files must be uninstalled.
To uninstall the DefaultApplication.ear, do the following:
The term localhost might be localhost or the host name of the machine on which the product is running.
Examine the properties files trustedservers.properties and webseal.properties installed with WebSphere Version 4.0 FixPak 2. With FixPak 2, all references to WebSeal 3.6 have been changed to WebSeal. If you have customized these property files, then add those customizations to the files that are installed with the FixPak. Do not continue to use webseal36.properties. Use the common interceptor for WebSeal Versions 3.6 and 3.7 called webseal.
If you write your own interceptor, ensure that the class file is in the WebSphere_installation_root\classes directory and the property files associated with your interceptor are in the WebSphere_installation_root\properties directory. Further, ensure that the interceptor class is public and uses a constructor that has no arguments.
Note that any interceptors that support initialization must extend WebSphereBaseTrustAssociationInterceptor. Also, they must continue to implement the TrustedAssociationInterceptor. For example:
public class WebSealTrustAssociationInterceptor extends WebSphereBaseTrustAssociationInterceptor implements TrustAssociationInterceptor
Finally, mutual SSL between WebSeal and HTTP server is supported in WebSeal Version 3.7. Ensure that SSL is set up correctly. WebSphere does not validate the mutual SSL setup.
Websphere Application Server 4.0.x will not run on AIX 4.3.2. Upgrade to AIX version 4.3.3 before migrating to WebSphere Application Server 4.0.x.
When migrating from version 3.02 on Linux, an error may occur during pre-migration if JAVA_HOME is not defined in the WebSphere 3.02 setupCmdLine.sh file in the bin directory and the JAVA_HOME value cannot be correctly derived in the WebSphere 3.02 XMLConfig.sh file in the bin directory. To complete the migration, JAVA_HOME must be set to a valid value. Modify the JAVA_HOME setting in the WebSphere 3.02 setupCmdLine.sh file to point to a valid JDK 1.1.x directory to correct the problem and rerun the migration process again.
The format of the Systems Management database has changed significantly between release 3.x and release 4.0.x. If the database name that will be used for release 4.0.x is the same as was used for release 3.x, then the database must be removed and recreated during the migration process at the same time that prerequisites are updated. It is recommended that you use the default database name of was40.
If you want to migrate from a previous version of WebSphere Application Server on a Solaris 2.6 machine, you must install all patches required by the JDK 1.3 product in order to run the pre-migration process. These patches are listed in the file README.sparc that comes with JDK 1.3 product.
When you migrate from a previous version of WebSphere Application Server on a non-English Sun Solaris machine, the installation program will not detect the proper installation location of the previous install when attempting to migrate a Solaris, non-English, native-package that was installed to a location other than the default /opt location.
The application server process for the Advanced Single Server Edition will not start, preventing access to the administrative console. As a result, you cannot use the administrative console to correct any configuration problems that might be preventing the server from starting.
To fix this situation:
startServer -configFile ../config/admin-server-cfg.xml
http://localhost:9091/admin
Alternatively, you can attempt to manually edit the offending server configuration file. You should always make a backup before making any manual changes.
WebSphere Application Server will fail to start if certain ports are in use. When the bootstrap port is in use, you may see the error below when starting WebSphere Application Server. This error is similar to the "Port 9000 in use error" when starting WebSphere Application Server.
009.765.6005c5b F Nameserver Failed to start the Bootstrap server org.omg.CORBA.INTERNAL: minor code: 8 completed: No
To fix the problem on the Advanced Edition, change the bootstrap port (the default is 900) in the admin.config file, using the property name:
com.ibm.ejs.sm.adminServer.bootstrapPort
If this property does not exist in file admin.config, add it. For more information, see the WebSphere Application Server Version 4.0 InfoCenter article "6.6.46.0: Administrative server configuration file properties."
To fix the problem on the Advanced Single Server Edition, edit the server configuration file (the default is WebSphere_installation_root/config/server-cfg.xml) and change the bootstrapPort value for orbSettings. For example, change
<orbSettings xmi:ed="ORBConfig_1" enable="true" bootstrapHost="localhost" bootstrapPort="900">
to
<orbSettings xmi:ed="ORBConfig_1" enable="true" bootstrapHost="localhost" bootstrapPort="901">
Corruption of the sas.server.props file might cause the administrative server to fail to start. sas.server.props contains critical information for the administrative server. Back up the sas.server.props file regularly.
If you cannot start the administrative server because of a JDBC problem, the possible reason is that the DB2 environment was not set up correctly. To set up the DB2 environment:
DB2_HOME/sqllib/java12/usejdbc2
DB2_HOME/sqllib/db2profile
If you are using the DB2 Network ("Thin") client, the script startupServer.sh will not run correctly. To change the script so it runs correctly, open an editor on the startupServer.sh file and go to line 19. You will see the following code:
elif [ "${DB_TYPE}" = "DB2" ] then { DB_ENV=$DB_INSTANCE_HOME/sqllib/db2profile . ${DB_ENV?} DB_CLASSPATH=$DB_INSTANCE_HOME/sqllib/java12/db2java.zip }
Change this code to the following:
elif [ "${DB_TYPE}" = "DB2" ] then { DB_ENV=$DB_INSTANCE_HOME/sqllib/db2profile if [ -f ${DB_ENV?} ] then . ${DB_ENV?} fi DB_CLASSPATH=$DB_INSTANCE_HOME/sqllib/java12/db2java.zip }
After you create the administrative repository database, you should allow the administrative server to initialize completely before setting the following properties to false:
The properties are in the logging.properties file in the WebSphere/AppServer/properties directory. You use the properties to control various aspects of event logging. If the properties are both set to false before the administrative server starts for the first time after a database is created, the administrative server might return NumberFormatExceptions and fail to initialize.
If the WebSphere Application Server Advanced Edition is installed on an AIX system with a local DB2 server and the commands below (as described in the InfoCenter) were executed previously to configure DB2, the administrative server should start successfully when first started.
4. Set the EXTSHM environment variable by entering the following commands: $ EXTSHM=ON $ export EXTSHM $ db2set DB2ENVLIST=EXTSHM
Later, when the administrative server is stopped or the system is shut down, DB2 will stop as well. However, when you next back up the system and start DB2, the administrative server might fail with the following error when you try to start it:
Could not initialize persistent storage for serious events. Got exception COM.ibm.db2.jdbc.DB2Exception: [IBM][CLI Driver] SQL1224N A database agent could not be started to service a request, or was terminated as a result of a database system shutdown or a force command. SQLSTATE=55032
To recover from this problem, enter the above commands that set the EXTSHM environment variable and restart the server.
To prevent the environment variable from being turned off accidently again, add the above three lines of commands to the db2profile (assuming the db2profile is sourced using .profile) to ensure the variable is always valid.
When you start the administrative server, WebSphere adds information on the following exception to the activity.log file:
... naming.NameNotFoundException: Name jdbc not found in context "local:". ...
The exception is harmless and you do not need to take any action to fix the problem. You can ignore this entry in the activity log.
Read the problems and fixes that apply to your situation:
FixPak 2 for WebSphere Application Server Version 4.0 adds an icon to the right of attributes
propagated to all clones on server group property sheets.
The icon is:
Note that the Remove push button is not available to clone System properties on the JVM Setting panel. The only way to remove the properties is to delete the appropriate name-value pair and then select Apply.
FixPak 2 for WebSphere Application Server Version 4.0 adds a new clone-only attribute to the list of clone-only attributes for server groups. The new attribute is the SystemProperties part of the JVMConfig attribute.
You can see what other attributes are clone-only in the InfoCenter article "6.6.22.0: Server group properties."
If the JDBC driver DB2XADataSource is configured and you restart the administrative server, a NullPointerException error occurs. To work around this error condition, complete the following steps:
tran1.log.org
.trans.log.org
.As to the Advanced Single Server Edition, after installing an EAR file with SEAppInstall.bat or SEAppInstall.sh, the following message displays:
CHKW6505W: A subject (user or group) has not been assigned for security role, DenyAllRole. The security role assignment should be made prior to running the application.
Ignore this message. It is appropriate for the DenyAllRole to not have any users or groups assigned to it.
When using Microsoft Internet Explorer version 5.00, after you add a new URL Provider, JDBC Driver or JMS Provider resource, the tree view in the left pane of the administrative console might not update. To see the newly added resource, save the configuration file, exit the administrative console, stop and restart the server, and then restart the console. In the left pane, expand Resources and then the resource type for which you just created a new instance. You should be able to see the new resource instance.
You can access HTML help for Log Analyzer using the Netscape Navigator browser only, even though in the tool's Preferences dialog there is an option that seemingly allows you to select either Netscape or Internet Explorer as the browser to display HTML help files. To specify the browser:
When creating an application in the application install process, do not include a / character in the application name.
Similarly, when creating an application server using the WebSphere Application Server Advanced Edition, do not include a / character in the application server name. This is regardless of the method used to create an application server (wscp, AdminConsole, or XMLConfig).
Server group property sheets now have an icon to the right of attributes
propagated to all clones:
There are limitations of some Netscape browser implementations on UNIX or Linux platforms which may cause the WebSphere Advanced Single Server Edition administrative console to operate incorrectly with respect to accessibility. The administrative console has been designed to support accessibility requirements, when viewed in a browser than can run in accessiblity mode. If the console is viewed within a browser than cannot run in an accessibility mode, tab or cursor keys may become unavailable.
The workaround is to view the administrative console using an accessibility-mode capable browser, such as Microsoft Internet Explorer 5.5 or Netscape 4.73 on Windows NT or Windows 2000.
The Adding EJB Reference window does not show the Name field when it first opens. The window is accessed by clicking Add on the Adding EJB Reference window of the the Create Application Client wizard. You have to resize the window to see the field.
To run WSCP successfully on Linux on zSeries (Linux 390), you must turn off the Just In Time (JIT) compile option in the shell that you are executing from. To do this, run the following:
export JAVA_COMPILER=NONE
To verify that the JIT option is indeed turned off, run the following:
java -fullversion
The reply tells you the version of Java and whether the JIT option is on or off.
The administrative console or login panel for WebSphere Advanced Single Server Edition might display incorrectly in a Netscape Web browser on Linux platforms. Instead of using a Netscape browser, use a Mozilla Web browser to display the administrative console and login panel.
If you export the display from a Sun machine to a Linux system and start the administrative console from a Telnet window that accesses the the Sun machine from the Linux system, the administrative console might appear in a small window with its panes unexpanded. The administrative console normally has several expanded panes that display different views. To improve the display, you can widen each pane so that the console has a normal appearance.
The framework in the AAT used for editing and verifying J2EE archives uses custom class loaders for Java reflection within the archive. In some situations, the class loader behavior in AAT is not consistent with the behavior in the run time. For example, you might receive validation errors when a class cannot be reflected. Or, you might encounter reflection problems or linkage errors when saving the archive.
Typically, these class loading errors result from one of two problems:
To avoid the class loading errors, correct the above problems.
If you install WebSphere Application Server on a Linux RedHat machine that uses the Gnome desktop, double-clicking on the folder name or folder icon will not open the folder or file. This error is caused by an inconsistency between the JVM and the Sawfish window manager with respect to the X Events generated by multi-clicks.
There are two ways to work around this multi-click problem:
To open a file using AAT without double clicking, specify the folder name and file name in the file name field. For example:
/opt/WebSphere/AppServer/installableApps
The exception java.lang.ClassCastException may be thrown when you do the following:
These steps verify the .ear file even though executing the steps may throw the exception.
When you do the following in the Application Assembly Tool:
You cannot drag the war file. To work around this problem, import the file (Ejb .jar/Web Module .war/Ejb client .jar ) from new application window tree node.
When starting the Application Assembly Tool of the WebSphere Advanced Edition
by entering assembly.sh
on AIX, a java.lang.OutOfMemoryError exception
may be returned. To resolve this problem, try adding the -mx192m option to
the java command line in the assembly.sh file. The resulting java command line should
resemble--
$JAVA_HOME/jre/bin/java \ -Xmx192m \ -Dcom.ibm.itp.location=$WAS_HOME/bin \ -Dserver.root=$WAS_HOME \ -Dws.ext.dirs=$WAS_EXT_DIRS \ -classpath $WAS_CLASSPATH com.ibm.ws.bootstrap.WSLauncher \ com.ibm.ejs.assembly.gui.AssemblyTool
The Full Select feature for Entity EJB finders has been removed from the Application Assembly Tool. Information on the Application Assembly Tool should no longer document the feature.
If the application server is stopped and restarted, the Resource Analyzer might display incorrect values for JSP files and servlets. To display correct values for these resources, restart the Resource Analyzer.
IBM HTTP Server might hang during initialization when it is configured for SSL and the Websphere administrative server is running.
To solve this problem, try any of the following workarounds:
SSLAcceleratorDisable
in the IBM
HTTP Server configuration file httpd.conf. Place this directive outside of
VirtualHost
and Directory
stanzas.com.ibm.ejs.sm.adminServer.lsdPort=a_port_number
to the admin.conf file in the appserver/bin subdirectory.If you install IBM HTTP Server with the WebSphere Java development kit 1.3.0 and WebSphere Application Server and attempt to define a key using the IBM HTTP Server ikeyman Hardware Crypto Menu options, the resulting window might be difficult to see and navigate in. Use a workaround for the appropriate platform to correct this problem:
AIX:
$JAVA_EXECUTABLE $IKEYMAN_TEMP_JAVA_INPUT
with this one-line statement (shown here on two lines to improve readability):
$JAVA_EXECUTABLE -Djava.ext.dirs=/usr/opt/ibm/gskkm/classes/ikmuser.properties $IKEYMAN_TEMP_JAVA_INPUT
Linux platforms:
$JAVA_EXECUTABLE $IKEYMAN_TEMP_JAVA_INPUT
with this one-line statement (shown here on two lines to improve readability):
$JAVA_EXECUTABLE -Djava.ext.dirs=/usr/local/ibm/gsk5/classes/ikmuser.properties $IKEYMAN_TEMP_JAVA_INPUT
After installing WebSphere Application Server, if you cannot start the iPlanet server, check the obj.conf file and make sure the plugin configuration information is in the correct order. The installation program may have placed the plugin configuration information into obj.conf in the incorrect order. The correct order should be:
Init fn="load-modules" funcs="as_init,as_handler,as_term" shlib="C:/WebSphere/AppServer/bin/ns41_http.dll" Init fn="as_init" bootstrap.properties= "C:/WebSphere/AppServer/config/plugin-cfg.xml"
When running the WebSphere administrative server, a server error is returned when you try to run a servlet such as the sample servlet snoop. To enable the iPlanet plugin to send the servlet to WebSphere Application Server, turn off the iPlanet servlet support:
On Unix platforms, the log of Domino plug-in configuration failures might include a false negative when Domino configuration code is run. If the DSAPI plug-in does not load, then use the manual Domino configuration instructions to troubleshoot the configuration. If the plug-in appears to load properly (that is, it is viewable in the Domino console startup messages), you can disregard the log error.
Read the problems and fixes that apply to your database:
The net driver for accessing DB2 remotely is not supported in this version of WebSphere Application Server. If you are using DB2 remotely, do not modify the dbServerName and dbPortNumber fields in the admin.config file. The use of the DB2 client installation and DB2 aliases is supported in order to access DB2 remotely.
If your .ear file uses multiple data sources with the DB2XADataSource class, when you deploy the .ear file into the application server and restart the Administrative Server, an "UnsatisfiedLink Error" may be returned on the AIX platform.
The problem is in the LD_LIBRARY_PATH and LIBPATH on AIX. After running
DB2 usejdbc2
, the LIBPATH includes $INSTHOME/sqllib/java12,
but the StartServer.sh overwrites the existing content of LIBPATH and sets
it to $WAS_HOME/bin:$LD_LIBRARY_PATH. To fix the problem, include
$INSTHOME /sqllib/java12 in the LD_LIBRARY_PATH. That is, for example, export
LD_LIBRARY_PATH to /home/test/sqllib/java12:/home/test/sqllib/lib. Then,
restart the server without errors.
When using DB2 UDB FixPak 3 as the Sessions data source, you must set
CURSORHOLD=1
to prevent statements from hanging in the database.
(If you are using a DB2 UDB FixPak later than FixPak 3, you do not
need to change the setting.)
Set the CURSORHOLD property for the Sessions data source by specifying the following connectionAttribute custom property in the data source configuration, as follows:
property name: connectionAttribute type: java.lang.String value: cursorhold=1
Note that the type field has to be set for the Advanced Single Server Edition only.
When you run DB2 on any UNIX platform, you may see the following error message:
java.lang.NoSuchFieldError: batchReturn
This error is caused because of a mismatch of db2java.zip files. To
work around this problem, ensure that the db2java.zip file in the
java12 directory is before the db2java.zip in the java directory in
your classpath. A common problem is to install a JDBC driver using
~db2inst1/sqllib/java/db2java.zip
, while you should have
specified ~db2inst1/sqllib/java12/db2java.zip
.
To use the IBM Toolbox for Java (also known as the AS/400 Toolbox for Java) JDBC driver with WebSphere Application Server Version 4.0.x, you must use the most current version of the IBM Toolbox for Java Modification level 4 (5722JC1 or JTOpen). If you have installed the licensed product 5722JC1, you must also apply 5722JC1 PTF SI02195. After applying the PTF, replace the Toolbox jar file (jt400.jar) on the workstation systems on which you are running WebSphere Application Server Version 4.0.x with the updated version from your iSeries system.
If you are using a DB2/390 database, add the definition below to the WebSphere/AppServer/bin/db2390.sql script file before running a job stream on an OS/390 system. Without the definition, not all of the appropriate WebSphere repository tables will be created and the administrative server will fail to initialize when started unless the user ID used to connect to DB2/390 has CREATE TABLE authority.
CREATE TABLESPACE DOMTMPTS IN WAS4DIST USING STOGROUP SYSDEFLT PRIQTY 12 SECQTY 12 LOCKSIZE ROW DEFINE NO; CREATE TABLE EJSADMIN.DOMAIN_TMPTBL ( NAME VARCHAR(255) NOT NULL ) IN WAS4DIST.DOMTMPTS;
When running WebSphere Application Server on Solaris 8 with a DB2 UDB database as the repository, your system might develop a hang condition. The hang condition occurs because of networking problems on Solaris. To fix the condition, do the following:
Depending on your specific system, you may need one, two, or all three of these solutions.
When using an XADataSource and Informix, running the LifeinsMD application fails for the XADataSource and results in the error condition below. The failure can occur on both the WebSphere Application Server Advanced Edition and the Advanced Single Server Edition.
CNTR0019E: Non-application exception occurred while processing method getNextId: com.ibm.websphere.cpi.CPIException: java.sql.SQLException: System error - invalid statement id received by the sqlexec process.; nested exception is: java.sql.SQLException: System error - invalid statement id received by the sqlexec process. ...
The Informix JDBC driver adversely affects the WebSphere Application Server cache prepared statements. To fix the problem, set the statement cache size to zero (0):
The Advanced Single Server Edition might return error messages such as Configuration Problems have been detected or CHKW3019E: Conflicting statement cache size of the data source must be specified. Ignore the error messages.
If your WebSphere Application Server configuration is WLM-enabled, uses Informix Version 7.31, and has an application installed using a server group, severity 1 exceptions are thrown when you do either of the following:
Messages for the exceptions are shown in the administrative console messages area and detailed information on the exceptions are given in the tracefile and activity.log files. The messages resemble the following:
[01.12.13 13:42:02:925 CST] 3b3402 ExceptionUtil X CNTR0019E: Non-application exception occurred while processing method create: java.rmi.RemoteException: ; nested exception is: java.sql.SQLException: Could not insert new row - duplicate value in a UNIQUE INDEX column.
[01.12.13 13:42:02:962 CST] 3b3402 ExceptionUtil X CNTR0020E: Non-application exception occurred while processing method bind on bean BeanId(admin#nssrcm.jar#NsSession, null): org.omg.CORBA.portable.UnknownException: minor code: 0 completed: Maybe at com.ibm.ejs.ns.CosNaming.EJBDataStore.bind(EJBDataStore.java:206)
org.omg.CORBA.TRANSACTION_ROLLEDBACK: com.ibm.websphere.csi.CSITransactionRolledbackException at com.ibm.ejs.csi.TranStrategy.handleException(TranStrategy.java:121)
Ignore these exceptions. Your server clones and application will run successfully.
If you are using the Oracle thin driver and the OCI driver, surrounding a query with parentheses ("()") results in the error "ORA-01009: missing mandatory parameter" and an empty result set (no data). This is an Oracle error (917674) and was fixed in the 817.2 fixset. To avoid the problem, either install Oracle fixset 817.2 or avoid surrounding queries with parentheses.
On Solaris and with Oracle as the administrative repository, the administrative console might hang intermittently if you try to stop and start the application server multiple times. If you experience this problem, recurrence can be minimized or eliminated by the doing all or some of the following:
0
. This can
be done by adding the following to the admin.config file:
com.ibm.ejs.sm.adminServer.dbstatementCacheSize=0
Then, restart the administrative server.
Choices 1, 3, and 4 might eliminate the problem. Choices 2, 3, and 4 will reduce the appearance of the problem.
If you are using connection pooling with Oracle on Sun Solaris or Linux,
it is recommended that you set the maximum number of files allowed open per
user to at least 2048. You can do this using the ulimit command. Simply enter
ulimit -n 2048
in the session where you will be running
the application server.
It is also recommended on the Linux system that the JVM initial heap
size and maximum heap size be set to 256 megabytes and 512 megabytes, respectively.
Using the administrative interface, select Nodes -> node_name
-> Application Servers -> server_name -> Process Definition
-> JVM Settings. In the Initial Heap Size field,
enter 256
and in the Maximum Heap Size field
enter 512
. Save the configuration and restart the application
server to have the settings take effect.
The Merant type 4 driver for Microsoft SQL Server Version 7.0 and SQL Server 2000 does not properly support the one-phase optimisation of a two-phase commit. If you use a connection from this type of data source within a distributed transaction that involves no other resources, then the transaction commit will fail with a javax.transaction.TransactionRolledbackException. If you use a connection from this type of data source in a distributed transaction that involves more than one resource or use the connection outside the scope of a distributed transaction, then the exception does not occur. The DataDirect case number for this problem is 1266610.
You do not get the exception if you use the Merant type 3 driver for SQL Server Version 7.0 and SQL Server 2000.
If you are using WebSphere Application Server on a Solaris machine and connecting to Sybase as the administrative repository, you may experience network problems. When you start an application server, numerous JZ006 errors may occur with chained JZOEM errors. At this point, the connection pool will get dropped. In addition, other connections may start to experience the following error:
SET CHAINED command not allowed within multi-statement transaction
To work around the SET CHAINED errors, place the following line into the admin.config file:
com.ibm.ejs.sm.adminserver.dberrorMap=EC226=com.ibm.websphere.ce.cm.StaleConnectionException
Note that JZ006/JZOEM and SET CHAINED errors will still occur with this workaround. However, the frequency will be reduced and WebSphere will be able to recover from the errors.
With Sybase as the administrative repository, the following DatabaseMetaData methods are not implemented as of the last Sybase EBF and will throw UnimplementedOperationExceptions.
getSchemaName() getTableName() getCatalogName()
When you install and use Sybase, be sure that you apply the latest EBF and search the accompanying Cover.ROLL.EBF# document that lists what patches and enhancements are a part of EBF# (where EBF# is the number of the latest e-fix available). In particular, look for the following EBF IDs:
1074408-11 CR255096 1074408-12 CR255094 1074408-13 CR255097
During the creation of a data source, you can click on the Test Connection push button to determine if the data source is set up correctly before proceeding. When the data source is for Sybase, clicking Test Connection might return a JZ0C0 error indicating that the connection was already closed. If this problem occurs, you must install Sybase EBF 9422 or later. Note that, even if you encounter a JZ0C0 error, the administrative and application servers should work properly on EBFs prior to 9422.
Read the problems and fixes that apply to the type of entity bean used:
You may receive errors when creating database tables using Oracle when running the "Assembling, installing, deploying and accessing an EJB 1.1 application." To manually deploy the beans, do the following:
ejbdeploy EJB11Big3.jar tmp Ejb11Big3depl.jar -novalidate -dbvendor ORACLE_V8
During EJB deployment, the following GenerationException may be thrown:
null com.ibm.etools.codegen.api.GenerationException at com.ibm.etools.java.codegen.JavaCompilationUnitGenerator.addImport (JavaCompilationUnitGenerator.java:50) ...
To correct the situation, run deployment again.
You might encounter problems with interoperability between WebSphere Application Server Advanced Edition version 4.0.1 and WebSphere for z/OS versions 4.0.0 and 4.0.1 when applications deployed on WebSphere for z/OS attempt to use enterprise beans deployed on the WebSphere Advanced Edition. To exploit interoperability between WebSphere Advanced Edition and WebSphere for z/OS, check the RETAIN PSP bucket for the latest service recommendations for Websphere 4.0 for z/OS and OS/390.
When using the default value of the Module visibility setting, if the application server Module property and your application includes multiple EJB JAR modules and the client module, without any dependency specification among the JAR modules, the Java client might return an exception such as the following:
Exception within loop - continuing - java.rmi.ServerException: RemoteException occurred in server thread; nested exception is: com.ibm.ejs.container.UncheckedException: ; nested exception is: java.lang.LinkageError: Class com/ibm/wssvt/tc/pli/ejb/Person violates loader constraints java.rmi.ServerException: RemoteException occurred in server thread; nested exception is: com.ibm.ejs.container.UncheckedException: ; nested exception is: java.lang.LinkageError: Class com/ibm/wssvt/tc/pli/ejb/Person violates loader constraints com.ibm.ejs.container.UncheckedException: ; nested exception is: java.lang.LinkageError: Class com/ibm/wssvt/tc/pli/ejb/Person violates loader constraints java.lang.LinkageError: Class com/ibm/wssvt/tc/pli/ejb/Person violates loader constraints
To fix this problem of class duplication among JAR modules, do the following:
Manifest-Version: 1.0 Main-Class: com.ibm.wssvt.tc.pli.apps.TestClient Class-Path: liagentna11.jar lipersonna11.jar lipolicyna11.jar
For example, using the example in step 1, note that lipersonna11.jar created the classes "Person.class, PersonHome.class, PersonKey.class", which are also referenced by the other two jars, liagentna11.jar and lipolicyna11.jar. However, during an earlier exporting of the EJB JAR file, the option Select reference types and resources included all referenced classes, meaning that the other two JARs, liagentna11.jar and lipolicyna11.jar, got the "Person ..." classes included too. The duplicate "Person ..." classes must be removed from these two JARs.
If you created a VisualAge for Java association, the default name of the relationship will cause problems because of the generated hyphen (-) in the table.ddl file. The hyphen creates a syntax error when attempting to create tables in an Informix database. You cannot use a table.ddl if the association was created using VisualAge for Java.
If you install the session bean in EJBCommandTarget.jar that is contained in the WebSphere_installation_root\lib directory, you will then have an EJBCommandTarget.jar in the WebSphere_installation_root\installedApps\EJBCommandTarget.ear directory. Having EJBCommandTarget.jar in these two places can cause classloader problems. To fix this problem, move this jar file out of the WebSphere_installation_root\lib directory and place it in the WebSphere_installation_root\installableApps directory. This way, you will still have a copy of the original jar, but it will not get picked up at run time by the wrong classloader.
Generated code for a CMP bean when using a Merant JDBC driver to access a database might cause errors if a TEXT column type for the database is used. For example, with the Microsoft SQL Server database, you might get the error [HY104][SQL Server]Invalid precision value. The code updating the TEXT field is bad if the field to be updated is NULL at the particular instance. The code generated asks the database to update the field as LONGVARCHAR when the field is NULL and as VARCHAR when field is not NULL.
Due to a bug in the Merant SequeLink Driver, the clearParameters method
does not adequately reset parameters to allow prepared statements to be
reused in all cases. The solution is to disable prepared statement caching
on the BRBeans data source by setting the Statement Cache Size to 0
.
For the Advanced Single Server Edition, the Statement Cache Size property
among the data source properties. For the Advanced Edition, it will be among
the connection pooling properties of the data source.
When compiling an EJBModule that has CMP-based entity beans which use primitive primary keys, you might get an error message resembling the following:
Compiling content of ejbModule/com/ibm/ejb/cb/samples/big3/tier2 (12 problems found) Copying all resources on the classpath (12 problems found) Build done Java build completed Invoking Validation on /Big3BRB.jar. ejbModule/com/ibm/ejb/cb/samples/big3/tier2/EJSCMPClaimHomeBean.java(62): The constructor java.lang.Integer() is undefined ... ejbModule/com/ibm/ejb/cb/samples/big3/tier2/EJSJDBCPersisterCMPPolicyBean.java(197): The constructor java.lang.Integer() is undefined Shutting down workbench. Execution Halted: Compilation Errors Reported 12 Errors, 0 Warnings, 0 Informational Messages
Compilation halted because the deployment descriptor specified used a primitive object key (java.lang.Integer) but did not specify a key field to which the deployment descriptor should map. It was left as a compound key. Therefore, the deploy tool did not know which field to use as the key and returned the error messages.
As to the generated deployment descriptor in the above example, the <prim-key-class> element was set to java.lang.Integer but there was no <primkey-field> element specifying which <cmp-field> element should map to the primary key.
The solution is to use the Application Assembly Tool to specify which key field (other than compound key) should be used or to manually edit the ejb-jar.xml and add the <primkey-field> elements.
A javax.ejb.FinderException can occur when a finder method is called for an entity bean with CMP and the finder is defined incorrectly. This failure occurs when the finder returns more than one EJB object (returns either a java.util.Enumeration or a java.util.Collection) and the finder logic is encapsulated in a String constant named findMethodNameQueryString. The failure occurs because the SQL select statement encapsulated by the Java String constant is incorrect. Either the encapsulated SQL select statement does not include a complete list column names for each of the CMP fields, or the list column names does not appear in the order required to successfully hydrate the entity bean. The following is an example of the error that occurs when the encapsulated SQL select statement does not include all required column names:
ERROR: javax.ejb.FinderException: com.ibm.ejs.persistence.EnumeratorException original exception: com.ibm.ejs.container.ContainerInternalError:; nested exception is: COM.ibm.db2.jdbc.DB2Exception: [IBM][JDBCDriver] CLI0610E Invalid column number. SQLSTATE=S1002
Note that encapsulating the logic in a String constant named findMethodNameQueryString has been deprecated. What follows describes how to correctly create the finder logic in a EJB server so that the above failure and similar failures do not occur.
Creating finder logic in the EJB server
For the EJB server environment, the following finder logic is required for each finder method (other than the findByPrimaryKey method) contained in the home interface of an entity bean with CMP:
As an example, suppose the AccountHome home interface defines the following finder method:
Enumeration findLargeAccounts(float amount) throws RemoteException, FinderException;
You must also create the AccountBeanFinderHelper interface as follows:
public interface AccountBeanFinderHelper { String findLargeAccountsWhereClause = "balance > ?"; }
You can use the Application Assembly Tool to define the finder logic as well. For each CMP entity bean, select your entity bean and Method Extensions choice in the Application Assembly Tool's tree view and set the Finder descriptor for each finder method. Using the Full select radio button is not recommeded because it can easily result in the javax.ejb.FinderException being thrown when the required list and order of column names is not used. Use the Where clause radio button to obtain the correct list of column names and order.
If a CMP bean is defined with one CMP field of type StringBuffer and a deployed ear is generated with a database type of image in the Table.ddl file, the table can be created successfully when the Table.ddl file is run but testing the CMP bean causes the following error message:
<operation failed>: java.rmi.ServerException: RemoteException occurred in server thread; nested exception is: com.ibm.websphere.cpi.CPIException: java.sql.SQLException: [MERANT][SequeLink JDBC Driver]Driver cannot perform requested operation: ResultSet.getBlob().; nested exception is: java.sql.SQLException: [MERANT][SequeLink JDBC Driver]Driver cannot perform requested operation: ResultSet.getBlob().
The exception is caused by a limitation of the Merant/SQLServer driver: the driver does not support the get and setBlob() operators which WebSphere drivers use to access binary fields.
Try mapping the StringBuffer to a character type such as text for large character fields on SQL Server. It may require a converter because StringBuffer is not directly supported by JDBC String APIs.
FixPak 2 for WebSphere Application Server Version 4.0 adds a new system property for the Web container resource: client.encoding.override. You use the client.encoding.override property to override any client preferences for parsing client input values. To ensure that the correct encoding is used to parse the input values, specify this new property instead of the system property default.client.encoding for the JVM settings of the application server.
The following search order determines the client encoding used by the Web container:
FixPak 2 for WebSphere Application Server Advanced Edition Version 4.0 adds a new parameter for Object Request Broker (ORB) Thread pools: com.ibm.ws.OrbThreadPoolGrowable. You use the parameter to control the growth of ORB threads from incoming client requests. The default behavior allows the ORB to spawn as many threads as necessary to service incoming requests. To limit the number of concurrent threads to the value specified on the ORB Settings panel in the administrative client, set the parameter to -Dcom.ibm.ws.OrbThreadPoolGrowable=false. You can set the parameter as a command-line argument using the Advanced JVM Settings, which are part of the JVM Settings.
For an application server to reference native code, the path to that code must be included in the java.library.path environment variable. Version 4.0 FixPak 2 provides a way for you to include a path for a specific application server only. To include the path, go to the administrative console's application server configuration notebook and open the JVM Settings panel. In the System Properties field, add a name-value pair for the needed library path. Set the name to java.library.path and set the value to the path where your native code resides. For example, set the name-value pair to name=java.library.path and value=c:\bin. In such a case, when the application server launches, c:\bin prepends to the java.library.path environment variable.
If the SoapEarEnabler.sh script on Solaris fails with function: unknown command, it is due to the level of bourne shell on the system. To fix the problem, open an editor on SoapEarEnabler.sh and modify the script by changing the line:
function run
to:
run()
Assigning a large number of users or groups (greater than 5000) to a role might fail (in the Security Center).
When possible, assign roles to groups. There typically are fewer groups than users. Also, this will improve performance during server startup and during the authorization check.
SSL settings are managed by the administrative console. Any editing changes made to the following properties in sas.server.props will be overwritten at runtime.
While receiving a CA Certificate into a new SSL key file using WebSphere JSSE iKeyman, the product may return the error message An error occurred while receiving the certificate from the given file.
The workaround is to save the SSL key file before creating a certificate request:
After you enable security, you cannot access enterprise java beans (EJBs) spread across other nodes. The error throws authorization failed exceptions and CORBA TRANSACTION_ROLLBACK exceptions. To work around this problem, ensure all the nodes involved are in the same time zone.
A key file and trust file can be used to store certificates in the Advanced Edition 4.0.x, conforming to JSSE guidelines. The key file is typically for private keys and the trust file is typically for signer certificates. With this approach, you can pass the trust file to anyone with the same trust requirements but keep the private key of the key file separate for each machine. However, when you add a signer certificate to the trust file (ORB SSL connections only), the certificate does not get picked up and you might see Unknown CA or Unknown Certficate errors and the SSL handshake will fail.
As a workaround to this problem, you should add your signer certificates to the key file's signer certificates section from within iKeyMan. See the InfoCenter for information on using the iKeyMan tool. The key file can be specified in the Security Center under Default SSL Configuration, or you can override these defaults by specifying a different SSL configuration for each ORB. To do this you should go to the Service tab of the application server and edit the Object Request Broker service. Go to the Advanced tab and select Configure SSL.
WebSphere Application Server for Linux on zSeries Version 4.0 (based on Version 4.0.2) does not support debugging. Debugging will be supported when the fix to PMR 38519,001,866 becomes available.
When debugging on the HP-UX platform, there is a known HP-UX JDK product defect that may cause the application server to crash. To work around this problem, restart the machine.
The IBM distributed debugger requires that Object Level Tracing is enabled. If you modify your application server configuration such that OLT is not enabled and the IBM distributed debugger is enabled and click the Apply button, you will receive the following message:
ADGU3124W: The IBM Distributed debugger only works when Object Level Tracing is enabled. Do you want OLT enabled now?
If you select Yes, OLT is enabled and your property changes are saved. If you select No, the Apply selection is canceled and your changes are not saved. To save any changes, go to the Advanced JVM Settings dialog, de-select Enable IBM distributed debugger, and click OK and then Apply.
When you select Enable IBM distributed debugger from the Advanced JVM Settings dialog and OLT is not enabled, you are asked whether you want to enable OLT. If you select Yes, both OLT and the IBM distributed debugger are enabled.
The dertrjrt.jar file must be in the Java runtime classpath for tracing only. Note that the "Tracing only" section under "Local debugging" in the InfoCenter article "Debugging a Java client" does not mention that this file must be added to the classpath to enable tracing only.
Read the problems and fixes that apply to your language:
Data files that contain the information for the default and sample configurations are not translated in this release. For example, objects such as Default Server and Sample DB Driver will have English names and descriptions even in non-English locales.
echo
statements from batch files and shell scripts (for example,
ejbdeploy
and adminclient
) also are not translated.
This release of WebSphere Application Server provides the English (en_US) installation of the application client (J2EE client and Java thin client) only.
On AIX and for Korean and other languages, some WebSphere Application Server pages may be corrupted. To fix the page display, uncheck the Auto-select in the View -> Encoding menu option of Microsoft Internet Explorer browsers or the View -> Character Set option of Netscape browsers.
The installation destination directory path for WebSphere Application Server Advanced Edition and for WebSphere Application Server Advanced Single Server Edition does not support double-byte characters.
For supported locales, see InfoCenter article 6.6.49.
Before installing WebSphere Application Server Advanced Edition for Linux on zSeries (390) onto a Linux for z390 distribution, ensure that True type font and Input method are available on your distribution for your DBCS locale.
If you have CD-ROMs for the WebSphere Application Server Version 4.0.1 and Version 4.0.2 for Linux on zSeries releases, you can access the administrative client remotely by doing the following:
adminclient host_name_of_Linux_on_zSeries_machine
Note that the Turbo Linux 6.5 for z390 distribution does not support DBCS.
If you are using one of the supported DBCS locales, one of the following filesets is required:
AIX:
X11.fnt.ucs.ttf (for ja_JP or Ja_JP) X11.fnt.ucs.ttf_CN (for zh_CN or Zh_CN) X11.fnt.ucs.ttf_KR (for ko_KR) X11.fnt.ucs.ttf_TW (for zh_TW or Zh_TW)
Solaris:
SUNWjxcft, SUNWjxmft (for ja) SUNWkcoft (for ko) SUNWgttf (for zh_GBK) SUNW5ttf (for zh_TW.BIG5)
If you are running WebSphere Application Server on an AIX machine, true type fonts (TTFs) must be installed in order for the characters to display properly. These fonts are not installed automatically with AIX default installation.
If you are installing the Japanese version of WebSphere Application Server, after the install process completes, the FirstSteps window appears. If you select Start Server from the FirstSteps window, a new window appears and the Japanese characters appear corrupted. However, if you cancel the FirstSteps window and open a terminal session, you can start the server from the command line and the messages will appear without corruption.
If you are installing WebSphere Application Server Advanced Single Server
Edition on a Sun Solaris
machine (Simplified Chinese Only), change the GB2312 key in
the converter.properties file from Cp1386
to GBK
to avoid corruption on the administrative console. The converter.properties
file is located in the following directory: WebSphere/AppServer/properties.
You might encournter the following problems with the Simplified Chinese release of WebSphere Application Server:
com.ibm.ejs.sm.client.command.ExecutionException: command server.start failure
To fix the problem, do not assign a new application server a Simplified Chinese name.
./waslogbr
in the directory
WebSphere_main_directory/bin. A log analyzer console will open with
an English interface. Open one log file, such as activity.log, and the
correct output pops up.rservs
to rerv
.
(If the editor is Windows Notepad, the two s characters in rservs
are displayed as garbage characters.)When installing on UNIX, certain traditional Chinese characters will not be displayed properly due to a JDK 1.3 product limitation. Some characters will be displayed wrong or will be unreadable.
If you are using the Java Pet Store sample with Oracle as the database, be aware that repeated transactions (same user re-ordering same item) are not supported on Oracle.
The first release of WebSphere Application Server Advanced Single Server Edition Version 4.0 had an Execution State field in the console that you could set. This field has since been removed, though the InfoCenter still references it in the article "6.6.3.0: Application server properties" and in the installation information for the Advanced Single Server Edition on UNIX platforms.
Though you can still set the execution state value by modifying the XML file, there is no longer a field in the console that you can modify to change the field's value. In fact, there is no need to change the value because it controls the initial state of the application server, which must be running for the console to be operational.
In the "Command arguments" section of the InfoCenter article "6.6.0.15.1: Generating EJB deployment code from the command line," the list of valid databases under -dbvendor includes DB2UDBWIN_V71 (DB2 for Windows, V7.1. The Application Assembly Tool no longer has this option but, instead, has the option DB2UDBWIN_V72 (DB2 for Windows, v7.2).
After installing FixPak 2 for WebSphere Application Server Version 4.0.1 on AIX and running ./configClient.sh in the /usr/WebSphere/AppServer/bin directory to access the Application Client Resource Configuration Tool, you cannot access concept or task help from the Tool's Help menu. Trying to access the help from the Tool's Help menu results in the following error message:
WSCL0150E: There is no Help file /usr/WebSphere/AppServer/web/Infocenter/was/ccrcthelpfile.txt
You cannot access the help file because the path should point to the InfoCenter directory and not to the Infocenter directory. To view the help, browse the file /usr/WebSphere/AppServer/web/InfoCenter/was/ccrcthelpfile.txt.
On the Advanced Single Server Edition, you might not be able to open PDF versions of the documentation if you accessed help through the administrative console. As a workaround, point your Web browser to the index.html page of the InfoCenter, which is located in the subdirectory main_WebSphere_directory/web/InfoCenter and has the URL main_WebSphere_directory/web/InfoCenter/index.html.
To correct the problem, do not install the InfoCenter jar files into the same directory as the WebSphere Application Server product. Install into a separate directory. The following steps describe how to download and install the full WebSphere Application Server InfoCenter from a self-extracting .jar file.
java
command is recognized.InfoCenter_name.jar.zip
to:
InfoCenter_name.jar
In other words, remove the .zip from the end of the file. Web browsers often treat .jar files as corrupted so .zip is added to the end of the file to avoid this problem.
java
command to install the InfoCenter:
java -jar InfoCenter_name.jar
java -classpath InfoCenter_name.jar;%CLASSPATH InfoCenterDoc.class
In the Version 4.0 Advanced Edition InfoCenter, expanding the Contents choices Application Server AE and then Migration does not show a link to article "3.7: Interoperability with Version 3.5.x." To view the article, click on Table of Contents under Migration and click on the link "3.7: Interoperability with Version 3.5.x" at the bottom of the Table of Contents page.
The Version 4.0 InfoCenter article "6.6.8.0.aa: Assembly properties for Web modules" contains inaccuracies. The descriptions for classpath and additional classpath should be as follows:
myapp.ear/mywebapp.war myapp.ear/class1.jar myapp.ear/class2.zip
Specify class1.jar class2.zip as the value of the Classpath property. Note that loading of .class files from the EAR file is not supported, as it is not J2EE portable.
myapp.ear/mywebapp.war myapp.ear/class1.jar myapp.ear/class2.zip
Specify class1.jar;class2.zip as the value of the additional classpath property. Note that loading of .class files from the EAR file is not supported, as it is not J2EE portable.
The Version 4.0 InfoCenter is missing information on configuring SessionManager with DB2 OS390 as the persistent store. The information is available in the Version 3.5 InfoCenter in the article "1.2.3.2.3: Switching server databases to DB2/390." Note that only the section "Setting up the HttpSession database in DB2/390" applies to sessions.
The InfoCenter article "6.6.8.0.14: Assembly properties for MIME filters" describes MIME Filter - Target incorrectly as "Specifies the target virtual host for the servlets." Instead, the description should state "Specifies the target servlet name to which the filter output will be routed."
The InfoCenter article "6.6.14.5: Additional administrative tasks for specific databases" has incorrect bean values for the Oracle 8.1.7 two phase commit support. The correct bean values are REQUIRED, BEAN_METHOD, and _READ_COMMITTED and not TX_REQUIRED, TX_BEAN_MANAGED and TRANSACTION_READ_COMMITTED.
The InfoCenter article "6.6.3.0: Application server properties" incorrectly states that the default module visibility for the Advanced Single Server Edition is COMPTABILITY. It should state that the default module visibility is APPLICATION.
The hyperlinks to DER_DBG_TAB and DER_DBG_TABGRID at the bottom of the article "Setting environment variables for the Debugger" in information in English on the Distributed Debugger incorrectly go to a Spanish page.
The statement that "each server group and clone must be secured individually" in the InfoCenter article "6.6.18.1.2: Securing cloned applications" is incorrect. To secure a cloned application, you secure an enterprise application, put that secured application into a server group, and then make clones of the server group.
The InfoCenter Version 4.0 article "6.6.18.1a.7: Configuring SSL in WebSphere Application Server" provides the following incorrect SSL example for configuring a plug-in:
<Property name="keyring" value="product_installation_root\myKeys\plug-inKeys.kdb"> <Property name="stashfile" value="product_installation_root\myKeys\plug-inKeys.sth">
The example should be as follows:
<Property name="keyring" value="product_installation_root\myKeys\plug-inKeys.kdb"/> <Property name="stashfile" value="product_installation_root\myKeys\plug-inKeys.sth"/>
The example elements need a forward slash (/) at the end of each element to terminate them.
The TechNotes database contains additional information about known defects and the workarounds. The TechNotes database also includes some supplemental information for topics covered in the WebSphere Application Server documentation.
To search the TechNotes database, go to the TechNotes database Web page, select a component, and click Go. You can also search the database by keywords.