====== OPNFV JIRA Permissions ======

The [[https://jira.opnfv.org|OPNFV JIRA instance]] uses your Linux Foundation ID for login.  This is the same ID as git, Gerrit and this Wiki.

If you can log in, by default you are a member of the ''jira-users'' group.

Only specific members of the Linux Foundation are members of the ''jira-administrators'' group.

===== JIRA Project Roles =====

Within each project there are three roles:

  - Administrators.  This role is able to:
    * create and manage Sprints, Versions and Components associated with the project
    * delegate and assign project roles to other users
    * view project Workflows, Issue Types, Notifications and Screens
  - Developers.  These users can:
    * Start, Stop and Complete progress on issues
    * Create and share filters
  - Users.  Can:
    * Create or comment on issues in the project

===== How are Roles Assigned? =====

Roles are seeded from the project's INFO file.  Initially:

  * Primary Contact: This user becomes the Project Lead
  * Committers: Each member becomes a part of the ''opnfv-gerrit-PROJECTNAME-submitters'' group
  * Contributors: Each member becomes a part of the ''opnfv-gerrit-PROJECTNAME-contributors'' group

Group to Role mapping:

^ Role ^ Group ^
| Administrators | jira-administrators, Project Lead |
| Developers | opnfv-gerrit-PROJECTNAME-submitters and opnfv-gerrit-PROJECTNAME-contributors |
| Users      | Anyone who can log in |

===== Project Role Administration ======

As only Project Administrators can change the role assignment, this means that the initial Primary Contact is the only one who can assign additional Project Administrators.

  - Log into JIRA
  - From the Projects drop down menu, choose your project
  - Administrators can see two tabs  {{:developer:screen_shot_2015-10-01_at_3.06.11_pm.png|}}
  - Select Administration.  On the nav panel on the left, scroll down to Roles and select that.
  - You will see a screen similar to the following:

{{:developer:screen_shot_2015-10-01_at_3.09.59_pm.png|}}

In this screenshot, the administrator clicked in the cell at the intersection of Administrators row and Users column.  From there additional Administrators can be added by simply typing their name into the box and clicking Update once complete.

Given the roles shown in the screenshot, Mark Beierl and Edgar St. Pierre can both create and start sprints for the StorPerf project, and anyone in the ''opnfv-gerritt-storperf-contributors'' or ''opnfv-gerritt-storperf-submitters'' groups can transition stories and tasks through workflows.

All other JIRA users can create and comment on StorPerf (or any other project) issues as needed.