Installation&Upgrade Guide

v2.0 is compatible with JIRA 5.0.x

If you are using or planning to use global on-edit validation and/or post-function scripts then read on otherwise proceed to step 2.
1. Install a patched version of JIRA Quick Edit plugin: navigate to Install tab at UPM, click 'Upload Plugin' and enter URL according to your JIRA version:
  1. JIRA 5.0: http://quisapps.s3.amazonaws.com/public/jss/deps/jira-quick-edit-plugin-1.0.29.jar
  2. JIRA 5.0.1: http://quisapps.s3.amazonaws.com/public/jss/deps/jira-quick-edit-plugin-1.0.36.jar
  3. JIRA 5.0.2: http://quisapps.s3.amazonaws.com/public/jss/deps/jira-quick-edit-plugin-1.0.37.jar
  4. JIRA 5.0.3, 5.0.4: http://quisapps.s3.amazonaws.com/public/jss/deps/jira-quick-edit-plugin-1.0.41.jar
2. If you choose not to install this update to JIRA Quick Edit plugin, then global on-edit validation and post-function scripts will not work; all other functions will work properly.
Install JSS through UPM; use one of the following:
1. find the plugin using Search field and click Install Now button, or
2. click "Upload Plugin" and enter http://dev.quisapps.com/artifactory/public/com/quisapps/jira/jss/2.0.0/jss-2.0.0.jar into URL field

v1.2 is compatible with JIRA 4.4.x

Download Jython 2.5.0 from http://jython.org/downloads.html and install it: java -jar jython_installer-2.5.0.jar. Please do not use other versions (even later ones), this is known to cause bugs.
Set Java property for JIRA: -Dpython.home=<jython install directory> (follow this guide)
Download JSS 1.2 Plugin JAR (jss-1.2.0_44.jar) and initial scripts package (jss_base_scripts.zip);
Copy Plugin JAR to JIRA_HOME/plugins/installed-plugins or upload it using UPM;
Unzip initial Jython scripts from jss_base_scripts.zip to JIRA_HOME - it will create jss folder in JIRA_HOME;

You don't need to install any add-ons or modify any JIRA files.

v1.1 is compatible with JIRA 4.0.x - 4.3.x

Download Jython 2.5.0 from http://jython.org/downloads.html and install it: java -jar jython_installer-2.5.0.jar. Please do not use other versions (even later ones), this is known to cause bugs.
Set Java property for JIRA: -Dpython.home=<jython install directory> (follow this guide)
Download JSS 1.1 Plugin JAR (jss-1.1.jar), Initial scripts package (jss_base_scripts.zip) and On-edit Validator & Postfunction Add-on (jss_NN-1.0.jar - select one matching your JIRA version);
Copy Plugin JAR and Add-on JAR to JIRA_HOME/plugins/installed-plugins;
Unzip initial Jython scripts from jss_base_scripts.zip to JIRA_HOME - it will create jss folder in JIRA_HOME;
Modify /WEB-INF/classes/actions.xml:
- JIRA 4.0.x and 4.1.x: change "issue.EditSubTaskIssue" to "com.quisapps.jira.plugin.action.EditSubTaskIssue" and "issue.EditIssue" to "com.quisapps.jira.plugin.action.EditIssue"
- JIRA 4.2, 4.3 : change "issue.EditIssue" to "com.quisapps.jira.plugin.action.EditIssue"
Restart JIRA

Prerequisites: Jython 2.5.0 installed, python.home Java property set for JIRA and /WEB-INF/classes/actions.xml patched;
Download JSS 1.1 Plugin JAR (jss-1.1.jar), Initial scripts package (jss_base_scripts.zip) and On-edit Validator & Postfunction Add-on (jss_NN-1.0.jar - select one matching your JIRA version);
Replace old jss-NNNN.jar with new Plugin JAR and Add-on JAR in JIRA_HOME/plugins/installed-plugins;
Make a backup copy of your scripts library in JIRA_HOME/jss/jython and update initial Jython scripts from jss_base_scripts.zip to JIRA_HOME; you may safely choose to not overwrite any existing files.
Restart JIRA

All your existing scripts are compatible with new JSS version.