![]() ![]() ![]() ![]() ![]() ![]() |
This document provides information about new capabilities, usage notes, and known limitations related to the installation and configuration of BEA Weblogic Server® 9.2, BEA Workshop for WebLogic Platform™ 9.2, BEA WebLogic Portal® 9.2 and BEA Weblogic Integration™. This document also provides information about WebLogic Server upgrade tools and the new capabilities provided for Independent Software Vendor (ISV) partners.
The following topics are included:
For the latest release note information for BEA Products, go to the BEA documentation Web site at the following URL:
For detailed information about the BEA products encompassed by the WebLogic Portal 9.2, BEA Workshop for WebLogic Platform 9.2, and WebLogic Server 9.2 releases, including BEA JRockit J2SE 5.0 (R26.0) JDK, which is contained in the installation of these products, see the corresponding Release Notes document as follows:
http://download.oracle.com/docs/cd/E13222_01/wls/docs92/notes/index.html http://download.oracle.com/docs/cd/E13222_01/wls/docs92/issues/index.html |
|
http://download.oracle.com/docs/cd/E13226_01/workshop/docs92/ws_platform/introduction/conWhatsNew.html http://download.oracle.com/docs/cd/E13226_01/workshop/docs92/relnotes/index.html |
|
http://download.oracle.com/docs/cd/E13214_01/wli/docs92/relnotes/intro.html http://download.oracle.com/docs/cd/E13214_01/wli/docs92/relnotes/intro.html |
|
The following list summarizes new features and changes in the installation and configuration tools used with BEA WebLogic Server 9.2, BEA WebLogic Portal 9.2 and BEA Workshop for WebLogic Platform 9.2.
WebLogic 9.2 includes powerful tools to assist you with upgrading your application environments including the WebLogic Upgrade Wizard for upgrading domains, custom security providers, and custom node managers, and BEA Workshop for WebLogic Platform 9.2 for upgrading WebLogic Workshop and WebLogic Portal applications.
Most WebLogic Server applications can be run without modifications in the new WebLogic Server 9.2 application environment. WebLogic Workshop and WebLogic Portal applications developed in 8.1 must be upgraded first before they can be run in WebLogic 9.2.
Table 1 below provides pointers to additional documents with information on upgrading application environments to WebLogic 9.2.
For information on upgrading WebLogic Server application environments from 6.1, 7.0, and 8.1, see
Upgrading WebLogic Application Environments.
For information on upgrading WebLogic Server application environments from 9.0 and 9.1, see
Roadmap for Upgrading WebLogic Application Environments.
|
||
For information on upgrading WebLogic Workshop application environments, see
Upgrading from WebLogic Workshop 8.1.
For information on domain upgrade see,
Upgrading a WebLogic Domain in
Upgrading WebLogic Application Environments.
|
||
For information on upgrading WebLogic Portal application environments, see the
WebLogic Portal Upgrade Guide and the
Upgrading WebLogic Portal Projects from Version 8.1 to Version 9.2 chapter of the Portal Development Guide.
For information about domain upgrade, see
Upgrading a WebLogic Domain in
Upgrading WebLogic Application Environments.
|
||
For information on upgrading WebLogic Integration application environments, see the
WebLogic Integration Upgrade Guide.
For information about domain upgrade, see
Upgrading a WebLogic Domain in
Upgrading WebLogic Application Environments.
|
||
For information on changes between 8.1 and 9.2, and for a list of unsupported usage patterns with applicable workarounds, see:
Rolling Upgrade is the process of upgrading a running WebLogic Server cluster with a patch, maintenance pack, or minor release without shutting down the entire cluster or domain. During the rolling upgrade of a cluster, each server in the cluster is individually upgraded and restarted while the other servers in the cluster continue to host your application.
Prior to the WebLogic Server 9.2 release, to upgrade a cluster, you had to either shutdown the entire domain, or install the upgraded server version on a parallel domain on additional hardware and use a load balancer to transfer load from the old domain to the new domain. The rolling upgrade process minimizes downtime and allows you to install a patch, maintenance pack, or minor release while the domain is still running.
Note: Rolling Upgrade cannot be used to upgrade a WebLogic Portal or BEA Workshop for WebLogic Platform domain.
For more information see, WebLogic Server Rolling Upgrade.
Smart Update has been enhanced to support BEA WebLogic Server 9.2, BEA Workshop for WebLogic Platform 9.2, and BEA WebLogic Portal 9.2.
Smart Update is a standalone Java application that you can run independently of BEA software to upgrade your software installations quickly and easily with maintenance patches and service packs. When you install a BEA product for the first time, Smart Update is automatically installed in your BEA Home directory.
Smart Update is enhanced from time to time with new features, and is made available on the BEA download server.
The new version of Smart Update is placed on the BEA download server: if you log in using an earlier version of Smart Update, the latest version is pushed to your machine, and it is installed automatically.
After the installation, you will be prompted to close and start Smart Update again. Click Yes to start Smart Update, and continue with managing your patch maintenance.
When you start Smart Update at a later point, the updated version will be invoked.
For more information, see Installing Maintenance Updates and Service Packs.
In this release, the Configuration Wizard has been enhanced to support the creation of BEA WebLogic Server, BEA Workshop for WebLogic Platform, and BEA WebLogic Portal enabled domains.
For more information, see Creating WebLogic Domains Using the Configuration Wizard.
In this release, the following new domain and extension templates have been added:
wsrp-simple-producer.jar
) — Extends the basic WebLogic Server domain by importing the resources needed to support WebLogic Simple Producer (Portal) functionality. Use this template to enable the development of WebLogic Simple Producer applications in existing domains.wlp_groupspacedb.jar
) — Extends a domain containing WebLogic Server, Portal and Personalization resources to include the database resources required for WebLogic GroupSpace. wlp_groupspace.jar
) — Extends a domain containing WebLogic Portal, Personalization and GroupSpace Framework resources to include pre-configured GroupSpace Application Resources. wls_webservice.jar
) — Extends an existing WebLogic Server domain to add functionality required for advanced Web Services, including WSRM, Buffering, and JMS Transport.workshop_wl.jar
) — Extends the Basic WebLogic Server domain to create a BEA Workshop for WebLogic domain.For more information, see Domain Template Reference.
The following sections describe new and changed functionality in this WebLogic Server® release. For more information about new features, see What’s New in BEA WebLogic Server. For information about known limitations and problems fixed, see BEA WebLogic Server Known and Resolved Issues.
The following features are new to WebLogic security in this release:
In this release, Administration Console extensions that use these third-party JSP tag libraries from the WebLogic Server installation must use predefined, absolute URIs to specify the tag libraries. The Administration Console web.xml
file maps these URIs to tag libraries within the WebLogic Server installation. This mapping facility enables BEA to reorganize its installation directory without requiring you to change your JSPs.
The following features are new to WebLogic JDBC and JTA in this release.
Performance of the WebLogic Diagnostics Framework (WLDF) and the WLDF Console Extension have been enhanced with the addition of new features.
This release of WebLogic Server includes the following improvements in WebLogic Server JMS, Messaging Bridge, and the Store-and-Forward service:
Web Services in this release of WebLogic Server include the following new and changed features:
The following deployment features were added in this release of WebLogic Server.
In this release of WebLogic Server; WebLogic FilteringClassLoader enables users to configure deployment descriptors to explicitly specify packages that are always loaded from the application, rather than being loaded using the system classloader.
The following features related to migration and clustering were added in this release:
In this release of WebLogic Server, Web applications, servlets, and JSPs include the following new and changed features:
In this release of WebLogic Server, WebLogic Tuxedo Connector includes the following new and changed features:
Workshop for WebLogic Platform integrates open sources technologies into a development experience with a focus on easing the creation of complex applications. This release of Workshop for WebLogic Platform has the following enhancements and new features:
For more information about new features, see What’s New in BEA Workshop for WebLogic Platform.
For information about known limitations, see Known Limitations for Workshop for WebLogic Platform.
BEA Workshop for WebLogic Platform™ 9.2 and WebLogic Portal® 9.2 provide new and improved functionality for building enterprise portal applications, including:
For more information about new features, see What’s New in BEA WebLogic Portal 9.2. For information about known limitations and workarounds, see Known Limitations and Workarounds in BEA WebLogic Portal 9.2.
BEA WebLogic Integration 9.2 supports an Eclipse-based development environment, Apache Beehive integration controls, Java 5-compliant annotations, and a new Worklist subsystem. In addition to automated upgrade tools for applications from BEA WebLogic Integration 8.1 SP4, SP5 and SP6, or 8.5 (including SP5 and SP6), BEA WebLogic Integration 9.2 leverages the power of WebLogic Server 9.2, providing improved security, manageability, performance, scalability and availability.
BEA WebLogic Integration 9.2 includes the following new features and enhancements:
For more information about new features, see What’s New in BEA WebLogic Integration 9.2. For information about known limitations and workarounds, see Known Limitations and Workarounds in BEA WebLogic Integration 9.2.
Information about configurations supported by BEA WebLogic Server, BEA WebLogic Portal and BEA Workshop for WebLogic Platform, including hardware and software requirements, is provided from the Supported Configurations page at the following URL:
http://download.oracle.com/docs/cd/E13196_01/platform/suppconfigs/index.html
The documents available from the preceding page also include special installation and usage instructions, which are required for some operating systems.
To use the WebLogic Portal and BEA Workshop for WebLogic Platform software, you must have a valid license file installed on your system. When you install WebLogic Portal 9.2 or BEA Workshop for WebLogic Platform 9.2, the installation program installs a non-expiring development license to enable you to start using the software immediately. The development license is a full license, enabling use of all component features of the product software available from the installer.
To add a license for additional functionality, you need to update the license.bea
file in your BEA Home directory. Please refer to
“
Installing and Updating License Files” in the BEA Products Installation Guide for more information.
In this release, the following BEA JRockit licenses are available:
http://www.mercury.com/us/products/diagnostics
.For more information about the license packages available, see Licensing.
The following instructions are provided for users who have already installed either WebLogic Portal 9.2, BEA Workshop for WebLogic Platform 9.2, or WebLogic Server 9.2 and want to switch from Sun Java 2 to BEA JRockit, or vice-versa:
bin
subdirectory of your domain’s root directory and, by default, is named startWebLogic.cmd
(Windows) or startWebLogic
.sh
(UNIX).
The following set JAVA_VENDOR
and set JAVA_HOME
commands specify the BEA JRockit J2SE 5.0 JDK, where c:\bea
is the BEA home directory:
set JAVA_VENDOR=BEA
set JAVA_HOME=c:\bea\jrockit90_150_04
For Sun, the equivalent commands are as follows:
set JAVA_VENDOR=Sun
set JAVA_HOME=c:\bea\jdk150_04
JAVA_VENDOR
variable is not set in the WebLogic Server start script, then you need to set the default JDK in the setDomainEnv
.cmd
(Windows) or setDomainEnv.sh
(UNIX) script as described in this step. The setDomainEnv
script is also located in the bin
subdirectory of the domain’s root directory.
The following two code snippets show the switching of the default JDK from Sun Java 2 JDK 5.0 to BEA JRockit J2SE 5.0 (R26.0) JDK 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 JDK 5.0 as the default:
if "%JAVA_VENDOR%"=="BEA" (
set JAVA_HOME=C:\bea\jrockit90_150_04
) else (
if "%JAVA_VENDOR%"=="Sun" (
set JAVA_HOME=C:\bea\jdk150_04
) else (
set JAVA_VENDOR=Sun
set JAVA_HOME=C:\bea\jdk150_04
)
)
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\jrockit90_150_04
) else (
if "%JAVA_VENDOR%"=="Sun" (
set JAVA_HOME=C:\bea\jdk150_04
) else (
set JAVA_VENDOR=BEA
set JAVA_HOME=C:\bea\jrocki
t90_150_04
For more information about BEA support for BEA JRockit and the Sun Java 2 JDK, see Supported Configurations for WebLogic Server, WebLogic Portal, and Workshop for WebLogic Platform - Version 9.2.
If you have any questions about this version of WebLogic Server 9.2, WebLogic Portal 9.2 or BEA Workshop for WebLogic Platform 9.2, 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:
This section describes problems that have been identified in the installation and configuration software delivered with WebLogic Server 9.2, WebLogic Portal 9.2 and BEA Workshop for WebLogic Platform 9.2. Whenever possible, workarounds are provided.
For each problem described, a tracking number is specified. These numbers enable BEA and users to monitor the status of issues while solutions are being developed.
Using Ctrl+C to stop a WebLogic Server instance results in a thread dump in the command window from which the server was started. This problem occurs because the RDBMS configured for the domain halts before the WebLogic Server shutdown procedure is completed.
This problem can happen in either the WebLogic Server Examples domain or Avitek Medical Records domain when configured with the default PointBase RDBMS, but potentially can happen in any domain in which the RDBMS is configured to start and stop with WebLogic Server.
Workaround: The recommended way to shut down a WebLogic Server instance is via the WebLogic Server Administration Console. For details, see
“Starting and Stopping Servers” in Managing Server Startup and Shutdown.
|
|
WebLogic Server fails to start and displays the message that the server is not found in the WL_HOME directory
The WebLogic Server wasn't found in directory directory-name . Please edit the setWLSEnv.cmd script so that the WL_HOME variable points to the WebLogic installation directory. Your environment has not been set.
|
|
PointBase is not disabled after a domain is extended using two or more extension templates, and an extension template other than the first is used to change the database from PointBase to a production RDBMS
If you extend a domain using two or more extension templates, and switch the database from PointBase to a production RDBMS when applying the second template or a subsequent one, PointBase is not disabled for the domain.
|
|
Server fails to start when domain name includes a dot and the dot is preceded and followed by strings of a certain length
If you create a domain and assign a name that has all the following characteristics, the domain will not start:
|
|
A single-server domain cannot be configured correctly by deleting all but one server from a clustered domain template
Neither the Configuration Wizard nor WLST offline support the creation of a single-server domain based on a template of a clustered domain from which all but one server are removed. The reason for this restriction is that a clustered domain template contains no initial single-server targeting state, which is needed when you attempt to make this type of customization.
|
|
If you create a template or extension template of a domain that contains application-scoped resources, and then create or extend a clustered domain on the basis of that template or extension, the Configuration Wizard may not properly retarget the application-scoped resources. If the template on which a clustered domain is based contains application-scoped JMS or JDBC resources, the domain may fail to start.
— In place of each JMS queue in the packaged JMS module, create a uniform distributed JMS queue. — Configure a JMS server for each Managed Server in the cluster. — Include the connection factory and the uniform distributed queues in the same sub deployment group, and deploy them to the cluster. When the application is deployed, each Managed Server in the cluster has a connection factory and a member for each distributed queue. For information about configuring JMS for a clustered environment, see “Configuring Clustered WebLogic JMS Resources” in Configuring and Managing WebLogic JMS. |
|
If you choose to install Node Manager as a Windows service, which is an option available via a custom installation, the installation program may hang after you specify a listen port for Node Manager.
This problem may occur if Windows Firewall is running, and the listen port chosen for Node Manager has not been specified as a Windows Firewall exception.
|
|
Servers for both WebLogic examples and Avitek Medical Records sample cannot be started at the same time due to database conflicts
|
|
In rare cases, when using the Smart Update graphical interface, the following exception may be displayed:
|
|
Smart Update’s patch profile maintenance snapshot text file is poorly formatted when viewed in Notepad
|
|
While upgrading from 8.1.x to 9.2, annotations are sometimes not generated for the service control during application upgrade.
Workaround: In Workshop, right-click on the control source file and select the Upgrade Source File(s)... option.
|
|
If you copy and edit
wsrp-wsdl-template.wsdl to your web application, you also need to copy the following files from wlp-wsrp-producer-web-lib.war to you your web-app:
|
|
On the Windows platform, an Unknown Publisher security alert may be encountered when launching a downloaded 9.2 installer, even though BEA's digital signature is present and correctly registered.
|
|
When you create a cluster domain using Configuration Wizard by modifying the admin server name from default AdminServer, and the admin server listen-address to IP address or DNS name, not with localhost, some of the applications may not be deployed on managed servers.
The following errors may be seen while starting managed servers due to inappropriate applications target to cluster from All Local Addresses (the default listen-address) to a specific IP address or DNS name. The errors do not occur if you create the cluster domain using the
WLST Offline script.
If you have created an ALSB Cluster Domain, the following error message is displayed:
####<Jun 21, 2006 2:58:51 PM EDT> <Error> <Deployer> <pint21> <ms1> <[ACTIVE]
ExecuteThread: '0' for queue: 'weblogic.kernel.Default (self-tuning)'> <<WLS Kernel>> <> <> <1150916331219> <BEA-149231> <Unable to set the activation state to true for the application 'XBus Kernel'.java.lang.NullPointerException
|
|
On Solaris, when multiple users run Domain Provisioning tools like the Configuration Wizard, Domain Stop Server Script or WLST Off-Line Scripting, it is possible that subsequent users of the tool might encounter error messages like:
This message appears because WLST creates a temporary directory (for example, on Solaris it is /var/tmp/wlstTemp) that gets shared by all users and it is unable to differentiate between users. As a result, access to the directory gets blocked when the user accessing the directory is not the one who originally created the directory.
|
|
Specifying an incorrect custom profile causes bsu to display warning messages and execute the command against the default profile
When using Smart Update (bsu) in the console mode, if you specify an incorrect custom profile using the
-profile argument with -install, -remove and -view , the tool prints out a warning message and executes the command against the Default profile.
|
|
Smart Update Help displays an ‘Unable to Open’ error message if the URL being accessed contains the shortcut character ‘#’
On Windows 2000, you might encounter an ‘Unable to Open’ error message when Smart Update Help tries to access a page that contains the shortcut character ‘#’.
|
|
Using WLST to run a script that uses loadProperties fails when a property name in the file contains improper characters.
|
|
If you installed WebLogic Integration in command-line mode, and opted to apply patches automatically (by selecting option 1) after successful completion of the installation, the installer automatically applies patches to WebLogic Server, BEA Workshop for WebLogic Platform, and WebLogic Portal. The installer does not check whether WebLogic Portal is installed or not; the patches to WebLogic Portal are applied even when WebLogic Portal is not installed.
|
|
If you apply patches to WebLogic Server, provided after WebLogic Integration 9.2 GA is released, the patch catalog on your installation would be updated. If you later install WebLogic Integration 9.2 from a GA kit, the patch catalog bundled with it would overwrite the existing (newer) patch catalog.
This older patch catalog from the WebLogic Integration installer may not contain patches applied before installing WebLogic Integration 9.2. Because of that, Smart Update may not accurately reflect the Server patches earlier applied to the installation. This could also lead to inconsistent or unpredictable behavior in Smart Update (offline mode) while applying or removing patches.
|
|
The commEnv.cmd and commEnv.sh files refer to patch_weblogic920 instead of patch_weblogic921 in WebLogic Server 9.2 MP1
|
|
Product upgrade from WebLogic Server or Platform 9.2 MP2 to 9.2 MP3 using Smart Update fails for Windows EM64T
|
|
After the installation has been upgraded in steps to successive versions, rollback to previous installation does not work correctly. For example, the installation is upgraded from 9.2MP1 to 9.2MP2, and then to 9.2MP3. The first rollback from 9.2 MP3 to 9.2 MP2 works. However, the uninstaller.sh script does not provide an option for further rollback from 9.2MP2 to 9.2MP1.
|
|
When the Platform installation is upgraded from 9.2.x to any MP (such as 9.2.1 or 9.2.2 ) using the upgrade installer, registry.xml may contain an incorrect entry of install directory for Workshop as 'weblogic92' as shown below:
<component name='Workshop for WebLogic Platform' version='9.2.1.0' InstallDir='D:\bea\WLW92GA\weblogic92'>
Workaround: Correct the registry.xml entry manually before you proceed with your future upgrades as shown below:
<component name='Workshop for WebLogic Platform' version='9.2.1.0' InstallDir='D:\bea\WLW92GA\workshop92'> |
The following table describes problems that have been fixed in the installation and configuration software delivered with WebLogic Server 9.2, WebLogic Portal 9.2 and BEA Workshop for WebLogic Platform 9.2.
![]() ![]() ![]() |