Release Notes
|
|
|
This document provides important information about all WebLogic Platform 8.1 releases up to and including Service Pack 6.
It includes the following topics:
For updated release note information, see the BEA documentation Web site at the following URL:
Note: If you are using an earlier version of WebLogic Platform 8.1, such as Service Pack 4, and you need information specific to that service pack, see "Important Usage Notes for Previous Releases of WebLogic Platform 8.1" at:
http://e-docs.bea.com/platform/docs81/sp_notes/sp_notes.html
This document provides instructions for tasks such as enabling 128-bit encryption, configuring your WebLogic Platform domain for Oracle9i RAC, and downloading and installing the SDK1.4.2/Oracle10gdriver/Database patch.
For detailed information about any of the components of WebLogic Platform—WebLogic Server, WebLogic Workshop, WebLogic Integration, WebLogic Portal, or BEA JRockit—see the Release Notes document for the component in question.
|
http://e-docs.bea.com/workshop/docs81/relnotes/relnotes.html |
|
|
http://e-docs.bea.com/wljrockit/docs142/relnotes/relnotes.html |
This section describes the changes that have been made to this document since the release of BEA WebLogic Platform 8.1 Service Pack 5 (SP5).
|
Added support for MircoSoft SQL Server 2005. See Database Support for 8.1 SP6 in Supported Configurations for WebLogic Platform 8.1. |
|
|
Added CR287393, which addresses how to use the Config Wizard to create a JDBC connection pool when the database is MircoSoft SQL Server 2005, to Known Limitations. |
|
|
Added CR248707, which addresses the removal of the WebLogic Workshop IDE from a production environment, to Known Limitations. |
The following two substitutable strings are used throughout this document, in pathnames:
BEA_HOME represents the directory that serves as a repository for files used by multiple BEA products installed on the same machine, such as license files. A typical value for BEA_HOME is c:\bea, but you can designate any directory as BEA_HOME.WL_HOME represents the directory in which WebLogic Platform software is installed. By default, it is located under BEA_HOME. A typical default pathname is c:\bea\weblogic81, but you can situate WL_HOME in any directory.
BEA WebLogic Platform merges all the features of the existing BEA WebLogic products—application server, development, portal, and integration—into a highly integrated solution. This integrated solution combines the benefits of a common application infrastructure with an easy-to-use, robust framework.
Service Pack 6 includes the following enhancements and changes:
WebLogic Portal provides an Import utility for automatically deploying JSR-168 portlets that are packaged in JSR-168 WAR files. This utility lets you import JSR-168 WAR files containing JSR-168 portlets, and expose the portlets in WSRP producers.
After you start the utility, you can import the JSR-168 WAR files into an enterprise application (EAR file). You can then either automatically deploy the EAR file or deploy it from the Administration Console. After the new EAR file is deployed, you can add the portlets contained in the imported WAR file(s) to your application by adding the web applications as WSRP producers.
For more information, see "Deploying JSR-168 Portlets in WAR File" in Preparing and Deploying the EAR File" in Production Operations User Guide at http://edocs.bea.com/wlp/docs81/prodOps/deployment.html#1029385.
WebLogic Portal supports pluggable cache framework using existing or third-party distributed cache systems. Cache implementation in WebLogic Portal has been modified to use configured cache providers instead of using the automatic cache implementation.
For more information about pluggable cache implementation, see CacheProvider athttp://edocs.bea.com/wlp/docs92/javadoc/index.html.
BEA WebLogic Platform 8.1 Service Pack 5 (SP5) provides maintenance updates for all WebLogic Platform 8.1 components (WebLogic Server, WebLogic Workshop, WebLogic Integration, WebLogic Portal, and BEA JRockit). BEA WebLogic Platform 8.1 SP5 is the fourth full service pack for WebLogic Platform 8.1.
WebLogic Platform 8.1 SP5 can be used to update all WebLogic Platform 8.1 components.
Service Pack 5 includes the following enhancements and changes:
For a complete list of the new features introduced in WebLogic Platform 8.1 GA, 8.1 SP2, 8.1 SP3, and 8.1 SP4, see the "What's New" page at the following URL:
http://e-docs.bea.com/platform/docs81/interm/whatsnew.html
Oracle Real Application Clusters (RAC) is a software option you can add to an Oracle 9i or 10g database to allow multiple database instances to access the same database (storage) simultaneously via cluster technology. In SP5, support for Oracle9i RAC and 10g RAC is extended to all component products in WebLogic Platform 8.1.
The benefits of using Oracle RAC include:
When you configure a domain with Oracle9i RAC and 10g RAC, the use of WebLogic JDBC MultiPools and global (XA) transactions with connection pool failover and load balancing is supported.
For information about configuring and using Oracle RAC with your WebLogic domain, see:
WLST is a command-line scripting interface that you use to configure WebLogic Server and WebLogic Platform domains. Using WLST, WebLogic Server administrators and operators can perform administrative tasks and initiate WebLogic Server configuration changes interactively or by using an executable script.
WLST supports both online and offline configuration:
Enables you to perform administrative tasks and initiate WebLogic Server configuration changes while connected to a running server.
Prior to SP5, WLST was available only as an unsupported developer offering from dev2dev. As of SP5, WLST is available and supported by BEA as follows.
|
The software, including documentation that explains how to set up and use WLST Online, is available at the following Web site:
|
As of SP5, WLST Online is supported for use with all releases of WebLogic Platform 7.0 and 8.1. |
|
|
As a set of JAR files and scripts bundled with the WebLogic Platform 8.1 SP5 software. Instructions for setting up and using WLST Offline, as well as sample scripts for configuring domains, are available from dev2dev at the following Web site:
|
WLST Offline is now supported for use with WebLogic Platform 8.1 SP5 and later service packs only. WLST Offline is not supported in WebLogic Platform 7.0, or in releases of WebLogic Platform 8.1 prior to SP5. |
The WebLogic Integration 8.1 Service Pack 5 release includes the following new features:
BPEL Import and Export tools are provided to enable design-time interoperability with other tools that support the BPEL 1.1 specification. For more information, see BPEL Import and Export User Guide, available at the following URL:
The TIBCO Rendezvous (TIBCO RV) control enables seamless connection to, and transfer of data with, TIBCO RV version 7.2.16 using the Rendezvous daemon. TIBCO RV event generator listens for messages on a Rendezvous subject and raises events to the message broker on receiving the desired message. For more information, see TIBCO Rendezvous Control and Event Generator User Guide, available at the following URL:
For more information about the 8.1 SP5 release of WebLogic Integration, see the WebLogic Integration Release Notes at the following URL:
http://e-docs.bea.com/wli/docs81/relnotes/index.html
The WebLogic Portal 8.1 Service Pack 5 release includes the following new feature enhancements:
.portal and .pinc files into the database, and also lets you export these files from the database. The exported files can be loaded back into WebLogic Workshop, or imported into another WebLogic Portal database.With SP5 you now have the ability to thread the "pre-render" lifecycle as well as, or instead of, the "render" lifecycle. If your portlets communicate with external systems during this lifecycle, you might want to implement pre-render forking.
http://e-docs.bea/com/wlp/docs81/url/simplify.htmlhttp://e-docs.bea.com/wlp/docs81/prodOps/index.htmlhttp://e-docs.bea.com/wlp/docs81/autonomy/intro.htmlhttp://e-docs.bea.com/wlp/docs81/index.htmlFor more information about the 8.1 SP5 release of WebLogic Portal, see the WebLogic Portal Release Notes at the following URL:
http://e-docs.bea.com/wlp/docs81/relnotes/relnotes.html
The WebLogic Platform 8.1 SP5 software supports the following Java 2 SDKs:
If you are upgrading a domain from SP4 to SP5, the script in that domain that sets the JAVA_HOME variable needs to be modified to point to the new SDK that has been installed. This script is located in the domain's root directory. Depending on the type of domain you are upgrading, this variable is set in either the setDomainEnv or startWebLogic script.
To update the value of the JAVA_HOME variable, set it to the directory containing either the Sun or JRockit 1.4.2 directory as appropriate. For example:
set JAVA_HOME=C:\bea\jrockit81sp5_142_08
If you are installing SP5 as an upgrade to a previous 8.1 release, it is also recommended that you update your application startup scripts and silent configuration scripts to reference the new Sun or JRockit SDK directory.
For a complete list of Java SDKs for each hardware and operating system combination supported in WebLogic Platform 8.1 SP5, see "Summary of Supported Operating System Configurations, by Release Number" in "WebLogic Platform 8.1 Supported Configurations" in Supported Configurations for WebLogic Platform 8.1 at the following URL:
http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/overview.html
To get hands-on experience with WebLogic Platform 8.1, we recommend that you try the following tutorials and samples:
WebLogic Server 8.1 provides the following tutorials and examples:
Information about running the tutorials and examples is available at:
http://e-docs.bea.com/wls/docs81/samples.html
WebLogic Workshop 8.1 provides the following tutorials:
Information about running the tutorials is available at:
http://e-docs.bea.com/workshop/docs81/doc/en/workshop/guide/navTutorials.html
WebLogic Workshop includes numerous fully documented samples to help you become familiar with WebLogic Workshop Web service design patterns, page flows, features, and programming techniques. After completing the tutorials, we recommend that you also run the following WebLogic Workshop samples:
http://e-docs.bea.com/workshop/docs81/doc/en/workshop/guide/netui/samples/navPageFlowAndJSPSamples.html
WebLogic Integration 8.1 provides the following tutorials:
http://e-docs.bea.com/wlibc/docs81/install/tutorial.html
Note: The code for the Trading Partner Integration tutorials is available for download from the dev2dev code samples Web site at the following URL:
https://codesamples.projects.dev2dev.bea.com/servlets/Scarab?id=75
WebLogic Integration also provides the following samples:
The following samples are available on BEA's dev2dev site and can be accessed from the following URL:
http://e-docs.bea.com/wli/docs81/sol_samples/index.html
WebLogic Portal 8.1 provides the following tutorials:
Information about running these tutorials is available at:
http://e-docs.bea.com/workshop/docs81/doc/en/portal/tutorials/tutOV.html
WebLogic Workshop 8.1 also provides sample portlets that you can use in the portals you create with WebLogic Workshop. Information about accessing these sample portlets is available at:
http://e-docs.bea.com/workshop/docs81/doc/en/portal/samples/samples.html
The WebLogic Platform Tour Guide provides a hands-on walk-through of a WebLogic Platform example developed with WebLogic Workshop. The example includes new portal, Web application, Java control, and business process functionality. To take the Tour, visit:
http://e-docs.bea.com/platform/docs81/tour/index.html
WebLogic Platform 8.1 provides the following tutorials:
Information about running these tutorials is available in "Tutorials: Using the Configuration Wizard" in Creating WebLogic Configurations Using the Configuration Wizard at the following URL:
http://e-docs.bea.com/platform/docs81/confgwiz/tutorials.html
Information about configurations supported by WebLogic Platform, including hardware and software requirements, is provided in Supported Configurations for WebLogic Platform 8.1 at the following URL:
http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/overview.html
If you have any questions about this version of WebLogic Platform, or if you have problems installing and running the product, contact BEA Customer Support through BEA eSupport at:
You can also contact Customer Support by using the contact information provided on the BEA Customer Support card, which is included in the product package.
When contacting Customer Support, be prepared to provide the following information:
For WebLogic Platform 8.1, special installation and usage instructions are required for some operating systems, such as IBM AIX 5.1 and HP-UX 11i v2 on Itanium.
These installation instructions are now provided in Supported Configurations for WebLogic Platform 8.1 at the following URL:
http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/install_info.html
The online help for the following tools includes a search function that is provided by a Java applet:
This applet requires a Java plug-in. If you do not have this plug-in installed on your system and you want to be able to search the online help for these tools, then you must install the plug-in.
Note: By default, the content for the Workshop IDE online help topics is hosted at BEA, and the search function is also performed at BEA. Unless you specifically configure the IDE to use help files that are installed on the local disk, the plug-in described in this section is never used for IDE help search.
If you are working on a Microsoft Windows platform, the first time you initiate a search in the online help for one of these tools, you are prompted to download and install the plug-in.
However, if you are working on the HP-UX, Red Hat Enterprise Linux, or Sun Solaris platform, you need to download and install the Java plug-in manually. Table 1 provides the Web site from which you can download the required Java plug-in for these platforms. The plug-in you download must be version 1.4 or later.
|
For Itanium-based systems, download and install the latest Runtime plug-in version 1.4.2 from: http://www.hp.com/products1/unix/java/java2/jpi/downloads/ For PA-RISC-based systems, download and install the latest Runtime Environment for Java version 1.4.2 from: http://www.hp.com/products1/unix/java/java2/sdkrte14/downloads/index_pa-risc.html |
|
|
1. Go to the following URL and choose Download J2SE JRE: http://java.sun.com/j2se/1.4.2/download.html. |
|
|
1. Go to the following URL and choose Download J2SE JRE: http://java.sun.com/j2se/1.4.2/download.html. |
This section provides tips, based on best practices, for configuring the environment in which you run WebLogic Platform 8.1:
This release provides the BEA JRockit SDK and JVM. BEA JRockit is designed specifically to address the needs of server-side applications. To use WebLogic Platform 8.1 client-side development tools and features, such as the WebLogic Workshop IDE, use of the Sun Java 2 SDK is recommended. Therefore, when using the WebLogic Workshop IDE to develop applications to run on the JRockit SDK, do not remove the Sun Java 2 SDK 1.4.2 from your machine because it is required by the IDE.
Notes: JRockit is available on Windows and Linux platforms only.
For some UNIX platforms, the WebLogic Platform installation program does not include an SDK.
For a list of JVMs supported for your operating system and hardware platform, see "Summary of Supported Operating System Configurations, by Release Number" in "WebLogic Platform 8.1 Supported Configurations" in Supported Configurations for WebLogic Platform 8.1 at the following URL:
http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/overview.html
The following instructions are provided for users who have already installed WebLogic Platform 8.1 SP5 and want to switch to another JVM:
startWebLogic.cmd (Windows) or startWebLogic.sh (UNIX).The following set JAVA_VENDOR and set JAVA_HOME commands specify the BEA JRockit 1.4.2 SDK, where c:\bea is the BEA home directory:
set JAVA_VENDOR=BEA
set JAVA_HOME=c:\bea\jrockit81sp5_142_08
For Sun, the equivalent commands are as follows:
JAVA_VENDOR variable is not set in the WebLogic Server start script, then you need to set the default JVM in the setDomainEnv.cmd (Windows) or setDomainEnv.sh (UNIX) script as described in this step. The setDomainEnv script is also located in the domain's root directory.The following two code snippets show the switching of the default JVM from Sun Java 2 SDK 1.4.2 to BEA JRockit 1.4.2 SDK in commEnv.cmd on Windows. In these snippets, the BEA home directory is c:\bea.
The first code snippet shows the initial settings that establish Sun Java 2 SDK 1.4.2 as the default:
if "%JAVA_VENDOR%"=="BEA" (
set JAVA_HOME=C:\bea\jrockit81sp5_142_08
) else (
if "%JAVA_VENDOR%"=="Sun" (
set JAVA_HOME=C:\bea\jdk142_08
) else (
set JAVA_VENDOR=Sun
set JAVA_HOME=C:\bea\jdk142_08
)
)
The second code snippet shows the changes, in bold, made to switch to JRockit as the default:
if "%JAVA_VENDOR%"=="BEA" (
set JAVA_HOME=C:\bea\jrockit81sp5_142_08
) else (
if "%JAVA_VENDOR%"=="Sun" (
set JAVA_HOME=C:\bea\jdk142_08
) else (
set JAVA_VENDOR=BEAset JAVA_HOME=C:\bea\jrockit81sp5_142_08
For more information about WebLogic Platform 8.1 support for BEA JRockit and the Sun Java 2 SDK, see "Summary of Supported Operating System Configurations, by Release Number"
in "WebLogic Platform 8.1 Supported Configurations" in Supported Configurations at the following URL:
http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/overview.html
If your domain includes the MS SQL Server, DB2, Oracle RAC, or Sybase database, see Managing WebLogic Platform Database Resources at the following URL for required database setup information:
http://e-docs.bea.com/platform/docs81/db_mgmt/index.html
This document also includes the following sections:
It is recommended that you do not exceed a maximum of 12 characters when naming your BEA Home directory. If the name of this directory contains more than 12 characters, the CLASSPATH resolution may not be performed properly.
A WebLogic Integration domain that includes an administration server and one or more managed servers must include a cluster. The Configuration Wizard enables you to create a WebLogic Integration domain that includes an administration server and one or more managed servers without a cluster, but this is an unsupported configuration.
When creating a domain for WebLogic Server, WebLogic Integration, WebLogic Portal, or WebLogic Workshop, the database schema used in that domain cannot be used or referenced by any other domain. For example, the database schema for the WebLogic Integration repository that is configured in one domain cannot be shared by the WebLogic Integration configuration in another domain.
Note that WebLogic Platform supports only those users of the Apache multithreaded option who use 2.0.48 or a higher version of Apache. For complete details about Apache Web Server support in WebLogic Platform 8.1, see "Supported Web Servers, Browsers, and Firewalls" in Supported Configurations for WebLogic Platform 8.1 at the following URL:
http://e-docs.bea.com/platform/suppconfigs/configs81/81_over/add-ons.html
This section describes problems that have been identified in this release. For each problem listed in the following table, a problem ID is specified. These IDs enable BEA and users to monitor the status of issues while solutions are being developed. Whenever possible, workarounds are provided.
|
When there is an invalid login attempt, while using the com.bea.p13n.controls.login.UserLoginControl, only a `Failed Authentication' exception message is displayed. A more descriptive message is required to be displayed to the user. Workaround: The |
|
|
Each script in WL_HOME/common/eval/pointbase/tools/startPointBaseConsole requires a PointBase Server to be started independently If a PointBase Server is not running when the PointBase Console is launched, the Connect to the Database option fails with an error message (SQL State 08004). Workaround: Before launching either a domain-based startPointBaseConsole script or the PointBase Console (from one of the Example links on the Start menu), start the WebLogic Server for the relevant domain. As it starts each domain, WebLogic Server also starts the PointBase Server associated with the domain. When you log in to the database console (by selecting Connect to the Database), enter |
|
|
Restrict the addition of an application via extension template if the application already exists in the domain The Configuration Wizard allows you to extend a domain using an extension template that contains an application name that already exists in the target domain. As a result, two applications of the same name will end up in the Workaround: No workaround exists. Make sure that any extension template you plan to use does not contain an application with the same name as an application in your domain. |
|
|
Workshop Web service fails to invoke secure WebLogic Server Web service due to a missing timestamp header Interoperability between Workshop Web services and a secure WebLogic Server Web service is currently not supported. |
|
|
Windows-31J is not included in versions 1.4.0 through 1.4.1_03 of the Sun Java 2 SDK The WebLogic Workshop 8.1 IDE and compiler use a new API from Sun called java.nio.Charset (introduced in the Sun Java 2 SDK 1.4.0). The implementation of this API contains a bug: Windows-31J, the Japanese character set most commonly used in Windows, is not included in versions 1.4.0 through 1.4.1_03 of the Sun Java 2 SDK. For details, see: http://developer.java.sun.com/developer/bugParade/bugs/4626545.html The absence of Windows-31J does not mean that users cannot read and write their files using Japanese; other character sets are available. If, however, characters from a character set other than Windows-31J are included in an IDE file, the IDE fails silently: it allows the user to save the file, without issuing a warning that the file has been corrupted by the inclusion of non-Windows-31J characters. This problem will be solved in two future versions of the Sun Java 2 SDK: 1.4.1_05 and 1.4.2. These versions will include the Windows-31J (MS932) character set. Workaround: For types of files that may include encoding headers, including HTML, XML, and JSP files, specify UTF-8, instead of Windows -31J, for the file's encoding. |
|
|
If you change the DBMS Name for PointBase on Configure JDBC Connection Pools, the database files are not renamed In the Configuration Wizard window labeled Configure JDBC Connection Pools, you can change the values of several PointBase parameters: DBMS Name, Dbms Host, Dbms Port, User Name, and User Password. Your changes, however, are reflected only in the Workaround: When using the Configuration Wizard and a PointBase database, always accept the default values for DBMS Name, DBMS Host, DBMS Port, User Name, and User Password. |
|
|
The PointBase database must use port number 9093 The Configuration Wizard offers the option of changing the port number used by PointBase from the default. If you do change the PointBase port number, however, the test connection for the database fails and the server cannot start properly. Workaround: Always accept the default port number for PointBase: 9093. |
|
|
When you try to stop the server by entering Ctrl+c, the PointBase process running in the background is not killed If you enter Ctrl+c to stop a server on a platform comprising Windows and PointBase, and then try to start a different server, you may get exceptions, but you will not get any obvious clues about the problem. Workaround: On Windows platforms, run the stopWeblogic script ( |
|
|
Generated stopWebLogic script cannot stop PointBase configured at a nondefault port The Configuration Wizard does not customize the stopWebLogic script ( |
|
|
Corrupted connections in connection pool using MS SQL Server and XA are used Shared use of a JDBC connection pool for global (XA) transactions by multiple Data Sources creates recovery problems in the event of a failure. Workaround: If you are using an MS SQL Server driver and corrupted connections have already occurred, adjust the JDBC Connection Pool configuration in the WebLogic Server Administration Console by doing the following: |
|
|
A java.lang.IncompatibleClassChangeError exception is generated when the clientgen or autotype Ant task is executed to generate non-built-in data type components from an XML Schema file This problem happens only when the following two circumstances occur simultaneously: (a) the This problem is discussed further in FAQs: Web Services in WebLogic Server Frequently Asked Questions. Workaround: Use any of the following three ways to work around this problem: 1. Use the 2. Remove the |
|
|
When Smart Update is used to revert a Service Pack installation, the End-to-End sample application domain is not reverted After a WebLogic Platform installation is reverted from SP2 to a previous release, the End-to-End sample application does not start. Workaround: After you revert a WebLogic Platform installation, restart the server in the End-to-End sample application domain you are using. |
|
|
Upgrade installer overwrites all user applications in the samples directory As part of the upgrade procedure, the WebLogic Platform 8.1 SP2 installation program automatically overwrites any files, including applications, that you have created in Workaround: Before installing SP2, make backup copies of any files or applications that you have created in For more detailed information regarding additional workarounds, please contact BEA Customer Support and reference CR126952. |
|
|
WebLogic Integration and End-to-End sample domains log MDB warnings during server startup When the server is started in either a Platform or End-to-end sample domain, the following messages are logged:
Workaround: These messages are advisory; they can be ignored. It is possible, by using the WebLogic Server Administration Console, to create the execute queues listed in these logged messages in such a way that they contain the listed EJBs. If you create execute queues in this way, however, make sure that you specify a thread size that accommodates the relevant application and tracking level. For more information about creating execute queues, see "Execute Queue http://e-docs.bea.com/wls/docs81/ConsoleHelp/domain_executequeue_config.html |
|
|
Use of org.apache.xalan.processor.TransformerFactoryImpl causes portability issues In the Also, use of the Xalan transformer obtained directly from Apache causes portability issues, because this version is newer than the JAXP currently shipped with WebLogic Server. Workaround: Set the Transformer Factory to |
|
|
Java error when running Workshop without Administrator privileges If you install WebLogic Workshop on a Windows system as a user with Administrator privileges, then all users must have Administrator privileges to use Workshop. Otherwise, users without Administrator privileges receive the following error when running a Workshop application:
Workaround: On Windows systems, install and use WebLogic Workshop as a user with Administrator privileges. |
|
|
Distributed queues assigned to an additional cluster cannot be configured because they do not appear in the JMS Queue dropdown list in the Configuration Wizard When using the Configuration Wizard to create a multi-cluster domain, a problem exists in the Configure JMS Distributed Queue Members window. This problem occurs when adding a distributed queue member to a JMS distributed queue that has been assigned to a second cluster. When you click on the queue, and click the Add button, the JMS Queue dropdown list is empty. This prevents you from using the Configuration Wizard to assign distributed queue members to a JMS distributed queue not on the primary cluster. Workaround: After creating the domain, use the WebLogic Server Administration Console to configure JMS distributed queues as follows: |
|
|
Anonymous login to Web application resources under certain circumstances can fail If your This combination, namely, Workarounds: (1) If you require these settings and the use of http://e-docs.bea.com/workshop/docs81/doc/en/workshop/guide/security/transport/conTwoWaySSL.html (2) If you are not using WebLogic Integration, you can change |
|
|
Domain administration port: error starting managed server on same machine as Administration Server When a cluster domain is configured with Managed Servers on multiple machines, including a machine that hosts both a Managed Server and the Administration Server, errors are generated in the log file for the Managed Server that is on the same machine as the Administration Server. Workaround: The administration port accepts only secure, SSL traffic, and all connections via the port require authentication. Enabling the administration port imposes the following restrictions on your domain:
|
|
|
Smart Update fails to complete on Red Hat Linux 64-bit systems When upgrading to WebLogic Server 8.1 SP3 on Red Hat Enterprise Linux 3.0 on Itanium systems, Smart Update hangs and does not complete the installation. (Smart Update works on Red Hat Enterprise Linux 2.1 on Itanium, but not 3.0.) Operating System: Red Hat Enterprise Linux AS, ES 3.0 on Itanium Workaround: Do not use Smart Update to upgrade to WebLogic Server 8.1 SP3 on Red Hat Enterprise Linux 3.0. Either use the upgrade installer, or perform a new installation of WebLogic Server 8.1 SP3. For more information about using the upgrade installer, see "Installing Service Packs and Rolling Patches Using a Downloadable Upgrade Installer" in "Installing Service Packs and Rolling Patches" in Installing BEA WebLogic Platform at the following URL: http://e-docs.bea.com/platform/docs81/install/update.html Note that if you are simultaneously upgrading WebLogic Server 8.1 and Red Hat Enterprise Linux (from 2.1 to 3.0), you can complete the following procedure to use Smart Update successfully to upgrade to SP3: |
|
|
Sun JDK HotSpot compiler crashes when precompiling JSPs in production mode (-server) with debug enabled In domains configured with the Sun Java 2 SDK 1.4.2_04, the Sun JDK HotSpot compiler can crash while precompiling JSPs with a HotSpot Virtual Machine Error. A log similar to the following may be generated:
This problem is most likely to occur with the following JVM command-line options:
Workaround: Any of the following workarounds prevent this problem from occurring:
|
|
|
EAR file component with pathname longer than 255 characters may not be accessible Before an EAR file is deployed on a domain, it is exploded to the |
|
|
When you add a Managed Server to a cluster in an existing domain, the domain fails to start If you add a Managed Server to a cluster in an existing domain, the updated domain fails to boot. This limitation exists if you attempt to add the Managed Server outside the scope of creating a new domain or modifying an existing domain via an extension template. Workaround: To add a Managed Server to a cluster, you must add the server via either a domain or a domain extension template. For example, you can add a Managed Server to an existing domain via the Configuration Wizard or WLST Offline in either of the following ways: |
|
|
When creating an extension template, the JMSDistributedQueues in a cluster domain are lost When using the Template Builder to create an extension template of a clustered domain that includes JMS distributed queues, those queues are excluded from the resulting template. Workaround: At the time you use the resulting template to extend a domain, configure each JMS distributed queue as required. |
|
|
Downgrading from SP5 to SP4 or SP3 may fail on HP-UX if maxdsiz is too small If you upgrade from 8.1 SP3 to 8.1 SP4, or from 8.1 SP4 to 8.1 SP5, by using Smart Update or the Upgrade Installer on an HP-UX 11.0 or 11i on PA-RISC configuration, and then try to use the same tool to downgrade from 8.1 SP5 to 8.1 SP4, or 8.1 SP4 to 8.1 SP3, the downgrade attempt may fail. |
|
|
Error encountered while upgrading from SP2 to SP3 on AIX If you upgrade WebLogic Platform from 8.1 SP2 to 8.1 SP3 on AIX, the upgrade process might fail before completion with the following message:
This condition occurs due to improper system memory cleanup when WebLogic Server 8.1 SP2 shuts down. Operating system: IBM AIX 5.1 or 5.2 PowerPC, POWER3, POWER4, and POWER5 Workaround: Before upgrading to SP3, you must manually clean out any unused libraries on your machine by using the |
|
|
Applications fail to launch from QuickStart if the installation directory name includes High-ASCII characters If the directory name for either the BEA Home or WebLogic Home directories contains characters from the High-ASCII character set, you cannot use QuickStart to launch applications, such as the Configuration Wizard. This is a limitation imposed by the Sun Java 2 J2SE. Operating system: Any system in which the Sun Java 2 J2SE is used Workaround: If you plan to use QuickStart to launch applications, during installation you should choose directories for BEA Home and WebLogic Server Home with names that include only the ASCII character set. |
|
|
The 'ulimit -n' command to limit the number of open file descriptors is not provided in commEnv.sh on HP-UX platforms On many UNIX platforms, Operating system: HP-UX 11.0, 11i on PA-RISC Workaround: In your shell environment, you can manually limit the number of open file descriptors, which should be set to less than 1024. |
|
|
Smart Update hangs during upgrade to SP4 on HP-UX If you use Smart Update to upgrade WebLogic Platform 8.1 on HP-UX 11i Itanium systems, the upgrade procedure hangs before running to completion. This problem occurs when you upgrade to any service pack of WebLogic Platform 8.1. Operating system: HP-UX 11i Itanium Workaround: Use the package upgrade installer instead of Smart Update for upgrading a WebLogic Platform 8.1 installation. For more information, see "Installing Service Packs and Rolling Patches Using a Downloadable Upgrade Installer" in "Installing Service Packs and Rolling Patches" in Installing BEA WebLogic Platform at the following URL: |
|
|
WLST failures should cause WLST to exit with failure Currently if the execution of a WebLogic Server Scripting Tool (WLST) script fails, WLST terminates without sending a proper failure notification. As a result, calling components that depend on a successful WLST script execution are not aware of the failure, such as when WLST is employed via Ant, which is a common use case. Workaround: When invoking WLST from an Ant script, it is recommended that you fork a new JVM by specifying |
|
|
Cannot overwrite another user's wlst_module.py file If you use WLST as a module, you are unable to overwrite another user's Workaround: Make sure you have write permissions to the directory specified by the |
|
|
Multibyte characters are garbled when WLST runs in interactive mode If you install WebLogic Platform on a machine that is configured with the multibyte character set, and launch WLST from a command window prompt, the output generated by WLST—in both the command window as well as any files into which WLST writes—is garbled. This problem occurs only when WLST is used offline in interactive mode; that is, when not connected to a running WebLogic Server instance. Workaround: On machines configured with the multibyte character set, use WLST offline in script mode. |
|
|
WLST fails to launch when multibyte characters are used in the installation path If the names of the directories in which WebLogic Platform is installed contain multibyte characters, attempting to start WLST from a command window fails, and an error message similar to the following example is displayed:
Workaround: When installing WebLogic Platform, do not specify directories for BEA Home or WebLogic Home that have names containing the multibyte character set. |
|
|
Failover with Oracle RAC takes longer than the time specified in Test Interval in RDBMSAuthenticator In a domain configured with Oracle RAC, the length of time required for failover to a secondary RAC node to complete is longer than the time specified in the Test Interval parameter in the RDBMSAuthenticator window. Workaround: The RDBMSAuthenticator will failover to a secondary RAC node only after detecting a database connection failure, either through failed user authentication attempts or through RDBMSAuthenticator connection tests. Connections that fail the tests are closed and reopened to re-establish a valid physical database connection, as determined by the Test Interval parameter specified while creating the RDBMSAuthenticator. The Test Interval setting should be based on a trade-off between system availability requirements and database performance impact. Lower settings will reduce the amount of time to detect RAC failures and reduce the likelihood of failed user authentication attempts, but will increase the database load. The default setting is 120 seconds. To minimize failed user authentication attempts due to RAC failures, set the Test Interval parameter to its minimum value of 5 seconds. With the Administration Server running, log in to your domain's Administration Console and navigate to Security |
|
|
Japanese characters are garbled in the graphical user interface to the installation program, Configuration Wizard, and Template Builder On Red Hat Enterprise Linux 4.0 systems configured with the Japanese character set, the graphical user interfaces to the installation program, Configuration Wizard, and Template Builder fail to display correctly. This problem is caused by a limitation in the Sun Java 2 J2SE 1.4.2_08 JDK, which does not have the Operating System: Red Hat Enterprise Linux 4.0 Workaround: Use the console-mode interfaces to these applications. Note: This limitation does not exist on Red Hat Enterprise Linux 3.0 systems. However, for Red Hat Enterprise Linux 4.0 systems, Sun provides a workaround that is described at |
|
|
Cannot install WebLogic Integration in a production environment without also installing the WebLogic Workshop IDE In WebLogic Platform 8.1 SP5, when you use a custom or silent-mode installation method to install the WebLogic Integration server component, both the WebLogic Workshop Runtime Framework and the IDE are installed. Only the WebLogic Workshop Runtime Framework should be installed with the WebLogic Integration server component. Workaround: To remove the WebLogic Workshop IDE from a production environment, manually delete the |
|
|
When using the Config Wizard to configure a JDBC pool connection, if you choose MS SQL Server as the database, the drop down for drivers does not list MS SQL 2005 as an option. Workaround: Depending on whether the pool is XA or non-XA, choose: |
|
|
WLS 8.1 SP6 B2B Soaks with MSSQL Database fails with XA Exception. In WebLogic Platform 8.1SP6, when JDBC connection pools have the ShrinkingEnabled attribute set to true, the 3.5 Data Direct driver used to fail long-running tests. Workaround: For optimal JDBC pool performance and stability, set ShrinkingEnabled attribute to false. |
This section lists problems that have been fixed in WebLogic Platform 8.1 that were described as known limitations in earlier versions of this document.
This topic includes the following sections:
Table 3 lists and describes the problems fixed in WebLogic Platform 8.1 SP4.
|
Exception occurs while the End-to-End server is being shut down If you boot the End-to-End server and then run the Fix Information: In SP3, the exception occurred while applications were being undeployed. In SP4, this problem no longer occurs because multiple applications with the same LoadOrder are deployed and undeployed in alphabetical order of deployment name. |
|
|
Application-scoped roles cause an error dialog to be displayed in the Workshop IDE After creating security roles in the Workshop IDE, an error dialog box is displayed with the following message:
This error does not prevent application deployment or role creation, but will occur with domains that are based on the Basic WebLogic Portal Domain template or Basic WebLogic Platform Domain template. The cause of this error is nominally the Identity Assertion security provider that is required for the Web Services for Remote Portals (WSRP) feature of WebLogic Portal, and occurs when the classloader of the JVM for the Workshop IDE is unable to locate the JAR file for that security provider. However, this error can occur with any custom security provider that cannot be located by the IDE JVM classloader. Workaround: The JAR file for the WSRP Identify Assertion provider, as well as any additional custom security provider configured for your domain, needs to be added to the classpath for the Workshop IDE. The IDE classpath is specified in the file Fix Information: The |
|
|
Domains created with the Configuration Wizard using non-XA compliant JDBC drivers are configured with EnableTwoPhaseCommit=true, which can result in data risks under certain failure conditions When the Configuration Wizard tool is used to configure a domain using non-XA JDBC drivers, the http://e-docs.bea.com/wls/docs81/ConsoleHelp/jdbc_datasources.html Workaround: The
To summarize the key information from the preceding topics:
|
|