background image

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 Service Pack 2 Examples Server to WebLogic 
Server 7.0

„

Upgrading the WebLogic 6.1 Service Pack 2 Examples Server to WebLogic 
Server 7.0

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.

Terms Used in This Document

Where all three versions are being discussed, the instructions use version-specific 
terms for WebLogic home directories. These conventions are used in this document to 
make explaining how to port your domain configurations easier.

In this document 

WL_HOME

 is defined to be the home of WebLogic Server 6.x and 7.0.

Summary of Contents for WebLogic Server 7

Page 1: ...BEA WebLogic Server BEA WebLogic Server 7 0 Upgrade Guide Release 7 0 Document Date June 2002 Revised June 28 2002 ...

Page 2: ...6 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...

Page 3: ...n Application from WebLogic Server 6 x to WebLogic Server 7 0 1 4 Upgrading Security 1 6 Booting WebLogic Server in Compatibility Security 1 7 ACLs on MBeans 1 7 Upgrading from Compatibility Security to WebLogic Server 7 0 Security 1 8 Security Realms 1 9 Guest User 1 11 password ini File 1 11 Upgrading the SSL Protocol 1 12 Creating a Trusted CA Keystore 1 12 Using CertAuthenticator in Compatibil...

Page 4: ...eployment 1 24 EJB 2 0 1 25 weblogic management configuration EJBComponentMBean Changes 1 26 max beans in cache Parameter 1 26 Fully Qualified Path Expressions 1 27 jCOM 1 27 JDBC 1 27 JMS 1 28 JMX 1 28 Jolt Java Client 1 28 JSP 1 29 Load Order for Startup Classes 1 29 Managed Servers 1 29 MBean API Change 1 30 Security 1 30 Guest and Anonymous Users 1 30 Servlets 1 31 Thread Pool Size 1 31 Web Ap...

Page 5: ...les 2 12 Deploying Web Applications 2 12 Session Porting 2 13 JavaServer Pages JSPs and Servlets 2 14 Porting a Simple Servlet from WebLogic Server 5 1 to WebLogic Server 7 0 2 15 Porting and Converting Enterprise JavaBeans Applications 2 16 EJB Porting Considerations 2 17 EJB Porting Recommendations 2 18 Steps for Porting a 1 0 EJB from WebLogic Server 4 5 x to WebLogic Server 7 0 2 20 Steps for ...

Page 6: ...cations 2 35 Writable config xml File 2 35 XML 7 0 Parser and Transformer 2 36 Deprecated APIs and Features 2 36 Removed APIs and Features 2 37 A The weblogic properties Mapping Table B Upgrading the Pet Store Application and the Examples Server Terms Used in This Document B 1 Upgrading the Pet Store Application From WebLogic 6 1 Service Pack 3 to WebLogic Server 7 0 B 2 Install WebLogic Server 7 ...

Page 7: ...rver cmd script used to boot a WebLogic 6 0 Service Pack 2 Examples Server B 25 above listed startExamplesServer cmd script modified to boot a WebLogic 7 0 Examples Server B 26 Start the Examples Server on WebLogic Server 7 0 B 28 Upgrading the WebLogic 6 1 Service Pack 2 Examples Server to WebLogic Server 7 0 B 29 Install WebLogic Server 7 0 B 29 Set Up the WebLogic Server 7 0 Environment with Yo...

Page 8: ...viii BEA WebLogic Server 7 0 Upgrade Guide ...

Page 9: ... Server 7 0 from WebLogic Server 6 x Chapter 2 Upgrading WebLogic Server 4 5 and 5 1 to Version 7 0 describes how to upgrade to WebLogic Server 7 0 from WebLogic Server 4 5 or 5 1 Appendix A The weblogic properties Mapping Table shows which config xml web xml or weblogic xml attribute handles the function formerly performed by weblogic properties properties Audience This document is written for al...

Page 10: ...to us Send us e mail at docsupport bea com if you have questions or comments Your comments will be reviewed directly by the BEA professionals who create and update the documentation In your e mail message please indicate the software name and version you are using as well as the title and document date of your documentation If you have any questions about this version of BEA WebLogic Server or if ...

Page 11: ...itles monospace text Code samples commands and their options Java classes data types directories and file names and their extensions Monospace text also indicates text that you enter from the keyboard Examples import java util Enumeration chmod u w config examples applications java config xml float monospace italic text Variables in code Example String CustomerName UPPERCASE TEXT Device names envi...

Page 12: ...line Example java weblogic deploy list deploy undeploy update password application source Indicates one of the following in a command line An argument can be repeated several times in the command line The statement omits additional optional arguments You can enter additional parameters values or other information Indicates the omission of items from a code example or from a syntax line Convention ...

Page 13: ... Server 6 x to WebLogic Server 7 0 Upgrading Your WebLogic Server Configuration Main Steps on page 1 2 Modifying Startup Scripts on page 1 3 Understanding the WebLogic Server 7 0 Directory Structure on page 1 4 Porting an Application from WebLogic Server 6 x to WebLogic Server 7 0 on page 1 4 Upgrading Security on page 1 6 Upgrading WebLogic Tuxedo Connector on page 1 15 Additional Upgrade Procedu...

Page 14: ...downgrade to 6 x 2 Install WebLogic Server 7 0 See the the Installation Guide Note The installer will prevent you from installing the new version directly over the old version You must select a new directory location 3 Modify your 6 x startup scripts to work with WebLogic Server 7 0 See Modifying Startup Scripts on page 1 3 4 Ensure that you have considered differences in the WebLogic Server 7 0 d...

Page 15: ...r startup scripts with a previous version of the product modify them to work with WebLogic Server 7 0 Modify the startup scripts as described here For another example of how to modify the startup scripts see Upgrading the Pet Store Application and the Examples Server Modify the startup scripts as described here 1 Modify bea home property to point to your BEA home directory containing the license b...

Page 16: ...ee Understanding the WebLogic Server Directory Structure in Performing Post Installation Tasks in the Installation Guide If you are booting your WebLogic Server 6 x domain with the WebLogic Server 7 0 environment the new directory structure is created automatically However if you have custom tools or scripts that rely on the WebLogic Server 6 x domain directory structure you need to update those t...

Page 17: ...e paths to items such as the Java compiler or external files WebLogic Server configurations rely on a number of files that may be stored on the file system Typically these files are persistence repositories log files file based repositories etc or utilities Java compiler These files can be configured using fully qualified or relative paths If all external files are defined using relative paths and...

Page 18: ...he Introduction to WebLogic Security WebLogic Server 7 0 detects whether you are upgrading from an earlier WebLogic Server version or whether you are a new customer starting with 7 0 If you are upgrading from WebLogic Server 6 x WebLogic Server 7 0 runs in Compatibility security meaning that it allows you to keep your 6 x configuration of users and groups However because some key 6 x security func...

Page 19: ...either a File realm or an alternative security realm defined in your config xml file Otherwise your server may not boot If you are unable to boot WebLogic Server in Compatibility security copy SerializedSystemini dat to your new domain folder and then do one of the following Boot your configuration under WebLogic Server 6 x letting the server save the config xml file and then port the saved config...

Page 20: ...ted To upgrade you need to replace the Compatibility realm with myrealm From within the WebLogic Server Administration Console 1 Click on the Realms node The Realms table appears with two security realms configured The two security realms are the CompatibilityRealm and myrealm The CompatibilityRealm will have the default attribute set to true 2 Click on the myrealm node 3 Click on the Providers ta...

Page 21: ...they are changed Security Realms The scope of security realms changed in WebLogic Server 7 0 In WebLogic Server 6 x security realms provided authentication and authorization services You chose from the File realm or a set of alternative security realms including the Lightweight Data Access Protocol LDAP Windows NT UNIX or RDBMS realms In addition you could write a custom security realm In WebLogic...

Page 22: ...m Adapter Authentication provider in a WebLogic 7 0 security realm 1 Boot Compatibility security 2 Ensure that the Realm Adapter Authentication provider in the Compatibility realm is populated with users and groups from your 6 x security realm check that existing users and groups appear in the Users and Groups table The user and group information is copied into a filerealm properties file 3 Click ...

Page 23: ...d any unauthenticated user anonymous user as a guest user and allowed the guest user access to WebLogic Server resources In 7 0 WebLogic Server distinguishes between the guest user and an anonymous user To use the guest user as you did in WebLogic Server 6 x add the guest user to the default Authentication provider and set the following property when starting WebLogic Server Dweblogic security ano...

Page 24: ...ient checks the trusted certificate authorities presented by the server The client rejects the server s trusted certificate authority if the certificate authority is not trusted by the client Previous versions of WebLogic Server did not perform this trust validation Make the following changes to allow an existing 6 x WebLogic client to use SSL protocol to communicate with a server 1 Specify the fo...

Page 25: ...CAs to the JDK s trusted CA keystore and not specify the command line argument or you can create your own trusted CA keystore and point to it with the argument For two way SSL or mutual authentication in addition to performing the previous two steps on the client side do either of the following steps on the server side Add Dweblogic security SSL trustedCAKeyStore absoluteFilename to the server com...

Page 26: ...anually configure the X 509 identity assertion when using Compatibility security You enable X 509 identity assertion by configuring options on the Realm Adapter Authentication provider In the WebLogic Server Administration Console while running in Compatibility security 1 Click on the Security node 2 Click on the Realms node 3 Click on the CompatibilityRealm node 4 Click on the Providers node 5 Cl...

Page 27: ...the Administration Console at http e docs bea com wls docs70 wtc_admin Install html WTCuseCLI Previous releases of the connector used a WebLogic Server Startup class to start a WebLogic Tuxedo Connector session and a WebLogic Server Shutdown class to end a session In WebLogic Server 7 0 WebLogic Tuxedo Connector does not use a Startup or a Shutdown class WebLogic Tuxedo Connector sessions are mana...

Page 28: ... Server development shell as described in Setting Up your environment 2 Start an instance of WebLogic Server 3 Open a new shell window 4 Start the WTCMigrateCF tool Enter the following command java Dweblogic wtc migrateDebug weblogic wtc gwt WTCMigrateCF url URL username USERNAME password PASSWORD infile CONFIGWTC server SERVERNAME domain DOMAIN protocol PROTOCOL deploy The arguments for this comm...

Page 29: ...cts now use the server name to reference remote WebLogic Tuxedo Connector objects Earlier releases used the DOMAINID CONFIGWTC Fully qualified path and name of the WebLogic Tuxedo Connector XML configuration file to migrate to the config xml file Example d bea weblogic700 server samples examples wtc atmi simpapp bdmconfig xml SERVERNAME Optional The name of the administration or managed server tha...

Page 30: ...m your Tuxedo application 3 Modify the DM_REMOTE_SERVICES section of your Tuxedo domain configuration file Replace your WebLogic Server service name formerly the DOMAINID with the name of your WebLogic Server Listing 1 1 Domain Configuration File DM_RESOURCES VERSION U22 DM_LOCAL_DOMAINS TDOM1 GWGRP SYS_GRP TYPE TDOMAIN DOMAINID TDOM1 BLOCKTIME 20 MAXDATALEN 56 MAXRDOM 89 DM_REMOTE_DOMAINS TDOM2 T...

Page 31: ...hat can execute these services The valid values for this parameter are LOCAL GLOBAL ACL Policy is LOCAL If the WebLogic Tuxedo Connector ACL Policy is set to Local the Tuxedo remote domain DOMAINID must be authenticated as a local user To allow WebLogic Tuxedo Connector to authenticate a DOMAINID as a local user use the WebLogic Server Console to complete the following steps 1 Click on the Securit...

Page 32: ... Connector using the WebLogic Server log file you must set the tracing level using the WebLogic Server TraceLevel property For more information see Monitoring the WebLogic Tuxedo Connector at http e docs bea com wls docs70 wtc_admin troubleshooting html 1104694 Dweblogic wtc TraceLevel tracelevel where tracelevel is a number between 10 000 and 100 000 that specifies the level of WebLogic Tuxedo Co...

Page 33: ...c Server 7 0 uses PointBase 4 2 as a sample database and does not bundle the Cloudscape database ant jar on page 1 22 Apache Xalan XML Transformer on page 1 22 Apache Xerces XML Parser on page 1 23 Applications Directory on page 1 23 Deployment on page 1 24 EJB 2 0 on page 1 25 jCOM on page 1 27 JDBC on page 1 27 JMS on page 1 28 JMX on page 1 28 Jolt Java Client on page 1 28 JSP on page 1 29 Mana...

Page 34: ...has been deprecated If you are still using those APIs and encounter difficulties you should use the Java API for XML Processing JAXP to use XSLT Changes were made to Apache s Xalan code to enable Xerces and Xalan to work together You may encounter problems if you use Xalan from Apache because it will not include these changes In general it is best to use JAXP and to port any vendor specific code t...

Page 35: ... www apache org in the WL_HOME server ext xmlx zip file The ZIP file no longer includes these classes and interfaces Download the unmodified Xerces parser and Xalan transformer directly from the Apache Web site Applications Directory In WebLogic Server 6 1 and 7 0 there is a division between runtime modes The two modes are development and production The runtime mode is selected using a command lin...

Page 36: ...ll not deploy in the 7 0 server until you add that stanza A typical stanza looks like ejb reference description ejb ref name ejb acc Acc ejb ref name jndi name estore account jndi name ejb reference description Using WebLogic Server 7 0 you can no longer deploy through the console using the 6 x protocol As a result you must use the new deployment APIs If your application is previously deployed in ...

Page 37: ...tion You may have to make the following changes to EJB 2 0 beans If your deployment descriptor contains a 6 0 element that has a different name in 7 0 you have to manually change the name in your deployment descriptor The following are some examples of element names that you may need to change in 7 0 z In 7 0 the name of the element that is used to identify a particular EJB that participates in a ...

Page 38: ...plementation also does not do exclusive locking but gives each transaction its own instance of the read only bean to use If you have trouble with a servlet within the scope of application deployment see Deployment on page 1 24 weblogic management configuration EJBComponentMBean Changes Beginning in Weblogic Server 6 1 and continuing in WebLogic Server 7 0 the interface weblogic management configur...

Page 39: ...same query to be compiled the address and zip fields must be qualified SELECT c address FROM CustomerBean AS c WHERE c zip 1 jCOM For information about upgrading from WebLogic jCOM 6 1 to WebLogic jCOM 7 0 see Upgrading Considerations in Programming WebLogic jCOM JDBC The minimum capacity increment for a JDBC connection pool has changed from 0 in WebLogic Server 6 1 to 1 in version 7 0 See JDBCCon...

Page 40: ...mation on porting your WebLogic JMS applications see Porting WebLogic JMS Applications in Programming WebLogic JMS JMX All public WebLogic Server 6 x MBeans and attributes are supported in WebLogic Server 7 0 However if you are employing internal MBeans or attributes you may encounter porting issues See Deprecated APIs and Features on page 1 34 for information on deprecated MBean attributes and op...

Page 41: ...up Classes The behavior of LoadBeforeAppDeployments in StartupClassMbean has changed between versions 6 x and 7 0 Service Pack 2 LoadBeforeAppDeployments still exists in version 7 0 Service Pack 2 but its behavior has changed In 6 x setting LoadBeforeAppDeployments to true caused startup classes to be invoked after the datasources were created and before the applications were activated In 7 0 Serv...

Page 42: ...ted a potential security risk so the functionality was modified In this version of WebLogic Server the guest user is no longer supplied by default WebLogic Server now distinguishes between the guest user and an anonymous user by assigning an anonymous user the name anonymous If you want to use the guest user as you did in WebLogic Server 6 x do one of the following Use Compatibility security For m...

Page 43: ...pe of application deployment see Deployment on page 1 24 Thread Pool Size In WebLogic Server 6 0 the number of worker threads was specified via the ThreadPoolSize parameter on the server MBean Starting in WebLogic Server 6 1 the number of worker threads is defined via an ExecuteQueue on the Server MBean WebLogic Server 7 0 provides a porting path for this parameter so that if it is specified in th...

Page 44: ...agement runtime ServletRuntimeMBean getServletName in WebLogic Server 6 1 and 7 0 You will have to update your source code and recompile if you are using this interface With Java Servlet Specification 2 3 authorization on forward is no longer default behavior To obtain authorization when you forward to a secure resource add check auth on forward to the weblogic xml file Servlet Request and Respons...

Page 45: ...XML based RPC JAX RPC For detailed information on upgrading a 6 1 WebLogic Web service to 7 0 see Upgrading 6 1 WebLogic Web Services to 7 0 at http e docs bea com wls docs70 webServices migrate html For examples of using JAX RPC to invoke WebLogic Web services see Invoking Web Services at http e docs bea com wls docs70 webServices client html For general information on the differences between 6 1...

Page 46: ... select a directory for deployment the directory must contain either one standalone J2EE module an EJB Web Application or Resource Adapter or multiple modules with an associated application xml file an Enterprise Application This release provides a standard method for resource adapter deployers to plug in their specified authorization authentication mechanism through secure password credential sto...

Page 47: ...P1 weblogic management tools WebAppComponentRefreshTool and weblogic refresh are both deprecated in this release of WebLogic Server 7 0 They have been replaced by weblogic Deployer WebLogic JDBC t3 Driver See Deprecation of WebLogic File Services at http bt04 stage wls docs70 file filesrvc html 1028649 If you did programmatic deployment or used the weblogic Admin command in order to create applica...

Page 48: ...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 49: ...dures and other information you need to upgrade your system from WebLogic Server 4 5 or 5 1 to WebLogic Server 7 0 to port your applications from WebLogic Server 4 5 or 5 1 to WebLogic Server 7 0 and deploy these applications Instructions apply to upgrades from both WebLogic Server 4 5 and 5 1 to WebLogic Server 7 0 Upgrading Your WebLogic Server Configuration Main Steps on page 2 2 Upgrading WebL...

Page 50: ...our WebLogic Server Configuration Main Steps Take the following steps to upgrade from WebLogic Server 4 5 or 5 1 to WebLogic Server 7 0 1 Make a back up copy of your 4 5 or 5 1 domain before you begin the upgrade procedure After you start the server using WebLogic Server 7 0 classes you will be unable to downgrade to a previous version 2 Install WebLogic Server 7 0 See the Installation Guide Prior...

Page 51: ... CLASSPATH For more information see Classloading in WebLogic Server 7 0 on page 2 8 8 Modify your existing startup scripts to work with WebLogic 7 0 See Modifying Startup Scripts on page 2 8 9 Package and port your WebLogic server side business object implementations referred to as Web applications beginning with WebLogic Server 6 0 to run on WebLogic 7 0 See Converting and Porting Your Existing A...

Page 52: ...a Converting a WebLogicLicense class License If a WebLogicLicense class license file is used in your existing WebLogic Server installation perform the following tasks before you install WebLogic Server 7 x 1 Convert the WebLogicLicense class license file to a WebLogicLicense XML file using the licenseConverter utility at http www weblogic com docs51 techstart utils html licenseConverter 2 Convert ...

Page 53: ...ebLogic Server releases used a weblogic properties file to configure applications In WebLogic Server 7 0 configuration of applications is handled through XML descriptor files and the Administration Console Converting a weblogic properties file to the config xml file creates a new domain for your applications and adds XML files that define how your applications are set up BEA Systems recommends tha...

Page 54: ... password 2 At the home page for the WebLogic Administration Console for example http localhost 7001 console index jsp click on the Convert weblogic properties link under the heading Helpful Tools 3 Use the Console s links to navigate the server s file system and find the root directory of your previous version of WebLogic Server for example C weblogic When you have found the correct directory cli...

Page 55: ...ng a security realms in WebLogic Server 7 0 see Customizing the Default Security Configuration The weblogic common ConfigServicesDef API which provided methods to get properties out of the weblogic properties file has been removed from this version For more procedures for converting your weblogic properties file see the Console Help documentation For a list of which config xml web xml or weblogic ...

Page 56: ... applications Modifying Startup Scripts If you used WebLogic Server startup scripts with a previous version of the product modify them to work with 7 0 Modify the startup scripts as described in Setting the Classpath in the Administration Guide The WebLogic classpath is no longer used use the Java system classpath as described in the preceding section Classloading in WebLogic Server 7 0 on page 2 ...

Page 57: ...iptor that describes the bundled components Client Applications are Java classes that connect to WebLogic Server through Remote Method Invocation RMI Later sections discuss the aforementioned J2EE deployment units in greater detail Converting and Porting Your Existing Applications into Web Applications In order to convert an application to a Web Application and then port it into a Web Application ...

Page 58: ...static files and other resources belonging to a Web Application are organized under a directory hierarchy The root of this hierarchy defines the document root of your Web Application All files under this root directory can be served to the client except for files under the special directories WEB INF and META INF located in the root directory The root directory should be named with the name of you...

Page 59: ...JSP properties JNDI mappings security role mappings and HTTP session parameters The WebLogic specific deployment descriptor also defines how named resources in the web xml file are mapped to resources residing elsewhere in WebLogic Server For detailed instructions on creating the WebLogic specific deployment descriptor see Writing the WebLogic Specific Deployment Descriptor This file may not be re...

Page 60: ...Name with the specific name you have chosen for your Web Application jar cvf webAppName war You now have created a WAR file that contains all the files and configuration information for your Web Application Deploying Web Applications To configure and deploy a web application using the WebLogic Server Administration Console 1 Start the WebLogic Server Administration Console 2 Select the Domain in w...

Page 61: ...er the deployment order Targets Indicate the Targets Server for this configured application by moving the application from the Available list to the Chosen list Deploy Deploy the application to all of the selected targets or undeploy it from all targets Monitoring View monitoring information related to the application Notes Enter notes related to the application 13 Click Apply For more information...

Page 62: ...ed in the same Web Application these changes are not necessary Only serializable objects may be stored in a session if your application is intended to be distributable You must convert your weblogic properties file to XML attributes in web xml and or weblogic xml For additional information on this process see the conversion section of the Console Help Access control by an ACL has been replaced wit...

Page 63: ...l file has already been created for you If you registered HelloWorldServlet in your weblogic properties file before you converted it the servlet will be properly configured in your new web xml file An XML file can be created with any text editor The following is an example of a basic web xml file that could be used with the HelloWorldServlet DOCTYPE web app View Source for full doctype web app ser...

Page 64: ...ill create a hello war file and place it inside the C hello directory 6 To install this Web Application start your server and open the Administration Console Under the Getting Started menu choose Install Applications Browse to the newly created WAR file and click Upload The servlet should now be deployed and appear under the Web Applications node under Deployments in the left hand pane of the cons...

Page 65: ...1 WebLogic Server 5 1 deployment descriptors can be upgraded to 7 0 to take advantage of new features in WebLogic Server 7 0 Details on the DDConverter utility are provided in the WebLogic Server EJB Utilities section of Programming WebLogic Enterprise JavaBeans The finder expressions feature of EJB 1 1 is no longer supported This is the only non supported feature of EJB 1 1 Deploying beans is des...

Page 66: ...gement to interface with the JDBC connection and it also supports XA transactions The WebLogic Server 7 0 CMP Deployment Descriptor supports TxDataSources and should be used instead of the WebLogic Server 5 1 CMP Deployment Descriptor which only specifies a connection pool Use a fast compiler ejbc The WebLogic Server EJB compiler weblogic ejbc generates Java code that is then compiled by the Java ...

Page 67: ...hows the descriptor combinations supported by WebLogic Server 7 0 For more information on Enterprise JavaBeans see Enterprise JavaBean Components and Programming WebLogic Enterprise Java Beans Table 2 1 EJB Version WebLogic Server Version The CMP Version Any existing WebLogic Server 5 1 deployment uses the following combination and can be deployed without changing descriptors or code in WebLogic S...

Page 68: ...jbc tool ensures that when the EJB compiles it conforms to either the EJB 1 1 or EJB 2 0 specifications 4 Correct any compliance errors before deploying the EJB in the EJB container To ensure EJB 1 1 or 2 0 compliance make the following changes to the EJB 1 0 beans EJB 1 0 beans referred to the SessionContext or EntityContext as transient When EJB 1 1 or 2 0 beans are deployed the reference cannot...

Page 69: ...oyment descriptor allows multiple EJBs to be specified and it supports using a TxDataSource instead of a connection pool Using a TxDataSource is required when XA is being used with EJB 1 1 CMP To port a 1 1 EJB from WebLogic Server 5 1 to WebLogic Server 7 0 1 Open the Administration Console From the home page click on Install Applications under the Getting Started heading 2 Locate the JAR file yo...

Page 70: ...n Programming WebLogic Enterprise JavaBeans for information on how to do this conversion The basic steps required to convert a simple CMP 1 1 bean to a 2 0 bean are as follows 1 Make the bean class abstract EJB 1 1 beans declare CMP fields in the bean CMP 2 0 beans use abstract getXXX and setXXX methods for each field For instance 1 1 Beans will use public String name 2 0 Beans should use public a...

Page 71: ...all of the JAR and WAR component archive files for an application and an XML descriptor that describes the bundled components The META INF application xml deployment descriptor contains an entry for each Web and EJB module and additional entries to describe security roles and application resources such as databases EnterpriseApplicationStagingDirectory jar files war files META INF application xml ...

Page 72: ...text are clients that are not Web browsers They are Java classes that connect to WebLogic Server using Remote Method Invocation RMI A Java client can access Enterprise JavaBeans JDBC connections messaging and other services using RMI Client applications range from simple command line utilities that use standard I O to highly interactive GUI applications built using the Java Swing AWT classes To ex...

Page 73: ...Applications in Programming WebLogic JMS Note that WebLogic Events are deprecated and are replaced by JMS messages with NO_ACKNOWLEDGE or MULTICAST_NO_ACKNOWLEDGE delivery modes Each of these delivery modes is described in WebLogic JMS Fundamentals in Programming WebLogic JMS Upgrading Oracle BEA Systems mirroring Oracle s support policy supports the Oracle releases listed in the Platform Support ...

Page 74: ...cations on WebLogic Server 7 0 Deprecated features upgrades and the important changes that have been made in WebLogic Server 7 0 are noted Note WebLogic Server 7 0 uses PointBase 4 2 as a sample database and does not bundle the Cloudscape database Applications and Managed Servers on page 2 27 Deployment on page 2 27 Plug ins on page 2 27 Internationalization I18N on page 2 28 Java Transaction API ...

Page 75: ...mation see Using WebLogic Server Clusters and Overview of WebLogic System Administration in the Administration Guide Deployment By default WebLogic Server version 7 0 uses the two phase deployment model For more information on this deployment model and other 7 0 deployment features see WebLogic Server Deployment in Developing WebLogic Server Applications Therefore if you deploy a 4 5 or 5 1 applic...

Page 76: ...at affect the way that messages are localized The new message format also has additions to the first line begin marker machine name server name thread id user id tran id and message id A new internationalized logging API enables users to log messages in the server and clients Clients log to their own logfiles which are in the same format as the server logfiles with the exception of the servername ...

Page 77: ...eing replaced with weblogic jdbc packages All WebLogic JDBC drivers are now compliant with JDBC 2 0 If you have a current connection and are using a preparedStatement and the stored procedure gets dropped in the DBMS use a new name to create the stored procedure If you recreate the stored procedure with the same name the preparedStatement will not know how to access the newly created stored proced...

Page 78: ...ram param name printNulls param name param value false param value jsp param weblogic web app JVM WebLogic Server 7 0 installs the Java Virtual Machine JVM JDK 1 3 1_02 with the server installation The setenv sh scripts provided with the server all point to the JVM The latest information regarding certified JVMs is available at the Certifications Page RMI The following tips are for users porting t...

Page 79: ... to the New Security Architecture WebLogic Server 7 0 has a new security architecture Upgrading WebLogic Server 4 5 or 5 1 to the security functionality in WebLogic Server 7 0 is a two step process 1 Upgrade your security configuration to WebLogic Server 6 x For instructions on how to upgrade security configurations from WebLogic Server 4 5 or 5 1 to WebLogic Server 6 x see the Security section un...

Page 80: ...elete extra characters at the end of each line in the private key Private Keys and Digital Certificates In this release of WebLogic Server more stringent checks are performed on private keys and digital certificates In order to use an existing private key and digital certificate you must perform the following upgrade steps 1 If the private key is encrypted convert the key to PEM format using the j...

Page 81: ...ookies from previous versions because cookie format changed with 6 0 WebLogic Server ignores cookies with the old format and creates new sessions The default name for cookies has changed from 5 1 when it was WebLogicSession Beginning in WebLogic 6 0 cookies are named JSESSIONID by default See weblogic xml Deployment Descriptor Elements in Assembling and Configuring Web Applications for more inform...

Page 82: ...re details SSI is no longer supported URL ACLs are deprecated Use Servlet 2 3 features instead Some information has moved from web xml to weblogic xml This reorganization allows a third party Web application based strictly on Servlet 2 3 to be deployed without modifications to its J2EE standard deployment descriptor web xml WebLogic Server 5 1 style settings made in the web xml file using context ...

Page 83: ...IME types see Programming WebLogic Server for Wireless Services For information on creating and editing a web xml file see Writing Web Application Deployment Descriptors in Assembling and Configuring Web Applications An example configuration of the mime types in the web xml file web app mime mapping extension tiff extension mime type image tiff extension mime mapping mime mapping extension tif ext...

Page 84: ... use FastParser if your application handles mostly small to medium size up to 10 000 elements XML documents The WebLogic Server 7 0 distribution no longer includes the unmodified Xerces parser and Xalan transformer in the WL_HOME server ext xmlx zip file Deprecated APIs and Features The following APIs and features are deprecated in anticipation of future removal from the product WebLogic Events We...

Page 85: ...loyment Tools and Procedures in Developing WebLogic Server Applications weblogic management tools WebAppComponentRefreshTool and weblogic refresh are both deprecated in this release of WebLogic Server 7 0 They have been replaced by weblogic Deployer Removed APIs and Features The following APIs and features have been removed The old administrative console GUI The Deployer Tool WebLogic Beans WebLog...

Page 86: ...2 Upgrading WebLogic Server 4 5 and 5 1 to Version 7 0 2 38 BEA WebLogic Server 7 0 Upgrade Guide This feature relied on the Microsoft JVM Jview which is no longer supported ...

Page 87: ...formed by weblogic properties properties weblogic properties file Property xml Configuration Attribute Console Label weblogic administrator email config xml EmailAddress Administrator element weblogic administrator location config xml Notes freeform optional Administrator element weblogic administrator name config xml Name Administrator element weblogic administrator phone config xml PhoneNumber A...

Page 88: ...figuration Multicast Multicast TTL weblogic cluster name config xml Cluster Address Cluster element Clusters clustername Configuration General Cluster Address weblogic httpd authRealmName config xml AuthRealmName WebAppComponent element Deployments Web Applications applicationname Configuration Other Auth Realm Name weblogic httpd charsets config xml Charsets WebServer element weblogic httpd clust...

Page 89: ... config xml KeepAliveSecs WebServer element weblogic httpd https keepAliveSe cs config xml HttpsKeepAliveSecs WebServer element weblogic httpd indexDirectories config xml IndexDirectoryEnabled WebAppComponent element Deployments Web Applications applicationname Configuration Files Index Directories weblogic httpd keepAlive enable config xml KeepAliveEnabled WebServer element Servers servername Con...

Page 90: ... WebServer element weblogic httpd logRotationPeriod Mins config xml LogRotationPeriodMins WebServer element weblogic httpd logRotationType config xml LogRotationType WebServer element Servers servername Logging HTTP Rotation Type weblogic httpd maxLogFileSizeKBy tes config xml MaxLogFileSizeKBytes WebServer element Servers servername Logging HTTP Max Log File Size Kbytes weblogic httpd mimeType we...

Page 91: ...ThreadedServletP oolSize WebAppComponent element Deployments Web Applications applicationname Configuration Files Single Threaded Servlet Pool Size weblogic httpd session cacheEntr ies weblogic xml CacheSize param name param va lue element pair Servers servername Configuration SSL Certificate Cache Size weblogic httpd session cookie co mment weblogic xml CookieComment param name param va lue eleme...

Page 92: ...m name param va lue element pair weblogic httpd session debug weblogic xml SessionDebuggable param name param va lue element pair weblogic httpd session enable weblogic xml TrackingEnabled param name param va lue element pair weblogic httpd session invalidat ionintervalSecs weblogic xml InvalidationIntervalSe cs param name param va lue element pair weblogic httpd session jdbc conn TimeoutSecs webl...

Page 93: ...StoreType weblogic xml PersistentStoreType param name param va lue element pair weblogic httpd session sessionID Length weblogic xml IDLength param name param va lue element pair weblogic httpd session swapinter valSecs weblogic xml SwapIntervalSecs param name param va lue element pair weblogic httpd session timeoutSe cs weblogic xml TimeoutSecs param name param va lue element pair Servers servern...

Page 94: ...on Tuning Tunneling Client Timeout weblogic httpd tunnelingenabled config xml TunnelingEnabled Server element Servers servername Configuration Tuning Enable Tunneling weblogic httpd URLResource config xml URLResource WebServer element weblogic iiop password config xml DefaultIIOPPassword Server element Servers servername Configuration Protocols Default IIOP Password weblogic iiop user config xml D...

Page 95: ...utorefresh test refreshTestMinutes interval for autorefresh test testConnsOnReserve true to test connection at reserve testConnsOnRelease true to test connection at release props props for JDBC connection URL DriveName LoginDelaySeconds InitialCapacity MaxCapacity CapacityIncrement AllowShrinking ShrinkPeriodMinutes TestTableName RefreshMinutes TestConnectionsOnReser ve TestConnectionsOnRelea se P...

Page 96: ...ation weblogic jms connectionFactoryAr gs factoryName ClientID DeliveryMode TransactionTimeout config xml JMSConnectionFactory element ClientID DefaultDeliveryMode TransactionTimeout UserTransactionsEnable d AllowCloseInOnMessage weblogic jms connectionFactoryNa me config xml JMSConnectionFactory element JNDIName weblogic jms connectionPool ConnectionPool JMSJDBCStore element weblogic jms queue co...

Page 97: ...logic jms topicSessionPool config xml ConnectionConsumer ConnectionFactory ListenerClass AcknowledgeMode SessionsMaximum Transacted JMSSessionPool element weblogic jndi transportableObjec tFactories config xml JNDITransportableObjec tFactoryList Server element Servers servername weblogic login readTimeoutMillis SSL config xml LoginTimeoutMillis SSL element Servers servername weblogic security audi...

Page 98: ...config xml TrustedCAFileName SSL element Servers servername Configuration SSL Trusted CA File Name weblogic security disableGuest config xml GuestDisabled Security element Security General Guest Disabled weblogic security enforceClientC ert config xml ClientCertificateEnforced SSL element Servers servername Configuration SSL Client Certificate Enforced weblogic security key export lif espan config...

Page 99: ...urity ldaprealm grou pNameAttribute config xml GroupNameAttribute LDAPRealm element weblogic security ldaprealm grou pUsernameAttribute config xml GroupUsernameAttribute LDAPRealm element weblogic security ldaprealm prin cipal config xml Principal LDAPRealm element weblogic security ldaprealm ssl config xml SSLEnable LDAPRealm element weblogic security ldaprealm url config xml LDAPURL LDAPRealm el...

Page 100: ...ement weblogic security ntrealm domain config xml PrimaryDomain NTRealm element weblogic security realm cache ac l enable config xml ACLCacheEnable CachingRealm element weblogic security realm cache ac l size config xml ACLCacheSize CachingRealm element weblogic security realm cache ac l ttl negative config xml ACLCacheTTLNegative CachingRealm element weblogic security realm cache ac l ttl positiv...

Page 101: ...config xml CacheCaseSensitive CachingRealm element weblogic security realm cache gr oup enable config xml GroupCacheEnable CachingRealm element weblogic security realm cache gr oup size config xml GroupCacheSize CachingRealm element weblogic security realm cache gr oup ttl negative config xml GroupCacheTTLNegative CachingRealm element weblogic security realm cache gr oup ttl positive config xml Gr...

Page 102: ...enable config xml UserCacheEnable CachingRealm element weblogic security realm cache us er size config xml UserCacheSize CachingRealm element weblogic security realm cache us er ttl negative config xml UserCacheTTLNegative CachingRealm element weblogic security realm cache us er ttl positive config xml UserCacheTTLPositive CachingRealm element weblogic security realm certAuth enticator config xml ...

Page 103: ...figuration SSL Handler Enabled weblogic security unixrealm auth Program config xml AuthProgram UnixRealm element weblogic system AdministrationPo rt config xml AdministrationPort Server element Servers servername Configuration General Administration Port weblogic system bindAddr config xml ListenAddress Server element weblogic system defaultProtocol config xml DefaultProtocol Server element Server...

Page 104: ...nableSetGID config xml PostBindGID weblogic system enableSetUID config xml PostBindUIDEnabled weblogic system enableTGIOP config xml TGIOPEnabled Server element Servers servername weblogic system helpPageURL config xml HelpPageURL Server element Servers servername weblogic system home config xml RootDirectory Server element weblogic system ListenPort config xml ListenPort Server element Servers se...

Page 105: ... ServerDebug element weblogic system maxLogFileSize config xml FileMinxSize Log element weblogic system nativeIO enable config xml NativeIOEnabled Server element Servers servername Configuration Tuning Enable Native IO weblogic system nonPrivGroup config xml PostBindGID UnixMachine element weblogic system nonPrivUser config xml PostBindUID UnixMachine element weblogic system percentSocketRea ders ...

Page 106: ...tion SSL Use Java weblogic system SSLListenPort config xml ListenPort SSL element Servers servername Configuration SSL Listen Port weblogic system startupFailureIs Fatal config xml FailureIsFatal StartupClass element weblogic system user config xml SystemUser Security element weblogic system weight config xml ClusterWeight Server element Servers servername Configuration Cluster Cluster Weight webl...

Page 107: ... 2 Examples Server to WebLogic Server 7 0 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 Terms Used in This Document Where all three versions are being discussed the instructions use version specific terms for WebLogic home directories These...

Page 108: ...bLogic Server 7 0 this section just provides the steps to do so as an example of how to upgrade an application from 6 1 to 7 0 To upgrade the WebLogic 6 1 Service Pack 3 Pet Store application for use on WebLogic Server 7 0 1 Install WebLogic Server 7 0 2 Set Up the WebLogic Server 7 0 Environment with Your 6 1 Service Pack 3 Domain Configuration 3 Start the Pet Store Application on WebLogic Server...

Page 109: ... Pet Store s directory location in WebLogic Server 6 1 you will not need to edit the config xml file to reflect a new directory location If you copy Pet Store to a different directory location you will need to find all of the fully qualified file and directory paths in your config xml file and change them to relative paths 3 Edit the startPetstore cmd script to reflect the new WebLogic Server 7 0 ...

Page 110: ...t them The errors corrected in this section are property settings for which the method and setter properties do not agree Correcting the errors requires making changes to these source files ListTag java CartListTag java MyListTag java ProductItemListTag java ProductListTag java SearchListTag java All of these files are located in the WL_HOME samples petStore src petstore src com sun j2ee blueprint...

Page 111: ...Index startIndexIn 5 Save and close ListTag java Make the replacements in the rest of the files as follows 1 In the command console navigate to WL_HOME samples petStore src petstore src com sun j2ee blueprin ts petstore taglib list For example C cd WL_HOME samples petStore src petstore src com sun j2ee blueprin ts petstore taglib list 2 Open CartListTag java in a text editor For example WL_HOME sa...

Page 112: ...steps 1 through 5 for the remaining files MyListTag java ProductItemListTag java ProductListTag java SearchListTag java Rebuild Pet Store After making the corrections to Pet Store rebuild the application 1 In a command console change to theWebLogic Server 6 x WL_HOME config examples directory and set your environment WL_HOME config examples setexamplesenv cmd or sh 2 In the same console change to ...

Page 113: ...ebLogic Server installer Note that rem this script uses the hotspot VM to run WebLogic Server rem If you choose to use a JDK other than the one rem included in the disribution make sure that the JDK rem includes the hotspot VM See the WebLogic platform rem support page http e docs bea com wls platforms index html rem for an up to date list of supported JVMs on Windows NT rem rem When setting these...

Page 114: ...eServer cmd script so that the JAVA_HOME echo variable points to the root directory of your JDK installation goto finish runWebLogic echo on set PATH bin JAVA_HOME bin PATH set CLASSPATH lib weblogic_sp jar lib weblogic jar samples eval cloudscape lib cloudscape jar config petStore se rverclasses echo off echo echo echo To start WebLogic Server use the password echo assigned to the system user The...

Page 115: ...This script can be used to start WebLogic Server for the purpose rem of running the PetStore application This script ensures that rem the server is started using the config xml file found in rem this directory and that the CLASSPATH is set appropriately rem This script contains the following variables rem rem JAVA_HOME Determines the version of Java used to start rem WebLogic Server This variable ...

Page 116: ...l index html SETLOCAL cd rem Set user defined variables rem 1 SET THE NEW JAVA HOME APPROPRIATELY set JAVA_HOME D 70bea jdk131 rem 2 FOR SIMPLICITY CREATE AND SET BEA_HOME AND WL_HOME70 set BEA_HOME d wls70 set WL_HOME70 BEA_HOME weblogic700 rem 3 REMOVE THIS ENTIRE CHECK AND ITS TAG SINCE rem NEITHER IS RELEVANT ANY LONGER rem Check that script is being run from the appropriate directory rem if n...

Page 117: ... user The system echo username and password must also be used to echo access the WebLogic Server console from a web echo browser echo rem Set WLS_PW equal to your system password for no password prompt server startup set WLS_PW rem Set Production Mode When set to true the server starts up in production mode rem When set to false the server starts up in development mode The default is false set STA...

Page 118: ...ntoryDB Name InventoryDB PoolName petstorePool Targets petstoreServer JDBCTxDataSource JNDIName jdbc SignOnDB Name SignOnDB PoolName petstorePool Targets petstoreServer Application Deployed true Name tour Path D WLS 6 1 wlserver6 1 config petstore applications tour war WebAppComponent Name tour Targets petstoreServer URI tour war Application Application Deployed true Name petstore Path D WLS 6 1 w...

Page 119: ...petstoreServer URI signonEjb jar EJBComponent Name shoppingcartEjb Targets petstoreServer URI shoppingcartEjb jar EJBComponent Name petstoreEjb Targets petstoreServer URI petstoreEjb jar WebAppComponent Name petstore Targets petstoreServer URI petstore war Application Application Deployed true Name petstoreAdmin Path D WLS 6 1 wlserver6 1 config petstore applications petstoreAdmin ear EJBComponent...

Page 120: ...ig petstore ca pem ServerCertificateFileName config petstore democert pem ServerKeyFileName config petstore demokey pem TrustedCAFileName config petstore ca pem Ciphersuites SSL_RSA_EXPORT_WITH_RC4_40_MD5 SSL_RSA_WITH_DES_C BC_SHA SSL_RSA_EXPORT_WITH_DES_40_CBC_SHA SSL_NULL_WITH_NULL_NULL Log FileName config petstore logs weblogic log Server Log FileName config petstore logs wl domain log JDBCConn...

Page 121: ... a browser after the server has finished booting Domain above listed config xml file used for WebLogic Server 7 0 1 Change the path to point to your 7 0 petstore ear file Domain ConfigurationVersion 7 0 0 0 Name petstore Path D 700sp0 weblogic700 samples server config petstore appl ications petstore ear StagedTargets TwoPhase false JDBCTxDataSource JNDIName jdbc EstoreDB Name EstoreDB PoolName pet...

Page 122: ...tomerEjb Targets petstoreServer URI customerEjb jar EJBComponent Name inventoryEjb Targets petstoreServer URI inventoryEjb jar EJBComponent Name mailerEjb Targets petstoreServer URI mailerEjb jar EJBComponent Name personalizationEjb Targets petstoreServer URI personalizationEjb jar EJBComponent Name signonEjb Targets petstoreServer URI signonEjb jar EJBComponent Name shoppingcartEjb Targets petsto...

Page 123: ...reServer URI petstoreadmin war Application 3 Change the path so that it points to the location of your WebLogic Server 7 0 Java compiler Server JavaCompiler D 700sp0 jdk131_02 bin javac ListenPort 7001 Name petstoreServer RootDirectory D 700sp0 ThreadPoolSize 15 TransactionLogFilePrefix config petstore logs IIOPEnabled false WebServer DefaultWebApp tour LogFileName config petstore logs access log ...

Page 124: ...ity 1 MaxCapacity 1 Name petstorePool Properties user none password none server none Targets petstoreServer URL jdbc cloudscape petStore FileRealm Name myFileRealm Security Realm myRealm Realm FileRealm myFileRealm Name myRealm MailSession Name mailSession Targets petstoreServer JNDIName mail Session Properties mail from orders javapetstoredemo com mail host san francisco beasys com StartupClass A...

Page 125: ...ary to upgrade the WebLogic 6 0 Examples Server to WebLogic Server 7 0 this section just provides the steps to do so as an example of how to upgrade a server from 6 0 to 7 0 To upgrade the WebLogic 6 0 Examples Server domain configuration for use on WebLogic Server 7 0 Install WebLogic Server 7 0 Set Up the WebLogic Server 7 0 Environment with Your 6 0 Service Pack 2 Domain Configuration Start the...

Page 126: ...cmd and sh respectively The setExamplesEnv script at SAMPLES_HOME server config examples sets certain environment variables in your development shell the command window from which you build and run the examples setExamplesEnv sets these variables CLASSPATH contains all of the classes needed to build and run the examples CLIENT_CLASSES points to the directory that stores client classes SERVER_CLASS...

Page 127: ...n example of the startExamplesServer cmd script used to boot a WebLogic 6 0 Service Pack 2 Examples Server An example of the above listed startExamplesServer cmd script modified to boot a WebLogic 7 0 Examples Server which includes explanations for how to change this script to upgrade the Examples Server toWebLogic Server 7 0 setExamplesEnv cmd script used to boot a WebLogic 6 0 Service Pack 2 Exa...

Page 128: ...E D WLS_6 0 jdk130 if exist WL_HOME lib weblogic jar goto checkJava echo echo The WebLogic Server wasn t found in directory WL_HOME echo Please edit the setExamplesEnv cmd script so that the echo WL_HOME echo variable points to the WebLogic Server installation echo directory echo Your environment has not been set goto finish checkJava if exist JAVA_HOME bin java exe goto setEnv echo echo The JDK w...

Page 129: ... JAVA_HOME Determines the version of Java used to compile rem and run examples This variable must point to the rem root directory of a complete JDK installation See rem the WebLogic platform support page rem http e docs bea com wls platforms index html rem for an up to date list of supported JVMs on Windows NT rem rem When setting these variables below please use short file rem names 8 3 rem To di...

Page 130: ... config examples applications 5 Point to the directory used to store client classes set CLIENT_CLASSES WL60_HOME config examples clientclasses 6 Point to the directory used to store server side classes set SERVER_CLASSES WL60_HOME config examples serverclasses 7 Point to the directory used to store classes used by the Examples Web Application set EX_WEBAPP_CLASSES WL60_HOME config examples applica...

Page 131: ...e set rem for you by the WebLogic Server installer Note that rem this script uses the hotspot VM to run WebLogic Server rem If you choose to use a JDK other than the one rem included in the disribution make sure that the JDK rem includes the hotspot VM See the WebLogic platform rem support page rem http e docs bea com wls platforms index html rem for an up to date list of supported JVMs rem on Win...

Page 132: ...he root directory of your Java installation goto finish runWebLogic echo on set PATH bin PATH set CLASSPATH lib weblogic_sp jar lib weblogic jar samples eval cloudscape lib cloudscape jar config examples server classes JAVA_HOME bin java hotspot ms64m mx64m classpath CLASSPATH Dweblogic Domain examples Dweblogic Name examplesServer Dbea home D WLS 6 0 Dcloudscape system home samples eval cloudscap...

Page 133: ... The JRE wasn t found in directory JAVA_HOME echo Please edit the startExamplesServer cmd script so that the JAVA_HOME echo variable points to the root directory of your Java installation goto finish runWebLogic echo on rem original set PATH bin PATH 4 Set the PATH to look in your WL_HOME 7 0 home If this is not set the server won t boot set PATH WL_HOME bin PATH rem original set rem CLASSPATH lib...

Page 134: ...LASSPATH Dweblogic Name examplesServer Dweblogic ProductionModeEnabled true Dbea home C bea700 Dcloudscape system home WL60_HOME samples eval cloudscape data Djava security policy WL60_HOME lib weblogic policy weblogic Server goto finish finish ENDLOCAL Start the Examples Server on WebLogic Server 7 0 To start the Examples Server on WebLogic Server 7 0 On Windows 1 On the taskbar click Start 2 Cho...

Page 135: ...the WebLogic 6 1 Examples Server to WebLogic Server 7 0 this section just provides the steps to do so as an example of how to upgrade a server from 6 1 to 7 0 To upgrade the WebLogic 6 1 Examples Server domain configuration for use on WebLogic Server 7 0 Install WebLogic Server 7 0 Set Up the WebLogic Server 7 0 Environment with Your 6 1 Service Pack 2 Domain Configuration Start the Examples Serve...

Page 136: ...d and sh respectively The setExamplesEnv script at SAMPLES_HOME server config examples sets certain environment variables in your development shell the command window from which you build and run the examples setExamplesEnv sets these variables CLASSPATH contains all of the classes needed to build and run the examples CLIENT_CLASSES points to the directory that stores client classes SERVER_CLASSES...

Page 137: ...xamplesServer cmd script used to boot a WebLogic 6 1 Service Pack 2 Examples Server An example of the above listed startExamplesServer cmd script modified to boot WebLogic Server 7 0 which includes explanations for how to change this script to upgrade the Examples Server toWebLogic Server 7 0 setExamplesEnv cmd script used to boot a WebLogic 6 1 Service Pack 2 Examples Server echo on rem This scri...

Page 138: ...directory WL_HOME echo Please edit the setExamplesEnv cmd script so that the echo WL_HOME variable points to the WebLogic Server installation echo directory echo Your environment has not been set goto finish checkJava dir JAVA_HOME jre bin java exe nul if errorlevel 0 goto setEnv echo echo The JDK wasn t found in directory JAVA_HOME echo Please edit the setEnv cmd script so that the JAVA_HOME echo...

Page 139: ... platform support page rem http e docs bea com wls platforms index html rem for an up to date list of supported JVMs on Windows NT rem rem When setting these variables below please use short file rem names 8 3 rem To display short MS DOS filenames use dir x File rem names with spaces will break this script rem rem jDriver for Oracle users This script assumes that native libraries rem required for ...

Page 140: ...t to the directory used to store server side classes set SERVER_CLASSES WL61_HOME config examples serverclasses 7 Point to the directory used to store classes used by the Examples Web Application set EX_WEBAPP_CLASSES WL61_HOME config examples applications exam plesWebApp WEB INF classes 8 Point to the WebLogic Server 6 1 and WebLogic Server 7 0 classes set CLASSPATH JAVA_HOME lib tools jar WL_HOM...

Page 141: ...ses the hotspot VM to run WebLogic Server rem If you choose to use a JDK other than the one rem included in the disribution make sure that the JDK rem includes the hotspot VM See the WebLogic platform rem support page http e docs bea com wls platforms index html rem for an up to date list of supported JVMs on Windows NT rem rem When setting the variable below please use short file names 8 3 rem To...

Page 142: ...so that the JAVA_HOME echo variable points to the root directory of your JDK installation goto finish runWebLogic echo on set PATH bin PATH set CLASSPATH lib weblogic_sp jar lib weblogic jar samples eval cloudscape lib cloudscape jar config examples serverclas ses echo off echo echo echo To start WebLogic Server use the password echo assigned to the system user The system echo username and passwor...

Page 143: ...ariables rem original set JAVA_HOME C bea61sp2 jdk130 1 Set your JAVA_HOME to your new JDK in WebLogic 7 0 set JAVA_HOME C bea700 jdk131 rem added 2 Set this in order to be able to access your WebLogic Server 6 1 classes set WL61_HOME c bea61sp2 wlserver6 1 3 Set this in order to be able to access your WebLogic Server 7 0 classes set WL_HOME c bea700 weblogic700 checkJRE if exist JAVA_HOME lib nul...

Page 144: ...1_HOME config examples serverclasses 5 Set the CLASSPATH to point to old classes and to new classes that you need echo CLASSPATH CLASSPATH rem original JAVA_HOME bin java hotspot ms64m mx64m rem classpath CLASSPATH Dweblogic Domain examples rem Dweblogic Name examplesServer Dbea home C bea61sp2 rem Dcloudscape system home rem samples eval cloudscape data rem Djava security policy C bea61sp2 wlserv...

Page 145: ...Start 2 Choose Programs 3 Choose BEA WebLogic E Business Platform 4 Choose WebLogic Server 7 0 5 Choose Examples 6 Choose Start Examples Server 7 Watch for the Out of the Box Examples Index Page Or 1 In Windows Explorer go to the SAMPLES_HOME server config examples directory 2 Double click the startExamplesServer icon 3 Watch for the Out of the Box Examples Index Page On UNIX Bourne shell 1 cd SAM...

Page 146: ...B Upgrading the Pet Store Application and the Examples Server B 40 BEA WebLogic Server 7 0 Upgrade Guide ...

Reviews: