10g RAC 前置驗證神器 CLUVFY 實戰：常見錯誤診斷與 LD_LIBRARY_PATH_64 修正

CLUVFY 核心指令

cluvfy -help
cluvfy stage -pre crsinst -n node1,node2 [-verbose]
cluvfy stage -pre dbinst -n node1,node2 [-verbose]
cluvfy comp -list

經典錯誤：Unable to retrieve database release version

現象

bash-2.05$ cluvfy stage -pre crsinst -n db210-rac2
ERROR: Unable to retrieve database release version. Verification cannot proceed.

根因

LD_LIBRARY_PATH_64 環境變數被 EMC PowerPath 等第三方軟體佔用，導致 CLUVFY 找不到 Oracle 核心庫（libclntsh.so 等）。

修正

# 原狀態
LD_LIBRARY_PATH_64=/opt/EMCpower/lib/sparcv9

# 修正：追加 CRS_HOME/lib
export LD_LIBRARY_PATH_64=/opt/EMCpower/lib/sparcv9:/opt/oracle/product/10.2.0/Crs10g/lib

驗證輸出解讀範例

修正後重驗

bash-2.05$ cluvfy stage -pre crsinst -n db210-rac1,db210-rac2 -verbose
# 所有項目 Passed → 可進行 CRS/RAC 安裝

最佳實踐

1. 環境變數隔離：Oracle 用戶 .profile 明確設定 LD_LIBRARY_PATH_64，避免繼承系統/第三方殘留值
2. 預檢腳本化：將 cluvfy stage -pre crsinst 納入自動化部署 Pipeline，Gate 條件為全綠
3. 修補包基線：維護 OS Patch Baseline 文檔，新節點上線前自動比對
4. 儲存多路徑共存：EMC PowerPath / Veritas DMP 與 Oracle CRS 共存時，LD_LIBRARY_PATH_64 必須雙方庫路徑並存

結語

CLUVFY 是 RAC 部署的「體檢醫生」，LD_LIBRARY_PATH_64 汙染是 Solaris 平台首發陷阱。建立標準化環境變數模板、自動化預檢門禁、修補包基線，可將 RAC 部署成功率從「看運氣」提升至「可預期」。