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?

• Before You Start

• Using Silent Installation: Main Steps

• Creating a Template File

• Invoking the Silent Installation Process on a Windows System

• Invoking the Silent Installation Process on a UNIX System

• Windows Template File

• UNIX Template File

• What Do I Do Next?

 

---

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.0 or earlier software, see Upgrading the BEA Tuxedo System to Release 8.1 and follow the instructions given there. Then return here to continue your BEA Tuxedo installation.

 

---

Using Silent Installation: Main Steps

The silent installation process has two primary steps:

1. 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.

2. 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:

1. 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.

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

3. 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=	The mode of installation. The default is silent; do not modify this value.
   USER_LOCALE=	A language code determining the language-specific message catalog installed during the installation. Besides en (the default) for English, you can set this value to ja (or ja_JP) for Japanese.
   BEAHOME=	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=	The full pathname of the product directory of your choice.
   C_ldapName=	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.)
   C_ldapPortID=	The port number through which the local machine communicates with the LDAP server; for example, 389.* (See Note at end of table.)
   C_ldapBaseObj=	The distinguished name of the base object for search in the LDAP server; for example, o=beasys.com. (See Note at end of table.)
   C_ldapFiltFile=	The full pathname of the LDAP filter file on your machine; for example, C:\bea\tuxedo8.1\udataobj\security\ bea_ldap_filter.dat. (See Note at end of table.)
   C_tlistenPassword=	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=	The full pathname of the BEA Tuxedo 8.1 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: Note: The valid options are case sensitive and should be coded exactly as defined below for proper installation. If a valid option is not used, a faulty installation results. Full Install for a full installation, Server Install for server-only installation, Full Client Install for full client installation, ATMI (WS) Client Install for ATMI-client-only (/WS) installation, CORBA Client 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.
   BEAHOMES_NEW (Windows only)	The list of BEA home directories of the various BEA products installed on the machine. Prepend any new BEA home directories. Use a semicolon to separate entries. The list of existing BEA home directories are available in the BEAHOMELIST registry entry or from the file: C:\bea\beahomelist For example, given the following registry entry, c:\bea\tux\80;c:\tux if you set the BEAHOME keyword in the template file to: BEAHOME=D:\\bea\\tux\\80: then you would also set BEAHOMES_NEW=D:\\bea\\tux\\80;c:\\bea\\tux\\80;c:\\tux Note: Backslashes must be escaped.

   
    

Note: Keywords C_ldapName, C_ldapPortID, C_ldapBaseObj, and C_ldapFiltFile are optional. Include these keywords and their values only if you install CORBA server and/or client software components on your machine 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:

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

   The Windows 98 or XP system supports only BEA Tuxedo client components.

2. Log in to the Windows system as the Administrator or as a member of the Administrator group.

   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.

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

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

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

   1. Open a command-line shell.

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

   3. 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

5. If installing BEA Tuxedo from the CD-ROM:

   1. While pressing and holding the Shift key, insert the BEA Tuxedo CD-ROM into the CD-ROM drive. Hold the Shift key for approximately 10 seconds to bypass the autorun feature.

   2. Open a command-line shell.

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

   4. 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.

6. 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:

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

2. Log in to the UNIX system as the BEA Tuxedo administrator.

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

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

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

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

   2. 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

5. If installing BEA Tuxedo from the CD-ROM:

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

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

   3. 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.

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

 

---

Windows Template File

This sample Windows template file applies to a silent installation of BEA Tuxedo 8.1.

###############################################
### Silent Installation Properties 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\\tuxedo8.1
###############################################
### LDAP Service Name
###############################################
### C_ldapName=pcwiz.mydomain.com
###############################################
### LDAP PortID
###############################################
### C_ldapPortID=389
###############################################
### LDAP BaseObject
###############################################
### C_ldapBaseObj="o=beasys.com"
###############################################
### LDAP Filter File Location
###############################################
C_ldapFiltFile=C:\\bea\\tuxedo8.1\\udataobj\\security\\bea_ldap_filter.dat
###############################################
### Default Listen Port, User Can Run
### BEA Tuxedo 8.1 Administration in
### Control Panel to Change to Another Port
###############################################
C_serverListenPort=3050
###############################################
### Tlisten Password
###############################################
C_tlistenPassword=abcd1234
###############################################
### User License File
###############################################
USER_LIC_FILE=C:\\myfiles\\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 (WS) Client Install
### CHOSEN_INSTALL_SET=CORBA Client Install
### CHOSEN_INSTALL_SET=Jolt Client Install
###############################################
CHOSEN_INSTALL_SET=Full Install
###############################################
### List of BEA Home Directories
###############################################
BEAHOMES_NEW=C:\\bea

Post Release Windows Platform Template File

The following post-release Windows platforms use a slightly modified silent install template:

• Microsoft Windows 2003 Server (32-bit) on x86

• Microsoft Windows 2003 Server (64-bit) on Itanium

Please note the following example:

###############################################
### Silent Installation Properties File
###############################################
INSTALLER_UI=silent
###############################################
### BEA Home Directory
### NOTE: backslashes must be escaped.
###############################################
BEAHOME=C:\\home\\user\\bea
###############################################
### Product Installation Directory
###############################################
USER_INSTALL_DIR=C:\\home\\user\\bea\\tuxedo8.1
###############################################
### LDAP PortID
###############################################
LDAP_PORTID=389
###############################################
### LDAP Host Name
###############################################
LDAP_HOSTNAME=pcwiz.mydomain.com
###############################################
### LDAP BaseObject
###############################################
LDAP_BASE_OBJECT="o=beasys.com"
###############################################
### LDAP Filter File Location
###############################################
LDAP_FILTER_FILE=C:\\home\\user\\bea\\tuxedo8.1\\udataobj\\security\\bea_ldap_filter.dat
###############################################
### Default Listen Port, User Can Run
### BEA Tuxedo 9.1 Administration in
### Control Panel to Change to Another Port
###############################################
TLISTEN_PORT=1357
###############################################
### Tlisten Password
###############################################
TLISTEN_PASSWORD=luckluck
###############################################
### User License File
###############################################
USER_LIC_FILE=C:\\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
###############################################
CHOSEN_INSTALL_SET=Full Install

 

---

UNIX Template File

This sample UNIX template file applies to a silent installation of BEA Tuxedo 8.1.

###############################################
### Silent Installation Properties File
###############################################
INSTALLER_UI=silent
###############################################
### Locale
###############################################
USER_LOCALE=en
###############################################
### BEA Home Directory
###############################################
BEAHOME=/home/rsmith/bea
###############################################
### Product Installation Directory
###############################################
USER_INSTALL_DIR=/home/rsmith/bea/tuxedo8.1
###############################################
### LDAP Service Name
###############################################
### C_ldapName=pcwiz.mydomain.com
###############################################
### LDAP PortID
###############################################
### C_ldapPortID=389
###############################################
### LDAP BaseObject
###############################################
### C_ldapBaseObj="o=beasys.com"
###############################################
### LDAP Filter File Location
###############################################
### C_ldapFiltFile=/home/rsmith/bea/tuxedo8.1/udataobj/security/
    bea_ldap_filter.dat
###############################################
### Default Listen Port
###############################################
C_serverListenPort=3050
###############################################
### Tlisten Password
###############################################
C_tlistenPassword=abcd1234
###############################################
### User License File
###############################################
USER_LIC_FILE=/home/rsmith/lic.txt
###############################################
### Default Install Set
###############################################
### 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 (WS) Client Install
### CHOSEN_INSTALL_SET=CORBA Client Install
### CHOSEN_INSTALL_SET=Jolt Client Install
###############################################
CHOSEN_INSTALL_SET=Full Install

Post Release UNIX Platform Template File

The following post-release UNIX platforms use a slightly modified silent install template:

• Red Hat Linux Advanced Server 3.0 (64-Bit) on Itanium 2

• Solaris 10 (32-bit) on x86-64

• SUSE Linux Enterprise Server 9.0 (32-bit) on x86

Please note the following example:

###############################################
### Silent Installation Properties File
###############################################
INSTALLER_UI=silent
###############################################
### BEA Home Directory
###############################################
BEAHOME=/home/user/bea
###############################################
### Product Installation Directory
###############################################
USER_INSTALL_DIR=/home/user/bea/tuxedo8.1
###############################################
### LDAP PortID
###############################################
LDAP_PORTID=389
###############################################
### LDAP Host Name
###############################################
LDAP_HOSTNAME=pcwiz.mydomain.com
###############################################
### LDAP BaseObject
###############################################
LDAP_BASE_OBJECT="o=beasys.com"
###############################################
### LDAP Filter File Location
###############################################
LDAP_FILTER_FILE=/home/user/bea/tuxedo8.1/udataobj/security/bea_ldap_filter.dat
###############################################
### Default Listen Port
###############################################
TLISTEN_PORT=1357
###############################################
### 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
###############################################
CHOSEN_INSTALL_SET=Full Install

 

---

What Do I Do Next?

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

• Assigning File Ownership on a UNIX System

• Understanding the BEA Tuxedo Shortcuts on a Windows System

• Understanding the BEA Administration Program on a Windows System

• Reviewing the Windows 2000 Registry Content

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