Installing on Microsoft Windows


Before starting the installation procedure, review the topics in this section to determine that your system meets the basic requirements and that you have the prerequisite software installed.

The following is a list of prerequisites for installing the adapter on Microsoft Windows systems. See Installer Disk Space Requirements in Temporary Area for additional disk space requirements.

Table 3 Supported platforms, package names, service packs and disk space for Microsoft Windows
Platform
Package Names
Service Pack
Hardware
Disk Space (MB)
Microsoft Windows 2000
TIB_adcom-simple_5.3.0_w32.exe
Service Pack 3
x86
45
Microsoft Windows XP Professional
Service Pack 1a
x86
45
Microsoft Windows Server 2003
 
x86
45

If you are using the Recordset feature or the ADO connection object feature, you will need version 2.5 of the Microsoft ADODB libraries.

TIBCO Runtime Agent Must be Installed Before the Adapter

Before you can install the adapter, you must install the TIBCO Runtime Agent. If you use the Typical installation, the installer places all libraries and other products required by the adapter into the TIBCO HOME directory.

During installation, the adapter installer checks for the availability of all dependent products in the target system. If any of the dependencies are not available, the installer will immediately exit. Otherwise installation will proceed.

This release of the adapter requires TIBCO Runtime Agent 5.2.1 Hotfix3.

Installer Account

You must have administrator privileges for the machine on which the adapter is installed.

If you do not have administrator privileges, the installer will exit. You must then log out of the system and log in as a user with the required privileges, or request your system administrator to assign the privileges to your account.

Installing from Network Drive

If you intend to install the product on a network drive, you must ensure that the account used for installation has permission to access the network drive.

Installing on Microsoft Windows 2000 and 2003 Terminal Server

There are two modes in the Microsoft Windows Terminal Server: Execute and Install. Users are logged on by default in the Execute mode, which allows them to run applications. To install an adapter so that everyone can use it, log on as administrator in Install mode. When the adapter is installed in the Install mode, the installation registry is maintained in SystemDrive:\WINNT\.

Microsoft Windows Terminal Server must be running in remote admin mode, not application sharing mode. The adapter is not supported if it is installed on a machine that is using Microsoft Windows Terminal Server in the application sharing mode.

The best way to install the adapter on Microsoft Windows Terminal Server is to use the Add/Remove Programs control panel applet. This automatically sets your mode to Install during the installation and then back to Execute afterwards. Alternatively, you can manually change your mode to Install before starting the installation by typing the following at a command prompt:

   C:\> change user /install 

Change back to Execute mode after installation is complete by typing:

   C:\> change user /execute 

To check your current mode, type the following:

   C:\> change user /query

Installing the Adapter on Microsoft Windows

You can either download the adapter package or install the package from a CD. The installer prompts you to accept the license agreement, then to choose to perform a typical install or custom install.

The installer checks your system for the installation home directory that was established when TIBCO Runtime Agent was installed. The adapter is installed under the installation home directory.

Use one of the following modes to install the software.

Install Using GUI Mode

GUI Mode allows you input values in panels. Type the following at the command prompt:

 
TIB_adcom-simple_5.3.0_w32.exe 
Install Using Console Mode

Console mode allows you to install the software in a non-Microsoft Windows environment. The installer will prompt you for values. Type the following at the command prompt:

 
TIB_adcom-simple_5.3.0_w32.exe -is:javaconsole -console 

When running in console mode you can move through the installation process as described next:

 
Enter Key = Moves forward in the installer 
2 = Goes back to previous screen 
3 = Cancels the Wizard and exits the installation or uninstallation 
4 = Redisplays the current screen 
Install Using Silent Mode

Silent mode allows you to install the software without prompts. Type the following at the command prompt:

 
TIB_adcom-simple_5.3.0_w32.exe -silent 
Install and Generate a Response File

You can generate a response file during installation which you can later use to invoke the installer with the selected values as default values (GUI mode) or as selected values (silent mode).

To install and generate a response file, type the following at the command prompt:

TIB_adcom-simple_5.3.0_w32.exe -options-record 
                                       C:\directory\<responseFile>
The response file does not record selections at the component level. It does record all other selections, for example, which products you wished to install.
 
Install Using a Response File

You can use a previously generated response file for installation. For non-silent modes, the response file determines the defaults that are presented. For silent mode, the response file determines what will be installed.

To install using a response file, type the following at the command prompt:

TIB_adcom-simple_5.3.0_w32.exe -options                                    C:\directory\<responseFileName>

Combining Options

You can combine the different available options. For example, to install in silent mode using a response file, use:

TIB_adcom-simple_5.3.0_w32.exe -silent -options <responseFileName>

To install using Console mode and generate a response file, use:

TIB_adcom-simple_5.3.0_w32.exe -is:javaconsole -console                            -options-record <responseFileName>

Post-Installation Tasks

Verifying System Variables

Ensure that the installer has set the system variable TIB_ICU_DATA to the <TRA_HOME>\config\g11n folder. If this variable has not been set, you must set it manually.

To set the system variable TIB_ICU_DATA manually:

  1. Open the Environment Variables applet from the Control Panel.
  2. Under System Variables, click New. The New System Variable dialog is displayed.
  3. In the Variable Name field, type TIB_ICU_DATA.
  4. In the Variable Value field, type the path to the <TRA_HOME>\config\g11n folder.

Running the Interceptor

To run the interceptor, you must run the setenv.bat file first so that the path is set. The installer installs the interceptor as:

To update the system variable:

  1. Include the following in the system variable PATH:
    • <ADCOM_HOME>\hotfix\bin and <ADCOM_HOME>\hotfix\lib
    • <ADCOM_HOME>\bin and <ADCOM_HOME>\lib
    • <TRA_HOME>\bin and <TPCL_HOME>\bin
  2. Restart the machine.
  3. Register the interceptor(.dll) from the <ADCOM_HOME>\bin directory.

TIBCO Adapter™ for COM User’s Guide
Software Release 5.3, September 2005
Copyright © TIBCO Software Inc. All rights reserved
www.tibco.com