<?xml version="1.0"?>
<rss version="2.0"><channel><title>Knowledge Base: Getting Started</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/?d=6</link><description>Knowledge Base: Getting Started</description><language>en</language><item><title>Cookie Security concern</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/cookie-security-concern-r5050/</link><description><![CDATA[<p>The Secure attribute in a cookie is identified by ensuring it is present in the Set-Cookie header, which restricts cookie transmission to HTTPS-only connections. It can be verified in browser Developer Tools under the "Application" or "Storage" tab, where a checkmark or explicit "Secure" label appears in the cookie details.</p><p>How to Identify Secure Cookies:</p><p>Browser Developer Tools: Open your browser's Developer Tools (F12), navigate to the Application (Chrome/Edge) or Storage (Firefox) tab, select Cookies, and check the "Secure" column for a checkmark.</p><p>Set-Cookie Header: Inspect network traffic to view the HTTP response header. A secure cookie will contain the ; Secure flag at the end of the Set-Cookie line.</p><p></p>
<p><img class="ipsImage ipsImage_thumbnailed ipsRichText__align--block" data-fileid="133280" data-full-image="//media.invisioncic.com/i328763/monthly_2026_06/Screenshot2026-04-13170435.png.642817809076daa203341727ef915ec7.png" src="//media.invisioncic.com/i328763/monthly_2026_06/Screenshot2026-04-13170435.thumb.png.fd4c4bf21a9d6f075d5a9ddc669eb930.png" height="498" width="1000" alt="Screenshot 2026-04-13 170435.png" loading='lazy'></p>
<p><img class="ipsImage ipsImage_thumbnailed ipsRichText__align--block" data-fileid="133281" data-full-image="//media.invisioncic.com/i328763/monthly_2026_06/Screenshot2026-04-13170501.png.d15e92f45665389241872bde67b0fb0e.png" src="//media.invisioncic.com/i328763/monthly_2026_06/Screenshot2026-04-13170501.thumb.png.e62337c4ce3893023bf31f3e1a059de2.png" height="490" width="1000" alt="Screenshot 2026-04-13 170501.png" loading='lazy'></p>]]></description><guid isPermaLink="false">5050</guid><pubDate>Tue, 09 Jun 2026 06:14:50 +0000</pubDate></item><item><title>JasperReports IO - Step 2</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-2/</link><description><![CDATA[
<div class="jrio">
	<div class="intro">
		<p>
			<strong><span style="font-size:24px;">Develop reports &amp; visualizations</span></strong>
		</p>

		<p>
			Before using JasperReports IO, you need to develop a report or visualization to generate. Jaspersoft Studio is a desktop designer that gives you complete control over the look, feel, and behavior of your report or visualization. Jaspersoft 7.2 is equipped with features specifically designed for JasperReports IO.
		</p>

		<p>
			In Step 2, we will show you how to get started using Jaspersoft Studio, and introduce you to the JasperReports IO features inside of it, and how to use them.
		</p>
	</div>

	<div class="steps">
		<p>
			<strong><span style="font-size:1.1em;border-bottom:1px solid #ddd;padding-bottom:5px;"><strong>JasperReports IO: 4 steps</strong></span> </strong>
		</p>

		<div>
			<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="90373" href="https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-1/" rel=""><img alt="022417_search.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90373" data-ratio="100" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2018_09/022417_search.png.0a88727fdf01c5def9795a835920cbf2.png" loading="lazy"></a>

			<p>
				<strong><a href="https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-1/" rel="">Get Started</a></strong><br>
				install, docs &amp; samples
			</p>
		</div>

		<div>
			<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="90374" href="#tutorials" rel=""><img alt="020117_visualization_design-_flexibility.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90374" data-ratio="100.37" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2018_09/020117_visualization_design-_flexibility.png.a9bffc6b89e9d1395484316b3755f756.png" loading="lazy"></a>

			<p>
				<strong><a href="#tutorials" rel="">Develop</a></strong><br>
				reports &amp; visualization
			</p>
		</div>

		<div>
			<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="90375" href="https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-3" rel=""><img alt="020117_api-led.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90375" data-ratio="100.37" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2018_09/020117_api-led.png.bd75c0b5f58e68a1ce0e8014582b2247.png" loading="lazy"></a>

			<p>
				<strong><a href="https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-3" rel="">Generate</a></strong><br>
				the content you develop
			</p>
		</div>

		<div>
			<a class="ipsAttachLink ipsAttachLink_image" href="https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-4" rel=""><img alt="022417_analytics_applications.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90376" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2018_09/022417_analytics_applications.png.f5dfd8614cd42fc37d0de54ad6387d6e.png" loading="lazy"></a>

			<p>
				<strong><a href="https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-4" rel="">Embed</a></strong><br>
				into your apps
			</p>
		</div>
	</div>
</div>

<div>
	<a rel=""></a>
</div>

<h2 style="margin-bottom:0;">
	Getting started tutorials: Develop
</h2>

<hr style="border-top:0;border-bottom:1px solid #ddd;">
<h3>
	Develop your first report in Jaspersoft Studio
</h3>

<p style="font-size:13px;">
	<i>Already familiar with Jaspersoft Studio? Skip to the <a href="#Section2" rel="">next section</a></i>
</p>

<p>
	This tutorial provides a tour of Jaspersoft Studio – a powerful desktop designer used to develop reports and data visualizations – and demonstrates the process of creating your first report using the tool.
</p>

<p>
	<iframe allowfullscreen="" frameborder="0" height="405" scrolling="no" width="720" src="https://www.youtube-nocookie.com/embed/V-iyUxD2qbE" loading="lazy"></iframe>
</p>

<p>
	 
</p>

<h3>
	...Or create an interactive data visualization in Jaspersoft Studio
</h3>

<p>
	<iframe allowfullscreen="" frameborder="0" height="405" scrolling="no" width="720" src="https://www.youtube-nocookie.com/embed/_TY9ZwGv_LE" loading="lazy"></iframe>
</p>

<p>
	 
</p>

<h3>
	Learn more Jaspersoft Studio fundamentals in the following videos:
</h3>

<ul>
	<li>
		<a href="https://www.jaspersoft.com/content/dam/jaspersoft/documents/data-sheet/Jaspersoft-Studio-datasheet-0925.pdf" rel="external nofollow">Jaspersoft Studio Overview [Data sheet]</a>
	</li>
	<li>
		<a href="https://community.jaspersoft.com/getting-started/jaspersoft-studio/" rel="">Quickstart guide to Jaspersoft Studio</a>
	</li>
	<li>
		<p>
			<a href="https://youtu.be/vrb0UcnCdbw" rel="external nofollow">How to create and use expressions in Jaspersoft Studio</a>
		</p>
	</li>
	<li>
		<p>
			<a href="https://youtu.be/Fm3n1puixno" rel="external nofollow">Using report templates in Jaspersoft Studio</a>
		</p>
	</li>
	<li>
		<p>
			<a href="https://youtu.be/aJjgTv1F13Y" rel="external nofollow">How to create and use styles in Jaspersoft Studio</a>
		</p>
	</li>
	<li>
		<p>
			<a href="https://community.jaspersoft.com/getting-started/jaspersoft-studio-guides-and-tutorials/" rel="">More guides and tutorials for Jaspersoft Studio</a>
		</p>
	</li>
</ul>

<p style="margin:0;">
	<a rel=""></a> 
</p>

<hr style="border-top:none;border-bottom:1px solid #ddd;margin-top:0;margin-bottom:34px;">
<h3>
	Learn the basics of how JasperReports IO and Jaspersoft Studio work together
</h3>

<p>
	This video introduces the fundamental concepts of setting up a Jaspersoft Studio project to leverage the JasperReports IO service.
</p>

<p>
	<iframe allowfullscreen="" frameborder="0" height="405" scrolling="no" width="720" src="https://www.youtube-nocookie.com/embed/MVW0B6ZaopQ" loading="lazy"></iframe>
</p>

<p>
	 
</p>

<h3>
	Get step-by-step instructions on how to set up your first JasperReports IO project in JSS
</h3>

<p>
	This tutorial takes concepts from the video above and demonstrates how to actually implement them in Jaspersoft Studio, including creating and configuring a JasperReports project in Jaspersoft Studio.
</p>

<p>
	<iframe allowfullscreen="" frameborder="0" height="405" scrolling="no" width="720" src="https://www.youtube-nocookie.com/embed/LAUmPEYUwcU" loading="lazy"></iframe>
</p>

<p>
	 
</p>

<h3>
	Creating and organizing a repository in Jaspersoft Studio
</h3>

<p>
	This tutorial demonstrates how to create and organize a repository in Jaspersoft Studio for a JasperReports IO project. Repositories in Jaspersoft Studio are used to store all the files and assets used in your reports and visualizations. Examples of repository assets include fonts, images, style templates, resource bundles, and more.
</p>

<p>
	<iframe allowfullscreen="" frameborder="0" height="405" scrolling="no" width="720" src="https://www.youtube-nocookie.com/embed/O3vfLBimMAM" loading="lazy"></iframe>
</p>

<p>
	 
</p>

<h3>
	Creating connections to data with data adapters in Jaspersoft Studio
</h3>

<p>
	This tutorial demonstrates how to create and configure data adapters in Jaspersoft Studio for a JasperReports IO project. Data adapters are links that connect your report or visualization to your data source(s). When a report or visualization is run, data adapters fetch data from your data source(s) to fill it.
</p>

<p>
	<iframe allowfullscreen="" frameborder="0" height="405" title="How to Use Data Adapters in Jaspersoft Studio" width="720" src="https://www.youtube.com/embed/t2TFR7YbPuM?si=l36NBNuBE7rK3ftS" loading="lazy"></iframe>
</p>

<p>
	 
</p>

<h2 style="margin-bottom:0;">
	Ready for Step 3?
</h2>

<p>
	<a href="https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-io-step-3" rel="">Click here</a> to learn how to generate the reports and visualizations you've developed.
</p>

<p>
	 
</p>
]]></description><guid isPermaLink="false">3126</guid><pubDate>Tue, 02 Oct 2018 11:06:53 +0000</pubDate></item><item><title>Jaspersoft for AWS: Connect to Amazon Data Sources</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/jaspersoft-for-aws-connect-to-amazon-data-sources-r4901/</link><description><![CDATA[<h2>Summary</h2><p>This page explains the best practices to connect to your Amazon data using Jaspersoft for AWS.<br>For Amazon Elastic MapReduce (EMR) see the <a rel="" href="/jaspersoft-aws/connect-emr">Amazon EMR connection page</a>.<br>For non-Amazon data sources see the JDBC/JNDI connections section below.</p><h2>Prerequisites</h2><ul><li><p>JasperReports Server is running.</p></li><li><p>You can login as superuser.</p></li><li><p>Get help with these requirements here:  <a rel="" href="https://community.jaspersoft.com/knowledgebase/getting-started/launching-jaspersoft-for-aws-r4902/">Launching Jaspersoft for AWS</a>.</p></li></ul><h2>Connect to Amazon RDS or Redshift</h2><p>JasperReports Server can automatically discover and connect to <a rel="external nofollow" href="http://aws.amazon.com/rds/">Amazon Relational Database Server</a> (RDS) and <a rel="external nofollow" href="http://aws.amazon.com/redshift/">Amazon Redshift</a> using the <a rel="" href="https://community.jaspersoft.com/knowledgebase/faq/jaspersoft-bi-aws-frequently-asked-questions/#wiki-header-4">auto-connect</a> feature.</p><p><span data-ips-font-size="150">1. Menu: Create -&gt; Data Source</span></p><p><span data-ips-font-size="150">2. Use EC2 instance credentials</span></p><p>The data source type should be set to "AWS Data Source". You should use "EC2 instance credentials". If EC2 instance credentials are not available, then see the <a rel="" href="#additional">Additional Connection Possibilities</a> section below.</p><p><span data-ips-font-size="150">3. Enter Database connection info</span></p><p>JasperReports Server is able to detect your RDS and Redshift data sources. This is possible because the IAM Role associated with the EC2 instance is allowed to execute the actions "rds:Describe*" and "redshift:Describe*". It pre-populates the Database Name, Driver, and URL.</p><p>You must enter the database username and password. For security reasons Amazon does not store these credentials, so Jaspersoft cannot retrieve them.</p><p>The default database is automatically populated, but you may manually enter another if your RDS or Redshift instance has multiple databases.</p><p><span data-ips-font-size="150">4. Test</span></p><p>You should always test your connection. Testing does more than just testing.</p><ul><li><p>It creates a DB Security Group.</p></li><li><p>It adds the internal IP of the EC2 instance to the security group to authorize ingress to RDS.</p></li><li><p>This is possible because the IAM Role provides the instance with credentials like "rds:CreateDBSecurityGroup" and "redshift:AuthorizeClusterSecurityGroupIngress".</p></li><li><p>If you want to control details of the security group name or specify the IP address manually because you have a complex VPC Topology, then navigate to the menu Manage -&gt; Server Settings -&gt; AWS Settings</p></li></ul><p><span data-ips-font-size="150">5. Create a Domain</span></p><p>Jaspersoft's metadata layer is called "Data Domains". Choose the menu Create -&gt; Domain.</p><p>Follow the domain creation wizard to build a domain.</p><p><span data-ips-font-size="150">6. Analyze your data</span></p><p>Choose the menu Create -&gt; Ad Hoc View. Find your newly created domain and use the ad hoc environment to begin analyzing your data.</p><p><span data-ips-font-size="150">7. Next steps</span></p><p>Refer to the Online Learning Portal for lots of details on creating domains, performing ad hoc analysis, and creating reports.</p><h2>Additional Connection Possibilities</h2><p><span data-ips-font-size="150">1. AWS Credentials</span></p><p>Under normal circumstances it's best to launch Jaspersoft BI on an EC2 instance with an associated IAM Role. This role provides the instance with EC2 credentials.</p><p>If this option is not available for some reason, then it's possible to use AWS credentials instead. If you already have AWS Credentials, you may enter the Access Key and Secret Key.</p><p>If you do not have AWS Credentials, you may run the CloudFormation Template "jrs-create-user" to generate credentials.</p><p><span data-ips-font-size="150">2. JDBC / JNDI Connections</span></p><p>NOTE: When using JDBC for data source connections, the user will be responsible for managing the security groups to allow access from the Jaspersoft server to the data source. Please refer to the comparison of benefits of JDBC connections vs. AWS Data Sources, detailed below.</p><p><span data-ips-font-size="150">Amazon RDS or Redshift</span></p><p>When connecting to Amazon RDS or Redshift, it is best to use the data source type "AWS Data Source" to make configuration easier. If you prefer, JDBC connections may used to connect to Amazon RDS or Redshift, per below. To connect using JDBC, choose the data source type "JDBC Data Source". Enter all connection information and test. Alternatively, you can choose "JNDI Data Source" and refer to a data source defined in Apache Tomcat.</p><p>Benefits of defining your own JDBC connections:</p><ul><li><p>You have complete control</p></li></ul><p>Benefits of using AWS Data Sources:</p><ul><li><p>Jaspersoft provides the driver and URL</p></li><li><p>Data source automatically recovers if the IP address changes</p></li><li><p>Data source automatically recovers if DB Security Groups are modified</p></li></ul><h2>Connect to Amazon Elastic MapReduce</h2><p>The JasperReports Server auto-connect feature is not supported for Amazon Elastic MapReduce (EMR). Connections to EMR need to be configured manually.<br>Please see the <a rel="" href="/jaspersoft-aws/connect-emr">Amazon EMR connection page</a> for details.</p><p> </p>]]></description><guid isPermaLink="false">4901</guid><pubDate>Thu, 23 Oct 2025 22:30:16 +0000</pubDate></item><item><title>Launching Jaspersoft for AWS</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/launching-jaspersoft-for-aws-r4902/</link><description><![CDATA[<p>This page explains the best practices in launching Jaspersoft's AMI on Amazon Web Services (AWS) Marketplace.</p><p>Jaspersoft offers Hourly, Annual, and BYOL (Bring Your Own License) AMIs. The AMIs should be launched via instructions on this page using <a rel="external nofollow" href="http://aws.amazon.com/cloudformation/aws-cloudformation-templates/">Cloud Formation Templates</a>. Cloud Formation Templates ensure that Jaspersoft is configured properly for your selected AMI size, for example Memory configuration. Cloud Formation Templates are particularly important for <a rel="external nofollow" href="http://aws.amazon.com/vpc/">VPC</a> configuration.</p><p>Follow the steps listed below to get your instance running. You can also find more details about launching and managing <a rel="" href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jaspersoft-for-aws-user-guide-1/v901/aws-_-introduction/">Jaspersoft for AWS in our Guide</a>.</p><h2>Prerequisites</h2><ul><li><p><strong>Amazon AWS Account</strong><br>Don't have an AWS account? <a rel="external nofollow" href="https://www.amazon.com/ap/signin?openid.assoc_handle=aws&amp;openid.return_to=https%3A%2F%2Fportal.aws.amazon.com%2Fgp%2Faws%2Fdeveloper%2Fregistration%3Fie%3DUTF8%26redirectURL%3Dhttps%253A%252F%252Faws.amazon.com%252Fmarketplace%253F%26productCode%3DAmazonEC2%26redirectOnSignUp%3D1&amp;openid.mode=checkid_setup&amp;openid.ns=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0&amp;openid.identity=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&amp;openid.claimed_id=http%3A%2F%2Fspecs.openid.net%2Fauth%2F2.0%2Fidentifier_select&amp;action=&amp;disableCorpSignUp=&amp;clientContext=&amp;marketPlaceId=&amp;poolName=&amp;authCookies=&amp;pageId=aws.ssop&amp;siteState=&amp;accountStatusPolicy=P1&amp;sso=&amp;openid.pape.preferred_auth_policies=MultifactorPhysical&amp;openid.pape.max_auth_age=3600&amp;openid.ns.pape=http%3A%2F%2Fspecs.openid.net%2Fextensions%2Fpape%2F1.0&amp;server=%2Fap%2Fsignin%3Fie%3DUTF8&amp;accountPoolAlias=&amp;forceMobileApp=0&amp;forceMobileLayout=0">Sign up here</a>.</p></li><li><p><strong>Amazon Key Pair for security</strong><br>Don't have an <a rel="external nofollow" href="http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-key-pairs.html">Amazon Key Pair</a> defined? <a rel="external nofollow" href="https://console.aws.amazon.com/ec2/home?region=us-east-1#s=KeyPairs">Define one here</a>.</p></li><li><p><strong>Jaspersoft annual subscription</strong> (only needed for BYOL AMI)</p></li></ul><h2>Note about AWS EC2 instances</h2><p>AWS EC2 instances are charged per hour or annually. Please make sure to follow <a rel="external nofollow" href="http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/Stop_Start.html">instructions</a> to turn off your EC2 instance server running Jaspersoft after use. If not, you will continue to be charged by the hour for EC2 usage.  <em>Remember that when you stop your EC2 instance server, no one will have access to any reports or dashboards you have created until you restart the EC2 instance server.</em></p><p>When you stop an EC2 instance server, you will still be charged for <a rel="external nofollow" href="http://aws.amazon.com/ebs/">EBS</a> usage. If you prefer not to be charged for EBS, make sure to <a rel="external nofollow" href="http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/terminating-instances.html">terminate</a> your EC2 instance server.  <em>Remember that if you do so, none of your work will be retrievable.</em></p><h2>Start an EC2 instance with Jaspersoft inside <a rel="external nofollow" href="http://aws.amazon.com/vpc/">VPC</a></h2><p>Following these steps will give you a secure and easily maintainable instance of Jaspersoft.<br>Launching a server manually in the EC2 console will work fine, but you will miss out on the <a rel="" href="/knowledgebase/jaspersoft-bi-aws-frequently-asked-questions#auto-connect">auto-connect</a> for Amazon RDS and Redshift that the CloudFormation Templates provide.</p><h2>Launching Jaspersoft for AWS</h2><details class="ipsRichTextBox ipsRichTextBox--expandable ipsRichText__no-index"><summary class="ipsRichTextBox__title"><p>Launching Jaspersoft for AWS into VPC</p></summary><ol><li><p><strong>Accept License Agreement</strong><br>First find Jaspersoft on the AWS Marketplace. <a rel="external nofollow" href="https://aws.amazon.com/marketplace/search/results/ref=gtw_navgno_search_box?searchTerms=jaspersoft&amp;search=">Go directly to the Jaspersoft listings.</a> Note there are hourly, annual, and BYOL versions. Continue to the launch pages. Accept Terms, but DO NOT launch directly using 1-Click or the EC2 Console.</p></li><li><p><strong>Select ONLY one of the following:</strong></p><ol><li><p><strong>Run CloudFormation Template, including VPC configuration, for "Jaspersoft Reporting and Analytics for AWS"</strong><br>Select a region to launch an instance of Jaspersoft for AWS, either Hourly or Annually with option for Free Online Support. The link will launch a CloudFormation Template in your AWS Console to securely launch an instance. It takes about 10 minutes.</p></li><li><p><strong>Run CloudFormation Template, including VPC configuration, for "Jaspersoft for AWS with Multi-Tenancy"</strong><br>Select a region to launch an instance of Jaspersoft for AWS with Multi-tenancy, either Hourly or Annually with option for Free Online Support. The link will launch a CloudFormation Template in your AWS Console to securely launch an instance. It takes about 10 minutes.</p></li><li><p><strong>Run CloudFormation Template, including VPC configuration, for "BYOL" AMI</strong><br>Select a region to launch an instance of Jaspersoft for AWS. The link will launch a CloudFormation Template with VPC in your AWS Console to securely launch an instance. It takes about 10 minutes.</p></li></ol></li><li><p><strong>Upload Your License (BYOL AMI Only)</strong><br>Please reference <a rel="" href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jaspersoft-for-amazon-web-services-aws/vv900/aws-_-applying-byol-license/">this section</a> in the Jaspersoft for AWS User Guide to learn how to upload your Jaspersoft license.</p></li></ol></details><details class="ipsRichTextBox ipsRichTextBox--expandable ipsRichText__no-index"><summary class="ipsRichTextBox__title"><p>Launching Jaspersoft for AWS Cluster</p></summary><ol><li><p><strong>Accept License Agreement</strong><br>First find Jaspersoft on the AWS Marketplace. <a rel="external nofollow" href="https://aws.amazon.com/marketplace/search/results/ref=gtw_navgno_search_box?searchTerms=jaspersoft&amp;search=">Go directly to the Jaspersoft listings</a>. Note there are hourly, annual, and BYOL versions. Continue to the launch pages. Accept Terms, but DO NOT launch directly using 1-Click or the EC2 Console.</p></li><li><p><strong>Run CloudFormation Template for "Jaspersoft Reporting and Analytics for AWS Cluster (Manual - VPC)"</strong><br>Select a region to launch an instance of Jaspersoft for AWS, either Hourly or Annually with option for Free Online Support. The link will launch a CloudFormation Template in your AWS Console to securely launch an instance. It takes about 10 minutes.</p></li><li><p><strong>Review the Jaspersoft for AWS User Guide</strong><br>Please reference <a rel="" href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jaspersoft-for-aws-user-guide-1/v901/aws-_-installation/">this document</a> to learn more about configuring and using your new instance.</p></li></ol></details><details class="ipsRichTextBox ipsRichTextBox--expandable ipsRichText__no-index"><summary class="ipsRichTextBox__title"><p>Launching Jaspersoft for AWS Cluster with Multi-Tenancy</p></summary><ol><li><p><strong>Accept License Agreement</strong><br>First find Jaspersoft on the AWS Marketplace. <a rel="external nofollow" href="https://aws.amazon.com/marketplace/search/results/ref=gtw_navgno_search_box?searchTerms=jaspersoft&amp;search=">Go directly to the Jaspersoft listings</a>. Note there are hourly, annual, and BYOL versions. Continue to the launch pages. Accept Terms, but DO NOT launch directly using 1-Click or the EC2 Console.</p></li><li><p><strong>Run CloudFormation Template for "Jaspersoft Reporting and Analytics for AWS Cluster (Manual - VPC)"</strong><br>Select a region to launch an instance of Jaspersoft for AWS, either Hourly or Annually with option for Free Online Support. The link will launch a CloudFormation Template in your AWS Console to securely launch an instance. It takes about 10 minutes.</p></li><li><p><strong>Review the Jaspersoft for AWS User Guide</strong><br>Please reference <a rel="" href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jaspersoft-for-aws-user-guide-1/v901/aws-_-installation/">this document</a> to learn more about configuring and using your new instance.</p></li></ol></details><details class="ipsRichTextBox ipsRichTextBox--expandable ipsRichText__no-index"><summary class="ipsRichTextBox__title"><p>Launching Jaspersoft for AWS BYOL Cluster</p></summary><ol><li><p><strong>Accept License Agreement</strong><br>First find Jaspersoft on the AWS Marketplace. <a rel="external nofollow" href="https://aws.amazon.com/marketplace/search/results/ref=gtw_navgno_search_box?searchTerms=jaspersoft&amp;search=">Go directly to the Jaspersoft listings</a>. Note there are hourly, annual, and BYOL versions. Continue to the launch pages. Accept Terms, but DO NOT launch directly using 1-Click or the EC2 Console.</p></li><li><p><strong>Run CloudFormation Template for "Jaspersoft Reporting and Analytics for AWS BYOL Cluster (Manual - VPC)"</strong><br>Select a region to launch an instance of Jaspersoft for AWS with option for Free Online Support. The link will launch a CloudFormation Template in your AWS Console to securely launch an instance. It takes about 10 minutes.</p></li><li><p><strong>Review the Jaspersoft for AWS User Guide and Upload Your License</strong><br>Please reference <a rel="" href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jaspersoft-for-aws-user-guide-1/v901/aws-_-applying-byol-license/">this section</a> in the Jaspersoft for AWS User Guide to learn how to upload your Jaspersoft license.</p></li></ol></details><p></p><h2>Additional Information</h2><h3>Using the EC2 Console</h3><p>Launching a server manually in the EC2 console will work fine, and you'll have a useful business intelligence server, but you'll miss out on several features to make your life easier. It's recommended to always launch using the provided CloudFormation Templates.</p><h3>Additional CloudFormation Templates</h3><p>Jaspersoft's CloudFormation templates allow you to automatically create all of the resources needed for a Business Intelligence server. This includes defining the AMI to be used for a new EC2 instance, defining an IAM Role to set the EC2 credentials, and defining policies to allow this role to connect to AWS data sources. These policies include actions including "rds:CreateDBSecurityGroup", "redshift:AuthorizeClusterSecurityGroupIngress", and "ec2:DescribeSecurityGroups".</p><p>Instead of running the template "jrs-launch-instance" which creates all needed resources, it's possible to run templates to create just the <a rel="external nofollow" href="http://aws.amazon.com/iam/">IAM Role</a> or <a rel="external nofollow" href="http://aws.amazon.com/iam/">IAM User</a>. After running these templates, Jaspersoft BI for AWS can be launched from the EC2 Console. Be sure to associate the correct IAM Role with the EC2 instance so that the BI server will be authorized to connect to Amazon RDS and Amazon Redshift data.</p><p> </p>]]></description><guid isPermaLink="false">4902</guid><pubDate>Thu, 23 Oct 2025 22:39:27 +0000</pubDate></item><item><title>Issues Concerning Specifying Parameters in TIBCO JasperReports&#xAE; Server  Dashlets</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/issues-concerning-specifying-parameters-tibco-jasperreports-server-dashlets/</link><description><![CDATA[<p>In TIBCO JasperReports<span class="ipsEmoji">®</span> Server User Guide, section  <a rel="" href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-dashboards-_-dashboards-parameters-in-dashlets/">"Specifying Parameters in Dashlets"</a>, there are examples of how to hyperlink an ad hoc chart slice to another dashboard. For repository hyperlinks in a chart dashlet, users need to use the syntax ?filter_in_target=$P{dashlet_param} to pass the chart slice value to another dashboard.</p><p>"filter_in_target" is the filter internal reference name in the hyperlinked dashboard. To find out this filter's internal name, users can export the dashboard and inspect exported zip file content. Under dashboard repository structure, users should find a {dashboard_name}.xml file. In this file, look for &lt;inputControl&gt; seåction and filter_in_target name is identified in the &lt;name&gt; property tag.</p><p>As for the dashlet_param value in $P{} part of the URL, users can simply type in the field name in the dashlets properties parameters list.</p><p><img class="ipsImage ipsImage_thumbnailed ipsRichText__align--block" data-fileid="90518" src="//media.invisioncic.com/i328763/monthly_2018_11/5_1.png.faa9dcd96bd41a98184296cf0351183a.png" alt="5_1.png.faa9dcd96bd41a98184296cf0351183a.png" title="5_1.png.faa9dcd96bd41a98184296cf0351183a.png" data-full-image="//media.invisioncic.com/i328763/monthly_2018_11/5_1.png.faa9dcd96bd41a98184296cf0351183a.png" loading="lazy"></p><p>NOTICE feature for Auto-complete parameters is based on previously accessed items in a dashboard in the designer. This feature does not provide items from all dashlets on a newly designed dashboard. Users will need to save the dashboard first, then edit hyperlink to get all available items in Auto-complete parameters list.</p><hr><p><strong><em>TTC-20181101</em></strong></p><p><img class="ipsImage ipsImage_thumbnailed ipsRichText__align--block" data-fileid="90519" src="//media.invisioncic.com/i328763/monthly_2018_11/5_1.png.e2eadd251227e41fae4e353c220cd1a0.png" alt="5_1.png.e2eadd251227e41fae4e353c220cd1a0.png" title="5_1.png.e2eadd251227e41fae4e353c220cd1a0.png" data-full-image="//media.invisioncic.com/i328763/monthly_2018_11/5_1.png.e2eadd251227e41fae4e353c220cd1a0.png" loading="lazy"></p>]]></description><guid isPermaLink="false">3175</guid><pubDate>Thu, 01 Nov 2018 20:21:06 +0000</pubDate></item><item><title>Error invoking getDriver() method when using buildomatic</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/error-invoking-getdriver-method-when-using-buildomatic/</link><description><![CDATA[<p><strong>Problem:</strong><br>During manual WAR file installation you get the following errors on database check:</p><pre spellcheck="" class="ipsCode language-java" data-language="Java"><code>
BUILD FAILED
C:\Jaspersoft630\JRS630\buildomatic\bin\validation.xml:495: The following error occurred while executing this line:
C:\Jaspersoft630\JRS630\buildomatic\bin\validation.xml:376: The following error occurred while executing this line:
C:\Jaspersoft630\JRS630\buildomatic\conf_source\db\sqlserver\db.xml:29: The following error occurred while executing this line:
C:\Jaspersoft630\JRS630\buildomatic\bin\app-server.xml:60: C:\Jaspersoft630\JRS630\buildomatic\bin\app-server.xml:60: Error invoking getDriver() method
</code></pre><h2>Solution:</h2><p>This is a classic Jaspersoft installation hurdle. The "Error invoking getDriver() method" accompanied by a failure in the <code>db.xml</code> script means that the <code>buildomatic</code> Ant scripts cannot find the JDBC driver required to communicate with your database.</p><p>Looking at your stack trace (<code>\conf_source\db\sqlserver\db.xml</code>), you are trying to connect to a <strong>Microsoft SQL Server</strong> database.<br><br>Because of licensing restrictions, TIBCO Jaspersoft does not always bundle proprietary JDBC drivers (like those for SQL Server or Oracle) in the standard installer or ZIP file. You have to add it manually before running the build scripts.</p><p><strong>1. Download the SQL Server JDBC Driver</strong></p><p>If you don't already have it, download the official Microsoft JDBC Driver for SQL Server. For Jaspersoft 6.3.0, you typically need a driver compatible with Java 7 or 8 (usually sqljdbc4.jar, sqljdbc41.jar, or sqljdbc42.jar).</p><p><strong>2. Place the Driver in the Buildomatic Directory</strong></p><p>The buildomatic tool looks for database-specific drivers in a very specific folder. Copy your downloaded .jar file and paste it into this exact directory based on your stack trace:</p><p>C:\Jaspersoft630\JRS630\buildomatic\conf_source\db\sqlserver\jdbc\</p><p>(Note: If the jdbc folder does not exist inside the sqlserver directory, create it).</p><p><strong>3. Verify default_</strong><a rel="external nofollow" href="https://master.properties"><strong>master.properties</strong></a></p><p>Open your C:\Jaspersoft630\JRS630\buildomatic\default_<a rel="external nofollow" href="https://master.properties">master.properties</a> file and double-check your database settings. Ensure the driver class is specified correctly for SQL Server:</p><p>In default_<a rel="external nofollow" href="https://master.properties">master.properties</a> make sure that the native driver configuration matches the jar you have. Due to certain buildomatic restrictions, the jar filename needs also to accommodate the configuration as well. That means that you need to have a JAR in the following naming format: artifactID-version.jar. If you are missing the version then you won't be able to specify the maven.jdbc.versionMake sure the user has full read access to the JAR file.</p>]]></description><guid isPermaLink="false">2429</guid><pubDate>Thu, 27 Oct 2016 01:30:04 +0000</pubDate></item><item><title>Error when publishing with version 10 in Jaspersoft Studio</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/error-when-publishing-with-version-10-in-jaspersoft-studio-r5027/</link><description><![CDATA[<p>If you are getting this error when publishing your report from Jaspersoft Studio on version 10, you are probably still using version 9 as your server.</p><p>Upgrade your server to version 10.</p><p>org.apache.http.client.HttpResponseException: illegal.parameter.value.error<br>The value "JRXML.content" for parameter "JRXML.content" is invalid.</p>]]></description><guid isPermaLink="false">5027</guid><pubDate>Thu, 07 May 2026 14:40:01 +0000</pubDate></item><item><title>Hotfix-9.0.0 compatibility with MySQL 8.4</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/hotfix-900-compatibility-with-mysql-84-r5012/</link><description><![CDATA[<p>With the release of Hotfix-9.0.0 build <em>hotfix_JRSPro9.0.0_cumulative_20260428_0806.zip</em>, JasperReports Server is tested and certified against MySQL 8.4, ensuring full compatibility, stability, and support for this database version.</p><p>If you are currently running MySQL 8.4 or planning to upgrade to it, we recommend updating your JasperReports Server installation to Hotfix 9.0.0 build <em>hotfix_JRSPro9.0.0_cumulative_20260428_0806.zip</em> or later to take advantage of this certified support.</p>]]></description><guid isPermaLink="false">5012</guid><pubDate>Fri, 24 Apr 2026 09:47:30 +0000</pubDate></item><item><title>Issue logging into Jaspersoft Studio on launch</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/jaspersoft-studio-login-error/</link><description><![CDATA[<p>Some users have reported an issue when logging into Jaspersoft Studio upon initial launch.  Should you encounter an error message, this article walks you through steps to troubleshoot any problems.  Below, we've included a short video demonstrating steps to solve any errors, and get you from download to designing your first report in no time!</p><p>When opening Jaspersoft Studio for the first time, you will be prompted to login with your Jaspersoft community email and password. </p><p><em>Note: If you do not already have an account, you will need to create one at: </em><a rel="" href="https://community.jaspersoft.com/register/"><em>https://community.jaspersoft.com/register/</em></a></p><p>This login process is only required once, upon first launching the software.  When logging in, if a message appears that "The provided credentials are invalid", please try the following steps:</p><p><img class="ipsImage ipsRichText__align--block" data-fileid="132900" src="//media.invisioncic.com/i328763/monthly_2025_10/jss-invalid-credentials-message.png.b402da7e783797741ceb3cc7e1f94170.png" alt="jss-invalid-credentials-message.png" title="jss-invalid-credentials-message.png" width="747" height="216" loading="lazy"></p><p><strong>Provided credentials are invalid.  Now what?</strong></p><ol><li><p><strong>Double-check the email and password were entered correctly.</strong><br>You can confirm your account email and password by logging into the community site at: <a rel="" href="https://community.jaspersoft.com/login/">https://community.jaspersoft.com/login/</a><br> </p></li><li><p><strong>Disable your VPN or proxy server.</strong><br>If you have determined the account email and password entered are correct, the issue is often due to either a VPN or proxy server being unable to connect to the Jaspersoft login server.  In such a scenario, disabling these temporarily for the login process will usually resolve the issue, allowing Jaspersoft Studio to connect and confirm your login credentials.  Once logged in, you can re-enable your VPN/proxy server.  Again, you will only need to log in the first time starting up Jaspersoft Studio.<br> </p></li><li><p><strong>Use the Alternative Login Method.</strong><br>For those who cannot or do not wish to disable their VPN proxy server, we have provided users with an Alternative Login Method.  Clicking this provides you with the options to either:<br>    a) Scan the QR code and log in to the community site with your phone, or<br>    b) Click the "Copy URL button" and paste this into a browser window to log in.  <br>Once you have successfully logged in via one of these methods, you will be given a code to insert into the box and validate your account.</p><p><img class="ipsImage ipsRichText__align--block" data-fileid="132907" src="//media.invisioncic.com/i328763/monthly_2025_10/QR-code-login.png.5c09ee4be38973f8e769b6f006511651.png" alt="Alternative login method - QR code" title="Alternative login method - QR code" width="755" height="573" loading="lazy"></p></li><li><p><strong>Still unable to login?</strong><br>On rare instances, a user may experience difficulty due to their unique configuration. In this scenario, rather than an alert stating "Your login credentials are invalid", you might get an exception error with a readout of the error details below.  Please reach out to us via chat for assistance. </p></li></ol><p>We hope this post has helped get you connected.  Ready to <a rel="" href="https://community.jaspersoft.com/getting-started/jaspersoft-studio/"><strong>Get started with Jaspersoft Studio</strong></a>?</p><p> </p>]]></description><guid isPermaLink="false">4898</guid><pubDate>Fri, 10 Oct 2025 18:11:05 +0000</pubDate></item><item><title>Feature compatibility matrix for JasperReports Web Studio</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/feature-compatibility-matrix-jasperreports-web-studio/</link><description><![CDATA[<p><strong>The following table describes the available features for Jaspersoft<span class="ipsEmoji">®</span> Studio and JasperReports<span class="ipsEmoji">®</span> Web Studio.</strong></p><div class="ipsRichText__table-wrapper"><table style="min-width: 120px;"><colgroup><col style="min-width:20px;"><col style="min-width:20px;"><col style="min-width:20px;"><col style="min-width:20px;"><col style="min-width:20px;"><col style="min-width:20px;"></colgroup><tbody><tr><th colspan="1" rowspan="1"><p>Feature</p></th><th colspan="1" rowspan="1"><p>Jaspersoft Studio</p></th><th colspan="1" rowspan="1"><p>JasperReports Web Studio 1.0</p></th><th colspan="1" rowspan="1"><p>JasperReports Web Studio 2.0</p></th><th colspan="1" rowspan="1"><p>JasperReports Web Studio 3.0</p></th><th colspan="1" rowspan="1"><p>JasperReports Web Studio 3.0.1</p></th></tr><tr><td colspan="1" rowspan="1"><p>Installation</p></td><td colspan="1" rowspan="1"><p>Desktop - Every user needs to install</p></td><td colspan="4" rowspan="1"><p>Browser + Server Side - single installation for multiple users</p></td></tr><tr><td colspan="1" rowspan="1"><p>Repositories</p></td><td colspan="1" rowspan="1"><p>JasperReports Server</p></td><td colspan="1" rowspan="1"><p>Google Drive, GitHub, JasperReports Server</p></td><td colspan="3" rowspan="1"><p>Google Drive, GitHub, Jackrabbit, Local Folders</p></td></tr><tr><td colspan="1" rowspan="1"><p>JRS Report Units</p></td><td colspan="1" rowspan="1"><p>Create, reorder input controls add and delete resources. Edit create all types of resources</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="2" rowspan="1"><p>Create, reorder input controls add and delete resources.</p></td></tr><tr><td colspan="1" rowspan="1"><p>Jackrabbit Repository</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="1" rowspan="1"><p>Simple resource structure</p></td><td colspan="2" rowspan="1"><p>Owner and repositories<br>All kinds of limits<br>Permissions</p></td></tr><tr><td colspan="1" rowspan="1"><p>Data Adapters</p></td><td colspan="1" rowspan="1"><p>JDBC, CSV, Excel, JNDI, JSON, XML, JasperReports Server, Query Executor, Mondrian, MongoDB</p></td><td colspan="1" rowspan="1"><p>JDBC, CSV, Excel, JNDI, JSON, XML</p></td><td colspan="3" rowspan="1"><p>JDBC, CSV, Excel, JNDI, JSON, XML, JasperReports Server, Query Executor, Mondrian, MongoDB</p></td></tr><tr><td colspan="1" rowspan="1"><p>File Editors</p></td><td colspan="1" rowspan="1"><p>Editors for all files</p></td><td colspan="1" rowspan="1"><p>Yes (Text Editor basic, No Image editor)</p></td><td colspan="3" rowspan="1"><p>Text and Image Editor</p></td></tr><tr><td colspan="1" rowspan="1"><p>JRXML Editor</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="4" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Report Preview</p></td><td colspan="1" rowspan="1"><p>Preview and export in multiple (image, JSON, XML, text) formats, Parameter prompts(user and built-in, wizards for much more parameter types, reset, and set to null parameters, default parameter values), sort fields, export property settings, bookmarks, book tabs, no search report functionality, select data adapter, data snapshots, report execution statistics, and logs, input controls for JasperReports Server.</p></td><td colspan="1" rowspan="1"><p>PDF, HTML, Excel, open doc, PPT, no parameter prompts, no sort fields, no export property setting, no bookmarks, no book tabs, no search functionality, no data adapter selection, no data snapshots, no report execution statics, and logs, no input controls</p></td><td colspan="3" rowspan="1"><p>PDF, HTML, EXCEL, doc, open doc, metadata, PPT, parameter prompts supported by JRIO, no defaults, reset for all (not for individual), no null value setting, no sort fields, no export property setting, bookmarks, book tabs, functionality, no data adapter selection, no data snapshots, no report execution statistics and logs, no input controls</p></td></tr><tr><td colspan="1" rowspan="1"><p>Query Preview</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Query Editors</p></td><td colspan="1" rowspan="1"><p>Specialized UI query editors for different query languages</p></td><td colspan="1" rowspan="1"><p>Only a simple text editor</p></td><td colspan="3" rowspan="1"><p>Text editor with syntax highlighting</p></td></tr><tr><td colspan="1" rowspan="1"><p>Outline</p></td><td colspan="1" rowspan="1"><p>Lot of functionalities and actions (drag and drop, arrange elements, menus for different things to generate or verify something)</p></td><td colspan="1" rowspan="1"><p>Just showing report structure, not possible to add or remove bands</p></td><td colspan="3" rowspan="1"><p>Report structure, possible to add or remove bands</p></td></tr><tr><td colspan="1" rowspan="1"><p>Designer</p></td><td colspan="1" rowspan="1"><p>Render elements with JasperReports, tools and actions to arrange elements, snap to grid, layouts, key shortcuts,</p></td><td colspan="1" rowspan="1"><p>Basic Rendering of the report, element re-arrangement, move or resize, delete</p></td><td colspan="1" rowspan="1"><p>Improved rendering of text elements (render better fonts, sizes, and other properties), improvements in key shortcuts, every chart type has image now instead of static image</p></td><td colspan="1" rowspan="1"><p>Improved over 2.0 Copy, Cut and Paste elements Drag and Drop fields, better Expression editor, Dataset model validation, Dataset changes refactoring</p></td><td colspan="1" rowspan="1"><p>Improved Expression editor, Snap to Geometry, Image preview, Inline text element editing, Column support</p></td></tr><tr><td colspan="1" rowspan="1"><p>Parameter Prompts</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Search in Preview</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Report Bursting</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Data snapshots</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="4" rowspan="1"><p>No</p></td></tr><tr><td colspan="1" rowspan="1"><p>Bookmarks, Book Tabs</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Data Structure View</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Generate Fields</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Element Rendering</p></td><td colspan="1" rowspan="1"><p>Rendering with JasperReports<span class="ipsEmoji">®</span> Library</p></td><td colspan="1" rowspan="1"><p>Basic rendering</p></td><td colspan="3" rowspan="1"><p>Improved text fields, charts, and images</p></td></tr><tr><td colspan="1" rowspan="1"><p>Palette</p></td><td colspan="1" rowspan="1"><p>Dynamic (showing different images sizes, search elements, add elements)</p></td><td colspan="1" rowspan="1"><p>Show all elements</p></td><td colspan="3" rowspan="1"><p>Have elements by category, improved labels, and icons</p></td></tr><tr><td colspan="1" rowspan="1"><p>Properties</p></td><td colspan="1" rowspan="1"><p>Advanced view and specialized UI, search, reset, set to null, default values, styles view, more complex widgets for different property types</p></td><td colspan="1" rowspan="1"><p>For simple elements, simple types, search</p></td><td colspan="1" rowspan="1"><p>Properties for all elements, search, arranged in categories, more widgets for diff types, show default values</p></td><td colspan="2" rowspan="1"><p>Added file selection image, subreport selection</p></td></tr><tr><td colspan="1" rowspan="1"><p>Styles</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Highcharts</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>Just generated properties for Highcharts</p></td><td colspan="3" rowspan="1"><p>Improved properties (arranged in categories, more widget types)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Fusion</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>Just general properties (no fusion-specific ones)</p></td><td colspan="3" rowspan="1"><p>Improved properties (arranged in categories, more widget types), all fusion properties (fusion-specific ones)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Barcodes</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>Just general properties (no specific ones)</p></td><td colspan="3" rowspan="1"><p>Improved properties (arranged in categories, more widgets types), all properties (specific ones)</p></td></tr><tr><td colspan="1" rowspan="1"><p>CVC</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>Just general properties (no specific ones)</p></td><td colspan="3" rowspan="1"><p>Improved properties (arranged in categories, more widgets types), all properties (specific ones)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Tables, Crosstab</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>Render and show elements (can modify elements)</p></td><td colspan="2" rowspan="1"><p>Render and show elements (can modify elements), we have all the properties</p></td><td colspan="1" rowspan="1"><p>Add, remove or reorder columns</p></td></tr><tr><td colspan="1" rowspan="1"><p>Maps</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>Just general properties (no specific ones)</p></td><td colspan="3" rowspan="1"><p>Improved properties(arranged in categories, more widgets types), all properties (specific ones)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Markers Clustering</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>Charts</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>Just general properties (no specific ones)</p></td><td colspan="3" rowspan="1"><p>Improved properties (arranged in categories, more widgets types), all properties (specific ones)</p></td></tr><tr><td colspan="1" rowspan="1"><p>Bursting, splitting</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Yes</p></td></tr><tr><td colspan="1" rowspan="1"><p>JasperReports Server Report Publishing</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="4" rowspan="1"><p>Not needed</p></td></tr><tr><td colspan="1" rowspan="1"><p>Custom Properties</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>All custom properties defined in the library</p></td></tr><tr><td colspan="1" rowspan="1"><p>Expression Editor</p></td><td colspan="1" rowspan="1"><p>Advanced (can see datasets, functions)</p></td><td colspan="1" rowspan="1"><p>Simple Text</p></td><td colspan="1" rowspan="1"><p>Simple text, Syntax highlighting for Java, Groovy, JavaScript</p></td><td colspan="2" rowspan="1"><p>Added dataset objects in the dialog</p></td></tr><tr><td colspan="1" rowspan="1"><p>JR Properties UI</p></td><td colspan="1" rowspan="1"><p>Advanced (lot of preferences pages)</p></td><td colspan="1" rowspan="1"><p>No</p></td><td colspan="3" rowspan="1"><p>Set JasperReports Library properties in the context.xml file</p></td></tr><tr><td colspan="1" rowspan="1"><p>Report Compilation</p></td><td colspan="1" rowspan="1"><p>Yes</p></td><td colspan="4" rowspan="1"><p>Not needed (because JasperReports<span class="ipsEmoji">®</span> IO compiles it)</p></td></tr></tbody></table></div><p> </p>]]></description><guid isPermaLink="false">4895</guid><pubDate>Tue, 23 Sep 2025 05:50:27 +0000</pubDate></item><item><title>Jaspersoft Studio: Resources and tutorials for getting started</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/jaspersoft-studio-resources-and-tutorials/</link><description><![CDATA[<div class="tutorials">
	<p>
		Welcome to the Jaspersoft® Studio tutorials archive.<br />
		Here you will find a list of related tutorials, tips &amp; tricks, and other useful resources.
	</p>

	<hr />
	<h2>
		Getting Started with Jaspersoft® Studio
	</h2>

	<p style="margin-top:0;">
		The following tutorials explain the basics of how Jaspersoft Studio works. They are highly recommended, especially to new users.
	</p>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/introduction-jaspersoft-studio" rel="">What is Jaspersoft Studio?</a>
	</h3>

	<div>
		An introduction to Jaspersoft Studio, the new report designer for JasperReports based on Eclipse.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/getting-started-jaspersoft-studio/" rel="">Getting Started with Jaspersoft Studio</a>
	</h3>

	<div>
		The minimum requirements, how to install it and some compilation information.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/designing-report-jaspersoft-studio" rel="">Designing a Report</a>
	</h3>

	<div>
		Create your first report in a few seconds.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/report-structure-jaspersoft-studio" rel="">Report Structure</a>
	</h3>

	<div>
		Description of the basic structure of a report: bands, columns and properties.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/drag-and-drop-jaspersoft-studio" rel="">Drag &amp; Drop</a>
	</h3>

	<div>
		How the drag &amp; drop works inside Jaspersoft Studio
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/exporting-reports-jaspersoft-studio" rel="">Exporting Reports</a>
	</h3>

	<div>
		How to compile and export reports.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/measure-units-jaspersoft-studio" rel="">Measure Units</a>
	</h3>

	<div>
		Getting familiar with the different measure units.
	</div>

	<h2>
		Additional Tutorials
	</h2>

	<p style="margin-top:0;">
		The following will help you explore further and get the most out of Jaspersoft Studio.
	</p>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/jaspersoft-studio-expression-editor-what-it-and-how-it-works-part-1/" rel="">The Expression Editor: What it is and how it works</a>
	</h3>

	<div>
		Illustrates the new Expression Editor introduced in Jaspersoft Studio.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/jaspersoft-studio-expression-editor-how-extend-it-and-contribute-your-own-functions-part-2-0" rel="">The Expression Editor: How to extend it and contribute your own functions</a>
	</h3>

	<div>
		Explains how to extend the Expression Editor adding new functions.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/variables" rel="">Using Report Variables</a>
	</h3>

	<div>
		Simple tutorial about using report variables.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/using-report-parameters-jaspersoft-studio" rel="">Using Report Parameters</a>
	</h3>

	<div>
		Simple tutorial about using report parameters.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/groups" rel="">Using Report Groups</a>
	</h3>

	<div>
		Simple tutorial about using report groups.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/element-attributes" rel="">Element Attributes and Styles</a>
	</h3>

	<div>
		An overview of how attributes and styles get assigned to JasperReports elements.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/styles-template" rel="">The Styles Template</a>
	</h3>

	<div>
		Learn how to create a style template and how to use it inside a report
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/inheritance-tab" rel="">The Inheritance Tab</a>
	</h3>

	<div>
		Using the Inheritance Properties tab to better understand the (real) element attributes.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/creating-charts-and-subreports-jaspersoft-studio" rel="">Creating Charts and Subreports</a>
	</h3>

	<div>
		Simple tutorial on how to use a multi-series chart and subreport.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/creating-charts-and-datasets-jaspersoft-studio" rel="">Creating Charts and Datasets</a>
	</h3>

	<div>
		Simple tutorial on how to use the datasets and chart component.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/subreports-jaspersoft-studio" rel="">Using Subreports</a>
	</h3>

	<div>
		A detailed tutorial on how to use subreport elements in Jaspersoft Studio.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/xml-datasources-jaspersoft-studio" rel="">Using XML Datasources</a>
	</h3>

	<div>
		A tutorial on how to use XML datasources and Xpath query language.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/lists-jaspersoft-studio" rel="">Using the List component</a>
	</h3>

	<div>
		A tutorial on how to use the List component in Jaspersoft Studio.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/tables-and-crosstabs-jaspersoft-studio" rel="">Using Table and Crosstab components</a>
	</h3>

	<div>
		A tutorial on using Table and Crosstabs in Jaspersoft Studio.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/connect-jaspersoft-studio-jasperreports-server" rel="">Connect Jaspersoft Studio to JasperReports Server</a>
	</h3>

	<div>
		A tutorial on the connection between Jaspersoft Studio and JasperReports Server
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/how-create-and-use-jrdatasource-adapter" rel="">How to Create and Use a JRDataSource Adapter</a>
	</h3>

	<div>
		A tutorial on how to create a custom data adapter and use it into a report.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/how-create-and-use-jrdatasourceprovider-adapter" rel="">How to Create and Use a JRDataSourceProvider Adapter</a>
	</h3>

	<div>
		A tutorial on how to create a custom data source and use it into a report.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/creating-custom-template-jaspersoft-studio" rel="">Creating a Custom Report Template</a>
	</h3>

	<div>
		A tutorial on how to create a custom template for the report and use it inside Jaspersoft Studio
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/how-translate-jaspersoft-studio" rel="">How to Translate Jaspersoft Studio</a>
	</h3>

	<div>
		A tutorial on how to create a translation for the Jaspersoft Studio application
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/how-install-jaspersoft-studio-translation" rel="">How to Install a Jaspersoft Studio Translation</a>
	</h3>

	<div>
		A tutorial on how to install and use a previously created Jaspersoft Studio translation
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/how-publish-tibco-jaspersoft-studio-translation/" rel="">How to Publish a Jaspersoft Studio Translation</a>
	</h3>

	<div>
		A tutorial on how to publish on the community site a translation previously created
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/compile-older-jasperreports-version-jaspersoft-studio" rel="">Compile with Older JasperReports Version from Jaspersoft Studio</a>
	</h3>

	<div>
		A tutorial on how to use a previous version of JasperReports to compile a report
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/custom-font-font-extension" rel="">Custom Font with the Font Extension</a>
	</h3>

	<div>
		A tutorial on how to use the Font Extension for the report and the PDF Exporter
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/composite-element" rel="">The Composite Elements</a>
	</h3>

	<div>
		A tutorial on how to create, use and modify the Composite Elements
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/import-projects-and-settings-previous-version-tibco-jaspersoft-studio" rel="">Import Projects and Settings from a Previous Version of Jaspersoft Studio</a>
	</h3>

	<div>
		A tutorial on how to easily import Projects, Data Adapters, Server Connections and settings from a different workspace used by an existing Jaspersoft Studio installation.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/report-books-jaspersoft-studio" rel="">Report Books in Jaspersoft Studio</a>
	</h3>

	<div>
		A tutorial on how to get started in JasperReports Books with Jaspersoft Studio.
	</div>

	<h3>
		<a href="https://community.jaspersoft.com/knowledgebase/how-to/jaspersoft-studio-layouts/" rel="">Jaspersoft Studio Layouts</a>
	</h3>

	<div>
		A tutorial about the layouts included inside Jaspersoft Studio
	</div>

	<h3>
		See also:
	</h3>

	<ul>
		<li>
			<a href="https://community.jaspersoft.com/knowledgebase/getting-started/introduction-jaspersoft-studio/" rel="">Introduction to Jaspersoft Studio</a>
		</li>
		<li>
			<a href="https://community.jaspersoft.com/knowledgebase/getting-started/jaspersoft-studio-features/" rel="">Jaspersoft Studio Features</a>
		</li>
		<li>
			<a href="https://community.jaspersoft.com/knowledgebase/how-to/jaspersoft-studio-usage-reporting/" rel="">Jaspersoft Studio Usage Reporting</a>
		</li>
		<li>
			<a href="https://community.jaspersoft.com/knowledgebase/designing-report-jaspersoft-studio" rel="">Designing a Report with Jaspersoft Studio</a>
		</li>
		<li>
			<a href="https://community.jaspersoft.com/knowledgebase/exporting-reports-jaspersoft-studio" rel="">Exporting reports with Jaspersoft Studio</a>
		</li>
		<li>
			<a href="https://community.jaspersoft.com/knowledgebase/getting-started/jaspersoft-studio-tutorials-and-resources-for-getting-started/" rel="">Jaspersoft Studio Tutorials Archive</a>
		</li>
	</ul>
</div>

]]></description><guid isPermaLink="false">4624</guid><pubDate>Mon, 08 Jan 2024 21:38:39 +0000</pubDate></item><item><title>Make Sure To Set proxyName For Catalina Connector When Proxy Server Is Used In The DMZ To Access TIBCO JasperReports&#xAE; Server</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/make-sure-set-proxyname-catalina-connector-when-proxy-server-used-dmz-access-tibco/</link><description><![CDATA[<p>
	The TIBCO JasperReports® Server Security Guide, section 3.7 <strong><a href="https://community.jaspersoft.com/documentation/tibco-jasperreports-server-security-guide/v62/enabling-ssl-tomcat" rel="">"Enabling SSL in Tomcat"</a></strong>, discusses the procedures necessary to allow a user to use HTTPS protocol to access TIBCO JasperReports® Server  web application.
</p>

<p>
	If using a proxy server in the DMZ to communicate with JasperReports® Server running behind the firewall, user will also need to make sure to include proxy server name as part of the catalina connector setting in server.xml file in addition to the port and protocol settings:
</p>

<pre class="ipsCode prettyprint lang-xml prettyprinted">scheme="https" proxyName="my.report.proxy.server.com" proxyPort="443" secure="true"
</pre>

<p>
	Otherwise, use could get cross-site scripting error and was not able to access JasperReports® Server Manage web UI for administrators.<br />
	<br />
	NOTE: This is a specific use case and a generic solution that you can try to resolve the issue.
</p>

<hr />
<p>
	<em><strong>TTC-20160731</strong>-70119</em>
</p>
]]></description><guid isPermaLink="false">2358</guid><pubDate>Mon, 01 Aug 2016 03:57:06 +0000</pubDate></item><item><title>System requirements and installation of JasperReports Server</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/system-requirements-and-installation-of-jasperreports-server-r4963/</link><description><![CDATA[<div class="jrs-sys-reqs">
	<h2>
		Overview
	</h2>

	<p style="margin:0;">
		This page provides a comprehensive guide to system requirements and installation procedures for JasperReports® Server.
	</p>

	<div class="ipsAccordion ipsSpoiler" data-ipsaccordion="" data-ipsaccordion-color="">
		<div class="ipsSpoiler_header">
			<h2>
				Downloading installers
			</h2>
		</div>

		<div class="ipsSpoiler_contents ipsClearfix" data-gramm="false">
			<h3>
				Installation packages
			</h3>

			<p>
				JasperReports<span> </span>Server has two main installation packages:
			</p>

			<ul>
				<li>
					Binary installer
					<ul>
						<li>
							Support for Windows, Linux or Mac
						</li>
					</ul>
				</li>
				<li>
					WAR file distribution zip (install using ant scripts)
					<ul>
						<li>
							Works on any operating system that runs Java
						</li>
					</ul>
				</li>
			</ul>

			<p>
				Both the release packages can be downloaded from the JasperReports Server Downloads section (<a href="https://community.jaspersoft.com/download-jaspersoft/commercial-edition/" rel="">JasperReports Server Downloads</a>).
			</p>

			<p>
				For Commercial customers, the product and the license files are available for download from<span> </span><a href="https://edelivery.tibco.com/" rel="external nofollow">eDelivery</a>.
			</p>

			<h3>
				Download files
			</h3>

			<p>
				The following files are available in the Downloads section:
			</p>

			<ul>
				<li>
					<em>js-jrs_x.0.0_win_x86_64.exe</em>
				</li>
				<li>
					<em>js-jrs_x.0.0_linux_x86_64.run</em>
				</li>
				<li>
					<em>js-jrs_xxx_bin.zip </em> (War File Distribution)
				</li>
			</ul>

			<p>
				The <em>js-jrs_xxx_bin.zip</em> is known as the "War File Distribution" because it contains a <em>jasperserver.war</em> file in it. This is handy for users who already have an application server and a database in their environment. And, they would like to configure their application server and deploy the <em>jasperserver.war</em>. 
			</p>
		</div>
	</div>

	<div class="ipsAccordion ipsSpoiler" data-ipsaccordion="" data-ipsaccordion-color="">
		<div class="ipsSpoiler_header">
			<h2>
				Installing JasperReports® Server using the binary installer
			</h2>
		</div>

		<div class="ipsSpoiler_contents ipsClearfix" data-gramm="false">
			<p>
				The binary installer can be used to deploy a full instance of JasperReports Server on a laptop or desktop, for local evaluation. The installer is available for Windows, Linux, or Mac. This package includes the Tomcat application server and PostgreSQL database, along with optional sample data for tutorials.
			</p>

			<p>
				You can run the installer via the command line or a double-click. Choose the <b>Standard</b> installation to use default settings, or select <b>Custom</b> to specify a particular Tomcat or PostgreSQL instance.
			</p>

			<p>
				The installer provides a streamlined setup to get JasperReports Server operational quickly. Since the server requires both an application server and a database, the executable allows you to either deploy the bundled components or configure the system to use your existing infrastructure. 
			</p>

			<p>
				The installer distribution bundles the following components:
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Component</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Description</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports Server Application
							</p>
						</td>
						<td>
							<p>
								WAR file and configuration support scripts
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Apache Tomcat
							</p>
						</td>
						<td>
							<p>
								Web application container. You can use the bundled version or an existing version.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								PostgreSQL Database
							</p>
						</td>
						<td>
							<p>
								Database server. You can use the bundled version or an existing version.
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<h3>
				Installation
			</h3>

			<p>
				You can run the installer either in GUI mode or using the command line. 
			</p>

			<p>
				When you run the installer in GUI mode, the installer presents a dialog proving selections you can use to choose the installation environment and customize your installation.
			</p>

			<p>
				In Linux, the installer is the <em>.run</em> file. you can run it from the command line or from the GUI. To start the installer from the command line, open a bash shell, and enter the name of the installer file, for example, <em>.js-jrs_10.0.0_linux_x86_64.run. </em>
			</p>

			<p>
				Whether you run the installer from the command line or from the GUI, you are prompted with the same information. If you are installing from the command line, use your keyboard to specify your answers. For example, for the license agreement text, instead of clicking <em>I accept the agreement</em>, press <em>Y</em>, and press <em>Enter </em>on the keyboard.
			</p>

			<p>
				<strong>Tomcat configuration</strong>
			</p>

			<p>
				JasperReports Server requires a web application server to run. The JasperReports Server installer is pre-configured to run with the Apache Tomcat server. There are two options available for your Tomcat configuration.
			</p>

			<p>
				The first option is to install the <b>bundled Tomcat</b>. By selecting this, the installer will automatically set up an instance of <b>Tomcat x</b> on your machine. Click <b>Next</b> to proceed to the port configuration screen, where you will be asked to define the <b>server and shutdown ports</b>. While you can enter custom values if needed, most users simply keep the default settings. Once you have confirmed the ports, click <b>Next</b>.
			</p>

			<p>
				The second option allows you to use an <b>existing Tomcat</b> instance already installed on your system. After selecting this option and clicking <b>Next</b>, you will be asked to provide the server's location; you can type the path directly or use the <b>Browse</b> button to find it. Once the location is set, click <b>Next</b> to configure the <b>server and shutdown ports</b>. You may either keep the default port values or enter your own before clicking <b>Next</b> to continue.
			</p>

			<p>
				<strong>PostgreSQL configuration</strong>
			</p>

			<p>
				JasperReports Server requires a database to run. The JasperReports Server installer is pre-configured to run with the PostgreSQL database. There are two options available for you PostgreSQL configuration.
			</p>

			<p>
				The first option is to install <b>bundled PostgreSQL</b>. This installs <b>PostgreSQL x</b> directly onto your system using the default port <b>5432</b>. If the installer detects that this port is already occupied, it will ask you to select an alternative. Additionally, the installer automatically configures two accounts. It sets the PostgreSQL administrator password to <b>postgres</b> and creates a dedicated database user with the credentials <b>jasperdb/password</b>.
			</p>

			<p>
				The following table summarizes the parameters set during installation of the bundled PostgreSQL:
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Parameter</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Default value and description</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Binary Directory
							</p>
						</td>
						<td>
							<p>
								The directory where the postgres and pgAdmin binaries are located.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Port
							</p>
						</td>
						<td>
							<p>
								The port number that PostgreSQL uses (default is 5432). User must choose an alternate port if 5432 is in use.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								IP or Host Name
							</p>
						</td>
						<td>
							<p>
								The IP address or name of the machine where PostgreSQL is installed. The default value is 127.0.0.1.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								PostgreSQL Administrative Password
							</p>
						</td>
						<td>
							<p>
								Password of the database administrative user: postgres. The installer cannot handle special characters at the end of a password string. Incompatible characters include: &amp; ; $
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Database User Name
							</p>
						</td>
						<td>
							<p>
								The user name is hard coded. The default value is jasperdb. The installer creates this user which is used to connect to the JasperReports Server database
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Database User Password
							</p>
						</td>
						<td>
							<p>
								The password is hard coded. The default value is password. The installer uses this password for the jasperdb user.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Additional notes for Linux
							</p>
						</td>
						<td>
							<p>
								If your Linux installation does not have a locale setting that supports UTF-8 encoding, your Bundled PostgreSQL instance will be initialized using a temporary locale (--locale=C). This will allow the PostgreSQL initdb to succeed with the desired UTF-8 database encoding.
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<p>
				<strong>Note</strong>: For improved security, Jaspersoft recommends updating your database user password from the default setting to a new, secure value.
			</p>

			<p>
				The second option allows you to use an <b>existing PostgreSQL</b> instance already running on your system. If you select this, the installer will prompt you for the server's location and port. If your database is installed locally, you can accept the default host address, <b>127.0.0.1 (localhost)</b>. You will also need to specify the <b>PostgreSQL bin directory</b> by either accepting the default path or using the <b>Browse</b> button to select a different location. Finally, enter the password for the database administrator account (the default username is <b>postgres</b>) and click <b>Enter</b> to proceed.
			</p>

			<p>
				The following table summarizes the parameters set during the installation of an existing PostgreSQL:
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Defaults used</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Hardcoded default values used or created</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								PostgreSQL Administrative User Name
							</p>
						</td>
						<td>
							<p>
								postgres - The default administrative database user.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								jasperserver Database User Name
							</p>
						</td>
						<td>
							<p>
								jasperdb - The installer creates this database user which is used to connect to jasperserver database.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								jasperserver Database User Password
							</p>
						</td>
						<td>
							<p>
								password - The installer creates this password for the jasperdb database user.
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<p>
				<strong>Note</strong>: For improved security, Jaspersoft recommends updating your database user password from the default setting to a new, secure value.
			</p>

			<p>
				<strong>Enabling connections to a remote host</strong>
			</p>

			<p>
				On most platforms, the default PostgreSQL installation does not allow remote connections for security reasons. You need to enable remote connections as described in: 
			</p>

			<ul>
				<li>
					The PostgreSQL configuration documentation is on the PostgreSQL website.
				</li>
				<li>
					The <em>\docs</em> directory of your PostgreSQL installation.
				</li>
			</ul>

			<p>
				For steps on how to enable connections from the installation machine to the remote PostgreSQL server, see <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-binary-installer-_-select-postgresql/#installing_3160859210_1119368" rel="">Enabling Connections to a Remote Host</a> section in the  <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-introduction-_-introduction/" rel="">JasperReports Server Installation Guide</a>.
			</p>

			<p>
				<strong>Selecting a Chrome/Chromium configuration</strong>
			</p>

			<p>
				Chrome/Chromium handles JavaScript execution for background or scheduled graphical reports. Conversely, when viewed directly via the web UI, the user's browser performs the rendering. You have three ways to proceed:
			</p>

			<ul>
				<li>
					Use an existing Chrome/Chromium.
				</li>
				<li>
					Download Chrome/Chromium.
				</li>
				<li>
					Install without Chrome/Chromium.
				</li>
			</ul>

			<p>
				For details, see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-binary-installer-_-select-phantomjs/" rel="">Selecting a Chrome/Chromium Configuration</a> section in the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-introduction-_-introduction/" rel="">JasperReports Server Installation Guide</a>.
			</p>

			<p>
				<strong>Sample data</strong>
			</p>

			<p>
				During setup, you will be prompted to include sample databases and reports designed to help you explore the full capabilities of JasperReports Server. These resources include:
			</p>

			<ul>
				<li>
					Sugar CRM data that simulates three years of operations for a fictitious company that relies on the SugarCRM open source application.
				</li>
				<li>
					Foodmart data that simulates three years of operations for a fictitious company.
				</li>
				<li>
					JasperReports Server repository resources such as Reports, Analysis Views, Ad Hoc topics, Domains, Data Sources, and Input Controls.
				</li>
			</ul>

			<p>
				Our official tutorials rely on these specific datasets, we <b>strongly recommend</b> including them in your installation.
			</p>

			<p>
				For details, see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-binary-installer-_-installation/" rel="">Binary Installer installation</a> section in the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-introduction-_-introduction/" rel="">JasperReports Server Installation Guide</a>.
			</p>
		</div>
	</div>

	<div class="ipsAccordion ipsSpoiler" data-ipsaccordion="" data-ipsaccordion-color="">
		<div class="ipsSpoiler_header">
			<h2>
				Installing JasperReports® Server with the WAR file using js-install scripts
			</h2>
		</div>

		<div class="ipsSpoiler_contents ipsClearfix" data-gramm="false">
			<p>
				For production deployments, utilize the standalone WAR file distribution to install the JasperReports Server application. You can download this package directly from <a href="https://community.jaspersoft.com/download-jaspersoft/commercial-edition/" rel="">JasperReports Server Downloads</a> or by reaching out to your sales representative.
			</p>

			<p>
				The WAR file distribution provides the JasperReports Server web archive along with the necessary scripts for creating and initializing your database.
			</p>

			<h4>
				WAR File Distribution
			</h4>

			<p>
				The WAR file distribution comes in a file named <em>js-jrs_x.x.x_bin.zip</em> in compressed ZIP format. The WAR file distribution includes <em>js-install</em> shell scripts (for Linux and Windows) that automate much of the installation using a single properties file. These scripts are:
			</p>

			<ul>
				<li>
					<em>js-install.bat</em>
				</li>
				<li>
					<em>js-install.sh</em>
				</li>
			</ul>

			<p>
				The main contents of the WAR file binary distribution are shown in the following table:
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Content item</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Description</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports Server <em>js-install</em><br>
								Scripts
							</p>
						</td>
						<td>
							<p>
								Found at <em>&lt;js-install&gt;/buildomatic/js-install.bat</em> and<em> js-install.sh</em>.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports Server Database Scripts
							</p>
						</td>
						<td>
							<p>
								SQL scripts for each supported database.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports Server Documentation
							</p>
						</td>
						<td>
							<p>
								Guides for end users and administrators.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports Server Extra<br>
								Samples
							</p>
						</td>
						<td>
							<p>
								Web Service example applications, sample reports, custom data source examples, and other sample files.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports Server Standard Sample Data
							</p>
						</td>
						<td>
							<p>
								Sample data that highlights JasperReports Server features.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports Server WAR file archive
							</p>
						</td>
						<td>
							<p>
								All JasperReports Server class files and dependent jars.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								JasperReports IO for<br>
								JasperReports Web Studio 
							</p>
						</td>
						<td>
							<p>
								JasperReports IO application is required for JasperReports<br>
								Web Studio preview.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Repository for JasperReports<br>
								Web Studio 
							</p>
						</td>
						<td>
							<p>
								Repository connector application is required for <br>
								JasperReports Web Studio integration with JasperReports<br>
								Server.
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<p>
				The <em>js-install</em> shell scripts automate most of the process and are compatible with Windows, Linux, and macOS. Ensure you are using <em>bash</em> to execute these scripts correctly.
			</p>

			<p>
				To install the WAR file using <em>js-install</em> scripts: 
			</p>

			<p>
				1.  Extract all files from <em>js-jrs_10.0.0_bin.zip</em>. Choose a destination, such as:
			</p>

			<ul>
				<li>
					On Windows: <em>C:\Jaspersoft</em>
				</li>
				<li>
					On Linux: <em>/home/&lt;user&gt;</em>
				</li>
				<li>
					On Mac: <em>/Users/&lt;user&gt;</em>
				</li>
			</ul>

			<p>
				 The directory, on <em>Linux_bin</em>, appears in the file location you choose.
			</p>

			<p>
				2. Copy the <em>&lt;dbType&gt;_master.properties</em> file for your database from <em>sample_conf</em> and paste it to <em>buildomatic</em>:
			</p>

			<ul>
				<li>
					Copy from: <em>&lt;js-install&gt;/buildomatic/sample_conf/</em>
				</li>
				<li>
					Paste to: <em>&lt;js-install&gt;/buildomatic</em>
				</li>
			</ul>

			<p>
				  For example, if your database is PostgreSQL, copy <em>postgresql_master.properties</em> to <em>&lt;js-install&gt;/buildomatic</em>.
			</p>

			<p>
				3. Rename the file that you copied to <em>default_master.properties</em>.
			</p>

			<p>
				4. Edit the <em>default_master.properties</em> file to add the settings for your database and application server. The following table lists sample property values for each supported database.
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Database</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Sample property values</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								PostgreSQL
							</p>
						</td>
						<td>
							<p>
								<em>appServerType=tomcat [jboss-eap-8, wildfly,<br>
								skipAppServerCheck]<br>
								appServerDir=c:\\Program Files\\Apache Software<br>
								Foundation\\Tomcat 10.0<br>
								dbHost=localhost<br>
								dbUsername=postgres<br>
								dbPassword=postgres</em>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								MySQL
							</p>
						</td>
						<td>
							<p>
								<em>appServerType=tomcat [jboss-eap-8, wildfly,<br>
								skipAppServerCheck]<br>
								appServerDir=c:\\Program Files\\Apache Software<br>
								Foundation\\Tomcat 10.0<br>
								dbUsername=root<br>
								dbPassword=password<br>
								dbHost=localhost</em>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Standard Oracle options
							</p>
						</td>
						<td>
							<p>
								<em>appServerType=tomcat [jboss-eap-8, wildfly,<br>
								skipAppServerCheck]<br>
								appServerDir=c:\\Program Files\\Apache Software<br>
								Foundation\\Tomcat 10.0<br>
								dbUsername=jasperserver<br>
								dbPassword=password<br>
								sysUsername=system<br>
								sysPassword=password<br>
								dbHost=hostname</em>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Additional options for Oracle CDB with common users
							</p>
						</td>
						<td>
							<p>
								If you are using Oracle CDB and you want to use a common Jaspersoft user, then use the settings for Oracle with the following changes:
							</p>

							<p>
								<em>dbUsername=c##jasperserver</em>
							</p>

							<p>
								<em>sid=orclcdb</em>
							</p>

							<p>
								If you are using sample databases:
							</p>

							<p>
								<em>foodmart.dbUsername=c##foodmart</em>
							</p>

							<p>
								<em>sugarcrm.dbUsername=c##sugarcrm</em>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								DB2
							</p>
						</td>
						<td>
							<p>
								<em>appServerType=tomcat [jboss-eap-8, wildfly,<br>
								skipAppServerCheck]<br>
								appServerDir=c:\\Program Files\\Apache Software<br>
								Foundation\\Tomcat 10.0<br>
								dbUsername=db2inst1<br>
								dbPassword=password<br>
								dbHost=localhost</em>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								SQL Server
							</p>
						</td>
						<td>
							<p>
								<em>appServerType=tomcat [jboss-eap-8, wildfly,<br>
								skipAppServerCheck]<br>
								appServerDir=c:\\Program Files\\Apache Software<br>
								Foundation\\Tomcat 10.0<br>
								dbUsername=sa<br>
								dbPassword=sa</em>
							</p>

							<p>
								<em>dbHost=localhost</em>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								Additional options for all databases 
							</p>
						</td>
						<td>
							<p>
								(Optional) <em>jrws.deploy.webapps=true</em><br>
								(Optional)<em> jrws.repo.url=http://localhost:8080/repo</em><br>
								(Optional) <em>jrws.jrio.url=http://localhost:8080/jrio</em><br>
								By default, JasperReports Web Studio applications are installed into the same application server as  JasperReports Server, as configured in the <em>appServerDir</em> property.<br>
								If you do not want to deploy the JasperReports Web Studio applications, set <em>jrws.deploy.webapps=false</em>.
							</p>

							<p>
								In that case the integrated JasperReports Web Studio stops working. From JasperReports Server, you can still view the <strong>Open in Editor</strong> option. This option must be disabled from the context menu.<br>
								For steps on how to disable the Open in Editor option, refer to the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-administration-guide/v1000/jasperreports-server-admin-guide-_-overview-_-overview_intro/" rel="">JasperReports Server Administrator Guide</a>.
							</p>

							<p>
								If you have already deployed JasperReports Web Studio on another server you can skip deploying it with  JasperReports Server and just point to that remote applications by setting:<br>
								<em>jrws.deploy.webapps=false<br>
								jrws.repo.url=http://&lt;jasper-reports-webstudio-host&gt;:8080/repo<br>
								jrws.jrio.url=http://&lt;jasper-reports-webstudio-host&gt;:8080/jrio</em>
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<p>
				For the Split installation, configure the additional settings in the <em>default_master.properties</em> file.
			</p>

			<p>
				<strong>Note:</strong>
			</p>

			<ul>
				<li>
					When the property <em>appServerType</em> is set to <em>skipAppServerCheck</em>, buildomatic skips any application server validation.
				</li>
				<li>
					Backslashes in paths must be doubled in properties files, for example: <em>appServerDir=C:\\Apache Software Foundation\\Tomcat 10.0</em>.
				</li>
				<li>
					The <em>dbUsername</em> must be the same as the Oracle user name. In addition, buildomatic does with the “<em>sys as sysdba</em>” syntax.
				</li>
				<li>
					For Oracle without CDB with common users, do not use the <em>c##jasperserver dbUsername</em>. Use the standard <em>jasperserver dbUsername</em> instead.
				</li>
			</ul>

			<p>
				5. In case DB2, SQL Server or Oracle databases are used you must install the required JDBC driver. 
			</p>

			<p>
				6.  Run the<em> js-install</em> script:<br>
				     a. Start your database server.<br>
				     b. Stop your application server.<br>
				     c. Open Command Prompt as Administrator on Windows or open a terminal window on Linux and Mac OSX.<br>
				    d. Run the js-install script for the version and files that you want, as shown in the following table:
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Command</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Description</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>cd &lt;js-install&gt;/buildomatic</em>
							</p>
						</td>
						<td>
							<p>
								 
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-install.bat </em>(Windows)<br>
								<em>./js-install.sh</em> (Linux and Mac OSX)
							</p>
						</td>
						<td>
							<p>
								Installs JasperReports Server and JasperReports Web Studio, sample data, and sample databases<br>
								(foodmart and sugarcrm)
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-install.bat minimal</em> (Windows)<br>
								<em>./js-install.sh minimal</em> (Linux and Mac OSX)
							</p>
						</td>
						<td>
							<p>
								Installs JasperReports Server and JasperReports Web Studio, but not the sample data and sample databases
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<p>
				7. Set Java JVM Options (required).
			</p>

			<p>
				8. Set up the license (required).
			</p>

			<p>
				<strong>Note: </strong>
			</p>

			<ul>
				<li>
					To view the output log, look in: <em>&lt;js-install&gt;/buildomatic/logs/js-install-&lt;date&gt;.log</em>.
				</li>
				<li>
					Installing JasperReports Server automatically generates encryption keys that reside on the file system. These keys are stored in a dedicated Jaspersoft  keystore. Make sure that this keystore is properly secured and backed up, as described in the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-security-guide/v1000/jasperreports-server-security-guide-_-overview-_-security/" rel="">JasperReports Server Security Guide</a>.
				</li>
			</ul>

			<p>
				For the steps to install the WAR File  for specific environment combinations, and for further details see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-warfileinstall-_-war_install_using_js_install/#warfiledist_4279087660_1148723" rel="">Installing the WAR File Using js-install Scripts</a> section in the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-introduction-_-introduction/" rel="">JasperReports Server Installation Guide</a>.
			</p>
		</div>
	</div>

	<div class="ipsAccordion ipsSpoiler" data-ipsaccordion="" data-ipsaccordion-color="">
		<div class="ipsSpoiler_header">
			<h2>
				Installing JasperReports® Server with manual WAR file installation
			</h2>
		</div>

		<div class="ipsSpoiler_contents ipsClearfix" data-gramm="false">
			<p>
				If the <em>js-install</em> scripts are unavailable or cannot be used, you can perform a manual installation of the WAR file.
			</p>

			<p>
				The manual buildomatic steps described in this procedure execute the same Ant targets as the <em>js-install</em> script (<em>js-install.sh/.bat</em>). The procedure  shows which buildomatic targets to run manually if you are unable to use the js-install scripts.
			</p>

			<p>
				To install the WAR file distribution using manual buildomatic steps: 
			</p>

			<p>
				1. Start your database server.
			</p>

			<p>
				2. Stop your application server.
			</p>

			<p>
				3. Create and edit a <em>default_master.properties</em> file to add the settings in for your database and application server as described in <strong><em>Installing the WAR File Using jsinstall Scripts</em></strong> section.
			</p>

			<p>
				4. Open a Command Prompt as Administrator on Windows or open a terminal window on Linux or Mac. Run the following commands.
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Command</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Description</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>cd &lt;js-install&gt;/buildomatic</em>
							</p>
						</td>
						<td>
							<p>
								Makes the buildomatic directory your current directory.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant create-js-db</em>
							</p>
						</td>
						<td>
							<p>
								Creates the JasperReports Server repository database.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant create-sugarcrm-db<br>
								js-ant create-foodmart-db</em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Creates the sample databases.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant load-sugarcrm-db<br>
								js-ant load-foodmart-db</em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Loads sample data into the sample databases.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant update-foodmart-db</em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Initializes the sample databases
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant init-js-db-pro<br>
								js-ant import-minimal-pro</em>
							</p>
						</td>
						<td>
							<p>
								Initializes the jasperserver database, loads core application data. Running js-ant import-minimalpro<br>
								is mandatory. The server needs this data to function.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant import-sample-data-pro</em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Loads the demos that use the sample data.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant deploy-webapp-pro</em>
							</p>
						</td>
						<td>
							<p>
								Configures and deploys the WAR file to Tomcat or JBoss.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant deploy-jrws</em>
							</p>
						</td>
						<td>
							<p>
								Deploys only JasperReports Web Studio apps into the application server configured using the <em>appServerDir, jrws.repo.url</em> and <em>jrws.jrio.url</em> properties in the <em>default_master.properties</em> file.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant create-audit-db</em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Creates the audit database. Required only for the Split installation.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant init-audit-db-pro</em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Initializes the audit database. Required only for the Split installation.
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<p>
				<strong>Note</strong>: On non-Linux Unix platforms, the<em> js-ant</em> commands may not be compatible with all shells. If you have errors, use the bash shell explicitly. For more information, see <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-troubleshooting-_-bash_shell_for_other_linux/#troubleshooting_3046823171_1128294" rel="">Bash Shell for Solaris, IBM AIX, HP UX, and FreeBSD</a> section in the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-introduction-_-introduction/" rel="">JasperReports Server Installation Guide</a>.
			</p>

			<p>
				If you encounter an error when running <em>create-sugarcrm-db, create-foodmart-db</em>, or <em>create-js-db</em>, you can create the JasperReports Server database manually using the database administration tool for your particular database type. To create the JasperReports Server database manually for PostgreSQL, MySQL, Oracle, SQL Server, or DB2, refer to <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-manual-db-_-manually_creating_the_jasperreports_/#additional_646152231_1159733" rel="">Manually Creating the JasperReports Server Database</a>. 
			</p>

			<p>
				If you have previously installed the databases, you can drop the old versions and then recreate the databases. To do this, run the following drop commands before running the commands in the following table<span ipsnoautolink="true">:</span>
			</p>

			<table class="command-param">
				<tbody>
					<tr>
						<td style="width:220px;">
							<p>
								<strong>Command</strong>
							</p>
						</td>
						<td>
							<p>
								<strong>Description</strong>
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant drop-sugarcrm-db </em><br>
								<em>js-ant drop-foodmart-db </em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Deletes the sample databases.
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant drop-js-db</em>
							</p>
						</td>
						<td>
							<p>
								(WARNING) Deletes the JasperReports Server repository database. Only run this command if you intend to recreate the jasperserver database
							</p>
						</td>
					</tr>
					<tr>
						<td>
							<p>
								<em>js-ant drop-audit-db</em>
							</p>
						</td>
						<td>
							<p>
								(Optional) Deletes the audit database.<br>
								Required only for the Split installation, or if the previous installation was Split, or for the database clean up after a Split installation.
							</p>
						</td>
					</tr>
				</tbody>
			</table>

			<p>
				5. Set Java JVM Options (required).
			</p>

			<p>
				6. Set up the license (required).
			</p>

			<p>
				For further details, see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-warfileinstall-_-war_install_manually/#start" rel="">Installing the WAR File Manually</a> section in the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-introduction-_-introduction/" rel="">JasperReports Server Installation Guide</a>.
			</p>

			<p>
				<strong>Note: </strong>Installing JasperReports Server automatically generates encryption keys that reside on the file system. These keys are stored in a dedicated Jaspersoft keystore. Make sure that this keystore is properly secured and backed up, as described in the JasperReports Server Security Guide.
			</p>
		</div>
	</div>
</div>
<p> </p>]]></description><guid isPermaLink="false">4963</guid><pubDate>Tue, 13 Jan 2026 06:07:12 +0000</pubDate></item><item><title>How to manually copy/move a list of Servers and Data Adapters from one TIBCO Jaspersoft&#xAE; Studio to another</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/how-manually-copymove-list-servers-and-data-adapters-one-tibco-jaspersoft-studio-another/</link><description><![CDATA[<h2>
	Use case
</h2>

<p>
	When moving TIBCO Jaspersoft<sup>®</sup> Studio from one machine to another, or when simply attempting to replicate a setup on a different machine, it might be helpful to have a quick way to copy/move your existing configuration of TIBCO JasperReports<sup>®</sup> Server connections and/or the Data Adapters
</p>

<hr />
<h2>
	Solution
</h2>

<p>
	The TIBCO JasperReports Server<span style="background-color:rgb(255,255,255);font-family:Arial, Helvetica, sans-serif;"> connection definitions are stored in the workspace, particularily in </span>
</p>

<pre class="ipsCode prettyprint lang-auto prettyprinted">\.metadata\.plugins\com.jaspersoft.studio\serverprofiles
</pre>

<p>
	<span style="background-color:rgb(255,255,255);font-family:Arial, Helvetica, sans-serif;">Just copy the contents of this folder to the new instanace of TIBCO Jaspersoft Studio and restart it.</span>
</p>

<p>
	<font face="Arial, Helvetica, sans-serif"><span style="background-color:rgb(255,255,255);">Similarly, t</span></font><span style="background-color:rgb(255,255,255);font-family:Arial, Helvetica, sans-serif;">he data adapter definitions are stored in <span style="color:#696969;"><strong><em>.metadata.pluginscom.jaspersoft.studiodataAdapters</em></strong></span> folder and can be migrated too</span>
</p>
]]></description><guid isPermaLink="false">2472</guid><pubDate>Tue, 01 Nov 2016 01:45:43 +0000</pubDate></item><item><title>Getting Started with JasperReports Server</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/getting-started-jasperreports-server/</link><description><![CDATA[<h2>
	Overview
</h2>

<p>
	JasperReports Server extends the core functionality of the <a href="https://community.jaspersoft.com/knowledgebase/getting-started/getting-started-jasperreports-library/" rel="">JasperReports Library</a> into a full-scale reporting platform. It adds essential management tools like security protocols, resource repositories, and report scheduling. Furthermore, its comprehensive public interfaces make it highly customizable and easy to integrate into your <a href="https://community.jaspersoft.com/knowledgebase/getting-started/getting-started-rest-web-service-api/" rel="">existing software ecosystem</a>.
</p>

<p>
	For details, see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-introduction-_-intro_getting_started/#introduction_2172476893_1063116" rel="">JasperReports Server User Guide &gt; Getting Started Page</a>
</p>

<p>
	At the center of the Jaspersoft BI Suite is <b>JasperReports Server</b>, which enables you to:
</p>

<ul>
	<li>
		Easily create new reports using an intuitive web-based drag and drop Ad Hoc reporting interface. (Enterprise Edition capability)
	</li>
	<li>
		Efficiently and securely manage many reports.
	</li>
	<li>
		Interact with reports, including entering parameters and drilling on data.
	</li>
	<li>
		Arrange reports and web content to create appealing, data-rich dashboards that quickly convey business trends. (Enterprise Edition capability)
	</li>
	<li>
		Host separate organizations securely and transparently through multi-tenancy. (Enterprise Edition capability)
	</li>
</ul>

<p>
	For details, see <a href="https://community.jaspersoft.com/knowledgebase/faq/what-jasperreports-server/" rel="">What is JasperReports Server?</a>
</p>

<h2>
	Requirements
</h2>

<p>
	See the <a href="https://www.jaspersoft.com/support/supported-platforms" rel="external nofollow">Supported Platform Datasheet</a> for the up-to-date list of supported software, including databases, JVMs, and web browsers.
</p>

<p>
	Additionally, to ensure the application functions correctly, we recommend adjusting your browser security settings to permit the following:
</p>

<ul>
	<li>
		Cookies
	</li>
	<li>
		Pop-ups (new windows/tabs)
	</li>
	<li>
		Javascript
	</li>
	<li>
		AJAX
	</li>
	<li>
		DHTML
	</li>
</ul>

<ul>
</ul>

<h2>
	Configuration
</h2>

<p>
	Here is a <a href="https://community.jaspersoft.com/knowledgebase/faq/jaspersoft-product-configuration-reference/" rel="">Jaspersoft Product Configuration Reference</a>. Also, for additional information, see the <em><a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-ultimate-guide/v1000/js-ultimate-guide-_-introduction-_-introduction/" rel="">JasperReports Server Ultimate Guide</a></em>.
</p>

<h2>
	Using JasperReports Server
</h2>

<h3>
	Connecting to your data
</h3>

<h4>
	Creating a datasource
</h4>

<ul>
	<li>
		<a href="https://community.jaspersoft.com/knowledgebase/how-to/connecting-jasperreports-server-your-database/" rel="">Connecting JasperReport Server to your Database</a> for reporting (creating a datasource).
	</li>
	<li>
		<a href="https://community.jaspersoft.com/search/?q=%22data%20sources%22&amp;quick=1&amp;updated_after=any&amp;sortby=relevancy" rel="">Comprehensive List of Articles on Data Sources</a>
	</li>
</ul>

<h4>
	Creating a domain
</h4>

<ul>
	<li>
		<a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-data-management-using-domains/v1000/jrs-domain-_-understanding_domains-_-introduction/" rel="">Data Management Using Domains</a>
	</li>
	<li>
		<a href="https://community.jaspersoft.com/search/?&amp;q=domains&amp;type=cms_records6&amp;quick=1&amp;nodes=29,32,25,28&amp;search_and_or=or&amp;search_in=titles&amp;sortby=relevancy" rel="">Comprehensive List of Articles on Domains</a> 
	</li>
</ul>

<h4>
	Domain security
</h4>

<ul>
	<li>
		<a href="https://community.jaspersoft.com/knowledgebase/how-to/defining-domain-security-file/" rel="">Defining a Domain Security File</a>
	</li>
</ul>

<h3>
	Creating your first Ad Hoc View
</h3>

<p>
	For information about Ad Hoc Editor, see the  <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-adhoc-_-adhoc-intro/#ad_hoc_reports_2012736005_1242127" rel="">Working with the Adhoc Editor</a> section in the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-introduction-_-intro_login/" rel="">JasperReports Server User Guide</a>.
</p>

<h3>
	Working with dashboards
</h3>

<p>
	For information about dashboards, see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-dashboards-_-dashboards-intro/" rel="">Working with Dashboards</a> section in the  <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-introduction-_-intro_login/" rel="">JasperReports Server User Guide</a>.
</p>

<h3>
	Reports and report viewer
</h3>

<p>
	For information about reports and report viewer, see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-reports-_-reports-intro/#running_reports_2536605942_999704" rel="">Running Reports and the Report Viewer</a> section in the  <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-user-guide/v1000/jasperreports-server-user-guide-_-introduction-_-intro_login/" rel="">JasperReports Server User Guide</a>.
</p>

<h2>
	How can I get help?
</h2>

<p>
	If you require assistance, you can find a complete list of Jaspersoft's formal support services <a href="http://www.jaspersoft.com/support" rel="external nofollow">here</a>.
</p>

<p>
	<strong>See also:</strong>
</p>

<p>
	For additional information, see the following resources:
</p>

<ul>
	<li>
		<a href="http://www.jaspersoft.com/products/jaspersoft-commercial.html" rel="external nofollow">JasperReports Server product page on the Jaspersoft website</a>
	</li>
	<li>
		<a href="https://community.jaspersoft.com/download-jaspersoft/commercial-edition/" rel="">JasperReports Server overview page on the Jaspersoft community site</a>
	</li>
	<li>
		<a href="https://community.jaspersoft.com/knowledgebase/getting-started/getting-started-rest-web-service-api/" rel="">Getting Started with REST Web Service API</a>
	</li>
	<li>
		<a href="https://community.jaspersoft.com/knowledgebase/getting-started/?d=6&amp;advanced_search_submitted=1&amp;csrfKey=47288cf3f638b6e25506f1509e0d3985&amp;record_type=all&amp;time_frame=show_all&amp;cms_record_i_started=&amp;content_field_56%5B1%5D=212&amp;sortby=record_publish_date&amp;sortdirection=desc" rel="">Other JasperReports Server Getting Started Articles</a>
	</li>
</ul>
]]></description><guid isPermaLink="false">12</guid><pubDate>Fri, 20 Jul 2012 22:37:39 +0000</pubDate></item><item><title><![CDATA[Q & A - Jaspersoft Studio v6.2.1 Software Installation on Linux x86_64]]></title><link>https://community.jaspersoft.com/knowledgebase/getting-started/q-jaspersoft-studio-v621-software-installation-linux-x8664/</link><description><![CDATA[<h2>
	[toc on_off::hide=1]Question:
</h2>

<p>
	Could you please provide us the detailed Installation steps of Jaspersoft Studio v6.2.1 Software on Linux x86_64?
</p>

<hr />
<h2>
	Answer:  
</h2>

<ol>
	<li>
		<p>
			Open the archive "TIBCOJaspersoftStudioPro-6.2.1.final-linux-x86_64.tgz" file to get "TIBCOJaspersoftStudioPro-6.2.1.final-linux-x86_64.tar" file out.
		</p>
	</li>
	<li>
		<p>
			Untar this file and extract all its content into a folder on Linux machine, for example
		</p>

		<pre class="ipsCode prettyprint lang-javascript prettyprinted">/opt/tibco
</pre>
	</li>
	<li>
		<p>
			After extracting all the Studio components, check and make sure you have execution permission to deployment folder
		</p>
	</li>
	<li>
		<p>
			You can start the Studio from the installed location, for example:
		</p>

		<pre class="ipsCode prettyprint lang-javascript prettyprinted">$ /opt/tibco/TIBCOJaspersoftStudioPro-6.2.1.final/Jaspersoft Studio Professional
</pre>
	</li>
</ol>

<div>
	<hr />
	<p>
		<em><strong>TTC-20160622-69616</strong></em>
	</p>
</div>

<p>
	<strong>Note: This wiki article is for old JSS 6.2.1 version installation.</strong>
</p>
]]></description><guid isPermaLink="false">2332</guid><pubDate>Fri, 01 Jul 2016 04:01:29 +0000</pubDate></item><item><title>Failed to execute: ALTER TABLE JIAccessEvent DROP FOREIGN KEY error message during upgrade to 8.0.0</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/failed-execute-alter-table-jiaccessevent-drop-foreign-key-error-message-during-upgrade-800/</link><description><![CDATA[<p>
	<strong>Situation:</strong>
</p>

<p>
	You're performing an upgrade from version 7.1.0 to 8.0.0 using upgrade-samedb Same Database upgrade script and your historic upgrade path has been the following:
</p>

<p>
	7.1.0 -&gt; 7.2.0 -&gt; 7.5.0 -&gt; 7.8.0 -&gt; 7.9.0 -&gt; 8.0.0
</p>

<p>
	On the last step you're getting a similar error:
</p>

<p>
	[advanced-sql] Executing resource: /opt/jasperreportsserver/buildomatic/install_resources/sql/mysql/upgrade-mysql-7.9.0-8.0.0-pro.sql<br />
	[advanced-sql] Failed to execute:   ALTER TABLE JIAccessEvent DROP FOREIGN KEY FK7caj87u72rymu6805gtek03y8<br />
	[advanced-sql] java.sql.SQLSyntaxErrorException: (conn=17) Can't DROP 'FK7caj87u72rymu6805gtek03y8'; check that column/key exists<br />
	[advanced-sql] Failed to execute:   ALTER TABLE JIAccessEvent DROP FOREIGN KEY FK8lqavxfshc29dnw97io0t6wbf<br />
	[advanced-sql] java.sql.SQLSyntaxErrorException: (conn=17) Can't DROP 'FK8lqavxfshc29dnw97io0t6wbf'; check that column/key exists
</p>

<p>
	What to do in this situation?
</p>

<p>
	<strong>Solution:</strong>
</p>

<p>
	There is a hotfix available for this issue. Please download either the latest 8.0.2 hotfix and apply it to buildomatic by following the readme.txt instructions under js-install.zip or download the 8.0.2 WAR artifact which has this fixed baseline.<br />
	<br />
	<br />
	Note : This is a specific use case and generic solution that you can try to resolve the issue.
</p>
]]></description><guid isPermaLink="false">4422</guid><pubDate>Mon, 07 Nov 2022 20:47:21 +0000</pubDate></item><item><title>Simba Drivers Decoupled from JasperReports Server WAR File</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/simba-drivers-decoupled-jasperreports-server-war-file/</link><description><![CDATA[<p>
	The following Simba JDBC drivers will be getting removed from the JasperReports Server WAR file:
</p>

<ul>
	<li>
		Athena
	</li>
	<li>
		Cassandra
	</li>
	<li>
		Impala
	</li>
	<li>
		Neo4j
	</li>
	<li>
		Spark
	</li>
</ul>

<p>
	<strong>Important Note</strong>: No default DataSource properties or configurations are changed, Jaspersoft is removing the JAR files from the WAR file.
</p>

<h2>
	How to Get the Simba Drivers
</h2>

<p>
	Refer to the following URLs to get these Simba Drivers:
</p>

<table>
	<thead>
		<tr>
			<th scope="col">
				<p>
					<strong>JDBC Driver</strong>
				</p>
			</th>
			<th scope="col">
				<p>
					<strong>Replacement</strong>
				</p>
			</th>
			<th scope="col">
				<p>
					<strong>Link</strong>
				</p>
			</th>
		</tr>
	</thead>
	<tbody>
		<tr>
			<td>
				Athena
			</td>
			<td>
				AthenaJDBC42-2.0.35.1000.jar
			</td>
			<td>
				<a href="https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar" rel="external nofollow">https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar</a>
			</td>
		</tr>
		<tr>
			<td>
				Cassandra
			</td>
			<td>
				CassandraJDBC42.jar
			</td>
			<td>
				<a href="https://downloads.datastax.com/jdbc/cql/2.0.3.1003/SimbaCassandraJDBC42-2.0.3.1003.zip" rel="external nofollow">https://downloads.datastax.com/jdbc/cql/2.0.3.1003/SimbaCassandraJDBC42-2.0.3.1003.zip</a>
			</td>
		</tr>
		<tr>
			<td>
				Impala
			</td>
			<td>
				Cloudera
			</td>
			<td>
				 
			</td>
		</tr>
		<tr>
			<td>
				Neo4j for JAVA 8
			</td>
			<td>
				neo4j-jdbc-4.0.9.jar
			</td>
			<td>
				<a href="https://github.com/neo4j-contrib/neo4j-jdbc/releases/download/4.0.9/neo4j-jdbc-driver-4.0.9.jar" rel="external nofollow">https://github.com/neo4j-contrib/neo4j-jdbc/releases/download/4.0.9/neo4j-jdbc-driver-4.0.9.jar</a>
			</td>
		</tr>
		<tr>
			<td>
				Neo4j for Java 17
			</td>
			<td>
				neo4j-jdbc-bolt-5.0.0.jar
			</td>
			<td>
				<a href="https://github.com/neo4j-contrib/neo4j-jdbc/releases/download/5.0.0/neo4j-jdbc-bolt-5.0.0.jar" rel="external nofollow">https://github.com/neo4j-contrib/neo4j-jdbc/releases/download/5.0.0/neo4j-jdbc-bolt-5.0.0.jar</a>
			</td>
		</tr>
		<tr>
			<td>
				Spark
			</td>
			<td>
				SparkJDBC41.jar
			</td>
			<td>
				<a href="https://downloads.datastax.com/jdbc/2.6.5.1005/SimbaSparkJDBC41-2.6.5.1005.zip" rel="external nofollow">https://downloads.datastax.com/jdbc/2.6.5.1005/SimbaSparkJDBC41-2.6.5.1005.zip</a>
			</td>
		</tr>
	</tbody>
</table>

<p>
	 
</p>

<h2>
	How to Install a Driver
</h2>

<p>
	To Install a Driver:
</p>

<p>
	1) Create a custom components folder at the buildomatic level.<br />
	    In components folder, add the following folders: <br />
	    a) A META-INF folder which contains components.properties file. In the property file, create these two properties:<br />
	        connectors.XXX.enabled = true|false<br />
	        connectors.XXX.artifacts = XXX.jar<br />
	    b) Create a folder named XXX-connector in which to place the JAR file.<br />
	    <br />
	    This folder structure can be achieved by executing target:<br />
	<em>        &lt;jrs bin&gt;buildomatic&gt; js-ant gen-components-metainf -DcomponentId=XXX(connector name) -DcomponentArtifacts=YYY(Driver along with version).jar </em><br />
	        <br />
	2) After creating the folder structure, execute target js-ant install-components.
</p>

<p>
	For example: <em>&lt;jrs bin&gt;buildomatic&gt; js-ant install-components</em>
</p>

<p>
	This will repackage the jasperserver-pro.WAR and deploy the JAR in the Tomcat WEB-INF/lib folder.
</p>

<p>
	3) To update the JAR version, change the JAR version in <strong>components-&gt;META-INF-&gt;components.properties</strong> file at connectors.XXX.artifacts=YYY.jar
</p>

<p>
	then place the specified version JAR in the <strong>components&gt;XXX-connector</strong> folder and run script js-ant install-components. <br />
	For example: <em>&lt;jrs bin&gt;buildomatic&gt; js-ant install-components</em>
</p>

<p>
	4) To remove a JAR, create or update <strong>components&gt;META-INF&gt;components.properties</strong> file as connectors.XXX.enabled = false OR you can add connectors.XXX.enabled = false in default_master.properties file and run js-ant install-components. 
</p>

<p>
	For example: <em>&lt;jrs bin&gt;buildomatic&gt; js-ant install-components</em><br />
	<br />
	<strong>Note:</strong> Some of the driver download URLs may not be working. Please try downloading the driver from an alternative source or location.
</p>

<h2>
	How to Enable or Disable a Driver
</h2>

<p>
	To disable a driver, keep the entry connectors.XXX(connector).enabled = false in <strong>components&gt;META-INF&gt;components.properties</strong> file<br />
	To enable a driver, keep the entry connectors.XXX(connector).enabled = true in <strong>components&gt;META-INF&gt;components.properties</strong> file
</p>

<p>
	After repackaging and Tomcat deployment is done, restart Tomcat.<br />
	    <br />
	To only repackage jasperserver-pro.WAR, run script:  <em>&lt;jrs bin&gt;buildomatic&gt; js-ant package-components</em><br />
	To only deploy in Tomcat webapp/WEB-INF/lib, run script:  <em>&lt;jrs bin&gt;buildomatic&gt; js-ant deploy-components</em><br />
	To repackage jasperserver-pro.WAR and deploy in Tomcat webapp/WEB-INF/lib, run script: <em>&lt;jrs bin&gt;buildomatic&gt; js-ant install-components</em>
</p>

<h2>
	How to Download a Driver using the URL
</h2>

<p>
	Enable a driver using URL by following these steps:<br />
	If there is any custom component, include in lib WEB-INFlib without having JAR in the system, there is an option to keep the corresponding URL through which you can download the JAR property:<br />
	<em>connectors.${project.artifactId}.url={URL from where we can download URL}</em>
</p>

<p>
	For example, for simba-athena, this folder structure can be achieved by using ant command:<br />
	    <em>&lt;jrs&gt;/jasperserverbuildomatic&gt; js-ant gen-components-metainf -DcomponentId=simba-athena -DcomponentArtifacts=AthenaJDBC42-2.0.35.1000.jar -DcomponentUrl=<a href="https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar" rel="external nofollow">https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar</a></em>
</p>

<p>
	<strong>Case 1:</strong><br />
	    connectors.simba-athena.enabled=true<br />
	    connectors.simba-athena.artifacts=AthenaJDBC42-2.0.35.1000.jar<br />
	    connectors.simba-athena.url=<a href="https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar" rel="external nofollow">https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar</a><br />
	    <br />
	    Driver will get downloaded into /tmp/componentsXXX/components/simba-athena-connector 
</p>

<p>
	<strong>Case 2:</strong><br />
	    connectors.simba-athena.enabled=<br />
	    connectors.simba-athena.artifacts=AthenaJDBC42-2.0.35.1000.jar<br />
	    connectors.simba-athena.url=<a href="https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar" rel="external nofollow">https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar</a><br />
	    The simba-athena.enabled property will be considered to true because we are providing the URL property and the driver will get downloaded.
</p>

<p>
	<strong>Case 3:</strong><br />
	    connectors.simba-athena.enabled=true<br />
	    connectors.simba-athena.artifacts=AthenaJDBC42-2.jar<br />
	    connectors.simba-athena.url=<a href="https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar" rel="external nofollow">https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar</a><br />
	    <br />
	    If the driver name format differs from the download path, you can mention the required format in connectors.simba-athena.artifacts so that the driver will get renamed to required format .
</p>

<p>
	<strong>Case 4:</strong><br />
	    connectors.simba-athena.enabled=<br />
	    connectors.simba-athena.artifacts=<br />
	    connectors.simba-athena.url=<a href="https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar" rel="external nofollow">https://s3.amazonaws.com/athena-downloads/drivers/JDBC/SimbaAthenaJDBC-2.0.35.1000/AthenaJDBC42-2.0.35.1000.jar</a><br />
	    <br />
	    In this case, it will treat enabled flag to true and artifacts will be assigned with AthenaJDBC42-2.0.35.1000.jar from URL <br />
	<br />
	 
</p>

<p>
	 
</p>
]]></description><guid isPermaLink="false">4550</guid><pubDate>Fri, 07 Jul 2023 20:42:39 +0000</pubDate></item><item><title>How to use Elasticsearch?</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/how-to-use-elasticsearch-r4722/</link><description><![CDATA[<p>
	This document provides the steps to use Elasticsearch with JasperReports Server 9.0.0.<br>
	To use Elasticsearch with JasperReports Server 9.0.0:<br>
	   1. Download the Elasticsearch driver from the following link: <a href="https://mvnrepository.com/artifact/org.elasticsearch.plugin/x-pack-sql-jdbc" rel="external nofollow">https://mvnrepository.com/artifact/org.elasticsearch.plugin/x-pack-sql-jdbc</a>  
</p>

<p>
	   <strong>Note</strong>: The location for accessing the driver is provided for convenience only, and this does not constitute an endorsement or representation that this drivers is fit for any  particular purpose. You are solely responsible for the deployment and use of the driver in connection with the JasperReports Server product.
</p>

<p>
	   2. On the <strong>New Data Source</strong> page, from the <strong>Type </strong>drop-down, select <strong>JDBC</strong>.<br>
	   3. From the <strong>JDBC Driver</strong> drop-down, select <strong>Other</strong>.
</p>

<p>
	      <b><span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;"><img alt="AD_4nXer0tAOJgAzoCcKpmTn0UxYyjHpsj5npjMo51jk68-89HlS62hkag7snBhBEcs8r_tJhy3xNSPqEsSG-Oi3utCaaXsK_nC5NnECEhL2PIOctv6sla1ZAAaUWmp27HAbPDWHQBgjGvO9L_qJinDeABfkXWMN?key=OEJatADSOO7FTaQV65uO1w" data-ratio="66.60" height="260" style="height:auto;" width="624" src="https://lh7-us.googleusercontent.com/docsz/AD_4nXer0tAOJgAzoCcKpmTn0UxYyjHpsj5npjMo51jk68-89HlS62hkag7snBhBEcs8r_tJhy3xNSPqEsSG-Oi3utCaaXsK_nC5NnECEhL2PIOctv6sla1ZAAaUWmp27HAbPDWHQBgjGvO9L_qJinDeABfkXWMN?key=OEJatADSOO7FTaQV65uO1w" loading="lazy"></span></span></b>
</p>

<p>
	<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">    4. In the <strong>JDBC Driver</strong> field enter, <em>org.elasticsearch.xpack.sql.jdbc.EsDriver</em>.<br>
	    5. Click <strong>Add Driver</strong>.<br>
	    6. In the <strong>Select Driver</strong> dialog, click <strong>Choose File</strong> to browse to the required file.</span></span>
</p>

<p>
	<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">        </span></span><b><span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;"><img alt="AD_4nXewIHWlshK_DgwMnqJXp0CX1Qvqx52-SoRcszSCjWh0a8VcMUpxmkEUBfqxccaoi47l7fD8JNe5To8l5PQN-NkCG6QwSOQeA7bGJZ2uxD72fuWcSE3Y2VY9h6tfsI54jYZSuQHHkDNrKdqInVt0sjQ4ZDp-?key=OEJatADSOO7FTaQV65uO1w" data-ratio="68.90" height="269" style="height:auto;" width="624" src="https://lh7-us.googleusercontent.com/docsz/AD_4nXewIHWlshK_DgwMnqJXp0CX1Qvqx52-SoRcszSCjWh0a8VcMUpxmkEUBfqxccaoi47l7fD8JNe5To8l5PQN-NkCG6QwSOQeA7bGJZ2uxD72fuWcSE3Y2VY9h6tfsI54jYZSuQHHkDNrKdqInVt0sjQ4ZDp-?key=OEJatADSOO7FTaQV65uO1w" loading="lazy"></span></span></b>
</p>

<p>
	<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">  7. Click <strong>Upload</strong>.<br>
	  8. In the <strong>URL</strong>, enter <em>jdbc:es://dbhost:9200/?ssl=true&amp;ssl.keystore.location=/opt/home/jasperserver/truststore_jdbc.jks&amp;ssl.keystore.pass=elasticsearch&amp;ssl.truststore.location=/opt/home/jasperserver/truststore_jdbc.jks&amp;ssl.truststore.pass=elasticsearch</em>.<br>
	  9. Provide relevant information in the <strong>User Name, Password</strong> and <strong>Time Zone</strong> fields.<br>
	       Note:<br>
	      <strong>JDBC Driver</strong> and <strong>URL</strong> are mandatory fields.<br>
	  10. Click <strong>Test Connection</strong> to check if all inputs are correct.<br>
	  11. Click <strong>Save </strong>to save the data source.</span></span>
</p>

<h2>
	<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">Connect to Elasticsearch with security enabled JDBC URL</span></span>
</h2>

<p>
	<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">To connect to ElasticSearch with security enabled JDBC URL, <strong>ssl </strong>must be set to <strong>true </strong>(<strong>ssl=true</strong>) and the related certificates, and the key must be provided. For details, see <a href="https://www.elastic.co/guide/en/elasticsearch/reference/current/sql-jdbc.html" rel="external nofollow">SQL JDBC</a>.  </span></span>
</p>

<p>
	<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">To get and repackage the files, search for <strong>xpack.security.http.ssl:</strong> section in the <strong>elasticsearch.yml</strong>.</span></span>
</p>

<p>
	<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">To get the <strong>truststore_jdbc.jks</strong> file on Linux:</span></span>
</p>

<ol>
	<li>
		On terminal, run the <em>`openssl pkcs12 -export -out bundle_jdbc.p12 -in elastic.crt -inkey elastic.key`</em> command.
	</li>
	<li>
		<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">Select a secure password, when prompted.</span></span>
	</li>
	<li>
		<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">On terminal, run the <em>`keytool -keystore truststore_jdbc.jks -import -file CA.crt -alias cacert`</em> command.</span></span>
	</li>
	<li>
		<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">Select a secure password, when prompted.</span></span>
	</li>
	<li>
		<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">Type <em>'yes'</em>.</span></span>
	</li>
	<li>
		<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">On terminal, run the <em>`keytool -destkeystore truststore_jdbc.jks -importkeystore -srckeystore bundle_jdbc.p12 -srcstoretype PKCS12`</em> command.</span></span>
	</li>
	<li>
		<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">Enter the password to get the <strong>truststore_jdbc.jks</strong> file. </span></span>
	</li>
	<li>
		<span style="background-color:transparent;color:#000000;font-size:11pt;vertical-align:baseline;"><span style="border:none;">Copy the <strong>truststore_jdbc.jks</strong> file to <strong>/opt/home/jasperserver</strong> on JasperReports Server</span></span>
	</li>
</ol>
]]></description><guid isPermaLink="false">4722</guid><pubDate>Mon, 08 Jul 2024 05:45:07 +0000</pubDate></item><item><title>Gain Access</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/gain-access/</link><description><![CDATA[<table style="margin-left:16px;">
	<tbody>
		<tr>
			<td style="width: 55px;">
				<img alt="020117_account_and_access.png.ac39ced6ee55c5581249ca8a05d44511.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90873" style="width: 34px; height: auto;" src="//media.invisioncic.com/i328763/monthly_2019_10/020117_account_and_access.png.ac39ced6ee55c5581249ca8a05d44511.png" loading="lazy">
			</td>
			<td>
				<p style="font-size:1rem; font-weight:bold; margin:0;">
					<a href="#fulfillment" rel="">Fullfillment &amp; Access</a>
				</p>
			</td>
		</tr>
		<tr>
			<td style="width: 55px;">
				<img alt="product_update_.png.a57bb2bb82f82d30be45008ef2b39a89.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90874" style="width:34px; height: auto;" src="//media.invisioncic.com/i328763/monthly_2019_10/product_update_.png.a57bb2bb82f82d30be45008ef2b39a89.png" loading="lazy">
			</td>
			<td>
				<p style="font-size:1rem; font-weight:bold; margin:0;">
					<a href="#product" rel="">Product Update</a>
				</p>
			</td>
		</tr>
		<tr>
			<td style="width: 55px;">
				<img alt="020117_cloud-ready.png.756ad51de885f3ba99fc6c77128dd336.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90875" style="width:34px; height: auto;" src="//media.invisioncic.com/i328763/monthly_2019_10/020117_cloud-ready.png.756ad51de885f3ba99fc6c77128dd336.png" loading="lazy">
			</td>
			<td>
				<p style="font-size:1rem; font-weight:bold; margin:0;">
					<a href="#cloud" rel="">Cloud</a>
				</p>
			</td>
		</tr>
		<tr>
			<td style="width: 55px;">
				<img alt="user-community.png.2eafed6da9c55e4e2c7d3f2dcb4ee036.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90876" style="width:34px; height: auto;" src="//media.invisioncic.com/i328763/monthly_2019_10/user-community.png.2eafed6da9c55e4e2c7d3f2dcb4ee036.png" loading="lazy">
			</td>
			<td>
				<p style="font-size:1rem; font-weight:bold; margin:0;">
					<a href="#community" rel="">Community</a>
				</p>
			</td>
		</tr>
	</tbody>
</table>

<p>
	<a name="fulfillment" rel=""></a>
</p>

<p>
	 
</p>

<h2>
	Fulfillment &amp; Access
</h2>

<ul>
	<li>
		<strong>Edelivery</strong>: Main customer contacts are sent a fulfillment email, with information on how to access the <strong><a href="https://edelivery.tibco.com/" rel="external nofollow">TIBCO Edelivery Site</a> </strong>If you have not received access to the edelivery site but need to do so, please reach out to your TIBCO Sales rep, or ask the person at your company who purchased the product(s) -- as they may have been the one to whom this information was sent. Find and download your Jaspersoft product license(s) in the Customer Portal.
	</li>
	<li>
		<strong>Supported Platforms</strong>: The <a href="https://community.jaspersoft.com/documentation/jasperreports-server/jasperreports%C2%AE-server-platform-support-guide-commercial-edition/v1000/jaspersoft-platform-support-_-overview/" rel="">Platform Support Guide</a> provides information that will help you prep to set up your own Jaspersoft environment in your organization, on your own servers.
	</li>
	<li>
		<strong>Documentation</strong>: <a href="./documentation" rel="">Jaspersoft's documentation</a> is a great place to learn and understand your analytics products with detailed documentation. After you have obtained your license and reviewed our <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-installation-guide/v1000/jrs-install-guide-_-introduction-_-introduction/" rel="">Installation Guide</a>, be sure to review our knowledge base article on <a href="https://community.jaspersoft.com/knowledgebase/how-to/applying-your-jaspersoft-product-licenses/" rel="">Applying Your Jaspersoft License</a>
	</li>
</ul>

<p>
	<a name="product" rel=""></a>
</p>

<p>
	 
</p>

<h2>
	Product Update
</h2>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="90877" href="//media.invisioncic.com/i328763/monthly_2019_10/screenshot_167.png.9a81520cedec1265f5bcee3fbe919ff1.png" rel=""><img alt="screenshot_167.png.9a81520cedec1265f5bcee3fbe919ff1.png" class="ipsImage ipsImage_thumbnailed" data-fileid="90877" style="height: auto;" src="//media.invisioncic.com/i328763/monthly_2019_10/screenshot_167.png.9a81520cedec1265f5bcee3fbe919ff1.png" loading="lazy"></a>
</p>

<p>
	You can keep up to date with different information about TIBCO products by subscribing to updates for the product in question through your support.tibco.com portal. Hover over Your Name, then click on Product Interest and Knowledgebase subscriptions. Check the boxes to each product you would like to receive notifications for. 
</p>

<p>
	Our <b><a href="https://www.jaspersoft.com/support/end-of-life-policies" rel="external nofollow">Product Release Strategy</a></b> will help you plan for Jaspersoft product software releases and technical support polices for software versions.
</p>

<p>
	<a name="cloud" rel=""></a>
</p>

<p>
	 
</p>

<h2>
	Cloud: Launching Jaspersoft for AWS
</h2>

<p>
	Our <strong><a href="https://community.jaspersoft.com/getting-started/jaspersoft-for-aws/" rel="">AWS Quick Start</a></strong> page has detailed information on working with AWS. It points to our AWS Github, Deployment Guide and provides background on the architectural set up of the implementation.
</p>

<p>
	<a name="community" rel=""></a>
</p>

<p>
	 
</p>

<h2>
	Community Access &amp; Layout
</h2>

<p>
	Our Jaspersoft Community helps you ask and answer product questions with responses from other knowledgeable community members and even experts at Jaspersoft. It's fast and easy to signup for Community accounts.
</p>

<ul>
	<li>
		<a href="https://community.jaspersoft.com/forums" rel=""><strong>Forum</strong> </a> — Read, Ask and Answer
	</li>
	<li>
		<strong><a href="https://community.jaspersoft.com/knowledgebase/" rel="">Knowledgebase</a></strong> — Read, Learn &amp; Contribute
	</li>
	<li>
		<a href="https://community.jaspersoft.com/files/category/2-extensions/" rel=""><strong>Extensions</strong></a> — Extend &amp; Build
	</li>
</ul>

<p>
	 
</p>

<p>
	<span style="font-size:1.5em; font-weight:bold;">←</span> Back to<a href="https://community.jaspersoft.com/knowledgebase/installation/jaspersoft-customer-orientation/" rel="">Jaspersoft Customer Orientation</a>
</p>

<p>
	 
</p>
]]></description><guid isPermaLink="false">3559</guid><pubDate>Wed, 02 Oct 2019 20:01:02 +0000</pubDate></item><item><title>JasperReports&#xAE; Server Administrator Resources</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/tibco-jasperreports-server-administrator-resources/</link><description><![CDATA[<p>
	Below you will find some resources that will be useful for new<span style="color:#000000;"> JasperReports Server</span> admins. Ultimately admins should familiarize themselves with all areas of <span style="color:#000000;">JasperReports Server</span> usage, but the information here will serve as an initial focus.
</p>

<h2>
	Install and Configure
</h2>

<ol>
	<li>
		<p>
		<a href="https://community.jaspersoft.com/documentation/tibco-jasperreports-server-installation-guide/v900/system-requirements" rel="">Hardware Requirements</a>: Covers the minimums required to run Jaspersoft.
	</p></li>
	<li>
		<p>
		<a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-installation-guide/v900/jrs-install-guide-_-introduction-_-jasperreports_server_distributions/" rel="">64 Bit Bundled Installer</a>: Our bundled installer accounts for one of the two ways you can install Jaspersoft.
	</p></li>
	<li>
		<p>
		<a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-installation-guide/v900/jrs-install-guide-_-warfileinstall-_-war_intro/" rel="">War File Distribution</a>: Our WAR File Distribution allows for more control over your Jaspersoft installation configuration and supports the use of databases beyond PostgreSQL and application servers beyond Apache Tomcat.
	</p></li>
	<li>
		<p>
		<a href="https://github.com/TIBCOSoftware/js-docker" rel="external nofollow">Docker Installation</a>: If you are looking to set up Jaspersoft within Docker containers we have a github that can help you.
	</p></li>
	<li>
		<p>
		<a href="https://aws.amazon.com/marketplace/pp/prodview-yk2d5mxc5vw5m?ref=portal_asin_url" rel="external nofollow">Jaspersoft for AWS</a>: Our<a href="https://community.jaspersoft.com/getting-started/jaspersoft-for-aws/" rel=""> Quick Start guide</a> should help you and your team get Jaspersoft up and running in AWS.
	</p></li>
</ol>

<h2>
	Documentation
</h2>

<p>
	In addition to the Admin, JasperReports<sup>®</sup> Server User Guide and Ultimate Guide detailed on our Jaspersoft<sup>®</sup> Customer Orientation page admins should review the following documentation.
</p>

<ol>
	<li>
		<p>
			Our <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-security-guide/vv900/jasperreports-server-security-guide-_-overview-_-security/" rel="">Security Guide</a> to ensure their Application, Users, and Domains are properly protected.
		</p>
	</li>
	<li>
		<p>
			The <a href="https://community.jaspersoft.com/documentation/v8-v81-v810/tibco-jaspersoft-platform-support-guide-commercial-edition-0" rel="">Supported Platforms Sheet</a> will detail what has been test and'or certified to work with Jaspersoft.
		</p>
	</li>
	<li>
		<p>
			Upgrades will take place at some point, review our <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports-server-upgrade-guide/v900/jrs-upgrade-guide-_-introduction/" rel="">Upgrade Guide</a> prior to embarking on this endeavor.
		</p>
	</li>
	<li>
		<p>
			When utilizing Ad-Hoc Reporting a firm understanding of working with <a href="https://community.jaspersoft.com/documentation/jasperreports-server/tibco-jasperreports%C2%AE-server-data-management-using-domains/vv900/jrs-domain-_-introduction-_-introduction/" rel="">Domains</a> will go a long way to ensuring you are maximizing your use of Jaspersoft.  
		</p>
	</li>
</ol>

<p>
	 
</p>

<p>
	Return to <a href="https://community.jaspersoft.com/wiki/jaspersoft-customer-orientation" rel="">Jaspersoft Customer Orientation</a> page.
</p>

<p>
	 
</p>
]]></description><guid isPermaLink="false">3414</guid><pubDate>Mon, 06 May 2019 16:20:19 +0000</pubDate></item><item><title>Apache Drill and Jaspersoft Studio</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/apache-drill-and-jaspersoft-studio/</link><description><![CDATA[<p>
	These instructions were kindly contributed by <a href="https://www.mapr.com/" rel="external nofollow">MapR</a>. <a href="https://www.mapr.com/" rel="external nofollow">MapR</a> provides the industry's only converged data platform that integrates the power of the top-ranked Hadoop and Spark with global event streaming, real-time database capabilities, and enterprise storage, enabling customers to harness the enormous power of their data. 
</p>

<p>
	This is a guide to connecting TIBCO Jaspersoft<sup>®</sup> Studio to Apache Drill via JDBC connector. It was tested with TIBCO Jaspersoft Studio 6.2.0 on Windows 7 using Apache Drill 1.4
</p>

<p>
	<a href="https://community.jaspersoft.com/project/jaspersoft-studio/releases" rel="">http://community.jaspersoft.com/project/jaspersoft-studio/releases</a>
</p>

<hr>
<h2>
	Download Drill JDBC driver
</h2>

<p>
	The JAR file should be included with any Drill distribution, the path below is where the MapR Drill JDBC driver is located
</p>

<pre class="ipsCode prettyprint lang-xml prettyprinted">/opt/mapr/drill/drill-1.4.0/jars/jdbc-driver/drill-jdbc-all-1.4.0.jar
</pre>

<p>
	Copy this jar file to your environment, it was placed in the Download folder for us.
</p>

<p>
	Run Jaspersoft Studio
</p>

<hr>
<h2>
	Create a new Data Adapter
</h2>

<p>
	Using the Database JDBC Connection
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89539" href="//media.invisioncic.com/i328763/monthly_2016_04/DataAdapter.png.46a0d8427367fcec3f65bd1548c13afa.png" rel=""><img alt="DataAdapter.png.46a0d8427367fcec3f65bd1548c13afa.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89539" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/DataAdapter.png.46a0d8427367fcec3f65bd1548c13afa.png" loading="lazy"></a>
</p>

<hr>
<h2>
	Add the jar file on the Driver Classpath page
</h2>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89540" href="//media.invisioncic.com/i328763/monthly_2016_04/DataAdapter2.png.9529ac52c1ea750b825204d45756e75a.png" rel=""><img alt="DataAdapter2.png.9529ac52c1ea750b825204d45756e75a.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89540" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/DataAdapter2.png.9529ac52c1ea750b825204d45756e75a.png" loading="lazy"></a>
</p>

<hr>
<h2>
	Put the relevant details in the Database Location page.
</h2>

<p>
	Note:
</p>

<ul>
	<li>
		‘org.apache.drill.jdbc.Driver’ is not available on the drop down box so it should be typed
	</li>
	<li>
		drill.url: jdbc:drill:zk=&lt;zkhost:port&gt;,&lt;zkhost:port&gt;,&lt;zkhost:port&gt;/drill/&lt;cluster-id&gt;
	</li>
	<li>
		the &lt;cluster-id&gt; can be found in the $DRILL_HOME/conf/drill-override.conf file
	</li>
	<li>
		drill.user: &lt;username&gt;
	</li>
	<li>
		drill.password: &lt;password&gt;
	</li>
</ul>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89541" href="//media.invisioncic.com/i328763/monthly_2016_04/DataAdapter3.png.80f5654d02d43e3e0f81cc751e6173a5.png" rel=""><img alt="DataAdapter3.png.80f5654d02d43e3e0f81cc751e6173a5.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89541" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/DataAdapter3.png.80f5654d02d43e3e0f81cc751e6173a5.png" loading="lazy"></a>
</p>

<p>
	Press test connection
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89542" href="//media.invisioncic.com/i328763/monthly_2016_04/DataAdaptertest.png.2319de3b88b397e50294d0bbbe46fc8b.png" rel=""><img alt="DataAdaptertest.png.2319de3b88b397e50294d0bbbe46fc8b.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89542" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/DataAdaptertest.png.2319de3b88b397e50294d0bbbe46fc8b.png" loading="lazy"></a>
</p>

<hr>
<p>
	<span style="color:rgb(43,38,34);font-family:'proxima-nova';font-size:2em;line-height:1.2em;">Create a view in Apache drill on a data source</span>
</p>

<p>
	For this example, a simple csv file was used and placed in the root of the MapR file system
</p>

<pre class="ipsCode prettyprint lang-auto prettyprinted"># ls -lrt
-rw-r--r--  1 mapr     mapr   1034773 Mar 16 10:54 customers.all.csv
</pre>

<pre class="ipsCode prettyprint lang-xml prettyprinted"># head customers.all.csv
16841,"Lisa Wells","tx","FEMALE","26-35",40,"basic"
19905,"Neely Nova","va","MALE","15-20",45,"basic"
17718,"William Bush","il","FEMALE","51-100",29,"basic"
21975,"Gerald Staples","ma","MALE","26-35",28,"basic"
20468,"William Conners","de","MALE","36-50",32,"basic"
16670,"John Rubio","oh","MALE","15-20",42,"basic"
18600,"Jay Holland","fl","FEMALE","21-25",43,"basic"
23438,"James Hogsett","ne","FEMALE","15-20",30,"basic"
20669,"Florence Black","pa","FEMALE","26-35",24,"basic"
22880,"Judith Stuart","ga","MALE","21-25",25,"basic"</pre>

<p>
	Create a view using the following command
</p>

<pre class="ipsCode prettyprint lang-sql prettyprinted"># create or replace view `dfs`.`tmp`.`customer` as
SELECT columns[0] as `customer_id`,
       columns[1] as `name`,
       columns[2] as `state`,
       columns[3] as `gender`,
       columns[4] as `age_group`,
       columns[5] as `age`,
       columns[6] as `account_type`
 FROM `dfs`.`default`.`customers.all.csv`
</pre>

<p>
	Test the View
</p>

<pre class="ipsCode prettyprint lang-sql prettyprinted">SELECT * FROM `dfs`.`tmp`.`customer`
</pre>

<p>
	 
</p>

<hr>
<h2>
	Now Back to TIBCO Jaspersoft® Studio
</h2>

<p>
	Create a new report
</p>

<h3>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89543" href="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewreport0.png.06cf2e5012ec216d37f0f5cf7f92aa90.png" rel=""><img alt="JSSnewreport0.png.06cf2e5012ec216d37f0f5cf7f92aa90.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89543" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewreport0.png.06cf2e5012ec216d37f0f5cf7f92aa90.png" loading="lazy"></a><br>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89544" href="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewreport.png.3a1c4aca174b631aa5ee81f292b9ba54.png" rel=""><img alt="JSSnewreport.png.3a1c4aca174b631aa5ee81f292b9ba54.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89544" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewreport.png.3a1c4aca174b631aa5ee81f292b9ba54.png" loading="lazy"></a>
</h3>

<h3>
	<br>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89545" href="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewreport2.png.56d248fb151022df8da32a7ad2c30376.png" rel=""><img alt="JSSnewreport2.png.56d248fb151022df8da32a7ad2c30376.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89545" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewreport2.png.56d248fb151022df8da32a7ad2c30376.png" loading="lazy"></a>
</h3>

<p>
	<span style="font-size:12px;">Select Data and query editor dialogue</span><br>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89546" href="//media.invisioncic.com/i328763/monthly_2016_04/JSSselectdata.png.309ff7094a442bdc0bbd80d81c8ed854.png" rel=""><img alt="JSSselectdata.png.309ff7094a442bdc0bbd80d81c8ed854.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89546" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/JSSselectdata.png.309ff7094a442bdc0bbd80d81c8ed854.png" loading="lazy"></a>
</p>

<p>
	<span style="font-size:12px;">Enter your query and press Read Fields and then OK.</span><br>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89547" href="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewquery.png.7d0ec0c50c97c2fb8a6c68c1b5eb784d.png" rel=""><img alt="JSSnewquery.png.7d0ec0c50c97c2fb8a6c68c1b5eb784d.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89547" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/JSSnewquery.png.7d0ec0c50c97c2fb8a6c68c1b5eb784d.png" loading="lazy"></a>
</p>

<p>
	<span style="font-size:12px;">The fields are now populated and ready for you to use</span><br>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="89548" href="//media.invisioncic.com/i328763/monthly_2016_04/JSSfieldsready.png.e23d86ae51d2b10c7a91dc9081d10ed6.png" rel=""><img alt="JSSfieldsready.png.e23d86ae51d2b10c7a91dc9081d10ed6.png" class="ipsImage ipsImage_thumbnailed" data-fileid="89548" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2016_04/JSSfieldsready.png.e23d86ae51d2b10c7a91dc9081d10ed6.png" loading="lazy"></a>
</p>
]]></description><guid isPermaLink="false">2218</guid><pubDate>Mon, 11 Apr 2016 12:55:02 +0000</pubDate></item><item><title>System requirements and installation of Jaspersoft Studio</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/getting-started-jaspersoft-studio/</link><description><![CDATA[<h2>
	Overview
</h2>

<p>
	Details regarding requirements and installation to get started with Jaspersoft® Studio.
</p>

<h2>
	Hardware requirements
</h2>

<p>
	Jaspersoft Studio needs a 64-bit processor and at least 500MB of hard-disk space. The RAM required depends on how complex the reports are. We recommend dedicating 2GB of RAM to Jaspersoft Studio, and because your system likely runs other applications that also need RAM, a total of 4GB is suggested.
</p>

<h2>
	Software requirements and installation
</h2>

<p>
	Like any Java-based application, Jaspersoft Studio needs the Java Runtime Environment (JRE) to run. However, to compile report scriptlets, the full Java Development Kit (JDK) is required. For details on supported Java versions, see the <a href="https://community.jaspersoft.com/documentation/jasperreports-server/jasperreports%C2%AE-server-platform-support-guide-commercial-edition/v900/jaspersoft-platform-support-_-overview/" rel="">Platform Support Guide</a>.
</p>

<p>
	Jaspersoft Studio supports most common operating systems, including:
</p>

<ul>
	<li>
		Windows 10 or newer (64-bit)
	</li>
	<li>
		Linux 64-bit, with support for Debian and CentOS
	</li>
	<li>
		macOS 14.x or 15.x (64-bit)
	</li>
</ul>

<p>
	Jaspersoft Studio can be downloaded from <a href="https://community.jaspersoft.com/download-jaspersoft/" rel="">here</a>. There are two versions available for download:
</p>

<ul>
	<li>
		The <strong>free community</strong> edition
	</li>
	<li>
		The <strong>paid commercial</strong> edition
	</li>
</ul>

<p>
	The commercial edition come with a <strong><a href="https://community.jaspersoft.com/download-jaspersoft/commercial-edition/" rel="">30-day free trial</a></strong>. Once you select an option (community or commercial), a list of available download choices are shown for the different operating systems, and you can choose the one that suits your needs.
</p>

<p>
	For the commercial edition:
</p>

<ul>
	<li>
		js-jss_x.x.x_linux_x86_64.tgz
	</li>
	<li>
		js-jss_x.x.x_macosx_x86_64.dmg
	</li>
	<li>
		js-jss_x.x.x_sources.zip
	</li>
	<li>
		js-jss_x.x.x_windows_x86_64.exe
	</li>
	<li>
		js-jss_x.x.x_windows_x86_64.zip
	</li>
</ul>

<p>
	x.x.x represents the version number of Jaspersoft Studio.
</p>

<p>
	For the community edition, the Eclipse RCP application files available are:
</p>

<ul>
	<li>
		js-studiocomm_x.x.x_linux_x86_64.tgz
	</li>
	<li>
		js-studiocomm_x.x.x_macosx_x86_64.dmg
	</li>
	<li>
		js-studiocomm_x.x.x_windows_x86_64.exe
	</li>
	<li>
		js-studiocomm_x.x.x_windows_x86_64.zip
	</li>
</ul>

<p>
	Download and install the correct Java and Jaspersoft Studio versions for your operating system.
</p>

<h2>
	Launching Jaspersoft Studio
</h2>

<p>
	In most cases, installation is as simple as downloading the file and double-clicking it to launch the setup wizard. Then, follow the on-screen instructions from there. 
</p>

<p>
	Jaspersoft Studio requires you to login with your Jaspersoft community user account credentials the first time you open the file. This is a one-time process, and you will not need to login again.  If you do not have a community account, you can <a href="https://community.jaspersoft.com/register" rel="">sign up here</a>.
</p>

<p>
	On rare occasion, a user may experience an issue logging in.  If you have any trouble, please see <a href="https://community.jaspersoft.com/knowledgebase/getting-started/jaspersoft-studio-login-error/" rel="">this guide to logging in via the alternative method</a>.
</p>

<p>
	<strong>Now, ready to <a href="https://community.jaspersoft.com/getting-started/jaspersoft-studio/" rel="">get started</a>?</strong>
</p>

<p>
	 
</p>
]]></description><guid isPermaLink="false">763</guid><pubDate>Mon, 19 Nov 2012 14:15:31 +0000</pubDate></item><item><title>JasperReports Web Studio - Getting Started</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/jasperreports-web-studio-professional-edition/</link><description><![CDATA[<h1>
	Introduction
</h1>

<p>
	<strong>JasperReports Web Studio</strong> is a visual, web-based designer for creating and editing report templates. While Jaspersoft Studio remains the most comprehensive desktop tool, the Web Studio offers a convenient alternative for building dynamic content and data visualizations for the JasperReports Library and other Jaspersoft products.
</p>

<p>
	You can deploy JasperReports Web Studio in a couple of ways. It can be used as a standalone web application or integrated into an existing JasperReports Server to add report-editing capabilities.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="132873" href="//media.invisioncic.com/i328763/monthly_2025_09/sample_screen.png.af73f0177e690e1b5a62b4c808b1e3e6.png" rel=""><img alt="sample_screen.thumb.png.849314a5bb68baaaf693a4a87d78511d.png" class="ipsImage ipsImage_thumbnailed" data-fileid="132873" style="height:auto;" width="1000" src="//media.invisioncic.com/i328763/monthly_2025_09/sample_screen.thumb.png.849314a5bb68baaaf693a4a87d78511d.png" loading="lazy" height="560"></a>
</p>

<h1>
	Getting started
</h1>

<p>
	The standalone version of JasperReports Web Studio is available as a ZIP file. This package includes everything required to run the application on Linux, Windows, or macOS.
</p>

<p>
	To get started, simply <a href="https://community.jaspersoft.com/download-jaspersoft/commercial-edition/" rel="">download the ZIP file</a> and extract its contents to a folder. From there, open a terminal or command prompt, navigate to that folder, and run either the <em>start.sh</em> (for Linux/macOS) or <em>start.bat</em> (for Windows) script.
</p>

<p>
	By default, the application runs on <em><a href="http://localhost:8088" rel="external nofollow">http://localhost:8088</a></em>, but you can change the port and other settings in the start script, if required.
</p>

<p>
	When you first open the web application, a login screen appears. From here, you can connect to different repositories, such as JasperReports Server instances, Google Drive accounts, GitHub projects, or Jackrabbit repository, to access your reporting resources.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="132872" href="//media.invisioncic.com/i328763/monthly_2025_09/loginscreen.png.7441051dc0143383e42b679c9c27a4db.png" rel=""><img alt="loginscreen.thumb.png.2956a852124eddfb8afff987e4a93ca2.png" class="ipsImage ipsImage_thumbnailed" data-fileid="132872" style="height:auto;" width="1000" src="//media.invisioncic.com/i328763/monthly_2025_09/loginscreen.thumb.png.2956a852124eddfb8afff987e4a93ca2.png" loading="lazy" height="430"></a>
</p>

<p>
	By default, you can only connect to either an existing JasperReports Server instance or to Jackrabbit repository. The options to log in with Google Drive and GitHub are disabled because they require extra configuration in the start script for their OAuth2 authentication.
</p>

<h1>
	Configuration
</h1>

<p>
	JasperReports Web Studio can be configured in different ways through properties. These properties may be:
</p>

<ul>
	<li>
		passed as environment variables
	</li>
	<li>
		added in the <em>jrws.properties</em> file
	</li>
	<li>
		added in the java system properties.
	</li>
</ul>

<div class="pageLinks">
	<div class="back">
		<a href="https://community.jaspersoft.com/getting-started/jasperreports-web-studio/" rel="">Getting started overview</a>
	</div>

	<div class="next">
		<a href="https://community.jaspersoft.com/knowledgebase/getting-started/report-repositories-and-repository-manager-jasperreports-web-studio/" rel="">Report repositories &amp; repository manager</a>
	</div>
</div>
]]></description><guid isPermaLink="false">4184</guid><pubDate>Tue, 23 Nov 2021 12:43:37 +0000</pubDate></item><item><title>Creating Charts and Subreports with Jaspersoft Studio</title><link>https://community.jaspersoft.com/knowledgebase/getting-started/creating-charts-and-subreports-jaspersoft-studio/</link><description><![CDATA[<h2>
	Overview
</h2>

<p>
	JasperReports supports a large number of built-in charts created using the popular open source library JFreeChart. Chart types include Pie, Bar, Stacked Bar, Line, Area, Bubble, Gantt, Thermometer and Meter. In this tutorial we will learn how to add a multi-series chart to a report. This tutorial uses the same example explained in <a href="https://community.jaspersoft.com/knowledgebase/designing-report-jaspersoft-studio" rel="">Designing a Report with Jaspersoft Studio</a>. We suggest you complete that tutorial before beginning this one.
</p>

<p>
	The goal is to have the same report described in the tutorial <a href="https://community.jaspersoft.com/knowledgebase/designing-report-jaspersoft-studio" rel="">Designing a Report with Jaspersoft Studio</a>, with a bar chart showing the number of shipments for every city.
</p>

<h2>
	Placing the Graph
</h2>

<p>
	The report created in the earlier tutorial is composed of multiple bands, each with different print times. For example, the detail band is printed for every record read from the data source, the page header and footer are printed at the start and at the end of every page and so on. For this tutorial we will use the Summary band that is printed at the end of the report. Note that in this report the Summary band is not visible from the designer because its height is set to 0. It is, however, visible from the outline view, so select it from there and change its height in the property tab to 400 pixels, as shown in the following image:
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86021" href="//media.invisioncic.com/i328763/monthly_2012_11/1(11).png.3ecf9fff811b74d76d30307cbe655fc3.png" rel=""><img alt="1(11).png.3ecf9fff811b74d76d30307cbe655fc3.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86021" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/1(11).png.3ecf9fff811b74d76d30307cbe655fc3.png" loading="lazy"></a>
</p>

<h2>
	The Subreport
</h2>

<p>
	A subreport is an element that includes a report inside another report. The idea in this tutorial is to have a subreport containing just the graph, and a main report that includes the subreport in the summary section.
</p>

<p>
	For the purposes of this tutorial, we want to use two reports because in the main report we need a list of records without any aggregation so we had used the query "select * from orders" and from all the fields read we had selected the order id, the shipment name, shipment address, shipment city, shipment region. But for the graph in the subreport we don't need a list of records, just a group of them. In other words, we need the records grouped by the shipment city. For this reason we need two queries, one that returns all the records  (for the main report) and one for the group (for the subreport). Because a report can have only one main query, we need to use another report for the additional query. Note that there are other ways to use more than a query on the report, but for now we choose this one to introduce the concept of subreport.
</p>

<div>
	Now drag the subreport element from the palette into the summary section and a wizard will appear:
</div>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86023" href="//media.invisioncic.com/i328763/monthly_2012_11/2(8).png.7a09c1f01bdc1d875bfa7ddebd843a04.png" rel=""><img alt="2(8).png.7a09c1f01bdc1d875bfa7ddebd843a04.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86023" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/2(8).png.7a09c1f01bdc1d875bfa7ddebd843a04.png" loading="lazy"></a>
</p>

<p>
	In the first step of the wizard we have three choices:
</p>

<ol>
	<li>
		Create a new report as subreport.
	</li>
	<li>
		Use an existing report as subreport.
	</li>
	<li>
		Put an empty report as subreport, as a placeholder.
	</li>
</ol>

<p>
	Since we are doing this from scratch select the first option, <strong>Create a new report</strong>, and click <strong>Next</strong>.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86025" href="//media.invisioncic.com/i328763/monthly_2012_11/3(4).png.d6d922fd0a0a26621396c71e1a6181ee.png" rel=""><img alt="3(4).png.d6d922fd0a0a26621396c71e1a6181ee.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86025" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/3(4).png.d6d922fd0a0a26621396c71e1a6181ee.png" loading="lazy"></a>
</p>

<p>
	Now we will seen a wizard almost identical to the one seen when we created the first report. This time, since we need only a blank paper with a graph select <strong>BlankA4</strong> and hit <strong>Next</strong>.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86027" href="//media.invisioncic.com/i328763/monthly_2012_11/4(4).png.b03352fa9ef0afbd1cf5c9dee4a1ba26.png" rel=""><img alt="4(4).png.b03352fa9ef0afbd1cf5c9dee4a1ba26.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86027" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/4(4).png.b03352fa9ef0afbd1cf5c9dee4a1ba26.png" loading="lazy"></a>
</p>

<p>
	Now we need to choose the location and the filename of the new report, put it in the standard location <strong>MyReports </strong>and as name use "<strong>GraphReport" </strong>and click <strong>Next</strong>.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86029" href="//media.invisioncic.com/i328763/monthly_2012_11/5(3).png.1c5ea63957b4fadea2a21f4198db4bd1.png" rel=""><img alt="5(3).png.1c5ea63957b4fadea2a21f4198db4bd1.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86029" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/5(3).png.1c5ea63957b4fadea2a21f4198db4bd1.png" loading="lazy"></a>
</p>

<p>
	Now we have to select the data adapter. Since we need to use the same data source for both reports, select the same data adapter as used in the main report. We must also provide the query to retrive the fields, so enter the query that returns the records grouped by the shipment city. Every record read from the database with this query contains two fields: the number of elements for a city and the name of the city. After that we can click <strong>Next</strong>.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86031" href="//media.invisioncic.com/i328763/monthly_2012_11/6(3).png.e48430c9247b10f04a8c73d9cf3b0416.png" rel=""><img alt="6(3).png.e48430c9247b10f04a8c73d9cf3b0416.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86031" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/6(3).png.e48430c9247b10f04a8c73d9cf3b0416.png" loading="lazy"></a>
</p>

<p>
	At this point we can see the fields included by the second query. Click the <strong>add all</strong> button or double-click on each field until they are in the right list. After that click <strong>Next</strong>. The following step in the wizard is to create groups into the report, but this is unnecessary for our goal. Click <strong>Next </strong>again.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86033" href="//media.invisioncic.com/i328763/monthly_2012_11/7(1).png.00291784351b48b42a8185b8d1bc061d.png" rel=""><img alt="7(1).png.00291784351b48b42a8185b8d1bc061d.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86033" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/7(1).png.00291784351b48b42a8185b8d1bc061d.png" loading="lazy"></a>
</p>

<p>
	Now we have to select the connection to the database. Since we are using the same database as in the main report we can select the first option and click <strong>Next</strong>. In the following step in the wizard, we could create some parameters that can be passed from the main report to the subreport, but we don't need them so click the button <strong>Finish</strong>.
</p>

<p>
	Now we have a new report with all his bands, but we need only one of them. In fact, we need only a band for the graph, and the band must be printed only once, so the detail band is excluded. We can choose the Title or Summary band. If we decide to choose Title, we need to remove the other bands because otherwise they will take up space unnecessarily. So for each band except Title right-click on its element in the outline view and choose <strong>Delete</strong>. The name of a deleted band appears in light gray text in the outline view, so at the end of the process the only band with a black name must be Title.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86035" href="//media.invisioncic.com/i328763/monthly_2012_11/8(1).png.658baf5752021d94dfced5b7ac428593.png" rel=""><img alt="8(1).png.658baf5752021d94dfced5b7ac428593.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86035" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/8(1).png.658baf5752021d94dfced5b7ac428593.png" loading="lazy"></a>
</p>

<h2>
	The Chart
</h2>

<p>
	Now we can place the chart. Drag its element from the palette into the Title band to open the wizard, select the bar chart and click <strong>Next</strong>.
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86037" href="//media.invisioncic.com/i328763/monthly_2012_11/9(1).png.0a64eab004760ce91605c6e9948a590d.png" rel=""><img alt="9(1).png.0a64eab004760ce91605c6e9948a590d.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86037" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/9(1).png.0a64eab004760ce91605c6e9948a590d.png" loading="lazy"></a>
</p>

<p>
	In the next step you can configure the series of the chart, as shown in the following image:
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86039" href="//media.invisioncic.com/i328763/monthly_2012_11/10(1).png.1a62db74b57a7ef78a1663d69220b0bd.png" rel=""><img alt="10(1).png.1a62db74b57a7ef78a1663d69220b0bd.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86039" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/10(1).png.1a62db74b57a7ef78a1663d69220b0bd.png" loading="lazy"></a>
</p>

<p>
	Then click <strong>Finish</strong> to create the chart. Since we need space, resize the Title band with an height of 350 pixels. Right-click on the chart, select <strong>Size to Container</strong> and then <strong>Fill Both</strong>. The chart will take all the space in the band. Now we can switch to the Preview tab and if it is all correct, save this subreport and switch to the main report as shown in the following image:
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86041" href="//media.invisioncic.com/i328763/monthly_2012_11/11.png.e28889d36e7707b6c58e59fc426762c1.png" rel=""><img alt="11.png.e28889d36e7707b6c58e59fc426762c1.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86041" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/11.png.e28889d36e7707b6c58e59fc426762c1.png" loading="lazy"></a>
</p>

<p>
	Now the only thing to do is to resize the subreport element to fill the Summary band, and compile the report. On the last page you will get a result like this:
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86043" href="//media.invisioncic.com/i328763/monthly_2012_11/12.png.aeb63f543919b95652415b8307154ff4.png" rel=""><img alt="12.png.aeb63f543919b95652415b8307154ff4.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86043" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/12.png.aeb63f543919b95652415b8307154ff4.png" loading="lazy"></a>
</p>

<hr>
<h2>
	More on Complex Reporting
</h2>

<h4>
	<a href="https://community.jaspersoft.com/knowledgebase/subreports-jaspersoft-studio" rel="">Subreports in Jaspersoft Studio</a>
</h4>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86022" href="//media.invisioncic.com/i328763/monthly_2012_11/1(11).png.f75819f2c82ffe93f55fe9b1c518fc5a.png" rel=""><img alt="1(11).png.f75819f2c82ffe93f55fe9b1c518fc5a.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86022" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/1(11).png.f75819f2c82ffe93f55fe9b1c518fc5a.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86024" href="//media.invisioncic.com/i328763/monthly_2012_11/2(8).png.741a2ffd5a591d545ac7887db2bd3477.png" rel=""><img alt="2(8).png.741a2ffd5a591d545ac7887db2bd3477.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86024" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/2(8).png.741a2ffd5a591d545ac7887db2bd3477.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86026" href="//media.invisioncic.com/i328763/monthly_2012_11/3(4).png.3a8cf3ecdc1c122515966b302c176027.png" rel=""><img alt="3(4).png.3a8cf3ecdc1c122515966b302c176027.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86026" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/3(4).png.3a8cf3ecdc1c122515966b302c176027.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86028" href="//media.invisioncic.com/i328763/monthly_2012_11/4(4).png.62bffed8a47bb197ceccda01ee11d75f.png" rel=""><img alt="4(4).png.62bffed8a47bb197ceccda01ee11d75f.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86028" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/4(4).png.62bffed8a47bb197ceccda01ee11d75f.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86030" href="//media.invisioncic.com/i328763/monthly_2012_11/5(3).png.126bcadc44ad187660a1ca85250c0f0c.png" rel=""><img alt="5(3).png.126bcadc44ad187660a1ca85250c0f0c.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86030" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/5(3).png.126bcadc44ad187660a1ca85250c0f0c.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86032" href="//media.invisioncic.com/i328763/monthly_2012_11/6(3).png.2a1d644302fc0bc7d2824c2ae8bf7abf.png" rel=""><img alt="6(3).png.2a1d644302fc0bc7d2824c2ae8bf7abf.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86032" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/6(3).png.2a1d644302fc0bc7d2824c2ae8bf7abf.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86034" href="//media.invisioncic.com/i328763/monthly_2012_11/7(1).png.51ab1a9da349ed50ba893ede6d71fd22.png" rel=""><img alt="7(1).png.51ab1a9da349ed50ba893ede6d71fd22.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86034" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/7(1).png.51ab1a9da349ed50ba893ede6d71fd22.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86036" href="//media.invisioncic.com/i328763/monthly_2012_11/8(1).png.be5334ee06fa7473a95382215d108594.png" rel=""><img alt="8(1).png.be5334ee06fa7473a95382215d108594.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86036" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/8(1).png.be5334ee06fa7473a95382215d108594.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86038" href="//media.invisioncic.com/i328763/monthly_2012_11/9(1).png.d7f13acab6b1121b12de98b35c83691e.png" rel=""><img alt="9(1).png.d7f13acab6b1121b12de98b35c83691e.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86038" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/9(1).png.d7f13acab6b1121b12de98b35c83691e.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86040" href="//media.invisioncic.com/i328763/monthly_2012_11/10(1).png.3590a96959e5b44802af27a7b75cfc6a.png" rel=""><img alt="10(1).png.3590a96959e5b44802af27a7b75cfc6a.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86040" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/10(1).png.3590a96959e5b44802af27a7b75cfc6a.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86042" href="//media.invisioncic.com/i328763/monthly_2012_11/11.png.1c4bec3c1421b22dee71a472503fde59.png" rel=""><img alt="11.png.1c4bec3c1421b22dee71a472503fde59.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86042" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/11.png.1c4bec3c1421b22dee71a472503fde59.png" loading="lazy"></a>
</p>

<p>
	<a class="ipsAttachLink ipsAttachLink_image" data-fileext="png" data-fileid="86044" href="//media.invisioncic.com/i328763/monthly_2012_11/12.png.922890d16b1665ac92839c4b09ceabb2.png" rel=""><img alt="12.png.922890d16b1665ac92839c4b09ceabb2.png" class="ipsImage ipsImage_thumbnailed" data-fileid="86044" style="height:auto;" src="//media.invisioncic.com/i328763/monthly_2012_11/12.png.922890d16b1665ac92839c4b09ceabb2.png" loading="lazy"></a>
</p>
]]></description><guid isPermaLink="false">785</guid><pubDate>Tue, 20 Nov 2012 17:22:47 +0000</pubDate></item></channel></rss>
