[Top] [Prev] [Next] [Bottom]

WLE (Java) Installation on Microsoft Windows NT Systems

This chapter discusses the following topics:

Platforms Supported

Microsoft Windows NT is the only Windows platform supported for this release of WLE (Java).

For the hardware and software requirements for Microsoft Windows NT, see Appendix B, "WLE (Java) Platform Data Sheets."

Installing the WLE (Java) Software on Microsoft Windows NT Systems

The installation procedure includes the following:

  1. Downloading and installing the Java Development Kit (JDK) 1.2.1 software from the Sun Microsystems, Inc. Web site. If you are installing the Client Only WLE (Java) software component, skip this step.

  2. Downloading and installing the idltojava compiler from the Sun Microsystems, Inc. Web site. If you are installing the Client Only WLE (Java) software component, skip this step.

  3. Choosing one of the following two WLE (Java) components to install:

    Installs the complete client and server WLE (Java) software

    Installs a client-only subset of the WLE (Java) software

For more information about the differences between these two components, see the section titled "WLE (Java) Software Components" on page 6-2.

  1. Downloading the Java Runtime Environment (JRE) software from the Sun Microsystems Inc. Web site. You perform this step only if you are installing the Client Only WLE (Java) software component, and you are not downloading the JDK 1.2.1 software.

  2. Setting environment variables on your system.

  3. Running simpapp_java to verify the installation.

The following sections discuss these steps in detail.

Downloading and Installing the JDK 1.2.1 Software

If you are installing the WLE (Java) Full System software component, you also need to download and install the JDK 1.2.1 software from the Sun Microsystems, Inc., Web site. (If you are installing the Client Only software, skip this section and go to the section titled "Installing the WLE (Java) Software" on page 7-4.)

To download and install the JDK 1.2.1 software:

  1. Open your Web browser and enter the following URL: 

    http://www.javasoft.com/products/index.html

The Sun Microsystems, Inc. Web site specified in the above URL provides links to the JDK 1.2.1 software kit for NT systems and also to complete installation instructions.

  1. Follow the instructions for installing the JDK 1.2.1 software, which are available at the preceding URL.

Downloading and Installing the idltojava Compiler

If you are installing the WLE (Java) Full System software component, you need to download and install the Sun Microsystems, Inc. idltojava compiler to build WLE (Java) client and server applications. (If you are installing the Client Only software, skip this section and go to the section titled "Installing the WLE (Java) Software" on page 7-4.)

To download and install the idltojava compiler:

  1. Open your Web browser and enter the following URL: 

    http://java.sun.com/marketing/enterprise/jidl.html

    Note: If you are not a member of the Java Developer Connection, you will be prompted to join. There is no fee to join. After you join, you will be allowed to access the Web page.

  2. Follow the installation instructions provided at the preceding URL. When you are prompted for a folder, direct the load to the wledir\bin folder. For example, if you installed the WLE (Java) software in the default location, direct the download to C:\wledir\bin. When the download completes, you will have a file named idltojava-ea-win32.exe.

  3. Double click the file idltojava-ea-win32.exe, which is a self-extracting file that places the idltojava compiler in a folder named idltojava-win32. The idltojava-win32 folder is created by default under wledir\bin.

  4. Add to your path the folder that contains the idltojava compiler.

Installing the WLE (Java) Software

Note: Before beginning the installation, make sure that the BEA WLE (C++) v4.2 Full System software is installed on the machine, and use the tmshutdown command to shut down any running WLE or BEA TUXEDO applications.

Note: It takes approximately 5 minutes to install the software.

To install the WLE (Java) software on a Microsoft Windows NT system, perform the following procedure:

  1. To ensure all BEA TUXEDO and WLE applications, servers, and services are shut down, execute the tmshutdown command on every running BEA TUXEDO and WLE application.

  2. Insert the CD labeled WLE (Java) 4.2 in the CD reader and use the Microsoft Windows NT taskbar to click Start->Programs->Windows NT Explorer.

  3. Click the CD drive and then click the Winnt folder.

  4. Double click the setup.exe program.

The Setup screen is displayed.

.

  1. After the Setup screen displays, the Welcome screen is displayed.

  2. Click Next. The Software License Agreement screen is displayed.

  3. To accept the license agreement, click Yes.

The Select Components screen is displayed, allowing you to choose which WLE (Java) software component you want to install: the Full System component, or the Client Only component. For a description of the differences between these two components, see the section titled "WLE (Java) Software Components" on page 6-2.

  1. Choose the kit you want to install and click Next.

If you are installing the Client Only component, skip the remainder of this section and go to the section "Installing the Java Runtime Environment (JRE)" on page 7-8.

The Setup Complete screen is displayed.

  1. Click Finish to complete the installation.

Installing the Java Runtime Environment (JRE)

The Client Only kit requires, as a minimum, the JRE. If you already have the JRE, or the JDK 1.2.1 software, installed on your machine, you can skip this step in the installation procedure.

To download and install the JRE software:

  1. Open your Web browser and enter the following URL: 

    http://www.javasoft.com/products/index.html

The Sun Microsystems, Inc. Web site specified in the above URL provides links to the JRE software kit for NT systems and also to complete installation instructions.

  1. Follow the instructions for installing the JRE software, which are also available at the preceding URL.

Setting Environment Variables on Your Windows NT System

Before you use the WLE (Java) software, you need to set three environment variables: JAVA_HOME, PATH, and CLASSPATH.

To set these variables, perform the following procedure:

  1. Click the Microsoft Windows NT Start button, and click
    Settings->Control Panel->System->Environment.

The System Properties window is displayed.

  1. Enter the following environment variables as user variables:

    Note: For instructions on how to set environment variables, click the Microsoft Windows NT Start button, click Help, and enter environment variables on the Index tab.

  2. Click Apply and OK to close the System Properties window.

Running the Java simpapp Sample Application to Verify the Full System Software Installation

If you have installed the WLE (Java) Full System software component, you can verify that the installation has been successful by executing the Java simpapp sample application. This "simple Java application" is a WLE (Java) client/server application that converts strings to uppercase and lowercase letters.

To run the simpapp application, open an MS-DOS window and perform the following steps:

  1. Create a directory under WLEDIR and copy the content of the simpapp_java directory to it. If you installed the WLE (Java) software in the default directory, the simpapp_java directory is located at C:\WLEDIR\Samples\Corba\simpapp_java.

  2. Change (cd) to the copy directory.

  3. Check the permissions on all the files in the copy directory and, if necessary, change the permissions to allow full access. To set permissions to full access, enter the following: 

    attrib -r *.*

  4. To run the simpapp application automatically, enter runme. The simpapp_java application runs, and prints the following messages:

Testing simpapp
cleaned up
prepared
built
loaded ubb
booted
ran
shutdown
saved results
PASSED

  1. To run the simpapp application manually to observe the processes starting and stopping, perform the following steps:

    1. Enter results\setenv.

    2. Enter tmboot -y. The application starts several processes.

    3. Enter the following: 

      java -DTOBJADDR=%TOBJADDR% SimpleClient

    The prompt String? is displayed.

    1. Enter a word in lowercase letters. The application converts the word to uppercase letters and then to lowercase letters.

    2. Enter the following: 

      tmshutdown -y

    The application shuts down the processes.

  2. To restore the copy directory to its original state, enter the following:

    1. results\setenv

    2. nmake -f makefile.nt clean

Running the Java simpapp Sample Application to Verify the Client Only Software Installation

If you have installed the WLE (Java) Client Only software component on your machine, you can verify that the installation has been successful by running the client component of the Java simpapp application.

To run the client component of the Java simpapp application:

  1. Make sure the server component of the simpapp application is running by checking the following:

  2. Copy the file SimpleClient.jar from the copy directory on the server machine identified in step 1 above to the client machine.

  3. On the client machine, verify that the CLASSPATH environment variable specifies both the SimpleClient.jar file and the following file: 

    $TUXDIR\udataobj\java\jdk\m3envobj.jar

  4. On the client machine, open an MS-DOS window and enter the following command: 

    simpapp: java -DTOBJADDR=//server-host:port# SimpleClient

In the preceding command line, server-host represents the name of the server machine (that is, the machine on which the WLE (Java) Full System software has been installed), and port# represents the port number of the IIOP Server Listener/Handler of the server machine.

The prompt String? is displayed.

  1. Enter a word in lowercase letters. The application converts the word to uppercase letters and then to lowercase letters.

Removing (Uninstalling) the WLE (Java) Software from Your System

To remove the Java software from your system, proceed as follows:

  1. Log on to the system as the administrator or as a member of the Administrator group.

  2. Make sure that no BEA TUXEDO or WLE client or server applications are running. Use tmshutdown to shut down all WLE applications.

  3. On the Microsoft Windows NT taskbar, click Start->Settings->Control Panel.

The Control Panel is displayed.

  1. Double click the Add/Remove Programs icon.

The Add/Remove Programs Properties window is displayed.

  1. Click BEA WebLogic Enterprise (Java) 4.2 and click Add/Remove.

  2. Click Yes to confirm the removal.

The WLE (Java) product is removed from your system and from the Windows Registry.


[Top] [Prev] [Next] [Bottom]