Using the BIRT Analytics installation script on Linux
This section describes how to use the single-module installer to install BIRT Analytics. To use the command-line installer, see
Using the command-line installation package on Linux.
When installing using the BIRT iHub installation script, the administrator performs the following tasks:
Downloads the installation packages, SystemConsole-ihub3.tar.gz and BIRTAnalytics-ihub3.tar.gz, from the software distribution site
For System Console and BIRT Analytics:
Unpacks the contents of the installation package
Reviews the software license agreement
Updates the installation properties file
Runs install.sh, installing into a directory such as /home/actuate/ihub3
How to run the BIRT Analytics installation script on Linux
Install BIRT Analytics core and then install the BIRT Analytics tools on a Windows system, as described in
How to install the BIRT Analytics tools. Install BIRT Analytics application on a Windows system, as described in
How to run the BIRT Analytics installation program on Windows.
1 Download the installation package, BIRTAnalytics-ihub3.tar.gz, from the software distribution site.
2 Decompress the package into a tar file and then unbundle the tar file into the folder where you want to install the software, such as /home/actuate. Unbundling the tar file creates the folder BIRTAnalytics.
3 Navigate to /home/actuate/BIRTAnalytics.
4 Open and read the file, license.pdf. You must agree to the license terms in order to install BIRT Analytics.
5 Using a text editor, open the acinstall.properties file, as shown in
Listing 4‑5, and perform the following tasks:
Listing 4‑5 acinstall.properties for installing BIRT Analytics
#Tue, 11 Jun 2013 16:19:16 -0700
ac.login=//machine/actuate
ac.password=password
ac.package=b,i
ac.homedir=.
ac.downloadonly=false
##ac.source=.
#ac.source=.
# By changing the value of the ac.acceptlicense parameter
# to <93>y<94> you agree to the terms of the license agreement
# in the file <93>license.pdf<94> located in the same folder as
# this parameter file.
ac.acceptlicense=y
#Advanced Settings
#ac.ihub_cluster_schema_name=
#ac.ihub_postgres_port=
1 Modify the ac.login and ac.password properties to contain the login and password for the network machine that contains the installable BIRT Analytics product modules.
2 Modify the ac.homedir property to specify the path to the installation files if you do not run the installation script from the directory to which you extracted the files.
3 Leave ac.downloadonly set to false.
4 Set ac.acceptlicense to y to accept the software license terms.
5 Save and close the file.
6 Execute the install.sh script using the following command:
sh ./install.sh
Messages similar to the following ones appear:
Install will start now...
[echo] Downloading from given file system location
[echo] Verifying Checksum...
[echo] Completed verification
[echo] Extracting package Actuate BIRT iHub
[echo] Installing Actuate BIRT iHub. This may take a few minutes...
[echo] "Setup did not detect a valid JDK installation on your machine"
[echo] Downloading from given file system location
[echo] Verifying Checksum...
[echo] Extracting package JDK64
[echo] iHub3 prerequisite 64-bit JDK was missing. Setup will now install 64-bit JDK on your machine
[echo] Using default PostgreSQL database port number 8432
[echo] Using default schema name
[echo] Downloading from given file system location
[echo] Verifying Checksum...
[echo] Extracting package Actuate.BIRTAnalytics.core
[echo] Installing Actuate.BIRTAnalytics.core. This may take a few minutes...
[echo] acmodules.properties already exists
[echo] Using existing value from acmodules.properties
[echo] Actuate BIRT Analytics Core Install Complete
[echo] To access Information Console, use URL: http://localhost:8700/iportal
[echo] Setup Completed
INSTALL SUCCEEDED
Total time: 5 minutes 3 seconds
installation complete