Selecting a PhantomJS Configuration

PhantomJS executes JavaScript when generating graphical reports that are run in the background or scheduled. (When run directly in the web UI, the browser itself renders the graphics.) You have three options:

Use the bundled PhantomJS
Use an existing PhantomJS
Use bundled Rhino library instead for rendering

Installer on Windows 7 and Above:

Due to a known issue with PhantomJS on Windows 7 and above, you should not install PhantomJS using the bundled installer on Windows 7 and above. Instead, to use PhantomJS, install JasperReports Server without PhantomJS and then install PhantomJS separately and configure JasperReports Server to use PhantomJS. See the JasperReports Server Community Project Administrator Guide for more information on configuring JasperReports Server with PhantomJS.

Choosing the Bundled PhantomJS

If you choose to install the bundled PhantomJS, the installer puts a version of PhantomJS onto your system and points JasperReports Server to its location. For information about configuring PhantomJS in JasperReports Server, see the JasperReports Server Community Project Administrator Guide.

Choosing an Existing PhantomJS

If you choose to use an existing PhantomJS executable, you'll be prompted for the location of PhantomJS. Jaspersoft recommends using PhantomJS 2.0 or later. For information about configuring PhantomJS in JasperReports Server, see the JasperReports Server Community Project Administrator Guide.

Choosing Rhino

An alternative for JasperReports Server's internal JavaScript engine is Rhino, which is an excellent solution for most cases. If you choose this option, the installer puts a version of Rhino onto your system and points JasperReports Server to its location.

Rhino may cause issues when scheduling chart-based reports or running them in the background, or when exporting dashboards. TIBCO Jaspersoft will be deprecating Rhino in a future release. If you encounter problems, you should use PhantomJS instead. See the JasperReports Server Community Project Administrator Guide for more information about limitations with Rhino.

Version: 
Feedback