Difference between revisions of "Requirements Tracking"
Line 55: | Line 55: | ||
# Tags: associate words to requirements in order to simplify the lookup and grouping of requirements. | # Tags: associate words to requirements in order to simplify the lookup and grouping of requirements. | ||
# Impact (<span style="color:red">'''Mandatory'''</span>): choose the impact of your requirement | # Impact (<span style="color:red">'''Mandatory'''</span>): choose the impact of your requirement | ||
# Description: Description of the requirement. This part evolves and expands over time as the requestor and solution provider(s) investigate and identify particular needs. | # Description (<span style="color:red">'''Mandatory'''</span>): Description of the requirement. This part evolves and expands over time as the requestor and solution provider(s) investigate and identify particular needs. | ||
Revision as of 14:26, 31 January 2011
About this page
This page is only a draft.
This page provides technical details about the Requirement Tracker tool (RT), used by the EGI collaboration to store, monitor and resolve requirements and recommendations communcated by user communities and NGIs to EGI. The page provides manuals and background information to those who wish to
- Submit requirements and recommendations to EGI
- Browse requirements and monitor progress
- Expand or comment requirements
- Provide complete or partial solution to requirements
Introduction
The evolution of the European Grid Infrastructure is driven by the users. Therefore capturing and communicating feedback from users to the infrastructure as well as technology operators and providers is a key goal for User Community Support (NA3 activity of EGI-InSPIRE) and for the project as a whole. The EGI-InSPIRE project has established and runs a well-defined process to collect, capture, process, and resolve user requirements and recommendations. Requirements and recommendations are collected from users through various electronic channels and face-to-face communication mechanisms. A queue called "Requirements" hase been setup in the EGI RT (Request Tracker) system to store requirement tickets, to monitor user demands and to resolve problems. Throughout this page the term "Requirement Tracker" and the acronym "RT" refer to the "Requirements" queue of the EGI Request Tracker system.
The high level description of the requirement gathering and processing workflow of EGI can be found on this page and in this EGI-InSPIRE project Milestone Document.
Submitting a new requirement (ticket) to EGI
This manual describes how can any person with an EGI SSO account submit a requirement to EGI through the RT system: How to submit a new requirement.
Requirements are stored as tickets within the RT system. Such a ticket includes the following information (See also figure below):
- Subject (Mandatory): A short, but informative and, if possible, a unique name to describe the requirement.
- Category (Mandatory): Defines the particular software, human or other entity of the EGI collaboration that need to be changed as requested in the ticket.
- Requestor (Mandatory): Defines the entity (VRC, VO, NGI, etc.) that communicated the requirement to EGI. (This is not necessarily the same who will use the required new feature.)
- Tags: associate words to requirements in order to simplify the lookup and grouping of requirements.
- Impact (Mandatory): choose the impact of your requirement
- Description (Mandatory): Description of the requirement. This part evolves and expands over time as the requestor and solution provider(s) investigate and identify particular needs.
Browsing, monitoring requirements - Dashboards
Pre-defined queries, "Dashboards" are available for the RT system to browse requirement tickets and to monitor progress of solving them. All the dashboards are public and tickets are publicly visible through these Dashboards.
The RT system can host any number and type of Dashboards. Should your community require custom view to the requirements, please request the setup of a new Dashboard by sending an email to the User Community Support Team (ucst@egi.eu).
A complete list of Dashboards of the RT system: All Dashboards
List of all the requirements
Dashboard Name | Link | Description |
---|---|---|
All | All | This dashboard lists all the requirements that EGI is aware of and stores in the RT system |
Filtering requirements by the submitter
These Dashboards filter tickets by Submitter, i.e. by the potential VRC, NGI or other entity who submitted requirements.
Dashboards for science disciplines and more
Dashboard Name | Link | Description |
---|---|---|
WeNMR | WeNMR | Requirements from the WeNMR community: WeNMR (potential VRC) and enmr.eu (VO) |
Life Sciences Grid Community | Life Sciences Grid Community | Requirements from the Life Sciences Grid Community: Life Sciences Grid Community (potential VRC), biomed (VO), lsgrid (VO) and vlemed (VO) |
WLCG | WLCG | WLCG (potential VRC) requirements listing |
Astronomy & Astrophysics | Astronomy & Astrophysics | Astronomy & Astrophysics (potential VRC) requirements listing |
Computational Chemistry | Computational Chemistry | Computational Chemistry (potential VRC) requirements listing |
Earth Sciences | Earth Sciences | Earth Sciences (potential VRC) requirements listing |
eHumanities | eHumanities | eHumanities (potential VRC)requirements listing |
Hydro-meteorology | Hydro-meteorology | Hydro-meteorology (potential VRC) requirements listing |
Dashboards by Requirements Status
Dashboard Name | Link | Description |
---|---|---|
AllStatus | AllStatus | AllStatus tickets ordered by Status |
New | New | New Tickets |
Open | Open | Open Tickets |
Accepted | Accepted | Accepted Tickets |
Rejected | Rejected | Rejected Tickets |
Stalled | Stalled | Stalled Tickets |
Resolved | Resolved | Resolved Tickets |
Dashboard for Heavy User Communities (HUCs)
This Dashboard lists tickets that were submitted by HUCs. HUCs are User communities that are advanced and experienced in terms of grid usage, operate (at least to some extent) support services for their own members and therefore are less dependent on EGI user support services.
Dashboard Name | Link | Description |
---|---|---|
HUCs | HUCs | HUCs (Heavy User Communities) requirements listing |
Dashboard for National Grid Infrastructures (NGIs)
This Dashboard lists tickets that were submitted by NGIs. NGIs are National Grid Infrastructures/Initiatives those provide the resources within EGI.
Dashboard Name | Link | Description |
---|---|---|
NGIs | NGIs | NGIs (National Grid Infrastructures) requirements listing |
Virtual Organisations (VOs)
This Dashboard lists tickets that were submitted by VOs. A VO is a group of people with similar interests and requirements, who have physical access to the European Grid Infrastructure thus are able to work collaboratively with other members and/or can share resources regardless of geographical location. A VO can be associated to a VRC, or can exist independently from VRCs.
Dashboard Name | Link | Description |
---|---|---|
VOs | VOs | VOs (Virtual Organisations) requirements listing |
Projects
This Dashboard lists tickets that were submitted by projects that are part of the EGI community.
Dashboard Name | Link | Description |
---|---|---|
Projects | Projects | Projects requirements listing |
Filtering requirements by category
These Dashboards filter tickets based on the subject of the requirements (Subject here means the entity that the requirements refers to.)
Dashboard Name | Link | Description |
---|---|---|
Operational Tools | Operational Tools | Requirements for Grid Operational Tools that are developed by the JRA1 work package of EGI-InSPIRE |
UMD | UMD | Requirements for Unified Middleware Distribution (UMD) |
NA3 | NA3 | Requirements for software tools that are developed and/or provided by the NA3 work package of EGI-InSPIRE |
Expanding and commenting requirements
While the Subject, Requestor, Category, Tags and Description part of a requirement ticket cannot be changed, the submitter, solution provider(s) or any third party can attach comments and replies to tickets. Comments and replies are recorded in ticket history and both comments and replies are publicly visible. Comments are also sent by the RT system in email to the requestor (the person who submitted the requirement ticket), while comments are not sent in email. Comments and replies must be used to attach details and background information to a requirement ticket, to discuss the reported demand and possible solutions. Any user with an EGI SSO account can attach comments to requirement tickets. This process is described in this manual: Adding a comment to a requirementWrite this page. Insert a screenshot into it
Providing solution to a requirement
Comment: (in terms of requirements solving market there is a suggestion to make access right to take the ticket (become Owner of the ticket) for All SSO accounts. The Owner could indicate that ticket/requirement was taken and is in the solving process after the solution will be provided by the Owner.)
EGI requirements are resolved according to the following high level workflow:
- Consistency check
- Allocation to responsible person/group
- Completeness check
- Providing solution from the EGI-InSPIRE project
- Involving external solution providers
- Closing the ticket
- Validating the solution
Step # | Action | Responsible party | Description of action |
---|---|---|---|
1. | Consistency check | Delegate from User Community Support Team | Actions performed in this step:
Change values of fields if necessary. Contact submitter if necessary. |
2. | Formally accept the ticket | User Community Support Team | Formal acceptance of the ticket means:
|
3. | Evaluate the technical completeness and correctness of the request | Ticket owner | Evaluation at this stage means:
|
4. | Provide solution from the EGI-InSPIRE project | Ticket owner | |
5. | Involve external solution providers | Ticket owner | |
6. | Close the ticket | Ticket owner | |
7. | Validate the solution - IS THIS POSSIBLE? | Requestor |
TECHNICAL DETAILS OF TICKET MANAGEMENT
Status definitions
Requirements queue status values definitions:
- New = just arrived, no action taken yet (ticket must be Opened)
- Open = to be discussed (Ticket is allocated to a person/group. This person/group should attach a deadline to the ticket - e.g. when it will be discussed)
- Stalled = discussion/implementation is on hold for some reason
- Resolved = solved (validation may or may not have happened. There will be no "validated" status at the moment. If we need, we can add it later)
- Rejected = EGI discussed then rejected the request (reason of rejection must be attached to the ticket)
- Accepted = to be implemented (Requested feature/action will be implemented. The owner of the ticket is responsible for the implementation)
ops-tools-roadmap and user-tools-roadmap queues status values definitions:
- New = Feature that is not necessarily linked to any requirement yet. Feature that is not necessarily allocated to any release yet. (This status can be used for features that need to be discussed, finalised to meet a requirement/request)
- Open = Feature to be included in the next release (the feature is currently under development). The ticket must depend on at least one requirements ticket from the requirements queue
- Stalled = Feature to be included in some future release (not in the next release). The ticket must depend on at least one requirements ticket from the requirements queue
- Developed = The feature has been developed (responsibilities have to be defined to validate) is it pre-release or production release ?
- Resolved = Implemented (developed feature was validated and can be understood as solved issue)
- Rejected = EGI discussed then rejected the feature (because no related user requirement exists)
Status life cycle
Priority & Impact
- Impact of Requirement
The requestor/proposer of a new Requirement needs to assess the likely impact that the modification will have to users both within the immediate user community and EGI community at large. In turn, this will enable the work to satisfy the new Requirement to be correctly prioritised. The majority of new Requirements should normally be considered to be “Important with a significant benefit to this user community”.
- Impact categories:
- 4. - Essential to the effectiveness of this user community/the wider user community
- 3. - Important with a measurable benefit to this user community
- 2. - Useful – will be of some benefit to this user community
- 1. - Nice to have - slight improvement
- 0. - Don’t know
- Priority
The EGI.eu User Community Support Team will consider the new Requirement and prioritise any work effort as necessary in relation to other proposals.
Authorization
Requirements queue access rights
New Requirement
RT Web
Please refer to the New Requirement Manual.
Web Form
Requirement dependencies
Ticket in the Requirements queue can have the dependencies or be depended on by another ticket.
RT WEB UI Links section must be used for that.
i.e. for the existing ticket #111 which is Requirement we put the dependency for another ticket #222 which is Feature request in the user-tools-roadmap queue. The ticket #111 cant be Resolved untill ticket #222 will be Resolved or Rejected or Deleted.
All Tickets in Requirements queue RT at a Glance interface will have additional mark "(pending 1 other ticket)" if they have at least one dependency which is not Resolved or Rejected or Deleted.
Ticket Watchers
- Watchers - Wathers ref
Watcher is superset term for Requestors, Ccs and AdminCcs.
More details:
Watcher is a user who gets a copy of correspondence on the ticket.
Watcher (type CC) gets the same things as a Requestor.
Watcher (type AdminCC) gets the same things as CC + comments those are not sent to requestors.
Only Admins of the Queue can set up and remove the Watchers.
Ticket AdminCC & CC
- AdminCC & CC - AdminCC ref
An *AdminCC* is like a joint Owner of a Ticket. A ticket's AdminCCs are Users, typically Staff, who receive both Comments and Correspondence. A CC, who might be outside the company, only gets Correspondence.
This role could be used for a manager who is not directly responsible for a Ticket but wants to follow its progress and be able to comment on it or Reply to the Requestor.
A ticket's AdminCCs will have Rights to the ticket by virtue of being AdminCCs.
Firefox & ticket search
Create New Bookmark using these instructions:
1) go to firefox menu bar "Bookmarks"
2) choose "organize bookmarks"
3) choose "bookmarks menu"
4) right click on "bookmarks menu" -> "New Folder..." and fill the details below:
Location: https://rt.egi.eu/rt/Search/Results.html?Query=Queue %3D 'requirements' AND ( Subject LIKE '%s' OR Content LIKE '%s' )
Keyword: rt
Now you can search rt by typing 'rt [some search terms]' in the address bar of firefox.
- list all ticket those have custom tags:https://rt.egi.eu/rt/Search/Results.html?Query=Queue %3D 'requirements' AND 'CF.{Custom Tag}' is not NULL
RT RSS Feed
For Firefox use "Live Bookmark"