Reinstall Xentools (Windows)

Prev Next

Available in Classic

Xentools is a tool used to provide high-performance I/O service as an I/O driver and management agent of Windows server. It describes how to troubleshoot Xentools on a Windows server by uninstalling and reinstalling.

Caution
  • During re-installation of Xentools, you may experience the blue screen of death (BSOD).
  • See Create My server image to create a My server image for backup before troubleshooting.

1. Preparations

Download the Xentools deletion file and the installation file.

Note

To install Xentools, you need to have .Net Framework version 4.0 or higher installed on the server. Check the .Net Framework version before starting installation.

Downloading Xentools_Uninstall.exe file

Run the script in PowerShell to download the Xentools_Uninstall.exe file.

Start-BitsTransfer -Source "http://init.ncloud.com/xentools/windows/Xentools_Uninstall.exe" -Destination "c:\Xentools_Uninstall.exe"

Downloading Xentools installation file

Download a new Xentools installation file.
In the Windows server, you can download Xentools in two ways.

  • Method 1: view and download Xentools information on a Windows server through the Citrix Knowledge Center
  • Method 2: download the Xentools installation file through a repo on NAVER Cloud Platform
    # Downloading the latest-version Xentools
    Start-BitsTransfer -Source "http://init.ncloud.com/xentools/windows/managementagentx64-latest.msi" -Destination "c:\managementagentx64-latest.msi"
    

2. Delete Xentools

Delete the previously installed Xentools.

  1. Run the downloaded Xentools_Uninstall.exe file in administrator mode.
    compute-xentoolswindow-new-01
  2. While deleting Xentools, the server must be rebooted. When the pop-up appears for confirmation, click Yes only if you can reboot the server.
    • If you cannot reboot, click No to stop the Xentools deletion process.
      compute-xentoolswindow-new-02

3. Reinstall Xentools

Install Xentools again.

  • During the installation process, Network Driver installation may cause remote access to be lost and make re-connection difficult. If remote connection is not possible, connect from the console or reboot the server once and try again.
  • If the server status is frozen at "Restart," connect to the server and check if the Reboot pop-up has disappeared. Check also if the server has been rebooted twice or more after Xentools re-installation.
Caution
  • After re-installation is complete, the server must be rebooted for Xentools to be properly recognized.
  • Perform the reboot directly on the server, not on the console.
  • If you use Restart/Stop on NAVER Cloud Platform console without rebooting the server at least twice, the command may not work properly.

compute-xentoolswindow-new-03

compute-xentoolswindow-new-04

compute-xentoolswindow-new-05

compute-xentoolswindow-new-06

4. Check Xentools operation

Check if the reinstalled Xentools is operating properly. Check the operation status and version of the service.

Check Xentools operation status

Run the following command in PowerShell to check the operation status. The following 3 services should be marked as running. (based on version 9 or above)

Note

The DisplayName of XenSvc may vary depending on the version of Xentools.

Get-Service -Name Xen*
          
Status   Name               DisplayName                           
------   ----               -----------                           
Running  xenagent           XenServer Agent                       
Running  xenbus_monitor     XenServer PV Driver Monitor      
Running  XenSvc             Citrix VM Tools Management Agent  

If the status is not Running, run the service.

  • Execute cmd > enter service.msc > service name check and perform right-click > service start.

Check Xentools version

Check the Xentools version in the Add/Remove Programs menu. You can check it in one of two ways:

  • Enter cmd > appwiz.cpl.
  • Right-click on i-server_window_start and then click on the Control Panel > Programs > Programs and Features menu in that order.
Note

The names of Programs and Features may vary depending on the version of your operating system. (ex. Apps and Features)