Installation and Configuration Release Notes
|
 |
 |
|
 |
 |
This document provides information about new capabilities, usage notes, and known limitations related to the installation and configuration of BEA AquaLogic Service Bus 2.0 and BEA WebLogic Server 9.0. 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:
http://www.oracle.com/technology/documentation/index.html
For detailed information about the BEA products encompassed by the AquaLogic Service Bus 2.0 and WebLogic Server 9.0 releases (including BEA JRockit J2SE 5.0 JDK, which is included in the installation of these products), see the corresponding Release Notes document as follows:
|
For information about new features, see BEA WebLogic Server and WebLogic Express Release Notes. For information about known limitations and problems fixed, see BEA WebLogic Server Known and Resolved Issues. |
|
The following list summarizes new features and changes in the installation and configuration tools used with AquaLogic Service Bus 2.0 and WebLogic Server 9.0:
Sample scripts are also available in WL_HOME\common\templates\scripts\wlst that show the following:
For more information about WLST, see WebLogic Scripting Tool.
In addition, silent-mode operation of the Configuration Wizard is deprecated. BEA recommends that you use the BEA WebLogic Scripting Tool in its place.
For more information, including new examples, see Creating WebLogic Domains Using the Configuration Wizard.
For more information, see Creating Templates Using the Domain Template Builder.
pack and unpack, for rapidly creating domain templates and domains, respectively, from the command line. pack command creates a template archive (.jar) file that contains a snapshot of either an entire domain, or the part of a domain needed to create a Managed Server domain directory.unpack command creates a domain directory or Managed Server domain directory using a template created with the pack command.For more information, see Creating Templates and Domains Using the pack and unpack Commands.
For more information, see the ISV Partners' Guide.
Information about configurations supported by AquaLogic Service Bus and WebLogic Server, 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.
The WebLogic Upgrade Wizard, new in WebLogic Server 9.0, guides you through the steps required to upgrade a WebLogic domain that is compatible with WebLogic Server 6.1, 7.0, or 8.1 so that it runs in a WebLogic Server 9.0 application environment. As part of the upgrade process, you may also have to upgrade any security providers and Node Managers used in the domain.
You can step through the upgrade process interactively, by using the graphical user interface (GUI), or "silently," by creating a script and executing the upgrade steps as a background process.
For information about using the WebLogic Upgrade Wizard, see Upgrading WebLogic Application Environments.
The preceding document includes the following important topics related to upgrading to WebLogic Server 9.0:
To use the AquaLogic Service Bus and WebLogic Server software, you must have a valid license file installed on your system. When you install AquaLogic Service Bus 2.0 or WebLogic Server 9.0, 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.
The following licensing changes are in effect for AquaLogic Service Bus 2.0 and WebLogic Server 9.0:
For more information about the license packages available, see Licensing.
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.
This section includes the following best practices and usage notes:
The following instructions are provided for users who have already installed either AquaLogic Service Bus or WebLogic Server 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_03
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 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 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_03
) else (
if "%JAVA_VENDOR%"=="Sun" (
set JAVA_HOME=C:\bea\jdk150_03
) else (
set JAVA_VENDOR=Sun
set JAVA_HOME=C:\bea\jdk150_03
)
)
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_03
) else (
if "%JAVA_VENDOR%"=="Sun" (
set JAVA_HOME=C:\bea\jdk150_03
) else (
set JAVA_VENDOR=BEAset JAVA_HOME=C:\bea\jrockit90_150_03
For more information about BEA support for BEA JRockit and the Sun Java 2 JDK, see the following documents:
The BEA JRockit JDK contains a private JRE that resides in the JRockit JDK directory. The private JRE, which includes the JRockit JVM, class libraries, and other files that support the execution of programs written in Java, is required to be able to use the JDK, including running the tools included in the JDK. The bundled version is used by AquaLogic Service Bus and WebLogic Server to run the servers and tools. You also have the option to install the public JRockit JRE. The public JRE can be used by other applications.
For information about the JRockit JRE installation option, see Java Runtime Environment (JRE) in "Preparing for Your Installation" in the BEA Products Installation Guide.
The documentation for the following is displayed in a browser-based viewer that includes a search function 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 this documentation, you must install the plug-in.
If you are working on a Microsoft Windows platform, the first time you initiate a search in the viewer for this documentation, you are prompted to download and install the plug-in.
However, if you are working on an 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.
|
Go to the following Web site to obtain the Java plug-in . . . |
|
|---|---|
|
For Itanium-based systems, download and install the latest Runtime Plug-in version 1.4.2 from:
For PA-RISC-based systems, download and install the latest Runtime Environment for Java version 1.4.2 from:
|
|
|
1. Go to the following URL and choose Download J2SE JRE: |
|
|
1. Go to the following URL and choose Download J2SE JRE: |
If you have any questions about this version of AquaLogic Service Bus or WebLogic Server, or if you have problems installing and running the product, contact BEA Customer Support through BEA eSupport at:
http://support.bea.com
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 AquaLogic Service Bus 2.0 and WebLogic Server 9.0. 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.
|
Thread dump occurs when Ctrl+C is used to stop server 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 A message similar to the following is displayed when you try to start WebLogic Server:
This problem is caused by a Windows bug that limits the length of the directory name you can use for the BEA Home directory. Workaround: Do not choose a BEA Home directory name that contains more than 12 characters. |
|
|
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. Workaround: Two workarounds can be used to avoid this problem, as follows:
|
|
|
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: For example, a domain created with the name Workaround: When choosing a domain name, do one of the following: |
|
|
Limited support in Template Builder for compatibility-mode security When using the Domain Template Builder to create a template from a domain that contains a Compatibility security configuration, you cannot create or assign additional users, groups, and global roles. Workaround: After you create a domain based on a template that contains a Compatibility security configuration, boot the domain and add users, groups, and roles via the WebLogic Server Administration Console. |
|
|
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. Workaround: If you are creating a single-server domain, choose a template that is not created from, or based on, a domain that is clustered. |
|
|
Exception java.lang.UnsupportedOperationException thrown from domain configured using WLST offline When operating in offline mode, WLST does not support the creation of security roles. If a WLST offline script includes statements that define security roles, WLST terminates abnormally when executing the script, throwing the Workaround: Use WLST in online mode to specify security roles. |
|
|
QuickStart is not displayed correctly after installation When installing AquaLogic Service Bus or WebLogic Server, if you specify a directory for either the BEA Home directory or WebLogic Server Home directory that contains a multibyte character set in the directory name, QuickStart is not displayed correctly after the installation is complete. Operating System: Any system in which the Sun Java 2 J2SE 5.0 is used. Workaround: During installation, choose directories for BEA Home and WebLogic Server Home with names that include only the ASCII character set. |
|
|
Configuration of application-scoped resources cannot be changed in domain template 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. Workaround: Note the following best practices for creating domains and templates:
|
|
|
Servers for both WebLogic examples and Service Bus samples cannot be started at the same time You cannot start or run the servers in the domains for WebLogic examples and Service Bus samples at the same time. This problem is caused by the fact that both servers are configured to use the same default port number. Workaround: Do not attempt to run both sample servers simultaneously. Stop one server before starting the other one. |
|
|
Service Bus domain templates cannot be created because of database dependency If you create a template of a Service Bus domain, and then create a new Service Bus domain based on that template, the new domain cannot be started. This problem is caused by a dependency that is created between the domain RDBMS and the domain name, which results in a restriction upon the usage of templates that you create from Service Bus domains. This problem occurs because the new domain attempts to use the same database, schema, and Logging Last Resources (LLR) table name (for storing LLR transaction records) that are used by the initial domain. LLR checks for this to prevent one domain from corrupting the LLR tables of another domain. Workaround: Two workarounds are available for this problem:
|
|
|
Server does not start if name of domain root directory contains a space If you use the Configuration Wizard to create a domain, and specify a name for the domain root directory that contains a space, the domain server cannot be started. When you attempt to boot the domain, a message similar to the following is generated:
Operating System: UNIX and Linux Workaround: When specifying the name of the domain's root directory, do not use spaces. |
|
|
Newly configured PKI credential mapper is available via the run-time tree without reboot When security providers are added to or removed from the list of security providers in the run-time MBean tree, a reboot should be required before the revised list is displayed. Currently, however, WebLogic Server displays the changed set of security providers in the run-time MBean tree immediately, and the listed security providers are immediately available for management operations. Even though the providers become available for management operations immediately, the server continues to use the set of providers that was present at boot time for security run-time operations (such as authentication, authorization, auditing, and so on). Workaround: A reboot of the server is required for these changes to the security framework to affect the run-time security operations. This requirement applies to all security providers. |
|
|
Help button in Configuration Wizard opens Template Builder Help When using the Configuration Wizard to extend a domain, clicking Help in the Review WebLogic Domain window invokes the Template Builder online help. Workaround: Two workarounds are available to display help for the Review WebLogic Domain window while extending a domain:
|
|
|
In a base WebLogic domain that has been extended with the WebLogic Server Default Domain and WebLogic Server Examples extension templates, the server cannot be started After you extend a base WebLogic domain with the WebLogic Server Default Domain and WebLogic Server Examples extension templates, the resulting domain will not boot. This problem occurs if, after creating a domain in the Configuration Wizard, you navigate backward in the Configuration Wizard to the initial window and extend the newly created domain without having first exited from that tool. Workaround: After you use the Configuration Wizard to create a domain, restart the Configuration Wizard before extending that domain. |
|
|
Oracle 10g database does not allow insertion of a character string larger than 1000 bytes using the latest 10g driver You cannot insert a variable-length character string that is larger than 1000 bytes into an Oracle 10g database (Oracle 10.1.0.2) using the latest Oracle 10g driver. This limitation extends to Workaround: You can use either of the following two workarounds: |
|
|
Installer hangs on Windows XP during Node Manager configuration 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. Operating System: Windows XP Professional with Service Pack 2 Workaround: Before you run the installation program, do either of the following: If you choose to turn off Windows Firewall prior to installation, you can turn it back on after the installation procedure is complete. |
|
|
Managed Server template should not include applications A Managed Server template created using the Workaround: After you create a domain based on a Managed Server template, you can safely remove directories that contain user-created applications. This will not prevent you from being able to start the domain. If the user-created applications in the Managed Server template do not use a great deal of disk space, this problem is not an issue for creating or starting the domain. Note that AquaLogic Service Bus domains contain a large number of system-level applications and files that must not be removed. |
|
|
Missing updates to WLST online help The online help for the WebLogic Server Scripting Tool does not include the following updates: 2. The note that appears with the
Workaround: The topic WLST Command and Variable Reference in WebLogic Scripting Tool contains the preceding updates. |
|
|
Administration Server name and listen port changes specified in Template Builder do not take effect for Service Bus domains When using the Domain Template Builder to create a template of a Service Bus domain, if you change the host name and listen port of the Administration Server, those changes do not take effect in the resulting template. The resulting template retains the host name and listen port of the Administration Server for the Service Bus domain from which the template was created. Workaround: After you create a domain based on this template, edit the domain |
|
|
|