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 IIS Web Server Appliance

Upgrade PV Drivers in Windows IIS Web Server Appliance

The following steps describe the process for upgrading a Windows IIS appliance, using /system_ms:IIS08S as an example.

Follow these steps:

1. Create a new application and open it in the Infrastructure Editor.
2. Drag an instance of the IIS08S appliance from the system_ms catalog onto the canvas and branch the class instance.
3. Modify the boundary of the singleton as follows:
   • Set the documentation URL to

     http://doc.3tera.net/AppLogicxx/CatFilerWindows08.html.

     where xx indicates the current version of CA AppLogic

   • 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.
4. Create sufficient volumes of type ntfs08 (ntfs03 for Windows Server 2003 based appliances) and size 50 MB to use for the placeholder volumes.
5. Configure the singleton instance and set the placeholder volumes to use the created volumes.
6. Save and start the application using 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.
7. Save and start the application.
8. 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
9. Open the graphic console for the singleton and log in as Administrator.
10. Use the control panel to remove the existing version 2.0 TurboGate PV drivers. The OS will blue screen mid-way through the program removal.
11. Restart the application --debug, open the graphic console for the singleton, log in as Administrator and use the control panel to remove the existing version 2.0 TurboGate PV drivers again. This time, there should not be a BSOD (blue screen of death). Do not reboot when requested.
12. Restart the application using the --debug option.
13. Open the graphic console for the singleton and log in as Administrator.
14. Install the v3.0.1 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.
15. Restart the application using the --debug option.
16. 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 2003 this typically means clicking through the Found New Hardware Wizard for each virtual network interface: No, not this time, Next, Install the software automatically, Next, Continue Anyway, Finish. 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).
17. 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.
18. Restart the application using the --debug option (you may have to wait for the previous restart to timeout). If you do not have a successful start, it is most likely the case that you are installing the PV drivers on a version of Windows Server 2008 and the original appliance was not properly prepped to include the placeholder volumes. If this is the case:
    • Open the graphic console for the singleton and log in as Administrator. Open a cmd.exe shell and start diskpart. For each disk which is offline:
      • sel disk # (use the appropriate number)
      • online disk
      • attr disk remove read-only (this attribute may not be set and therefore failure can be ignored)
    • Restart the application using the --debug option.
19. 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
20. Stop the application. In the infrastructure editor drag the singleton into the user catalog.
21. Execute the following commands in a 3t shell:

    class destroy /system_ms:IIS08S --force 
    

    (or move the existing class if you want to preserve it).

    class move /user:IIS08S /system_ms:IIS08S 
    

22. Destroy the application.