Résolution des problèmes liés à l'agent EC2Launch v2

Cette section présente les scénarios de dépannage courants pour EC2Launch v2, les informations sur l’affichage des journaux d’évènements Windows, ainsi que la sortie et les messages du journal de la console.

Scénarios courants de résolution des problèmes

Cette section présente les scénarios de dépannage courants et les étapes de résolution.

Le service ne parvient pas à définir le fond d’écran

Le service ne parvient pas à exécuter les données utilisateur

Cause possible : le service peut avoir échoué avant l’exécution des données utilisateur.

Le service exécute une tâche une seule fois

Le service ne parvient pas à exécuter une tâche

Le service exécute les données utilisateur plus d’une fois

Résolution

Les données utilisateur sont traitées différemment entre EC2Launch v1 et EC2Launch v2. EC2Launch v1 exécute les données utilisateur en tant que tâche planifiée sur l’instance lorsque persist est défini sur true. Si persist est défini sur false, la tâche n’est pas planifiée même lorsqu’elle se termine avec un redémarrage ou est interrompue pendant son exécution.

EC2Launch v2 exécute les données utilisateur en tant que tâche d’agent et suit son état d’exécution. Si les données utilisateur entraînent un redémarrage de l’ordinateur ou si leur exécution est interrompue, l’état d’exécution pending persiste et les données utilisateur seront réexécutées au démarrage suivant de l’instance. Si vous souhaitez empêcher le script de données utilisateur de s’exécuter plusieurs fois, rendez le script idempotent.

L’exemple suivant de script idempotent définit le nom de l’ordinateur et joint un domaine.

<powershell>
  $name = $env:computername
  if ($name -ne $desiredName) {
	Rename-Computer -NewName $desiredName
  }
  $domain = Get-ADDomain
  if ($domain -ne $desiredDomain) 
  {
	Add-Computer -DomainName $desiredDomain
  }
  $telnet = Get-WindowsFeature -Name Telnet-Client
  if (-not $telnet.Installed)
  {
	Install-WindowsFeature -Name "Telnet-Client"
  }
</powershell>
<persist>false</persist>

Les tâches planifiées à partir d’EC2Launch v1 échouent après la migration vers EC2Launch v2

Résolution

L’outil de migration ne détecte aucune tâche planifiée liée aux scripts EC2Launch v1 ; par conséquent, il ne définit pas automatiquement ces tâches dans EC2Launch v2. Pour configurer ces tâches, modifiez le fichier agent-config.yml ou utilisez la boîte de dialogue des paramètres d’EC2Launch v2. Par exemple, si une tâche planifiée sur une instance exécute InitializeDisks.ps1, après avoir exécuté l’outil de migration, vous devez spécifier les volumes que vous souhaitez initialiser dans la boîte de dialogue des paramètres d’EC2Launch v2. Voir l’étape 6 de la procédure pour Modifier les paramètres à l’aide de la boîte de dialogue des paramètres EC2Launch v2.

Le service initialise un volume EBS qui n’est pas vide

Résolution

Avant d’initialiser un volume, EC2Launch v2 tente de détecter s’il est vide. Si un volume n’est pas vide, il ignore l’initialisation. Les volumes détectés comme non vides ne sont pas initialisés. Un volume est considéré comme vide si les 4 premiers Ko d’un volume sont vides ou si un volume n’a pas de disposition de lecteur reconnaissable par Windows. Un volume initialisé et formaté sur un système Linux n’a pas de disposition de lecteur reconnaissable par Windows, par exemple MBR ou GPT. Par conséquent, il sera considéré comme vide et initialisé. Si vous souhaitez conserver ces données, ne comptez pas sur la détection de lecteurs vides EC2Launch v2. Spécifiez plutôt les volumes que vous souhaitez initialiser dans la boîte de dialogue des paramètres EC2Launch v2 (voir étape 6) ou dans agent-config.yml.

La tâche setWallpaper n’est pas activée, mais le fond d’écran se réinitialise au redémarrage

La tâche setWallpaper crée le fichier de raccourci setwallpaper.lnk dans le dossier de démarrage de chaque utilisateur existant, sauf pour Default User. Ce fichier de raccourci s’exécute lorsque l’utilisateur se connecte pour la première fois après le démarrage de l’instance. Il configure l’instance avec un fond d’écran personnalisé qui affiche les attributs de l’instance. La suppression de la tâche setWallpaper ne supprime pas ce fichier de raccourci. Vous devez supprimer manuellement ce fichier ou le supprimer à l’aide d’un script.

Le chemin du raccourci est le suivant :

$env:SystemDrive/Users/<user>/AppData/Roaming/Microsoft/Windows/Start Menu/Programs/Startup/setwallpaper.lnk

Résolution

Supprimez manuellement ce fichier ou supprimez-le à l’aide d’un script.

Exemple de script PowerShell pour supprimer un fichier de raccourci

foreach ($userDir in (Get-ChildItem "C:\Users" -Force -Directory).FullName)
{
	$startupPath = Join-Path $userDir -ChildPath "AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup"
	if (Test-Path $startupPath)
	{
		$wallpaperSetupPath = Join-Path $startupPath -ChildPath "setwallpaper.lnk"
		if (Test-Path $wallpaperSetupPath)
		{
			Remove-Item $wallpaperSetupPath -Force -Confirm:$false
		}
	}
}

Service bloqué en mode d’exécution

Description

EC2Launch v2 est bloqué avec des messages de journaux (agent.log) similaires à ce qui suit :

2022-02-24 08:08:58 Info: *****************************************************************************************
2022-02-24 08:08:58 Info: EC2Launch Service starting
2022-02-24 08:08:58 Info: Windows event custom log exists: Amazon EC2Launch
2022-02-24 08:08:58 Info: ACPI SPCR table not supported. Bailing Out
2022-02-24 08:08:58 Info: Serial port is in use. Waiting for Serial Port...
2022-02-24 08:09:00 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:02 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:04 Info: ACPI SPCR table not supported. Use default console port.
2022-02-24 08:09:06 Info: ACPI SPCR table not supported. Use default console port.

Cause possible

SAC est activé et utilise le port série. Pour plus d’informations, consultez Utilisation de SAC pour dépanner votre instance Windows.

Résolution

Essayez les étapes suivantes pour résoudre ce problème :

agent-config.yml non valide empêche l’ouverture de la boîte de dialogue des paramètres EC2Launch v2

Description

Les paramètres EC2Launch v2 tentent d’analyser le fichier agent-config.yml avant d’ouvrir la boîte de dialogue. Si le fichier de configuration YAML ne suit pas le schéma pris en charge, la boîte de dialogue affiche l’erreur suivante :

Unable to parse configuration file agent-config.yml. Review configuration file. Exiting application.

task:executeScript should be unique and only invoked once

Description

Une tâche ne peut pas être répétée dans la même étape.

Résolution

Certaines tâches doivent être entrées sous forme de tableau, telles que executeScript et executeProgram. Pour obtenir un exemple de la façon d’écrire le script en tant que tableau, consultez executeScript.

Journaux d’événements Windows

EC2Launch v2 publie les journaux des évènements Windows pour les évènements importants, tels que le démarrage du service, Windows est prêt et la réussite et l’échec des tâches. Les identificateurs d’événement identifient de manière unique un événement particulier. Chaque événement contient des informations sur l’étape, la tâche et le niveau, ainsi qu’une description. Vous pouvez définir des déclencheurs pour des événements spécifiques à l’aide de l’identificateur d’événement.

Les ID d’événement fournissent des informations sur un événement et identifient de manière unique certains événements. Le chiffre le moins significatif d’un ID d’événement indique la gravité d’un événement.

Les événements liés au service qui sont générés au démarrage ou à l’arrêt du service incluent un identifiant d’événement à un seul chiffre.

Les messages d’événement pour les événements EC2LaunchService.exe commencent par Service:. Les messages d’événement pour les événements EC2Launch.exe ne commencent pas par Service:.

Les ID d’événement à quatre chiffres incluent des informations sur l’étape, la tâche et la gravité d’un événement.

Format de l’ID d’événement

Le tableau suivant indique le format d’un identificateur d’évènement EC2Launch v2.

Les lettres et les chiffres du tableau représentent le type d’événement et les définitions suivants.

Exemples d’ID d’événement

Voici des exemples d’ID d’événement.

Schéma du journal des événements Windows

Sortie du journal de la console EC2Launch v2

Cette section contient un exemple de sortie du journal de la console pour EC2Launch v2 et répertorie tous les messages d’erreur du journal de la console EC2Launch v2 pour vous aider à résoudre les problèmes. Pour plus d'informations sur la sortie de la console de l'instance et sur la manière d'y accéder, consultez Sortie de la console de l’instance.

Sortie du journal de la console EC2Launch v2

Voici un exemple de sortie du journal de la console pour EC2Launch v2.

2023/11/30 20:18:53Z: Windows sysprep configuration complete.
2023/11/30 20:18:57Z: Message: Waiting for access to metadata...
2023/11/30 20:18:57Z: Message: Meta-data is now available.
2023/11/30 20:18:57Z: AMI Origin Version: 2023.11.15
2023/11/30 20:18:57Z: AMI Origin Name: Windows_Server-2022-English-Full-Base
2023/11/30 20:18:58Z: OS: Microsoft Windows NT 10.0.20348
2023/11/30 20:18:58Z: OsVersion: 10.0
2023/11/30 20:18:58Z: OsProductName: Windows Server 2022 Datacenter
2023/11/30 20:18:58Z: OsBuildLabEx: 20348.1.amd64fre.fe_release.210507-1500
2023/11/30 20:18:58Z: OsCurrentBuild: 20348
2023/11/30 20:18:58Z: OsReleaseId: 2009
2023/11/30 20:18:58Z: Language: en-US
2023/11/30 20:18:58Z: TimeZone: UTC
2023/11/30 20:18:58Z: Offset: UTC +0000
2023/11/30 20:18:58Z: Launch: EC2 Launch v2.0.1643
2023/11/30 20:18:58Z: AMI-ID: ami-1234567890abcdef1
2023/11/30 20:18:58Z: Instance-ID: i-1234567890abcdef0
2023/11/30 20:18:58Z: Instance Type: c5.large
2023/11/30 20:19:00Z: Driver: AWS NVMe Driver v1.5.0.33
2023/11/30 20:19:00Z: SubComponent: AWS NVMe Driver v1.5.0.33; EnableSCSIPersistentReservations: 0
2023/11/30 20:19:00Z: Driver: AWS PV Driver Package v8.4.3
2023/11/30 20:19:01Z: Driver: Amazon Elastic Network Adapter v2.6.0.0
2023/11/30 20:19:01Z: RDPCERTIFICATE-SUBJECTNAME: EC2AMAZ-SO1T009
2023/11/30 20:19:01Z: RDPCERTIFICATE-THUMBPRINT: 1234567890ABCDEF1234567890ABCDEF1234567890
2023/11/30 20:19:09Z: SSM: Amazon SSM Agent v3.2.1705.0
2023/11/30 20:19:13Z: Username: Administrator
2023/11/30 20:19:13Z: Password: <Password>
1234567890abcdef1EXAMPLEPASSWORD
</Password>
2023/11/30 20:19:14Z: User data format: no_user_data	
2023/11/30 20:19:14Z: EC2LaunchTelemetry: IsTelemetryEnabled=true
2023/11/30 20:19:14Z: EC2LaunchTelemetry: AgentOsArch=windows_amd64
2023/11/30 20:19:14Z: EC2LaunchTelemetry: IsAgentScheduledPerBoot=true
2023/11/30 20:19:14Z: EC2LaunchTelemetry: AgentCommandErrorCode=0
2023/11/30 20:19:14Z: Message: Windows is Ready to use

Messages du journal de la console EC2Launch v2

Voici une liste de tous les messages du journal de la console EC2Launch v2.

Message: Error EC2Launch service is stopping. {error message}
 Error setting up EC2Launch agent folders
 See instance logs for detail
 Error stopping service
 Error initializing service
Message: Windows sysprep configuration complete
Message: Invalid administrator username: {invalid username}
Message: Invalid administrator password
Username: {username}
Password: <Password>{encrypted password}</Password>
AMI Origin Version: {amiVersion}
AMI Origin Name: {amiName}
Microsoft Windows NT {currentVersion}.{currentBuildNumber}
OsVersion: {currentVersion}
OsProductName: {productName}
OsBuildLabEx: {buildLabEx}
OsCurrentBuild: {currentBuild}
OsReleaseId: {releaseId}
Language: {language}
TimeZone: {timeZone}
Offset: UTC {offset}
Launch agent: EC2Launch {BuildVersion}
AMI-ID: {amiId}
Instance-ID: {instanceId}
Instance Type: {instanceType}
RDPCERTIFICATE-SUBJECTNAME: {certificate subject name}
RDPCERTIFICATE-THUMBPRINT: {thumbprint hash}
SqlServerBilling: {sql billing}
SqlServerInstall: {sql patch leve, edition type}
Driver: AWS NVMe Driver {version}
Driver: Inbox NVMe Driver {version}
Driver: AWS PV Driver Package {version}
Microsoft-Hyper-V is installed.
Unable to get service status for vmms
Microsoft-Hyper-V is {status}
SSM: Amazon SSM Agent {version}
AWS VSS Version: {version}
Message: Windows sysprep configuration complete
Message: Windows is being configured. SysprepState is {state}
Windows is still being configured. SysprepState is {state}
Message: Windows is Ready to use
Message: Waiting for meta-data accessibility...
Message: Meta-data is now available.
Message: Still waiting for meta-data accessibility...
Message: Failed to find primary network interface...retrying...
User data format: {format}