Installing Jaspersoft Studio

Jaspersoft Studio is available as an Eclipse Rich Client Package (RCP), downloadable from the following location:

http://community.jaspersoft.com/project/jaspersoft-studio/releases.

Requirements

Software Requirements

Jaspersoft Studio requires the Java Runtime Environment (JRE). To compile the report scriptlets, a full distribution of Java is required. The JSS installer includes the required version of Java.

During the JSS download, you must accept the Java license agreement and select the correct operating system. Jaspersoft Studio is based on Eclipse and supports several common operating systems. For the versions supported, see the JasperReports Server Supported Platform Datasheet:

• Windows, 64 bit
• Linux, 64 bit
• MacOS X, 64 bit

To find the version of Eclipse used in Jaspersoft Studio:

1. Select Help > About Jaspersoft® Studio from the main menu.
2. Click the Eclipse icon to view information about Eclipse .

Hardware Requirements

Jaspersoft Studio needs a 64-bit processor and at least 500 MB of hard disk space. The amount of RAM needed is dependent on report complexity. A value of 1 GB dedicated to Jaspersoft Studio is recommended, 2 GB is suggested.

Available Packages

The Eclipse RCP package is available in the following formats for community and commercial versions.

Commercial versions:

• js-jss_x.x.x_linux_x86_64.tgz
• js-jss_x.x.x_macosx_x86_64.dmg
• js-jss_x.x.x_sources.zip
• js-jss_x.x.x_windows_x86_64.exe
• js-jss_x.x.x_windows_x86_64.zip

x.x.x represents the version number of Jaspersoft Studio.

For community only, unsupported versions for the Eclipse RCP are available as a convenience for users who are in a restricted environment and cannot download or install an .exe file:

• js-studiocomm_x.x.x_linux_amd64.deb
• js-studiocomm_x.x.x_linux_x86_64.tgz
• js-studiocomm_x.x.x_macosx_x86_64.dmg
• js-studiocomm_x.x.x_windows_x86_64.exe
• js-studiocomm_x.x.x_windows_x86_64.zip

The community version is also available as an unsupported Eclipse plug-in, called the Jaspersoft Studio plugin. You can install it from the Eclipse Marketplace or download using the Eclipse Update Manager. See the following article on the community website for more information about working with the Jaspersoft Studio plugin.

http://community.jaspersoft.com/wiki/contributing-jaspersoft-studio-and-building-sources

Command-Line Installation on Windows

The Jaspersoft Studio installer can be run via the command line on Windows. The command-line installation supports an unattended (silent) mode.

Options for the Command-Line Installer

Option Description Notes
/S

Silent mode (optional)

 Flag to run the installer in silent mode. When /S is present, no prompt is required from the user.
/LICENSE

License Path (optional - commercial versions only)

Path to the license file to use for this installation. The license file is copied into the Jaspersoft Studio installation folder and given the following filename: Jaspersoft-JSS.license. If no license is specified, Jaspersoft Studio looks for the file Jaspersoft-JSS.license in the installation directory.

If this option is specified, it must appear before the /D option.

You can place the license file there directly instead of using the /LICENSE option.
/D Destination Directory (Mandatory) The path of the installation directory for this Jaspersoft Studio instance.

Sample Install Command

Suppose you want to use a silent install for Jaspersoft Studio and have the following setup:

• Installer Path: \JASPERSOFT\Installer\JaspersoftStudioPro-x.x.x.final-windows-installer-x86_64.exe
• License File (downloaded from support portal): C:\Jaspersoft\My Licenses\jasperserver.license
• Desired destination folder: C:\SW\JASPERSOFT\JSS\xxx

The install command is:

\JASPERSOFT\Installer\TIBCOJaspersoftStudioPro-x.x.x.final-windows-installer-x86_64.exe /S /LICENSE=C:\Jaspersoft\My Licenses\jasperserver.license /D=C:\SW\JASPERSOFT\JSS\xxx

The command-line installer looks for the license in the following order:

  1. (Optional) If the command is run including the /LICENSE option, the license at the specified path is copied into the installation folder with the filename Jaspersoft-JSS.license.
  2. Jaspersoft Studio looks in the installation folder for a license with the name Jaspersoft-JSS.license.
  3. If no license is present, the evaluation license is used.

Installing a New License File

By default Jaspersoft Studio is installed with a temporary license that expires at the end of the evaluation period. After the license expires, you can only access the community features of Jaspersoft Studio.

To obtain a commercial license, contact Jaspersoft Technical Support (https://www.jaspersoft.com/support) or your sales representative.

To install a license file:

1. Select Help > License Manager from the main menu.

Figure 1: License Manager
2. Click Install new license.
3. Browse to the location where you have placed your license file.
4. Select the license and click Open. A confirmation message appears.
5. Click OK and then Close to return to the user interface.