Performing Post-Installation Tasks

 

After you have completed the installation process and verified your installation, complete the post-installation tasks in the following sections to ensure that WebLogic JAM operates properly.

• Updating Your license.bea File

• Deploying WebLogic JAM in the WebLogic Server Environment

 

---

Updating Your license.bea File

You must update your license.bea file if at least one of the following is true:

• You are downloading the 60-day extension to your 30-day evaluation period of WebLogic JAM.

• You installed WebLogic JAM from the CD-ROM.

• You possess a non-expiring license file for a previous version of WebLogic JAM, and you want to upgrade to a WebLogic JAM license after downloading WebLogic JAM from the BEA Web site.

In each case, you receive a license update file in an e-mail attachment. Update your license.bea file by performing the following steps for your system.

Updating Your license.bea File on a Microsoft Windows System

To update your existing license.bea file on a Microsoft Windows system follow these steps:

1. Log in to the Microsoft Windows system.

2. Save the license update file that you received through e-mail with a name other than license.bea in the target BEA Home directory.

3. Open a command prompt window.

4. Navigate to the target BEA Home directory.

5. Include the path to the JDK at the front of your PATH. Note the following example:

   set PATH=.\jkd131\bin;%PATH%

6. Merge the license update file into your existing license by entering the following command:

   UpdateLicense license_update_file

   license_update_file is the name to which you saved the license update file that you received through e-mail. Running this command updates your license.bea file.

7. Save a copy of your license.bea file in a safe place outside the WebLogic JAM product directory. Although no one else can use your license file, you should save this information in a place protected from either malicious or innocent tampering by others.

Updating Your license.bea File on a Unix System

To update your existing license.bea file on a Unix system, follow these steps:

1. Log in to the Unix system.

2. Save the license update file that you received through e-mail with a name other than license.bea in the target BEA Home directory.

3. Open a command prompt window.

4. Navigate to the target BEA Home directory.

5. Include the path to the JDK at the front of your PATH. Note the following example:

   PATH=./jkd131/bin;$PATH

   export PATH

6. Merge the license update file into your existing license by entering the following command:

   sh UpdateLicense.sh license_update_file

   license_update_file is the name to which you saved the license update file that you received through e-mail. Running this command updates your license.bea file.

7. Save a copy of your license.bea file in a safe place outside the WebLogic JAM product directory. Although no one else can use your license file, you should save this information in a place protected from either malicious or innocent tampering by others.

 

---

Deploying WebLogic JAM in the WebLogic Server Environment

After WebLogic JAM has been installed, it must be deployed in the WebLogic Server environment. The following tasks must be completed if you are not running a pre-configured sample.

You can deploy WebLogic JAM in the following ways:

• If you are creating applications, the example domain and the verify domain are examples of domains deployed in the WebLogic Server environment. You may want to use these domains as a starting point, adding other J2EE applications to meet your specific requirements.

• If you are adding WebLogic JAM to existing WebLogic Server applications, you need to manually deploy WebLogic JAM by completing the following steps:

  • Adding the jam.jar File to the WebLogic Server CLASSPATH

  • Deploying the jam.ear File

  • Defining the WebLogic JAM Startup Class

Adding the jam.jar File to the WebLogic Server CLASSPATH

The jam.jar file adds classes to the WebLogic Server CLASSPATH. The jam.jar file must be added to the CLASSPATH in the WebLogic Server startup script for each server where it will run.

To manually add the jam.jar file to the WebLogic Server CLASSPATH, perform the following steps:

1. Using the text editor of your choice, locate the script you use to start WebLogic Server in your domain. For example, use the startWebLogic script in your config/mydomain directory mydomain is the name of your domain.

   • For example, on a Microsoft Windows platform, use your startWebLogic.cmd script in your config\mydomain directory where mydomain is the name of your domain and startWebLogic.cmd is the script to start WebLogic Server.

   • For example, on a Unix platform, use your startWebLogic.sh script in your config/mydomain directory where mydomain is the name of your domain and startWebLogic.sh is the script to start WebLogic Server.

2. Edit the startWebLogic script by adding the jam.jar file to the CLASSPATH setting as shown in the following examples:

   • For Microsoft Windows:

     set CLASSPATH=.;.\lib\weblogic_sp.jar;
     .\lib\weblogic.jar;e:\bea\wljam5.0\lib\jam.jar

     In this example, e:\bea\wljam5.0 is the install directory for WebLogic JAM.

   • For Unix:

     CLASSPATH=$WL_HOME:$WL_HOME/lib/weblogic_sp.jar:$WL_HOME/lib/weblogic.jar:./ext/weblogic-tags.jar:/bea/wljam5.0/lib/jam.jar

     In this example, /bea/wljam5.0 is the install directory for WebLogic JAM.

3. Save the file and close the text editor.

Deploying the jam.ear File

The jam.ear file deploys the WebLogic JAM applications and the WebLogic JAM extension to the WebLogic Administration Console. This file contains the following EJBs:

• jambeans

• jamtojms

• jam.war (for the console)

Deploy the jam.ear file on the appropriate servers using the WebLogic Administration Console. To manually deploy the jam.ear file, perform the following steps:

1. In the WebLogic Administration Console, select Deployments—>Applications to invoke the Applications page. Click on Install a new Application.

 

2. Click Browse to locate the jam.ear file in wljam5.0\lib directory. Click Upload.

 

Note: The Path field and the Browse button specify directories and files relative to the computer that the browser is running on.

The following screen displays. The jam.ear file has been uploaded and WebLogic JAM applications and components are available in the left pane of the WebLogic Administration Console. The application files that have been installed are listed in the lower part of the right pane.

 

Defining the WebLogic JAM Startup Class

The WebLogic JAM startup class defines a class that is launched at WebLogic Server startup. To manually define the WebLogic JAM startup class using the WebLogic Administration Console, perform the following steps:

1. In the WebLogic Administration Console, select Deployments—>Startup & Shutdown to invoke the Startup & Shutdown page.

2. Click on Configure a new Startup Class to invoke the Create a new Startup Class page.

3. Fill in the fields.

   1. Assign a name for the Name field.

   2. The ClassName must be com.bea.jam.GatewayStartup.

4. Click Create to create the new startup class.

 

5. Select the Targets tab. Select the target server from the available list and click the arrow to add it to the chosen list. Click Apply to apply the new startup class.

See the BEA WebLogic Java Adapter for Mainframe Configuration and Administration Guide for additional information about deploying WebLogic JAM.