Deploying a visualization

After creating your visualization, deploy it to a Pentaho product, such as the Pentaho Server or PDI.

The Pentaho platform is built on top of an OSGi container (Apache Karaf). It allows for a modular approach at both development time and runtime, reducing complexity and facilitating deployment.

For example, to deploy the sample D3 bar chart visualization from the tutorial to Analyzer, copy the TGZ file into the pentaho-solutions/system/karaf/deploy folder.

OSGi artifacts deployment

The Pentaho platform supports deployment via dropping files into the deploy folder. Artifacts are automatically installed and activated even after you restart of the product. Replacing an artifact in the deploy folder will reinstall it. Deleting it in the folder, will uninstall it.

The deployer is able to handle ZIP and TGZ files (such as the files generated by the npm pack command) that include web resources described by a package.json file. Multiple web packages can be contained in a single archive, which provision visualization’s dependencies for example.

Depending on the Pentaho product, the Karaf deploy folder is in either of the following locations:

• PDI

  system/karaf/deploy

• Pentaho Server

  pentaho-solutions/system/karaf/deploy

Inspecting tutorial results

After deploying the sample tutorial project, the D3 bar chart visualization now appears in Analyzer and PDI. It is also available in a CDE dashboard.

In Analyzer

• The D3 bar chart visualization menu and placeholder icon appear on the canvas, as shown in the following example:

  

  Bar/D3 visualization example in Analyzer, showing the menu and placeholder icon
• The D3 bar chart visualization fully renders, as shown in the following example:

  

  Rendered Bar/D3 visualization example in Analyzer

In PDI

• The D3 bar chart visualization menu and placeholder icon appear on the canvas, as shown in the following example:

  

  Bar/D3 visualization example in PDI, showing the menu and placeholder icon
• The D3 bar chart visualization fully renders, as shown in the following example:

  

  Rendered Bar/D3 visualization example in PDI

In CTools

The D3 bar chart is available for use in a dashboard. You can obtain the following dashboard from the pentaho/pentaho-engineering-samples directory:

Bar/D3 visualization example in CTools