5
Oracle Business Components for Java Migration

This chapter explains the process of migrating Oracle Business Components for Java (BC4J) applications from Oracle Business Components for Java version 3.1 to 3.2 in Oracle9i Application Server 1.0.2. Also note that Oracle Business Components for Java version 3.2 is backward compatible with the 3.1 version.

For local applications, JSPs, and servlets, no migration is necessary. You only need to add your application jar files to the jserv.properties file and ensure that they are in the CLASSPATH.

For remote applications, JSPs, and servlets you must perform the migration tasks described in this chapter.

The migration topics for this component are:

• Premigration

• Environment

• Configuration

• Application Logic

• Tools

Premigration

No premigration tasks are necessary.

Environment

No environment migration tasks are necessary.

Configuration

No migration steps are necessary for Oracle Business Components for Java applications that are deployed to the local Apache JServ CLASSPATH.

To configure servlets or JSPs to work with Oracle Business Components for Java applications deployed in the Oracle8i JVM, you must change your configuration files as explained in the following sections.

Setting the CLASSPATH

Set the Oracle9i Application Server CLASSPATH to connect to remotely deployed Oracle Business Components for Java components:

1. Open NEW_HOME\Apache\Jserv\conf\jserv.properties in a text editor.

2. Locate the block that begins with the comment:

   # Oracle Portal

3. In this block, locate the CLASSPATH settings for the BC4J. The following is the base set of CLASSPATH settings for BC4J that you will find in the file:

   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\ordvir817.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\ordim817.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\ordhttp.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jboremote.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\oraclexmlsql.jar
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jboorasql.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jndi.jar
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbomt.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\javax_ejb.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jdev-rt.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbodomorcl.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jboimdomains.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbohtml.zip
   wrapper.classpath=NEW_HOME\Apache\Apache\htdocs\OnlineOrders_html
   wrapper.classpath=NEW_HOME\Apache\Apache\htdocs\OnlineOrders_html\OnlineOrders.jar
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\connectionmanager.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbodatum12.zip
   #wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbodatum111.zip
   wrapper.classpath=NEW_HOME\Apache\BC4J\lib\oracle\ora81\sqlj\lob\runtime.zip
   
   

4. Depending on your business components deployment platform, add the following CLASSPATH lines. Remember to maintain the directory structure.

   CORBA Server Object to Oracle8i

   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbo8iclient.zip
   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jboo8i.zip

   EJB to Oracle8i

   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jboremoteejb.zip

   In addition, if you have business components client archives and common archives for your project, add the following lines:

   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\project_nameclient.jar
   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\project_namecommon.jar

   to the end of jserv.properties, where project_nameclient.jar is the business components client archive for the project and project_namecommon.jar is the business components common archive for the project.

   VisiBroker Bind Mode

   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbovbclient.zip
   • wrapper.classpath=NEW_HOME\lib\vbjorb.jar
   • wrapper.classpath=NEW_HOME\lib\vbjapp.jar

   VisiBroker with Naming Service

   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbovbclient.zip
   • wrapper.classpath=NEW_HOME\lib\vbjorb.jar
   • wrapper.classpath=NEW_HOME\lib\vbjapp.jar
   • wrapper.classpath=NEW_HOME\lib\vbjcosnm.jar

     Note: If you want to use the VisiBroker naming service, you'll need to copy vbjcosnm.jar from your JDeveloper_HOME\lib directory to your NEW_HOME\lib directory.

   VisiBroker Colocate Mode

   • wrapper.classpath=NEW_HOME\Apache\BC4J\lib\jbovbclient.zip
   • wrapper.classpath=NEW_HOME\lib\vbjorb.jar
   • wrapper.classpath=NEW_HOME\lib\vbjapp.jar
   • wrapper.classpath=NEW_HOME\lib\vbjcosnm.jar

Application Logic

No application logic migration tasks are necessary.

Tools

No tools migration tasks are necessary.