Chapter 2: Installing BEA TUXEDO

Introduction

This chapter provides procedures for

A description of the directory structure after installation is also included.

Installing BEA TUXEDO System v6.4

This section provides procedures for installing the following:

Note: If you are planning to install the Web-based GUI for BEA TUXEDO application administration, make sure you have decided whether or not you want the GUI-related files to be installed in their default directories and, if you do not, where you want them to be installed. For details, see Chapter 1.

Installing BEA TUXEDO on UNIX Systems

To install the BEA TUXEDO System on a UNIX platform, complete the following procedure. Make sure you install the software in the file system in which the BEA TUXEDO System executables will run.

Note: It will take approximately 5 minutes to install each package on a local disk; installation on a remote disk may require as much as 10 minutes.

  1. Log in as the administrator of the BEA TUXEDO System.
  2. Insert the CD-ROM into the reader.
  3. Mount the CD-ROM as a file system. For platform-specific instructions about how to do this, see Appendix A. On most systems you will need to acquire superuser privileges to perform the mount.

    Note: If your system does not have a directly-connected CD-ROM reader, you can mount the CD-ROM on a remote system, share (export) the CD-ROM file system, and then mount the remote file system. See Appendix A for detailed instructions for each platform. Alternatively, you can mount the CD-ROM on a remote system, copy the contents of the CD-ROM directory for your platform to the system in which you plan to install BEA TUXEDO, and continue with the rest of the installation procedure.

    CD-ROM Directory Names for UNIX Platforms

    Directory Platform
    dgintl/dgux411 Data General-DG/UX v4.11 on AviiON (Intel)
    dgm88k/dgux411 Data General-DG/UX v4.11 on AviiON (M88K)
    alpha/dux40 Digital UNIX v4.0 on DEC Alpha
    alpha/dux32 Digital UNIX v3.2 on DEC Alpha
    fujitsu/uxpds20 Fujitsu UXP/DS V20 on DS/90
    hp/hpux11 HP UX v11 on HP 9000 Series 800
    hp/hpux1020 HP UX v10.20 on HP 9000 Series 800
    hp/hpux1010 HP UX v10.10 on HP 9000 Series 800
    hp/hpux1001 HP UX v10.01 on HP 9000 Series 800
    ibm/aix43 IBM AIX v4.3 on RS/6000 and SP2
    ibm/aix421 IBM AIX v4.2.1 on RS/6000 and SP2
    ibm/aix414 IBM AIX v4.1.4 on RS/6000 and SP2
    ncr/mpras30 NCR MP-RAS v3.01
    ncr/mpras20 NCR MP-RAS v2.03
    nec/ux4800 NEC UX/4800 on EWS 4800 v2
    sco/scoos50 SCO OpenServer v5.0 on Intel
    uw/uw21 SCO UnixWare v2.1
    seq/dynix441 Sequent DYNIX/ptx v4.4.1 on Sequent i386
    seq/dynix42 Sequent DYNIX/ptx v4.2 on Sequent i386
    sgi/irix64 SGI IRIX v6.4 on Silicon Graphics IP22
    sgi/irix62 SGI IRIX v6.2 on Silicon Graphics IP22
    sni/rel543c Siemens Pyramid SNI Reliant UNIX v5.43c
    sni/rel543b Siemens Pyramid SNI Reliant UNIX v5.43b
    sun5x/isol26 Sun OS 5.6 Solaris v2.6 on Intel
    sun5x/sol26 Sun OS 5.6 Solaris v2.6 on UtraSPARC
    sun5x/isol251 Sun OS 5.5.1 Solaris v2.5.1 on Intel
    sun5x/sol251 Sun OS 5.5.1 Solaris v2.5.1 on UltraSPARC
    sun5x/isol24 Sun OS 5.4 Solaris v2.4 on Intel
    tandem/nsuxc21 Tandem Non-Stop UX C21 on Integrity S4000 Series
    unisys/svr4 UNISYS SVR4 on Intel
  4. Change directory to the root of the mounted CD-ROM.
  5. Invoke the installation procedure: 
    sh install.sh
  6. Respond to the prompts displayed during the installation process. Some of the prompts will require you to choose between (a) accepting default locations for files being installed, and (b) specifying non-default pathnames for these files. For details, see "Selecting Directories for BEA TUXEDO Files" in Chapter 1.
  7. After the installation is complete, unmount the CD-ROM file system and remove the CD-ROM from the reader. See Appendix A for platform-specific instructions.

Installing BEA TUXEDO on Windows Platforms

To install the BEA TUXEDO System on a Windows platform, complete the following procedure.

Note: It will take approximately 5 minutes to install the BEA TUXEDO System.

  1. Insert the CD-ROM into a reader attached to a machine running Windows.

    CD-ROM Directory Names for Windows Platforms

    Directory Platform
    alphant/server Windows NT 4.0 for DEC Alpha (server)
    alphant/ws/disk[1-6] Windows NT 4.0 for DEC Alpha (workstation)
    winnt/server Windows NT 4.0 for Intel (server)
    winnt/ws/disk[1-4] Windows NT 4.0 for Intel (workstation)
    win16/disk[1-2] Windows 3.x (workstation)
    win95/disk[1-4] Windows 95 (workstation)

    Note: Diskette images are present on the CD-ROM for the /WS platforms to facilitate ease of distribution within your organization.

  2. Select one of the following steps, depending on the platform on which you're installing BEA TUXEDO.
    1. For Windows 3.x: 
      win16\disk1\setup.exe
    2. For Windows 95: 
      win95\disk1\setup.exe
    3. For Windows NT 4.0 on DEC Alpha, choose one of the following:
      • To install the BEA TUXEDO System: 
        alphant\server\setup.exe
      • To install BEA TUXEDO /WS: 
        alphant\ws\disk1\setup.exe
    4. For Windows NT 4.0 on Intel, choose one of the following.
      • To install the BEA TUXEDO System: 
        winnt\server\setup.exe
      • To install BEA TUXEDO /WS: 
        winnt\ws\disk1\setup.exe
  3. Respond to the prompts displayed during the installation process. (For a description of the prompts, see "Information Needed during Installation" in Chapter 1.)

Installing BEA TUXEDO System/WS on Macintosh

To install BEA TUXEDO/WS on a Macintosh machine, complete the following procedure.

Note: It will take approximately 15 minutes to install BEA TUXEDO System/WS on a Macintosh platform.

  1. Insert the CD-ROM into a reader attached to a machine running either Windows. The CD-ROM is in ISO 9660 format, which is different from the Macintosh's native CD-ROM file format (HSF, Hierarchical File System) so the CD-ROM is not readable on a Macintosh system.
  2. Transfer the .hqx file from the Windows machine to the Macintosh. (If possible, perform this transfer via a network using ASCII mode to transfer the file.)
  3. Use a utility such as Stuffit to convert the .hqx file into a self-extracting archive file (.sea file).
  4. To perform the installation, double-click on the icon representing the .sea file.
  5. Respond to the prompts displayed during the installation process. Some of the prompts will require you to choose between (a) accepting default locations for files being installed, and (b) specifying non-default pathnames for these files. For details, see "Selecting Directories for BEA TUXEDO Files" in Chapter 1.

Installing BEA TUXEDO Documentation

During the installation process, you are prompted to choose whether to have all but one of the online documents for BEA TUXEDO installed. (The exception is the BEA TUXEDO Administrator's Guide to the Web-based GUI.) If you accept, the documentation is installed in $TUXDIR/doc.

The BEA TUXEDO Administrator's Guide to the Web-based GUI is installed (in the same directory) only when you install the Web-based GUI for BEA TUXEDO application administration.

Installing Your Product License

Your product license was delivered on the floppy diskette that you received in the box with the software CD-ROM.

Installing on Any Platform except NT

  1. Install the contents of the floppy diskette on your machine.

    Note: The floppy diskette cannot be read on a computer running the UNIX system. If you are using a UNIX platform, read the floppy onto a Windows machine and transfer the license file to the UNIX machine. To verify that the UNIX system has accepted the file, run the tmadmin -v command.

  2. Make a copy of the new portion of your license file and append it to the existing license file in $TUXDIR/udataobj/lic.txt.

Installing on an NT Platform

  1. Install the contents of the floppy on your machine.
  2. Respond to prompts directing you to move your product license file to $TUXDIR/udataobj/lic.txt.

Verifying the Software Installation

To verify that you have successfully installed the BEA TUXEDO System software on a server platform, check the directory structure added to your system for the BEA TUXEDO files, and try configuring and executing the sample application provided. This section describes the directory structure and provides instructions for running the sample application.

Checking the Directory Structure after BEA TUXEDO Installation

When the BEA TUXEDO System is installed, the directories shown in Figure 2-1 are created. This diagram reflects the directory structure after all packages in the BEA TUXEDO System Development Environment have been installed.

Fig. 2-1: BEA TUXEDO System Directory Structure

The contents of each directory are described below. TUXDIR is the base directory for the BEA TUXEDO System software. TUXDIR must be an empty directory for which you have read, write, and search (execute) permissions. (In previous releases it was referred to as ROOTDIR.)

$TUXDIR/apps
Contains several subdirectories with sample applications.
 
$TUXDIR/bin
Contains executable programs.
 
$TUXDIR/cobinclude
Contains copylib entries for use in COBOL programs.
 
$TUXDIR/doc
Contains the BEA TUXEDO document set (if installed).
 
$TUXDIR/include
Contains the C language header files. May include subdirectories such as rpc, depending on the platform.
 
$TUXDIR/lib
Contains compiled object files, including dynamic shared libraries (on platforms where BEA TUXEDO uses dynamic shared libraries) and other object files needed to build BEA TUXEDO clients and servers.
 
$TUXDIR/locale
Contains subdirectories to support the localization of system messages.
 
$TUXDIR/locale/C
 
$TUXDIR/locale/En_US
Contain message catalogs for the default locale (U.S. English). En_Us is an SCO alias for C.
 
$TUXDIR/locale/C/mask
Contains the default DES (Data Entry System) initial mask.
 
$TUXDIR/locale/C/mask/vuform
Contains compiled data entry masks used by vuform(1).
 
$TUXDIR/udataobj
Contains files required by the BEA TUXEDO System.

Running a Sample Application

To verify that you have successfully installed the BEA TUXEDO System software on a server platform, you can try configuring and executing the sample application found in the directory $TUXDIR/apps/simpapp.

Note: Instructions for setting up and running simpapp through the Web GUI are provided in the "Tutorial" section (in Chapter 1) of the BEA TUXEDO Administrator's Guide to the Web-based GUI.

simpapp is a non-distributed application consisting of a server, client, and configuration file. The server simpserv offers a single service called TOUPPER. The client simpcl is invoked with a single argument, which is a string to be converted to upper case. The server returns the converted string to the client, which prints it out.

For example, the invocation 

simpcl "hello world"

results in the output 

Returned string is: HELLO WORLD

To configure and run simpapp, follow these steps. (This procedure is also described in the README file in $TUXDIR/apps/simpapp.)

  1. Set up and export the environment variables used by the BEA TUXEDO System. The Bourne shell script $TUXDIR/tux.env shows you how to do this.
  2. Copy the simpapp files to your own working directory, since the configuration file must be edited. Make sure that the client and server files are executable and that the configuration file is writable. For example: 
    MYDIR=/home/me/simpapp
mkdir $MYDIR
cd $MYDIR
cp $TUXDIR/apps/simpapp/* .
chmod 755 simpserv simpcl
chmod 644 ubbsimple
  3. Edit the sample configuration file ubbsimple to replace the bracketed items with values appropriate to your BEA TUXEDO System installation. Follow the comments in ubbsimple, which show you exactly how to customize the file. APPDIR (in the file) should be the same as MYDIR, and TUXCONFIG (in the file) should be set to the literal pathname corresponding to $MYDIR/tuxconfig (in our example, /home/me/simpapp/tuxconfig). The machine name should be set to the name of your system. To determine the name of your system on a UNIX machine run the command: 
    uname -n

    If you are using an NT platform and you do not know the name of your system, see your system administrator.

  4. Initialize and export the TUXCONFIG environment variable, which is used by several BEA TUXEDO commands. 
    TUXCONFIG=$MYDIR/tuxconfig
export TUXCONFIG
  5. Create the binary version of your edited configuration file by invoking tmloadcf(1), which produces a file named tuxconfig. This file, referenced by the TUXCONFIG environment variable, is used by the BEA TUXEDO System at runtime to describe the application configuration. 
    tmloadcf -y ubbsimple
  6. Boot simpapp by typing this: 
    tmboot -y

    If the boot succeeds, you will see output such as the following: 

Booting all admin and server processes in /home/me/simpapp/tuxconfig
INFO: BEA TUXEDO(r) System Release 6.4
INFO: Serial #: 000102-9125503751, Maxusers 25
Booting admin processes ...
exec BBL -A :
	process id=24180 ... Started.
Booting server processes ...
exec simpserv -A :
	process id=24181 ... Started.
2 processes started.
  • If the boot fails, examine the log located in a file named ULOG.mmddyy in your application directory ($MYDIR), where mmddyy are digits corresponding to the current month, day, and year. If you see a message like the following towards the end of the log 
    can't create enough semaphores for BB

    then the Interprocess Communication (IPC) resources configured in your operating system are not adequate for running simpapp.

    To confirm this hypothesis, invoke the BEA TUXEDO command tmloadcf(1) and specify the name of your configuration file. For example: 

    tmloadcf -c $MYDIR/ubbsimple

    If the current value of any IPC parameter configured in your operating system is less than a minimum (either variable or fixed) listed in the tmloadcf output, you must increase the value of that parameter. For instructions on determining and changing the current IPC values for your platform, see the data sheet for your platform in Appendix A.

  • Assuming that the boot succeeded, you can invoke the client. For example, try this: 
    simpcl "hello world"
  • When you have finished, shut down simpapp with the following command: 
    tmshutdown -y

    Removing BEA TUXEDO from Your System

    • On a UNIX system:
      • Make sure that all BEA TUXEDO applications are shut down.
      • Enter 
        rm -rf $TUXDIR

        where TUXDIR is set to the BEA TUXEDO base directory.

    • On a Windows platform: Double-click on the "Uninstall" icon.
    • On a Macintosh platform: Remove all subdirectories and files from the base directory specified at install time.