How do I debug a failed HealthCheck for Azure Agent installation?
The HealthCheck for Azure Windows Agent installer may fail during installation. Follow these steps to retry installing the HealthCheck for Azure Agent and generate log files to identify the cause of the failure:
- Download these diagnostic files:
- Save the files to the same directory on the machine you're installing the HealthCheck for Azure Agent on. For example, save the files to "C:\HealthCheck\".
- Click on the Windows Start button and search for Command Prompt.
- From the search results, right-click on the Command Prompt desktop application and click on Run as administrator.
- Type the following command, and press Enter to change the directory to the folder in which the AgentUtility.exe and AgentUtility.exe configuration files are stored:
- Type the following commands, and press Enter to stop the current HealthCheck for Azure Agent installation and uninstall all previous installations.
Note: These commands must be executed in order to retry installation.
- Type one of the following commands and press Enter to run the HealthCheck for Azure Agent installer with logging enabled:
- To install the HealthCheck for Azure Agent in quiet mode without dialog boxes:
msiexec /i CloudamizeAgent.msi customerkey=YOUR_KEY /qn /l*vx msi_log.txt
- To install the HealthCheck for Azure in standard mode with dialog boxes:
msiexec /i CloudamizeAgent.msi customerkey=YOUR_KEY /l*vx msi_log.txt
Note: These commands should return immediately without a message, and the installation process proceeds in the background. It normally takes several minutes to complete the agent installation.
- Two log files (msi_log.txt and log_backup.txt) are created after running the command above. The log files are saved to the directories listed below. These log files provide clues about why the installation failed, and should be shared with BitTitan Support to help diagnose the issue.
- On 64-bit machines: C:\Program Files (x86)\Cloudamize\
- On 32-bit machines: C:\Program Files\Cloudamize\
Note: The log_blackup.txt file is only created if the HealthCheck for Azure installer starts. The file is not created if the installer fails to start.
- Run the following command to confirm that the installation has succeeded: