Here is an administrator-level overview to get your system up and running with Arsenale Dataplane:
- Make sure your Jira instance meets the system requirements.
- Review Dataplane's database configuration requirements before proceeding with the installation.
- Install the Arsenale Dataplane app in your Jira instance as you would any standard Jira app.
- Enable support for Asian character sets, if you use Jira with Chinese, Japanese or Korean text.
- Run Dataplane's indexer to build its database of Jira issue states and transitions.
- Configure Dataplane user permissions to enable those users you wish to have access to the application.
- Enable any optional, experimental Dataplane Labs features you would like to try.
You are done!
Before installing Arsenale Dataplane, check your Jira database server against the system requirements and recommendations.
Arsenale Dataplane stores all its data in the same database used by Jira.
Depending on the type of Jira issues you have, Arsenale Dataplane's data storage could potentially double your Jira database size or more.
We recommend checking your database server to ensure that you have sufficient space available before installing Dataplane and running the Dataplane indexer.
MySQL Database Performance Tuning
MySQL's default installation is not particularly optimized for performing database-intensive reporting operations. In particular, a stock configuration of MySQL can cause performance problems.
Although Arsenale Dataplane will generally work without needing to perform any specific MySQL configuration, some reports can take an exceedingly long time to run if your Jira installation is large and MySQL has not been properly configured.
For best performance, the database user used by Jira needs to be granted the "CREATE TEMPORARY TABLES" privilege. To grant this privilege, connect to the MySQL console and execute the following statement, and then restart your Jira instance. (Substitute the same values into this query as you did when performing the original Jira database setup.)
- Before installing Arsenale Dataplane, we strongly recommend that you check your MySQL installation to ensure that Jira is using the InnoDB database engine. The InnoDB database is also the only MySQL storage engine officially supported by Atlassian for Jira.
- In addition, we recommend that you configure the InnoDB buffer pool to use as much physical memory as you have available on your database server. For Jira installations with a few tens of thousands of issues, we recommend a minimum of one gigabyte, or more if possible. This cache will benefit Jira as well as Arsenale Dataplane.
- We also recommend enabling the MySQL query cache and setting the query cache size to at least 10 megabytes.
An example configuration of /etc/my.cnf with these modified settings looks like this:
No special database tuning is currently required for databases other than MySQL.
Arsenale Dataplane is a standard Jira app, and can be downloaded and installed from within the Jira Add-On Manager.
Alternatively, you may download the Dataplane .jar file and upload it to your Jira installation manually via the same admin page.
Once installed, Arsenale Dataplane is accessible from the Dataplane Reports menu in the main Jira navigation bar.
If your browser window is not wide enough, the Dataplane Reports menu may get collapsed into the More menu option:
Enabling Support for Chinese, Japanese and Korean Character Sets
In most cases, the default settings allow Dataplane to produce correctly-rendered output with Asian languages and you do not need to make any changes. However, Dataplane depends on the Java-standard system fonts and PDF fonts to render Asian characters, so if you are experiencing issues with text in charts or PDF exports, please see below.
Configuring Asian Fonts for Charts and Graphics
Dataplane renders charts on the Jira server, and normally uses the fonts bundled with Java for rendering the labels, titles and other text on charts. In many cases, Java will supplement these fonts with system fonts when rendering Asian languages (including Chinese, Japanese and Korean). If the required fonts are missing from the Jira server, Dataplane may render Asian language text as small squares ("◻") instead of the proper characters.
If the text on Dataplane charts is not displayed correctly, you will need to install some fonts on the Jira server. There are two methods for doing so.
Method 1: Installing Missing System Fonts
This method is for Linux servers only running Dataplane 2.1.1 and above, and you must have system administrator privileges in order to perform these commands.
For Windows and Mac OS X servers, you must instead use Method 2: "Manually Installing Fonts for Dataplane".
By default, most Linux installations support only Western languages. In order for Dataplane to render charts correctly in Asian languages, you must install a font pack.
For RedHat Enterprise Linux and CentOS systems, the following commands will install the correct fonts:
|yum install fonts-chinese
|yum groupinstall "Chinese Support"
|yum install fonts-japanese
|yum groupinstall "Japanese Support"
|yum install fonts-korean
|yum groupinstall "Korean Support"
After installing a new font pack you must restart Jira for Dataplane to start using the new fonts.
If you do not have system administrator privileges or are not able to immediately restart Jira, you can instead install fonts for Dataplane use only by using the Method 2 instructions that follow.
Method 2: Manually Installing Fonts for Dataplane
For Linux, Windows and Mac OS X servers, you can manually install TrueType fonts for Dataplane use.
Dataplane can use any standard TrueType font that supports your OS and desired locale.
On the Jira server, font files for Dataplane use go in a Dataplane-specific sub-directory of the Jira data directory. The Jira data directory is where user data (such as issue attachments) for your Jira instance resides—not the directory where you have installed the Jira application itself. For Jira Data Center installations, these fonts must be stored in the shared data directory.
Dataplane supports separate TrueType fonts for regular and boldface text. These font files should be placed in the following locations:
|Regular Weight Font
|<JIRA DATA DIRECTORY>/dataplane/fonts/chart-regular.ttf
|Bold Weight Font (optional)
|<JIRA DATA DIRECTORY>/dataplane/fonts/chart-bold.ttf
For example, if your Jira data directory is located at "/usr/local/atlassian/jira-data", create "/dataplane/fonts" sub-directories and place the files there:
Within your Jira data directory, create the "/dataplane/fonts" sub-directories if they do not already exist.
Dataplane will only use font files named exactly "chart-regular.ttf" and "chart-bold.ttf", so rename your TrueType font files to these file names.
Installing a bold font file is optional. If the bold font is not present, Dataplane will automatically use the regular font instead.
After installing the font files, you must disable and re-enable the Dataplane app within Jira for Dataplane to start using the new fonts.
For Japanese text, the IPAex Gothic font is known to work well. In particular, download the file labeled as "IPAexGothic(Sans Serif)(Ver.002.01)" with filename "ipaexg00201.zip", extract the .TTF file and then rename it to chart-regular.ttf as described above.
For Chinese and Korean text, please contact us for font file suggestions.
Configuring Asian Fonts for PDF Exports
When Dataplane reports are exported in PDF format, Dataplane specifies in the PDF file which fonts should be used to render the report.
Since most popular PDF reader applications include Chinese, Japanese and Korean fonts in the application, to keep exported Dataplane reports to a reasonable file size, the PDF files identify fonts by reference rather than bundling the entire font within the file.
For Dataplane reports that contain Chinese, Japanese or Korean text, so long as the Jira user profiles of your Jira users are set to a matching locale, you should not need to do anything for those users to get the correct language fonts when generating report exports in PDF format.
By default Dataplane uses the language specified by the locale setting in the user's Jira profile to determine the appropriate fonts for a report export in PDF format.
In most scenarios, this works as desired for users. However if there is a mismatch in language between the text in Dataplane reports and the profiles of Jira users—for instance, users have an English-language Jira profile but still need to export Dataplane reports containing Japanese characters—it is possible, on a global basis, to override the font chosen for PDF exports.
To manually set the PDF export language and font choice, edit your <JIRA HOME DIRECTORY>/bin/setenv.sh file and add the following to JVM_SUPPORT_RECOMMENDED_ARGS (or on Windows, customize the JVM parameters in the Jira Tomcat Service) based on the desired language and font choice for report exports in PDF format:
After making the above modification, you must restart your Jira server for the changes to take effect.