解決導致錯誤或失敗的作業系統組態變更

檢查您是否可以切換到 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，安裝後指令碼可能無法成功執行。

檢查 chef-client 日誌是否有套件相關的錯誤：

$ less /var/log/chef-client.log

在 cfn-init 日誌中尋找套件相依性衝突：

$ less /var/log/cfn-init.log

如果特定套件造成問題，請嘗試重新安裝它：

$ sudo yum reinstall package-name

對於相依性衝突，您可能需要移除衝突的套件：

$ sudo yum remove conflicting-package

如果問題仍然存在，請考慮使用 pcluster build-image命令預先安裝的必要套件來建立自訂 AMI。如需詳細資訊，請參閱AWS ParallelCluster AMI 自訂。

檢查 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 自訂。

檢查是否已套用核心更新：

$ uname -r

在日誌中尋找 Amazon FSx 掛載失敗：

$ grep -i "fsx" /var/log/chef-client.log

對於 Ubuntu 22.04，請避免更新至最新的核心，因為該核心沒有 Amazon FSx 用戶端。如需詳細資訊，請參閱作業系統考量事項。

如果您已更新核心並遇到問題，請考慮降級至相容的核心版本：

$ sudo apt install linux-image-previous-version

對於持久性核心自訂，請使用您需要的特定核心版本建立自訂 AMI。如需詳細資訊，請參閱AWS ParallelCluster AMI 自訂。

使用自訂引導操作：使用 OnNodeStart或 OnNodeConfigured指令碼以受控制的方式進行變更，而不是直接修改系統檔案。如需詳細資訊，請參閱自訂引導操作。

建立自訂 AMIs：對於重大作業系統修改，請使用 建立自訂 AMI，pcluster build-image而不是變更執行中的執行個體。如需詳細資訊，請參閱AWS ParallelCluster AMI 自訂。

測試變更優先：在將變更套用至生產叢集之前，請先在小型測試叢集上測試變更，以確保相容性。

文件變更：追蹤所有作業系統組態變更，以便進行故障診斷。

備份組態檔案：修改任何系統組態檔案之前，請先建立備份：

$ sudo cp /etc/file.conf /etc/file.conf.bak

變更後檢查日誌：變更作業系統組態後，請檢查日誌是否有任何錯誤：

$ less /var/log/cfn-init.log
$ less /var/log/chef-client.log