疑難排解 ONTAP 工具部署錯誤
建議變更
PDF
如果您遇到部署問題，請查看日誌和錯誤代碼以診斷和解決問題。從適用於ONTAP tools for VMware vSphere開始，從 pod 收集的日誌包包括來自 MongoDB、RabbitMQ 和 Vault 的日誌，以及所有 pod 的狀態和描述。這些是在現有ONTAP工具服務日誌的基礎上提供的，增強了可支援性和故障排除能力。
收集記錄檔
您可以透過 ONTAP tools Manager 使用者介面中的選項收集 ONTAP tools for VMware vSphere 的日誌檔案。技術支援人員可能會要求您收集這些日誌檔案，以協助疑難排解問題。
|
從 ONTAP tools Manager 產生記錄包含所有 vCenter Server 執行個體的所有記錄。從 vCenter 用戶端使用者介面產生記錄的範圍僅限於所選的 vCenter Server。 |
-
從網路瀏覽器啟動 ONTAP 工具管理員：
https://<ONTAPtoolsIP>:8443/virtualization/ui/ -
使用您在部署期間提供的 VMware vSphere 管理員認證 ONTAP 工具登入。
-
從側欄中選擇 * 日誌套件 * 。
此作業可能需要數分鐘的時間。
-
選取 * 產生 * 以產生記錄檔。
-
輸入日誌套件組合的標籤、然後選取 * 產生 * 。
下載 tar.gz 檔案並傳送給技術支援人員。
請遵循下列步驟，使用 vCenter 用戶端使用者介面產生記錄套件：
-
登入 vSphere 用戶端。
-
從 vSphere Client 首頁、前往 * 支援 * > * 記錄套件 * > * 產生 * 。
-
提供日誌包標籤並產生日誌包。文件生成後，您可以看到下載選項。下載可能需要一些時間。
|
|
產生的記錄套件會取代過去 3 天或 72 小時內產生的記錄套件。 |
部署錯誤代碼
您可能會在部署 VMware vSphere 、重新開機和還原作業的 ONTAP 工具期間遇到錯誤代碼。 錯誤代碼長度為五位數、前兩位數代表發生問題的指令碼、後三位數代表該指令碼內的特定工作流程。
所有錯誤日誌都記錄在 /var/log 目錄下的 ansible-perl-errors.log 檔案中，以便於輕鬆追蹤和解決問題。此日誌檔案包含錯誤代碼和失敗的 Ansible 任務。
|
|
本頁提供的錯誤代碼僅供參考。如果錯誤仍然存在或未提及解決方案，請聯絡支援團隊。 |
下表列出錯誤代碼和對應的檔案名稱。
* 錯誤代碼 * |
* 指令碼名稱 * |
00 |
firstboot-network-config.pl 、模式部署 |
01 |
firstboot-network-config.pl 、模式升級 |
02 |
firstboot-inputs-validation.pl |
03 |
firstboot-deploy-otv-ng.pl ，部署， HA |
04 |
firstboot-deploy-otv-ng.pl ，部署，非 HA |
05 |
firstboot-deploy-otv-ng.pl 、重新開機 |
06 |
firstboot-deploy-otv-ng.pl ，升級， HA |
07 |
firstboot-deploy-otv-ng.pl ，升級，非 HA |
08 |
firstboot-otv-recovery.pl |
09 |
post-deploy-upgrade.pl |
錯誤代碼的最後三位數字表示指令碼內的特定工作流程錯誤：
* 部署錯誤代碼 * |
工作流程 |
* 解決方法 * |
049 |
對於網路和驗證 perl 指令碼，也會很快指派它們 |
- |
050 |
SSH 金鑰產生失敗 |
重新啟動主要虛擬機器（ VM ）。 |
053 |
無法安裝 RKE2 |
執行下列操作並重新啟動主要 VM 或重新部署： Sudo rke2-killall.sh （所有 VM ） Sudo rke2-uninstall.sh （所有 VM ）。 |
054 |
無法設定 kubeconfig |
重新部署 |
055 |
部署登錄失敗 |
如果登錄 pod 存在、請等待 pod 準備就緒、然後重新啟動主要 VM 或重新部署。 |
059 |
KubeVip 部署失敗 |
請確保部署期間提供的 Kubernetes 控制平面虛擬 IP 位址和 ONTAP tools IP 位址屬於相同 VLAN，且均為閒置 IP 位址。若以上所有條件均已滿足，請重新啟動服務。否則，請重新部署。 |
060 |
操作員部署失敗 |
重新啟動 |
061 |
服務部署失敗 |
在 NTV 系統命名空間中執行基本 Kubernetes 偵錯、例如 Get Pod 、 Get RS 、 Get Svc 等、以取得詳細資料和錯誤記錄、請參閱 /var/log/ansible-perl-errors.log 和 /var/log/ansible-run.log 、然後重新部署。 |
062 |
ONTAP 工具服務部署失敗 |
請參閱 /var/log/ansible-perl-errors.log 上的錯誤記錄、以取得更多詳細資料並重新部署。 |
065 |
無法連線到 Swagger 頁面 URL |
重新部署 |
066 |
閘道憑證的部署後步驟失敗 |
請執行下列步驟以恢復 / 完成升級：
|
088 |
設定日誌輪轉為日誌檔失敗 |
檢查 VM 網路設定是否與裝載 VM 的主機相容。您可以嘗試移轉至其他主機，然後重新啟動 VM 。 |
089 |
變更摘要記錄輪轉組態檔的擁有權失敗 |
重新啟動主要 VM 。 |
096 |
安裝動態儲存資源配置程式 |
- |
108 |
植入指令碼失敗 |
- |
114 |
MongoDB 集合中的內部憑證更新失敗 |
如果部署失敗並出現錯誤代碼 114、請完成下列步驟：
|
* 重新開機錯誤代碼 * |
工作流程 |
* 解決方法 * |
067 |
等待 rke2 伺服器逾時。 |
- |
101. |
無法重設維護 / 主控台使用者密碼。 |
- |
102. |
在重設維護 / 主控台使用者密碼期間，無法刪除密碼檔案。 |
- |
103 |
無法在資料保險箱中更新新的維護 / 主控台使用者密碼。 |
- |
088 |
設定日誌輪轉為日誌檔失敗。 |
檢查 VM 網路設定是否與裝載 VM 的主機相容。您可以嘗試移轉至其他主機，然後重新啟動 VM 。 |
089 |
變更摘要記錄輪轉組態檔的擁有權失敗。 |
重新啟動 VM 。 |