Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).



The BOOTSTRAP_FAILURE_FILE_NOT_FOUND_PRIMARY error indicates that the primary instance can’t find the bootstrap action script that the instance just downloaded from the specified Amazon S3 bucket.


To resolve this error, confirm that your primary instance has appropriate access to the bootstrap action script.

To troubleshoot the failed EMR cluster, refer to the ErrorDetail information returned from the DescribeCluster and ListClusters APIs. For more information, see Error codes with ErrorDetail information. The ErrorData array within ErrorDetail returns the following information for this error code:


The ID of the primary instance where the bootstrap action failed.


The ordinal number for the bootstrap action that failed. A script with a bootstrap-action value of 1 is the first bootstrap action to run on the instance.


The Amazon S3 location of the bootstrap action that failed.


The public URL of the documentation for the error code.

Steps to complete

Perform the following steps to identify and fix the root cause of the bootstrap action error. Then launch a new cluster.

  1. To find the relevant bootstrap action script in Amazon S3, use the amazon-s3-path value from the ErrorData array.

  2. Review the bootstrap action log files in Amazon S3 to identify the root cause for the failure. To learn more on how to view Amazon EMR logs, see View log files.


    If you didn't turn on logs for your cluster, you must create a new cluster with the same configurations and bootstrap actions. To ensure the cluster logs are turned on, see Configure cluster logging and debugging.

  3. Review the stdout log for your bootstrap actions and confirm that there are no custom processes that delete files in the /emr/instance-controller/lib/bootstrap-actions folder on your primary instances. You can find the stdout log for the bootstrap action in this Amazon S3 location:

  4. Launch a new cluster with your updated bootstrap action.