BEA 7 - Manuals

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...

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 ...

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...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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...

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 ...

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 ...

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...

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.

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...

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...

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...

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...

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...

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 ...

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...

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...

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...

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. ...

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...

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...

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 ...

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 ...

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...

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...

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 ...

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 ...

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...

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...

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...

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...

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...

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...

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...

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...

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: ...

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...

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...

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...

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....