Blog Post

SQL Server Support Blog

5 MIN READ

SQL Server 2019 Installation Error - An error occurred for a dependency of the feature

Microsoft

Nov 11, 2019

After release of SQL Server 2019, one of our customer was trying to install SQL Server 2019 and encountered an error message. Since I was able to reproduce the issue in my lab, I contacted SSMS product group and they were kind enough to fix this issue very quickly. As of now, this is already called out in the release notes. The purpose of this blog is to show how to confirm if you are hitting the same issue. We would learn how to look at various log file and what are the error messages we need to look.

Issue Description:

Installation of SQL Server 2019 from removable media fails if SQL Server Management Studio 18.3 or earlier is installed. In my lab, I downloaded ISO from download center and mounted it. Here is the final screen shot showing installation failure.

When we click on the hyperlink on the screen, it opens up setup summary file which has this information about failed component. (Database Engine Services)

Detailed results:
Feature:                       Database Engine Services
Status:                        Failed
Reason for failure:            An error occurred for a dependency of the feature causing the setup process for the feature to fail.
Next Step:                     Use the following information to resolve the error, and then try the setup process again.

Next step is to look at Detail.txt file for any hint about dependent feature. (Search for “at Microsoft” keyword)

Target package: "E:\1033_ENU_LP\x64\setup\x64\sqlncli.msi"
InstallPackage: MsiInstallProduct returned the result code 1602.
No retry-able MSI return code detected.
ExecuteActionWithRetryHelper.Failed actionToExecute is 'Install_sqlncli_Cpu64_Action', stack trace    at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.<>c__DisplayClass2_0.<ExecuteActionWithRetryHelper>b__0()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionHelper(ActionWorker workerDelegate)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionWithRetryHelper(WorkflowObject metaDb, ActionKey action, ActionMetadata actionMetadata, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.InvokeAction(WorkflowObject metabase, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.PendingActions.InvokeActions(WorkflowObject metaDb, TextWriter loggingStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionEngine.RunActionQueue()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.<>c__DisplayClass2_0.<ExecuteActionWithRetryHelper>b__0()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionHelper(ActionWorker workerDelegate)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionWithRetryHelper(WorkflowObject metaDb, ActionKey action, ActionMetadata actionMetadata, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.InvokeAction(WorkflowObject metabase, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.PendingActions.InvokeActions(WorkflowObject metaDb, TextWriter loggingStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionEngine.RunActionQueue()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.Workflow.RunWorkflow(WorkflowObject workflowObject, HandleInternalException exceptionHandler)
   at Microsoft.SqlServer.Chainer.Infrastructure.Action.Execute(String actionId, TextWriter errorStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.<>c__DisplayClass2_0.<ExecuteActionWithRetryHelper>b__0()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionHelper(ActionWorker workerDelegate)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionWithRetryHelper(WorkflowObject metaDb, ActionKey action, ActionMetadata actionMetadata, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.InvokeAction(WorkflowObject metabase, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.PendingActions.InvokeActions(WorkflowObject metaDb, TextWriter loggingStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionEngine.RunActionQueue()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.Workflow.RunWorkflow(WorkflowObject workflowObject, HandleInternalException exceptionHandler)
   at Microsoft.SqlServer.Chainer.Infrastructure.Action.Execute(String actionId, TextWriter errorStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.<>c__DisplayClass2_0.<ExecuteActionWithRetryHelper>b__0()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionHelper(ActionWorker workerDelegate)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionWithRetryHelper(WorkflowObject metaDb, ActionKey action, ActionMetadata actionMetadata, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.InvokeAction(WorkflowObject metabase, TextWriter statusStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.PendingActions.InvokeActions(WorkflowObject metaDb, TextWriter loggingStream)
   at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionEngine.RunActionQueue()
   at Microsoft.SqlServer.Setup.Chainer.Workflow.Workflow.RunWorkflow(WorkflowObject workflowObject, HandleInternalException exceptionHandler)
   at Microsoft.SqlServer.Chainer.Setup.Setup.RunRequestedWorkflow()
   at Microsoft.SqlServer.Chainer.Setup.Setup.Run(String[] args)
   at Microsoft.SqlServer.Chainer.Setup.Setup.Start(String[] args)
   at Microsoft.SqlServer.Chainer.Setup.Setup.Main()
Error: Action "Install_sqlncli_Cpu64_Action" failed during execution.
Completed Action: Install_sqlncli_Cpu64_Action, returned False

…Trimmed lines…

MSI (s) (5C:3C) [06:42:01:134]: Note: 1: 1729
MSI (s) (5C:3C) [06:42:01:134]: Product: Microsoft SQL Server 2012 Native Client -- Configuration failed.

MSI (s) (5C:3C) [06:42:01:134]: Windows Installer reconfigured the product. Product Name: Microsoft SQL Server 2012 Native Client. Product Version: 11.4.7462.6. Product Language: 1033. Manufacturer: Microsoft Corporation. Reconfiguration success or error status: 1602.

From here we can see that issue is during installation of SQLNCLI (SQL Server Native Client) and error code is 1602. The log file associate is sqlncli_Cpu64_1

MSI (s) (5C:3C) [06:42:01:009]: Note: 1: 2203 2: E:\sqlncli.msi 3: -2147287038
MSI (s) (5C:3C) [06:42:01:009]: Source is incorrect. Unable to open or validate MSI package E:\sqlncli.msi.
MSI (s) (5C:3C) [06:42:01:009]: Note: 1: 2203 2: E:\sqlncli.msi 3: -2147287038
MSI (s) (5C:3C) [06:42:01:009]: Source is incorrect. Unable to open or validate MSI package E:\sqlncli.msi.
Please insert the disk:
MSI (s) (5C:3C) [06:42:01:025]: Note: 1: 2265 2: 3: -2147287035
MSI (s) (5C:3C) [06:42:01:025]: User policy value 'DisableRollback' is 0
MSI (s) (5C:3C) [06:42:01:025]: Machine policy value 'DisableRollback' is 0
Action ended 6:42:01: InstallFinalize. Return value 2.
MSI (s) (5C:3C) [06:42:01:025]: Note: 1: 2318 2:

There we can see an interesting error : “Please insert the disk”.

If we check control panel, I already have SQL Server Native Client and mind you, this was installed when I installed SSMS 18.1.

Solution:

By now you would have understood the reason of the blog. If you are seeing messages in various logs, which are shown above, then you can conclude that you are hitting the issue due to preinstalled SSMS. Here is the screenshot from the release notes.

https://docs.microsoft.com/en-us/sql/sql-server/sql-server-version-15-release-notes

Here are my additional notes.

We have seen this issue earlier when we have SSMS 18.3 already installed and SQL 2019 setup is invoked from ISO mounted as drive. It was combination of few situations.

SSMS 18.3 already installed AND
SQL Server 2019 Setup was running from a mounted ISO.

We have below workarounds:

On existing machines, where SSMS 18.3 or lower is already installed.

Uninstall SQL Server 2012 Native Client which got installed with SSMS. Then install SQL Server 2019. OR
Instead of running setup from mounted ISO, copy the content of media to a local drive or a network share and start setup.exe from those locations.

On new machines, where SSMS is NOT installed.

First install SQL Server 2019 and then install SSMS 18.3 OR
Install version of SSMS greater than 18.3.1 and then install SQL Server 2019

I hope this blog would help someone find solution without contacting Microsoft Product Support team. Please comment and let me know.

Cheers,
Balmukund Lakhani
Twitter @blakhani

Updated Dec 02, 2019

Version 2.0

Microsoft

Joined October 02, 2017

View Profile

SQL Server Support Blog

Follow this blog board to get notified when there's new activity

jnikaido
Copper Contributor
Nov 19, 2019
I was running into the same issue as you were with that cryptic error message and really no details when you look at the log it references. I did have SSMS installed from before (went from pre 18 versions all the way to the current one).

The solution that I went with was copying the ISO to a local drive and running it from there, then it worked without any problems. I was worried about removing the SQL Server 2012 Native Client to figure out if that broke anything. It also works if you partially were able to upgrade certain parts of SQL Server (like the shared components) and not tried to roll it back to the prior version when encountering the error the first time.

Thankfully your post was there to help me out when my brain failed to make the connection with the SSMS issue (since I was already running 18.4).
Balmukund-Lakhani
Microsoft
Apr 16, 2020
I think that's what I have documented.

"Instead of running setup from mounted ISO, copy the content of media to a local drive or a network share and start setup.exe from those locations."
sqltwins
Copper Contributor
Dec 01, 2019
It's perfect - it's so useful that this must be converted into a KB article!
Also, I understands that separating SSMS from core SQL Server installer provides flexibility, but frequent releases that block upgrades is not a good thing. Trust the SSMS team has taken a note of this and will be addressing the same.
User_RND_Seed
Copper Contributor
Mar 11, 2021
Restart your computer and run Setup again.
Balmukund-Lakhani
Microsoft
Apr 02, 2021
vaishalimehta - Thanks for the comment. I have sent you a private message to contact me directly to see what's going on.
A_Rahmati
Copper Contributor
Jul 24, 2021
Just copy files from ISO to a folder.
setup will show this error, every time you run it from ISO file...
Balmukund-Lakhani
Microsoft
Dec 01, 2019
sqltwins - Sure. Thanks for your comment.
blescher
Copper Contributor
Dec 12, 2019
Thank you so much! I can't imagine how many more hours I would've spent trying to figure the error out.
Halil Mollaoğlu
Copper Contributor
Jan 15, 2020
Thanks. This indeed should converted to a KB article.
gabrielasarbu
Copper Contributor
Feb 27, 2020
I have the same issue, but in my case the solution is not working. I had an Enterprise 2016 instance and trying an upgrade to 2019. I had SSMS 18.4 installed on the server. When my upgrade failed with the mentioned error (An error occurred for a dependency of the feature), i followed your instructions and uninstalled SQL Server 2012 Native Client, followed by a restart on the machine. Tried again from command prompt to run setup /action=repair /instancename=MSSQLSERVER and got another error:
Overall summary:
Final result: Failed: see details below
Exit code (Decimal): -2146232828
Exit facility code: 19
Exit error code: 5636
Exit message: Exception has been thrown by the target of an invocation.
Start time: 2020-02-27 11:18:27
End time: 2020-02-27 11:19:36
Requested action: Repair
Exception help link: https://go.microsoft.com/fwlink?LinkId=20476&ProdName=Microsoft+SQL+Server&Evtsrc=setup.rll&EvtID=50000&ProdVer=15.0.2000.5&EvtType=0x55494D32%400x11428655&EvtType=0x55494D32%400x11428655

The entire message is:
Configuration file: C:\Program Files\Microsoft SQL Server\150\Setup Bootstrap\Log\20200227_111827\ConfigurationFile.ini
Rules with failures or warnings:
Rules report file: C:\Program Files\Microsoft SQL Server\150\Setup Bootstrap\Log\20200227_111827\SystemConfigurationCheck_Report.htm
Exception summary:
The following is an exception stack listing the exceptions in outermost to innermost order
Inner exceptions are being indented
Exception type: System.Reflection.TargetInvocationException
Message:
Exception has been thrown by the target of an invocation.
HResult : 0x80131604
Data:
HelpLink.EvtType = 0x55494D32@0x11428655
DisableWatson = true
Stack:
at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
at Microsoft.SqlServer.Configuration.SetupExtension.ObjectDatastoreIntegration.SetInputSettingInputPropertiesOnObject(Object pendingObject, TextWriter loggingStream)
at Microsoft.SqlServer.Configuration.SetupExtension.ActionDatastoreIntegration.SetPropertiesOnRunningAction(ActionKey key, TextWriter loggingStream)
at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionMetadata.NotifyInExecution(ActionKey actionRunning, TextWriter loggingStream)
at Microsoft.SqlServer.Setup.Chainer.Workflow.ActionInvocation.ExecuteActionHelper(ActionWorker workerDelegate)
Inner exception type: System.ArgumentNullException
Message:
Value cannot be null.
Parameter name: InstallMediaPath
HResult : 0x80004003
Stack:
at Microsoft.SqlServer.Configuration.MsiExtension.InitializeMsiExtension.set_InstallMediaPath(String value)

Still struggling with this error..