排解 CouchDB 相關問題

以下說明如何排解您在 Google Workspace Migrate 設定中使用 Apache CouchDB 時可能遇到的問題。

解決 CouchDB 磁碟空間已滿的錯誤

Google Workspace Migrate 可能會佔用 CouchDB 伺服器上的大量磁碟空間。建議您定期監控 CouchDB 磁碟，以免儲存空間不足。

如果無法監控磁碟，以下這些跡象可能表示 CouchDB 磁碟已滿：

無法存取詳細的橋接設定交易資訊。
無法啟動橋接設定分區。
無法載入 CouchDB 管理頁面 (http://localhost:5984/_utils 或根據設定的對等位址)。
Google Workspace Migrate 平台或節點伺服器上的服務主機記錄含有 CouchDB 錯誤，並且顯示下列字串：
- badarg
- unknown_error
- function_clause

若發現上述這些跡象，請先確認 CouchDB 正在執行：

只要刪除不需要的橋接設定或專案，即可釋出空間。

您也可以清除現有橋接設定的交易記錄詳細資料，藉此釋出空間：

前往 http://localhost:5131/#/clear-transaction-details (或根據設定的對等位址)。
選取要清除的橋接設定，然後按一下「Delete」(刪除) 圖示。
(選用) 如要保留各個橋接設定最近執行的交易詳細資料，請選取「Preserve details from most recent executions」(保留最近執行作業的詳細資料)。

注意：如果 CouchDB 磁碟因為多次執行一項橋接設定導致空間已滿，這個選項可以讓您清理 CouchDB 磁碟。但如果您是一次執行所有橋接設定，建議您不要選取這項設定，因為這樣不會釋出額外的空間。如果未選取這個選項，系統就會在保留交易記錄時清除所選橋接設定的所有交易詳細資訊。
點選「Yes」(是) 即可開始程序。
按一下「Details」(詳細資料) 圖示，確認橋接設定交易記錄中沒有內容。所選橋接設定的交易詳細資訊應該會顯示「No items to display」(沒有可顯示的項目)。
檢查 CouchDB 的磁碟用量，卻保有足夠的磁碟空間。如要進一步瞭解 CouchDB 磁碟空間需求，請參閱「系統需求」。

請根據您是否能存取 Google Workspace Migrate 平台，選擇下方相應的方法。

在 Google Workspace Migrate 平台中，依序按一下頂端的「Settings」(設定) 圖示「Database settings」(資料庫設定)。
輸入 CouchDB 和 MySQL 的新密碼。
您必須提供這兩組密碼。如果您沒有 MySQL 密碼，請參閱「我無法存取 Google Workspace Migrate 平台」(見下方說明)。
按一下「Continue」(繼續)，然後繼續執行下方的「步驟 3：重新連結節點」。

登入執行平台的電腦。
在工作列上的 Google Workspace Migrate 圖示上按一下滑鼠右鍵，然後選取「Edit host settings」(編輯主機設定)。
按一下「CouchDB settings」(CouchDB 設定) 下方的「Password」(密碼)，然後輸入新密碼。
依序按一下「Save & Close」(儲存並關閉) 「OK」(確定)。
在工作列上的 Google Workspace Migrate 圖示按一下滑鼠右鍵，並選取「Stop Google Workspace Migrate service」(停止 Google Workspace Migrate 服務)，然後重新啟動服務。
繼續執行下方的「步驟 3：重新連結節點」。

您必須完成這個步驟，才能將新的資料庫設定套用到節點。