文件

故障排除

概觀

MinIO 使用者有兩種支援選項。

  1. 來自公共 Slack 頻道的社群支援。

    社群支援僅盡力而為,沒有SLASLO

  2. 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。

  1. 前往您的 MinIO 叢集 URL,然後登入

  2. 選擇支援選項

  3. 選擇註冊

  4. 選擇使用註冊方法的索引標籤

    • 認證索引標籤,使用您的 MinIO SUBNET 使用者名稱和密碼

    • API 金鑰索引標籤,輸入您已有的 API 金鑰,或直接從 SUBNET 取得一個 API 金鑰

    • 氣隙索引標籤,用於註冊沒有直接連線到網際網路和/或 SUBNET 的部署的權杖和說明

使用下列步驟註冊沒有直接網際網路存取的 MinIO 部署。例如,存在於氣隙中、防火牆後方或在其他沒有直接網際網路存取的環境中的部署。

從主控台

  1. 前往您的 MinIO 叢集 URL,然後登入

  2. 選取 Support 索引標籤,然後選取 Health

  3. 選取 Register your Cluster

  4. 選取 Airgap 索引標籤。

  5. 複製提供的連結,其中包含部署的權杖值。

  6. 將連結貼到可存取網際網路的裝置上的網頁瀏覽器中。

  7. 成功註冊後,複製提供的 API 金鑰。

  8. 在 MinIO 主控台中,選取 API Key 索引標籤。

  9. 將從 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 下載授權檔案。

  1. 登入 MinIO SUBNET

  2. 前往 Deployments 索引標籤。

  3. 選取頁面頂端右側帳戶統計資訊方塊附近的 License 按鈕,以顯示 Account License

  4. 選取 Download

SUBNET 問題

使用 SUBNET 問題來取得 MinIO 工程團隊的支援。

  1. 登入 https://subnet.min.io

  2. 選取 Issues 區段。

使用搜尋列來找到現有的問題或新增問題。

MinIO SUBNET with the Issues section displaying a list of an organization's issues

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

A example MinIO SUBNET issue conversation

檢閱 SUBNET 中的健康資料

SUBNET 從 Deployments 區段提供組織中已註冊叢集的健康資料。

該檢視畫面會顯示組織的 MinIO 叢集總大小,以及每個叢集的詳細資訊。

MinIO SUBNET displaying the deployments overview

組織的每個叢集都顯示在摘要資料下方。選取部署列以檢視其他健康詳細資訊。

部署健康狀況

部署的詳細資訊包括部署組態的摘要,以及執行和失敗的檢查次數。您可以選取 Upload 來新增從 mc support diag 命令或 MinIO 主控台的 Support > Health 頁面取得的診斷健康資料。

您也可以使用 Call Home 功能自動執行並上傳診斷健康報告。

如果您需要 MinIO 工程團隊的支援,您可以為部署建立 New Issue

MinIO SUBNET displaying health summary information for a myminio deployment

SUBNET 會顯示 CPU、磁碟機、記憶體、網路和安全性等資料點的健康檢查。

失敗的檢查會先顯示。有警告的檢查會在失敗的檢查之後顯示。通過的檢查會在最後顯示。

選取任何失敗或警告的檢查,以顯示其他詳細資訊的 JSON 輸出。您可以在選取檢查的輸出中垂直捲動。

MinIO SUBNET's health report for a deployment showing a failed Health Report with details expanded

記錄

使用 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。

  1. 使用 mc support diagmc support inspect 從命令列產生要上傳的檔案。

  2. 登入 SUBNET

  3. 選取 Deployments

  4. 選取 Diagnostics

  5. 拖放 .gzip 檔案,或瀏覽至要上傳的檔案位置。

加密資料

可以加密 主控台 中的檢查工具或 mc support inspect 命令中的資料。如需更多關於加密或解密此類檔案的詳細資訊,請參閱 加密檔案

升級和版本支援

MinIO 會定期發布更新,以引入功能、提高效能、解決安全性問題或修正錯誤。這些發布可能會非常頻繁,而且因產品而異。

在生產部署上進行升級之前,請務必在開發環境中測試軟體版本。

有效支援期間

版本支援因部署使用的 授權而異。

授權

支援期限

AGPLv3

最新版本

MinIO Enterprise Lite

任何版本的一年長期支援

MinIO Enterprise Plus

任何版本的五年長期支援,SUBNET 支援升級指南和建議

版本對齊

由於各種 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 版本。