5
Oracle BC4J Migration

This chapter explains the process of migrating Oracle BC4J (Business Components for Java) applications from Oracle BC4J version 3.1 to 3.2 in Oracle9i Application Server 1.0.2.

Oracle Internet Application Server Releases 1.0.0 and 1.0.1 are compatible with Oracle BC4J 3.1 while Oracle9i Application Server 1.0.2 is compatible with Oracle BC4J 3.2.1. Also note that Oracle BC4J 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.

Contents

• Pre-migration

• Environment

• Configuration

• Application Logic

• Tools

Pre-migration

No pre-migration tasks are necessary.

Environment

No environment migration tasks are necessary.

Configuration

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

To configure servlets or JSPs to work with Oracle BC4J 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 BC4J components:

1. Open <NEW_HOME>/Apache/Jserv/etc/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/<projectName>client.jar

   • wrapper.classpath=<NEW_HOME>/Apache/BC4J/lib/<projectName>common.jar

   to the end of the jserv.properties file, where <projectName>client.jar is the business components client archive for the project and <projectName>common.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 the file 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.