Installing the Tuxedo System

Installing BEA Tuxedo Using GUI-Mode Installation

The following sections describe how to install BEA Tuxedo using graphical user interface (GUI) mode installation on both Windows and UNIX systems:

What Is GUI-Mode Installation?

The graphical user interface mode installation is the graphics-based method of executing the BEA Installation program. It can be run on both Windows and UNIX systems.

To run GUI-mode installation, the console attached to the machine on which you are installing the software must support a Java-based GUI. All consoles for Windows systems support Java-based GUIs, but not all consoles for UNIX systems do.

Note: To install BEA Tuxedo on a UNIX system with a non-graphics console, seeInstalling BEA Tuxedo on UNIX Systems Using Console-Mode Installation.

Before You Start

If you are upgrading from BEA WebLogic Enterprise or BEA Tuxedo 8.1 or earlier software, see Upgrading the BEA Tuxedo System to Release 9.1 and follow the instructions given there. Then return here to continue your BEA Tuxedo installation.

On a Windows machine that has the BEA WebLogic Enterprise software or an older version of the BEA Tuxedo software installed, a window named "Previous Version Detected!" will display at the very beginning of the BEA Tuxedo installation. This window contains a message that encourages you to exit the installation program and remove the older software before installing BEA Tuxedo 9.1.

If you choose to remove the older software, refer to Upgrading the BEA Tuxedo System to Release 9.1, follow the instructions to remove the older software from your machine, and then restart the installation.

If you choose not to remove the older software, install the BEA Tuxedo 9.1 software to a different product directory than the product directory where the BEA WebLogic Enterprise software or the older version of the BEA Tuxedo software is installed. See also Previous Tuxedo Versions

Starting GUI-Mode Installation on a Windows System

To start the GUI-mode installation process on a Windows system, follow these steps:

Select a Windows system that meets the hardware and software requirements described in BEA Tuxedo 9.1 Platform Data Sheets.

The Windows XP systems support only BEA Tuxedo client components.

You need administrative privileges to install BEA Tuxedo server components on a Windows system. If you are going to install only BEA Tuxedo client components, you do not need administrative privileges.

Ensure that you have enough free space for the BEA Tuxedo installation.

For disk space requirements, see BEA Tuxedo 9.1 Platform Data Sheets. For important disk space allocation information, seeFile and Database Management and Disk Space Allocation.

If installing BEA Tuxedo by downloading from the BEA Web site:

Go to http://commerce.bea.com/downloads/tuxedo.jsp#tuxedo and download the BEA Tuxedo 9.1 installation file specific to your platform, including the 30-day evaluation license file needed to complete the BEA Tuxedo installation.

Go to the directory where you downloaded the BEA Tuxedo installer and double-click the installer filename to start the installation.

If installing BEA Tuxedo from the product software CD:

Insert the BEA Tuxedo 9.1 product software CD into the CD-ROM drive. Select the executable for your platform and double-click to initiate the installation process. For more information see, Tuxedo 9.1 Installation Binary Files.

Proceed to Running GUI-Mode Installation.

Re-login to the system after Tuxedo 9.1 installation has completed.

Starting GUI-Mode Installation on a UNIX System

To start the GUI-mode installation process on a UNIX system, follow these steps:

Select a UNIX system that meets the hardware and software requirements described in BEA Tuxedo 9.1 Platform Data Sheets

Ensure that you have enough free space for the BEA Tuxedo installation.

For disk space requirements, see BEA Tuxedo 9.1 Platform Data Sheets. For important disk space allocation information, see File and Database Management and Disk Space Allocation

If installing BEA Tuxedo by downloading from the BEA Web site:

Go to the directory where you downloaded the installer and invoke the installation procedure by entering the following command:

prompt> sh filename.bin
where filename is the name of the BEA Tuxedo installer file.

Note: GUI mode is the default for Tuxedo 9.1 installation. If a GUI interface is not available on your Unix platform, you will receive an error message and the installation process is aborted.

If a GUI interface is not available on your Unix platform, you must use silent or console-mode installation. For more information, see What Is Silent Installation? and What Is Console-Mode Installation?

If installing BEA Tuxedo from the product software CD:

Mount the CD-ROM as a filesystem and insert the BEA Tuxedo CD-ROM into the CD-ROM drive.

Go to the top-level directory of the mounted CD-ROM.

Invoke the installation procedure by entering the following command:

prompt> sh filename.bin
where filename is the name of the BEA Tuxedo installer file specific to your platform.

Proceed to Running GUI-Mode Installation.

Running GUI-Mode Installation

The BEA Tuxedo installer program is currently available in English and Japanese. By checking the value of a certain language-related environment variable on the target platform, the installer program automatically determines (1) the language displayed during the installation and (2) the language-specific message catalog installed during the installation. If the language-related environment variable is not set or is set to a value unknown to the installer program, both the language displayed and the message catalog installed default to English.

The BEA Tuxedo installer program prompts you to enter specific information about your system and configuration. For instructions on responding to the prompts during installation, see the following table.

In This Window . . .	Perform the Following Action . . .
Introduction	Click Next to proceed with the installation. You may cancel the installation at any time by clicking Cancel.
License Agreement	Read the BEA Software License Agreement and indicate your acceptance of the terms of the agreement by selecting "I accept...". The default is "I do NOT accept." To continue with the installation, you must accept the terms of the license agreement and then click Next.
Choose Install Set (.NET Client Install set in not available on UNIX platforms)	Select the install set that you want installed on your system. The following seven choices are available: Full Install (the default)—all Tuxedo server and client software components Server Install—Tuxedo server software components only Full Client Install—Tuxedo client software components only Jolt Client Install—Jolt client software components only ATMI (/WS) Client Install—Tuxedo ATMI client software components only CORBA Client Install—Tuxedo CORBA client software components only .NET Client Install—Tuxedo .NET client software and ATMI client components only. The .NET Client Install set installs the Tuxedo Workstation Client on your system. For more information on the Tuxedo .Net Workstation Client, see Creating Tuxedo .NET Workstation Client Applications Custom Install—select specific Tuxedo server and client software components. The following table entry provides a summary of options for the Custom Install. For a detailed list of software components for each install set, see Install Sets. Note: A Windows XP system cannot be used as a BEA Tuxedo server machine. On a Windows XP system, select Full Client Install, Jolt Client Install, ATMI Client Install, or CORBA Client Install from the installation menu. Select an install set and then click Next to launch the Choose BEA Home Directory window—your selection includes the appropriate encryption software for Link-Level Encryption (LLE) and/or Secure Sockets Layer (SSL). Or select an install set and then click Customize to launch the Customize Install window.
Customize Install	Select (add) or deselect (clear) one or more software components from the selected install set, or choose one of the other five install sets or Custom Set from the drop-down list menu and customize its software components. For a description of the JRLY component, see Jolt Internet Relay. Observe the following software component mappings: Server—contains ATMI server software; CORBA C++ server software; BEA Jolt server software; BEA SNMP Agent software, and BEA Tuxedo Administration Console software ATMI Client—contains BEA ATMI Workstation (/WS) client software CORBA Client—contains BEA CORBA C++ client software (C++ client ORB) including environmental objects Jolt JRLY—contains BEA Jolt Relay software Jolt Client—contains BEA Jolt client software . NET Client—contains BEA .Net client software After selecting or deselecting one or more software components from the selected install set, click Next to continue with the installation. The appropriate encryption software for LLE and/or SSL is automatically included.
Choose BEA Home Directory	Specify the BEA Home directory that will serve as the central support directory for all BEA products installed on the target system. If you already have a BEA Home directory on your system, you can select that directory (recommended) or create a new BEA Home directory. If you choose to create a new directory, the BEA Tuxedo installer program automatically creates the directory for you. For details about the BEA Home directory, see BEA Home Directory. Choose a BEA Home directory and then click Next to continue with the installation.
Choose Product Directory	Specify the directory in which you want to install the BEA Tuxedo software. You may select the default product directory (`tuxedo9.1`) or create a new product directory. If you choose to create a new directory, the BEA Tuxedo installer automatically creates the directory for you. Warning: Running a previous Tuxedo version in conjunction with Tuxedo 9.1 on a Windows system requires that the product directories for both versions do not have the same name. Choose a product directory and then click Install to start the BEA Tuxedo software installation.
Confirm .Net Client Installation (Windows Platforms only)	Click Next to proceed with the installation. Will only display if .NET Client set is selected and .Net Framework is not installed on your system.
Choose Shortcut Folder	Specify where you want to place Tuxedo 9.1 shortcut icons.
Pre-Installation Summary	Review your installation selections. Clicking Previous allows you to modify installation selections. Otherwise click Install to continue.
Installing Tuxedo. . .	No user input is required here. The installation program is installing BEA Tuxedo in the user-specified product directory. Note: It is normal for the installation progress bar to stop for several minutes, especially at the end. The BEA Tuxedo installer is still working when this occurs.
Configure tlisten Service	This window appears only if you have installed the Server Install set. Set the tlisten port value. Note: For Windows platforms, the default value is 3050. There is no default value for UNIX platforms. Enter a `tlisten` password of your choice. Your password must be a string of alphanumeric characters in clear-text format that is no more than 80 characters in length. You use this password to log in to the BEA Tuxedo Administration Console. Note: Machines on the same domain must have the same tlisten password defined. BEA Tuxedo uses the `tlisten` password to protect the local machine from administrative requests and operations that are not authorized. Whenever administrative communications arrive on the local machine through `tlisten(1)` or `wlisten(1)` gateway processes, BEA Tuxedo authenticates them by means of the `tlisten` password. Enter and re-enter a `tlisten` password and then click Next to continue.
SSL Installation Choice	This window appears only if you have installed Server Install set and or CORBA Client install set components. BEA Tuxedo provides a Lightweight Directory Access Protocol (LDAP) based certificate retrieval mechanism that supports certificate-based authentication when using SSL. The BEA Tuxedo certificate retrieval mechanism has been certified for use with the LDAP Directory server included with iPlanet Directory Server. Choose whether or not you want to install SSL support. If you intend to use SSL encryption in your application, select Yes and then click Next to launch the LDAP Configuration window. If you do not intend to use SSL encryption in your application, select No and then click Next to launch the License Installation Choice window.
LDAP Configuration for SSL Support	Enter the following LDAP configuration information and then click Next to continue: LDAP Service Name: Fully qualified domain name of the LDAP server (for example, `pcwiz.mydomain.com`) LDAP PortID: Port number through which the local machine communicates with the LDAP server (for example, `389`) LDAP BaseObject: Distinguished name of the base object for search in the LDAP server (for example, `o=beasys.com`) LDAP Filter File Location: (`tux_ prod_dir/udataobj/security/ bea_ldap_filter.dat` by default, where `tux_prod_dir` represents the product directory in which you installed the BEA Tuxedo software)
License Installation Choice	Choose whether or not you want to install the BEA Tuxedo product license now. To install the license now, select Yes and then click Next to launch the License File Browser window. To install the license later, select No and then click Next to launch the Install Complete window. For instructions on installing the product license manually, see Installing the Product License After You Install BEA Tuxedo.
Choose License File Location	Read the following important information, specify the location of the license file on your machine, and then click Next to continue. There are three types of licenses for the BEA Tuxedo product: a 30-day evaluation license, a development license, and a production license. (When a 30-day evaluation license expires, a customer may decide to buy the BEA Tuxedo product, thus upgrading the evaluation license to a development or production license.) All licenses come with 56-bit encryption enabled by default. Licenses with 128-bit encryption enabled are available but require a separate authorization procedure. After acquiring your license, which is packaged as a file named `lic.txt`, you copy the license file to the machine targeted to receive the BEA Tuxedo installation. After you specify the location of the `lic.txt` file during the installation, the BEA Tuxedo installer copies the `lic.txt` file to the `tux_prod_dir/udataobj` directory, where `tux_prod_dir` represents the product directory in which you installed the BEA Tuxedo software.
Install Complete	Click Done to exit the installation program.

Congratulations! Your installation of the BEA Tuxedo software is complete!

Assigning File Ownership on a UNIX System

If you installed the BEA Tuxedo software on a UNIX system, BEA strongly recommends that you create a separate user account for the BEA Tuxedo administrator and give ownership of the BEA Tuxedo files to that account. To change ownership of the BEA Tuxedo software on a UNIX machine, enter the following command:

chown -R adm_account full_path_of_tux_prod_dirchgrp -R adm_group full_path_of_tux_prod_dir

Replace adm_account with the BEA Tuxedo administrator account, replace adm_group with the BEA Tuxedo administrator group ID, and replace full_path_of_tux_prod_dir with the full pathname of the product directory in which you installed the BEA Tuxedo software.

Understanding the BEA Tuxedo Shortcuts on a Windows System

When installing the BEA Tuxedo software on a Windows system, the installer program automatically uses BEA WebLogic E-Business Platform as the parent folder for BEA Tuxedo. As additional BEA Home directories are added to the system, the installer program continues to create new BEA WebLogic E-Business Platform folders using the convention shown in the following figure.

Figure 2-1 Tracking Multiple BEA Home Directories on the Same Windows System

Tracking Multiple BEA Home Directories on the Same Windows System

Each BEA Home directory has an associated BEA WebLogic E-Business Platform folder. Each BEA WebLogic E-Business Platform folder contains one or more BEA product folders (see note) and two files: BEAHOME Location and Install History.

Note: Because a BEA Home directory may be the home directory for a BEA Tuxedo installation, a BEA WebLogic Server installation, or other BEA product installations, a BEA WebLogic E-Business Platform folder may contain multiple BEA product folders.

For a given BEA Home directory and BEA WebLogic E-Business Platform folder, the BEAHOME file contains the pathname of the BEA Home directory, and the View History file contains a history of installation and uninstallation for the BEA Home directory. Double-clicking the text icon associated with either file displays its content. The BEAHOME and history files contain information extracted from the logs/log.txt file located in the BEA Home directory.

The Tuxedo 9.1 folder (Start —>Programs —>BEA WebLogic E-Business Platform —>Tuxedo 9.1) contains the following shortcuts:

bealic—appears even if you did install the BEA Tuxedo product license during the installation. Choosing bealic enables you to install the product license (lic.txt file) after the installation. For more information about installing the license file, see Installing the Product License After You Install BEA Tuxedo.
Uninstall Tuxedo—choosing uninstall enables you to uninstall the BEA Tuxedo 9.1 software. For more information about uninstalling BEA Tuxedo, see Uninstalling BEA Tuxedo.

Understanding the BEA Administration Program on a Windows System

In addition to the BEA Tuxedo Administration Console, the BEA Tuxedo 9.1 software for Windows provides a BEA Administration program and two Windows services (Tlisten and BEA procMGR) for configuring the BEA Tuxedo system on a Windows 2003 Server system. Only if the installation included BEA Tuxedo server components will these additional administration tools be installed on the Windows 2003 Server system.

After you have installed or upgraded the BEA Tuxedo software on your Windows 2003 Server system, you can use the BEA Administration control panel (Start —> Settings —> Control Panel —> BEA Tuxedo 9.1 Administration) to perform the following tasks:

Access other machines on the network on which the BEA Tuxedo system is installed
Set and modify environment variables for the BEA Tuxedo system
Direct BEA Tuxedo system messages to the Windows 2003 Server Event Log
Configure BEA Tuxedo tlisten(1) processes to start automatically
Tune interprocess communication (IPC) resources to maximize BEA Tuxedo system performance

For instructions on performing these tasks, see Configuring BEA Tuxedo ATMI for Windows Server 2003 on page 2-1 in Using BEA Tuxedo ATMI on Windows.

Reviewing the Windows 2003 Server Registry Content

The Windows 2003 Server Registry is the repository for all hardware, software, and application configuration settings for the Windows 2003 Server system. During the BEA Tuxedo installation, the installer program writes general installation information as well as IPC Resource values to the Registry. The structure of the Registry relevant to BEA Tuxedo is as follows.

HKEY_LOCAL_MACHINE\Software\BEA Systems\Tuxedo\9.1\...

Developer
Environment
Security

To view this structure, choose Start —> Run to launch the Run dialog box, enter regEdt32, and click OK to launch the Registry Editor window.

Developer Key

The Developer key stores product information, including the major and minor version numbers of the release, and user and company names.

Environment Key

The Environment key stores the locations referenced by the BEA Tuxedo environment variables set on your Windows 2003 Server system. It also stores other values such as IPC resource settings.

Security Key

The Security key holds the access permissions for BEA Tuxedo processes and services. The following permissions are mandatory:

Any user who runs tlisten(1) must have read access permissions.
The account under which the BEA ProcMGR service is running must have read access permissions.

BEA recommends that the Administrator have full control permissions.

What Do I Do Next?

To configure your BEA Tuxedo software, verify that your software is installed correctly, or to uninstall BEA Tuxedo software, see Performing Post-Installation Tasks.