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

WLE (Java) Installation on Solaris Systems

This chapter discusses the following topics:

Platforms Supported

This release of WLE (Java) is supported on Solaris 2.6 and 7.0.

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

Installing the WLE (Java) Software on Solaris 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 WLE (Java) Client Only software component, skip this step.

  2. Downloading and installing the idltojava compiler from the Sun Microsystems, Inc. Web site. If you are installing the WLE (Java) Client Only 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 need to download and install the Sun Microsystems, Inc. JDK 1.2.1 software to build and run WLE (Java) applications. (If you are installing the Client Only software component, skip this section and go to the section titled "Installing the WLE (Java) Software" on page 8-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 Solaris 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 component, skip this section and go to the section titled "Installing the WLE (Java) Software" on page 8-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. Log on, select the Solaris download format, and download the compiler.

  3. When you are prompted for a directory to which to download the compiler, direct the load to the /bin directory under wledir. For example, if you installed the BEA WLE (C++) software in the /usr/local/wledir directory, direct the download to /usr/local/wledir/bin. When the download completes, you will have a file named idltojava-ea-solaris.bin.

  4. To unbundle the compiler, change (cd) to the /usr/local/wledir/bin directory and enter idltojava-ea-solaris. The idltojava compiler executable is created.

Installing the WLE (Java) Software

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

Note: It takes approximately 5 minutes to install the software on a local disk; installation on a remote disk may take as long as 10 minutes.

To install the WLE (Java) software on a Solaris operating system, use the following procedure:

  1. Log on to the system as root or as a superuser.

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

  3. Insert the CD labeled WLE (Java) 4.2 into the reader. Solaris systems automatically mount the CD.

    Note: If your system does not have a directly connected CD reader, you can mount the CD on a remote system, share (export) the CD file system, and then mount the remote file system. Alternatively, you can mount the CD on a remote system, copy the content of the CD directory for your platform to the system in which you plan to install the WLE (Java) software, and continue with the remainder of the installation procedure. Table 8-1 lists the CD directory name.

    Table 8-1 WLE (Java) 4.2 Software CD Directory Name for the Solaris Platform
    Platform Directory

    Solaris v2.6 on UltraSPARC

    sun5x/sol26

    Solaris v7.0 on UltraSPARC

    sun5x/so127

  4. Change (cd) to the /cdrom/bea#1 directory.

  5. To invoke the installation procedure, enter sh ./install.sh. The following prompt is displayed: 

    01) SUN5X/SOL26      02) SUN5X/SOL27
    Install which platform's files? [01-2, q to quit, l for list]:

  6. Select the desired operating system. For example, if you select Solaris 2.6, the following information is displayed: 

    ** You have chosen to install from sun5x/sol26 **
    BEA WebLogic Enterprise (Java) 4.2
     
    This directory contains the BEA WebLogic Enterprise System for
    SunOS 5.6 (Solaris 2.6) on SPARC.
     
    Is this correct? [y,n,q]:

  7. Enter y. The following information is displayed: 

    To terminate the installation at any time
    press the interrupt key,
    typically <del>, <break>, or <ctrl+c>.
    The following packages are available:
     
      1     wlejava         BEA WebLogic Enterprise (Java)
     
    Select the package(s) you wish to install (or 'all' to install
    all packages) (default: all) [?,??,q]:

  8. Entet 1. The following information is displayed: 

    BEA WebLogic Enterprise (Java)
    (sparc) Release 4.2
    Copyright (c) 1999 BEA Systems, Inc.
    All Rights Reserved.
    BEA, M3 and WebLogic are trademarks of BEA Systems, Inc.
    WebLogic Enterprise (C++) is required to install this Package
     
    Location of existing BEA software installation [?,q]:

  9. Enter the name of the existing directory. For example, /usr/local/wledir. The following information is displayed: 

    Determining if sufficient space is available ...
    17752 blocks are required
    1035478 blocks are available to /usr/local/wledir

    Using /usr/local/wledir as the     WebLogic Enterprise (Java) base directory

    The following installation options are available:

      1    both        Install the full system - client and server
      2    client      Install the client only

    Select an option (default: both) [?,??,q]:

  10. If you are installing the Client Only component, enter 2. Then skip the remainder of this section and go to the section "Installing the Client Only Component" on page 8-7.

  11. If you are installing the Full System component, enter 1. The WLE (Java) Full System software is installed.

After the software installation is completed, the following messages are displayed: 

... finished

Changing file permissions...
... finished

Installation of BEA WebLogic Enterprise (Java) was successful

Please don't forget to fill out and send in your registration card

  1. After the installation is complete, open the CD reader and remove the CD. To open the CD reader, change (cd) to the root directory and enter eject.

Installing the Client Only Component

If you chose to install the Client Only component in step 10 in the preceding section, the WLE (Java) Client Only software is installed.

After the software installation is completed, the following messages are displayed: 

... finished

Changing file permissions...
... finished

Installation of BEA WebLogic Enterprise (Java) was successful

Please don't forget to fill out and send in your registration card

After the installation is complete, open the CD reader and remove the CD. To open the CD reader, change (cd) to the root directory and enter eject.

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 Solaris 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 Solaris System

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

To set these variables, perform the following procedure:

  1. To set the JAVA_HOME variable to the directory where you installed JDK 1.2.1, enter:
    JAVA_HOME=/home/<user_name>/jdk1.2.1

  2. To set the PATH variable to contain JAVA_HOME, enter:
    PATH=$JAVA_HOME/bin:$PATH

  3. To set the LD_LIBRARY_PATH variable, enter: LD_LIBRARY_PATH=$JAVA_HOME/jre/lib/sparc

  4. To set the CLASSPATH variable, enter:
    CLASSPATH=.:$TUXDIR/udataobj/java/jdk/m3.jar:$TUXDIR/locale/jav a/M3

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 a terminal window and perform the following steps:

  1. Create a directory under your directory-for example, /home/<username>/simpapp_java-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 usr/local/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: 

    chmod +w *

  4. To change the permission of the runme.ksh file to give it execute permission, enter the following: 

    chmod +x runme.ksh

  5. Make sure make is in your path.

  6. To run the simpapp application automatically, use the korn shell (ksh) and enter ./runme.ksh. 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, do the following:

    1. Enter KSH.

    2. Enter . ./results/setenv.ksh.

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

    4. Enter java -DTOBJADDR=$TOBJADDR SimpleClient. The prompt String? is displayed.

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

    6. Enter tmshutdown -y. The application shuts down the processes.

  2. To restore the directory created in step 1 to its original state, enter:

    1. . ./results/setenv.ksh

    2. make -f makefile.mk 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 directory created in step 1 in the section titled "Running the Java simpapp Sample Application to Verify the Full System Software Installation" on page 8-8 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 a terminal 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 WLE (Java) software from your system, proceed as follows:

  1. Log on to the system as root or as a superuser.

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

  3. Enter the following command, where $TUXDIR is the environment variable that represents the location of the WLE (Java) software: 

    sh $TUXDIR/bin/uninstall.sh

The following prompt is displayed: 

To terminate the uninstallation at any time
press the interrupt key,
typically <del>, <break>, or <ctrl+c>.

Location of existing BEA software installation [(default: /usr/local/wledir) ?,q]:

  1. Press Enter to accept the default location, or enter the location on the system where the WLE (Java) software is installed.

The following prompt is displayed: 

Using /usr/local/wledir as the base directory

The following uninstallable BEA software was detected:

  1     BEA WLE (Java) 4.2

Select the item you wish to remove [?,??,q]:

  1. Enter 1 to remove the WLE (Java) software.

The following prompt is displayed: 

"Are you sure you want to delete this software? [y,n,?,q]:"

  1. Press Enter to continue removing the WLE (Java) software.

The installation procedure displays the names of the files being removed from your system, as in the following example: 

Deleting: ${TUXDIR}/samples/corba/simpapp_java/makefile.nt...
Deleting: ${TUXDIR}/samples/corba/simpapp_java/runme.cmd...
Deleting: ${TUXDIR}/samples/corba/simpapp_java/runme.ksh...
Deleting: ${TUXDIR}/samples/corba/simpapp_java/smakefile.nt...
Deleting: ${TUXDIR}/udataobj/java/jdbc/jdbcKona.jar...
Deleting: ${TUXDIR}/udataobj/java/jdk/m3.jar...
Deleting: ${TUXDIR}/udataobj/java/jdk/m3envobj.jar...

After the removal procedure is completed, the following message is displayed: 

Uninstall successfully completed.

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