오류 또는 실패를 유발하는 OS 구성 변경 사항 해결

AWS ParallelCluster 노드에 OS 구성을 변경할 때 클러스터 생성, 업데이트 또는 작업 실패를 일으킬 수 있는 다양한 문제가 발생할 수 있습니다. 이 섹션에서는 일반적인 OS 구성 관련 문제를 식별하고 해결하는 방법에 대한 지침을 제공합니다.

일반적인 OS 구성 문제

가장 일반적인 OS 구성 문제 중 하나는 로캘 설정과 관련이 있습니다. 다음과 같은 오류가 표시되는 경우:


cannot change locale (en_US.utf-8) because it has an invalid name

이는 일반적으로 다음과 같은 경우에 발생합니다.

pcluster-admin 사용자로 전환할 수 있는지 확인합니다.
```
$ su - pcluster-admin
```
와 같은 오류가 표시되면 문제가 cannot change locale...no such file or directory확인된 것입니다.
사용 가능한 로캘을 확인합니다.
```
$ localedef --list
```
이렇게 하면 빈 목록이 반환되거나 기본 로캘이 포함되지 않으면 로캘 구성이 중단됩니다.
마지막 yum 명령을 확인합니다.
```
$ yum history
$ yum history info #ID
```
마지막 ID에 Return-Code: Success가 없으면 설치 후 스크립트가 성공적으로 실행되지 않았을 수 있습니다.

언어 팩을 다시 설치하여 로캘을 다시 빌드합니다.


$ sudo yum reinstall glibc-all-langpacks

다시 빌드한 후 다음을 실행하여 문제가 해결되었는지 확인합니다.


$ su - pcluster-admin

오류나 경고가 표시되지 않으면 문제가 해결된 것입니다.

사용자 지정 패키지를 설치하거나 시스템 패키지를 수정할 때 충돌이 발생하여 클러스터가 제대로 작동하지 않을 수 있습니다.

특정 패키지에서 문제가 발생하는 경우 다시 설치해 보십시오.
```
$ sudo yum reinstall package-name
```
종속성 충돌의 경우 충돌하는 패키지를 제거해야 할 수 있습니다.
```
$ sudo yum remove conflicting-package
```
문제가 지속되면 pcluster build-image 명령을 사용하여 필요한 패키지가 사전 설치된 사용자 지정 AMI를 생성하는 것이 좋습니다. 자세한 내용은 AWS ParallelCluster AMI 사용자 지정 단원을 참조하십시오.

중요한 시스템 구성 파일을 수정하면 특히 이러한 파일을에서 관리하는 경우 클러스터 오류가 발생할 수 있습니다 AWS ParallelCluster.

Chef-client 로그에서 특정 구성 파일을 언급하는 오류가 있는지 확인합니다.
```
$ grep -i "config" /var/log/chef-client.log
```
구성 파일에서 권한 또는 구문 오류를 찾습니다.
```
$ less /var/log/cfn-init.log
```

수정된 구성 파일을 원래 상태로 복원합니다.
```
$ sudo cp /etc/file.conf.bak /etc/file.conf
```
시스템 구성 파일을 지속적으로 변경해야 하는 경우 파일을 직접 수정하는 대신 사용자 지정 부트스트랩 작업을 사용합니다.
```
HeadNode:
  CustomActions:
    OnNodeConfigured:
      Script: s3://bucket-name/config-script.sh
```
자세한 내용은 사용자 지정 부트스트랩 작업 단원을 참조하십시오.
시스템 파일을 직접 변경해야 하는 구성 변경의 경우 사용자 지정 AMI를 생성하는 것이 좋습니다. 자세한 내용은 AWS ParallelCluster AMI 사용자 지정 단원을 참조하십시오.

커널 업데이트는 특정 AWS 서비스, 특히 Amazon FSx for Lustre와의 호환성 문제를 일으킬 수 있습니다.

Ubuntu 22.04의 경우 해당 커널에 대한 Amazon FSx 클라이언트가 없으므로 최신 커널로 업데이트하지 마세요. 자세한 내용은 운영 체제 고려 사항 단원을 참조하십시오.
커널을 이미 업데이트했는데 문제가 발생하는 경우 호환되는 커널 버전으로 다운그레이드하는 것이 좋습니다.
```
$ sudo apt install linux-image-previous-version
```
영구 커널 사용자 지정의 경우 필요한 특정 커널 버전으로 사용자 지정 AMI를 생성합니다. 자세한 내용은 AWS ParallelCluster AMI 사용자 지정 단원을 참조하십시오.

OS 구성 변경 시 문제를 최소화하려면:

사용자 지정 부트스트랩 작업 사용: 시스템 파일을 직접 수정하는 대신 OnNodeStart 또는 OnNodeConfigured 스크립트를 사용하여 제어된 방식으로 변경합니다. 자세한 내용은 사용자 지정 부트스트랩 작업 단원을 참조하십시오.
사용자 지정 AMIs: OS를 크게 수정하려면 실행 중인 인스턴스를 변경하는 pcluster build-image 대신를 사용하여 사용자 지정 AMI를 생성합니다. 자세한 내용은 AWS ParallelCluster AMI 사용자 지정 단원을 참조하십시오.
변경 사항 테스트 우선: 프로덕션 클러스터에 변경 사항을 적용하기 전에 작은 테스트 클러스터에서 변경 사항을 테스트하여 호환성을 확인합니다.
문서 변경: 문제 해결을 용이하게 하기 위해 모든 OS 구성 변경 사항을 추적합니다.
백업 구성 파일: 시스템 구성 파일을 수정하기 전에 백업을 생성합니다.
```
$ sudo cp /etc/file.conf /etc/file.conf.bak
```
변경 후 로그 확인: OS 구성을 변경한 후 로그에 오류가 있는지 확인합니다.
```
$ less /var/log/cfn-init.log
$ less /var/log/chef-client.log
```

이러한 지침을 따르면 OS 구성 변경으로 인해 클러스터 장애가 발생할 위험을 최소화하고 발생하는 문제를 보다 효과적으로 해결할 수 있습니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

클러스터 경보

AWS ParallelCluster 지원 정책