2006 BEA Systems, Inc.

11
BEA Tuxedo Installation & Deployment
At the end of this module, you will be able to:
Install the BEA Tuxedo software
Configure a very basic Tuxedo application
Start up and shut down a Tuxedo application
Use basic commands to monitor a Tuxedo application
Verify the correct installation of the Tuxedo software
Module 2
BEA Tuxedo Installation and Deployment-1
2006 BEA Systems, Inc. 12
Road Map
1. BEA Tuxedo Product Installation
Tuxedo Software Components
Installation Modes
Tuxedo Directory Structure
2. Deploying a Test Application
BEA Tuxedo Installation and Deployment-2
2006 BEA Systems, Inc. 13
Lab Exercise
For details on the exercise, refer to the Lab Guide.
If questions arise, ask the instructor.
The instructor will determine the stop time.
Lab 01 INSTL: Install BEA Tuxedo Software
BEA Tuxedo Installation and Deployment-3
2006 BEA Systems, Inc. 14
The Tuxedo Product Package
The BEA Tuxedo product box contains:
BEA Tuxedo product software CD also includes BEA Jolt
and BEA SNMP Agent)
BEA Tuxedo Online Documentation CD includes the same
online documentation accessible at http://edocs.bea.com)
Read-Me-First card
Customer Support Quick Reference card
BEA Tuxedo Release Notes
Installation Guide
BEA Tuxedo Installation and Deployment-4
2006 BEA Systems, Inc. 15
Tuxedo Software Components
Tuxedo 9.0 Server components:
Application-to-Transaction Monitor Interface (ATMI) server software
Common Object Request Broker Architecture (CORBA) C++ server
software
Jolt 9.0 server software
SNMP Agent 9.0 software
Tuxedo Administration Console software
Link-Level Encryption (LLE) and Secure Sockets Layer (SSL)
encryption software
Tuxedo 9.0 Client components:
ATMI Workstation (/WS) client software
CORBA C++ client software
Jolt 9.0 client software
LLE and SSL encryption software
BEA Tuxedo Installation and Deployment-5
2006 BEA Systems, Inc. 16
Platform-Specific Requirements
Platform data sheets are provided for each BEA
Tuxedo supported platform.
Each data sheet includes the following platform-
specific information:
A list of available BEA Tuxedo install sets
Hardware, software, network, and disk space requirements
Instructions for mounting and unmounting the BEA Tuxedo
software CD
Tunable parameters
Review the latest information on platform support
online: http://www.bea.com > Products > BEA Tuxedo
BEA Tuxedo Installation and Deployment-6
2006 BEA Systems, Inc. 17
Tuxedo 9.0 Installation
The BEA Installation program is the standard tool for
installing Tuxedo on Windows or UNIX machines.
There are three installation methods:
Graphical user interface (GUI) mode
Console-mode (UNIX only)
Silent installation
Installation requires choices concerning:
Install Set components
BEA Home and Tuxedo product directories
SSL installation options
License file location
BEA Tuxedo Installation and Deployment-7
2006 BEA Systems, Inc. 18
Installation Steps GUI Mode
Ensure machine conforms with appropriate platform
data sheet requirements.
Log in requirements:
Windows Log in as a member of the Administrator group.
UNIX Log in as a member of a Tuxedo Administrator
group.
Execute the installer, then
respond to GUI window options.
UNIX only If installing from the
product CD, mount the CD-ROM
as a filesystem
BEA Tuxedo Installation and Deployment-8
2006 BEA Systems, Inc. 19
Console & Silent Modes
Console mode (UNIX Only):
From a shell prompt, execute the installer:
tuxedo9_sol.bin i console
Respond to the prompts in each section
Silent mode:
Copy the contents of the appropriate Template File and save
it to a text file named installer.properties
Modify the keyword values for your configuration
Windows from a command prompt, execute the installer:
tuxedo9_win.exe f installer.properties
UNIX from a shell prompt, execute the installer:
tuxedo9_sol.bin f installer.properties
BEA Tuxedo Installation and Deployment-9
2006 BEA Systems, Inc. 20
Post-Installation Steps
Check the directory structure after the BEA Tuxedo
system installation.
Install product license file (if necessary).
Verify the software installation by configuring and
running a sample application.
We will discuss this in the next section.
BEA Tuxedo Installation and Deployment-10
2006 BEA Systems, Inc. 21
Installed Directory Structure
Tuxedo 9.0









C/C++ CORBA applications can also
be deployed (not available in 6.5)
Sample applications are stored
in these subdirectories
Miscellaneous files and
subdirectories; the license file
lic.txt is placed in this directory
All command and utility
executables are here
Subdirectories to support the local
language for system messages
Files needed for running
C/C++ or COBOL
applications
BEA HOME
TUXDIR
BEA Tuxedo Installation and Deployment-11
2006 BEA Systems, Inc. 22
Product License Installation
You may install the BEA Tuxedo product license
separately.
Windows: run the BEA License utility
UNIX: manually copy in the license file


In either case, the name and location must be:
Windows: %TUXDIR%\udataobj\lic.txt
UNIX: $TUXDIR/udataobj/lic.txt
The two types of product licenses are:
Software Development Kit (SDK)
Run-time Kit (RTK)
BEA Tuxedo Installation and Deployment-12
2006 BEA Systems, Inc. 23
Section Review
Identify the various Tuxedo product components
Install the BEA Tuxedo software
Inspect the installed directory structure
Install the Tuxedo product license
In this section, we learned how to:
BEA Tuxedo Installation and Deployment-13
2006 BEA Systems, Inc. 24
Lab Exercise
For details on the exercise, refer to the Lab Guide.
If questions arise, ask the instructor.
The instructor will determine the stop time.
Lab 02 INSTL: Setup Lab Exercise
Environment
BEA Tuxedo Installation and Deployment-14
2006 BEA Systems, Inc. 25
Road Map
1. BEA Tuxedo Product Installation
2. Deploying a Test Application
Edit and Build the Tuxedo Configuration File
Setting up the Application Environment
Running the simpapp Sample Application
BEA Tuxedo Installation and Deployment-15
2006 BEA Systems, Inc. 26
Deploying a Test Application
A sample application, simpapp, is provided with the
Tuxedo software:
$TUXDIR/samples/atmi/simpapp
$TUXDIR/apps/simpapp (version 6.5)
simpapp: A simple, single-machine application using
one server and one test client
Server: advertises a single service, TOUPPER
Client: runs with one command-line argument, a string that
will be converted to uppercase by TOUPPER
This is the same application we will use in our
upcoming lab exercise.
BEA Tuxedo Installation and Deployment-16
2006 BEA Systems, Inc. 27
Configuration Checklist
1. Set the appropriate environment variables:
TUXDIR, PATH, TUXCONFIG, (LD_LIBRARY_PATH)
2. Determine your machines hostname:
UNIX: uname n
Windows: echo %COMPUTERNAME%
3. Edit the text configuration file.
IPC key, Machine Name, file/directory names
4. Compile the configuration file: tmloadcf
5. Stage the simpserv server executable to the
APPDIR
BEA Tuxedo Installation and Deployment-17
2006 BEA Systems, Inc. 28
1. Setting the Environment Variables
Before running Tuxedo commands, we need to set
some environment variables.
These can be set using a command/shell script file.


setenv.ksh
10
0101
1110
Example setenv.cmd script:
set TUXDIR=C:\bea\tuxedo9.0
set PATH=%TUXDIR%\bin;%PATH%
set TUXCONFIG=C:\student\course_tux\domains\adminTng\tuxconfig
These two are normally
already set as system
environment variables.
setenv.ksh
10
0101
1110
Example setenv.ksh script:
export TUXDIR=/opt/bea/tuxedo9.0
export PATH=$TUXDIR/bin:$PATH
export LD_LIBRARY_PATH=$TUXDIR/lib:$LD_LIBRARY_PATH
export TUXCONFIG=/appdir/tuxconfig
Example shown for SVR4
Name & location of
binary configuration file
BEA Tuxedo Installation and Deployment-18
2006 BEA Systems, Inc. 29
2. Determine the Machine Name
The Tuxedo configuration file will require the actual
hostname of the machine.

setenv.ksh
Windows O/S command prompt example:
C:\> echo %COMPUTERNAME%
STUDENT14
setenv.ksh
UNIX O/S Korn shell example:
> uname n
student14
Note: In Windows it is ALL CAPS.
BEA Tuxedo Installation and Deployment-19
2006 BEA Systems, Inc. 30
The Tuxedo Configuration File
It is referred to as the UBBCONFIG file, but can be any
file name; it defines the parameters for Tuxedo to boot
(start up) an application.
The UBBCONFIG file is typically created by
application developers and modified by the application
administrator.
The configuration file exists in two formats:
UBBCONFIG: text version; edited by administrators.
TUXCONFIG: binary version, compiled from the text
version; this is the only file that is read by the Tuxedo
system software.
BEA Tuxedo Installation and Deployment-20
2006 BEA Systems, Inc. 31
3. Edit the Text Configuration File
Use any text editor to modify the file.
We will be using the provided SciTE editor for syntax help.

setenv.ksh
10
0101
1110
Example UBBCONFIG text file:
*RESOURCES
IPCKEY 55432
MASTER SITE1
MODEL SHM

*MACHINES
STUDENT14
LMID=SITE1
APPDIR=C:\student\course_tux\domains\adminTng
TUXCONFIG=C:\student\course_tux\domains\adminTng\tuxconfig
TUXDIR=C:\bea\tuxedo9.0

*GROUPS
GROUP1 GRPNO=1 LMID=SITE1
*SERVERS
simpserv SRVID=1 SRVGRP=GROUP1
BEA Tuxedo Installation and Deployment-21
2006 BEA Systems, Inc. 32
4. Compile the Binary Configuration File
The Tuxedo configuration text file must be loaded to
create the binary tuxconfig file prior to booting the
application.
Use the tmloadcf utility to create the binary.
Note: The value of the TUXCONFIG environment variable
must exactly match the value of the TUXCONFIG parameter
in the MACHINES section of the text configuration file.

setenv.ksh
Using the tmloadcf utlity:
C:\student\course_tux\labs> cd Lab03_INSTL
C:\student\course_tux\labs\Lab03_INSTL> tmloadcf y ubb.tux
CMDTUX_CAT:6652: WARN: MAXACCESSERS is not...
CMDTUX_CAT:6653: WARN: MAXSERVERS is not...
CMDTUX_CAT:48: WARN: Missing SERVICES section
C:\student\course_tux\labs\Lab03_INSTL>
We can ignore these
warnings for now.
BEA Tuxedo Installation and Deployment-22
2006 BEA Systems, Inc. 33
5. Stage the Server(s) to APPDIR
All server executables listed in the SERVERS section
should be staged in the application directory indicated
by the APPDIR parameter.
During the boot process, Tuxedo will look for server
executable files in the following location sequence:
1. The APPDIR directory
2. The $TUXDIR/bin directory
3. The directories listed in the system PATH
If not found, an error message will be displayed.
Copying simpserv to the APPDIR:
C:\student\course_tux\labs\source\bin>
copy simpserv.exe ..\..\..\domains\adminTng
1 file(s) copied.
BEA Tuxedo Installation and Deployment-23
2006 BEA Systems, Inc. 34
Booting the Tuxedo Application
The tmboot utility will attempt to start the application
defined by the configuration file as indicated by the
value of the TUXCONFIG environment variable.
BEA Tuxedo Installation and Deployment-24
2006 BEA Systems, Inc. 35
Monitoring the Application
The tmadmin utility will attempt to connect to the
application configuration defined by the value of the
TUXCONFIG environment variable.
Using the tmadmin utility is one way to monitor a
running system. Some common commands include:
printserver(psr) to view info on running servers
printservice(psc) to view info on available services
BEA Tuxedo Installation and Deployment-25
2006 BEA Systems, Inc. 36
Running the Test Client Application
The client application will attempt to connect to the
application configuration defined by the value of the
TUXCONFIG environment variable.
Run the client executable simpcl with any
string argument, such as hello world

simpcl calls the TOUPPER service
simpcl displays the result
from the server; the text has
been converted to uppercase
BEA Tuxedo Installation and Deployment-26
2006 BEA Systems, Inc. 37
Shutting Down the Tuxedo Application
The tmshutdown utility will attempt to stop the
application configuration as indicated by the value of
the TUXCONFIG environment variable.
BEA Tuxedo Installation and Deployment-27
2006 BEA Systems, Inc. 38
Section Review
Configure a sample Tuxedo application
Edit and compile the Tuxedo configuration file
Run and monitor a sample Tuxedo application
In this section, we learned how to:
BEA Tuxedo Installation and Deployment-28
2006 BEA Systems, Inc. 39
Lab Exercise
For details on the exercise, refer to the Lab Guide.
If questions arise, ask the instructor.
The instructor will determine the stop time.
Lab 03 INSTL: Deploy a Sample Tuxedo
Application
BEA Tuxedo Installation and Deployment-29
2006 BEA Systems, Inc. 40
Module Review
Install the BEA Tuxedo Product
Deploy a Sample Tuxedo Application
In this module, we learned how to:
BEA Tuxedo Installation and Deployment-30