故障排除
概觀
MinIO 使用者有兩種支援選項。
來自公共 Slack 頻道的社群支援。
社群支援僅盡力而為,沒有SLA或SLO。
MinIO 訂閱網路SUBNET,根據訂閱等級提供 48 小時或 1 小時的SLA。
如需目前的授權等級和定價,請參閱MinIO SUBNET頁面。
SUBNET
SUBNET 透過 MinIO 建立的入口網站提供全天候 24/7/365 的工程師直接支援,該入口網站結合了常見通訊工具的聊天功能和標準支援平台的支援功能。
SUBNET 的功能包括
安全性與架構審查(取決於SLA)
存取緊急按鈕,可立即回應重大問題(取決於SLA)
用於交換記錄和軟體二進位檔案的安全通訊管道
團隊無限席位
無限問題
如需更多資訊,請參閱MinIO SUBNET頁面上的詳細資訊。
使用 SUBNET 註冊您的 MinIO 部署
從RELEASE.2023-04-07T05-28-58Z開始,主控台會在您向 SUBNET 註冊後提示您重新啟動部署。您可以透過主控台重新啟動,方法是在頂部橫幅中選擇重新啟動,或使用mc admin service restart
。
您可以從 MinIO 主控台註冊 SUBNET。
前往您的 MinIO 叢集 URL,然後登入
選擇支援選項
選擇註冊
選擇使用註冊方法的索引標籤
認證索引標籤,使用您的 MinIO SUBNET 使用者名稱和密碼
API 金鑰索引標籤,輸入您已有的 API 金鑰,或直接從 SUBNET 取得一個 API 金鑰
氣隙索引標籤,用於註冊沒有直接連線到網際網路和/或 SUBNET 的部署的權杖和說明
使用下列步驟註冊沒有直接網際網路存取的 MinIO 部署。例如,存在於氣隙中、防火牆後方或在其他沒有直接網際網路存取的環境中的部署。
從主控台
前往您的 MinIO 叢集 URL,然後登入
選取 Support 索引標籤,然後選取 Health。
選取 Register your Cluster。
選取 Airgap 索引標籤。
複製提供的連結,其中包含部署的權杖值。
將連結貼到可存取網際網路的裝置上的網頁瀏覽器中。
成功註冊後,複製提供的 API 金鑰。
在 MinIO 主控台中,選取 API Key 索引標籤。
將從 SUBNET 複製的 API 金鑰貼到 API Key 欄位,然後選取 Register。
您可以從命令列註冊 SUBNET。
重要
mc license register
需要 MinIO Client 版本 RELEASE.2023-11-20T16-30-59Z
或更新版本。雖然不是絕對必要,但最佳做法是保持 MinIO Client 版本 與 MinIO Server 版本一致。
如果您無法將 MinIO Client 升級到所需版本或更新版本,請改用主控台註冊。
請參閱 mc license register
以取得說明。
對於無法直接存取網際網路的叢集,請參閱 airgap 範例 中的指示,該範例位於 mc license register
文件中。
airgap 註冊程序適用於 MinIO Client 版本 RELEASE.2022-07-29T19-17-16Z
或更新版本。較舊版本的 MinIO Client 無法註冊 airgapped 部署。
下載授權檔案
從可存取網際網路的機器上的 SUBNET 下載授權檔案。
登入 MinIO SUBNET。
前往 Deployments 索引標籤。
選取頁面頂端右側帳戶統計資訊方塊附近的 License 按鈕,以顯示 Account License。
選取 Download。
SUBNET 問題
使用 SUBNET 問題來取得 MinIO 工程團隊的支援。
選取 Issues 區段。
使用搜尋列來找到現有的問題或新增問題。

從清單中選取現有的問題以展開對話或新增回應。

檢閱 SUBNET 中的健康資料
SUBNET 從 Deployments 區段提供組織中已註冊叢集的健康資料。
該檢視畫面會顯示組織的 MinIO 叢集總大小,以及每個叢集的詳細資訊。

組織的每個叢集都顯示在摘要資料下方。選取部署列以檢視其他健康詳細資訊。
部署健康狀況
部署的詳細資訊包括部署組態的摘要,以及執行和失敗的檢查次數。您可以選取 Upload 來新增從 mc support diag
命令或 MinIO 主控台的 Support > Health 頁面取得的診斷健康資料。
您也可以使用 Call Home 功能自動執行並上傳診斷健康報告。
如果您需要 MinIO 工程團隊的支援,您可以為部署建立 New Issue。

SUBNET 會顯示 CPU、磁碟機、記憶體、網路和安全性等資料點的健康檢查。
失敗的檢查會先顯示。有警告的檢查會在失敗的檢查之後顯示。通過的檢查會在最後顯示。
選取任何失敗或警告的檢查,以顯示其他詳細資訊的 JSON 輸出。您可以在選取檢查的輸出中垂直捲動。

記錄
使用 mc admin logs
命令,從命令列顯示記錄。該命令支援類型和數量篩選器,以進一步限制記錄輸出。
您可以選擇使用 Call Home 來開始自動將即時錯誤記錄上傳到 SUBNET 以進行分析。
Call Home
新版本:RELEASE.2022-11-17T23-20-09Z 和 mc RELEASE.2022-12-02T23-48-47Z
MinIO 的選擇加入 Call Home 服務會自動收集診斷資料或錯誤記錄並上傳到 SUBNET。Call Home 要求叢集同時具有有效的 SUBNET 註冊和可靠的網際網路存取權。
重要
Call Home 不適用於 airgapped 部署。
啟用後,Call Home 可以上傳下列一項或兩項:
即時錯誤記錄
每 24 小時產生一次新的診斷報告
上傳後,您可以如上所述透過 SUBNET 查看診斷報告結果或記錄,而無需手動上傳資料。讓這些記錄自動在 SUBNET 中提供,簡化了叢集健康狀況和功能的能見度。如果您提交問題以尋求 MinIO 工程師的支援,工程師可以立即存取您已上傳的錯誤和/或記錄。
診斷報告
診斷報告上傳會從您啟用 Call Home 的時間起,每 24 小時發生一次。如果您在啟用 Call Home 後重新啟動部署中的所有節點,則上傳會從部署重新啟動起,每 24 小時發生一次。
重要
診斷報告不會收集或上傳任何個人身分識別資訊。
報告包含下列資訊:
可能影響效能的系統設定、服務和組態
TLS 憑證狀態、有效性、到期日和演算法類型資訊
CPU 核心計數和資訊
磁碟機計數、狀態、大小和可用空間
叢集大小伺服器計數
檔案系統類型
記憶體大小和類型
作業系統對稱性和 Linux 核心版本
節點間延遲
NTP 同步
可用資源
MinIO 版本
錯誤記錄
當 MinIO Server 遇到錯誤時,它會將錯誤寫入記錄。這些記錄可以即時上傳到 SUBNET,您或 MinIO 工程師可以在其中檢視錯誤。
啟用或停用 Call Home
Call Home 預設為停用。您可以使用 MinIO Client 的 mc support callhome
命令,隨時啟用
和停用
Call Home 功能。此命令及其子命令可讓您僅啟用診斷、僅啟用錯誤記錄或同時啟用兩者的 Call Home 上傳。如需更多詳細資訊,請參閱命令的文件。
使用 mc support callhome status
來檢查上傳的狀態。
將資料上傳到 SUBNET
如果您使用 SUBNET 註冊叢集,則效能和檢查檔案可以自動上傳到 SUBNET。
對於具有 airgap、防火牆或以其他方式直接從 SUBNET 封鎖的叢集,您可以在登入後手動將檔案上傳到 SUBNET。
使用
mc support diag
或mc support inspect
從命令列產生要上傳的檔案。登入 SUBNET。
選取 Deployments。
選取 Diagnostics。
拖放
.gzip
檔案,或瀏覽至要上傳的檔案位置。
加密資料
可以加密 主控台 中的檢查工具或 mc support inspect
命令中的資料。如需更多關於加密或解密此類檔案的詳細資訊,請參閱 加密檔案。
升級和版本支援
MinIO 會定期發布更新,以引入功能、提高效能、解決安全性問題或修正錯誤。這些發布可能會非常頻繁,而且因產品而異。
在生產部署上進行升級之前,請務必在開發環境中測試軟體版本。
有效支援期間
版本支援因部署使用的 授權而異。
授權 |
支援期限 |
---|---|
AGPLv3 |
最新版本 |
MinIO Enterprise Lite |
任何版本的一年長期支援 |
MinIO Enterprise Plus |
任何版本的五年長期支援,SUBNET 支援升級指南和建議 |
建議的升級排程
MinIO 建議您始終安裝最新的版本,以取得最新的功能、安全性增強和效能改進。我們理解如此頻繁的版本發佈時程對於某些組織來說可能不切實際。在這種情況下,我們建議使用 MinIO 和我們相關的產品版本,其發佈時間不應超過六個月。
版本對齊
由於各種 MinIO 產品會根據各自的時程單獨發佈,我們建議遵循以下版本對齊實踐:
- MinIO
更新至最新版本或發佈時間不超過六個月的版本。
- MinIO 用戶端
更新至 MinIO 版本發佈後一到兩週內發佈的 mc 版本。
- MinIO Operator
使用不早於 Operator 發佈時最新版本的 MinIO 版本。在 Operator 版本範例租戶 kustomization yaml 檔案中的 quay.io 連結中,可以找到發佈時最新的 MinIO 版本。
4.5.5:MinIO RELEASE.2022-12-07T00-56-37Z 或更高版本
4.5.6:MinIO RELEASE.2023-01-02T09-40-09Z 或更高版本
4.5.7:MinIO RELEASE.2023-01-12T02-06-16Z 或更高版本
4.5.8:MinIO RELEASE.2023-01-12T02-06-16Z 或更高版本
當建立新的租戶時,Operator 會使用最新的可用 MinIO 發佈映像,或者您在建立租戶時指定的映像。
升級 Operator 不會 自動升級現有的租戶。 請單獨升級現有租戶 的 MinIO 版本。