tools/JasperStudio.md

+# Jasper
+
+Jasper is the engine used by OpenCell to generate the PDFs (invoices).
+
+### Version
+
+We ask the OC team what is the version recommended to work with the OC 6.2.0/6.3.0.
+
+Answer:
+
+We have been using v6.6.0 
+
+We can get this version of JasperStudio from https://sourceforge.net/projects/jasperstudio/files/JaspersoftStudio-6.6.0/TIB_js-studiocomm_6.6.0_linux_amd64.deb
+
+# Installation
+
+Once the package was downloaded, we can install it with:
+
+```
+sudo dpkg -i TIB_js-studiocomm_6.6.0_linux_amd64.deb
+```
+
+The installation process creates the `tibco` in `/opt/` and put all the files insede a folder with the version name: `/opt/tibco/TIB_js-studiocomm_6.6.0/`
+
+In this folder we find two executables:
+
+```
+ 'Jaspersoft Studio'
+  runjss.sh
+```
+
+We can exec the `runjss.sh` and the JasperStudio client was open.
+
+This file, expose two environment variables and call to the other executable file:
+```
+# cat runjss.sh
+
+#!/bin/bash
+DIR=$(dirname "$0")
+export UBUNTU_MENUPROXY=0;
+export SWT_GTK3=0;
+"$DIR"/Jaspersoft\ Studio $*
+```
+
+For call directly the `jasperstudio` command to open the application, we can create links in the `/usr/sbin/ folder:
+
+```
+$ sudo ln -s /opt/tibco/TIB_js-studiocomm_6.8.0/runjss.sh /usr/sbin/jasperstudio                               
+$ sudo ln -s /opt/tibco/TIB_js-studiocomm_6.8.0/Jaspersoft\ Studio /usr/sbin/Jaspersoft\ Studio 
+```
+Now we can run `jasperstudio` and the app is open
\ No newline at end of file