Blog Author
Nutanix cluster has build-in tool called Nutanix Guest Tool ( NGT ) need to install in Windows and Linux VMs for extra functionality like VM Mobility, VSS, File level restore etc.
But while installing Nutanix Guest tool ( NGT ) in Windows VM get failure errors like Nutanix VM Mobility Setup Fails with the Error Status : 1603 error , service failure, Invalid Function error, guest agent service wrapper.py installation failed error.
You can check Nutanix Guest Tool ( NGT ) logs in following path
C:\Program Files\Nutanix\config\*
Logs will be like this Example :
ExecuteSilently: Command = cmd.exe /c ""C:\Program Files\Nutanix\Python27\python.exe" "C:\Program Files\Nutanix\python\bin\guest_agent_service_wrapper.py" "--startup=Auto" "install"" ExecuteSilently: Exit code: 0x1 ExecuteSilently: Error message: Incorrect function. MSI (s) (84:58) [07:41:49:739]: Leaked MSIHANDLE (24) of type 790531 for thread 14088 MSI (s) (84:58) [07:41:49:739]: Note: 1: 2769 2: InstallGuestAgent 3: 1 MSI (s) (84:58) [07:41:49:739]: Note: 1: 2205 2: 3: Error MSI (s) (84:58) [07:41:49:739]: Note: 1: 2228 2: 3: Error 4: SELECT `Message` FROM `Error` WHERE `Error` = 2769 MSI (s) (84!08) [07:41:49:786]: Note: 1: 2205 2: 3: Error MSI (s) (84!08) [07:41:49:786]: Note: 1: 2228 2: 3: Error 4: SELECT `Message` FROM `Error` WHERE `Error` = 1709 MSI (s) (84!08) [07:41:49:786]: Product: Nutanix Guest Agent -- Incorrect function. cmd.exe /c ""C:\Program Files\Nutanix\Python27\python.exe" "C:\Program Files\Nutanix\python\bin\guest_agent_service_wrapper.py" "--startup=Auto" "install""
If you are facing the same above issue during Nutanix NGT tool installation and want to resolve this.
Then follow the steps to resolve this issue
Nutanix NGT Tool Troubleshooting
Nutanix NGT tool may have multiple reasons of installation failure error,
so we need to try many solutions to resolve this encounter problem.
Solution 1
Nutanix NGT tool installation required few services must be running in Windows VM as mentioned below
- Windows Installer service
- Windows Management Instrumentation service
What is Windows Installer Service
Windows Installer Service is Adds, modifies, and removes applications provided as a Windows Installer (*.msi, *.msp) package. If this service is disabled, any services that explicitly depend on it will fail to start.
What is Windows Management Instrumentation service
Windows Management Instrumentation service provides a common interface and object model to access management information about operating system, devices, applications and services. If this service is stopped, most Windows-based software will not function properly. If this service is disabled, any services that explicitly depend on it will fail to start.
Determine Windows services status
Step 1 : Login to target Windows VM, you want install Nutanix Guest Tool ( NGT )
Step 2 : Open Run command or CMD Commmand prompt and type
services.msc
Step 3 : Determine the Windows OS services status
As shown in screenshot red marked Windows services are not running
We have to start both Windows services manually to do right click on each service and click to start option
Step 4 : After successfully start the Windows services, Now try to install Nutanix Guest Tool ( NGT ) again.
If you don’t get success or display same error message display during NGT installation then switch to solution 2
Solution 2
Retrieve and reset the WMI repository by using the following steps.
Disable and stop the WMI service from an elevated command prompt.
sc config winmgmt start= disabled net stop winmgmt
Run the following commands.
winmgmt /salvagerepository %windir%\System32\wbem
winmgmt /resetrepository %windir$\System32\wbem
Re-enable the WMI service.
sc config winmgmt start= auto
Reboot the VM.
Retry the NGT install again.
If the problem persists, continue to rebuild the repository as follows.
Disable and stop the WMI service from an elevated CMD prompt.
sc config winmgmt start= disabled
net stop winmgmt
Rename the repository folder to repository.old.
Path: %windir%\System32\wbem\repository
Re-enable the WMI service.
sc config winmgmt start= auto
Reboot the VM and attempt re-install of NGT.
If the problem persists switch to solution 3
Solution 3
I would recommend to update the Windows OS to latest patches and take reboot of the Windows VM then try to install Nutanix Guest Tool ( NGT )
If the problem persists switch to solution 4
Solution 4
If the problem persists, Install fresh Windows VM and perform the Nutanix Guest Tool ( NGT ) install as a local administrator, attempt the install before joining to a domain.
If the problem persists switch to solution 5
Solution 5
If above 4 solutions didn’t work for you then download the latest Windows Operating System ISO Image from Microsoft website, create fresh VM then try to install Nutanix Guest Tool ( NGT ).
Conclusion
One solution out of 5 will 100% work depends on your virtualized Nutanix environment so try all described troubleshooting solutions and steps.
You will get success to install the Nutanix Guest Tool ( NGT ) in Windows VM.
Thanks to reach out on Hyper Hci Blog, I hope you learnt something new today.!
Useful Links
Blog Author