기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 클러스터를 생성하려는 경우
<a name="troubleshooting-fc-v3-create-cluster"></a>

 AWS ParallelCluster 버전 3.5.0 이상을 사용하여 클러스터를 생성하고를 로 `--rollback-on-failure` 설정하여 클러스터 생성에 실패한 경우 [`pcluster describe-cluster`](pcluster.describe-cluster-v3.md) CLI 명령을 `false`사용하여 상태 및 실패 정보를 가져옵니다. 이 경우 `pcluster describe-cluster` 출력의 예상 `clusterStatus`은 `CREATE_FAILED`입니다. `failureCode` 및 `failureReason`을 찾으려면 출력의 `failures` 섹션을 확인하세요. 그 후 다음 섹션에서 일치하는 `failureCode`를 찾아 추가 문제 해결 도움말을 찾아보세요. 자세한 내용은 [`pcluster describe-cluster`](pcluster.describe-cluster-v3.md) 항목을 참조하세요.

다음 섹션에서는 헤드 노드의 로그(예: `/var/log/cfn-init.log` 및 `/var/log/chef-client.log` 파일)를 확인하는 것이 좋습니다. AWS ParallelCluster 로그 및 로그를 보는 방법에 대한 자세한 내용은 [디버깅을 위한 키 로그](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-key-logs) 및 섹션을 참조하세요[로그 검색 및 보존](troubleshooting-v3-get-logs.md).

가 없는 경우 CloudFormation 콘솔로 `failureCode`이동하여 클러스터 스택을 확인합니다. `HeadNodeWaitCondition` 또는 다른 리소스의 실패에 대해 알아보려면 `Status Reason`에서 추가 실패 상세 정보를 확인하세요. 자세한 내용은 [에서 CloudFormation 이벤트 보기 `CREATE_FAILED`](troubleshooting-v3-cluster-deployment.md#troubleshooting-v3-cluster-deployment-events) 항목을 참조하세요. 헤드 노드의 `/var/log/cfn-init.log` 및 `/var/log/chef-client.log` 파일을 확인합니다. 헤드 노드 생성 실패로 인해 클러스터 생성에 실패하고 클러스터 로그를 클러스터 로그 그룹에서 사용할 수 없는 경우 실패 시 클러스터를 유지하고 `--rollback-on-failure` =를 지정`True`하고 헤드 노드 자체 내에서 로그를 검색해야 합니다.

## `failureCode`가 `OnNodeConfiguredExecutionFailure`일 시
<a name="create-cluster-on-node-configured-executed-failure-v3"></a>
+ **왜 실패했나요?**

  구성 내 헤드 노드 섹션의 `OnNodeConfigured`에 클러스터를 생성하기 위한 사용자 지정 스크립트를 제공했습니다. 하지만 사용자 지정 스크립트가 실행되지 않았습니다.
+ **해결 방법은?**

  `/var/log/cfn-init.log` 파일을 확인하여 실패에 대해 자세히 알아보고 사용자 지정 스크립트에서 문제를 해결하는 방법을 알아보세요. 이 로그의 끝부분에서 `Running command runpostinstall` 메시지 뒤에 `OnNodeConfigured` 스크립트와 관련된 실행 정보가 표시될 수 있습니다.

## `failureCode`가 `OnNodeConfiguredDownloadFailure`일 시
<a name="create-cluster-on-node-configured-download-failure-v3"></a>
+ **왜 실패했나요?**

  구성 내 헤드 노드 섹션의 `OnNodeConfigured`에 클러스터를 생성하기 위한 사용자 지정 스크립트를 제공했습니다. 하지만 사용자 지정 스크립트가 다운로드되지 않았습니다.
+ **해결 방법은?**

  URL이 유효하고 액세스가 올바르게 구성되어 있는지 확인하세요. 사용자 지정 부트스트랩 스크립트의 구성에 대한 자세한 내용은 [사용자 지정 부트스트랩 작업](custom-bootstrap-actions-v3.md) 항목을 참조하세요.

  `/var/log/cfn-init.log` 파일을 확인하세요. 이 로그의 끝부분에서 `Running command runpostinstall` 메시지 다음에 다운로드를 포함한 `OnNodeConfigured` 스크립트 처리와 관련된 실행 정보가 표시될 수 있습니다.

## `failureCode`가 `OnNodeConfiguredFailure`일 시
<a name="create-cluster-on-node-configured-failure-v3"></a>
+ **왜 실패했나요?**

  구성 내 헤드 노드 섹션의 `OnNodeConfigured`에 클러스터를 생성하기 위한 사용자 지정 스크립트를 제공했습니다. 하지만 클러스터 배포에서 사용자 지정 스크립트 사용이 실패했습니다. 즉각적인 원인을 확인할 수 없으며 추가 조사가 필요합니다.
+ **해결 방법은?**

  `/var/log/cfn-init.log` 파일을 확인하세요. 이 로그의 끝부분에서 `Running command runpostinstall` 메시지 뒤에 `OnNodeConfigured` 스크립트 처리와 관련된 실행 정보가 표시될 수 있습니다.

## `failureCode`가 `OnNodeStartExecutionFailure`일 시
<a name="create-cluster-on-node-start-execution-failure-v3"></a>
+ **왜 실패했나요?**

  구성 내 헤드 노드 섹션의 `OnNodeStart`에 클러스터를 생성하기 위한 사용자 지정 스크립트를 제공했습니다. 하지만 사용자 지정 스크립트가 실행되지 않았습니다.
+ **해결 방법은?**

  `/var/log/cfn-init.log` 파일을 확인하여 실패에 대해 자세히 알아보고 사용자 지정 스크립트에서 문제를 해결하는 방법을 알아보세요. 이 로그의 끝부분에서 `Running command runpreinstall` 메시지 뒤에 `OnNodeStart` 스크립트와 관련된 실행 정보가 표시될 수 있습니다.

## `failureCode`가 `OnNodeStartDownloadFailure`일 시
<a name="create-cluster-on-node-start-download-failure-v3"></a>
+ **왜 실패했나요?**

  구성 내 헤드 노드 섹션의 `OnNodeStart`에 클러스터를 생성하기 위한 사용자 지정 스크립트를 제공했습니다. 하지만 사용자 지정 스크립트가 다운로드되지 않았습니다.
+ **해결 방법은?**

  URL이 유효하고 액세스가 올바르게 구성되어 있는지 확인하세요. 사용자 지정 부트스트랩 스크립트의 구성에 대한 자세한 내용은 [사용자 지정 부트스트랩 작업](custom-bootstrap-actions-v3.md) 항목을 참조하세요.

  `/var/log/cfn-init.log` 파일을 확인하세요. 이 로그의 끝부분에서 `Running command runpreinstall` 메시지 다음에 다운로드를 포함한 `OnNodeStart` 스크립트 처리와 관련된 실행 정보가 표시될 수 있습니다.

## `failureCode`가 `OnNodeStartFailure`일 시
<a name="create-cluster-on-node-start-failure-v3"></a>
+ **왜 실패했나요?**

  구성 내 헤드 노드 섹션의 `OnNodeStart`에 클러스터를 생성하기 위한 사용자 지정 스크립트를 제공했습니다. 하지만 클러스터 배포에서 사용자 지정 스크립트 사용이 실패했습니다. 즉각적인 원인을 확인할 수 없으며 추가 조사가 필요합니다.
+ **해결 방법은?**

  `/var/log/cfn-init.log` 파일을 확인하세요. 이 로그의 끝부분에서 `Running command runpreinstall` 메시지 뒤에 `OnNodeStart` 스크립트 처리와 관련된 실행 정보가 표시될 수 있습니다.

## `failureCode`가 `EbsMountFailure`일 시
<a name="create-cluster-ebs-mount-failure-v3"></a>
+ **왜 실패했나요?**

  클러스터 구성에 정의된 EBS 볼륨이 탑재되지 못했습니다.
+ **해결 방법은?**

  `/var/log/chef-client.log` 파일에서 실패 세부 정보를 확인하세요.

## `failureCode`가 `EfsMountFailure`일 시
<a name="create-cluster-efs-mount-failure-v3"></a>
+ **왜 실패했나요?**

  클러스터 구성에 정의된 Amazon EFS 볼륨이 탑재되지 못했습니다.
+ **해결 방법은?**

  기존 Amazon EFS 파일 시스템을 정의한 경우 클러스터와 파일 시스템 간에 트래픽이 허용되는지 확인하세요. 자세한 내용은 [`SharedStorage`](SharedStorage-v3.md)/[`EfsSettings`](SharedStorage-v3.md#SharedStorage-v3-EfsSettings)/[`FileSystemId`](SharedStorage-v3.md#yaml-SharedStorage-EfsSettings-FileSystemId)를 참조하세요.

  `/var/log/chef-client.log` 파일에서 실패 세부 정보를 확인하세요.

## `failureCode`가 `FsxMountFailure`일 시
<a name="create-cluster-fsx-mount-failure-v3"></a>
+ **왜 실패했나요?**

  클러스터 구성에 정의된 Amazon FSx 파일 시스템이 탑재되지 못했습니다.
+ **해결 방법은?**

  기존 Amazon FSx 파일 시스템을 정의한 경우 클러스터와 파일 시스템 간에 트래픽이 허용되는지 확인하세요. 자세한 내용은 [`SharedStorage`](SharedStorage-v3.md)/[`FsxLustreSettings`](SharedStorage-v3.md#SharedStorage-v3-FsxLustreSettings)/[`FileSystemId`](SharedStorage-v3.md#yaml-SharedStorage-FsxLustreSettings-FileSystemId)를 참조하세요.

  `/var/log/chef-client.log` 파일에서 실패 세부 정보를 확인하세요.

## `failureCode`가 `RaidMountFailure`일 시
<a name="create-cluster-raid-mount-failure-v3"></a>
+ **왜 실패했나요?**

  클러스터 구성에 정의된 RAID 볼륨이 탑재되지 못했습니다.
+ **해결 방법은?**

  `/var/log/chef-client.log` 파일에서 실패 세부 정보를 확인하세요.

## `failureCode`가 `AmiVersionMismatch`일 시
<a name="create-cluster-ami-version-mismatch-v3"></a>
+ **왜 실패했나요?**

  사용자 지정 AMI를 생성하는 데 사용되는 AWS ParallelCluster 버전은 클러스터를 구성하는 데 사용되는 AWS ParallelCluster 버전과 다릅니다. CloudFormation 콘솔에서 클러스터 CloudFormation 스택 세부 정보를 확인하고에서 AWS ParallelCluster 버전 및 AMI에 `Status Reason` 대한 추가 세부 정보를 `HeadNodeWaitCondition` 확인합니다. 자세한 내용은 [에서 CloudFormation 이벤트 보기 `CREATE_FAILED`](troubleshooting-v3-cluster-deployment.md#troubleshooting-v3-cluster-deployment-events) 단원을 참조하십시오.
+ **해결 방법은?**

  사용자 지정 AMI를 생성하는 데 사용되는 AWS ParallelCluster 버전이 클러스터를 구성하는 데 사용되는 AWS ParallelCluster 버전과 동일한지 확인합니다. 사용자 지정 AMI 버전 또는 `pcluster` CLI 버전을 변경하여 동일하게 만들 수 있습니다.

## `failureCode`가 `InvalidAmi`일 시
<a name="create-cluster-invalid-ami-v3"></a>
+ **왜 실패했나요?**

  사용자 지정 AMI는를 사용하여 빌드되지 않았으므로 유효하지 않습니다 AWS ParallelCluster.
+ **해결 방법은?**

  `pcluster build-image` 명령을 사용하여 AMI를 상위 이미지로 만들어 AMI를 생성합니다. 자세한 내용은 [`pcluster build-image`](pcluster.build-image-v3.md) 항목을 참조하세요.

## `failureCode`가 `HeadNodeBootstrapFailure`이며 `failureReason`이 헤드 노드 설정에 실패했습니다.
<a name="create-cluster-head-node-bootstrap-setup-failure-v3"></a>
+ **왜 실패했나요?**

  즉각적인 원인을 확인할 수 없으며 추가 조사가 필요합니다. 예를 들어 클러스터가 보호 상태일 수 있는데, 이는 정적 컴퓨팅 플릿을 프로비저닝하지 못했기 때문일 수 있습니다.
+ **해결 방법은?**

  `/var/log/chef-client.log.` 파일에서 실패 세부 정보를 확인하세요.
**참고**  
`RuntimeError` 예외 `Cluster state has been set to PROTECTED mode due to failures detected in static node provisioning`가 표시되면 클러스터가 보호 상태인 것입니다. 자세한 내용은 [보호 모드를 디버깅하는 방법](slurm-protected-mode-v3.md#slurm-protected-mode-debug-v3) 항목을 참조하세요.

## `failureCode`가 `HeadNodeBootstrapFailure`이며 `failureReason`이 클러스터 생성 시간이 초과되었습니다.
<a name="create-cluster-head-node-bootstrap-timeout-failure-v3"></a>
+ **왜 실패했나요?**

  기본적으로 클러스터 생성을 완료하는 데 걸리는 시간 제한은 30분입니다. 클러스터 생성이 이 기간 내에 완료되지 않으면 시간 초과 오류와 함께 클러스터 생성이 실패합니다. 여러 가지 이유로 클러스터 생성 시간이 초과될 수 있습니다. 예를 들어 헤드 노드 생성 실패, 네트워크 문제, 헤드 노드에서 실행하는 데 너무 오래 걸리는 사용자 지정 스크립트, 컴퓨팅 노드에서 실행되는 사용자 지정 스크립트의 오류 또는 컴퓨팅 노드 프로비저닝의 긴 대기 시간으로 인해 시간 초과 실패가 발생할 수 있습니다. 즉각적인 원인을 확인할 수 없으며 추가 조사가 필요합니다.
+ **해결 방법은?**

  `/var/log/cfn-init.log` 및 `/var/log/chef-client.log` 파일에서 실패 세부 정보를 확인하세요. AWS ParallelCluster 로그 및 로그 가져오기 방법에 대한 자세한 내용은 [디버깅을 위한 키 로그](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-key-logs) 및 [로그 검색 및 보존](troubleshooting-v3-get-logs.md)을 참조하세요.

  이러한 로그에서 다음을 발견할 수 있습니다.
  + **`chef-client.log` 끝부분에 `Waiting for static fleet capacity provisioning`가 표시되는 경우**

    이는 정적 노드의 전원이 켜질 때까지 기다릴 때 클러스터 생성 시간이 초과되었음을 나타냅니다. 자세한 내용은 [컴퓨팅 노드 초기화 오류가 표시되는 경우](troubleshooting-fc-v3-compute-node-initialization-v3.md) 항목을 참조하세요.
  + **`cfn-init.log` 끝부분에 `OnNodeConfigured` 또는 `OnNodeStart` 노드 스크립트가 종료되지 않았다고 표시되는 경우**

    이는 `OnNodeConfigured` 또는 `OnNodeStart` 사용자 지정 스크립트를 실행하는 데 시간이 오래 걸리고 시간 초과 오류가 발생했음을 나타냅니다. 사용자 지정 스크립트에서 오랜 시간 실행으로 이어질 수 있는 문제가 있는지 확인합니다. 사용자 지정 스크립트를 실행하는 데 시간이 오래 걸리는 경우 다음 예와 같이 클러스터 구성 파일에 `DevSettings` 섹션을 추가하여 제한 시간을 변경하는 것이 좋습니다.

    ```
    DevSettings:
      Timeouts:
        HeadNodeBootstrapTimeout: 1800 # default setting: 1800 seconds
    ```
  + **로그를 찾을 수 없거나 헤드 노드가 성공적으로 생성되지 않았습니다.**

    헤드 노드가 성공적으로 생성되지 않아 로그를 찾을 수 없을 수 있습니다. 이 경우 CloudFormation 스택 이벤트와 헤드 노드 콘솔 로그를 확인하여 추가 장애 세부 정보를 얻을 수 있습니다. Amazon EC2 콘솔을 통해 또는 다음 Amazon EC2 CLI 명령을 실행하여 헤드 노드 콘솔 로그를 검색할 수 있습니다.

    ```
    aws ec2 get-console-output --instance-id {{HEAD_NODE_INSTANCE_ID}} --output text
    ```

## `failureCode`가 `HeadNodeBootstrapFailure`이며 `failureReason`이 헤드 노드 부트스트랩에 실패했습니다.
<a name="create-cluster-head-node-bootstrap-failure-v3"></a>
+ **왜 실패했나요?**

  즉각적인 원인을 확인할 수 없으며 추가 조사가 필요합니다.
+ **해결 방법은?**

  `/var/log/cfn-init.log` 및 `/var/log/chef-client.log` 파일을 확인합니다.

## `failureCode`가 `ResourceCreationFailure`일 시
<a name="create-cluster-resource-creation-failure-v3"></a>
+ **왜 실패했나요?**

  클러스터 생성 프로세스 중 일부 리소스 생성이 실패했습니다. 실패는 다양한 이유로 발생할 수 있습니다. 예를 들어 용량 문제나 잘못 구성된 IAM 정책으로 인해 리소스 생성 실패가 발생할 수 있습니다.
+ **해결 방법은?**

  CloudFormation 콘솔에서 클러스터 스택을 보고 추가 리소스 생성 실패 세부 정보를 확인합니다.

## `failureCode`가 `ClusterCreationFailure`일 시
<a name="cluster-creation-failure-v3"></a>
+ **왜 실패했나요?**

  즉각적인 원인을 확인할 수 없으며 추가 조사가 필요합니다.
+ **해결 방법은?**

  CloudFormation 콘솔에서 클러스터 스택을 보고 추가 실패 상세 정보를 찾기 위해 `Status Reason`에서 `HeadNodeWaitCondition`을 확인하세요.

  `/var/log/cfn-init.log` 및 `/var/log/chef-client.log` 파일을 확인합니다.

## CloudFormation 스택에서 `WaitCondition timed out...`가 표시되는 경우
<a name="create-cluster-wait-condition-timeout-v3"></a>

자세한 내용은 [`failureCode`가 `HeadNodeBootstrapFailure`이며 `failureReason`이 클러스터 생성 시간이 초과되었습니다.](#create-cluster-head-node-bootstrap-timeout-failure-v3) 항목을 참조하세요.

## CloudFormation 스택에서 `Resource creation cancelled`가 표시되는 경우
<a name="create-cluster-resource-create-error-v3"></a>

자세한 내용은 [`failureCode`가 `ResourceCreationFailure`일 시](#create-cluster-resource-creation-failure-v3) 단원을 참조하십시오.

## CloudFormation 스택에서 `Failed to run cfn-init...` 또는 기타 오류 표시
<a name="create-cluster-cfn-init-fail-error-v3"></a>

추가 실패 세부 정보는 `/var/log/cfn-init.log` 및 `/var/log/chef-client.log`를 확인하세요.

## `INFO: Waiting for static fleet capacity provisioning`로 끝나는 `chef-client.log`이 표시되는 경우
<a name="create-cluster-wait-on-fleet-capacity-v3"></a>

이는 정적 노드의 전원이 켜질 때까지 기다릴 때 발생하는 클러스터 생성 타임아웃과 관련이 있습니다. 자세한 내용은 [컴퓨팅 노드 초기화 오류가 표시되는 경우](troubleshooting-fc-v3-compute-node-initialization-v3.md) 항목을 참조하세요.

## `Failed to run preinstall or postinstall in cfn-init.log`가 표시되는 경우
<a name="create-cluster-pre-post-install-v3"></a>

클러스터 구성 `HeadNode` 섹션에 `OnNodeConfigured` 또는 `OnNodeStart` 스크립트가 있습니다. 스크립트가 제대로 작동하지 않습니다. `/var/log/cfn-init.log` 파일에서 사용자 지정 스크립트 오류 세부 정보를 확인하세요.

## CloudFormation 스택에서 `This AMI was created with xxx, but is trying to be used with xxx...`가 표시되는 경우
<a name="create-cluster-ami-mismatch-error-v3"></a>

자세한 내용은 [`failureCode`가 `AmiVersionMismatch`일 시](#create-cluster-ami-version-mismatch-v3) 항목을 참조하세요.

## CloudFormation 스택에서 `This AMI was not baked by AWS ParallelCluster...`가 표시되는 경우
<a name="create-cluster-ami-incomplete-error-v3"></a>

자세한 내용은 [`failureCode`가 `InvalidAmi`일 시](#create-cluster-invalid-ami-v3) 항목을 참조하세요.

## `pcluster create-cluster` 명령이 로컬에서 실행되지 않는 경우
<a name="create-cluster-pcluster-cli-error-v3"></a>

로컬 파일 시스템의 `~/.parallelcluster/pcluster-cli.log`에서 오류 세부 정보를 확인하세요.

## 추가 지원
<a name="create-cluster-additional-support-v3"></a>

[클러스터 배포 문제 해결](troubleshooting-v3-cluster-deployment.md)의 문제 해결 지침을 따르세요.

시나리오가 [GitHub의에 있는 GitHub 알려진 문제](https://github.com/aws/aws-parallelcluster/wiki) AWS ParallelCluster 에서 다루어지는지 확인합니다. GitHub