Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 1 Introduction : Installer Overview

Installer Overview
This section introduces the adapter installer.
Installing the Adapter
Before you install the adapter, read this chapter and fill out the Pre-Installation Worksheets.
Software, hardware, other prerequisites, and installation instructions for each platform are in the appropriate section of this document:
Uninstalling the Adapter
You either can uninstall the adapter by runing the Tibuninstall.exe program directly or using TIBCO Installation Manager.
Using the Tibuninstall.exe Program
To use the the Tibuninstall.exe program directly:
Click Start>Programs>TIBCO>Adapter>Uninstall or navigate to the _uninst directory located in the Adapter installation directory and invoke the Tibuninstall.exe program.
Navigate to the _uninst directory located in the Adapter installation directory and invoke the Tibuninstall.bin program.
Using TIBCO Installation Manager
TIBCO Installation Manager is used to uninstall TIBCO products. It allows you to:
To start the program:
Click Start>All Programs>TIBCO>TIBCO Installation Manager
TIBCO_HOME/tibco/TibcoInstallationManager.bin
The TIBCO Installation Manager displays all TIBCO software installed on your machine. Details about the selected TIBCO product are displayed in the rows on the right. Click the Uninstall button to remove the selected product. Note that some products cannot be installed from the utility. Instructions about uninstalling these products are listed in the uninstall window after clicking the Uninstall button.
Click the TIBCO Installation Manager help button for information about using the program.
Installer Mode
You can run the installer in different modes. Each mode is supported on all platforms.
GUI Mode
In GUI mode, the installer presents panels that allow you to make choices about product selection, product location, and so on. When you invoke the installer by double-clicking on the icon, GUI mode is used.
Console Mode
Console mode allows you to run the installer from the command prompt or terminal window. This is useful if your machine does not have a Windows environment.
Silent Mode
Silent mode either installs using default settings or uses a response file that was saved during an earlier installation. Silent mode installs without prompting you for information.
If no response file has been recorded earlier and you invoke the installer with the -silent argument, the default installation parameters are used.
If a response file exists, and the installer is started with -options responseFileName as an argument, the installer uses the values specified by the user when the response file was generated.
Major, Minor and Patch Releases
Software from TIBCO uses three numbers to indicate whether the release is major, minor, or a patch. For example, 5.0.0 indicates a major release, 5.1.0 indicates a minor release, and 5.1.1 indicates a patch release.
For a major or minor release, the installer asks if you want to upgrade, and informs you if incompatible products are on your system. If you proceed, the major or minor release is installed in a new directory that is named using the major or minor release version number.
For example, if you have installed the 5.7.0 release and are upgrading to a 6.0.0 major release, the 6.0 release will be installed under the new 6.0 directory. This allows both the 6.0 and 5.7 releases to coexist on the same machine.
The installer for a patch release performs an automatic upgrade. For example, the installer automatically upgrades TIBCO ActiveMatrix Adapter for Tuxedo 5.0.0 to 5.0.1 by overwriting the contents of the 5.0 directory.
If you are upgrading the adapter or reinstalling a clean version of the software, you may uninstall the product first or allow the installer to perform the upgrade or reinstall.
You are not prompted to supply the installation location. The software is automatically reinstalled where the previous version was installed.
If any files are currently locked (that is, in use), the installer marks the file for deletion in the install location. After installation, the installer prompts you to reboot your system. You must reboot before using the software.
Calculating Available Disk Space
The installer calculates the disk space required in the adapter's home directory for the selected components. This calculation is done before starting to copy files. The installer will proceed only if sufficient free disk space is available.
If the available disk space is consumed by another process during installation and there is not enough room to finish, the installer may fail and display a failure message.
You can avoid this by not running other processes during installation that consume disk space in the adapter's home directory.
Installation Registry
The installer maintains an installation registry. (Note that the installer does not recognize TIBCO ActiveEnterprise 4.x products.) The registry location depends on the platform, as described below. The registry files have vpd as a prefix, which stands for Vital Product Database.
Microsoft Windows Platforms
ActiveEnterprise 6.x products maintain the installation registry in the SystemDrive:\WINDOWS directory. The following files represent the installation registry:
 
SystemDrive:\WINDOWS\vpd.properties
SystemDrive:\WINDOWS\vpd.properties.tibco.systemName
UNIX Platforms
The installation registry is maintained in the following files in the user's home directory:
 
User_Home_Directory/vpd.properties
User_Home_Directory/vpd.properties.tibco.systemName
If installation is performed by a super-user (root), the installation registry is maintained as follows:
On Solaris, HP-UX and AIX, in the root user’s home directory (which is /) as two VPD files.
Installation History
The installer and uninstaller create a file called TIBCOInstallationHistory.xml in the same location where the installation registry is created. Each time an installation or uninstallation is performed, entries are appended to the file.
On Microsoft Windows: SystemDrive:\WINDOWS\TIBCOInstallationHistory.xml
On UNIX:
Users_Home_Directory/TIBCOInstallationHistory.xml
The TIBCOInstallationHistory.xml file contains the record of all installation and uninstallation activities of all products, features, and components.
Do not edit, modify, rename, move, or remove the TIBCOInstallationHistory.xml file.

Copyright © TIBCO Software Inc. All Rights Reserved