Error 500.19 on Jira Align Self-Hosted API Website and Swagger

Summary

In this document, you will see how to treat a Self-Hosted environment facing error 500 (500.19)when the user tries to access the Swagger URL meanwhile the Jira Align Website works properly.

Environment

Jira Align Self-Hosted

Diagnosis

Error Message and how to reproduce

• How to reproduce

  • Access your API application (Swagger): <Your Jira Align URL>/rest/align/api/docs/index.html

  • Blocked by error 500

• Error message sample:

  • 
  • 

Technical Summary

• Main Symptoms:

  • Error 500 once you try to access Jira Align or Jira Align Swagger Application not using detailed error view in IIS

    Reference: https://mid.as/kb/00211/how-to-enable-detailed-iis-errors#:~:text=To%20Enable%20detailed%20IIS%20Error,Select%20%22Detailed%20Errors%22

  • Error 500.19 once you’re using detailed errors with the following points:

    • Error Code = 0x8007000d

    • Config Error = Empty value

    • Config Source = No line reference or -1 and 0 (Meaning the error is before the webconfig opening)

      • 

    • Missing the entry C:\EnvironmentName\API2 started successfully by the IIS AspNetCoreModuleV2 into Event Viewer

      • 

    • Miss the IISAspNetCoreModeduleV2 in the source filter into the event viewer

      • Event Viewer> Application > Right Panel TBD

    • Missing the IISAspNetCoreModuleV2 DLL (Aspnetcore2.dll) installed into IIS folder

      • 

Cause

This error is caused due to a dependency or module not installed when you try to run an application according to Microsoft itself HTTP Error 500.19 - internal server error when you open an IIS Webpage.

Most precisely in our case, the module that rules API Application is IISAspNetCoreModuleV2.

This module comes from the ASP.NET Core Runtime 3.1.25 Hosting Bundle package and this error could be caused due to the wrong package installation

Note, it is documented in our official Self-Hosted document in the Software requirement section

Solution

• Download and install the ASP.NET Core Runtime 3.1.25 Hosting Bundle package from the original Microsoft website.

• Do an IIS Restart through CMD

  • 1 iisreset