Copyright © TIBCO Software Inc. All Rights Reserved

Installing Software

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

•

GUI Mode

•	Console Mode

•	Silent Mode

Before You Install TIBCO API Exchange Manager

Before you install the TIBCO API Exchange Manager, install the TIBCO API Exchange Gateway component on the same host.

If you have not installed the API Exchange Gateway, the installer displays a message indicating that the installation failed a dependency check, and then exits.

GUI Mode

To install this product in GUI mode:

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 the TIBCO Universal Installer executable (TIBCOUniversalInstaller*). You can do so in one of the following ways:

−	Double-click the installer executable file.

−	On the command prompt, run the installer executable TIBCOUniversalInstaller* file on 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 Next 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 and then click Next.

7.	Click Next. 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 installation.

−	Use an Existing TIBCO_HOME   Select this radio button, and select the directory from the drop-down list where TIBCO Rendezvous product is installed. The TIBCO API Exchange Gateway product is installed in this directory.

8.	Click Next.

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 Next.

11.	Verify the list of components selected for installation.

12.	Click Next.

13.	Review the Installation Environment Details in the Pre-Install Summary dialog.

14.	Click Install to start the installation process.

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

16.	Click Finish to complete the installation process and exit the universal installer.

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 the universal installer.

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

TIBCOUniversalInstaller -console

For example,

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

TIBCOUniversalInstaller-x86-64.exe -console

On the 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, the 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, it is good practice to copy the file to a different name and use that file for the silent install.

If errors occur during installation, they will be 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.	Make a copy of the TIBCOUniversalInstaller-asg.silent file and rename the file.

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

−	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>

−	Update ENV_NAME.

For example, update ENV_NAME as follows:

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

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

−	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 Manager is installed in a directory that has a config directory already set by another TIBCO product (for example, TIBCO Enterprise Message Service™), it is not required 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.

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

6.	Run TIBCO Universal Installer (TIBCOUniversalInstaller*) using the following command, replacing myfile with your response 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="myfilename.silent"

On the Linux platform, type the command as follows:

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

 

Copyright © TIBCO Software Inc. All Rights Reserved