---

Contents

Before You Begin
System Requirements
Installing the iPlanet Application Server Integration Tool for VisualCafé^TM
Installing the Remote Debugging Services
Uninstalling
Related Documentation

---

Before You Begin

Before you install the iPlanet Application Server Integration Tool for VisualCafé Enterprise Edition version 4.1 or WebGain Studio version 4.1, you must:

• Install iPlanet Application Server version 6.0 Service Pack 2. This in turn requires a web server such as iPlanet Web Server (Enterprise Edition) version 4.1.
• Install VisualCafé Enterprise Edition version 4.1 or WebGain Studio version 4.1.

---

System Requirements

The hardware and software requirements for installing and running the iPlanet Integration Tool for VisualCafé are as follows:

• Operating system: Intel Pentium microprocessor running Microsoft Windows NT version 4.0 with Service Pack 5.
• Memory: 128 MB minimum; 256 MB recommended.
• Available disk space: 10 MB.
• Web Server: iPlanet Web Server (Enterprise Edition) version 4.1.
• Application Server: iPlanet Application Server Version 6.0 Service Pack 2.
• Browser: A browser must be installed. Netscape Communicator 4.74 was used for certification.

---

Installing the iPlanet Application Server Integration Tool for VisualCafé

1. Exit VisualCafé Enterprise Edition or WebGain Studio.
2. Launch the install.exe.
3. Select Yes to accept the license agreement.
4. Select Install.

   The installer modifies the initialization files of VisualCafé and copy the Integration Tool files and documentation. If a file is in use, you are asked to reboot.

5. Select OK to end the installer.

The Integration Tool documentation is installed in <VisualCaféInstallDirectory>/iASVCPlugin.

---

Installing the Remote Debugging Services

To install on a Windows NT system with VisualCafé Enterprise Edition installed:

• In the System environment settings set the CLASSPATH as follows:

d:\iplanet\ias6\ias\lib\java\kfcjdk11.jar;
d:\iplanet\ias6\lib\java\jdbc20.jar; 
d:\iplanet\ias6\ias\lib\java\javax.jar;
d:\iplanet\ias6\ias\usr\java\jre\lib\ext\iioprt.jar

To install on a Windows NT system without VisualCafé Enterprise Edition installed:

1. From the VisualCafé CD, or from the <VisualCaféInstallDirectory>/Platforms directory, copy vcdbg_generic_1.2.exe to the target system.
2. Execute the vcdbg_generic_1.2.exe file.
3. In the System environment settings, set the CLASSPATH as follows:

   d:\iplanet\ias6\ias\lib\java\kfcjdk11.jar; 
   d:\iplanet\ias6\lib\java\jdbc20.jar; 
   d:\iplanet\ias6\ias\lib\java\javax.jar; 
   d:\iplanet\ias6\ias\usr\java\jre\lib\ext\iioprt.jar;
   

To install on a Solaris system:

1. From the VisualCafé CD, or from the <VisualCaféInstallDirectory>/Platforms directory, copy vcdbg_generic_1.2.tar to the target system.
2. From a shelltool type the command: tar xvf vcdbg_generic_1.2.tar
3. Copy the following files to the following locations inside the <ApplicationServerInstallDirectory>/ias/usr/java directory.

.ddagentsrc	bin\.ddagentsrc
ddservices	bin\ddservices
debugvm	bin\debugvm
vcdbg_generic_1.2.zip	lib\vcdbg_generic_1.2.zip
vcdbg_distdbg12.jar	jre\Lib\ext\vcdbg_distdbg12.jar
sfc.jar	jre\Lib\ext\sfc.jar

4. Inside the <ApplicationServerInstallDirectory/ias/bin directory, copy kjs to kjsdebug.
5. Edit kjsdebug and change the last line $GX_ROOTDIR/bin/.kjs $opts to debugvm.

These instructions set up the Java Virtual Machine^TM (JVM) shipped with the Application Server for remote debugging. Since the Application Server is using the optimized or production Solaris JVM, some debugging features are not supported by VisualCafé. If you want to enable these features, you can:

1. Install the Solaris Java Developer's Kit^TM 1.2 (JDK) reference version.
2. Install the VisualCafé files and alter the debugkjs script to use this JVM.

---

Configuring for an EJB Client Component

When you create an EJB in VisualCafé, two projects are created:

• The EJB deployed on a J2EE application server.
• A simple client project that accesses the EJB using RMI/IIOP.

To access the client co-project when the EJB is deployed on the Application Server:

1. Configure the iPlanet Application Server to support RMI/IIOP access to hosted EJBs.
2. Configure VisualCafé to use the ORB supported by the iPlanet Application Server.
3. Alter the project to address the Application Server.

The first configuration of the server and VisualCafé only need to be done once. The project must be altered for each new client co-project you wish to use.

Configuring the Application Server for RMI/IIOP Access to Hosted Beans

The iPlanet Application Server does not support RMI/IIOP access in its default configuration. The steps required to enable this support are discussed in detail in the document at: http://developer.iplanet.com/appserver/samples/j2eeguide/docs/converter.html.

To Configure the Application Server for RMI Access:

1. Verify the IIOP Port Number of the cxs process.
2. Start the iPlanet Application Server Administration Tool.
3. Connect to the server instance.
4. If the server does not have a cxs process associated with it, create one.

   To create the cxs processs:

   1. Select a process on the server. For example, kjs.
   2. From the File menu, select New Process.
   3. From the listed process types, select cxs.
   4. Enter a new (unused) Port Number for the process and the IIOP Port.
   5. Verify that the server has started the cxs process by using the ps command, or via the Windows Task Manager.

5. Alter the Application Server CLASSPATH as follows:
   1. Start regedit.
   2. Navigate to the following key: HKEY_LOCAL_MACHINE->SOFTWARE->iPlanet->Application Server->6.0->Java->ClassPath.
   3. Edit the value to include the following, as the first element: <ApplicationServerInstallDirectory\ias\APPS\rmi-classes
   4. Restart the server, using the services control.

Configuring VisualCafé to Use the ORB

The iPlanet Application Server is tested against a standardized ORB to reduce the support overhead associated with RMI/IIOP. These instructions provide the details of configuring VisualCafé to use this ORB for use by the client co-project.

To Configure for the Application Server ORB:

1. Create a new directory named Java2.orig that is a sibling to the Java2 directory in the VisualCafé installation directory.
2. Copy the contents of the Java2 diretory into this new directory.

   Copy the files from: <ApplicationServerInstallDirectory>\ias\usr\java\jre\lib\ext
   to <WebGainInstallDirectory>\Java2\lib\ext

3. Be sure to include the i386 directory.
4. Copy the file <VisualCaféInstallDirectory>\Java2\lib\ext\orb.properties
   to <VisualCaféInstallDirectory>\Java2\lib\

5. Copy the file: <ApplicationServerInstallDirectory>\ias\classes\java\iasclient.jar
   to <VisualCaféInstallDirectory>\Java2\lib\ext

6. Copy the file: <ApplicationServerInstallDirectory>\ias\lib\java\javax.jar
   to <VisualCaféInstallDirectory>\Java2\lib\ext

After completing these tasks, the defined Java2 JVM will use the iPlanet Application Server supported ORB.

Enabling RMI/IIOP accesss to an Enterprise Java Bean

Before an EJB can be accessed via RMI/IIOP, the Enterprise bean must be configured to support IIOP.

To Configure an EJB for IIOP:

1. From within the VisualCafé Project menu, select Configure Deployment Descriptor.

   The Deployment Descriptor configuration dialog appears.

2. Select the Bean you wish to access via RMI/IIOP, from the list on the left side of this dialog.
3. Select the Target Options tab.
4. Select the General sub-tab.
5. Select the checkbox labeled IIOP.

Delivering Enterprise Beans to an EJB Server

To enable access to an EJB deployed on the Application Server, the EJB JAR needs to be exploded into the RMI classes directory that was created as part of the server configuration:

• From the Project menu, select Deliver Enterprise Bean to EJB Server to deploy the JAR file to the server.

  The JAR file is located in the ias\JAR directory.

Once the EJB JAR file is deployed, it is ready to be expanded.

To Expand the EJB JAR file:

1. Change your default directory to the RMI classes directory by typing: cd <ApplicationServerInstallDirectory>\ias\APPS\rmi-classes
2. Expand the deployed EJB JAR by typing: jar -xf <ApplicationServerInstallDirectory>\ias\JAR\SalesEnterpriseBean.jar

   After the EJB JAR file is deployed and expanded, the server side of the configuration is complete.

To Configure Client Access to the EJB:

• From the Project menu, select Options.
• Select the Directories tab.
• Select Native Libraries from the combobox at the top of the panel.
• Enter the following Native Libraries directory location: <VisualCaféInstallDirectory>\Java2\lib\ext\i386
• Select Input Class Files and enter the path: <ApplicationServerInstallDirectory>\ias\APPS\rmi-classes
• Select the Project tab.
• In the Program Arguments text field, enter an identifier for the cxs process IIOP Port, for example: "iiop://" <HostName> ":" <cxs process IIOP port>
• Select OK.
• Add the following line to the import section of the client project's java code: import javax.rmi.PortableRemoteObject;
• Modify the ctx.lookup function call as follows:

  Object tmp = ctx.lookup("ejb/<EJB name>");
  <EJB name>Home home = (<EJB name>Home) PortableRemoteObject.narrow(tmp,<EJB name>Home.class);
  

• Change the line p.put(Context.INITIAL_CONTEXT_FACTORY,""); to p.put(Context.INITIAL_CONTEXT_FACTORY, "com.sun.jndi.cosnaming.CNCtxFactory");
• From the Project menu, select Execute to access the methods of the deployed bean.

---

Uninstalling the iPlanet Integration Tool

To uninstall version 1.1:

1. Exit VisualCafé.
2. Remove the <VCEE>\Bin\Components\iplanet_wg.jar file.
3. Remove the <VCEE>\Bin\ksdebrowser.dll file.
4. From a text editor, open the <VCEE>\BIN\sc.ini file and remove the following line:

   CLASSPATH=%CLASSPATH%;%@P%\Components\iplanet_wg.jar; 
   d:\iplanet\ias6\ias\lib\java\naf.jar;d:\iplanet\ias6\ias\lib\java\kfcjdk11.jar; 
   d:\iplanet\ias6\ias\lib\java\ktjdk11.jar;d:\iplanet\ias6\ias\classes\java\xml.jar;
   

5. From a text editor, open the <VCEE>\BIN\sb\plugin\ejb.ini and remove the following line:

   deploy=com.iplanet.ias.integ.webgain.IPlanetAppServerDT
   

6. Remove the documentation directory <VCEE>\iASVCPlugin.

---

Related Documentation

The iPlanet Third Party Tools Integration documentation can be found at: http://docs/iplanet.com/docs/manuals/ide Select the Visual Cafe WebGain link to access the latest documentation including:

• The Session EJB Tutorial.
• The CMP EJB Tutorial.
• The Menu Reference.
• The most up-to-date Release Notes.

---

Copyright ©2000, Sun Microsystems Inc. All rights reserved.
Copyright © 2000, Netscape Communications Corporation. All rights reserved.

Sun, Sun Microsystems, the Sun logo, Java, iPlanet, and the Sun, Java, and iPlanet-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries.

Netscape and the Netscape N logo are registered trademarks of Netscape Communications Corporation in the U.S. and other countries. Other Netscape logos, product names, and service names are also trademarks of Netscape Communications Corporation, which may be registered to other countries.