Requirements to install and run BIRT Analytics on Linux
The following sections describe the requirements for installing and running BIRT Analytics on Linux.
Configuring a Linux user account for BIRT Analytics
Actuate recommends running the installation procedure from an account created exclusively for BIRT Analytics administration. Having a dedicated user account isolates Analytics‑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 BIRT Analytics.
Installing BIRT Analytics 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.
Setting up libstdc++
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, which is part of the BIRT Analytics installation.
Using run level 5
The BIRT Analytics 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.
Linking to Openmotif
The Openmotif bundle 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:
ln -s libXm.so.3 libXm.so.4
32-bit library support
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, an error similar to the following one appears:
/home/actuate/iHub3/BIRTiHubVisualization/acinstall/Ant/apache-ant-1.8.2/bin/ant: /home/actuate/iHub3/BIRTiHubVisualization/acinstall/jre/bin/java: /lib/ld-linux.so.2: bad ELF interpreter: No such file or directory
To install 3-bit glibc,use a command similar to the following one:
yum install glibc.i686