Using the command-line installation package on Linux

The following sections describe how to use the command-line installer to install BIRT Analytics on Linux. To use the single-module installers, see Using the BIRT Analytics installation script on Linux.

In installing the BIRT Analytics command-line installation package, the administrator performs the following tasks:

Downloads the BIRT iHub 3 installation package, iHub3.tar.gz,from the download site

Downloads the Actuate.BIRTAnalytics.core.tar.gz archive installation package and associated MD5 file from the download site

Additional BIRT iHub modules are available at the same location.

Extracts the contents of the installation package into a directory such as /Actuate/iHub3

Reads the README file and updates the acinstall.properties file

The README file contains instructions about how to install the BIRT iHub product packages, as shown in Listing 4‑6. The instructions contain the following sections:

Lists the software components the command-line installation package can install, such as BIRT iHub, System Console and BIRT iHub Visualization Platform, Java Development Kit (JDK), PostgreSQL, Content Services, and BIRT Analytics.

Describes the deployment tasks required to extract and run install the BIRT iHub Release 3 installation package. By default, the installation script installs iHub, System Console, and BIRT iHub Visualization Platform on the local machine.

Describes the properties in the iHub3/acinstall.properties file.

Use the BIRT iHub network installation package to install:

* Untar iHub3.tar.gz a clean folder e.g. /home/server/ihub3home

* Change working folder to /home/server/ihub3home/iHub3

By default, both iHub and System Console will be installed.

To install other components, modify iHub3/acinstall.properties and add components to ac.package.

To get the list of modules that can be install, in the command prompt type 'install.sh -list'.

iHub3/acinstall.properties contains the following properties:

* ac.downloadonly=false (If true, set up will only download modules and no installation will take place)

* ac.runasservice=true (If false, after installation is complete user will see two DOS prompts corresponding iHub server and Postgres)

If you have modules installed in default home location you do not need to specify path to iHub3 installation. Just use following command

The acinstall.properties file contains the following properties, as shown in Listing 4‑7:

The ac.login and ac.password properties contain the account login name and password for the network machine that contains the installable Actuate BIRT product modules.

The ac.package installation list contains the BIRT iHub modules to install. You must change this property from its default value to install BIRT Analytics.

The ac.homedir property specifies the path to the installation files if you do not run the installation script from the directory to which you extracted the files.

The ac.downloadonly property specifies whether to download the product modules only and have no installation take place. Typically, leave this property at its default value, false, to install the modules.

The ac.source property specifies the network path of the installation modules.

On Linux, the ac.runasservice, ac.runasservice_username, and ac.runasservice_password have no effect.

The value of ac.acceptlicense must be y to specify that you accept the software license terms. If this property is n, the BIRT Analytics software installation does not proceed.

The ac.ihub_cluster_schema_name and ac.ihub_postgres_port properties specify the cluster schema name and PostgreSQL RDBMS port, if necessary.

All path settings use forward slash (/) for the file separators. Do not use Windows, backward-slash (\) notation.

# 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

To obtain the list of installable modules and the corresponding letter settings, type the following command:

Listing 4‑8 Available installation modules for Linux

How to extract the contents of the BIRT iHub distribution package on Linux

This procedure is a prerequisite for installing BIRT Analytics.

To extract the BIRT iHub run-time resources and configure the setup script, perform the following tasks.

1 Download the required files, iHub3.tar.gz, and the contents of the modules folder from the software distribution site.

2 Create a new folder into which to extract the installation files from the distribution archive file, such as /home/actuate.

3 Extract the contents of iHub3.tar.gz to the folder created in the previous step.

How to run the BIRT Analytics command-line installation script on Linux

1 Navigate to the folder where you extracted the BIRT iHub package.

2 Open and read the file, license.pdf. You must agree to the license terms in order to install BIRT iHub.

3 Using a text editor, open and read the file, README. Then, close the file.

4 Using a text editor, open the acinstall.properties file, as shown in Listing 4‑7, and perform the following tasks:

1 Modify the ac.login and ac.password properties to contain the account login and password for the network machine that contains the installable Actuate BIRT product modules.

2 By default, the installation script installs options a and b, iHub with System Console and the embedded BIRT iHub Visualization Platform. Modify the ac.package installation list, shown in Listing 4‑7, to contain the value for BIRT Analytics Core, which is i.

Add module codes for any other required modules to the installation list. To obtain the list of installable modules and the corresponding letter values, as shown in Listing 4‑8, type the following command:

To install only the BIRT Analytics Core module, remove the module codes for System Console and BIRT iHub from the installation list.

3 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.

4 Leave ac.downloadonly set to false.

5 Set ac.source to the network path of the installation modules.

6 Set ac.acceptlicense to y to accept the software license terms.

7 Uncomment ac.ihub_cluster_schema_name and ac.ihub_postgres_port, setting these two properties to the cluster schema name and PostgreSQL RDBMS port, if necessary.

8 Save and close the file.

5 Execute the install.sh script using the following command:

[echo] Installing System Console. This may take a few minutes...

[echo] "Setup did not detect a valid JDK installation on your machine"

[echo] iHub3 prerequisite 64-bit JDK was missing. Setup will now install 64-bit JDK on your machine

[echo] Installing Actuate BIRT iHub. This may take a few minutes...

[echo] Using existing value from acmodules.properties

[echo] Using default PostgreSQL database port number 8432

[echo] Extracting package Actuate.BIRTAnalytics.core

[echo] Installing Actuate.BIRTAnalytics.core. This may take a few minutes...

[echo] Using existing value from acmodules.properties

[echo] To access Information Console, use URL: http://localhost:8700/iportal

[echo] To access System Console, use URL: http://localhost:8500/sysconsole