Time for action – downloading, installing, and configuring PRD

We will download PRD from the SourceForge.net repositories, install PRD, and set your RAM:

  1. To download PRD, paste http://sourceforge.net/projects/pentaho/files/Report%20Designer/ in your web browser.

    Different versions of PRD are stored here, each version in its own folder.

    In the latest versions, we can recognize the type of content of the packages according to the following pattern:

    • prd-source-[version].zip: This contains the PRD source code
    • prd-ce-[version].zip: This contains the Windows distribution
    • prd-ce-mac-[version].tar.gz: This contains the Mac distribution
    • prd-ce-[version].tar.gz: This contains the Linux distribution

    In our case, we download Version 5.0.0; therefore, in Linux environments, we should download the following file:

    • prd-ce-5.0.0.stable.tar.gz

    And in Windows environments, we should download the following file:

    • prd-ce-5.0.0.stable.zip
  2. Now we will install PRD.

    We choose a folder and unzip the file according to our operating system. As a result, we obtain a folder with the report-designer name. From here on, we will call the complete path to this folder [PRD_HOME].

    Note

    As such, the location of the JDBC drivers is [PRD_HOME]/lib/jdbc. This is where we should copy the drivers for the JDBC data sources we want to connect to. Some drivers are included by default, for example, the HSQLDB driver. A JDBC driver is a software component that allows a Java application to connect and interact with a database. A different implementation is required for each database to which we connect.

  3. Next we will configure PRD.

    We can assign more RAM to the PRD execution environment in the following way:

    In Linux environments:

    1. Open a terminal and edit the report-designer.sh file:
        shell> gedit [PRD_HOME]/report-designer.sh
    2. Place the desired value in the following line:
        "$_PENTAHO_JAVA" -XX:MaxPermSize=512m -jar "$DIR/launcher.jar" $@

      For example:

        "$_PENTAHO_JAVA" -XX:MaxPermSize=512m -Xmx768M -jar "$DIR/launcher.jar" $@

    In Windows environments:

    1. Go to the [PRD_HOME] folder and edit the report-designer.bat file.
    2. Place the desired value in the following line:
        start "Pentaho Report Designer" "%_PENTAHO_JAVA%" -XX:MaxPermSize=256m -Xmx512M -jar "%~dp0launcher.jar" %*

      For example:

        start "Pentaho Report Designer" "%_PENTAHO_JAVA%" -XX:MaxPermSize=256m -Xmx768M -jar "%~dp0launcher.jar" %*

What just happened?

We downloaded PRD 5.0 from SourceForge.net, in accordance with our operating system, and we have learned about the pattern of names for various packages. We installed PRD, unzipping the respective package, and explained that the path where we should place the JDBC drives is [PRD_HOME]/lib/jdbc. We also edited the PRD_HOME]/report-designer.[sh|bat] file in order to explain how to assign more RAM to the PRD execution environment.