Using the Linux Installation Utility

These instructions are for Linux users only. Windows users should refer to the Windows installation instructions instead.

Important: If you do not have an X server installed, you can run the installation utility in text mode by invoking the --mode text switch. If you like, you can also perform the installation on a Linux workstation, then transfer over the /pentaho/ and ~/.pentaho/ directories to your server after installation.
Note: The installation utility's graphical mode defaults to the GTK graphics toolkit. If you do not have the requisite GTK libraries on your system, you can run the installer with the --mode xwindow switch to use OpenMotif instead.

Step-by-step instructions for using the installer are below. You may need to adjust the instructions for your specific situation.

  1. Open a terminal window.
  2. If it is not already there, copy the installation utility to the pentaho home directory.
    cp  /home/rwilco/Desktop/pentaho-bi-suite-3.6-linux-installer.bin /home/pentaho/
  3. Switch to the pentaho user account.
    su pentaho -
  4. Set execute permissions on the installation utility.
    chmod +x ./pentaho-bi-suite-3.6-linux-installer.bin
  5. Run the installation utility.
    /home/rwilco/Desktop/pentaho-bi-suite-3.6-linux-installer.bin
  6. When the installation utility starts, you'll see a Pentaho splash screen. Click Next. The graphical installer welcome screen
  7. Accept the license agreement to continue.
  8. When prompted for which Pentaho applications you want to install, uncheck all options except BI Server and Data Integration Server. If you have a Pentaho Dashboards Enterprise Edition or Pentaho Analysis Enterprise Edition license key, select the checkboxes for the Dashboard Designer and Pentaho Analyzer options, respectively. If you do not have the requisite support entitlements, the Dashboard Designer and Pentaho Analyzer plugins will not work, and they will change your Pentaho User Console interface irreversibly. There is no direct harm in installing these plugins if you do not have support entitlements for them; however, you will have to ensure that your users are properly trained to avoid the disabled functions in the Pentaho User Console. If necessary, it is possible to install Dashboard Designer and Pentaho Analyzer later by using archive packages.
    Note: If you install Pentaho Analyzer, you must also install Dashboard Designer due to a software dependency.
  9. When asked if you would like to install the Pentaho sample data, select No if this is a production install. The sample data is useful for evaluating the BI Suite, but tends to get in the way in a production environment.
  10. Next, you'll be asked to choose a directory to install to. Feel free to select a new path, but for documentation continuity and support purposes, you should leave the actual directory name alone. The default directory is ~/pentaho/ You cannot install into a directory that already exists.
  11. In the next screen, type in a root password for the MySQL database. The BI Suite installer provides a MySQL database to store your reports and analysis views. The root password is for the internal database root user, not the global system root (administrator) user. This is the account that has total control over all MySQL databases.
  12. The next step asks for a publish password, which controls access to the BI Server from Pentaho client tools such as Report Designer and Schema Workbench. If you do not set a publish password, you will not be able to publish from client tools to the BI Server.
  13. Next, you'll be asked to supply account details for a Pentaho administrator account. This will be both your Pentaho User Console and Pentaho Enterprise Console login information.
  14. Optional: If any of the default Pentaho BI and DI Server ports (8088, 8080, 8012, 9092, 9080, 8443, 8143, and 3306) are not available on your system, the default numbers will increment by one until an available port is found.
  15. A summary screen will show you an overview of which BI Suite components you've chosen to install, and the ports that all of the necessary services will run on, . Click Next to leave this screen, then Next again to commence installation.

Once the installation wizard is complete, the BI Server and DI Server should be up and running with default parameters. You have the option of starting Pentaho Enterprise Console, Pentaho Data Integration, and the Pentaho User Console during the last step of the installation process. You should de-select the Data Integration option, since it is not installed with the Data Integration Server, and choose both the User Console and Enterprise Console options so that you can properly test and configure your BI Server installation. If you choose them, your default Web browser will open and display tabs for the console pages that you selected.