NodeJS installation is necessary for BigTemplate to work properly. Installation steps can be found below


It's only a few clicks. First, go to Jira Administration > Manage apps > "Find new apps" and type "BigTemplate" in the search box. Then, click "Install," accept the terms, and you are almost there. 

The plugin installation may take a while, so be patient. The "Installed and ready to go!" pop-up on your screen means that the license has been detected and you are all set. However, if it's the first time you use BigTemplate, you may be required to click and navigate to My Atlassian in order to generate an evaluation license.

Have a look at the GIF below, which shows how easy the installation process is.

Stay up-to-date! 

If you wish to receive automatic email notifications about new versions coming out in the Atlassian Marketplace, feel free to click 'Watch app.' You can stop watching at any time, but we definitely recommend having the most recent BigTemplate installed. These email alerts are the best way to keep you informed about new versions going live.

If you are a Jira Cloud user, you'll get the updates deployed automatically to your Jira Cloud instance.

 

Features unlocked with Headless Chrome

A quick comparison of image export engines: 


Headless Chrome (Starting from BigTemplate 2.7.0)

Image export formatsPDF (exact export of browser as seen on PC/MAC)
ExportablesGantt, Roadmap, Resources, Risks

NodeJS Installation

Please install NodeJS (version 10.24.0 or higher) using guides from https://docs.npmjs.com/downloading-and-installing-node-js-and-npm

Installation check:
Command "node -v" should return the version of the installed NodeJS.
Command "npm -v" should return the version of the installed NPM.

If you have any further questions regarding setting up NodeJS or if by any chance the image export fails afterward, do not hesitate to contact our Support Team via our Service Desk.

Quick troubleshooting

Export diagnostics

Please start the troubleshooting by running export diagnostics. 

Go to App configuration > BigTemplate configuration > Technical Info and click the "Export diagnostics" button.

 Accessing BigTemplate Configuration

Method 1: "." (dot) context

If BigGantt is a Jira add-on, you can use the Jira "." shortcut to access the BigGantt configuration.

  1. Press the "." (dot) key shortcut. Jira to open Operations Dialogue.
  2. Type in "BigTemplate" to narrow down results:

  3. Click on "BigTemplate configuration" to go directly to app settings in Jira.

Method 2: Jira administration drop-down

  1. Click the Jira cog at the top right and select "Manage apps" from the list:
  2. Select "BigTemplate configuration on the left:


If everything is properly set up you will see green checkmarks:


Failures are marked with a red "X":

Node.js or NMP installation failure

If Node.js or NPM installation and version is not correct, follow the steps described above.

Temp directory read/write permissions failure

If Temp directory read/write permissions are not correct (przenieść) Temp directory read permission. 

Linux

Temp directory write permission:

  1. Go to your Jira Temp dir ( if you don't know the path go to Getting the path of Jira temp directory section below )
  2. Make sure that the user who runs Jira ( by default it is a user named Jira ) has permissions to create files in this directory.
  3. Execute the following command: chmod +w path/to/temp/dir

Temp directory read permission:

  1. Go to your Jira Temp dir ( if you don't know the path go Getting the path of Jira temp directory section below )
  2. Make sure that the user who runs Jira ( by default it is a user named Jira ) has permissions to create files in this directory.
  3. Execute the following command: chmod +r path/to/temp/dir

Getting the path of Jira temp directory:

  1. Go to Jira → System → System Info
  2. Search for the following text: java.io.tmpdir
  3. Value of this property is temp directory path, e.g. /opt/atlassian/jira/temp

Export library installation failure

If the last point is not correct, click on the "Re-install pdf export" button.

Using NVM as node manager

NVM can't be installed. If you are currently using NVM, you need to uninstall it. 

If you are using NVM as node manager, even after installing node.js, the application logs will still show that node.js does not exist (can't be found). 

  1. Please check if you use NVM as node version manager - run this command:
    nvm --help

    If it returns anything, that means that NVM is installed.

      2. Uninstall NVM

      3. Install Node.js and NPM

Instead of using NVM you could use https://www.npmjs.com/package/n


Pre 8.1 installation steps

  1. Go to Jira temp dir
  2. Execute 'npm init', confirm all to the end
  3. Execute 'npm install puppeteer@2.1.0'