The following sections describe the requirements for installing and running BIRT iHub.

Actuate recommends running the installation procedure from an account created exclusively for BIRT iHub administration. Having a dedicated user account isolates iHub‑specific issues and events on a machine, making it easier to administer the environment. Use the same level of security that your site exercises for other system administrator and root accounts.

Use the dedicated user account for installing, running, and administering iHub.

Installing BIRT iHub under the root account is not supported. If installed under the root account, the default installation is unable to set up the required BIRT iHub metadata schemas and sample volume. The PostgreSQL RDBMS must run using an unprivileged user account to prevent compromising system security.

The libstdc++ library is a prerequisite for running BIRT iHub on Linux systems. This library is present by default on most systems. If it is not present, the administrator must install it before installing BIRT iHub, using a command similar to the following one:

On Red Hat Enterprise Linux 7 and CentOS 7 operating systems, BIRT iHub requires both the 32-bit and 64-bit versions of the library.

Installation of BIRT iHub succeeds if this library is not present, but the server fails to start.

The BIRT iHub installation process requires running Linux at run level 3. Run level 3 is the default on most servers running the Linux operating system. This level supports networking and multi-user mode with a command-line interface.

Although BIRT iHub is a 64-bit application, 32-bit library support is required for installation. BIRT iHub requires either glibc.i686 or glibc.i386. If the BIRT iHub installation is unable to locate the required package, an error similar to the following one appears:

To install 32-bit glibc, use a command similar to the following one: