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

WLE (C++) Installation on UNIX Systems

This chapter discusses the following topics:

Platforms Supported

The platforms listed in Table 3-1 are supported.
Table 3-1 Supported Platforms
Vendor Operating System Release/Version

Compaq

Tru64 UNIX

4.0e (Alpha)

HP

HP-UX

10.20 and 11.00

IBM

AIX

4.3.2 (RS/6000, SP2)

Sequent

Dynix/ptx

4.4.2

SGI

IRIX

6.5

Sun

Solaris

2.6 and 7.0 (UltraSPARC)

For the hardware and software requirements for these operating systems, see Appendix A, "WLE (C++) Platform Data Sheets."

Installing the WLE (C++) Software on UNIX Systems

This section describes how to install the WLE (C++) software on UNIX systems.

Preinstallation Consideration: Backing Up Files

If you are installing WLE (C++) software on a system that already has M3 or WLE software installed, there are some files that you may want to back up prior to the installation, and then restore them after the installation is complete. This is because some files that you may have modified for your M3 or WLE software are overwritten when the WLE software is installed.

To avoid having to modify these files again, proceed as follows:

  1. If you are installing the WLE (C++) full system software, back up the RM file to a temporary location. This file is located in the wledir/udataobj directory.

  2. If you are installing the BEA Administration Console, back up the webgui.ini file to a temporary location. This file is located in the wledir/udataobj/webgui directory.

  3. After the installation is complete, restore these files to their original locations.

UNIX Installation Procedure

Note: Before beginning installation, 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.

Note: On most systems, you need superuser privileges to mount the CD.

To install the WLE (C++) software on a UNIX operating system, use the following procedure:

  1. Log on to the system with administrative privileges.

  2. Insert the WLE (C++) CD into the reader.

  3. Mount the CD as a file system. For platform-specific instructions on how to do this, see Appendix A, "WLE (C++) Platform Data Sheets." On most systems you need superuser privileges to perform the mount.

    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. For detailed instructions for each platform, see Appendix A, "WLE (C++) Platform Data Sheets." Alternatively, you can mount the CD on a remote system, copy the contents of the CD directory for your platform to the system in which you plan to install the WLE (C++) software, and continue with the remainder of the installation procedure. Table 3-2 lists the CD directory names.
    Table 3-2 BEA WLE CD Directory Name for UNIX Platforms
    Platform Directory

    Tru64 UNIX v4.0e on DEC Alpha

    alpha/dux40

    HP UX v10.20 on HP 9000 Series 800

    hp/hpux1020

    HP UX v11 on HP 9000 Series 800

    hp/hpux11

    IBM AIX v4.3.2 on RS/6000 and SP2

    ibm/aix432

    Sequent Dynix/ptx 4.4.2 on i386

    seq/dynix442

    SGI IRIX 6.5 on IP27

    sgi/irix65

    Solaris v2.6 on UltraSPARC

    sun5x/sol26

    Solaris v7.0 on UltraSPARC

    sun5x/sol27

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

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

    01) alpha/dux40      02) hp/hpux1020      03) hp/hpux11
    04) ibm/aix432       05) seq/dynix442     06) sgi/irix65
    07) sun5x/sol26      08) sun5x/sol27
    Install which platform's files [01-08, q to quit, l for list]:

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

    ** You have chosen to install from sun5x/sol26 **
    BEA WebLogic Enterprise (C++) 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 prompt 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     wle             BEA WebLogic Enterprise (C++)
     
    Select the package(s) you wish to install (or 'all' to install
    all packages) (default: all) [?,??,q]:

  8. Enter 1. The following prompt is displayed: 

    BEA WebLogic Enterprise (C++)
    (sparc) Release 4.2
    Copyright (c) 1999 BEA Systems, Inc.
    All Rights Reserved.
    BEA, M3 and WebLogic are trademarks of BEA Systems, Inc.
    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]:

    Note: The following steps assume that you select option 1.

  9. Select the desired option. The following prompt is displayed: 

    Directory where WebLogic Enterprise files are to be installed [?,q]:

  10. Enter the name of the desired directory (for example, /usr/local/wledir). If you elected to install the WLE (C++) full system, the following prompt is displayed: 

    Determining if sufficient space is available ...
    91086 blocks are required
    331202 blocks are available to /usr/local/wledir
    Using /usr/local/wledir as the WebLogic Enterprise base directory
     
    Directory where BEA Administration Console documents and images are to be installed 
    (default: /usr/local/wledir/udataobj/webgui) [?,q]:

  11. This prompt allows you to choose between (a) accepting default locations for files being installed, or (b) specifying nondefault pathnames for these files. For details, see the section "Selecting Directories for the WLE Files" on page 1-10. If you accept the default, the following prompt is displayed: 

    Creating /usr/local/wledir/udataobj/webgui
    Using /usr/local/wledir/udataobj/webgui as the BEA Administration Console document tree
     
    Directory where BEA Administration Console java applets are to be
    installed (default: 
    /usr/local/wledir/udataobj/webgui/java) [?,q]:

  12. Again, you have a choice. If you accept the default, the following prompt is displayed: 

    Creating /usr/local/wledir/udataobj/webgui/java
    Using /usr/local/wledir/udataobj/webgui/java as the BEA Administration Console document tree
     
    Directory where BEA Administration Console CGI programs are to
    be installed (default: /usr/local/wledir/udataobj/webgui/cgi-bin) [?,q]:

  13. If you accept the default, the following prompt is displayed: 

    Creating /usr/local/wledir/udataobj/webgui/cgi-bin
    Using /usr/local/wledir/udataobj/webgui/cgi-bin as the BEA Administration Console CGI directory
     
    Web server client prefix for CGI directory.  /cgi-bin is a good choice for most web servers. (default: /cgi-bin) [?,q]:

  14. If you accept the default, the following prompt is displayed and the install program proceeds to install the WLE (C++) files: 

    Using /cgi-bin as the BEA Administration Console CGI prefix
    Unloading /cdrom/bea/sun5x/sol26/wle/WS.Z ...

  15. After the installation of the WLE (C++) files is completed, the following prompt is displayed: 

    ... finished
    Moving BEA Administration Console files to their proper
    location...
    ... finished
     
    Changing file permissions...
    ... finished
     
    Processing default license file...
    ... finished
     
    Install tlisten password? [y/n]:

  16. If you want to specify a tlisten password, enter y; otherwise, enter n. For information about the tlisten password and instructions for setting it, see the section "Selecting an Administrative Password" on page 1-12. If you enter y, the following prompt is displayed: 

    Please enter the tlisten password:

  17. Enter the tlisten password. The following prompt is displayed: 

    Please verify the password:

  18. Enter the tlisten password again. The following prompt is displayed: 

    tlistpwd: INFO: Password appended to file "/usr/local/wledir/udataobj/tlisten.pw".
    Verifying installation... 
    ... Installation successful!
     
    If your license file is accessible, you may install it now.
    Install license file? [y/n]:

  19. If you want to install the WLE (C++) software license now, enter y; otherwise, enter n and install the license later. If you enter y, the following prompt is displayed: 

    To terminate the license update at any time
    press the interrupt key,
    typically <del>, <break>, or <ctrl+c>.
    Directory containing source license text file [?,q]:

  20. Insert the license disk, which is shipped in the WLE software box, in the disk reader on your machine, mount the disk (if necessary), copy the lic.txt file to a system directory, and enter the location of the lic.txt file at the prompt. For example, if you copy the lic.txt file to /usr, enter /usr. The following prompt is displayed: 

    Using /usr/lic.txt to copy license information.
    Updating /usr/local/wledir/udataobj/lic.txt with license information.
     
    Please don't forget to fill out and send in your registration card

  21. After the installation is completed, unmount the CD file system and remove the CD from the reader. For platform-specific instructions for unmounting the CD, see Appendix A, "WLE (C++) Platform Data Sheets."

Installing the Product License After You Install the WLE (C++) Software

If you elected not to install your software license when you installed the WLE (C++) software, you can install the license using the BEA License Utility.

Note: Your product license is on a 3.5-inch disk that is included in the WLE product box.

To install the license, use the following steps:

  1. Insert the license disk, which is shipped in the WLE software box, in the disk reader on your machine, mount the disk (if necessary), and copy the lic.txt file to a directory of your choice, but not to the wledir directory or any of its subdirectories.

  2. Enter the following command to change to the /bin directory: 

    cd /usr/local/wledir/bin

  3. Enter sh ./lic.sh. The following prompt is displayed: 

    To terminate the license update at any time
    press the interrupt key,
    typically <del>, <break>, or <ctrl+c>.
    Directory containing source license text file [?,q]:

  4. Enter the name of the directory that contains the lic.txt file (for example, /kits/license). The following prompt is displayed: 

    Using /kits/license/lic.txt to copy license information.
    Directory where WebLogic Enterprise files are installed. [?,q]:

  5. Enter /usr/local/wledir or the name of the directory where you installed the WLE (C++) software. The following prompt is displayed: 

    Updating /usr/local/wledir/udataobj/lic.txt with license information.

Running Simpapp to Verify the WLE (C++) Software Installation

To verify that you have successfully installed the WLE (C++) client and server software, execute the simpapp application. This "simple application" is a WLE C++ client/server application that converts strings to uppercase and lowercase letters.

To run simpapp, perform the following steps:

  1. Make sure that the directory in which you installed the WLE (C++) software is set in the environment variable TUXDIR. For example, if you installed the software in the default directory, enter the following to set the TUXDIR environment variable:
    TUXDIR=/usr/local/wledir; export TUXDIR

  2. Create a directory under wledir and copy the content of the simpapp directory to it. If you installed the software in the default directory, the simpapp directory is located at usr/local/wledir/samples/corba/simpapp.

  3. Change (cd) to the copy directory.

  4. To change the permissions on all the files to allow full access, enter:
    chmod 777 *

  5. Make sure make is in your path.

  6. To run the simpapp automatically, enter ./runme.ksh. The simpapp 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 manually to observe the processes starting and stopping, do the following:

    1. Enter KSH.

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

    3. Enter tmloadcf -y results/ubb.

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

    5. Enter ./simple_client. The prompt String? is displayed.

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

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

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

    1. . ./results/setenv.ksh

    2. make -f makefile.mk clean

Removing (Uninstalling) the WLE (C++) Software from Your System

To remove the software from your system, use the following procedure:

  1. Log on as the WLE administrator or superuser.

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

  3. Enter the following command: 

    # rm -rf wledir

where wledir is the WLE base directory.


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