EC2Launch v2 version histories - Amazon Elastic Compute Cloud

EC2Launch v2 version histories

EC2Launch v2 version history

The following table describes the released versions of EC2Launch v2.

Version Details Release date
2.0.2046
  • Updated the wallpaper path in the agent-config.yml file to use the default operating system wallpaper path.

  • Added telemetry to monitor the locations where agent errors occurred.

  • Updated agent log messaging.

October 3, 2024
2.0.1981
  • Updated EC2Launch.exe CLI command error messages for non-Administrator users.

August 6, 2024
2.0.1948
  • Added telemetry to monitor usage of admin password options.

  • Modified EC2Launch permissions.

July 1, 2024
2.0.1924
  • Updated the EC2Launch Settings UI.

  • Updated the wallpaper CLI command.

  • Updated the EC2Launch installer.

June 10, 2024
2.0.1914
  • Add routes with unspecified gateway addresses (0.0.0.0 for IPv4 or :: for IPv6).

  • Always add both IPv4 and IPv6 routes.

  • Fixed an issue where the Administrator username was added to the agent-config.yml file when it wasn't specified.

  • Modified EC2Launch v2 permissions.

June 5, 2024
2.0.1881
  • Added an encrypted password option to setAdminAccount task.

  • Added CLI command to encrypt static password in agent-config.yml.

  • Fixed an issue where XML user data doesn't add PowerShell arguments when it runs with Administrator permissions. For more details, see How Amazon EC2 handles user data for Windows instances.

  • Adjusted PowerShell arguments for the executeScript task and user data scripts when they run with LocalSystem permissions. When arguments are empty, the agent uses the following default value: -ExecutionPolicy Unrestricted.

  • Prevented printing duplicate driver versions to the console log.

May 8, 2024
2.0.1815
  • Adjusted error handling to fail on critical setup issues before sysprep.

  • Fixed an issue where wallpaper and hostname tasks could use an incorrect IP address on instances with multiple IP addresses assigned to the primary network interface.

  • Wallpaper and hostname tasks changed to get private IP from IMDS first, then fail back to WMI if IMDS is disabled.

  • Fixed an issue with the initializeVolume task where sc1 volumes failed to initialize due to a transient error.

March 6, 2024
2.0.1739
  • Fixed an issue that prevented exit codes from being captured by executeScript tasks that were run as the Windows Administrator user.

January 17, 2024
2.0.1702
  • Restricted Telemetry.log permissions to read-execute only for standard users.

  • Configured the EC2Launch Windows service to restart on start-up failure.

  • Made add-routes failures actionable by logging route.exe stderr output.

  • Fixed an issue that occurs when route metrics are outside of the range [1, 9999].

  • Added wallpaper support to several new instance types.

  • Fixed an issue caused by user data scripts that run as the Windows Administrator user and send output to stderr.

January 4, 2024
2.0.1643
  • Updated the ebsnvme-id.exe tool to version 1.1.0.7.

  • Fixed an issue with receive side scaling (RSS) and receive queue depth settings on metal instance types that begin with 'metal-*', such as metal-48x1.

  • Removed telemetry event that reports on XML userdata commands that block the agent.

  • Updated setDnsSuffix task to limit domain name devolution based on registry entry: HKEY_LOCAL_MACHINE\System\CurrentControlSet\Services\Dnscache\Parameters\DomainNameDevolutionLevel.

  • Added a public task and CLI that adds network routes.

  • Note – This is the last version to officially support Windows Server 2012.

  • Note – This is the last version to officially support 32-bit operating systems.

October 4, 2023
2.0.1580
  • Changed the way that the launch agent handles errors when you modify log file permissions.

  • Added a timeout for connecting to the serial port. The timeout allows the launch agent to continue running if the serial port is in use.

September 5, 2023
2.0.1521
  • Deprecated the —block flag of the EC2Launch.exe reset and sysprep commands.

  • Updated EC2Launch.exe to detect and handle the reset and sysprep commands that are used in inline executeScript tasks. Those commands cause the agent to stop running after the executeScript task runs them.

  • Updated XML userdata scripts to run inline by default.

  • Enable XML userdata scripts to run detached with the new detach tag. For more details, see User data scripts.

  • Made the following changes to the agent log.

    • Updated agent log messages.

    • Removed executeScript content and output from the agent log.

    • Removed executeProgram arguments and output from the agent log.

  • Made the following changes to the console log.

    • Added EnableSCSIPersistentReservations value to the console log.

July 3, 2023
2.0.1303
  • Added additional error handling and log lines when adding network routes.

  • Allowed executeScript and executeProgram tasks in the PreReady stage.

  • Updated executeProgram task to generate output files similar to the output from the executeScript task. For more information, see executeProgram.

  • Added telemetry to monitor usage of blocking agent commands in XML user data.

May 3, 2023
2.0.1245
  • Improved visibility into crashes by logging crash call stacks in clear text.

  • Added the EventLog service as a startup dependency to fix a crash when the Amazon EC2Launch service starts up faster than the EventLog service.

  • Made XML user data run before PostReady stage from the agent config file (like EC2Launch v1 and EC2Config).

  • Added YAML user data version 1.1 to make user data run before PostReady stage from the agent config file (YAML user data version 1.0 runs after PostReady stage from the agent config file).

March 8, 2023
2.0.1173
  • Adds an optional feature to display instance tags on wallpaper. For more information, see setWallpaper .

  • Adds error handling when the security group for Elastic Graphics is not properly set up.

  • Fixes a timeout when the Instance Metadata Service is not enabled.

February 6, 2023
2.0.1121
  • Fixes an issue where a 404 error is printed to the wallpaper when no public IPv4 address is assigned.

  • Fixes an issue where the volume's file system is formatted as RAW instead of NTFS when its device's drive letter is set to D.

  • Fixes an issue where NVMe SSD volumes are incorrectly identified as EBS volumes.

  • Fixes an error when activating Windows when IMDS is disabled.

January 4, 2023
2.0.1082
  • Fixes an issue where the setWallpaper: privateIpAddress field is blank when IMDS is disabled.

  • Fixes an issue with setting the hostname to the private IPv4 address when IMDS is disabled.

  • Fixes an issue with initializing volumes on Windows Server 2012.

  • Fixes an issue with setting jumbo frames.

  • Fixes an error when no SSH key is specified at instance launch.

  • Fixes an error on Windows Server 2012 when Windows does not have a 'ReleaseId' registry key.

December 7, 2022
2.0.1011
  • Fixes logic for finding network adapter when PnPDeviceID is empty.

November 11, 2022
2.0.1009
  • Uses PCI segment information to select the console port.

November 8, 2022
2.0.982
  • Adds retry logic to get RDP information.

  • Fixes errors during volume initialization on d2.8xlarge instances.

  • Fixes issue where an incorrect network adapter can be selected after a reboot.

  • Removes false alarm error message when ACPI SPCR is unavailable.

October 31, 2022
2.0.863
  • Updates IMDS wait logic to make only IMDSv2 requests.

  • Adds logic to assign drive letter to volumes that are already initialized but not mounted.

  • Prints a more specific error message when key pair type is not supported.

  • Fixes 3010 reboot code bug.

  • Adds check for invalid base64-encoded user data.

July 6, 2022
2.0.698
  • Fixes typo in log output when executing scripts.

January 30, 2022
2.0.674
  • Telemetry uploads the enabled/disabled privacy control.

  • Fixes index out of bounds bug.

  • Removes wallpaper shortcuts during sysprep.

November 15, 2021
2.0.651
  • Adds logic to uninstall legacy agents during EC2Launch v2 installation.

  • Fixes list-volume CLI issue when root volume is not listed as volume 0.

October 7, 2021
2.0.592
  • Fixes bug to correctly report stage status.

  • Removes false alarm error messages when log files are closed.

  • Adds telemetry.

August 31, 2021
2.0.548
  • Adds leading zeros for hex IP hostname.

  • Fixes file permissions for enableOpenSsh task.

  • Fixes sysprep command crash.

August 4, 2021
2.0.470
  • Fixes bug in network stage to wait for DHCP to assign an IP to the instance.

  • Fixes bug with setDnsSuffix when SearchList registry key does not exist.

  • Fixes bug in DNS devolution logic in setDnsSuffix.

  • Adds network routes after intermediate reboots.

  • Allows initializeVolume to re-letter existing volumes.

  • Removes extra information from version subcommand.

July 20, 2021
2.0.285
  • Adds option to run user scripts in a detached process.

  • Legacy userdata (XML userdata) now runs in a detached process, which is similar behavior to the prior launch agent.

  • Adds CLI flag to the sysprep and reset commands, which allows them to block until the service stops.

  • Restricts the config folder permissions.

March 8, 2021
2.0.207
  • Adds optional hostName field to setHostName task.

  • Fixes reboot bug. Reboot tasks executeScript and executeProgram will be marked as running.

  • Adds more return codes to the status command.

  • Adds bootstrap service to fix startup issue when running on t2.nano instance type.

  • Fixes clean installation mode to remove files not tracked by installer.

February 2, 2021
2.0.160
  • Fixes validate command to detect invalid stage name.

  • Adds w32tm resync command in addroutes task.

  • Fixes issue with changing DNS suffix search order.

  • Adds check conditions to better report invalid user data.

December 4, 2020
2.0.153 Adds Sysprep functionality in UserData. November 3, 2020
2.0.146
  • Fixes issue with RootExtend on non-English AMIs.

  • Grants users group write permission to log files.

  • Creates MS Reserved partition for GPT volumes.

  • Adds list-volumes command and volume dropdown in Amazon EC2Launch settings.

  • Adds get-agent-config command for printing agent-config.yml file in yaml or json format.

  • Erases static password if no public key detected.

October 6, 2020
2.0.124
  • Adds option to display OS version on wallpaper.

  • Initializes encrypted EBS volumes.

  • Adds routes for VPCs with no local DNS name.

September 10, 2020
2.0.104
  • Creates DNS suffix search list if it does not exist.

  • Skips Hibernation if not requested.

August 12, 2020
2.0.0 Initial release. June 30, 2020

EC2Launch v2 migration tool version history

The following table describes the released versions of the EC2Launch v2 migration tool.

You can receive notifications when new versions of the EC2Launch v2 agent are released. For more information, see Subscribe to EC2 Windows launch agent notifications.

Version Details Release date
1.0.435
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.2046.

October 10, 2024
1.0.413
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1981.

August 9, 2024
1.0.412
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1948.

August 7, 2024
1.0.396
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1924.

June 11, 2024
1.0.394
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1914.

June 6, 2024
1.0.384
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1881.

May 8, 2024
1.0.358
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1815.

March 8, 2024
1.0.345
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1739.

January 18, 2024
1.0.342
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1702.

January 5, 2024
1.0.331
  • Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1643

  • Fix an error that occurs when running .Install.ps1 -DryRun.

  • Fix an issue where password configuration is incorrectly set to random during migration from EC2Config.

  • Fix an error that occurs if setWallpaper is set to False during migration from EC2Launch.

November 3, 2023
1.0.303 Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1580. September 14, 2023
1.0.286 Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1521. July 14, 2023
1.0.272 Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1303. May 3, 2023
1.0.262 Update migration tool with the latest version of the EC2Launch v2 agent: 2.0.1245. March 9, 2023
1.0.241 Increments the version number of the EC2Launch v2 agent to 2.0.1011. December 7, 2022
1.0.218
  • Validates Region value retrieved from instance metadata.

  • Fixes migration failure bug in language packs.

  • Increments the version number of the EC2Launch v2 agent to 2.0.863.

September 3, 2022
1.0.162
  • Moves logic to remove legacy agents to the EC2Launch v2 MSI.

  • Increments the version number of the EC2Launch v2 agent to 2.0.698.

March 18, 2022
1.0.136 Increments the version number of the EC2Launch v2 agent to 2.0.651. October 13, 2021
1.0.130 Increments the version number of the EC2Launch v2 agent to 2.0.548. August 5, 2021
1.0.113 Uses IMDSv2 in place of IMDSv1. June 4, 2021
1.0.101 Increments the version number of the EC2Launch v2 agent to 2.0.285. March 12, 2021
1.0.86 Increments the version number of the EC2Launch v2 agent to 2.0.207. February 3, 2021
1.0.76 Increments the version number of the EC2Launch v2 agent to 2.0.160. December 4, 2020
1.0.69 Increments the version number of the EC2Launch v2 agent to 2.0.153. November 5, 2020
1.0.65 Increments the version number of the EC2Launch v2 agent to 2.0.146. October 9, 2020
1.0.60 Increments the version number of the EC2Launch v2 agent to 2.0.124. September 10, 2020
1.0.54
  • Installs EC2Launch v2 if no agents are installed.

  • Increments the version number of the EC2Launch v2 agent to 2.0.104.

  • Decouples the SSM agent.

August 12, 2020
1.0.50 Removes NuGet dependency. August 10, 2020
1.0.0 Initial release. June 30, 2020