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.1 and BEA WebLogic Server 9.1. 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.1 and WebLogic Server 9.1 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:
|
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.1 and WebLogic Server 9.1:
The new XACML providers are fully compatible with policies and roles created using the WebLogic Authorization provider (DefaultAuthorizer) and WebLogic Role Mapping provider (DefaultRoleMapper). Existing WebLogic domains that you upgrade to 9.1 will continue to use the authorization and role mapping providers currently specified, such as third-party partner providers or the original WebLogic Authorization and Role Mapping providers. If you wish, you can migrate existing domains from using WebLogic Server proprietary providers to the XACML providers, including performing bulk imports of existing policies. For more information, see Security for BEA WebLogic Server 9.1.
createDomain command has been added enabling you to create a domain quickly and easily using the specified domain template.nmGenBootStartupProps command has been added enabling you to generate the Node Manager property files, boot.properties and startup.properties, for the specified server. For more information, see WebLogic Scripting Tool.
For more information, see Roadmap for Upgrading Application Environments.
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.
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.1 or WebLogic Server 9.1, 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 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_04
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 (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=BEAset JAVA_HOME=C:\bea\jrockit90_150_04
For more information about BEA support for BEA JRockit and the Sun Java 2 JDK, see the following documents:
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.1 and WebLogic Server 9.1. 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:
|
|
|
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:
|
|
|
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. |
|
|
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. |
|
|
Servers for both WebLogic examples and Avitek Medical Records sample cannot be started at the same time due to database conflicts You cannot start or run the servers in the domains for the WebLogic examples and Avitek Medical Records (MedRec) sample at the same time because both servers reference the same database files. Workaround: Do not attempt to run both sample servers simultaneously. Stop one server before starting the other one. |
|
|
GUI cannot refresh patches installed from command line without restart If you use the Smart Update graphical and command-line interfaces simultaneously, patches that you apply via the command-line interface are not visible from the GUI when you refresh the view. Workaround: Exit and restart the Smart Update GUI to view the new patch. |
|
|
Mercury profiling tools are not installed if not initially selected During product installation, if you deselect the Mercury profiling tools on the Optional Tools screen, select Next, and then subsequently return to the Optional Tools screen using the Previous button and select to install the Mercury profiling tools, the tools will not be installed. Workaround: If you wish to install the Mercury profiling tools, make sure that you select the Mercury profiling tools on the Optional Tools screen when you are prompted inititally. |
|
|
Smart Update graphical interface displays java.util.ConcurrentModificationException in rare cases 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 The patch profile maintenance snapshot file produced by Smart Update cannot be easily viewed in common text editors, such as Notepad. The snapshot file does not contain conventional line breaks, which results in poorly formatted columns that cannot be easily read. Workaround: Use a text editor such as WordPad or TextPad to view this file. You do not need to reformat this file when sending it to BEA Customer Support. |
|
|
Invalidated patches should not list other invalidated patches as their replacement When you display details about an invalidated patch, the ID of the replacement patch may be provided. But if the replacement patch is subsequently invalidated by BEA Customer Support, this ID will not be updated and will refer to an invalidated patch. |
|
|
Exception is generated when reapplying the last of multiple patches After having applied multiple patches that contain patch JAR files with the same name, if you remove and then attempt to reapply any of those patches, you may see an exception similar to the following:
Workaround: Exit and restart Smart Update, and reapply the patch that previously caused the exception. |
|
|
Cannot create a domain using a template that was created from the out-of-the box AquaLogic Service Bus Examples domain If you create a domain using a template that was generated from the out-of-the box AquaLogic Service Bus Examples domain, the server may not start. Workaround: There is no workaround. Creating a domain using a template that was generated from the out-of-the box AquaLogic Service Bus Examples domain is not supported. |
Table 2 describes problems that have been fixed in the installation and configuration software delivered with AquaLogic Service Bus 2.1 and WebLogic Server 9.1.
|
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. Fix Information: The default port numbers for the Service Bus samples have been updated as follows so that they no longer conflict with the default ports for the WebLogic examples: |
|
|
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. Fix Information: When the Configuration Wizard is run on a UNIX or Linux machine, the tool will not allow you to include spaces in the name of the domain root directory. |
|
|
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. Fix Information: On a UNIX or Linux machine, the Configuration Wizard does not allow you to include space characters in the name of the domain root directory. |
|
|
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:
Fix Information: The Help button displays the correct help information. |
|
|
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: |
|
|
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 Fix Information: The host name and listen port changes are now saved to the domain template. |
|
|
|