疑難排解使用 gMSA 的 SQL Server 容錯移轉叢集執行個體失敗問題

適用於:Windows 上的 SQL Server

Summary

本文將協助你排除 SQL Server 故障轉移叢集實例(FCI)的故障,當 SQL Server 服務在群組管理服務帳號(gMSA)下執行時,設定、新增節點、啟動及故障轉移失敗的情況。 它涵蓋了對每個可能擁有者節點的託管密碼擷取、節點特定權限與啟動參數、不完整的設定狀態,以及叢集資源故障。

開始前,請先檢視前置條件,並執行 Troubleshoot SQL Server 設置、啟動及 gMSA 驗證失敗的快速驗證清單。

Symptoms

  • FCI 設定在帳號驗證時失敗。
  • 新增節點操作會報告服務帳號資訊不一致。
  • SQL Server 從命令列啟動,但不會從叢集開始。
  • 故障轉移失敗是因為缺少節點特定的啟動參數或設定。

原因

FCI 失敗可能涉及密碼擷取、設定中繼資料不完整、節點特定啟動參數、各節點權限差異、儲存存取權限或叢集服務健康檢查。 gMSA 特有的原因是,一個或多個可能的擁有者節點未被授權取得受管理密碼,因此實例在某些節點運作,在其他節點則失敗。

診斷故障轉移叢集實例故障

  1. 對每個可能的擁有者節點執行 快速驗證檢查清單 ,並比較結果。

    對每個可能的擁有者節點執行以下指令。

    Test-ADServiceAccount -Identity 'SQLgMSA'
    sc.exe qmanagedaccount MSSQLSERVER
    Get-ClusterResource | Format-Table Name, ResourceType, State, OwnerGroup -AutoSize
    
  2. 比較服務身份、管理帳戶狀態、有效權限及節點間啟動參數。

    預期結果:Test-ADServiceAccount 在每個可能的擁有者節點上都會傳回 True,且對於同一個 FCI,其服務組態與啟動參數一致。

  3. 檢視取消或不完整的新增節點操作的設定歷史。

  4. 收集同一資源轉移的 SQL Server 錯誤日誌和叢集日誌。

    請執行以下指令產生叢集日誌。

    Get-ClusterLog -UseLocalTime -Destination C:\Temp
    

解決故障轉移叢集實例故障

使用與診斷步驟證據相符的解決方案。

授權所有可能的擁有者節點取得受管理密碼

授權所有可能的擁有權節點擷取受管理的密碼,接著重新測試容錯移轉至各個節點。 若 gMSA 授權個別電腦帳戶, Set-ADServiceAccount 則會取代完整的授權主體清單。 請先檢查現有值,並納入所有必須持續保有授權的主體。

# Review the gMSA configuration
Get-ADServiceAccount -Identity "SQLgMSA" `
    -Properties PrincipalsAllowedToRetrieveManagedPassword |
    Select-Object Name, PrincipalsAllowedToRetrieveManagedPassword

# If individual computer accounts are used, authorize each possible owner node
Set-ADServiceAccount -Identity "SQLgMSA" `
    -PrincipalsAllowedToRetrieveManagedPassword "NODE1$","NODE2$","NODE3$"

# Verify the gMSA from each possible owner node
Invoke-Command -ComputerName NODE1,NODE2,NODE3 {
    Test-ADServiceAccount -Identity "SQLgMSA"
}

如果安全群組授權 gMSA,請將可能的擁有者節點加入該群組,而非取代現有的 gMSA 主體。

Add-ADGroupMember -Identity "SQL-FCI-gMSA-Nodes" `
    -Members "NODE1$","NODE2$","NODE3$"

欲了解更多資訊,請參閱以下文章:

更正節點特定權限、啟動參數或不完整的安裝狀態

修正已確認的節點專屬權限、啟動參數或不完整的 Setup 狀態。 在每個節點執行以下指令並比較結果。 將 替換 <InstanceID> 為實例 ID,例如 MSSQL16.MSSQLSERVER。

# Verify the SQL Server service account on each node
Get-CimInstance Win32_Service -Filter "Name='MSSQLSERVER'" |
    Select-Object Name, StartName, State, StartMode

# Compare SQL Server startup parameters on each node
reg query "HKLM\SOFTWARE\Microsoft\Microsoft SQL Server\<InstanceID>\MSSQLServer\Parameters"

# Check the SQL Server Windows service configuration
sc.exe qc MSSQLSERVER

使用 SQL Server 組態管理員 來修正啟動參數差異,而非手動編輯登錄檔。 欲了解更多資訊,請參閱以下文章:

如果叢集資源故障與服務帳號無關,請使用以下指令檢視叢集角色、叢集資源及叢集日誌。

# List clustered roles and their current owner/state
Get-ClusterGroup

# List cluster resources and their current state
Get-ClusterResource |
    Format-Table Name, ResourceType, State, OwnerGroup -AutoSize

# Identify SQL Server-related cluster resources
Get-ClusterResource |
    Where-Object { $_.ResourceType -like "*SQL*" } |
    Format-Table Name, ResourceType, State, OwnerGroup -AutoSize

# Generate cluster logs
New-Item -ItemType Directory -Path "C:\ClusterLogs" -Force
Get-ClusterLog -UseLocalTime -Destination "C:\ClusterLogs"

FailoverClusters PowerShell 模組提供 Get-ClusterGroup、 Get-ClusterResource、 及 Get-ClusterLog cmdlet。 欲了解更多關於這些指令的資訊,請參閱以下文章:

關於 SQL Server 特有的失敗案例,請參閱以下文章:

重新建立缺少的資源專用登錄鍵

若要重新建立缺少的資源專屬登錄檔金鑰,請依照 「手動重建資源專屬登錄鍵」中的步驟操作。 在你進行文件化的登錄檔變更之前,先先辨識 SQL Server 叢集資源並備份叢集登錄檔。

# Identify the SQL Server cluster resources
Get-ClusterResource |
    Where-Object { $_.ResourceType -like "*SQL*" } |
    Format-Table Name, ResourceType, State, OwnerGroup

# Back up the cluster registry before making documented registry changes
New-Item -ItemType Directory -Path "C:\Temp" -Force
reg export "HKLM\Cluster" "C:\Temp\ClusterRegistryBackup.reg" /y

注意事項

不要在無關的實例間複製登錄檔值。 在更改之前,請確認實例 ID、共享儲存路徑、叢集角色和節點。

收集診斷資料

如果完成這些步驟後失敗依舊,請從所有可能的擁有者節點收集診斷資料,包括同一資源轉移的叢集日誌。 關於 gMSA 專屬證據及標準 SQL Server 日誌,請參閱 gMSA 故障排除概述中的「收集診斷資料」。 利用這些資料繼續調查或開啟支援案件。