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

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 Encyclopedia sample volume. The PostgreSQL RDBMS must run using an unprivileged user account to prevent compromising system security.

The libstdc++ library is a prerequisite for installing 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.

The BIRT iHub installation process requires running Linux at run level 5. Run level 5 is typically the default on most Linux operating system distributions. This level supports networking and multi-user mode with a graphical window manager.

On Linux platforms, the Openmotif bundle is required and must be installed before installing BIRT iHub. BIRT iHub needs libXm.so.3 or libXm.so.4, which are part of Openmotif 2.2 and 2.3, respectively. If the BIRT iHub installation is unable to locate the required libXm.so.x library, create a symbolic link, as shown in the following example: