Preparing to Install the Oracle TSAM Plus Manager

The following sections provide information that you need to know before installing the Oracle TSAM Plus Manager 12c Release 2 (12.2.2) product software:

•	Oracle Universal Installer (OUI)

•	Oracle TSAM Plus Manager Web Distribution

•	TEMP/TMP Directory

•	Oracle Installation Program

•	Installation Road Map

For information about installing the Oracle TSAM Plus Agent, see Installing Oracle Tuxedo Using GUI-Mode Installation.

Oracle Universal Installer (OUI)

The Oracle Tuxedo 12c Release 2 (12.2.2) product software installer is based on the Oracle Universal Installer (OUI). To install the Oracle Tuxedo 12c Release 2 (12.2.2) product software on your host, you must know how to use OUI to install Oracle products. For more information, see Introduction to Oracle Universal Installer.

Modes of Installation

You can use OUI to install Oracle products in any of the three following modes:

•	Interactive:

Use OUI interactive mode to use the graphical user interface to walk through the installation, providing information in the installation dialogs when prompted. This method is most useful when installing a small number of products in different setups on a small number of hosts.

•

Silent:

Use OUI silent installation mode to bypass the graphical user interface and supply the necessary information in a response file. This method is most useful when installing the same product multiple times on multiple hosts. By using a response file, you can automate the installation of a product for which you know the installation parameters.

Note:

You can use the -noConsole flag on Windows to suppress the display of console messages.

Installation Media

Note:

On Windows, when you start the installer from a shared drive, you need to map the shared drive and then invoke the installer from the shared drive. When you invoke runInstaller.sh (UNIX) or setup.bat (Windows), you should invoke it from the directory where this command is present, or you must specify the complete path to runInstaller.sh (UNIX) or setup.bat (Windows).

Special Instructions for UNIX Users

The following sections describe special instructions that apply when you are installing certain products on a UNIX system.

Failed to Connect to Server Error

If you receive an Xlib error or a "Failed to connect to Server" error when you are running OUI on the Solaris operating system, do the following:

1.	Define the following environment variable on the host computer where you are running OUI:

%setenv DISPLAY <machine name>:0.0

2.	Replace <machine name> with the name of the computer that will display OUI.

3.	On the computer that will display OUI, enter the following command, which allows other computers to display information on the computer monitor: %xhost +

4.	Rerun the runInstaller.sh script after you have set the DISPLAY environment variable.

Note:

You can run OUI without specifying the DISPLAY variable by running in silent mode using a response file.

Providing a UNIX Installer Location with Root Privileges

You must have root privileges to perform various UNIX installation operations. For example, you must have root privileges to be able to create the OUI inventory.

If you are installing OUI for the first time, you are prompted to run a shell script from another terminal window before proceeding with the installation. OUI prompts you to run root.sh after installation completes only if the script is required to run as root before configuration assistants are run. Otherwise, you are prompted to run root.sh as root later.

Note:

When running OUI in silent mode, if root.sh is required prior to configuration assistants, OUI skips configuration assistants during the installation. You must run root.sh as root and then run the skipped configuration assistants after the silent installation is complete.

To successfully run the required shell script:

1.	Leave the OUI window open and open another terminal window.

2.	In the new terminal window, use the substitute user command to log in with root privileges: su -root

3.	Change directory to the Oracle home into which you are currently installing your Oracle software product.

4.	Run the shell script ./root.sh.

5.	When the script is finished and you are returned to the command prompt, exit from the new terminal window and return to OUI to continue installation.

Note:

Do not exit the installation to run the shell script. Exiting the installation removes this script.

You are prompted to run the script only the first time you install.

Providing a UNIX Group Name

If you are installing a product on a UNIX system, the Installer also prompts you to provide the name of the group that owns the base directory.

You must choose a UNIX group name that has permissions to update, install, and remove Oracle software. Members of this group must have write permissions for the chosen base directory.

Only users who belong to this group are able to install or remove software on this host.

About Oracle Universal Installer Log Files

When you install or deinstall products using OUI, important information about each installation is saved not only in the inventory, but also in a series of log files, located in the following directory:

$ORACLE_HOME/cfgtoollogs

You can use these log files to troubleshoot installation problems. These files are also crucial for removing and configuring the various software components you install. OUI displays the name and location of the current session log file on the Install page. Each installation or configuration utility provides a separate folder containing the logs inside the $ORACLE_HOME/cfgtoollogs folder.

Note:

The logs used to remove products are different from the installActions<timestamp>.log generated during the install process. The installActions<timestamp>.log is easier to read and can be used to view the operations performed at installation time.

Oracle Internationalization

Installation Dialogs Language

OUI runs in the operating system language. OUI uses the language that Java detects, the system locale value, and sets that to the default language. OUI dialogs are displayed in this language if available. If specific OUI dialogs are not translated in the language of the operating system, these dialogs are shown in English.

OUI displays the translated GUI only if the variable NLS_ENABLED has been set to TRUE in the oraparam.ini file. If the NLS_ENABLED variable is set to FALSE, all text is shown in English.

Note:

The dialogs displayed for internationalization can only be customized parts; some of them are embedded in OUI.

Oracle TSAM Plus Manager Web Distribution

An evaluation copy of Oracle TSAM Plus Manager is available for download from the Oracle corporate Web site at http://www.oracle.com/technology/software/index.html.

Platform-specific installer files for the Oracle TSAM Plus Manager product software are available for download from the Oracle corporate Web site.

TEMP/TMP Directory

During both UNIX and Windows installation, temporary copies of Oracle Universal Installer and JRE are placed in the TEMP or TMP directory in a subdirectory named /OraInstall<timestamp>. On both UNIX and Windows, Oracle Universal Installer looks for %TEMP% then %TMP%. If neither is set, Oracle Universal Installer defaults to /tmp on UNIX and c:\temp on Windows.

Note:

The TEMP/TMP directory should not be a cluster file system or a shared location.

Software Requirements

Java Development Kit (JDK) 1.8.0 or Java Runtime Environment (JRE) 1.8.0 is required to install Oracle Tuxedo System and Applications Monitor Plus. You need to install the required JRE and set the environment variable JAVA_HOME accordingly before installing Oracle Tuxedo System and Applications Monitor Plus.

Note:

If you choose to install "Bundled WebLogic", you need to run TSAM Plus Manager 12.2.2 installer with the following JDK versions.

•	Oracle JDK (64-bit): Tested with 1.8.0_60 on Linux, and 1.8.0_74 on Solaris

•	HP JDK (64-bit): Tested with Java version 1.8.0.04-hp-ux

•	IBM JDK (64-bit): Tested with 1.8.0 SR2 FP10

Oracle Installation Program

The Oracle TSAM Plus Manager software is distributed as an installer file, which also contains a copy of the Oracle Installation program. The Oracle Installation program is the Oracle standard tool for installing the Oracle TSAM Plus Manager software on Windows or UNIX systems.

Cancelling Installation

Clicking the “Cancel” or the “close’ window button in GUI mode causes an incomplete Oracle TSAM Plus Manager 12c Release 2 (12.2.2) installation. You will have to re-install Oracle TSAM Plus Manager 12c Release 2 (12.2.2).

Installation Road Map

You are now ready to begin your installation. To install Oracle TSAM Plus Manager 12c Release 2 (12.2.2), see one of the following sections:

•	“Installing Oracle TSAM Plus Manager Using GUI-Mode Installation” on page 2‑1

•	“Installing Oracle TSAM Plus Manager Using Silent Installation” on page 3‑1