Migration Tutorial Overview

prevnext

Migrating the Banking Application to WebLogic Server 6.x

 

Some of the tasks involved in migrating the application are performed by a conversion utility. This section shows how to use the conversion utility, and then describes the migration tasks that have not been automated. Main steps in the migration are:

Note: If you are migrating to WebLogic Server 6.1, you should be aware that in WebLogic 6.1 changes and configurations made to applications in the /config/domain_name/applications directory, which is intended for use as an auto-deploy directory, are not permanently saved in the config.xml file as they were in WebLogic Server 6.0. Changes and configurations made in this directory are persisted for the current runtime only.

Start the Examples Server

1. Open a DOS window or Unix console, navigate to to %WL_HOME%\config\examples and enter the following:
startexamplesserver
 2. In a Web browser, navigate to
http://localhost:7001/console/

Access the Conversion Utility

When you have opened the console, click the Convert weblogic.properties link under the Getting Started heading to navigate to the conversion tool interface.

For information about using the Administration Console, see Administration Console Online Help.

Specify Files to Be Converted

The conversion utility interface consists of two pages that contain graphical directory structures in which you can select the WebLogic Server 5.1 root directory and the subdirectories that contain the weblogic.properties files of the servers or clusters to be migrated.

1. In the first page of the conversion utility interface ("Locate your weblogic root"), click the icon to select the WebLogic Server 5.1 root directory, which contains the global weblogic.properties.
 The second page of the conversion utility ("Identify clusters and servers") will display.
 2. The second page of the conversion utility lists directories and instructs you to choose the location of the folder from your WebLogic Server 5.1 installation that contains the cluster-specific or server-specific file weblogic.properties. Choose the migrationserver directory.
3. Still in the second page of the conversion utility, enter a name for the application's new domain on WebLogic Server 6.x. For this example, enter migrationdomain.
4. At the bottom of the second page of the conversion utility, click the "Convert" button.
The conversion utility will use the properties specified in the the weblogic.properties file to convert the WebLogic Server 5.1 banking application to a WebLogic Server 6.x banking application.
 The converted application will have the same password and behavior it had before the conversion.

View Results of Conversion Utility

If you correctly select the folders on the two successive pages, the conversion tool will perform the conversion and display a message on a third page, reporting on the conversion.

The following is sample output from the WebLogic Server 6.0 conversion. 

New Domain name is migrationdomain

*************************************

Server Name is migrationserver

This server doesn't belong to any cluster 

*************************************

Converting Server properties

Warning--- File democert.pem not found has to be copied under config/migrationdomain/migrationserver directory

Warning-- File ca.pem not found has to be copied under config/migrationdomain/migrationserver directory

Warning-- File demokey.pem not found has to be copied under config/migrationdomain/migrationserver directory

Converting Server Debug Properties

Converting WebServer properties

Converting WebApp Component Properties

Converting JDBC Specific properties

Converting CORBA IIOP properties

Converting EJB Specific Properties

Converting StartupClass properties

Converting Shutdown Class properties

Converting MailSession Properties 

Converting FileT3 properties

Converting JMS properties

Converting Security Properties 

Converting the PasswordPolicy properties

Converting User Group and ACL properties

Creating webApp for the servlets registerd in the properties file

Startup Scripts for the Server are created in the ResultDir config/migrationdomain

Conversion successful.

Set the Environment Variables for the New Domain

Edit the startmigrationdomain command--located in the WL6x_HOME\samples\examples\tutorials\migration\banking directory--to reflect file locations in your directory structure.

1. Make sure that JAVA_HOME specifies the appropriate JDK in the startmigrationdomain script.
 2. Edit the following lines in the startmigrationdomain script to reflect the location of your your WL6x_HOME directory:
 

set APPLICATIONS=%WL6x_HOME%\config\migrationdomain\applications 

set CLIENT_CLASSES=%WL6x_HOME%\config\migrationdomain\clientclasses 

set SERVER_CLASSES=%WL6x_HOME%\config\migrationdomain\serverclasses 

set BANKING_WEBAPP_CLASSES=%WL6x_HOME%\config\migrationdomain\applications\Default WebApp_migrationserver\WEB-INF\classes 

set CLOUDSCAPE_CLASSES=%WL6x_HOME%\samples\eval\cloudscape\lib\cloudscape.jar

3. Append the following variables to the startmigrationdomain CLASSPATH.
 

CLASSPATH=...%APPLICATIONS%;%CLIENT_CLASSES%;%SERVER_CLASSES%;%BANKING_WEBAPP_CLASSES%;%CLOUDSCAPE_CLASSES%

4. Add the following setting to the startmigrationdomain command, making sure to add it before the final "weblogic.Server":
 

-Dcloudscape.system.home=WL51_HOME\eval\cloudscape\data

Copy the Application, Graphics and Class Files to the New Domain

Copy files from the old WebLogic Server 5.1 installation to the new WebLogic Server 6.x installation. In the instructions below, WL51_HOME means your source WebLogic Server 5.1 root directory, and WL6x_HOME means your target WebLogic Server 6.x root directory.

Application Files

Copy the following files:

from:

WL51_HOME\migrationserver\public_html

to:

WL6x_HOME\config\migrationdomain\applications\DefaultWebApp_migrationserver

Graphics File

1. Create a directory WL6x_HOME\config\migrationdomain\applications\DefaultWebApp_migrationserver\images.
2. To this new directory, copy BEA_Button_Final_web.gif from WL51_HOME\migrationserver\public_html\images.

Class Files

Copy the servlet class files

To WL6x_HOME\config\migrationdomain\applications\DefaultWebApp_migrationserver\WEB-INF\classes, copy the directory and contents of WL51_HOME\migrationserver\servletclasses\examples.

Copy the server class files

To WL6x_HOME\config\migrationdomain\, copy the directory and contents of WL51_HOME\migrationserver\serverclasses.

Copy the client class files

To WL6x_HOME\config\migrationdomain\, copy the directory and contents of WL51_HOME\migrationserver\clientclasses.

Run the Migrated Application

To run the sample application:

1. Run startmigrationdomain in the WL_HOME\config\migrationdomain directory. For more information about starting WebLogic 6.x Servers, see Starting and Stopping WebLogic Servers.
 2. Enter the following URL in your Web browser's address field:

http://localhost:7001/login.html

prevnext

 
Copyright © 2001 BEA Systems, Inc. All rights reserved.
Required browser: Netscape 4.0 or higher, or Microsoft Internet Explorer 4.0 or higher.