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 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.
   
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. Run routing rule script

When you reinstall Xentools, the inner routing rule may disappear in some cases. Reset the routing rule as you previously set it. To set the routing rule provided by NCP, download and run the file below.

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                           
------   ----               -----------                           
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 and then click on the Control Panel > Programs > Programs and Features menu in that order.