DB2 建立存儲過程報錯「instance owner does not belong to fenced user's primary group」根因與解決

錯誤現場

Unix/Linux 平台執行 db2 -td@ -vf <stored_proc_script> 建立存儲過程失敗，db2diag.log 記錄：

DIA8402C A disk error has occurred. ZRC=0x860F0004
...
instance owner does not belong to fenced user's primary group

雖然日誌提示「磁碟錯誤」，實際上是**權限不足**導致無法寫入存儲過程編譯暫存目錄 ~/sqllib/function/routine/sqlproc/<DB>/<INSTANCE>/tmp/。

核心約束規則

DB2 存儲過程編譯/執行機制要求：

DB2 實例擁有者必須屬於 Fenced User（受防護用戶）的主群組（Primary Group）成員。

若實例用戶未加入該群組，編譯器無法以 fenced user 身分存取暫存目錄，拋出偽裝成磁碟錯誤的 ZRC=0x860F0004。

三步驟驗證與修正

1. 找出 Fenced User 及其主群組

cd ~/sqllib/adm
ls -l .fenced
# 輸出範例：
# -r--r--r-- 1 db2fenc1 db2fgrp1 0 Jul 30 09:57 .fenced
# → Fenced User = db2fenc1，Primary Group = db2fgrp1

2. 檢查實例用戶群組成員資格

groups db2inst1
# 若輸出不含 db2fgrp1，即為根因

3. 將實例用戶加入正確主群組

# root 執行
usermod -a -G db2fgrp1 db2inst1

# 驗證
groups db2inst1
# 必須顯示 db2fgrp1

常見陷阱：已加入群組但問題持續 → 檢查是否加錯群組（如加入 fenced user 的次要群組而非主群組），或群組名稱拼寫錯誤。必須與 .fenced 檔案顯示的群組**完全一致**。

修正生效驗證

1. 重新登入實例用戶 Session（或重啟實例 db2stop; db2start）使群組生效
2. 重新執行建立存儲過程腳本，應成功完成
3. db2diag.log 不再出現 DIA8402C

延伸知識：為什麼需要這個約束？

• 存儲過程編譯產生的共享庫（.so/.dll）需寫入實例暫存目錄
• 執行時由 Fenced Mode Process（db2fmp） 載入共享庫，以 fenced user 身分運行，隔離主引擎進程
• 編譯階段實例用戶需以 fenced user 權限寫入暫存目錄 → 需共享主群組實現目錄寫入權限

總結

「磁碟錯誤」實為權限遮蔽。記住鐵律：**Instance Owner ∈ Primary Group of Fenced User**。排查三步驟（看 .fenced → 查 groups → 改 usermod）即可秒解，避免在磁碟硬體、檔案系統層面無謂排查。