修改主機名導致 DB2 實例啟動失敗（SQL6031N）的根因與修復

現象描述

在 Windows 平台上，修改伺服器主機名稱後，DB2 實例無法啟動，報錯 SQL6031N，原因碼 10。錯誤訊息提示：「確保在 db2nodes.cfg 第 <行> 行中定義的主機名值在系統上都定義了，並且可操作。」

根本原因

DB2 8.1 起，無論是否分區數據庫，實例目錄下均存在 db2nodes.cfg 文件，記錄節點拓撲資訊。以單分區實例為例，文件內容類似：

0 TSSTEST1 TSSTEST1 0

四欄分別為：節點號、主機名、邏輯主機名、邏輯端口。修改作業系統主機名後，此文件未同步更新，導致實例啟動時解析主機名失敗。

修復步驟

1. 以管理員身份打開實例目錄下的 db2nodes.cfg（Windows 預設路徑：SQLLIB\DB2）。
2. 將舊主機名替換為新主機名（如 TSCTEST1）：

0 TSCTEST1 TSCTEST1 0

3. 保存文件，重新啟動 DB2 實例服務（若設為自動啟動，需同步檢查服務登錄身份密碼）。

注意事項

• 若實例配置為自動啟動，修改主機名後必須同步更新 Windows 服務的登錄帳號密碼，否則仍會報 1069 登錄失敗錯誤。
• 跨平台遷移或叢集環境中，亦需檢查 /etc/hosts、DNS 解析及 db2nodes.cfg 一致性。

總結

主機名變更屬於基礎設施變更，務必同步更新 DB2 拓撲配置文件與服務登錄憑證，避免實例啟動失敗影響業務連續性。