Copyright © Cloud Software Group, Inc. All Rights Reserved

Installation Modes

TIBCO Universal Installer provides the following three modes of installation for TIBCO Hawk. When installing TIBCO Hawk you also have the option to install the Admin Agent, which exposes TIBCO Hawk to TIBCO Enterprise Administrator, along with the installation of TIBCO Hawk Components.

GUI Mode

GUI mode performs the installation in an interactive graphical interface. The installer prompts you for values specific to your environment.

Installing the Hawk Components and Hawk Admin Agent

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 TIBCOUniversalInstaller. You can do so in one of the following ways:

a.	Double-click the installer icon.

b.	On the command prompt, provide the absolute path of the installer file without specifying any options. The installer defaults to GUI mode.

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 and click the Next button.

The TIBCO Installation Home dialog is displayed.

7.	In the TIBCO Installation Home dialog, select one of the following options to specify the installation environment. See Installation Environment for more details.

•	Create a new TIBCO_HOME   to install the product into a new installation environment, specify the following properties:

−	Directory - The directory into which the product is installed. Type a path or click Browse to specify the path or accept the default location.

−	Name – The name is appended to the name of Windows services created by the installer and is a component of the path to the product in the Windows Start > All Programs menu.

•	Use an existing TIBCO_HOME   to install the product into an existing installation environment, select the environment from the drop-down list.

−	The Name and Directory fields are populated automatically and cannot be edited.

8.	Click the Next button. The Installation Profile Selection dialog displays.

9.	Select the TIBCO Hawk 5.2 Components installation profile to install all the Hawk components. Or select the Customize Installation checkbox to explicitly select the Hawk installation components.

Optionally, hold your Ctrl key down and click TIBCO Hawk Admin Agent to select it too. If you choose not to install the Admin Agent at this time you can always install it at a later time by re-running this installer. Click Next. See the Understanding Installation Profiles for more details.

10.	Select whether you want to use the JVM bundled with the installer or you want to use a previously installed JVM on your machine. If you opt for the latter, browse to the Java location on your machine using the Browse button, then click Next.

11.	Verify the list of product features selected for install in the Pre-Install Summary dialog and click Install.

12.	Review the information listed in the Post-Install Summary dialog and click Finish.

Installing the Admin Agent after Installing the TIBCO Hawk Components

1.	Navigate to the temporary directory where the installation package was extracted and re-run TIBCOUniversalInstaller. You can do so in one of the following ways:

a.	Double-click the installer icon.

b.	On the command prompt, provide the absolute path of the installer file without specifying any options. The installer defaults to GUI mode.

2.	Click the Next button on the Welcome dialog.

3.	Read through the license text when the License Agreement dialog appears. Select the “I accept the terms of the license agreement.” radio button and click the Next button.

4.	In the TIBCO Installation Home dialog, click the Use an existing TIBCO_HOME option and select the existing installation environment where Hawk is installed and click Next.

5.	Select the TIBCO Hawk Admin Agent installation profile to install the TIBCO Enterprise Administrator Agent Runtime component. Click Next. See the Understanding Installation Profiles for more details.

6.	Select whether you want to use the JVM bundled with the installer or you want to use a previously installed JVM on your machine. If you opt for the latter, browse to the Java location on your machine using the Browse button, then click Next.

7.	Verify the list of product features selected for install in the Pre-Install Summary dialog and click the Install.

8.	Review the information listed in the Post-Install Summary dialog and click Finish.

Console Mode

Console mode allows you to install the software from a command window or terminal emulator. The installer prompts you for values.

To install this product in console mode:

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.	To install from a Microsoft Windows command window, type:

TIBCOUniversalInstaller -console

To install from a UNIX terminal window, type:

TIBCOUniversalInstaller-<platform>.bin -is:javaconsole -console

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

The installation process is the similar to the installation in GUI Mode.

Silent Mode

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

The TIBCOUniversalInstaller.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.silent file, it is recommended 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.

 

Installing the Hawk Components and Admin Agent

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_hawk_5.2.0.silent file and rename the original file.

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

a.	Update the install location. Install TIBCO Hawk in the same directory where <Family> is installed. For example, update the directory as follows:

 

<entry key="installationRoot">C:\tibco</entry>

b.	Update ENV_NAME. TIBCO Hawk must use the same ENV_NAME that <Family> uses.

For example, update ENV_NAME as follows:

 

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

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

c.	Update features to install. Set the Hawk component features that you want to install to true and the Admin Agent feature to false. See Understanding Installation Profiles for more details.

The following elements can be set to true or false in the .silent file for installing your choice of components, to simulate the TIBCO Hawk custom installation.

 

<entry key="feature_Agent, EventService, Display, SDK, Examples_hawk">true</entry>

<entry key="feature_Runtime_hawk">true</entry>

<entry key="feature_WebConsole Application_hawk">true</entry>

<entry key="feature_WebContainer -Apache Tomcat_hawk">true</entry>

d.	If you would like to install the TIBCO Hawk Admin Agent at this time, set the following property to true:

<entry key="feature_Admin Agent Runtime_hawk">true</entry>

If you choose not to install the Admin Agent at this time, set the above property to false. You can always install the Admin Agent at a later time by setting the property to true and rerunning the installation.

6.	Run the following command to start the installation:

−	On Windows:

 

TIBCOUniversalInstaller.cmd -silent -V responseFile="TIBCOUniversalInstaller_hawk_5.2.0.silent"

−	On UNIX/Linux:

 

TIBCOUniversalInstaller.bin -silent -V responseFile=" TIBCOUniversalInstaller_hawk_5.2.0.silent "

Provide a complete (absolute) path of TIBCOUniversalInstaller_hawk_5.2.0.silent to execute Universal Installer from some other folder.

A line similar to the following is written to the installer log file when installation completes:

 

... Install, com.tibco.installer.util.TIBCOInstaller, dbg.Debug, Executing Event:::OnEndInstall

Installing Admin Agent After Installing the Hawk Components

1.	Edit the same .silent file which was used for Hawk components installation. See Installing the Hawk Components and Admin Agent.

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

a.	Update ENV_NAME. Admin Agent must use the same ENV_NAME that TIBCO Hawk 5.2 uses.

For example, update ENV_NAME as follows:

 

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

<entry key="environmentName">TIBCO-HAWK_HOME</entry>

b.	Update features to install. Set the following feature to true to install the Admin Agent component. See Understanding Installation Profiles for more details.

 

<entry key="feature_Admin Agent Runtime_hawk">true</entry>

3.	Run the following command to start the installation:

−	On Windows:

 

TIBCOUniversalInstaller.cmd -silent -V responseFile="TIBCOUniversalInstaller_hawk_5.2.0.silent"

−	On UNIX/Linux:

 

TIBCOUniversalInstaller.bin -silent -V responseFile=" TIBCOUniversalInstaller_hawk_5.2.0_silent "

Provide a complete (absolute) path of TIBCOUniversalInstaller_hawk_5.2.0.silent to execute Universal Installer from some other folder.

A line similar to the following is written to the installer log file when installation completes:

 

... Install, com.tibco.installer.util.TIBCOInstaller, dbg.Debug, Executing Event:::OnEndInstall

 

Copyright © Cloud Software Group, Inc. All Rights Reserved