Copyright © Cloud Software Group, Inc. All Rights Reserved

Installation

The following sections describe the installation process in the available installation modes:

•

GUI Mode

•	Console Mode

•	Silent Mode

The installer backs up the existing TIBCO API Exchange Gateway 2.1.0 installation files in the following directory: ASG_HOME\servicepack\sp1\backup

GUI Mode

To install this product in GUI mode, follow these steps:

1.	Open the physical media or download the package.

2.	Extract the contents of the package to a temporary directory.

3.	Navigate to the temporary directory.

4.	Run TIBCO Universal Installer executable (TIBCOUniversalInstaller*) in one of the following ways:

•	Double-click the installer executable file.

•	On the command prompt, run the installer executable TIBCOUniversalInstaller* file without specifying any options. The installer defaults to GUI mode.

For example,

On the Windows 64-bit platform, run the following installer executable file: TIBCOUniversalInstaller-x86-64.exe

On the Linux platform, run the installer as follows: ./TIBCOUniversalInstaller-lnx-x86-64.bin

5.	Click the Next button on the Welcome dialog.

6.	Read through the license text when the License Agreement dialog appears, select the I Accept The Terms of The License Agreement radio button.

7.	Click the Next button. The TIBCO Installation Home dialog displays.

An installation environment isolates product installations. A product installed into an installation environment does not access components in other installation environments. An installation environment consists of a name and path. You can choose a new environment or an existing environment.

−	Create A New TIBCO_HOME  This option is used to install the product into a new installation environment. Do not use this option as this product requires an existing TIBCO Rendezvous and TIBCO API Exchange Gateway 2.1.0 installation.

−	Use an existing TIBCO_HOME   Select this radio button, and select the directory from the drop-down list where TIBCO API Exchange Gateway 2.1.0 is installed. TIBCO API Exchange Gateway 2.1.1 is installed in this directory.

8.	Click the Next button.

9.	Select Typical as the installation profile from the list on the left. This is the default option. This profile installs the typical feature set for this product.

TIBCO Universal Installer allows customization of the profile feature settings. For this option, select the Customize Installation check box and use the feature tree on the right.

10.	Click the Next button.

11.	Review the information such as Installation Environment Details, Environment Location, and Environment Configuration Directory Location in the Pre-Install Summary dialog.

12.	Click the Install button to start the installation process.

13.	Review the information listed in the Post-Install Summary dialog.

14.	Click the Finish button to complete the installation process and exit TIBCO Universal Installer.

TIBCO API Exchange Gateway 2.1.1 uses the same configuration directory as specified in the TIBCO API Exchange Gateway 2.1.0 installation.

Console Mode

To install this product in console mode, follow these steps:

1.	Open the physical media or download the package.

2.	Extract the contents of the package to a temporary directory.

3.	Using a console window, navigate to the temporary directory that contains TIBCO Universal Installer.

4.	Run the TIBCO Universal Installer executable (TIBCOUniversalInstaller*) using this command line:

TIBCOUniversalInstaller -console

For example,

On Windows 64-bit platform, run the installer as follows:

TIBCOUniversalInstaller-x86-64.exe -console

On Linux platform, type the following command:

   ./TIBCOUniversalInstaller-lnx-x86-64.bin -console

5.	Complete the installation by responding to the console window prompts.

Silent Mode

In silent mode, TIBCO Universal Installer does not prompt for any inputs during installation. Instead, the inputs are read from a response file that can be provided as a command-line parameter. If no value is specified, the installer uses the default TIBCOUniversalInstaller-asg.silent file.

The TIBCOUniversalInstaller-asg.silent file is packaged in the directory that contains the universal installer. Edit the file with information for your environment before launching the silent installation. The file includes comments that describe the installation properties you can set.

While you can use the TIBCOUniversalInstaller-asg.silent file, copy the file to a different name and use that file for the silent install.

If errors occur during installation, they are listed in the installation log file located in the User_Home/.TIBCO directory.

1.	Open the physical media or download the package.

2.	Extract the contents of the package to a temporary directory.

3.	Using a console window, navigate to the temporary directory.

4.	Backup the TIBCOUniversalInstaller-asg.silent file to TIBCOUniversalInstaller-asg.silent.backup file.

5.	Using a text editor, open the TIBCOUniversalInstaller-asg.silent file and update the install location, ENV_NAME, and features to install as follows:

 

a.	Update the install location. This indicates the directory where the product is to be installed. For example, update the directory as follows:

<entry key="installationRoot">/home/asg/tibcoasg</entry>

b.	Update ENV_NAME.

For example, update ENV_NAME as follows:

<entry key="createNewEnvironment">false</entry>

<entry key="environmentName">TIBCO_HOME</entry>

c.	Update TIBCO Configuration Directory. This directory is used to store the configuration information.

For example, update configDirectoryRoot as follows:

<entry key="configDirectoryRoot">/home/user/tibco</entry>

• If TIBCO API Exchange Gateway is installed in a directory which has a configuration directory already set by another TIBCO product (for example, TIBCO Enterprise Message Service), you do not need to set the configDirectoryRoot in the silent file. In this case, the silent installer uses the value of configDirectoryRoot as already set and ignores the value if set in the silent file. • Set the configuration directory specified by the configDirectoryRoot property same as the configuration directory set for TIBCO API Exchange Gateway 2.1.0.

d.	Update features to install. Set the features that you want to install to true.

For example, following key values must be set to true to install both TIBCO API Exchange Gateway and the documentation for TIBCO API Exchange Gateway.

<entry key="feature_Runtime_api-exchange-gateway">true</entry>

<entry key="feature_Documentation_api-exchange-gateway">true</entry>

6.	Run TIBCO Universal Installer (TIBCOUniversalInstaller*) using the following command, replacing myfile.silent with your response silent file name:

TIBCOUniversalInstaller -silent -V responseFile="myfile.silent"

For example,

On the Windows 64-bit platform, run the installer as follows:

TIBCOUniversalInstaller-x86-64.exe -silent -V    responseFile="myfile.silent"

On the Linux platform, type the command as follows:

   ./TIBCOUniversalInstaller-lnx-x86-64.bin -silent -V    responseFile="myfile.silent"

Copyright © Cloud Software Group, Inc. All Rights Reserved