Install and Run Book

Installing The Plugin

The VOC Volume plugin installs through the Jira UPM (Universal Plugin Manager) with Systems Administration access.

UPM (Universal Plugin Manager)

1. Download (Jira 7.x) VOC Utilities v4.0.1-Jira7 or (Jira 6.x) VOC Utilities v3.0.0 locally.
2. As Jira Systems Administrator, Open the Manage Add-ons dialog.
3. Click "Upload add-on" link near top right of the dialog.
4. Click "Choose File" and navigate to the locally saved .jar file and click Open, and click Upload - The plugin will install.
5. Click "Configure" on the plugin dialog to open the VOC Volume Configuration page.

Configure VOC Volume features

See VOC Volume Configuration page for prepare Jira and configure the plugin in Jira.

Adding Gadgets to Dashboard

This plugin add 3 gadgets available in a Jira Dashboard.

1. Click Manage Dashboards from the Dashboards menu (or open an existing Dashboard from this menu).
2. Click "Add Gadget" and scroll down to "VOC..." and select one of these three gadgets.

Keeping Things Running

If you are making changes to the code base and installing on your production Jira, make a copy use a copy of your production Jira instance to test on first.

Troubleshooting

• Monitor the Jira application log tail -f atlassian-jira.log in a terminal.
• If there are errors after re-uploading your plugin in Jira, try uninstalling the plugin first, and installing the new one (data already created by the prior plugin should remain.
• If you run int a problem that you locked the jira instance (JIRALockedError), follow these steps to unlock...

ps aux | grep jira
kill -9 <process id>
CD to the JIRA Home directory 
CD /opt/atlassian/data/jira_home/
sudo ls -al
sudo rm .jira-home.lock
su jira
sudo /etc/init.d/jira start

• If your new plugin fails in Jira, be sure to go back to your local development instance and remote debug