Review and update the Jira 9 upgrade guides

XMLWordPrintable

    • Type: Suggestion
    • Resolution: Unresolved
    • None
    • Component/s: Documentation - All
    • None
    • 4

       The following link contains a recommendation that seems outdated:

      https://confluence.atlassian.com/adminjiraserver/upgrading-jira-manual-938846939.html

       

      Disable automatic reindex

       This step is recommended for the platform upgrade, that is when upgrading from 7.x to 8.x.

      Because of the changes to indexes that we've introduced in Jira 8.0, your old index is incompatible with the new version. To create a new one, Jira will trigger an automatic reindex right after you start it. To avoid reindexing twice (after startup and after upgrading your apps), you can disable the automatic reindex, and run the second one later, whenever you’re ready.

      1. Edit or create the following file:
        <jira-home-directory>/jira-config.properties
      1. Add the following line, and save the file:
        upgrade.reindex.allowed=false

         

      It seems that the section is valid only if you are upgrading from 7.x to 8.x, so, the customer upgrading from 8.x to 9.x may skip this, which will cause the reindex to be executed twice during the upgrade process.

      The document must be updated in the same manner as we see in Upgrading Jira Data Center to 9.4, as result of  JRASERVER-74957. The text should include:

      • Add these two JVM flags to the startup parameters:
        -Dcom.atlassian.jira.startup.allow.full.reindex=false
        -Dcom.atlassian.jira.startup.rebuild.local.index=false
        

      They can be added to the setenv.sh/bat in the "JVM_SUPPORT_RECOMMENDED_ARGS" variable.

      • Also keep-or-add this line to the jira-config.properties:
        upgrade.reindex.allowed=false
        

      Can you please adjust all "Upgrading Jira (manual)" for all 9.x versions?

            Assignee:
            Unassigned
            Reporter:
            Fernanda Gomes
            Votes:
            2 Vote for this issue
            Watchers:
            4 Start watching this issue

              Created:
              Updated: