For information about accessing Visualization Platform after installation, see Setting up BIRT iHub.
How to install the Visualization Platform module
1 Download the installation package, BIRTiHubVisualization.tar.gz, from the software distribution site.
2 Create a new folder into which to extract the files that BIRTiHubVisualization.tar.gz contains, such as /opt/actuate, if you have not already done so.
3 Unbundle the tar.gz file into opt/actuate. Unbundling the tar.gz file creates the installation directory, /opt/actuate/BIRTiHubVisualization.
4 Navigate to /opt/actuate/BIRTiHubVisualization/License.
5 Open and read the file, license.txt. You must agree to the license terms to install BIRT iHub Visualization Platform.
6 Navigate to /opt/actuate/BIRTiHubVisualization.
7 Using a text editor, open the acinstall.properties file. Using the example shown in Listing 2‑3, perform the following tasks:
1 Modify the ac.login and ac.password properties to contain the login and password for the machine onto which you are installing Visualization Platform.
2 Modify the ac.homedir property to specify the full installation directory path if you do not run the install script, install.sh, from the installation directory.
3 Leave ac.downloadonly set to false.
4 Set ac.upgrade.ihub and ac.upgrade.start.ihub to n.
5 For ac.acceptlicense, accept the default value of prompt for the install script to prompt you for whether you accept the software license terms when you run the script. Alternatively, specify y for yes, to accept the software license terms.
6 Save and close the file.
Listing 2‑3 acinstall.properties for installing BIRT iHub Visualization Platform
#Tue, 11 Jun 2015 16:19:16 -0700
ac.login=//URUP/actuate
ac.password=password
ac.package=b
# Please use forward slashes for the home fully qualified path
# on Windows OS, for example ac.homedir=D:/iHub/distribution
# For a new BIRT iHub installation, specify the pathname of the
# folder where you want to install BIRT iHub as the value of
# the ac.homedir property. The default is the current
# directory.
# For upgrading from ihub3/Linux.0 to ihub3/Linux.1F1, change
# the value of ac.homedir to the existing iHub location, for
# example, ac.homedir=/opt/actuate/BIRTiHubVisualization
ac.homedir=.
ac.downloadonly=false
# If you are performing a new BIRT iHub install, specify n as
# the value for upgrade.ihub. If you are upgrading
# ihub3/Linux.0 to ihub3/Linux.1 Fix 1, specify y as the value
# for upgrade.ihub.
# To start BIRT iHub automatically after upgrading, specify y
# as the value for upgrade.start.ihub. If you do not want to
# start BIRT iHub after upgrading, specify n as the value for
# upgrade.start.ihub.
# ac.upgrade.ihub=prompt
# ac.upgrade.start.ihub=prompt
ac.upgrade.ihub=n
ac.upgrade.start.ihub=n
# Please use forward slashes for the source network path on
# Windows OS, for example 'source'=//fs/installDir/iHub
# /distribution
# ac.source=.
# The license agreement (license.txt) file is located in the
# ./License directory
# The default value of the ac.acceptlicense parameter is set to
# 'prompt', which requires the user to read the license
# agreement before accepting it
# Before starting a network/silent install, read the
# license.txt file and change the value of the ac.acceptlicense
# parameter to 'y' to confirm that you agree to the terms of
# the license agreement
# ac.acceptlicense=prompt
ac.acceptlicense=y
#Advanced Settings
#ac.ihub_cluster_schema_name=
#ac.ihub_postgres_port=
8 Execute the install.sh script using the following command:
sh ./install.sh
When you run the BIRT iHub installation script, you see the message “Unable to locate tools.jar.” You can safely ignore this message.
The script displays messages similar to those shown in Listing 2‑4.