Reinstall Xentools (Windows)

Available in VPC

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.

1. Preparations

Download the Xentools deletion file and the installation file.

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 2 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.
   
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.
     

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.

4. Running routing rule script

When you reinstall Xentools, the inner routing rule may disappear in some cases. To set the inner routing rule again, download and run the following execution files:

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

Check whether the routing rules for 169.254.0.0/16 are properly entered in Persistent Routes as follows:

5. 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)

Get-Service -Name Xen*

Status   Name               DisplayName                           
------   ----               -----------                           
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.

• Enter run - service.msc > check the service name and right-click > start the service

Status   Name               DisplayName
------   ----               -----------
Running  xenagent           XenServer Agent
Running  xenbus_monitor     XenServer PV Driver Monitor
Running  XenSvc             Citrix XenServer Windows Management

Check Xentools version

There are 3 ways to check the Xentools version. You can use any one you want.

• Method 1: check Major > Minor > Micro in PowerShell

  PS C:\Users\Administrator> REG QUERY "HKLM\SOFTWARE\Citrix\XenTools"
  
  HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XenTools
      InstallDir    REG_SZ    C:\Program Files\Citrix\XenTools\
      MajorVersion    REG_DWORD    0x9
      MinorVersion    REG_DWORD    0x3
      MicroVersion    REG_DWORD    0x0
      BuildVersion    REG_DWORD    0x49
      DisableAutoUpdate    REG_DWORD    0x1
  

• Method 2: check in the add/remove program menu
  
• Method 3: move to HKEY_LOCAL_MACHINE\SOFTWARE\Citrix\XenTools to check in Registry Editor