WebLogic Server 8.1 Upgrade Guide

Common Upgrade Issues

Classpath, System Path, and Environment Variables

WebLogic Server 8.1 Dependencies on JDK 1.4.1

Data Sources

Deployment

JRockit

JSP Parsing

Security

Server Configuration

XML Parsing

Upgrading WebLogic Server 7.0 to Version 8.1

Understanding the WebLogic Server 8.1 Directory Structure

Contents of a Domain Directory

Upgrading Your WebLogic Server 7.0 Domain to Version 8.1

Shut Down WebLogic 7.0 Server Instances

Create a WebLogic Server 8.1 Domain Directory

Copy Contents of Your 7.0 Domain into the 8.1 Directory

Delete WebLogic Server 7.0 Settings from the 8.1 Domain

Modify Server Start Scripts

Upgrade Applications

Start 8.1 Administration and Managed Servers

Configure and Deploy Your Applications

Modifying Start Scripts

Upgrading the Pet Store Application from WebLogic Server 7.0 to WebLogic Server 8.1

Additional Upgrade Procedures and Information

Built-in Transformer Based on Apache Xalan XML 2.2 Transformer

Apache Xerces XML Parser

Connectors

Last-Resource Commit Optimization

Application Container Managed Security Log Messages

Classloader and Packaging Issues

Applications with Errors Will Not Deploy

Upgrading jCOM

JDBC

Removed Interfaces

Removed Classes

Removed Drivers

Interoperability Limitation

Statement Caches

Upgrading Your JDK

Stricter JSP Parsing in JDK 1.3.1_09

Reference JDK 1.4 When Compiling in 8.1

JMS Configuration Checking Is Stricter

Upgrading Your JVM to JRockit

Load Order Behavior for Startup Classes

Network Channels Include Network Access Point Features

Changes to Timeouts for Pool, JTS/JTA, and RMI Connections

Prepared Statement Cache Algorithm

Default Names for Execute Queues Have Changed

Security

Troubleshooting Problems with Certificates

Security Data Is Now Written to the config.xml File

Web Resource Is Replaced by URL Resource

Keystores Are Supported

Custom Keystore Providers Are No Longer Supported

The WebLogic Keystore Provider Is Deprecated

Upgrading to WebLogic Server 8.1 Keystores

Upgrading to the WebLogic Server 8.1 Trust Mechanism for Java Clients

URIs

Web Applications

Web Services

EJB 2.0

Run DDConverter Before Using New Features

New Default Values for EJB Deployment Descriptor Elements

Inserting a New CMP Bean at Commit Time

Writable config.xml File

Upgrading WebLogic Server 6.x to Version 8.1

Understanding the WebLogic Server 8.1 Directory Structure

Contents of a Domain Directory

Upgrading Your WebLogic Server 6.x Domain to Version 8.1

Shut Down WebLogic 6.x Server Instances

Create a WebLogic Server 8.1 Domain Directory

Copy Contents of Your 6.x Domain into the 8.1 Directory

Delete WebLogic Server 6.x Settings from the 8.1 Domain

Modify Server Start Scripts

Upgrade Applications

Start 8.1 Administration and Managed Servers

Configure and Deploy Your Applications

Modifying Start Scripts

Upgrading the Pet Store Application from WebLogic Server 6.1 Service Pack 4 to WebLogic Server 8.1

Repair Pet Store

Fix Erroneous <ejb-ref-name>

Add Missing <ejb-ref-name>

Fix Encoding Error

Clean fileRealm.properties

Fix JSP Parsing Errors

Rebuild Petstore

Upgrade the Pet Store Domain

Security Realms in WebLogic Server 8.1 Versus 6.x

Upgrading Your WebLogic Server 6.x Security Realms to 8.1

Upgrading from an LDAP V2 Security Realm

Upgrading from a Windows NT Security Realm

Upgrading from a UNIX Security Realm

Upgrading from an RDBMS Security Realm

Upgrading from a Custom Security Realm

Access Control Lists (ACLs)

ACLs on MBeans

ACLs That Protected WebLogic Resources

Upgrading from Compatibility Security to WebLogic Server 8.1 Security

Guest and <Anonymous> Users

password.ini File

Upgrading SSL

Upgrading SSL Identity and Trust

New Options for Storing SSL Client Trust

Using Host Name Verification

Using a Certificate Authenticator

Upgrading Private Keys and Digital Certificates

Additional Upgrade Procedures and Information

Apache Xalan XML Transformer

Apache Xerces XML Parser

Runtime Modes

Deployment

Manual Changes to Deployment Descriptors for EJB 2.0

weblogic.management.configuration.EJBComponentMBean Changes

max-beans-in-cache Parameter

Fully Qualified Path Expressions

jCOM

JDBC

Upgrading Your JDK

Stricter JSP Parsing in JDK 1.3.1_09

WebLogic Server 8.1 Dependencies on JDK 1.4

JMS

JMX

Jolt Java Client

Upgrading Your JVM to JRockit

JSP

New Behavior of Load Order Methods for Startup Classes

6.1 Managed Servers Cannot Boot from an 8.1 Administrative Server

Default Queue Names Have Changed

MBean API Change

Update Your web.xml file with New Classes

ThreadPoolSize Is Now ThreadCount

404 Message for URIs with Extra Spaces

Web Application API Changes from 6.0

Clusters on Solaris Perform Better with Client JVM

Change WebLogic Tuxedo Connector Configuration

Start the WebLogic Tuxedo Connector

Convert WebLogic Tuxedo Connector XML Configuration Files

Update Inbound RMI-IIOP Applications

Authenticate Remote Users

Set WebLogic Tuxedo Connector Properties

Using the Runtime WTC ORB

Upgrade Web Services

Deprecated APIs and Features

Removed APIs and Features

Upgrading WebLogic Server 5.1 to Version 8.1

Understanding the WebLogic Server 8.1 Directory Structure

Contents of a Domain Directory

Upgrading WebLogic Server 5.1 to Version 8.1: Main Steps

Upgrading WebLogic Server License Files

Converting a WebLogicLicense.class License

Converting a WebLogicLicense.XML License

Converting the weblogic.properties File to config.xml

Classloading in WebLogic Server 8.1

Modifying Startup Scripts

Converting Applications to Web Applications

XML Deployment Descriptors

WAR Files

Session Porting

JavaServer Pages (JSPs) and Servlets

Upgrading a Simple Servlet from WebLogic Server 5.1 to WebLogic Server 8.1

Upgrading Enterprise Java Beans Applications

EJB Upgrade Considerations

Steps for Upgrading a 1.1 EJB from WebLogic Server 5.1 to WebLogic Server 8.1

Steps for Converting an EJB 1.1 to an EJB 2.0

Porting EJBs from Other J2EE Application Servers

Upgrading JMS

Upgrading Oracle

Upgrading the Banking Application from WebLogic Server 5.1 to WebLogic Server 8.1

Set Up the Banking Application on WebLogic Server 5.1

Convert the weblogic.properties File

Configure the Banking Application for WebLogic Server 8.1

Edit the startmigration Script

Copy Banking Application Files to the Output Directory

Deploy and Run the Banking Application

Additional Upgrade and Deployment Considerations

Applications and Managed Servers

Reset Default Mime Type in weblogic.xml

Two-Phase Deployment Is the Default Deployment Model

FileServlet Behavior Has Changed

Changes to Internationalization (I18N) Log Files

8.1 Classes Must Be Built Under JDK 1.4

Support for Java Transaction API (JTA)

Changes to Java Database Connectivity (JDBC)

Upgrading Your JVM to JRockit

Changes to JSPs

Error Handling

Null Requests

JVM

Plug-ins Support SSL Communication

Default Queue Names Have Changed

Tips for Using RMI

Security

Upgrading Security Realms from WebLogic Server 5.1 to 6.1

Upgrading WebLogic Server 6.1 Security to Version 8.1

Standalone HTML and JSPs

URIs with Extra Spaces Result in a 404

Web Components

Define MIME Types for Wireless Application Protocol Applications in web.xml

XML 8.1 Parser and Transformer Are Updated

Deprecated APIs and Features

Removed APIs and Features

Upgrading WebLogic Server 8.1 Service Pack 2 to Version 8.1 Service Pack

New SDKs Bundled with WebLogic Platform 8.1

Mapping weblogic.properties to 6.x config.xml Configuration Attributes