Users installing their Controller on a Windows machine may see the following error message on the installer screen:
Please resolve the errors and retry the operation.
A Microsoft Windows hotfix is required but is not detected on this system.
Please install the hotfix from http://support.microsoft.com/kb/2549760 and retry the operation.
This hotfix ensures that the windows registry modifications made by this installer to extend the default service timeouts work as expected.
If you are unable to install the hotfix, send the file C:\Users<Username?\AppData\Local\Temp\hotfix_status_XXXXXXX.txt and the installation log in your temp directory to AppDynamics support for assistance.
The error message appears when hotfix #2549760 has not been installed on the Windows server.
Solution
Bypass the hotfix validation during Controller installation:
- Launch a command prompt as an Administrator on your Windows machine.
- Run the Controller installer with a
-Vskip_validation=true flag to bypass the hotfix check.
- Example:
<controller_installer_name>.exe -Vskip_validation=true
Note: There is no loss of functionality without the hotfix, but be aware that until the hotfix is installed, users must stop all Controller services (including app and database) and ensure they have completely shut down before rebooting the Controller. This prevents database corruption which may be irreversible.
Installing the hotfix after successful Controller installation:
- Shutdown all Controller related services (app and database).
- Install the hotfix by running the following commands in a command prompt as an Administrator:
reg add HKLM\SYSTEM\CurrentControlSet\Control /v WaitToKillServiceTimeout /t REG_SZ /d 600000 /f
- Increase service stop timeouts
reg add HKLM\SYSTEM\CurrentControlSet\Control /v ServicesPipeTimeout /t REG_SZ /d 1200000 /f
- Increases service startup timeouts
- Start the controller services.
