Uploaded image for project: 'Jira Data Center'
  1. Jira Data Center
  2. JRASERVER-64178

update JIRA 7.3 connecting to MySQL database documenation around 'default_storage_engine'

      Summary

      JIRA 7.3.x startup logs have this warning:

      2017-02-15 20:09:18,384 JIRA-Bootstrap WARN      [c.a.j.appconsistency.db.MySqlConnectionUrlCheck] You have an error in your dbconfig.xml file. Missing "default_storage_engine" in connection url. The "storage_engine" parameter is deprecated and should be replaced with  "default_storage_engine".Please refer to the https://docs.atlassian.com/jira/jadm-docs-073/Connecting+JIRA+applications+to+MySQL.
      2017-02-15 20:09:20,136 JIRA-Bootstrap INFO      [c.a.jira.startup.DatabaseChecklistLauncher] JIRA database startup checks completed successfully.
      

      The dbconfig.xml has the entry of:

          <url>jdbc:mysql://127.0.0.1:3306/jiradb?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=storage_engine=InnoDB</url> 
      

      The problem is that the warning log is pointing users to Connecting JIRA applications to MySQL - Atlassian Documentation But that documentation does not explicitly tell users how/where to use the new "default_storage_engine" variable. it is still using the previous 'storage_engine' in all examples and explanations there. I suspect that this replaces the previous/deprecated 'storage_engine', but this document should be updated to reflect the correct settings for JIRA 7.3.x, and update the sample dbconfig.xml on that document.

      Environment

      • JIRA 7.3.x and above
      • MySQL database

      Steps to Reproduce

      1. Set up JIRA 7.3.x to run with MySQL database as per Connecting JIRA applications to MySQL - Atlassian Documentation.
      2. Check the log file during JIRA startup.

      Expected Results

      JIRA is started with no warning or error for the database connection.

      Actual Results

      The below exception is thrown in the atlassian-jira.log file:

      2017-02-15 20:09:18,384 JIRA-Bootstrap WARN      [c.a.j.appconsistency.db.MySqlConnectionUrlCheck] You have an error in your dbconfig.xml file. Missing "default_storage_engine" in connection url. The "storage_engine" parameter is deprecated and should be replaced with  "default_storage_engine".Please refer to the https://docs.atlassian.com/jira/jadm-docs-073/Connecting+JIRA+applications+to+MySQL.
      2017-02-15 20:09:20,136 JIRA-Bootstrap INFO      [c.a.jira.startup.DatabaseChecklistLauncher] JIRA database startup checks completed successfully.
      

      Workaround

      Edit the database URL to:

          <url>jdbc:mysql://127.0.0.1:3306/jiradb?useUnicode=true&amp;characterEncoding=UTF8&amp;sessionVariables=default_storage_engine=InnoDB</url> 
      

      Replace storage_engine to default_storage_engine.

          Form Name

            [JRASERVER-64178] update JIRA 7.3 connecting to MySQL database documenation around 'default_storage_engine'

            Bugfix Automation Bot made changes -
            Minimum Version New: 7.03
            Owen made changes -
            Workflow Original: JAC Bug Workflow v2 [ 2847054 ] New: JAC Bug Workflow v3 [ 2918841 ]
            Status Original: Resolved [ 5 ] New: Closed [ 6 ]
            Owen made changes -
            Symptom Severity Original: Minor [ 14432 ] New: Severity 3 - Minor [ 15832 ]
            Owen made changes -
            Workflow Original: JIRA Bug Workflow w Kanban v7 - Restricted [ 2587833 ] New: JAC Bug Workflow v2 [ 2847054 ]
            Ignat (Inactive) made changes -
            Workflow Original: JIRA Bug Workflow w Kanban v6 - Restricted [ 1652594 ] New: JIRA Bug Workflow w Kanban v7 - Restricted [ 2587833 ]
            Wazza made changes -
            Resolution New: Fixed [ 1 ]
            Status Original: Verified [ 10005 ] New: Resolved [ 5 ]
            Bugfix Automation Bot made changes -
            UIS Original: 5 New: 4
            SET Analytics Bot made changes -
            Support reference count Original: 7 New: 9
            UIS Original: 3 New: 5
            Robin Reidl (Inactive) made changes -
            Rank New: Ranked higher
            Robin Reidl (Inactive) made changes -
            Sprint New: Sprint 40 [ 4762 ]

              wthompson Wazza
              aheinzer Andy Heinzer
              Affected customers:
              6 This affects my team
              Watchers:
              13 Start watching this issue

                Created:
                Updated:
                Resolved: