Installing the Tuxedo System

Installing BEA Tuxedo on UNIX Systems Using Console-Mode Installation

The following sections describe how to install BEA Tuxedo using console-mode installation:

What Is Console-Mode Installation?

Console-mode installation is the text-based method of executing the BEA Installation program. It can be run only on UNIX systems and is intended for UNIX systems with non-graphics consoles. Console-mode installation offers the same capabilities as graphics-based 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.0 and follow the instructions given there. Then return here to continue your BEA Tuxedo installation.

Starting Console-Mode Installation

To start the console-mode installation process, 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 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> sh filename.bin -i console
where filename is the name of the BEA Tuxedo installer file.

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 -i console
where filename is the name of the BEA Tuxedo installer file specific to your platform.

Proceed to Running Console-Mode Installation.

Running Console-Mode Installation

To complete the console-mode installation process, which is currently available in English and Japanese, respond to the prompts in each section with one of the following actions.

Enter the number associated with your choice or press <Enter> to accept the default.
Enter back or previous at the prompt to review or change your selection.
Enter quit in response to any prompt to exit the installation process.

In This Section . . .	Perform the Following Action . . .
Choose Locale	Choose a language by entering the number associated with that language. Your choice determines both the language displayed during the installation and the language-specific message catalog installed during the installation. `====================================================` `Choose Locale...` `->1- English` `CHOOSE LOCALE BY NUMBER:` `====================================================` Note: Launching console-mode installation on a system that utilizes a Japanese language environment adds a second choice, 2- Japanese, at the `CHOOSE LOCALE BY NUMBER` prompt.
Introduction	Press Enter to continue with the installation process.
License Agreement	Read the BEA Software License Agreement and indicate your acceptance or rejection of the terms of the agreement by entering `Y` or `N`, respectively, at the prompt. To review the entire agreement, you must press Enter several times. To proceed with the installation, you must enter `Y` to indicate your agreement with the terms of the license. If you enter `N`, the following warning appears: `Warning: If you do not accept the licensing terms you will not be allowed to continue with the install.` `DO YOU AGREE WITH THE TERMS OF THE LICENSE? (Y/N):` If you enter `N`, the installation process terminates.
Choose Install Set	Select the install set that you want installed on your system. The following choices appear: `====================================================` `Choose Install Set ------------------ Please Choose the Install Set to be installed by this installer.` `->1- Full Install 2- Server Install 3- Full Client Install 4- Jolt Client Install 5- ATMI Client Install 6- CORBA Client Install 7- CUSTOM Install` `ENTER THE NUMBER FOR THE INSTALL SET, OR <ENTER> TO ACCEPT THE DEFAULT:` `====================================================` For a list of software component for each install set, see Install Sets. Your selection includes the appropriate encryption software for Link-Level Encryption (LLE) and/or Secure Sockets Layer (SSL).
Custom Install	Select custom features. `====================================================` Custom Install ------------------ Enter a comma-separated list of numbers representing the features you want to select or deselect. To view a feature's description, enter `?<number>'. Press <RETURN> when you are done. `1-[X] Server Install 2-[X] Full Client Install 3-[X] Jolt Client Install 4-[X] ATMI Client Install 5-[X] CORBA Client Install` `SELECT FEATURES FOR CUSTOM INSTALLATION:` `====================================================`
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 will automatically create the directory for you. For details about the BEA Home directory, see BEA Home Directory. Enter `1` to create a new BEA Home directory or, if you already have a BEA Home directory on your system, enter `2` to select an existing BEA Home directory. Be sure to use the full pathname when specifying a new BEA Home directory. For example: `====================================================` `Choose BEA Home Directory ------------------------- 1- Create a New BEA Home 2- Use Existing BEA Home Enter a number: 2 1- /home3/bea 2- /home2/beahome Existing BEA Home: 1` `====================================================` In this example, we enter `2` to display the BEA Home directories that have already been created on this system. At the `Existing BEA Home` prompt, we enter `1` to specify `/home3/bea` as the BEA Home directory for this installation. Make sure that you enter the number associated with the BEA Home directory instead of the directory name. If a previous Tuxedo installation is in the existing directory you selected, the following screen appears: `====================================================` `A previous installation of Tuxedo 8.1 has been detected at /home3/bea.` `The following options are available:` `1- Continue to install over /home3/bea 2- Cancel to select another BEA Home Directory: 3- Exit the installation` `CHOOSE A NUMBER:` `====================================================`
Choose Product Directory	Specify the directory in which you want to install the BEA Tuxedo software. You may select the default product directory (`tuxedo9.0`) or create a new product directory. If you choose to create a new directory, the BEA Tuxedo installer will automatically create the directory for you. The initial default installs the product directory under the BEA Home directory you specified in the previous section. To accept this default, enter `2` at the prompt. The choices displayed in this section are as follows: `=================================================== Choose Product Directory ------------------------ 1- Modify Current Selection (/home3/bea/tuxedo9.0) 2- Use Current Selection (/home3/bea/tuxedo9.0) Enter a number:` `===================================================` Enter `1` to select an alternate directory. The following text appears: `Specify Product Installation Directory:` Specify a product directory using its full pathname. For example: `/home3/mytux9.0`. When you press Enter, your modified selection appears as the default. `1- Modify Current Selection (/home3/mytux9.0) 2- Use Current Selection (/home3/mytux9.0) Enter a number:` Enter `2` to accept the current selection. If you enter `2` at the initial prompt, you accept the default product directory (`/home3/bea/tuxedo9.0` in this example).
Pre-Installation Summary	`Review your installation selections. Enter back or previous to modify installation selection. Otherwise press <ENTER> to continue.` `====================================================` `Pre-Installation Summary ------------------------- Please Review the Following Before Continuing:` `Product Name: Tuxedo` `Install Folder: /home3/bea/tuxedo9.0` `Link Folder: /home3/bea` `Disk Space Information (for Installation target): Required: 320,768,364 bytes Available: 217,498,034,176 bytes` `PRESS <ENTER> TO CONTINUE:` `====================================================`
Installing . . .	No user input is required here. The installation program is installing BEA Tuxedo in the user-specified product directory. It is normal for the installation progress bar to stop for a fairly long time, especially at the end. The BEA Tuxedo installer is still working when this occurs.
Configure tlisten Service	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. 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.
SSL Installation Choice	`===================================================` `SSL Installation Choice ------------------------` `Would you like to install SSL Support?` `->1- Yes 2- No` `ENTER SELECTION, OR PRESS <ENTER> FOR DEFAULT:` `===================================================`
Enter Your LDAP Settings for SSL Support	This section appears only if you have installed CORBA server and/or client software 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. `===================================================` `Enter Your LDAP Settings for CORBA SSL Support ------------------------ 1- Enter LDAP Configuration Information 2- Do Not Enter LDAP Configuration Information Enter a number:` `===================================================` Choose whether or not you want to enter LDAP configuration information. If you intend to use SSL encryption in your application, enter `1` and then enter the following LDAP configuration information: Fully qualified domain name of the LDAP server Port number through which the local machine communicates with the LDAP server Distinguished name of the base object for search in the LDAP server LDAP filter file location For example: `===================================================` `Enter Your LDAP Settings for CORBA SSL Support ------------------------ 1- Enter LDAP Configuration Information 2- Do Not Enter LDAP Configuration Information Enter a number: 1` `LDAP Service Name: pcwiz.beasys.com LDAP PortID: 389 LDAP BaseObject: o=beasys.com LDAP Filter File Location: /home3/bea/tuxedo9.0/ udataobj/security/bea_ldap_filter.dat` `===================================================` To not enter LDAP information, enter `2` to proceed to the next section.
License Selection Option	Choose whether or not you want to install the BEA Tuxedo product license now. To install the license now, read the following important information, enter `1`, and then specify the location of the license file on your machine. 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. The actual wording in the License Selection Option section differs between a Tuxedo server installation (Full Install, Server Install) and a client only installation. The following example applies to a Tuxedo server installation: `===================================================` `License Selection Option ------------------------ 1- Copy License File Now 2- Copy License File Later Enter a number: 1` `Specify a Path to your License File: /home3/lic.txt` `===================================================` To install the license later, select `2` to proceed to the next section. For instructions on installing the product license manually, see Installing the Product License After You Install BEA Tuxedo.
Install Complete	Press Enter to exit the installation program.

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

What Do I Do Next?

To prepare for the post-installation tasks, see Assigning File Ownership on a UNIX System. To configure your BEA Tuxedo software and verify that your software is installed correctly, see Performing Post-Installation Tasks.