Error 500.0 after upgrading Jira Align Self-Hosted if .NET Framework version is unsupported
Summary
After upgrading to Jira Align 10.110.0 or higher, a 500.0 error is returned by IIS when accessing the Jira Align website
Environment
Jira Align Self-Hosted
Diagnosis
The following error is displayed when accessing the site:
HTTP Error 500.0 - Internal Server Error. The page cannot be displayed because an internal server error has occurred
The following error is found in Microsoft Windows Event Viewer > Windows Logs > Application
Exception information:
Exception type: ConfigurationErrorsException
Exception message: The 'targetFramework' attribute in the <compilation> element of the Web.config file is used only to target version 4.0 and later of the .NET Framework (for example, '<compilation targetFramework="4.0">'). The 'targetFramework' attribute currently references a version that is later than the installed version of the .NET Framework. Specify a valid target version of the .NET Framework, or install the required version of the .NET Framework. (C:\JA_FXPCORP\JiraAlign\web.config line 13)
at System.Web.Compilation.MultiTargetingUtil.ValidateTargetFrameworkMoniker(String targetFrameworkMoniker)
at System.Web.Compilation.MultiTargetingUtil.InitializeTargetFrameworkName()
at System.Web.Compilation.MultiTargetingUtil.EnsureFrameworkNamesInitialized()
at System.Web.Compilation.BuildManager.Initialize()
at System.Web.Compilation.BuildManager.InitializeBuildManager()
at System.Web.HttpRuntime.HostingInit(HostingEnvironmentFlags hostingFlags, PolicyLevel policyLevel, Exception appDomainCreationException)
Cause
The problem can occur if Jira Align is running an unsupported version of .NET Framework. Beginning with 10.110.0, Jira Align requires .NET Framework 4.8.x
- To determine the installed .NET Framework version, see Determine which .NET Framework versions are installed - .NET Framework
Solution
Install .NET Framework 4.8.x → https://dotnet.microsoft.com/en-us/download/dotnet-framework/net48