Step 1: Configure JIRA for AccuSync

Note: This step is for JIRA users only. If you are using another ITS, go to Step 2: Set Up the AccuWork™ Schema.

If you are using AccuSync with JIRA, you need to do the following before you can use AccuSync:

•	Configure JIRA to accept remote API calls

•	Install the JIRA plugin for AccuSync

Configure JIRA to Accept Remote API Calls

To configure JIRA to accept remote API calls:

1.	In JIRA, open the Administration tab.

2.	Navigate Global Settings > General Configuration.

3.	At the bottom of the General Configuration page, click Edit Configuration.

4.	Locate the Options section, and ensure that the Accept remote API calls property is set to ON.

5.	Click the Update button to save your changes.

Install the JIRA Plugin for AccuSync™

This section describes the JIRA plugin for AccuSync and how to install them. If you already installed the plugin as part of upgrading AccuSync from an earlier version, you can skip this section.

Purpose of the JIRA Plugins for AccuSync

JIRA plugins for AccuSync automatically add the following custom fields to JIRA:

•	AccuWorkIssueLink -- Stores the URL that JIRA users can use to open a web browser and display the issue in the AccuRev Web UI.

•	AccuWorkKey -- Stores the unique alphanumeric key for each AccuWork issue record.

•	AccuWorkChangePackage -- Stores summary AccuWork issue change package information.

•	AccuWorkChangePackageHistory -- Stores detailed AccuWork issue change package information.

These fields appear on the JIRA View Custom Fields page only after AccuSync has performed a synchronization task.

Different Plugins for JIRA 4 and JIRA 5

Note: Support for JIRA 4.x is deprecated and will be dropped in a future release.

AccuRev provides different plugins for JIRA 4 and JIRA 5, named AccuSyncJiraPlugin4.jar and AccuSyncJiraPlugin5.jar, respectively. These files are installed to the \jiraPlugin directory where you installed AccuSync (c:\Program Files (x86)\AccuSync\jiraPlugin\, for example).

Both plugins are what Atlassian refers to as Version 2 plugins. Version 2 plugins have different installation procedures than Version 1 plugins. For more information, refer to your JIRA documentation:

•	For JIRA 4: http://confluence.atlassian.com/display/JIRA040/Managing+JIRA's+Plugins

•	For JIRA 5: http://confluence.atlassian.com/display/JIRA050/Managing+JIRA's+Plugins

JIRA 6 users should use the JIRA 5 plugin.

How to Install the JIRA Plugin for AccuSync

1.	Stop the AccuSync server if it is running.

In Windows:

a.	Open the Services window.

For example: Type services.msc in the Windows Start Search box and then press Enter.

b.	Select the AccuSync service.

c.	Click Stop the service.

In Linux or Solaris:

Run shutdown.sh in the /bin directory where you installed AccuSync.

2.	Back up any existing AccuSync Configurations.

3.	Run the utility to update the AccuSync database.

In Windows:

Run update_db.bat in the \bin directory where you installed AccuSync.

In Linux or Solaris:

Run update_db.sh in the /bin directory where you installed AccuSync.

4.	Follow the instructions in your JIRA documentation for installing plugins:

•	For JIRA 4: http://confluence.atlassian.com/display/JIRA040/Managing+JIRA's+Plugins

•	For JIRA 5: http://confluence.atlassian.com/display/JIRA050/Managing+JIRA's+Plugins

JIRA 6 users should use the JIRA 5 plugin.

5.	Start the AccuSync server:

In Windows:

a.	Open the Services window.

For example: Type services.msc in the Windows Start Search box and then press Enter.

b.	Select the AccuSync service.

c.	Click Start the service.

Tip: If you have not already done so, consider changing the Startup Type to Automatic.

In Linux or Solaris:

Click the AccuSync_Server shortcut on your desktop.

Note: If shortcuts are not available on your desktop, start the AccuSync server manually by running startup.sh in the /bin directory where you installed AccuSync.