7 - C H A P T E R -

C H A P T E R 7

Using Other Application Servers With the Forte for Java 4 IDE

Once you have successfully installed the IDE and validated the IDE installation by creating a simple J2EE application (see for more information), you can use other application servers with the IDE.

This chapter contains information about using the BEA WebLogic Server 6.1 as the default application server for applications you develop with the Forte for Java 4 IDE.

Note - You must first download the WebLogic Server Plug-in module from the Update Center before you can proceed with the rest of this chapter. See Updating Modules With the Update Center for information on how to download Forte for Java 4 modules. In the Update Center wizard, expand the Enterprise Edition Modules node to locate the WebLogic Server Plug-in module.

Setting Up the WebLogic Environment

Note - WebLogic Server 6.1 requires version 1.3.1 of the Java runtime environment (JRE). You must run the IDE with JRE 1.3.1 if you intend to deploy applications to the WebLogic Server 6.1. Do not run the IDE and WebLogic Server 6.1 with the J2SE, v. 1.4 platform or the JRE, v. 1.4.

The WebLogic Server 6.1 must be running before you can deploy an application to it. However, before you start the application server, you must ensure that the WebLogic environment is set up correctly.

Note - If you deploy a J2EE application client to WebLogic Server 6.1, WebLogic must be able to download its XML document definitions from the WebLogic web site. If your connection to the web requires a proxy server, make sure that you specify this setting in the IDE before deploying an application to the WebLogic server. To set the proxy server, choose Tools right arrow Setup Wizard and specify your proxy and web browser settings in the General Forte for Java Settings pane of that wizard.

Setting Up the WebLogic Environment in a Solaris Operating Environment

Follow these steps to set up the WebLogic environment in your Solaris operating environment:

1. Shut down the IDE.

2. From a command window, ensure that you have a Bourne shell session.

If you do not yet have a Bourne shell session, type the following command:

% sh

3. Run the WebLogic environment setup script.

Type the following at the command prompt to run the setEnv.sh script:

$ . WebLogicHomeDirectory/config/Domain/setEnv.sh

For example, if your WebLogic home directory is /bea/wlserver6.1 and your domain is mydomain, you would type the following command:

$ . /bea/wlserver6.1/config/mydomain/setEnv.sh

4. Start the Forte for Java 4 IDE.

In the same terminal window where the WebLogic environment was just set up, type the following:

$ ffj-install-dir/bin/runide.sh

Setting Up the WebLogic Environment on a Microsoft Windows System

If you installed WebLogic as a Microsoft Windows service, the server starts whenever you restart Microsoft Windows. You do not need to start explicitly with the script. If you did not install WebLogic as a Microsoft Windows service, follow these instructions:

1. Shut down the IDE.

2. Run the WebLogic environment setup script.

At a command prompt, type the following:

C:\>WebLogicHomePath\config\Domain/setEnv.cmd

For example, if your WebLogic home is c:\bea\wlserver6.1 and your domain is mydomain, you would type the following command:

C:\> \bea\wlserver6.1\config\mydomain\setEnv.cmd

3. Start the Forte for Java 4 IDE.

In the same command window where the WebLogic environment was just set up, type the following:

C:\>cd ffj-install-dir\bin

C:\ffj-install-dir\bin>runidew.exe

Configuring the BEA WebLogic Server 6.1 as the Default Application Server

You must install and start the BEA WebLogic Server 6.1 before you can use it with the IDE.

Note - The BEA WebLogic Server 6.1 SP2 has been certified with this release of the Forte for Java 4 IDE and is certified only to run with the Java 2 SDK, v. 1.3.1 software.

Note - There is a known problem in deploying web services developed with the Forte for Java 4 IDE to the BEA WebLogic 6.1 Server. The fix requires a patch to the WebLogic server. You will not be able to deploy web services from the IDE to WebLogic 6.1 without the patch. WebLogic customers with BEA support contracts need to contact BEA Customer Support and request the patch for issue CR064391.

Follow these steps to make the BEA WebLogic 6.1 Server the default application server for applications you create and deploy in the IDE.

1. If you have not already done so, start the IDE.

See for instructions on how to start the IDE.

2. In the Explorer window, select the Runtime tab and expand the Server Registry/Installed Servers node.

You should see the WebLogic Server 6.1 node.

3. Right-click the WebLogic Server 6.1 node and choose Properties.

The property sheet for the WebLogic server appears.

4. Set the value for the WebLogic Home property.

a. Select the WebLogic Home property.

b. Type weblogic-install-dir/wlserver6.1. and close the property sheet.

5. Add a WebLogic server instance by right-clicking the WebLogic Server 6.1 node and choosing Add Server Instance.

6. Set the password value in the property sheet.

a. Right-click the WebLogic server instance you just created and choose Properties.

The property sheet for the instance appears.

b. Select the Password property and type the password you specified during the WebLogic server installation as the property's value.

c. Close the property sheet.

7. Right-click the WebLogic Server Instance 1 and choose Set As Default Application Server.

The WebLogic server is now the default application server used by the IDE.