기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# BOOTSTRAP\$1FAILURE\$1BA\$1DOWNLOAD\$1FAILED\$1PRIMARY
## 개요
기본 인스턴스가 지정한 Amazon S3 위치에서 부트스트랩 작업 스크립트를 다운로드할 수 없는 경우 클러스터는 `BOOTSTRAP_FAILURE_BA_DOWNLOAD_FAILED_PRIMARY` 오류로 종료됩니다. 잠재적 원인은 다음과 같습니다.
+ 부트스트랩 작업 스크립트 파일이 지정된 Amazon S3 위치에 없습니다.
+ 클러스터의 Amazon EC2 인스턴스에 대한 서비스 역할(*Amazon EMR의 EC2 인스턴스 프로파일*이라고도 함)에 부트스트랩 작업 스크립트가 있는 Amazon S3 버킷에 액세스할 권한이 없습니다. 서비스 역할에 대한 자세한 내용은 [클러스터 EC2 인스턴스에 대한 서비스 역할(EC2 인스턴스 프로파일)](emr-iam-role-for-ec2.md)을 참조하세요.
부트스트랩 작업에 대한 자세한 내용은 [부트스트랩 작업을 생성하여 Amazon EMR 클러스터에서 추가 소프트웨어 설치](emr-plan-bootstrap.md) 섹션을 참조하세요.
## 해결 방법
이 오류를 해결하려면 기본 인스턴스에 부트스트랩 작업 스크립트에 대한 적절한 액세스 권한이 있어야 합니다.
실패한 EMR 클러스터의 문제를 해결하려면 `DescribeCluster` 및 `ListClusters` API에서 반환된 `ErrorDetail` 정보를 참조하세요. 자세한 내용은 [Amazon EMR에서 오류 코드 및 ErrorDetail 정보](emr-troubleshoot-error-errordetail.md) 단원을 참조하십시오. `ErrorDetail` 내 `ErrorData` 배열은 이 오류 코드에 대한 다음 정보를 반환합니다.
**`primary-instance-id`**
부트스트랩 작업이 실패한 기본 인스턴스의 ID.
**`bootstrap-action`**
실패한 부트스트랩 작업의 서수. `bootstrap-action` 값이 `1`인 스크립트가 인스턴스에서 실행하는 첫 번째 부트스트랩 작업입니다.
**`amazon-s3-path`**
실패한 부트스트랩 작업의 Amazon S3 위치.
**`public-doc`**
오류 코드에 대한 설명서의 퍼블릭 URL.
## 완료할 단계
다음 단계를 수행하여 부트스트랩 작업 오류의 근본 원인을 식별하고 수정합니다. 그런 다음, 새 클러스터를 시작합니다.
**문제 해결 단계**
1. `ErrorData` 배열의 `amazon-s3-path` 값을 사용하여 Amazon S3에서 관련 부트스트랩 작업 스크립트를 찾습니다.
1. 인스턴스를 생성할 때 클러스터 로그를 활성화한 경우 자세한 내용은 `stdout` 로그를 참조하세요. 부트스트랩 작업에 대한 `stdout` 로그는 다음 Amazon S3 위치에서 찾을 수 있습니다.
```
s3://amzn-s3-demo-bucket/logs/Your_Cluster_Id/node/Primary_Instance_Id/bootstrap-actions/Failed_Bootstrap_Action_Number/stdout.gz
```
클러스터 로그에 대한 자세한 내용은 [Amazon EMR 클러스터 로깅 및 디버깅 구성](emr-plan-debugging.md) 섹션을 참조하세요.
1. 부트스트랩 작업 실패를 확인하려면 `stdout` 로그의 예외와 `ErrorData`의 `return-code` 값을 검토합니다.
1. 이전 단계에서 찾은 조사 결과를 사용하여 예외를 방지하거나 예외 발생 시 적절하게 처리할 수 있도록 부트스트랩 작업을 수정합니다.
1. 업데이트된 부트스트랩 작업으로 새 클러스터를 시작합니다.