OpenText Actuate Information Hub (iHub), Trial Edition is a free evaluation version of OpenText’s enterprise-grade data visualization server that you can download and use to bring your report designs and applications to life. This blog will walk you through the process of installing the software on Linux so you can begin your iHub projects and application deployment.
Download iHub, Trial using the icon above.
Before getting started, let’s take a quick glance at the system requirements and supported operating systems.
- Linux: x64 compatible, Pentium 1 GHz or higher
- RAM: 8 GB minimum
- Free Disk Space: 3 GB minimum
Supported Operating Systems
- CentOS: 6.5, 7.0
- OpenSUSE Linux: 12.2, 13.1
- Oracle Linux: 5.5
- Red Hat Enterprise Linux RHEL: 5.10, 6.1 – 6.5, 7.0
- SUSE Linux Enterprise Server 11 SP3
The target system I have installed the BIRT iHub Trial Edition on has the following specs:
- CentOS 7 (based on CentOS-7-x86_64-Minimal-1503-01.iso)
- 2 CPUs
- 8 GB RAM
- 20 GB free disk space
Before installing, the C++ Runtime Library (libstdc++) is a prerequisite for running BIRT iHub on Linux systems. If this library package is not installed, the install script will display a warning and the install script will stop.
If running from virtual environments such as Amazon EC2, where the IP address or hostname may change from a restart, one solution is to assign a hostname. This step should be completed prior to running the installation script. See below for this additional step.
On my CentOS 7 system, I installed it via:
sudo yum install libstdc++.i686
After downloading the iHub Trial Edition, I extracted it. You can place them anywhere such as /usr/local/ihub.
tar –xvf BIRTiHubTrialEdition.tar.gz
Then I changed to the BIRTiHubTrialEdition directory and started the installation. It should be noted that you do not want to run these commands with elevated privileges such as the “root” user.
cd BIRTiHubTrialEdition ./install.sh
After reading through the license agreement, I pressed “y” and enter to accept. Depending on your system specs, the install process shouldn’t take more than a minute or two. If successful, the installer will display progress messages and end with:
Installation complete To log in to BIRT iHub Trial Edition, open a browser window and type the following URL: http://localhost:8700/iportal
From a browser on another machine, I was able to access iHub Trial Edition via its IP address (http://ipaddress:8700/iportal).
Note that for a default install of CentOS 7, the firewall is automatically enabled. For testing, you can completely disable and stop the firewall as a root/admin user ( systemctl disable firewalld and systemctl stop firewalld ). Or you can just allow for TCP traffic on the default port 8700 with the root/admin user ( firewall-cmd –zone=public –add-port=8700/tcp ).
To log into iHub, the username is “administrator” and the password is blank.
There are 45 days for the trial period. After you log into iHub, an indicator showing the days remaining will display in the upper right-hand corner of the page.
Thanks for reading. Now, it’s time to unleash the full power of Analytics into your application. If you have any questions or comments, please feel free to use the comments section below or visit the Working with iHub forum.
Footnote for fixing hostname (for virtual environments such as Amazon EC2)
In a virtual environment where the IP address or hostname may change from a restart, such as in Amazon EC2, one solution is to assign a hostname. This step should be completed prior to running the installation script.
- Assign a hostname using the hostname command, or by editing /etc/sysconfig/network
- Add that hostname value to /etc/hosts for the “localhost” IP address.
127.0.0.1 myHostname, localhost ..
By assigning a hostname, the machine, will call itself via the loopback regardless of its current assigned IP or hostname. This hostname change is intended for internal server process communications only. Accessing the BIRT iHub server externally from a different machine’s browser should still be refereced via its external hostname, or external IP address.
For more information on changing a hostname in Amazon EC2, visit http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/set-hostname.html
Editor’s note: This article was updated on Sept. 14, 2015 to reflect a clarification on virtual environments.