The following sections describe how to install BEA Tuxedo using graphical user interface (GUI) mode installation on both Windows and UNIX systems:
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. |
If you are upgrading from BEA WebLogic Enterprise or BEA Tuxedo 9.1 or earlier software, see Upgrading the BEA Tuxedo System to Release 10.0 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 10.0.
If you choose to remove the older software, refer to Upgrading the BEA Tuxedo System to Release 10.0, 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 10.0 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
To start the GUI-mode installation process on a Windows system, follow these steps:
The Windows XP systems support only BEA Tuxedo client components.
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.
For disk space requirements, see BEA Tuxedo 10.0 Platform Data Sheets. For important disk space allocation information, seeFile and Database Management and Disk Space Allocation.
Insert the BEA Tuxedo 10.0 product software DVD into the CD/DVD drive. Select the executable for your platform and double-click to initiate the installation process. For more information see, Tuxedo 10.0 Installation Binary Files.
To start the GUI-mode installation process on a UNIX system, follow these steps:
For disk space requirements, see BEA Tuxedo 10.0 Platform Data Sheets. For important disk space allocation information, see File and Database Management and Disk Space Allocation
where filename
is the name of the BEA Tuxedo installer file.
Note: | GUI mode is the default for Tuxedo 10.0 installation. If a GUI interface is not available on your Unix platform, you will receive an error message and the installation process is aborted. |
Note: | 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? |
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.
Select the install set that you want installed on your system. The following seven choices are available:
For a detailed list of software components for each install set, see Install Sets.
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.
|
|||||
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.
|
|||||
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.
|
|||||
Specify the directory in which you want to install the BEA Tuxedo software. You may select the default product directory (
tuxedo10.0 ) or create a new product directory. If you choose to create a new directory, the BEA Tuxedo installer automatically creates the directory for you.
|
|||||
No user input is required here. The installation program is installing BEA Tuxedo in the user-specified product directory.
|
|||||
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.
|
|||||
This window appears only if you have installed Server, ATMI 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.
|
|||||
|
|||||
Congratulations! Your installation of the BEA Tuxedo software is complete!
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_dir
chgrp -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.
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.
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 10.0 folder (Start Programs BEA WebLogic E-Business Platform Tuxedo 10.0) contains the following shortcuts:
In addition to the BEA Tuxedo Administration Console, the BEA Tuxedo 10.0 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 10.0 with VS2005 Administration) to perform the following tasks:
tlisten(1)
processes to start automatically For instructions on performing these tasks, see “Configuring BEA Tuxedo ATMI for Windows Server 2003” in Using BEA Tuxedo ATMI on Windows.
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\10.0_VS2005\...
To view this structure, choose Start Run to launch the Run dialog box, enter regEdt32
, and click OK to launch the Registry Editor window.
The Developer key stores product information, including the major and minor version numbers of the release, and user and company names.
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.
The Security key holds the access permissions for BEA Tuxedo processes and services. The following permissions are mandatory:
BEA recommends that the Administrator
have full control permissions.
To configure your BEA Tuxedo software, verify that your software is installed correctly, or to uninstall BEA Tuxedo software, see Performing Post-Installation Tasks.