Add a new driver

To add a new driver, first download the driver file from the Support Portal then add it to Pentaho using the PDI client. If you are connected to a repository, the driver is copied to the Pentaho Server driver directory. Otherwise, the driver is copied locally to the PDI client driver directory.

Perform the following steps to add a new driver.

1. Download the new driver from the Support Portal.

   1. On the Support Portal home page, sign in using the Pentaho support username and password provided in your Pentaho Welcome Packet.

   2. In the Pentaho card, click Download.

      The Downloads page opens.

   3. In the 9.x list, click See all <number> articles to see the full list of 9.x downloads.

   4. On the 9.x page, click Pentaho 9.3 GA Release.

   5. Scroll to the bottom of the Pentaho 9.3 GA Release page.

   6. In the file component section, browse to the Big Data Shims folder and download the driver file that you need.

      The following table lists the driver files that are available in the Big Data Shims folder.

      Cluster connected to PDI	File
      Cloudera Distributed Hadoop	pentaho-hadoop-shims-ee- cdh61-kar-9.3.<date>-<build number>-dist.zip
      Cloudera Data Platform	pentaho-hadoop-shims-ee- cdpdc71-kar-9.3.<date>-<build number>-dist.zip
      Google Dataproc	pentaho-hadoop-shims-ee- dataproc1421-kar-9.3.<date>- <build number>-dist.zip
      Amazon Elastic MapReduce	pentaho-hadoop-shims-ee- emr521-kar-9.3.<date>-<build number>-dist.zip
      Azure HDInsight	pentaho-hadoop-shims-ee- hdi40-kar-9.3.<date>-<build number>-dist.zip
      Hortonworks Data Platform	pentaho-hadoop-shims-ee- hdp30-kar-9.3.<date>-<build number>-dist.zip
      MapR	pentaho-hadoop-shims-ee- mapr61-kar-9.3.<date>-<build number>-dist.zip

2. Unpack the Zip file that contains the driver to a temporary directory.

   A new directory containing scripts is created in the temporary directory.

3. In the new directory, run one of the following scripts that is appropriate for the OS:

   • install.bat

   • install.sh

   • installer.jar

4. In the IZPack window read the license agreement, select I accept the terms of this license agreement, then click Next.

5. In the Select the installation path box, save the file in a temporary directory, and then click Next.

   A warning message appears.

6. Click Yes.

   The installation begins.

7. When the installation finishes, click Quit.

   The new driver is saved as a .kar file in the temporary directory that you specified.

8. In the PDI client, select the View tab of your transformation or job.

9. Right-click the Hadoop clusters folder and click Add driver.

   The Add driver dialog box appears.

10. Click Browse and navigate to where you saved the new driver .kar file you downloaded from the Support Portal.

11. Select the new driver .kar file, click Open, and then click Next.

    The Congratulations dialog box appears, notifying you that you must restart the PDI client and the Pentaho Server.

    • If you are connected to a repository, the driver is copied to the Pentaho Server driver directory.

    • If you are not connected to a repository, the driver is copied to the PDI client driver directory.