BEA 7 manual

BEA WebLogic

Server™

BEA WebLogic Server 7.0

Upgrade Guide

Release 7.0

Document Date: June 2002

Revised: June 28, 2002

Contents

Main Copyright Restricted Rights Legend Trademarks or Service Marks Part Number Date Software Version Contents About This Document 1. Upgrading WebLogic Server 6.x to Version 7.0 Page 2. Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 Page Page Page About This Document Audience e-docs Web Site How to Print the Document Contact Us! BEA WebLogic Server 7.0 Upgrade Guide xi Documentation Conventions The following documentation conventions are used throughout this document. Convention Usage xii BEA WebLogic Server 7.0 Upgrade Guide Convention Usage C 1 Server 6.x to Version 7.0 Upgrading Your WebLogic Server Configuration: Main Steps Modifying Startup Scripts Modifying Startup Scripts Understanding the WebLogic Server 7.0 Directory Structure Porting an Application from WebLogic Server 6.x to WebLogic Server 7.0 Porting an Application from WebLogic Server 6.x to WebLogic Server 7.0 Upgrading Security Booting WebLogic Server in Compatibility Security ACLs on M Beans Upgrading from Compatibility Security to WebLogic Server 7.0 Security Security Realms Page Guest User password.ini File Upgrading the SSL Protocol Creating a Trusted CA Keystore Using CertAuthenticator in Compatibility Security Cipher Suites Upgrading WebLogic Tuxedo Connector Start the WebLogic Tuxedo Connector Convert WebLogic Tuxedo Connector XML Configuration Files Update Inbound RMI-II OP Applications Page Authenticate Remote Users ACL Policy is LOCAL ACL Policy is Global Set WebLogic Tuxedo Connector Properties Additional Upgrade Procedures and Information ant.jar Apache Xalan XML Transformer Apache Xerces XML Parser Applications Directory Deployment EJB 2.0 weblogic.management.configuration.EJBComponentMBean Changes max-beans-in-cache Parameter Fully Qualified Path Expressions jCOM JDBC JMS JMX Jolt Java Client JSP Load Order for Startup Classes Managed Servers MBean API Change Security Guest and <Anonymous> Users Servlets Thread Pool Size Web Applications WebLogic Server Clusters on Solaris Web Services Writable config.xml File Deprecated APIs and Features Page Page C 2 Server 4.5 and 5.1 to Version 7.0 Upgrading Your WebLogic Server Configuration: Main Steps Upgrading Your WebLogic Server Configuration: Main Steps Upgrading WebLogic Server License Files Converting a WebLogicLicense.class License Converting a WebLogicLicense.XML License Converting the weblogic.properties File to XML Files Converting the weblogic.properties File to XML Files Page Converting the weblogic.properties File to XML Files Classloading in WebLogic Server 7.0 Modifying Startup Scripts WebLogic Server 7.0 J2EE Application Types WebLogic Server 7.0 J2EE Application Types Converting and Porting Your Existing Applications into Web Applications Web Applications Directory Structure XML Deployment Descriptors WAR Fi les Deploying Web Applications Session Porting JavaServer Pages (JSPs) and Servlets Porting a Simple Servlet from WebLogic Server 5.1 to Porting and Converting Enterprise JavaBeans Applications EJB Porting Considerations EJB Porting Recommendations Page Steps for Porting a 1.0 EJB from WebLogic Server 4.5.x to Steps for Porting a 1.1 EJB from WebLogic Server 5.1 to Steps for Converting an EJB 1.1 to an EJB 2.0 Creating an Enterprise Application Porting EJBs from Other J2EE Application Servers Creating an Enterprise Application Understanding J2EE Client Applications Upgrading JMS Upgrading JMS Upgrading Oracle Additional Porting and Deployment Considerations Applications and Managed Servers Deployment Plug-ins FileServlet Internationalization (I18N) Java Transaction API (JTA) Java Database Connectivity (JDBC) JSP Error Handling Null Attributes JVM RMI Security Upgrading to the New Security Architecture Digital Certificates Generated by the Certificate Servlet Private Keys and Digital Certificates Session Porting Standalone HTML and JSPs Web Components Wireless Application Protocol Applications Writable config.xml File XML 7.0 Parser and Transformer Deprecated APIs and Features Removed APIs and Features Page A A weblogic.properties Mapping Table A-2 BEA WebLogic Server 7.0 Upgrade Guide weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-3 weblogic.properties file Property .xml Configuration A-4 BEA WebLogic Server 7.0 Upgrade Guide weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-5 weblogic.properties file Property .xml Configuration A-6 BEA WebLogic Server 7.0 Upgrade Guide weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-7 Servers: servername: Configuration: HTTP: Post Timeout Secs weblogic.properties file Property .xml Configuration A-8 BEA WebLogic Server 7.0 Upgrade Guide weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-9 weblogic.properties file Property .xml Configuration A-10 BEA WebLogic Server 7.0 Upgrade Guide (Server element) (JMSDestination element) (Server element) (JMSJDBCStore element) BEA WebLogic Server 7.0 Upgrade Guide A-11 weblogic.properties file Property .xml Configuration A-12 BEA WebLogic Server 7.0 Upgrade Guide weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-13 weblogic.properties file Property .xml Configuration A-14 BEA WebLogic Server 7.0 Upgrade Guide (Security element) (NTRealm element) weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-15 weblogic.properties file Property .xml Configuration A-16 BEA WebLogic Server 7.0 Upgrade Guide (SSL element) Servers: servername: Configuration: SSL: Cert Authenticator weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-17 weblogic.properties file Property .xml Configuration A-18 BEA WebLogic Server 7.0 Upgrade Guide weblogic.properties file Property .xml Configuration BEA WebLogic Server 7.0 Upgrade Guide A-19 weblogic.properties file Property .xml Configuration A-20 BEA WebLogic Server 7.0 Upgrade Guide weblogic.properties file Property .xml Configuration A B Store Application and the Examples Server Terms Used in This Document Upgrading the Pet Store Application From WebLogic 6.1 Service Pack 3 to WebLogic Server 7.0 Set Up the WebLogic Server 7.0 Environment with Your 6.1 Service Pack 3 Domain Configuration Fix JSP Parsing Errors Page Rebuild Pet Store BEA WebLogic Server 7.0 Upgrade Guide B-7 startPetstore.cmd script used to boot WebLogic Server 6.1 Service Pack 3 B-8 BEA WebLogic Server 7.0 Upgrade Guide BEA WebLogic Server 7.0 Upgrade Guide B-9 above-listed startPetstore.cmd script modified to boot WebLogic Server 7.0 B-10 BEA WebLogic Server 7.0 Upgrade Guide BEA WebLogic Server 7.0 Upgrade Guide B-11 B-12 BEA WebLogic Server 7.0 Upgrade Guide config.xml file used for WebLogic Server 6.1 Service Pack 3 BEA WebLogic Server 7.0 Upgrade Guide B-13 B-14 BEA WebLogic Server 7.0 Upgrade Guide BEA WebLogic Server 7.0 Upgrade Guide B-15 above-listed config.xml file used for WebLogic Server 7.0 1. Change the path to point to your 7.0 petstore.ear file. B-16 BEA WebLogic Server 7.0 Upgrade Guide BEA WebLogic Server 7.0 Upgrade Guide B-17 2. Change the path to point to your petstoreAdmin.ear file. 3. Change the path so that it points to the location of your WebLogic Server 7.0 Java compiler. B-18 BEA WebLogic Server 7.0 Upgrade Guide Start the Pet Store Application on WebLogic Server 7.0 Upgrading the WebLogic 6.0 Service Pack 2 Examples Server to WebLogic Server 7.0 Set Up the WebLogic Server 7.0 Environment with Your 6.0 Service Pack 2 Domain Configuration setExamplesEnv.cmd script used to boot a WebLogic 6.0 Service Pack 2 B-22 BEA WebLogic Server 7.0 Upgrade Guide BEA WebLogic Server 7.0 Upgrade Guide B-23 above-listed setExamplesEnv.cmd script modified to boot a WebLogic 7.0 Page BEA WebLogic Server 7.0 Upgrade Guide B-25 startExamplesServer.cmd script used to boot a WebLogic 6.0 Service Pack 2 B-26 BEA WebLogic Server 7.0 Upgrade Guide above-listed startExamplesServer.cmd script modified to boot a WebLogic 7.0 BEA WebLogic Server 7.0 Upgrade Guide B-27 1. Set your JAVA_HOME to your new JDK in WebLogic 7.0. 2. Set WL60_HOME in order to be able to access your WebLogic Server 6.0 classes. 3. Set this in order to be able to access your WebLogic Server 7.0 classes. 4. Set the PATH to look in your %WL_HOME% 7.0 home. If this is not set, the server won't boot. Start the Examples Server on WebLogic Server 7.0 Upgrading the WebLogic 6.1 Service Pack 2 Examples Server to WebLogic Server 7.0 Set Up the WebLogic Server 7.0 Environment with Your 6.1 Service Pack 2 Domain Configuration setExamplesEnv.cmd script used to boot a WebLogic 6.1 Service Pack 2 B-32 BEA WebLogic Server 7.0 Upgrade Guide BEA WebLogic Server 7.0 Upgrade Guide B-33 above-listed setExamplesEnv.cmd script modified to boot WebLogic Server 7.0 1. Set the WL61_HOME variable so that you can access your WebLogic Server 6.1 classes. startExamplesServer.cmd script used to boot a WebLogic 6.1 Service Pack 2 BEA WebLogic Server 7.0 Upgrade Guide B-35 B-36 BEA WebLogic Server 7.0 Upgrade Guide BEA WebLogic Server 7.0 Upgrade Guide B-37 above-listed startExamplesServer.cmd script modified to boot WebLogic Server 7.0 1. Set your JAVA_HOME to your new JDK in WebLogic 7.0. 2. Set this in order to be able to access your WebLogic Server 6.1 classes. 3. Set this in order to be able to access your WebLogic Server 7.0 classes. B-38 BEA WebLogic Server 7.0 Upgrade Guide 4. Set the PATH to look in your %WL_HOME% 7.0 home. If this is not set, the server won't boot. 5. Set the CLASSPATH to point to old classes and to new classes that you need. Start the Examples Server on WebLogic Server 7.0