Microsoft Dynamics AX update installer throws an exception.

I recently had the following error show up in my queue.

An unexpected exception occurred during setup. See the log file C:\ProgramData\Microsoft\Dynamics AX\Dynamics AX Setup Logs\2016-02-03 22-34-07\DynamicsSetupLog.txt for details.

The log had the following.

Exception: System.ArgumentOutOfRangeException

Message: The parameter value must be greater than zero.
Parameter name: textLength

FullText: System.ArgumentOutOfRangeException: The parameter value must be greater than zero.

I myself had encountered this (or similar) error when installing some hotfixes. At the time I would review the log and determined whatever had caused it hadn’t affected the installation of the hotfix so I continued working, thinking it was likely a minor issue with our internal test VM.

When I saw that a customer had reported the issue it provided an opportunity to look into it further in case there was an larger issue. Unfortunately, there wasn’t much I could look into so I confirmed that I could reproduced the above error and submitted it to our InMarket Development team to investigate.

They were able to determine that it was an issue stemming from WPF and not something specific to installing the Dynamics AX hotfix. In their testing, restarting the installer or the machine, the same installer wouldn’t throw the error. Unfortunately, this also meant that we didn’t currently have a fix for the issue other than to provide some education on what was causing the issue.

Hence this blog. 🙂

So if you encounter the above error when installing an update to Dynamics AX, you have the following options.

  • Verify the model is installed (for an application fix) or the build number matches (for a kernel fix) – Recommended
  • Rollback/restore the database prior to install, run the installer again
  • Rollback/restore the database prior to install, restart the machine, run the installer again

Hope this helps!