Amazon Elastic Compute Cloud
Microsoft Windows Guide (API Version 2014-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.Did this page help you?  Yes | No |  Tell us about it...

Upgrading PV Drivers on Your Windows AMI

Amazon Windows AMIs contain a set of drivers to permit access to Xen virtualized hardware. These drivers are used by Amazon EC2 to map the instance store and Amazon Elastic Block Store (Amazon EBS) volumes to the devices.

If your Windows instance uses RedHat drivers, you can upgrade to Citrix drivers, or, if you are already using Citrix drivers, you can upgrade the Citrix paravirtualized (PV) guest agent driver.

To verify which driver your Windows instance uses, open Network Connections in Control Panel and view the Local Area Connection. Check whether the driver is the RedHat PV NIC Driver or the Citrix PV Ethernet Adapter.

Upgrading PV Drivers on Your Windows Server 2003 Instance

Before you start upgrading your RedHat drivers to Citrix drivers, make sure you do the following:

To upgrade a Windows Server 2003 AMI

  1. Connect to your instance and log in as the local administrator. For more information about connecting to your instance, see Connecting to Windows Instances.

  2. In your instance, download the Citrix upgrade package by going to Amazon EC2 Windows Paravirtual Driver Upgrade Script.

  3. Extract the contents of the upgrade package to a location of your choice.

  4. Double-click the Upgrade.bat file. If you get a security warning, click Run.

  5. In the Upgrade Drivers dialog box, review the information and click Yes if you're ready to start the upgrade.

  6. In the Red Hat Paravirtualized Xen Drivers for Windows ® uninstaller dialog box, click Yes to remove the RedHat software. Your instance will be rebooted.

    Note

    If you do not see the uninstaller dialog box, click Red Hat Paravirtualiz… in the Windows taskbar.

    Red Hat Paravirtualized in taskbar
  7. Check that the instance has been rebooted and is ready to be used.

    1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

    2. On the Instances page, right-click your instance and select Get System Log.

    3. Check the end of the log message. It should read Windows is Ready to use.

  8. Connect to your instance and log in as the local administrator. The upgrade will continue by opening four applications: PowerShell, RedHat uninstaller, PVUpgrade.log and the Windows Device Manager.

  9. Uninstall the PCI BUS.

    1. In the Device Manager window, expand System devices, right-click PCI bus and click Uninstall.

      Device Manager
    2. When prompted, click OK.

    3. In the System Settings Change dialog, click No as you do not want to restart your instance immediately.

    4. Close Device Manager. The upgrade script reboots your instance.

  10. Check that the instance is ready by repeating the procedure in step 7. After you've confirmed it is ready, log in as the administrator.

  11. Confirm that the installation is complete. Navigate to the Citrix-WIN_PV folder that you extracted earlier, open the PVUpgrade.log file, and then check for the text INSTALLATION IS COMPLETE.

    PVUpgrade log file

Upgrading PV Drivers on Your Windows Server 2008 and 2008 R2 Instances

Before you start upgrading your RedHat drivers to Citrix drivers, make sure you do the following:

To upgrade a Windows Server 2008 or Windows Server 2008 R2 AMI

  1. Connect to your instance and log in as the local administrator. For more information about connecting to your instance, see Connecting to Windows Instances.

  2. In your instance, download the Citrix upgrade package by going to Amazon EC2 Windows Paravirtual Driver Upgrade Script.

  3. Extract the contents of the upgrade package to a location of your choice.

  4. Double-click the Upgrade.bat file. If you get a security warning, click Run.

  5. In the Upgrade Drivers dialog box, review the information and click Yes if you are ready to start the upgrade.

  6. In the Red Hat Paravirtualized Xen Drivers for Windows ® uninstaller dialog box, click Yes to remove the RedHat software. Your instance will be rebooted.

    Note

    If you do not see the uninstaller dialog box, click Red Hat Paravirtualiz… in the Windows taskbar.

    Red Hat Paravirtualized in taskbar
  7. Check that the instance has rebooted and is ready to be used.

    1. Open the Amazon EC2 console at https://console.aws.amazon.com/ec2/.

    2. On the Instances page, right-click your instance and select Get System Log.

    3. The upgrade operations should have restarted the server 3 or 4 times. You can see this in the log file by the number of times Windows is Ready to use is displayed.

      Windows system log
  8. Connect to your instance and log in as the local administrator.

  9. Close the Red Hat Paravirtualized Xen Drivers for Windows ® uninstaller dialog box.

  10. Confirm that the installation is complete. Navigate to the Citrix-WIN_PV folder that you extracted earlier, open the PVUpgrade.log file, and then check for the text INSTALLATION IS COMPLETE.

    PVUpgrade log file

Upgrading Your Citrix PV Guest Agent Driver

If you are using Citrix drivers on your Windows server, you can upgrade the Citrix PV guest agent driver. This driver runs as a Windows service, and handles tasks such as time synchronization at boot as well as shutdown and restart events from the API. You can run this upgrade package on any version of Windows Server, including Windows Server 2012.

Before you start upgrading your drivers, make sure you back up your important information on the instance, or create an AMI from the instance. For more information about creating an AMI, see Creating an Amazon EBS-Backed Windows AMI. If you create an AMI, make sure you do the following:

  • Do not enable the Sysprep tool in the EC2Config service.

  • Write down your password.

  • Set your Ethernet adapter to DHCP.

To upgrade your Citrix PV guest driver

  1. Connect to your instance and log in as the local administrator. For more information about connecting to your instance, see Connecting to Windows Instances.

  2. In your instance, download the Citrix upgrade package by going to Amazon EC2 Windows Paravirtual Driver Upgrade Script.

  3. Extract the contents of the upgrade package to a location of your choice.

  4. Double-click the Upgrade.bat file. If you get a security warning, click Run.

  5. In the Upgrade Drivers dialog box, review the information and click Yes if you are ready to start the upgrade.

  6. When the upgrade is complete, the PVUpgrade.log file will open and contain the text UPGRADE IS COMPLETE.

  7. Reboot your instance.

Troubleshooting

This topic addresses issues you may encounter with the Citrix PV driver on your Windows AMI.

TCP Offloading

By default, TCP offloading is enabled for the Citrix PV drivers in Windows AMIs. If you encounter transport-level errors or packet transmission errors (as visible on the Windows Performance Monitor)—for example, when you're running certain SQL workloads—you may need to disable this feature.

Note

Disabling TCP offloading may reduce the network performance of your instance.

To disable TCP offloading for Windows Server 2012 and 2008

  1. Connect to your instance and log in as the local administrator.

  2. If you're using Windows Server 2012, press Ctrl+Esc to access the Start screen, and then click Control Panel. If you're using Windows Server 2008, click Start and select Control Panel.

  3. Click Network and Internet, then Network and Sharing Center.

  4. Click Change adapter settings.

  5. Right-click Citrix PV Ethernet Adapter #0 and select Properties.

    Local area connection properties
  6. In the Local Area Connection Properties dialog box, click Configure... to open the Citrix PV Ethernet Adapter #0 Properties dialog box.

  7. On the Advanced tab, disable each of the following properties by selecting them in the Property list, and selecting Disabled from the Value list:

    • IPv4 Checksum Offload

    • Large Receive Offload (IPv4)

    • Large Send Offload Version 2 (IPv4)

    • TCP Checksum Offload (IPv4)

    Citrix PV Ethernet adapter properties
  8. Click OK.

To disable TCP offloading for Windows Server 2003

  1. Connect to your instance and log in as the local administrator.

  2. Click Start, and select Control Panel, then Network Connections, and then Local Area Connection 3.

  3. Click Properties.

  4. In the Local Area Connection 3 dialog box, click Configure... to open the Citrix PV Ethernet Adapter #0 Properties dialog box.

  5. On the Advanced tab, disable each of the following properties by selecting them in the Property list, and selecting Disabled from the Value list:

    • IPv4 Checksum Offload

    • Large Send Offload Version 1 (IPv4)

    • TCP Checksum Offload (IPv4)

    Citrix PV Ethernet adapter properties
  6. Click OK.