JIRA Agile ドキュメント

Jira Agile 6.3
GreenHopper 6.2
GreenHopper 6.1

More...

Agile Knowledge Base Resources

子ページ
  • How To Fix Duplicate Rank Values For a Rank Field
メタデータの末尾にスキップ
メタデータの先頭に移動

症状

One or more of the below symptoms may apply to JIRA Agile:

  • Ranking operations are not possible.
  • The balance job is never completed.

診断

If using JIRA Agile 6.7.0 or higher, use the LexoRank Management tool to run an integrity check. Otherwise, access <JIRA_BASE_URL>/rest/greenhopper/1.0/lexorank/integrity - for example https://jira.atlassian.com/rest/greenhopper/1.0/lexorank/integrity. You must be an admin to run this.

(info) It may help to copy/paste the results into something like jsonprettyprint.com as it will make it easier to read.

If the rank integrity checker doesn't pass on Duplicate Ranks Check, this KB will apply.

        ....
		{
          "name": "Duplicate ranks check",
          "description": "Checks if there are any duplicate rank values for a rank field.",
          "passed": false,
          "failureReason": "Detected duplicate ranks for rank field 15201 : {0|11t9b4:=2, 0|11sqnc:=2, 0|11suow:=2, 0|11tm0w:=2, 0|11thk8:=2, 0|11spog:=2, 0|11tes0:=2, 0|11sx00:=2, 0|11t2qg:=2, 0|11sqx4:=2, 0|11tde8:=2, 0|11t9zc:=2, 0|11sxcw:=2, 0|11ssi0:=2, 0|11teqo:=2, 0|11tlm0:=2, 0|11t140:=2, 0|11tbp4:=2, 0|11tg5s:=2, 0|11srhs:=2, 0|11t03s:=2, 0|11t4bc:=2, 0|11taow:=2, 0|11td48:=2}",
          "fatal": false
        },
		....

ソリューション

  • There is a REST endpoint that can be accessed, which will automatically heal the duplicate records.
  • This must be run as a System Administrator, which is defined in one of the groups as per Managing Global Permissions.
  • The endpoint requires a PUT, which is not something a browser can do without an additional plugin.
  • A PUT can also be done by executing it on the command line using cURL.

Browser Plugin

  1. Install Postman - REST client.
  2. Load it up and put in the URL <JIRA_BASE_URL>/rest/greenhopper/1.0/lexorank/duplicates, for example https://jira.atlassian.com/rest/greenhopper/1.0/lexorank/duplicates.
  3. Ensure the Content Type is set to JSON, otherwise errors will occur. The screenshot below illustrates the configuration.
  4. Submit the command and then run the Integrity Check again.

Command Line

(warning) This requires cURL to be installed. The installation is platform-specific, and can be downloaded from http://curl.haxx.se/download.html.

Run the below, replacing admin:password with the appropriate administrative user and their password, and populating <JIRA_BASE_URL> appropriately.

curl -X PUT <JIRA_BASE_URL>/rest/greenhopper/1.0/lexorank/duplicates -u admin:password
Help us improve!

3 Comments

  1. I cannot find the "rank integrity checker" anywhere in JIRA admin - where is it?

    And can I clean up duplicates if the mapping task is still running?

    1. See Troubleshooting New Ranking System Issues for more info about the rank integrity checker

    2. Apologies for the delayed in respond. The rank integrity checker, balance job and duplicate job can only be invoked through REST endpoint. I have attached a sample call through a Google Postman - REST client above.

      Is by mapping task you mean balance job? If it is, I would advise to run this separately – the duplicate job before the balance job whenever possible.