Before you start with installation, make sure your system meets all prerequisites, decide on the installation environment name and folder, and download and extract the installation package.
About this task
TIBCO_HOME is the top-level installation directory for TIBCO products. TIBCO_HOME is referred to as the installation environment. Installation environments isolate product installations; a product installed into an installation environment does not access components in other environments.
An installation environment consists of a name and a folder.
• The name identifies the environment, 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.
• The folder contains the installed software. When you install you can choose a new installation environment or an existing installation environment.
If a previous installation of a TIBCO product did not use the TIBCO Universal Installer, then the TIBCO Universal Installer does not detect the folder those older products use as an installation environment folder.
If you wish to use the existing location as the installation folder, create a new installation environment and choose the folder where the other products exist. See the Release Notes for restrictions on the installation environment.
Procedure
1. Make sure your environment meets all requirements and perform pre-installation tasks.
See Installation Requirements on page 16 and Pre-installation Tasks on page 20.
If you do not have Internet access, be sure to download the required software assemblies. See Downloading Software Assemblies if No Internet Access is Available on page 22.
2. Decide on the installation environment (TIBCO_HOME) you want to use. The installer will prompt you for a name and a folder.
3. Set up your environment for the installation you are planning.
Action Choice
Stop all processes that are using Java from TIBCO_HOME.
If you plan on installing in an existing installation environment...
Stop all the processes corresponding to the objects.
If you plan on installing on a machine on which runtime objects (Administrator server, TIBCO Host instances, and nodes) are running...
Create a new installation environment.
If you plan on installing the SOA Development profile or a custom profile containing TIBCO Business Studio.
4. Open the physical media or download the TIBCO ActiveMatrix Service Grid archive file and extract the archive file to a temporary directory.
5. Perform installation based on the mode you selected.
– Installing in GUI Mode on page 27 – Installing in Console Mode on page 29 – Installing in Silent Mode on page 30
TIBCO ActiveMatrix Service Grid Installation and Configuration 26 | Installation
Installing in GUI Mode
When you run the installer in GUI mode, the installer prompts you for information about the installation environment, and allows other customizations.
Before you begin
Prepare your system. See Preparing for Installation on page 26.
Procedure
1. Run TIBCOUniversalInstaller. 2. Click Next in the Welcome screen.
3. Read through the license agreement, select I accept the terms of the license agreement, and click Next.
4. Choose a new installation environment (TIBCO_HOME) or an existing installation environment and click Next.
Procedure Option
Specify properties:
Create a New
TIBCO_HOME • Directory The directory into which the product is installed. The directory cannot be the same as the directory of an existing installation
environment.
The directory path cannot contain special characters such as "*", "#", "?",
">", "<", "%", "&", "$", "`" or "|".
• Name Identifies the installation environment. The name cannot contain special characters such as "*", "?", ">", "<", ":", "|", "/", "\", or quotes (").
Select an installation environment from the drop-down list.
Use an Existing TIBCO_HOME
5. Follow these steps to accept license agreements for third-party software and to optionally install that software.
a) When the Hibernate license agreement appears, read the text and click I accept the terms of the license agreement.
b) On Linux and Solaris, the LGPL License Agreement appears. Read the text and click I accept the terms of the license agreement.
c) If the Hibernate software is not in the assemblies subdirectory of your temporary directory, your are prompted for a Download Hibernate option.
• Download Hibernate assembly from TIBCO. Choose this option if you are connected to the Internet or you do not want to use a previously downloaded assembly. The assembly is automatically downloaded and stored into the assemblies subdirectory of the directory where you extracted the installer.
• Select the Hibernate assembly previously downloaded from TIBCO. Choose this option if you are not connected to the Internet. Click Browse to navigate to the directory where a Hibernate assembly that was previously downloaded is stored and click Open. See Downloading Software Assemblies if No Internet Access is Available on page 22.
If you choose to download Hibernate, the wizard displays the Hibernate download process.
d) On Linux and Solaris, if you choose to install Development Tool, and the
product_tibco_eclipse_lgpl_3.7.2.001 assembly is not in the assemblies subdirectory of your temporary directory, the LGPL Assembly Download screen displays. Choose a download option:
TIBCO ActiveMatrix Service Grid Installation and Configuration Installation | 27
• Download Gnome Binding assembly from TIBCO Choose this option if you are connected to the Internet or do not want to use a previously downloaded assembly. The assembly is automatically downloaded and stored into the assemblies subdirectory of the directory where you extracted the installer.
• Provide the location for the assembly previously downloaded from TIBCO Choose this option if you are not connected to the Internet. Click Browse to navigate to the directory where the
product_tibco_eclipse_lgpl_3.7.2.001 assembly that was previously downloaded is stored.
Select the assembly and click Open. See Downloading Software Assemblies if No Internet Access is Available on page 22.
e) On Linux and Solaris, if you choose to install TIBCO Host software and the
product_tibco_eclipse_lgpl_rcp_3.7.2.001 assembly is not in the assemblies subdirectory of your temporary directory, the LGPL Assembly Download screen displays. Choose a download option:
• Download Gnome Binding assembly from TIBCO - Choose this option if you are connected to the Internet or do not want to use a previously downloaded assembly. The assembly is automatically downloaded and stored into the assemblies subdirectory of the directory where you extracted the installer.
• Provide the location for the assembly previously downloaded from TIBCO - Choose this option if you are not connected to the Internet. Click Browse to navigate to the directory where the
product_tibco_eclipse_lgpl_rcp_3.5.2.001 assembly that was previously downloaded is stored. Select the assembly and click Open. See Downloading Software Assemblies if No Internet Access is Available on page 22.
6. In the Installation Profile Selection screen, select one or more of the preconfigured profiles, or click Customize Installation and explicitly select the components you want to install. Click Next.
The following profiles are preconfigured.
Description Option
Includes TIBCO ActiveMatrix Administrator, Mediation Runtime, and supporting documentation for each product. Install this profile to create TIBCO ActiveMatrix Administrator servers on the machine.
Administration
Includes TIBCO Host software and supporting documentation. Install this profile to create TIBCO Host instances on the machine.
Runtime Host
Includes TIBCO Business Studio, Composite Editor, Mediation Flow Editor, binding and implementation type editors, and supporting documentation.
Install this profile to develop TIBCO ActiveMatrix applications on the machine.
SOA Development
7. Shut down all TIBCO processes if the installer prompts you to do so.
The installer prompts if the features are already installed on the target system. Reinstalling features is not usually recommended.
8. In the Pre-Install summary screen, verify the list of products selected for installation, and click Install.
9. When installation completes, you can choose to launch TIBCO Configuration Tool to create TIBCO Host or Administrator server instances. Uncheck the Launch TIBCO Configuration Tool checkbox if you do not want to run TIBCO Configuration Tool right away.
TIBCO ActiveMatrix Service Grid Installation and Configuration 28 | Installation
Installing in Console Mode
After you prepare your system and the installation media, you can run the installer in console mode.
Before you begin
Prepare your system. See Preparing for Installation on page 26.
If you expect to have no Internet access when you perform installation, be sure to download software assemblies before you run the installer. See Downloading Software Assemblies if No Internet Access is Available on page 22.
Procedure
1. In a console window, navigate to the temporary directory to which you extracted the files.
2. Run TIBCOUniversalInstaller -console. The installer launches a second console window.
3. Respond to the prompts in the second console window.
The installer prompts for installation information and allows you to return to a previous selection periodically. The process is similar to Installing in GUI Mode on page 27.
4. When installation completes, press Enter to exit the installer.
The console installer does not prompt you to run TIBCO Configuration Tool. To create servers and other runtime objects, you can run TIBCO Configuration Tool explicitly.
What to do next
After you exit the installer, you perform post-installation tasks and configuration. To configure your environment, you can run TIBCO Configuration Tool in GUI mode, console mode, or silent mode.
1. Continue with Post-Installation Tasks on page 33.
2. Run TIBCO Configuration Tool. See Configuration Tool Wizards and Screens on page 60.
TIBCO ActiveMatrix Service Grid Installation and Configuration Installation | 29
Installing in Silent Mode
You can run the installer without user input by pointing the installer to a response file. A default preconfigured response file exists.
Before you begin
Prepare your system. See Preparing for Installation on page 26.
If you expect to have no Internet access when you perform installation, be sure to download software assemblies before you run the installer. See Downloading Software Assemblies if No Internet Access is Available on page 22. If you have Internet access, the installer silently installs the required assemblies and completes installation.
About this task
In silent mode, the installer does not prompt for inputs during installation but reads the inputs from a response file. By default, the installer for TIBCO ActiveMatrix 3.2.0 products uses the
TIBCOUniversalInstaller-product_3.2.0.silent file, which is included in the directory that contains the universal installer.
You can customize the silent installer as follows:
• Make a backup copy of the TIBCOUniversalInstaller-product_3.2.0.silent file and edit the file itself.
You can then run the silent installer with or without the response file argument.
• Make a copy of the TIBCOUniversalInstaller-product_3.2.0.silent file and name the copy. You can then run the silent installer, passing in your custom response file.
Procedure
1. Make a copy of the TIBCOUniversalInstaller.silent file and name the file, for example, myfilename.silent.
2. Using a text editor, open the copied file and update the installation location and features to install.
3. Run the silent installer with or without the optional response file.
– Windows: TIBCOUniversalInstaller.cmd -silent [-V responseFile="myfile.silent" ]
– UNIX: TIBCOUniversalInstaller.bin -silent [-V responseFile='myfile.silent']
What to do next
After you exit the installer, you perform post-installation tasks and configuration. You can run TIBCO Configuration Tool in GUI mode, console mode, or silent mode.
1. Continue with Post-Installation Tasks on page 33.
2. Run TIBCO Configuration Tool. See Configuration Tool Wizards and Screens on page 60.
TIBCO ActiveMatrix Service Grid Installation and Configuration 30 | Installation