Using CA AppLogic › Appliance Developer Guide › Appliance OS Installations › Common Components › Windows APK › Halsign TurboGate PV Drivers › Upgrade Halsign TurboGate PV Drivers › Upgrade PV Drivers in Windows VDS Singleton Appliances

Upgrade PV Drivers in Windows VDS Singleton Appliances

We recommend that you first update the PV drivers in the generic Windows server appliance used to create the VDS singleton. You may then update the boot volume of the VDS singleton using its base class. The following steps describe the process for upgrading the singleton in a Windows VDS application, using the application VDS_Win08S_r2 as an example.

Follow these steps:

1. Configure the VDS_Win08S_r2 template application with the required mandatory values

   Add sufficient terminals such that the total terminal count, plus the internal interface, equals 8 for XEN and equals 10 for ESX.

2. If you are updating an appliance based on Windows Server 2008:
   • Add sufficient placeholder volumes such that the total volume count, including the boot volume, equals 4. Configure the new placeholder volumes to mount using drive letters, for example, K:\, L:\, M:\ as required.
   • Create sufficient volumes of type ntfs08 and size 50 MB to use for the placeholder volumes.
   • Configure the singleton instance and set the placeholder volumes to use the created volumes.
3. Save and start the application with the --debug option. If the appliance is based on Windows Server 2008 and was not prepared using a total of 4 volumes, then the appliance start may fail. Hence, the --debug option is used. An appliance start fail in this regard may be ignored.
4. From a 3t shell, ssh into the running singleton and do the following:
   • Set a new Administrator password, for example net user administrator newpwd.
   • ipconfig /all | grep 'DHCP Server' and note the IP address of the DHCP server for the internal interface.
   • cd / and then use wget to obtain the current TurboGate PV drivers installer from the grid controller using the IP address noted above, for example wget http://ip-address:8080/download/TurboGate-Tools-Setup-V3.0.1.exe
   • chmod 755 *.exe
5. Open the graphic console for the singleton and log in as Administrator.
6. Use the control panel to remove the outdated version of TurboGate PV drivers. The OS will blue screen mid-way through the program removal.
7. Restart the application --debug, open the graphic console for the singleton, log in as Administrator and use the control panel to remove the outdated version of TurboGate PV drivers. This time, there should not be a BSOD (blue screen of death). Do not reboot when requested.
8. Restart the application using the --debug option.
9. Open the graphic console for the singleton and log in as Administrator.
10. Install the latest Turbogate PV drivers by double-clicking on the installer in Windows Explorer. Do not reboot when prompted. Delete the PV driver installer and empty the recycle bin.
11. Restart the application using the --debug option.
12. Open the graphic console for the singleton and log in as Administrator. As required, complete the PV driver installation, for example, click through the hardware setup wizard. On Windows Server 2008 this typically means waiting until all the new devices are recognized and installed and a pop-up appears on the desktop asking to restart (select Restart Later).
13. Disable the service named gkservice. This service is installed with the PV drivers and fails to start if there is more than one virtual network interface associated to the appliance. Disabling this service does not affect the performance of the PV drivers.
14. From a 3t shell ssh to the singleton and execute:
    • rm -f /TurboGate*.exe
    • Set a new complex Administrator password, for example net user administrator a3893hf092jfww.^JDFoi8hfwehohgw
    • Exit and then ssh back into the running singleton
    • rm -f ~/.bash_history
    • Exit
15. Stop the application.
16. Unconfigure the template application and Save it.
17. Take the backup of template application