Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# BOOTSTRAP\$1FAILURE\$1BA\$1DOWNLOAD\$1FAILED\$1PRIMARY
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY"></a>

## Présentation de
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY_overview"></a>

Un cluster se termine avec l'erreur `BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY` lorsque l'instance principale ne parvient pas à télécharger un script d'action d'amorçage depuis l'emplacement Amazon S3 que vous spécifiez. Les causes sont généralement les suivantes :
+ Le fichier de script d'action d'amorçage ne se trouve pas à l'emplacement Amazon S3 spécifié.
+ Le rôle de service pour les instances Amazon EC2 du cluster (également appelé *profil d'instance EC2 pour Amazon EMR*) n'est pas autorisé à accéder au compartiment Amazon S3 où réside le script d'action d'amorçage. Pour de plus amples informations sur les rôles de service, veuillez consulter [Rôle de service pour les instances EC2 de cluster (profil d'instance EC2)](emr-iam-role-for-ec2.md).

Pour plus d'informations sur les actions d'amorçage, consultez [Créez des actions bootstrap pour installer des logiciels supplémentaires avec un cluster Amazon EMR](emr-plan-bootstrap.md).

## Résolution
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY_resolution"></a>

Pour résoudre cette erreur, assurez-vous que votre instance principale dispose d'un accès approprié au script d'action d'amorçage.

Pour dépanner le cluster EMR défaillant, reportez-vous aux informations renvoyées `ErrorDetail` par le et. `DescribeCluster` `ListClusters` APIs Pour de plus amples informations, veuillez consulter [Codes d'erreur contenant ErrorDetail des informations dans Amazon EMR](emr-troubleshoot-error-errordetail.md). Le tableau `ErrorData` dans `ErrorDetail` renvoie les informations suivantes pour ce code d'erreur :

**`primary-instance-id`**  
ID de l'instance principale où l'action d'amorçage a échoué.

**`bootstrap-action`**  
Numéro ordinal de l'action d'amorçage qui a échoué. Un script dont la valeur `bootstrap-action` est égale à `1` est la première action d'amorçage exécutée sur l'instance.

**`amazon-s3-path`**  
L'emplacement sur Amazon S3 de l'action d'amorçage qui a échoué.

**`public-doc`**  
URL publique de la documentation du code d'erreur.

## Étapes à suivre
<a name="BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY_stc"></a>

Procédez comme suit pour identifier et corriger la cause première de l'erreur d'action d'amorçage. Lancez ensuite un nouveau cluster.

**Étapes de résolution des problèmes**

1. Utilisez la valeur `amazon-s3-path` du tableau `ErrorData` pour trouver le script d'action d'amorçage approprié dans Amazon S3.

1. Si vous avez activé les journaux de cluster lors de la création de l'instance, consultez le journal `stdout`pour plus d'informations. Vous pouvez trouver le journal `stdout` de l'action d'amorçage dans cet emplacement Amazon S3 : 

   ```
   s3://amzn-s3-demo-bucket/logs/Your_Cluster_Id/node/Primary_Instance_Id/bootstrap-actions/Failed_Bootstrap_Action_Number/stdout.gz 
   ```

   Pour plus d'informations sur les journaux de clusters, consultez [Configuration de la journalisation et du débogage du cluster Amazon EMR](emr-plan-debugging.md).

1. Pour déterminer l'échec de l'action d'amorçage, passez en revue les exceptions dans les journaux `stdout`et la valeur `return-code` dans `ErrorData`.

1. Utilisez les résultats de l'étape précédente pour revoir votre action d'amorçage afin qu'elle évite les exceptions ou qu'elle puisse gérer les exceptions correctement lorsqu'elles se produisent.

1. Lancez un nouveau cluster avec votre action d'amorçage mise à jour.