BEAWebLogic. Platform. Release Notes

Transcription

1 BEAWebLogic Platform Release Notes Version 8.1 Service Pack 3 Document Date: June 2004 Revised: July 15, 2004

2

3 Copyright Copyright 2004 BEA Systems, Inc. All Rights Reserved. Restricted Rights Legend This software and documentation is subject to and made available only pursuant to the terms of the BEA Systems License Agreement and may be used or copied only in accordance with the terms of that agreement. It is against the law to copy the software except as specifically allowed in the agreement. This document may not, in whole or in part, be copied, photocopied, reproduced, translated, or reduced to any electronic medium or machine readable form without prior consent, in writing, from BEA Systems, Inc. Use, duplication or disclosure by the U.S. Government is subject to restrictions set forth in the BEA Systems License Agreement and in subparagraph (c)(1) of the Commercial Computer Software-Restricted Rights Clause at FAR ; subparagraph (c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS , subparagraph (d) of the Commercial Computer Software--Licensing clause at NASA FAR supplement ; or their equivalent. Information in this document is subject to change without notice and does not represent a commitment on the part of BEA Systems. THE SOFTWARE AND DOCUMENTATION ARE PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND INCLUDING WITHOUT LIMITATION, ANY WARRANTY OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE. FURTHER, BEA Systems DOES NOT WARRANT, GUARANTEE, OR MAKE ANY REPRESENTATIONS REGARDING THE USE, OR THE RESULTS OF THE USE, OF THE SOFTWARE OR WRITTEN MATERIAL IN TERMS OF CORRECTNESS, ACCURACY, RELIABILITY, OR OTHERWISE. Trademarks or Service Marks BEA, Jolt, Tuxedo, and WebLogic are registered trademarks of BEA Systems, Inc. BEA Builder, BEA Campaign Manager for WebLogic, BEA elink, BEA Liquid Data for WebLogic, BEA Manager, BEA WebLogic Commerce Server, BEA WebLogic Enterprise, BEA WebLogic Enterprise Platform, BEA WebLogic Express, BEA WebLogic Integration, BEA WebLogic Personalization Server, BEA WebLogic Platform, BEA WebLogic Portal, BEA WebLogic Server, BEA WebLogic Workshop and How Business Becomes E-Business are trademarks of BEA Systems, Inc. All other trademarks are the property of their respective companies.

4 iv BEA WebLogic Platform 8.1 Release Notes

5 Contents Change History Terminology About BEA WebLogic Platform What Is New in BEA WebLogic Platform 8.1 Service Pack WebLogic Server Process Edition Scale-Limited Production Licenses WebLogic Server Enhancements WebLogic Workshop Enhancements WebLogic Integration Enhancements WebLogic Portal Enhancements WebLogic JRockit SDK Enhancements Configuration Wizard Enhancements Upgrade Installer Enhancements JDBC Changes in Configuration Templates SDK Support Changes Bit Encryption Provided By Default Updates to Supported Configurations Tutorials and Samples Tutorials and Samples for WebLogic Server Tutorials and Samples for WebLogic Workshop Tutorials and Samples for WebLogic Integration Tutorials and Samples for WebLogic Portal End-to-End WebLogic Platform Tour Configuration Wizard Tutorials Supported Configurations Information BEA WebLogic Platform 8.1 Release Notes v

6 Customer Support Special Installation and Usage Instructions Installing the Java Plug-In for Online Help Search System Configuration Notes and Best Practices SDK Selection Steps to Switch JVMs Supported Configurations Important Database Setup Information Character Limit for the BEA Home Directory Name WebLogic Integration Domains with Administrative and Managed Servers Require a Cluster Referencing Database Schemas Apache Web Server Support Known Limitations Problems Fixed Problems Fixed in Service Pack Problems Fixed in Service Pack vi BEA WebLogic Platform 8.1 Release Notes

7 BEA WebLogic Platform 8.1 Release Notes BEA WebLogic Platform Release: 8.1 Service Pack 3 Date: June 2004 Revised Date: July 15, 2004 This document provides important information about all WebLogic Platform 8.1 releases up to and including Service Pack 3. It includes the following topics:! Terminology! About BEA WebLogic Platform! What Is New in BEA WebLogic Platform 8.1 Service Pack 3! Tutorials and Samples! Supported Configurations Information! Customer Support! Special Installation and Usage Instructions! Installing the Java Plug-In for Online Help Search! System Configuration Notes and Best Practices! Known Limitations BEA WebLogic Platform 8.1 Release Notes 1

8 BEA WebLogic Platform 8.1 Release Notes! Problems Fixed Change History This section describes the changes that have been made to this document since the release of BEA WebLogic Platform 8.1 Service Pack 3 (SP3). Date 07/15/04 Revised the WebLogic Integration information in the What Is New in BEA WebLogic Platform 8.1 Service Pack 3 section. Added CR to the Known Limitations section. 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 2, refer to the following topic for important usage notes. This topic contains notes about enabling 128-bit encryption, downloading the scale-limited license for WebLogic Workshop Free and Professional Editions, 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 WebLogic JRockit see the Release Notes document for the component in question: For this component... WebLogic Server WebLogic Workshop WebLogic Integration Choose the following Release Notes link BEA WebLogic Platform 8.1 Release Notes

9 Terminology For this component... WebLogic Portal WebLogic JRockit Choose the following Release Notes link Terminology 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. About BEA WebLogic Platform 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. What Is New in BEA WebLogic Platform 8.1 Service Pack 3 BEA WebLogic Platform 8.1 Service Pack 3 (SP3) offers updates for all WebLogic Platform 8.1 components (WebLogic Server, WebLogic Workshop, WebLogic Integration, WebLogic Portal, and WebLogic JRockit). BEA WebLogic Platform 8.1 SP3 is the second full service pack for WebLogic Platform 8.1. WebLogic Platform 8.1 SP3 can be used to update all WebLogic Platform 8.1 components. Service Pack 3 includes the following enhancements and changes:! WebLogic Server Process Edition! Scale-Limited Production Licenses! WebLogic Server Enhancements BEA WebLogic Platform 8.1 Release Notes 3

10 BEA WebLogic Platform 8.1 Release Notes! WebLogic Workshop Enhancements! WebLogic Integration Enhancements! WebLogic Portal Enhancements! WebLogic JRockit SDK Enhancements! Configuration Wizard Enhancements! Upgrade Installer Enhancements! JDBC Changes in Configuration Templates! SDK Support Changes! 128-Bit Encryption Provided By Default! Updates to Supported Configurations For a complete list of the new features introduced in WebLogic Platform 8.1 GA and 8.1 SP2, see the What s New page at the following URL: WebLogic Server Process Edition WebLogic Server Process Edition is a new product offering that provides a new, unified solution for developing process-based applications that run in the WebLogic Server environment. You can use WebLogic Server Process Edition to build and execute process-based applications without having to purchase a full WebLogic Integration license. WebLogic Server Process Edition includes the following components:! WebLogic Server Premium Edition Enables full support for WebLogic Server functionality, including the core Java 2 Enterprise Edition (J2EE) features and WebLogic Workshop Web applications, Web services, and controls. WebLogic Server Premium Edition provides premium clustering, caching, and messaging capabilities.! The Business Process Management (BPM) functionality of WebLogic Integration Allows a user to model and execute business processes that span multiple internal systems, external resources, and users, including trading partners. These business processes can orchestrate the execution of business logic and the exchange of business documents among such systems and users in a loosely coupled fashion. 4 BEA WebLogic Platform 8.1 Release Notes

11 What Is New in BEA WebLogic Platform 8.1 Service Pack 3 The following table provides links to topics that provide more details about WebLogic Server Process Edition, including installation and licensing information. For information about... See... WebLogic Server Process Edition documentation Getting started with WebLogic Server Process Edition Installing the WebLogic Server Process Edition software Using the WebLogic Server Process Edition license The configuration template to use to create a domain for WebLogic Server Process Edition applications WebLogic Server Process Edition Overview, at the following URL: ndex.html WebLogic Server Process Edition Support in Preparing to Install WebLogic Platform in Installing BEA WebLogic Platform, at the following URL: /prepare.html#wls_pe Licensing in WebLogic Server Process Edition Support in Preparing to Install WebLogic Platform in Installing BEA WebLogic Platform at the following URL: /prepare.html#wls_pe Template Reference in Creating WebLogic Configurations Using the Configuration Wizard, at the following URL: z/tempref.html Scale-Limited Production Licenses When you install WebLogic Platform 8.1 Service Pack 3 or later, two non-expiring license files are installed on your system: a license for development (license.bea) and a license for scale-limited production use (license_scale_limited.bea). The scale-limited license enables you to run a single WebLogic Server instance with a server capacity limited to approximately 3 percent of the full capacity of a production server. If you wish to deploy applications in scale-limited mode, it is recommended that you develop with the development license file, then install the scale-limited license file prior to scale-limited testing and deployment. BEA WebLogic Platform 8.1 Release Notes 5

12 BEA WebLogic Platform 8.1 Release Notes Scale-limited licenses are used with the following product offerings:! WebLogic Workshop Free Edition Enables the following: Development use of WebLogic Platform using the development license file installed with the WebLogic Platform software. Scale-limited personal and non-commercial use of WebLogic Platform using the scale-limited license file.! WebLogic Workshop Professional Edition Enables development use of WebLogic Platform, as with Free Edition, and adds commercial scale-limited usage rights and support. When you purchase this product, BEA supplies customer-specific developer and scale-limited licenses. For more information about the scale-limited licenses, see About WebLogic Platform Licenses in Installing BEA WebLogic Platform at the following URL: For information about purchasing WebLogic Workshop Professional Edition, visit the following Web site: Note: The way to obtain the scale-limited license has changed from SP2 to SP3. If you are using WebLogic Platform 8.1 SP2, and do not plan to upgrade to SP3 but want to install and use a scale-limited license, see Downloading and Installing the Scale-Limited Licenses in SP2 at the following URL: limited_license WebLogic Server Enhancements The enhancements added to WebLogic Server in SP3 include the following:! New Web Services features, including the following: Implementation of the Final 1.0 OASIS Web Services Security Specification HTTPBindingInfo API for SSL socket sharing to programmatically enable socket sharing from within your SSL Web Services client application New attribute for the wsdl2service Ant task to generate a skeleton implementation class 6 BEA WebLogic Platform 8.1 Release Notes

13 What Is New in BEA WebLogic Platform 8.1 Service Pack 3 New attribute for the servicegen and source2wsdd Ant tasks to ignore the Authorization header in SOAP requests New classes added to WebLogic XML Digital Signature API to digitally sign and validate SOAP messages. New timestamp method added to the weblogic.xml.security.wsse.security API, addtimestamp(), to add a timestamp to the security element of the SOAP request when invoking a secure non-weblogic Web Service.! The following new JDBC features and changes: Deprecation of the WebLogic jdriver for Oracle. Support for the Oracle 10g JDBC thin driver. Updates to the WebLogic Type 4 JDBC drivers. New ability to assign multiple JNDI names to a single Data Source or Tx Data Source. New ability to use the PinnedToThread JDBC connection pool property to increase performance. New JDBC MultiPool failover enhancements. New JDBC connection pool testing enhancements. New XA transactions troubleshooting capabilities. New XA resource transaction timeout value. New SQL statement timeout enhancements for pooled JDBC connections.! Web-based Distributed Authoring and Versioning (WebDAV) support for WebLogic Server proxy plug-in.! New security features.! New WebLogic Tuxedo Connection (WTC) features. For details about the WebLogic Server 8.1 SP3 release, see What's New in WebLogic Server 8.1 SP3 in WebLogic Server 8.1 Features and Changes in the BEA WebLogic Server and WebLogic Express Release Notes at the following URL: WebLogic Workshop Enhancements The enhancements added to WebLogic Workshop in SP3 include the following: BEA WebLogic Platform 8.1 Release Notes 7

14 BEA WebLogic Platform 8.1 Release Notes! Enhanced help viewer The help viewer includes several feature and performance enhancements in SP3, including bookmarking and topic navigation improvements.! Online help content hosted at BEA by default In SP3 the content for the WebLogic Workshop help topics is hosted at BEA. By default, when you display help, content is downloaded over the Internet to your help viewer. If you are working offline, or do not have a connection to the BEA server hosting the help content, you can change the default behavior in the IDE to display local help files.! IBM Rational ClearCase software configuration management (SCM) integration In SP3, IBM Rational ClearCase SCM has been added to Workshop s source control framework and is fully integrated with the Workshop IDE. The set of integrated ClearCase SCM tools includes ClearCase, ClearCase MultiSite, and ClearCase LT versions V2003, V2002, and V4.2.! Dynamic JNDI name look-up capability added to EJB control! XQuery s external-variable bindings available in XMLBeans For details about the WebLogic Workshop 8.1 SP3 release, see Summary of Changes in SP3 in the WebLogic Workshop Release Notes at the following URL: WebLogic Integration Enhancements The enhancements added to WebLogic Integration in SP3 include the following:! Support for complex types and local elements in business processes and in the mapper.! Non-persistent stateful processes, which allow you to use stateful business processes that use computer memory rather than database persistence.! Several new mapper features, including: Usability improvements Improved link rendering and functionality on links in the mapper Support for adding complex conditional expressions to transformations Support for adding if-then-else expressions to transformations 8 BEA WebLogic Platform 8.1 Release Notes

15 What Is New in BEA WebLogic Platform 8.1 Service Pack 3! Performance and architectural changes in the Workshop IDE for building business processes, including: Improved support for Java variables Improved condition builders Improved two-way editing! New HTTP control and event generator. The HTTP control encapsulates prepackaged logic that you can, via Workshop, conveniently incorporate into WebLogic Integration applications. Using this control simplifies the task of creating code that handles and processes HTTP requests and responses. The HTTP event generator publishes HTTP messages to the Message Broker.! New MQSeries control and event generator. The MQSeries control is functionally equivalent to the 8.1 MQ Series Adapter. The MQSeries event generator provides a high performance option of publishing MQSeries messages to the Message Broker.! Performance improvements in WebLogic Integration Tracking and Archiving.! Parent-child process monitoring now supported in the WebLogic Integration Administration Console.! Context-sensitive online help now available for business processes in the IDE and for the mapper. For details about the WebLogic Integration 8.1 SP3 release, see the WebLogic Integration Release Notes at the following URL: WebLogic Portal Enhancements The enhancements added to WebLogic Portal in SP3 include the following:! New Content Management services, such as check-in/check-out, versioning, and approval of content stored in a BEA-compatible content management system.! Management support for multiple authentication providers. WebLogic Portal now supports the use of multiple authentication providers for the management of users, groups, personalization, Delegated Administration, and visitor entitlements directly from the WebLogic Administration Portal.! Web Services for Remote Portals (WSRP) support. BEA WebLogic Platform 8.1 Release Notes 9

16 BEA WebLogic Platform 8.1 Release Notes WSRP is a Web services standard that allows you to plug-and-play visual, user-facing web services with portals or other intermediary web applications. It allows you to create portlets that can either provide content to other portlets or consume content from other sources, even those far removed from your enterprise. WSRP is available from dev2dev as a downloadable add-on for WebLogic Portal 8.1 SP2 installations. In SP3, WSRP is included with the WebLogic Portal software.! New branding capability in the WebLogic Administration Portal.! New Java controls for exposing rules engine capabilities for application developers. Note: If you are upgrading to WebLogic Portal 8.1 SP3 from SP2, you need to run an upgrade script to be able to use some of these new features, such as the new Content Management features and WSRP. This script, which modifies the RDBMS configured with WebLogic Portal, also makes other modifications that are required for SP3. For more information, see Upgrading to Service Pack 3 in the WebLogic Portal 8.1 Upgrade Guide at For details about the WebLogic Portal 8.1 SP3 release, see the WebLogic Portal Release Notes at the following URL: WebLogic JRockit SDK Enhancements The enhancements added to the WebLogic JRockit SDK included in WebLogic Platform 8.1 SP3 include the following:! Improved startup and runtime performance! Reduced heap size! Dynamic garbage collection and heap resizing WebLogic JRockit SDK includes: A unified garbage collector that allows you to select a dynamic garbage collector based solely upon one of two priorities: memory throughput or duration of pause time caused by collection. Automatic heap resizing behavior that is enhanced to allow more dynamic and adaptive heap usage.! Native POSIX Thread Library (NPTL) support on Linux 10 BEA WebLogic Platform 8.1 Release Notes

17 What Is New in BEA WebLogic Platform 8.1 Service Pack 3 NPTL is a thread library option available for use instead of LinuxThreads with Red Hat Enterprise Linux 3.0. NPTL provides significant performance improvement for multi-threading Linux applications. For details about the WebLogic JRockit SDK, see New Features in WebLogic JRockit SDK in Introduction to WebLogic JRockit SDK at the following URL: Configuration Wizard Enhancements In 8.1 SP3, the Configuration Wizard enables you to:! Configure the Administration Server when creating a configuration template using the Configuration Template Builder.! Specify whether a connection pool supports local transactions.! Use silent mode configuration to do the following: Create and edit any valid configuration object and its child elements, except custom security objects. Set AllowCasualUpdate to specify whether you want to allow a domain to be updated without adding an extension template. The silent configuration script samples have been enhanced to include additional documentation. A description of a new WebLogic Portal-based sample has also been added to the documentation. Upgrade Installer Enhancements SP3 adds the ability to use the upgrade installer in silent mode. When you upgrade your installation in silent mode, you define the settings in an XML file that you create prior to beginning the upgrade installation. During the silent upgrade installation process, the installation program reads the settings for your configuration from the XML file. The installation program does not display any configuration options during the installation process. Silent-mode upgrade installation works on both Windows and UNIX systems. For information, see Using the Upgrade Installer in Silent Mode in Installing Service Packs and Rolling Patches in Installing BEA WebLogic Platform at the following URL: BEA WebLogic Platform 8.1 Release Notes 11

18 BEA WebLogic Platform 8.1 Release Notes JDBC Changes in Configuration Templates In 8.1 SP3, changes have been made to the default JDBC configuration settings in several of the prepackaged configuration templates. Many of these changes make creating a domain using a database with an XA driver simpler, as described in How Do I: Create a Domain Using a Database with an XA Driver? in How Do I...? in Creating WebLogic Configurations Using the Configuration Wizard at the following URL: The default JDBC configuration changes include the following:! Two new connection pools: cgjmspool-nonxa provided by WebLogic Workshop and used by WebLogic Workshop, WebLogic Portal, WebLogic Integration and WebLogic Platform domains for a WebLogic JMS persistent file or database store. portalpool provided by WebLogic Portal and used in WebLogic Portal and WebLogic Platform domains for portal framework, services, and content management. The addition of this new pool contributes to the simplification of creating a domain using a database with an XA driver.! Multiple JNDI names assigned to a single data source or Tx Data Source. Note that this change impacts the Data Source and Tx Data Source configuration in the Basic WebLogic Platform Domain template and Basic WebLogic Portal Domain template, as follows: The new p13ndatasource Data Source supports personalization, data synchronization, and sequence identifiers. This functionality was previously supported by the p13n_datasyncdatasource and p13n_sequencerdatasource Data Sources; these Data Sources are no longer defined. The new cgdatasource-nonxa Tx Data Source supports JMS control state management and third-party Compoze portlets.this functionality was previously supported by the cgdatasource and ebusinesspool Data Sources, respectively. The ebusinesspool Data Source is no longer defined. The portalframeworkpool Tx Data Source now supports portal framework, services, and Content Management. The services and Content Management functionality were previously supported by the contentdatasource and commercepool Data Sources; these Data Sources are no longer defined. 12 BEA WebLogic Platform 8.1 Release Notes

19 What Is New in BEA WebLogic Platform 8.1 Service Pack 3! Removal of the WLAI_DataSource Tx Data Source from the Basic WebLogic Platform Domain template. This Tx Data Source is required only for the out-of-the-box WebLogic Integration samples domain, but was also included in the Basic WebLogic Platform Domain template prior to SP3. For complete details about each Configuration Wizard domain template, see Template Reference in Creating WebLogic Configurations Using the Configuration Wizard at the following URL: For description of the default JDBC configuration for SP3, see Default JDBC Configurations for WebLogic Platform at the following URL: SDK Support Changes In SP3, WebLogic Platform 8.1 supports JVMs at the Sun J2SE level only. (JVMs at the level and earlier are no longer supported.) The WebLogic Platform 8.1 SP3 software includes the following Java 2 SDKs:! Sun Java 2 SDK 1.4.2_04! BEA WebLogic JRockit 1.4.2_04 SDK If you are upgrading a domain from SP2 to SP3, 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 directory as appropriate. For example: set JAVA_HOME=C:\bea\jrockit81sp3_142_04 If you are installing SP3 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. Also note that as of SP3, for Windows and Linux operating systems, WebLogic JRockit is the default JVM for development as well as production domains that are created via the Configuration Wizard. For a complete list of Java SDKs for each hardware and operating system combination supported in WebLogic Platform 8.1 SP3, see Summary of Supported Operating System Configurations, BEA WebLogic Platform 8.1 Release Notes 13

20 BEA WebLogic Platform 8.1 Release Notes by Release Number in WebLogic Platform 8.1 Supported Configurations in Supported Configurations for WebLogic Platform 8.1 at the following URL: Bit Encryption Provided By Default Prior to SP3, in order to enable 128-bit encryption, the WebLogic Platform installer program always checked the encryption license in the license.bea file. The 128-bit encryption would then be enabled only if the appropriate encryption license was installed. In SP3, 128-bit encryption is enabled by default for all WebLogic Platform installations. The installer no longer performs this check on the license.bea file. Note: If you are installing SP2 or earlier releases of WebLogic Platform 8.1, the installer program must find the 128-bit encryption license in the license.bea file before the installer enables 128-bit encryption for the WebLogic Platform installation. For more information, see Enabling 128-Bit Encryption in SP2 or Earlier in Important Usage Notes for Previous Releases of WebLogic Platform 8.1 at the following URL: -encryption Updates to Supported Configurations In SP2, using WebLogic Platform with the Sun Java SDK, the Oracle 10g driver, or SQL Server, Sybase, or DB2 database required the installation of a patch. In SP3, support for configurations using these products is now fully provided in the WebLogic Platform 8.1 software. Note: PointBase Server is an all-java DBMS product included in the WebLogic Platform distribution solely for evaluation purposes, either in the form of custom trial applications or through packaged sample applications provided with WebLogic Platform. Non-evaluation development or other use of the PointBase Server requires that a separate PointBase Server license be obtained by the end user directly from DataMirror. PointBase is not supported for production use with WebLogic Workshop, WebLogic Integration, or WebLogic Portal. For more information about contacting DataMirror, see See Supported Configurations for WebLogic Platform 8.1, at the following URL, for complete details about changes introduced in SP3 related to supported operating systems, hardware, databases and database drivers, SDKs, Web servers, and more BEA WebLogic Platform 8.1 Release Notes

21 Tutorials and Samples Tutorials and Samples To get hands-on experience with WebLogic Platform 8.1, we recommend that you try the following tutorials and samples:! Tutorials and Samples for WebLogic Server! Tutorials and Samples for WebLogic Workshop! Tutorials and Samples for WebLogic Integration! Tutorials and Samples for WebLogic Portal! End-to-End WebLogic Platform Tour! Configuration Wizard Tutorials Tutorials and Samples for WebLogic Server WebLogic Server 8.1 provides the following tutorials and examples:! Avitek Medical Records Tutorials: Pet Store 1.3.1_02! Smart Ticket! API Examples Information about running the tutorials and examples is available at: Tutorials and Samples for WebLogic Workshop WebLogic Workshop 8.1 provides the following tutorials:! Getting Started tutorials, a series of short tutorials that offers a basic step-by-step introduction to the following core J2EE components: Web services Web applications Controls BEA WebLogic Platform 8.1 Release Notes 15

22 BEA WebLogic Platform 8.1 Release Notes Enterprise JavaBeans Portal applications! Tutorial: Java Control! Tutorial: Web Service! Tutorial: Page Flow! Tutorial: Enterprise JavaBeans Information about running the tutorials is available at: tml 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:! The Getting Started Samples ialssamples.html! Java Control Samples ntrolsamples.html! Web Application Samples es/navpageflowandjspsamples.html! Web Service Samples WebServices.html! Web Service Client Samples viceclientsamples.html! XMLBeans Samples 16 BEA WebLogic Platform 8.1 Release Notes

23 Tutorials and Samples nsamples.html! XQuery Map Samples MapSamples.html! Enterprise JavaBean Samples tml Tutorials and Samples for WebLogic Integration WebLogic Integration 8.1 provides the following tutorials:! Tutorial: Building Your First Business Process IProcessIntro.html! Tutorial: Building Your First Data Transformation WLIDataTransIntro.html! Tutorial: Building a Worklist Application Tutorials for Trading Partner Integration, which include: Tutorial: Building ebxml Solutions Tutorial: Building RosettaNet Solutions WebLogic Integration Business Connect Tutorial Note: The code for the Trading Partner Integration tutorials is available for download from the dev2dev Web site at the following URL: WebLogic Integration also provides the following samples: BEA WebLogic Platform 8.1 Release Notes 17

24 BEA WebLogic Platform 8.1 Release Notes! Example: ebxml Security Configuration Example: RosettaNet Security Configuration Non-XML Data Mapping Sample Map.html! Using the Suppressible Attribute for a Static Subscription Suppressible.html Tutorials and Samples for WebLogic Portal WebLogic Portal 8.1 provides the following tutorials:! Tutorial: Building Your First Portal ortalintro.html! Tutorial: Changing a Portal s Look & Feel and Navigation PortalLookFeelIntro.html! Tutorial: Showing Personalized Content in a Portlet rtletintro.html! Tutorial: Creating a Login Control Page Flow Using the Wizard trlintro.html! Tutorial: Using Page Flows Inside Portlets owportletintro.html Information about running them is available at: 18 BEA WebLogic Platform 8.1 Release Notes

25 Supported Configurations Information 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: End-to-End WebLogic Platform Tour 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: Configuration Wizard Tutorials WebLogic Platform 8.1 provides the following tutorials:! Tutorial: Creating Your First Domain! Tutorial: Creating a Custom Domain With Managed Servers, a Cluster, and Application Services! Tutorial: Extending an Existing Domain 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: Supported Configurations Information 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: Customer Support 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: BEA WebLogic Platform 8.1 Release Notes 19

26 BEA WebLogic Platform 8.1 Release Notes 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:! Your name, address, phone number, and fax number! Your company name and company address! Your machine type and authorization codes! The name and version of the product you are using! A description of the problem and the content of pertinent error messages Special Installation and Usage Instructions 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: html Installing the Java Plug-In for Online Help Search The online help for the following tools includes a search function that is provided by a Java applet:! WebLogic Workshop IDE (when configured to use help files from the local disk)! Configuration Wizard! Configuration Template Builder 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. 20 BEA WebLogic Platform 8.1 Release Notes

27 System Configuration Notes and Best Practices 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. Table 1 Downloading the Java Plug-in Required for Help Search Applet For the following platform... HP-UX Red Hat Enterprise Linux Sun Solaris 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 from: For PA-RISC-based systems, download and install the latest Runtime Environment for the Java version from: oads/index_pa-risc.html Complete the following steps: 1. Go to the following URL and choose Download J2SE JRE: 2. Accept the licence agreement that is displayed. 3. Choose either the RPM in self-extracting file, or the self-extracting file. Complete the following steps: 1. Go to the following URL and choose Download J2SE JRE: 2. Accept the licence agreement that is displayed. 3. Choose the JRE appropriate for your system. System Configuration Notes and Best Practices This section provides tips, based on best practices, for configuring the environment in which you run WebLogic Platform 8.1:! SDK Selection! Important Database Setup Information BEA WebLogic Platform 8.1 Release Notes 21

28 BEA WebLogic Platform 8.1 Release Notes! Character Limit for the BEA Home Directory Name! WebLogic Integration Domains with Administrative and Managed Servers Require a Cluster 22 BEA WebLogic Platform 8.1 Release Notes

29 System Configuration Notes and Best Practices! Referencing Database Schemas! Apache Web Server Support SDK Selection This release provides the WebLogic JRockit SDK and JVM. WebLogic 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 WebLogic JRockit SDK, do not remove the Sun Java 2 SDK from your machine because it is required by the IDE. Notes: WebLogic 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: Steps to Switch JVMs The following instructions are provided for users who have already installed WebLogic Platform 8.1 SP3 and want to switch to another JVM: 1. Examine the WebLogic Server start script. This script is located in your domain s root directory, and by default is named startweblogic.cmd (Windows) or startweblogic.sh (UNIX). 2. Locate the settings for the following two variables: JAVA_VENDOR JAVA_HOME 3. If these variables are set within the script, change them as appropriate. The following set JAVA_VENDOR and set JAVA_HOME commands specify the WebLogic JRockit SDK, where c:\bea is the BEA home directory: BEA WebLogic Platform 8.1 Release Notes 23

30 BEA WebLogic Platform 8.1 Release Notes set JAVA_VENDOR=BEA set JAVA_HOME=c:\bea\jrockit81sp3_142_04 For Sun, the equivalent commands are as follows: set JAVA_VENDOR=Sun set JAVA_HOME=c:\bea\jdk142_04 4. If the 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 to WebLogic JRockit 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 as the default: if "%JAVA_VENDOR%"=="BEA" ( set JAVA_HOME=C:\bea\jrockit81sp3_142_04 ) else ( if "%JAVA_VENDOR%"=="Sun" ( set JAVA_HOME=C:\bea\jdk142_04 ) else ( set JAVA_VENDOR=Sun set JAVA_HOME=C:\bea\jdk142_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\jrockit81sp3_142_04 ) else ( if "%JAVA_VENDOR%"=="Sun" ( set JAVA_HOME=C:\bea\jdk142_04 ) else ( set JAVA_VENDOR=BEA set JAVA_HOME=C:\bea\jrockit81sp3_142_04 ) ) Supported Configurations For more information about WebLogic Platform 8.1 support for WebLogic JRockit and the Sun Java 2 SDK, see Summary of Supported Operating System Configurations, by Release Number 24 BEA WebLogic Platform 8.1 Release Notes

31 System Configuration Notes and Best Practices in WebLogic Platform 8.1 Supported Configurations in Supported Configurations at the following URL: Important Database Setup Information If your domain includes the MS SQL Server, DB2, Oracle, or Sybase database, refer to Managing WebLogic Platform Database Resources at the following URL for required database setup information: This topic also includes the following sections:! Configuring Your Database Resources! Preparing Your Database for Production! Switching Databases Character Limit for the BEA Home Directory Name 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. WebLogic Integration Domains with Administrative and Managed Servers Require a Cluster A WebLogic Integration domain that includes an administrative 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 administrative server and one or more managed servers without a cluster, but this is an unsupported configuration. Referencing Database Schemas 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. BEA WebLogic Platform 8.1 Release Notes 25

32 BEA WebLogic Platform 8.1 Release Notes Apache Web Server Support Note that WebLogic Platform supports only those users of the Apache multithreaded option who use 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: Known Limitations 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. Table 2 Known Limitations in WebLogic Platform 8.1 Problem ID CR CR 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 weblogic as both your user ID and your password. 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 config.xml file for the domain. 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. 26 BEA WebLogic Platform 8.1 Release Notes