Using the installation scripts for Linux
When installing using the BIRT iHub installation script, the administrator performs the following tasks:
Downloads the installation packages, SystemConsole-ihub3.tar.gz and a single module, such as BIRTiHubVisualization-ihub3.tar.gz, from the software distribution site
For System Console and the additional module:
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 System Console installation script
1 Download the installation package, SystemConsole-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 SystemConsole.
3 Navigate to /home/actuate/SystemConsole.
4 Open and read the file, license.pdf. You must agree to the license terms in order to install System Console.
5 Using a text editor, open the acinstall.properties file, as shown in
Listing 1‑1, and perform the following tasks:
Listing 1‑1 acinstall.properties for installing System Console
#Tue, 11 Jun 2013 16:19:16 -0700
ac.login=//machine/actuate
ac.password=password
ac.package=a
ac.homedir=.
ac.downloadonly=false
##ac.source=.
#ac.source=.
ac.runasservice=true
ac.runasservice_username=
ac.runasservice_password=
# By changing the value of the ac.acceptlicense parameter
# to “y” you agree to the terms of the license agreement
# in the file “license.pdf” 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 iHub 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 System Console
[echo] Installing System Console. 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] To access System Console, use URL: http://localhost:8500/sysconsole
[echo] Setup Completed
INSTALL SUCCEEDED
Total time: 59 seconds
installation complete
How to run the BIRT iHub Visualization Platform installation script
1 Download the installation package, BIRTiHubVisualization-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 BIRTiHubVisualization.
3 Navigate to /home/actuate/BIRTiHubVisualization.
4 Open and read the file, license.pdf. You must agree to the license terms in order to install BIRT iHub Visualization Platform.
5 Using a text editor, open the acinstall.properties file, as shown in
Listing 1‑2, and perform the following tasks:
Listing 1‑2 acinstall.properties for installing BIRT iHub Visualization Platform
#Tue, 11 Jun 2013 16:19:16 -0700
ac.login=//machine/actuate
ac.password=password
ac.package=b
ac.homedir=.
ac.downloadonly=false
##ac.source=.
#ac.source=.
ac.runasservice=true
ac.runasservice_username=
ac.runasservice_password=
# By changing the value of the ac.acceptlicense parameter
# to “y” you agree to the terms of the license agreement
# in the file “license.pdf” 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 iHub 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] To access Information Console, use URL: http://localhost:8700/iportal
[echo] Setup Completed
INSTALL SUCCEEDED
Total time: 2 minutes 46 seconds
installation complete
How to run the BIRT Analytics installation script
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.
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 1‑3, and perform the following tasks:
Listing 1‑3 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: 4 minutes 21 seconds
installation complete
How to run the Content Services installation script
1 Download the installation package, ContentServices-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 ContentServices.
3 Navigate to /home/actuate/ContentServices.
4 Open and read the file, license.pdf. You must agree to the license terms in order to install Content Services.
5 Using a text editor, open the acinstall.properties file, as shown in
Listing 1‑4, and perform the following tasks:
Listing 1‑4 acinstall.properties for installing Content Services
#Tue, 11 Jun 2013 16:19:16 -0700
ac.login=//machine/actuate
ac.password=password
ac.package=b,n
ac.homedir=.
ac.downloadonly=false
##ac.source=.
#ac.source=.
# By changing the value of the ac.acceptlicense parameter
# to “y” you agree to the terms of the license agreement
# in the file “license.pdf” 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 ActuateBIRTiHubContentServices
[echo] Installing ActuateBIRTiHubContentServices. This may take a few minutes...
[echo] Actuate Content Services Install Complete
[echo] To access Information Console, use URL: http://localhost:8700/iportal
[echo] Setup Completed
INSTALL SUCCEEDED
Total time: 2 minutes 58 seconds
installation complete
7 At the prompt to shut down BIRT iHub, type:
no
Then, press Enter.