排解 MySQL 相關問題

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

網路連線錯誤  |  磁碟空間已滿  |  密碼問題  |  節點離線

網路連線錯誤

Google Workspace 支援團隊無法協助您解決網路設定相關問題。

在節點或平台服務主機記錄中提及 MySQL 的錯誤 (例如「連線逾時已過期」錯誤)，可能表示有 MySQL 磁碟空間已滿或網路連線問題。您應採取的行動取決於錯誤是間歇發生與否。

開啟區段  |  全部收合並返回頁首

錯誤是間歇性發生

這些錯誤可能與 MySQL 磁碟已滿有關：

1. 請確認您符合系統需求，且 MySQL 伺服器硬體符合最低要求 (具體來說是足夠的 RAM、CPU 和儲存空間)。
2. 如果是 MySQL 伺服器，請確認：
   1. 您使用 Google 提供的安裝程式安裝 MySQL
   2. 伺服器上沒有其他 MySQL 執行個體
   3. 未安裝任何防毒軟體或防惡意軟體
   4. 如果您已安裝防火牆，請允許通訊埠 3306 的輸入流量

如要進一步瞭解如何在磁碟空間已滿的情況下釋出空間，請參閱「排解 MySQL 磁碟空間已滿的問題」。

錯誤持續發生

這些錯誤的原因可能是網路問題：

1. 請確認下列事項：
   • MySQL 伺服器符合系統需求。

     詳情請參閱「硬體需求」。

   • 您使用 Google 提供的安裝程式安裝 MySQL 軟體。

     詳情請參閱「下載安裝程式」。

   • 您已完成「調整資料庫設定」中的所有步驟。
   • Google Workspace Migrate 叢集中的所有伺服器都位於相同的網路，且彼此之間沒有防火牆或篩選器。
   • MySQL 所用的 Windows Server 上未安裝其他軟體。
   • 您尚未修改預設的 Windows 防火牆設定。
2. 從遠端連線至無法連上 MySQL 伺服器的伺服器，並以管理員身分開啟 PowerShell 視窗。
3. 如要安裝 Telnet 用戶端，請輸入下列指令：

   Install-WindowsFeature -name Telnet-Client

4. 重新啟動 MySQL 伺服器和無法連線的伺服器，然後再試一次。如果問題仍未解決，請繼續進行步驟 6。
5. 如要執行 telnet 測試，請輸入下列指令：

   telnetMySQL-<伺服器 IP 位址> 3306

6. 評估 telnet 測試的結果。如果您：
   • 沒收到錯誤訊息，或者過幾秒鐘後系統顯示「Connection to host missing」訊息，表示可能是網路問題。請再次開啟 Google Workspace Migrate 平台，並重複執行先前失敗的動作，藉此重現錯誤。
   • 您可以使用 telnet 連線，但無法透過 Google Workspace Migrate (來自同一個節點或平台) 連線，本機防火牆可能會封鎖外送連線。請檢查本機伺服器的防火牆設定。
   • 如果系統顯示錯誤訊息，例如「Could not open connection to the host, on port 3306: Connect failed」，請按照下張表格的步驟操作。

在以下部分輸入 telnet MySQL-server-ip-address 3306...	結果與解決步驟
其他節點伺服器或平台伺服器	如果指令在其他伺服器上執行成功，就不太可能是 MySQL 伺服器發生問題。請針對執行 telnet 指令失敗的伺服器，檢查其網路設定。
多部伺服器	如果系統顯示錯誤訊息，表示問題可能出在整個網路或 MySQL 伺服器中。請嘗試以下步驟： 使用遠端桌面連線至 MySQL 伺服器。 在 PowerShell 視窗中輸入下列指令，執行 telnet 測試： telnet MySQL-server-ip-address 3306 如果您在從 MySQL 伺服器輸入指令時收到錯誤訊息，請按照下方的「排解 MySQL 磁碟空間已滿的問題」步驟操作。 如果從 MySQL 伺服器輸入指令時沒有收到錯誤訊息，問題原因可能在於網路。請確認伺服器之間沒有任何防火牆，且伺服器都位於相同的 VLAN。
MySQL 伺服器	如果系統顯示錯誤訊息，表示 MySQL 伺服器發生問題。 在 PowerShell 視窗中輸入下列指令，連線至 localhost： telnet localhost 3306 如果沒有收到任何錯誤訊息，請確認下列事項： MySQL 是透過 Google 提供的安裝程式安裝 未修改設定 如果發生問題，請修正問題並重新啟動伺服器。

排解 MySQL 磁碟空間已滿的問題

當磁碟空間已滿時，您可能會遇到下列情形：

• 橋接設定或分區似乎停滯。
• 橋接設定完成，但未偵測到任何項目。
• 在 HAR 檔案中會顯示 A RelationalDataLocation 或 (Errcode: 28 - No space left on device) 訊息。
• 平台服務主機記錄顯示以下錯誤或類似錯誤：
  • The table 'bridgeexecutionpartitionmappings' is full (「bridgeexecutionpartitionmappings」資料表已滿)。
  • The table 'appbridgeidentity' is full (「appbridgeidentity」資料表已滿)。

  如要找出服務主機記錄，請參閱「查看服務主機記錄」一節。

如果磁碟空間已滿，請透過下列修正方法釋出空間：

• 刪除所有不再需要的橋接設定或專案。
• 使用 Google Compute Engine 擴增空間。請參閱「將永久磁碟新增至 VM」一文。
• 將 MySQL 資料檔案移至較大的磁碟。請參閱 MySQL 說明文件。
• 刪除二進位記錄檔。請參閱「清除二進位檔記錄」。

密碼問題

開啟區段  |  全部收合並返回頁首

修正過期的 MySQL 密碼

系統可能會在您登入平台時顯示空白畫面，而在服務主機記錄中也會顯示以下錯誤訊息：

[MySqlException; HRESULT -2147467259] : Your password has expired. To log in you must change it using a client that supports expired passwords. (您的密碼已過期。如要登入，您必須使用支援過期密碼的用戶端變更密碼)

這項錯誤的發生原因是 MySQL 密碼預設在大約一年後過期。解決方法：

1. 如果您不知道 MySQL 根密碼，請先完成重設 MySQL 根密碼 (位於本頁)。
2. 登入 MySQL 機器，然後開啟命令提示字元。
3. 如要連線至 MySQL，請輸入下列指令：

   C:\MySQL\bin\mysql.exe -h 127.0.0.1 -u root -pRootPassword

   使用 MySQL 根密碼取代「RootPassword」。-p 和密碼之間沒有空格。

4. 如要將密碼設為永不過期，請輸入下列指令：

   ALTER USER USER() IDENTIFIED BY 'RootPassword';
   ALTER USER 'root'@'127.0.0.1' PASSWORD EXPIRE NEVER;
   ALTER USER 'migrate'@'%' PASSWORD EXPIRE NEVER;
   FLUSH PRIVILEGES;

5. 在平台伺服器上重新啟動 Google Workspace Migrate 服務並照常連線。

重設 MySQL 遷移密碼

Google Workspace Migrate 會使用遷移密碼與 MySQL 通訊。如需重設此密碼，請按照下列步驟操作。

步驟 1：重設密碼

1. 如果您不知道 MySQL 根密碼，請先完成本頁的「重設 MySQL 根密碼」步驟。
2. 登入 MySQL 機器，然後開啟命令提示字元。
3. 如要連線至 MySQL，請輸入下列指令：

   C:\MySQL\bin\mysql.exe -h 127.0.0.1 -u root -pRootPassword

   使用 MySQL 根密碼取代「RootPassword」。-p 和密碼之間沒有空格。

4. 如要更新遷移使用者的密碼，請輸入下列指令：

   ALTER USER 'migrate'@% IDENTIFIED BY 'NewUserPassword'; FLUSH PRIVILEGES;

   請使用新的遷移使用者密碼取代「NewUserPassword」。

步驟 2：更新平台

選擇下列任一做法：

我可以存取 Google Workspace Migrate 平台：

1. 在 Google Workspace Migrate 平台中，依序按一下頂端的「Settings」(設定) 圖示 「Database settings」(資料庫設定)。
2. 輸入 MySQL 和 Apache CouchDB 軟體的新密碼。

   您必須提供這兩組密碼。如果您不知道 CouchDB 密碼，請參閱下方的「我無法存取 Google Workspace Migrate 平台」一節。

3. 按一下「Continue」(繼續)。

我無法存取 Google Workspace Migrate 平台：

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

步驟 3：重新連結節點

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

1. 在 Google Workspace Migrate 平台中，按一下頂端的「Servers」(伺服器)。
2. 選取所有節點，然後按一下「Delete」(刪除) 圖示 。
3. 透過 CSV 檔案新增節點或手動輸入。

   詳情請參閱「新增節點伺服器」。

重設 MySQL 根密碼

在下列步驟中，使用新的 MySQL 根密碼取代「NewRootPassword」。

1. 登入 MySQL 電腦。
2. 開啟已提升權限的命令提示字元，然後前往 C:\MySQL\bin。
3. 如要停止 MySQL 服務，請輸入下列指令：

   for /f %a in ('net start ^| find /I "mysql"') do @net stop %a

4. 如要準備設定新密碼的指令檔，請輸入下列指令：

   echo|set /p="ALTER USER 'root'@'127.0.0.1' IDENTIFIED BY 'NewRootPassword';" > password-reset-init.txt

5. 將新密碼記錄在安全的位置。
6. 如要重設密碼，請輸入以下指令：

   mysqld --defaults-file="C:\MySQL\my.ini" --init-file="C:\MySQL\bin\password-reset-init.txt" --console

7. 記錄停止時，按下 Ctrl + Pause 鍵或 Ctrl + Break 鍵結束指令。
8. 如要刪除指令檔，請輸入下列指令：

   del password-reset-init.txt

9. 如要再次啟動 MySQL，請輸入下列指令：

   for /f %a in ('net start ^| find /I "mysql"') do @net start %a

10. 使用超級使用者登入資料庫，並輸入下列指令來測試新密碼：

    C:\MySQL\bin\mysql.exe -h 127.0.0.1 -u root -p

11. 輸入新密碼。

    如果新密碼不成功，請重複以上步驟重設密碼。

節點離線且無法啟動

如果您的節點在 MySQL 密碼到期後無法啟動，請完成下列步驟：

1. 登入節點電腦。
2. 刪除或重新命名 C:\ProgramData\AppBridge\DataSourceSettings.json。
3. 如要重新連結節點伺服器，請完成下列步驟：
   1. 在 Google Workspace Migrate 平台中，按一下右上角的「Servers」。
   2. 選取所有節點，然後按一下「Delete」(刪除) 圖示 。
   3. 透過 CSV 檔案新增節點或手動輸入。

      詳情請參閱「新增節點伺服器」。

相關主題

• 排解 Google Workspace Migrate 相關問題
• 解讀 Google Workspace Migrate 錯誤訊息

_{Google、Google Workspace 與相關符號和標誌均為 Google LLC 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。}