Page 3 - Contents; About This Document
BEA WebLogic Server 7.0 Upgrade Guide iii Contents About This Document Audience .............................................................................................................. ixe-docs Web Site ..............................................................................................
Page 6 - B. Upgrading the Pet Store Application and the Examples Server
vi BEA WebLogic Server 7.0 Upgrade Guide FileServlet................................................................................................. 2-28Internationalization (I18N) ....................................................................... 2-28Java Transaction API (JTA) ..................
Page 9 - Audience
BEA WebLogic Server 7.0 Upgrade Guide ix About This Document This document provides procedures and other information you need to upgrade earlier versions of BEA WebLogic Server to WebLogic 7.0. It also provides information about moving applications from an earlier version of WegLogic Server to 7.0. ...
Page 10 - How to Print the Document
x BEA WebLogic Server 7.0 Upgrade Guide How to Print the Document You can print a copy of this document from a Web browser, one main topic at a time, by using the File → Print option on your Web browser. A PDF version of this document is available on the WebLogic Server documentation Home page on th...
Page 11 - Documentation Conventions
BEA WebLogic Server 7.0 Upgrade Guide xi A description of the problem and the content of pertinent error messages Documentation Conventions The following documentation conventions are used throughout this document. Convention Usage Ctrl+Tab Keys you press simultaneously. italics Emphasis and book ...
Page 14 - Upgrading WebLogic Server 6.x to Version 7.0
1 Upgrading WebLogic Server 6.x to Version 7.0 1-2 BEA WebLogic Server 7.0 Upgrade Guide For information on upgrading to WebLogic Platform 7.0 (7.0.0.1), see the Upgrading section of the WebLogic Server FAQs. Note: Throughout this document “upgrade” refers to upgrading to a later version of WebLogic...
Page 15 - Modifying Startup Scripts
Modifying Startup Scripts BEA WebLogic Server 7.0 Upgrade Guide 1-3 To upgrade a cluster of servers, follow the above steps for each server and then follow the steps outlined in Setting Up WebLogic Clusters in Using WebLogic Server Clusters . In cases where you invoke an application by using RMI/T3 ...
Page 18 - Upgrading Security
1 Upgrading WebLogic Server 6.x to Version 7.0 1-6 BEA WebLogic Server 7.0 Upgrade Guide 4. When you deploy applications to WebLogic Server 7.0, use the Administration Console or weblogic.Deployer utility to deploy using the new two-phase deployment protocol. The older, WebLogic Server 6.x deploymen...
Page 19 - Booting WebLogic Server in Compatibility Security; ACLs on MBeans
Upgrading Security BEA WebLogic Server 7.0 Upgrade Guide 1-7 Note: The WebLogic Server 7.0 examples and PetStore are configured to use the default security configuration. It is not possible to run the WebLogic Server 7.0 examples and PetStore in Compatibility security. Booting WebLogic Server in Com...
Page 21 - Security Realms
Upgrading Security BEA WebLogic Server 7.0 Upgrade Guide 1-9 f. Click the Membership tab to add the user who can boot WebLogic Server to the Administrators group. g. Click the Apply button to save your changes. 5. Add the users and groups that you had configured in the 6.x security realm to an Authe...
Page 23 - Guest User
Upgrading Security BEA WebLogic Server 7.0 Upgrade Guide 1-11 9. Reboot WebLogic Server. 10. Expand the Domains-->Security nodes. 11. Select the General tab. 12. Set the security realm in which you configured the Realm Adapter Authentication provider as the default security realm. 13. Click Apply...
Page 24 - Upgrading the SSL Protocol; Creating a Trusted CA Keystore
1 Upgrading WebLogic Server 6.x to Version 7.0 1-12 BEA WebLogic Server 7.0 Upgrade Guide Creating a Boot Identity File in the Administration Guide . There is no direct upgrade of the old password.ini file because it contained a clear text password and no username. Upgrading the SSL Protocol This se...
Page 25 - Using CertAuthenticator in Compatibility Security
Upgrading Security BEA WebLogic Server 7.0 Upgrade Guide 1-13 keytool -import -trustcacerts -alias <some alias name> - file < the file that contains the trusted CA> - keystore < the trusted CA keystore> - storepass <your trusted CA Keystore password> The trusted certificate a...
Page 26 - Cipher Suites
1 Upgrading WebLogic Server 6.x to Version 7.0 1-14 BEA WebLogic Server 7.0 Upgrade Guide Using a CertAuthenticator that needs to be changed may result in access being denied in WebLogic Server 7.0, but allowed in WebLogic Server 6.x. To change the CertAuthenticator, have it return NULL for unrecogn...
Page 27 - Upgrading WebLogic Tuxedo Connector; Start the WebLogic Tuxedo Connector
Upgrading WebLogic Tuxedo Connector BEA WebLogic Server 7.0 Upgrade Guide 1-15 Upgrading WebLogic Tuxedo Connector You must make the following application and configuration changes to use WebLogic Tuxedo Connector in WebLogic Server 7.0: “Start the WebLogic Tuxedo Connector” on page 1-15 “Conver...
Page 29 - Update Inbound RMI-IIOP Applications
Upgrading WebLogic Tuxedo Connector BEA WebLogic Server 7.0 Upgrade Guide 1-17 When the migration is complete, the migration utility displays: The WTC configuration file migration is done! No error found!!! The information from the specified XML configuration file is migrated to a WTCServer Mbean an...
Page 31 - Authenticate Remote Users; ACL Policy is LOCAL
Upgrading WebLogic Tuxedo Connector BEA WebLogic Server 7.0 Upgrade Guide 1-19 4. Load your modified domain configuration file using dmloadcf . You are now ready to start your applications. Authenticate Remote Users For more information, see User Authentication at http://e-docs.bea.com/wls/docs70/wt...
Page 32 - ACL Policy is Global; Set WebLogic Tuxedo Connector Properties
1 Upgrading WebLogic Server 6.x to Version 7.0 1-20 BEA WebLogic Server 7.0 Upgrade Guide ACL Policy is Global If the WebLogic Tuxedo Connector ACL Policy is GLOBAL , the user's security token is passed. No administration changes are required. Set WebLogic Tuxedo Connector Properties Note: For more ...
Page 33 - Additional Upgrade Procedures and Information
Additional Upgrade Procedures and Information BEA WebLogic Server 7.0 Upgrade Guide 1-21 Additional Upgrade Procedures and Information The following sections provide additional information that may be useful about deprecated features, upgrades, and the important changes that have been made in WebLog...
Page 34 - Apache Xalan XML Transformer
1 Upgrading WebLogic Server 6.x to Version 7.0 1-22 BEA WebLogic Server 7.0 Upgrade Guide “Web Applications” on page 1-32 “WebLogic Server Clusters on Solaris” on page 1-33 “Web Services” on page 1-33 “Writable config.xml File” on page 1-33 “Deprecated APIs and Features” on page 1-34 “Re...
Page 35 - Apache Xerces XML Parser; Applications Directory
Additional Upgrade Procedures and Information BEA WebLogic Server 7.0 Upgrade Guide 1-23 Apache Xerces XML Parser The built-in XML parser for WebLogic Server 7.0 is based on the Apache Xerces 1.4.4 parser. The parser implements version 2 of the SAX and DOM interfaces. Users who used older parsers th...
Page 36 - Deployment
1 Upgrading WebLogic Server 6.x to Version 7.0 1-24 BEA WebLogic Server 7.0 Upgrade Guide Deployment WebLogic Server 7.0 provides a new two-phase deployment model. For more information on this deployment model and other 7.0 deployment features, see WebLogic Server Deployment . By default, statically...
Page 39 - Fully Qualified Path Expressions; jCOM; JDBC
Additional Upgrade Procedures and Information BEA WebLogic Server 7.0 Upgrade Guide 1-27 Fully Qualified Path Expressions In an EJB QL Query on WebLogic Server 7.0, all path-expressions must be fully qualified. This is a change from WebLogic Server 6.x. If you see an ejbc error while running ejbc on...
Page 40 - JMS; JMX; Jolt Java Client
1 Upgrading WebLogic Server 6.x to Version 7.0 1-28 BEA WebLogic Server 7.0 Upgrade Guide JMS WebLogic Server 7.0 supports the JavaSoft JMS specification version 1.0.2 . All WebLogic JMS 6.x applications are supported in WebLogic JMS 7.0. However, if you want your applications to take advantage of t...
Page 41 - JSP; Load Order for Startup Classes; Managed Servers
Additional Upgrade Procedures and Information BEA WebLogic Server 7.0 Upgrade Guide 1-29 JSP Due to a change in the JSP specification, null request attributes now return the string “null” instead of an empty string. WebLogic Server versions since 6.1 contain a new flag in weblogic.xml called printNu...
Page 42 - MBean API Change; Security
1 Upgrading WebLogic Server 6.x to Version 7.0 1-30 BEA WebLogic Server 7.0 Upgrade Guide MBean API Change Previous versions of this document and various other sample documents erroneously described using weblogic.management.Admin.getInstance().getAdminMBeanHome() as a way to look up the MBeanHome i...
Page 43 - Servlets; Thread Pool Size
Additional Upgrade Procedures and Information BEA WebLogic Server 7.0 Upgrade Guide 1-31 about upgrading, see “ Upgrading Security ” in the Upgrade Guide for BEA WebLogic Server 7.0 . Servlets Update your web.xml file so that it uses the following new classes: weblogic.servlet.proxy.HttpClusterServl...
Page 44 - Web Applications
1 Upgrading WebLogic Server 6.x to Version 7.0 1-32 BEA WebLogic Server 7.0 Upgrade Guide .../Server> Starting in WebLogic Server 7.0: <ServerName="myserver"... ><ExecuteQueueName="default"ThreadCount="23" />/Server> To change the thread count value via the ...
Page 45 - WebLogic Server Clusters on Solaris; Writable config.xml File
Additional Upgrade Procedures and Information BEA WebLogic Server 7.0 Upgrade Guide 1-33 WebLogic Server Clusters on Solaris Certain applications (heavy EJB apps) deployed in a WebLogic Server cluster on Solaris will perform better using the client JVM rather than the server JVM. This is especially ...
Page 46 - Deprecated APIs and Features
1 Upgrading WebLogic Server 6.x to Version 7.0 1-34 BEA WebLogic Server 7.0 Upgrade Guide Deprecated APIs and Features WebLogic Time Services is deprecated and should be replaced by JMX Timer Service. For documentation of JMX Timer Service, see Interface TimerMBean and Class Timer . WebLogic Wor...
Page 48 - Removed APIs and Features
1 Upgrading WebLogic Server 6.x to Version 7.0 1-36 BEA WebLogic Server 7.0 Upgrade Guide Removed APIs and Features WebLogic Enterprise Connectivity (WLEC) examples have been removed.
Page 51 - Upgrading Your WebLogic Server Configuration: Main Steps
Upgrading Your WebLogic Server Configuration: Main Steps BEA WebLogic Server 7.0 Upgrade Guide 2-3 3. Upgrade your server license files. For instructions on how to convert your licenses to the new format, see “Upgrading WebLogic Server License Files” on page 2-4 . 4. Convert your weblogic.properties...
Page 52 - Upgrading WebLogic Server License Files; Converting a WebLogicLicense.class License; Converting a WebLogicLicense.XML License
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-4 BEA WebLogic Server 7.0 Upgrade Guide Note: The directory structure in WebLogic Server 7.0 is different from that of 4.5 and 5.1. For complete information on the updated directory structure see Understanding the WebLogic Server Directory Str...
Page 53 - Converting the weblogic.properties File to XML Files
Converting the weblogic.properties File to XML Files BEA WebLogic Server 7.0 Upgrade Guide 2-5 2. Click the link to update a WebLogic Server license. You may need to scroll down to see the link. 3. Browse and select the pathname for the directory containing the license file to be converted, or enter...
Page 56 - Classloading in WebLogic Server 7.0
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-8 BEA WebLogic Server 7.0 Upgrade Guide Classloading in WebLogic Server 7.0 Earlier versions of WebLogic Server used the WebLogic classpath property ( weblogic.class.path ) to facilitate dynamic classloading. In WebLogic 6.0 and later, the web...
Page 57 - WebLogic Server 7.0 J2EE Application Types
WebLogic Server 7.0 J2EE Application Types BEA WebLogic Server 7.0 Upgrade Guide 2-9 WebLogic Server 7.0 J2EE Application Types Applications on J2EE-compliant servers such as WebLogic Server 7.0 are created and deployed as one of the following four types: Web Applications, Enterprise JavaBeans, Ente...
Page 58 - Web Applications Directory Structure
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-10 BEA WebLogic Server 7.0 Upgrade Guide “XML Deployment Descriptors” on page 2-11 “WAR Files” on page 2-12 “Deploying Web Applications” on page 2-12 “Session Porting” on page 2-13 “JavaServer Pages (JSPs) and Servlets” on page 2-14 ...
Page 59 - XML Deployment Descriptors
Converting and Porting Your Existing Applications into Web Applications BEA WebLogic Server 7.0 Upgrade Guide 2-11 When you convert your weblogic.properties file, the appropriate web.xml and weblogic.xml files are created for you under the directory domain\applications\DefaultWebApp_myserver\WEB-INF...
Page 60 - WAR Files; Deploying Web Applications
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-12 BEA WebLogic Server 7.0 Upgrade Guide WAR Files A WAR file is a Web Application archive. If you have correctly followed the prescribed directory structure of a Web Application and created the appropriate web.xml and weblogic.xml files, it i...
Page 61 - Session Porting
Converting and Porting Your Existing Applications into Web Applications BEA WebLogic Server 7.0 Upgrade Guide 2-13 8. Enter a name for the application or component in the provided field and click Create. 9. Enter the following information: Staging Mode—specify the staging mode. The options include s...
Page 65 - Porting and Converting Enterprise JavaBeans Applications; EJB Porting Considerations
Porting and Converting Enterprise JavaBeans Applications BEA WebLogic Server 7.0 Upgrade Guide 2-17 EJB Porting Considerations Consider the following when porting Enterprise JavaBeans to WebLogic Server 7.0. WebLogic Server Version 7.0 supports the Enterprise JavaBeans 1.1 and 2.0 specifications. ...
Page 66 - EJB Porting Recommendations
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-18 BEA WebLogic Server 7.0 Upgrade Guide for the WebLogic Server EJB container. This file must conform to the WebLogic Server 5.1 DTD or the WebLogic Server 7.0 DTD. In order to specify the mappings to the database, container-managed persist...
Page 70 - Steps for Converting an EJB 1.1 to an EJB 2.0
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-22 BEA WebLogic Server 7.0 Upgrade Guide java -classpath %CLIENTCLASSES%;%CLASSPATH% examples.ejb.basic.statelessSession.Client This command ensures that the EJB interfaces are referenced in your client’s classpath. Steps for Converting an EJB...
Page 71 - Porting EJBs from Other J2EE Application Servers; Creating an Enterprise Application
Creating an Enterprise Application BEA WebLogic Server 7.0 Upgrade Guide 2-23 Porting EJBs from Other J2EE Application Servers Any EJB that complies with the EJB 1.1 or EJB 2.0 specifications may be deployed in the WebLogic Server 7.0 EJB container. Each EJB JAR file requires an ejb-jar.xml file, a ...
Page 72 - Understanding J2EE Client Applications
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-24 BEA WebLogic Server 7.0 Upgrade Guide Developing WebLogic Server Applications . Note that if you are using JSPs and want them to compile at run time you must have the home and remote interfaces of the bean included in the classes directory ...
Page 73 - Upgrading JMS
Upgrading JMS BEA WebLogic Server 7.0 Upgrade Guide 2-25 Upgrading JMS WebLogic Server 7.0 supports the JavaSoft JMS specification version 1.0.2 . Weblogic Server 4.5.1 — Porting is supported only for SP15. Customers running all service packs should contact BEA Support. Weblogic Server 5.1 — Cus...
Page 75 - Additional Porting and Deployment Considerations; Applications and Managed Servers
Additional Porting and Deployment Considerations BEA WebLogic Server 7.0 Upgrade Guide 2-27 “Wireless Application Protocol Applications” on page 2-35 “Writable config.xml File” on page 2-35 “XML 7.0 Parser and Transformer” on page 2-36 “Deprecated APIs and Features” on page 2-36 “Removed A...
Page 76 - FileServlet
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-28 BEA WebLogic Server 7.0 Upgrade Guide FileServlet In WebLogic Server 6.1 Service Pack 2 and later, the behavior of FileServlet, which is the default servlet for a Web Application, has changed. FileServlet now includes the SERVLET_PATH when ...
Page 77 - Error Handling
Additional Porting and Deployment Considerations BEA WebLogic Server 7.0 Upgrade Guide 2-29 Based on the inclusion of support for JTA, the JTS JDBC driver (with properties in weblogic.jts.* and URL jdbc:weblogic:jts :..) has been replaced by a JTA JDBC/XA driver. Existing properties are available ...
Page 78 - Null Attributes; JVM; RMI
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-30 BEA WebLogic Server 7.0 Upgrade Guide Null Attributes Due to a change in the JSP specification, null request attributes now return the string "null" instead of an empty string. WebLogic Server versions since 6.1 contain a new flag i...
Page 79 - Upgrading to the New Security Architecture
Additional Porting and Deployment Considerations BEA WebLogic Server 7.0 Upgrade Guide 2-31 Use JNDI instead of *.rmi.Naming. Use weblogic.rmic to generate dynamic proxies and bytecode; with the exception of RMI IIOP, stubs and skeletons classes are no longer generated. Note: For more informatio...
Page 81 - Standalone HTML and JSPs
Additional Porting and Deployment Considerations BEA WebLogic Server 7.0 Upgrade Guide 2-33 ----------END CERTIFICATE---------- Remove any extra lines. If the existing private key is not password protected, you do not need to specify the weblogic.management.pkpassword argument when starting the serv...
Page 82 - Web Components
2 Upgrading WebLogic Server 4.5 and 5.1 to Version 7.0 2-34 BEA WebLogic Server 7.0 Upgrade Guide Web Components The following tips are for users porting to WebLogic Server 7.0 who used Web components in their previous version of WebLogic Server: All Web components in WebLogic Server now use Web A...
Page 83 - Wireless Application Protocol Applications
Additional Porting and Deployment Considerations BEA WebLogic Server 7.0 Upgrade Guide 2-35 Wireless Application Protocol Applications To run a Wireless Application Protocol (WAP) application on WebLogic Server 7.0, you must now specify the MIME types associated with WAP in the web.xml file of the w...
Page 88 - The weblogic.properties Mapping Table
A The weblogic.properties Mapping Table A-2 BEA WebLogic Server 7.0 Upgrade Guide weblogic.cluster.defaultLoadAlgorithm config.xml:DefaultLoadAlgorithm ( Cluster element) Clusters: clustername : Configuration: General: Default Load Algorithm weblogic.cluster.multicastAddress config.xml:MulticastAddr...
Page 107 - Terms Used in This Document
BEA WebLogic Server 7.0 Upgrade Guide B-1 A PPENDIX B Upgrading the Pet Store Application and the Examples Server This appendix presents examples of the following processes: Upgrading the Pet Store Application From WebLogic 6.1 Service Pack 3 to WebLogic Server 7.0 Upgrading the WebLogic 6.0 Ser...
Page 108 - Upgrading the Pet Store Application and the Examples Server; Install WebLogic Server 7.0
B Upgrading the Pet Store Application and the Examples Server B-2 BEA WebLogic Server 7.0 Upgrade Guide For 6.0 WL_HOME=D:\WLS_6.0\wlserver6.0 For 6.1 WL_HOME=D:\WLS_6.1\wlserver6.1 For 7.0 WL_HOME=D:\WLS_7.0\weblogic700 Upgrading the Pet Store Application From WebLogic 6.1 Service Pack 3 to WebLogi...
Page 110 - Fix JSP Parsing Errors
B Upgrading the Pet Store Application and the Examples Server B-4 BEA WebLogic Server 7.0 Upgrade Guide An example of the above-listed config.xml file used for WebLogic Server 7.0 which includes explanations for how to change this script to upgrade the Examples Server toWebLogic Server 7.0. Note: ...
Page 112 - Rebuild Pet Store
B Upgrading the Pet Store Application and the Examples Server B-6 BEA WebLogic Server 7.0 Upgrade Guide } public void setStartIndex(String startIndexStr) { super.setNumItems(startIndexStr); } 4. Replace with the following: public void setNumItems(int numItems) { super.setNumItems(numItems); } public...
Page 118 - config.xml file used for WebLogic Server 6.1 Service Pack 3
B Upgrading the Pet Store Application and the Examples Server B-12 BEA WebLogic Server 7.0 Upgrade Guide :finishcd config\petStoreENDLOCAL config.xml file used for WebLogic Server 6.1 Service Pack 3 <DomainName="petstore"><JDBCTxDataSourceJNDIName="jdbc.EstoreDB"Name="Es...
Page 125 - 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 BEA WebLogic Server 7.0 Upgrade Guide B-19 Start the Pet Store Application on WebLogic Server 7.0 To start the Pet Store application on WebLogic Server 7.0: 1. Open a new web browser window. 2. Go to http://localhost:70...
Page 134 - Start the Examples Server on WebLogic Server 7.0
B Upgrading the Pet Store Application and the Examples Server B-28 BEA WebLogic Server 7.0 Upgrade Guide @rem original: %JAVA_HOME%\bin\java -hotspot -ms64m -mx64m@rem -classpath %CLASSPATH% -Dweblogic.Domain=examples@rem -Dweblogic.Name=examplesServer -Dbea.home=C:\bea60sp2@rem -Dcloudscape.system....
