AWS Systems Manager
User Guide

Walkthrough: Automatically Update PV Drivers on EC2 Windows Instances (Console)

Amazon Windows AMIs contain a set of drivers to permit access to virtualized hardware. These drivers are used by Amazon EC2 to map instance store and Amazon EBS volumes to their devices. We recommend that you install the latest drivers to improve stability and performance of your EC2 Windows instances. For more information about PV drivers, see AWS PV Drivers.

The following walkthrough shows you how to configure a State Manager association to automatically download and install new AWS PV drivers when the drivers become available.

Before You Begin

Before you complete the following procedure, verify that you have at least one Amazon EC2 Windows instance running that is configured for Systems Manager. For more information, see Systems Manager Prerequisites.

To create a State Manager association that automatically updates PV drivers

  1. Open the Amazon EC2 console, expand Systems Manager Services in the navigation pane, and then choose State Manager.

  2. Choose Create Association.

  3. In the Association Name field, type a descriptive name.

  4. In the Select Document list, choose AWS-ConfigureAWSPackage.

  5. In the Select Targets by section, choose an option.


    If you choose to target instances by using tags, and you specify tags that map to Linux instances, the association succeeds on the Windows instance, but fails on the Linux instances. The overall status of the association shows Failed.

  6. In the Schedule section, choose an option. Updated PV drivers are only released a few times a year, so you can schedule the association to run once a month, if you want.

  7. In the Parameters section, choose Install from the Action list.

  8. For Name list, enter AWSPVDriver. You can leave the Version field empty.

  9. In the Advanced section, choose Write to S3 if you want to write association details to an Amazon S3 bucket.

  10. Disregard the S3Region field. This field is deprecated. Specify the name of your bucket in the S3Bucket Name field. If want to write output to a sub-folder, specify the sub-folder name in the S3Key Prefix field.

  11. Choose Create Association, and then choose Close. The system attempts to create the association on the instance(s) and immediately apply the state. The association status shows Pending.

  12. In the right corner of the Association page, choose the refresh button. If you created the association on one or more EC2 Windows instances, the status changes to Success. If your instances are not properly configured for Systems Manager, or if you inadvertently targeted Linux instances, the status shows Failed.

  13. If the status is Failed, choose the Instances tab and verify that the association was successfully created on your EC2 Windows instances. If Windows instances show a status of Failed, verify that SSM Agent is running on the instance, and verify that the instance is configured with an IAM role for Systems Manager. For more information, see Systems Manager Prerequisites.