Installing the Tuxedo System

Installing BEA Tuxedo Using Silent Installation

The following sections describe how to install BEA Tuxedo using silent installation on both Windows and UNIX systems:

What Is Silent Installation?

Silent installation reads the settings for your configuration from a text file that you create prior to beginning the installation. Manual intervention is not necessary during the installation process. Silent installation works on both Windows and UNIX systems.

Silent installation is a way of setting installation configurations only once and then using those configurations to duplicate the installation on many machines.

Note: Using silent installation implies your consent to the BEA License Agreement. You neither see a copy of the BEA Software License Agreement nor have any means to accept the terms of the agreement.

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.0 and follow the instructions given there. Then return here to continue your BEA Tuxedo installation.

If you are planning to use BEA Tuxedo 9.0 in conjuction with a previous Tuxedo version on a Windows system, see Previous Tuxedo Versions on page 1-2.

Using Silent Installation: Main Steps

The silent installation process has two primary steps:

Create a template file that contains the configuration settings, such as BEA Home directory, product directory, and install set appropriate for your installation.

For the detailed procedure, see Creating a Template File. Two sample template files are provided in Windows Template File and UNIX Template File.

Invoke the installation process using the values specified in the template files.

For the detailed procedure, see Invoking the Silent Installation Process on a Windows System and Invoking the Silent Installation Process on a UNIX System.

Creating a Template File

To create a template file for use in the silent installation process, follow these steps:

Display the template file specific to your platform. The following templates are available in:

Windows template file content at Windows Template File.
UNIX template file content at UNIX Template File.

Copy the contents of the template file and save it as a text file named installer.properties.

In the installer.properties file, modify the values for the keywords shown in the following table to create your desired configuration.

Table 4-1 The installer.properties File

For This Keyword . . .	Enter the Following Value . . .
`INSTALLER_UI= (UNIX and Windows)`	The mode of installation. The default is `silent`; do not modify this value.
`BEAHOME= (UNIX and Windows)`	The full pathname of the BEA Home directory of your choice. For details about the BEA Home directory, see BEA Home Directory.
`USER_INSTALL_DIR= (UNIX and Windows)`	The full pathname of the product directory of your choice. Warning: Running a previous Tuxedo version in conjunction with Tuxedo 9.0 on a Windows system requires that the product directories for both versions do not have the same name.
`LDAP_HOSTNAME= (Unix & Windows)`	The fully qualified domain name of the Lightweight Directory Access Protocol (LDAP) server of your choice; for example, `pcwiz.mydomain.com`. (See Note at end of table.)
`LDAP_PORTID= (Windows)`	The port number through which the local machine communicates with the LDAP server; for example, `389`.* (See Note at end of table.)
`TLISTEN_PORT (Windows)`	The port number through which the local machine communicates with the TLISTEN server; for example, 1357.
`LDAP_BASE_OBJECT (Unix & Windows)=`	The distinguished name of the base object for search in the LDAP server; for example, `o=beasys.com`. (See Note at end of table.)
`LDAP_FILTER_FILE (Unix & Windows)=`	The full pathname of the LDAP filter file on your machine; for example, C:\bea\tuxedo9.0\`udataobj\security\ bea_ldap_filter.dat`. (See Note at end of table.)
`TLISTEN_PASSWORD (Unix & Windows)=`	A `tlisten` password of your choice. The password must be a string of alphanumeric characters in clear-text format that is no more than 80 characters in length. You will be prompted to enter this password when logging in to the BEA Tuxedo Administration Console.
`USER_LIC_FILE= (UNIX and Windows)`	The full pathname of the BEA Tuxedo 9.0 license file on your machine; pathname must end with `lic.txt`.
`CHOSEN_INSTALL_SET=`	The chosen installation set. You must set this value to one of the following options: Notes: The valid options are case sensitive and should be coded exactly as defined below for proper installation. Use of invalid options will result in improper installation. Spaces should not be included after the install set name. If there are spaces after the install set name, the installation process uses the default mode `Full Install`. `Full Install` for a full installation, `Server Install` for server-only installation, `Full Client Install` for full client installation, `ATMI Client Install` for ATMI-client-only installation, `CORBA Client Install` for CORBA-client-only installation, or `Jolt Client Install` for Jolt-client-only installation No customizing of install sets is possible with silent-mode installation. For a description of install sets, see Install Sets.

Note: Keywords LDAP_HOSTNAME, LDAP_PORTID, LDAP_BASE_OBJECT, LDAP_FILTER_FILE, TLISTEN_PORT, and TLISTEN_PASSWORD are optional. Include these keywords and their values only if you select Server Install or CORBA Client Install and you want to use Secure Sockets Layer (SSL) encryption. Otherwise, comment these lines out by preceding them with hash marks (#).

In the template files, comment lines are preceded by hash marks (#). The installer program does not read any line beginning with a hash mark.

Invoking the Silent Installation Process on a Windows System

Installing the software using silent installation takes the same amount of time as a standard installation. During silent installation, an initial installation program window appears briefly, indicating that the installation has started.

To invoke the silent 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.0 Platform Data Sheets.

The Windows XP system supports 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.0 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:

Open a command-line shell.

Go to http://commerce.bea.com/downloads/tuxedo.jsp#tuxedo and download the BEA Tuxedo 9.0 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 installer and invoke the installation procedure by entering the following command:

prompt> filename.exe -f path\installer.properties
where filename is the name of the BEA Tuxedo installer file, and path is the full or relative pathname of the installer.properties file.

Note: If a file named installer.properties is present in the same directory as the installer (for example, tuxedo81_win.exe), it will be supplied automatically in silent mode. However, if installer.properties is in a different directory, you may use the -f command line option to specify the properties file. For example, filename.exe -f path\installer.properties

If installing BEA Tuxedo from the CD-ROM:

Open a command-line shell.

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

Invoke the installation procedure by entering the following command:

prompt> filename.exe -f path\installer.properties
where filename is the name of the BEA Tuxedo installer file specific to your platform, and path is the full or relative pathname of the installer.properties file.

To verify that the software installed successfully, see Performing Post-Installation Tasks.

Invoking the Silent Installation Process on a UNIX System

Installing the software using silent installation takes the same amount of time as a standard installation. During silent installation, a startup message appears followed by an "Installing . . ." message, indicating that the installation has started.

To invoke the silent 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.0 Platform Data Sheets.

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

For disk space requirements, see BEA Tuxedo 9.0 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 -f path/installer.properties
where filename is the name of the BEA Tuxedo installer file, and path is the full or relative pathname of the installer.properties file.

Note: If a file named installer.properties is present in the same directory as the installer (for example, tuxedo81_sol.exe), it will be supplied automatically in silent mode. However, if installer.properties is in a different directory, you may use the -f command line option to specify the properties file. For example, filename.exe -f path/installer.properties

If installing BEA Tuxedo from the CD-ROM:

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 -f path/installer.properties
where filename is the name of the BEA Tuxedo installer file specific to your platform, and path is the full or relative pathname of the installer.properties file.

To verify that the software installed successfully, see Performing Post-Installation Tasks.

Windows Template File

This sample Windows template file (installer.properties) applies to a silent installation of BEA Tuxedo 9.0.

Listing 4-1 Windows installer.properties Template File

INSTALLER_UI=silent
### Locale ###
USER_LOCALE=en
### BEA Home Directory ###
### NOTE: backslashes must be escaped. ###
BEAHOME=c:\\bea
### Product Installation Directory ###
USER_INSTALL_DIR=c:\\bea\\tuxedo9.0
### LDAP Service Name ###
LDAP_HOSTNAME=pcwiz.mydomain.com
### LDAP PortID ###
LDAP_PORTID=389
### LDAP BaseObject ###
LDAP_BASE_OBJECT="o=beasys.com"
### LDAP Filter File Location ###
LDAP_FILTER_FILE=c:\\bea\\tuxedo9.0\\udataobj\\security\\
bea_ldap_filter.dat
### Default Listen Port, User Can Run ###
### BEA Tuxedo 9.0 Administration in ###
### Control Panel to Change to Another Port ###
TLISTEN_PORT=1357 ###
### Tlisten Password ###
TLISTEN_PASSWORD=luckluck
### User License File ###
USER_LIC_FILE=c:\\mytux9_lic_dir\\lic.txt
### Valid Install Sets, select one:###
### CHOSEN_INSTALL_SET=Full Install ###
### CHOSEN_INSTALL_SET=Server Install ###
### CHOSEN_INSTALL_SET=Full Client Install ###
### CHOSEN_INSTALL_SET=ATMI Client Install ###
### CHOSEN_INSTALL_SET=CORBA Client Install ###
### CHOSEN_INSTALL_SET=Jolt Client Install ###
### NOTE: Spaces should not be included after the install set name. ### 
### If there are spaces after the install set name, the installation ###
### process uses the default mode Full Install. ###
CHOSEN_INSTALL_SET=Full Install

UNIX Template File

This sample UNIX template file (installer.properties) applies to a silent installation of BEA Tuxedo 9.0.

Listing 4-2 UNIX installer.properties Template File

INSTALLER_UI=silent
### Locale ###
USER_LOCALE=en
### BEA Home Directory ###
BEAHOME=/home/user/bea
### Product Installation Directory ###
USER_INSTALL_DIR=/home/user/bea/tuxedo9.0
### LDAP Service Name ###
LDAP_HOSTNAME=pcwiz.mydomain.com
### LDAP PortID ###
LDAP_PORTID=389
### LDAP BaseObject ###
LDAP_BASE_OBJECT="o=beasys.com"
### LDAP Filter File Location ###
LDAP_FILTER_FILE=/home/user/bea/tuxedo9.0/udataobj/security/
bea_ldap_filter.dat
### Tlisten Password ###
TLISTEN_PASSWORD=luckluck
### User License File ###
USER_LIC_FILE=/home/user/lic.txt
### Valid Install Sets, select one:###
### CHOSEN_INSTALL_SET=Full Install ###
### CHOSEN_INSTALL_SET=Server Install ###
### CHOSEN_INSTALL_SET=Full Client Install ###
### CHOSEN_INSTALL_SET=ATMI Client Install ###
### CHOSEN_INSTALL_SET=CORBA Client Install ###
### CHOSEN_INSTALL_SET=Jolt Client Install ###
### NOTE: Spaces should not be included after the install set name. ### 
### If there are spaces after the install set name, the installation ###
### process uses the default mode Full Install. ###
CHOSEN_INSTALL_SET=Full Install

What Do I Do Next?

To prepare for the post-installation tasks, read the following sections:

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