Oracle 伺服器 IP 變更後的 Listener 與 TNS 設定更新指南

Oracle 伺服器 IP 變更後的 Listener 與 TNS 設定更新指南

資料庫伺服器 IP 變更後，Listener 無法啟動、客戶端無法連線，需同步更新伺服器端 listener.ora 與客戶端 tnsnames.ora 中的 HOST 參數。

伺服器端：更新 listener.ora

路徑：$ORACLE_HOME/network/admin/listener.ora

LISTENER =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC1))
      (ADDRESS = (PROTOCOL = TCP)(HOST = 新IP)(PORT = 1521))
    )
  )

修改完成後重啟 Listener：

lsnrctl stop
lsnrctl start

客戶端：更新 tnsnames.ora

路徑：$ORACLE_HOME/network/admin/tnsnames.ora（或 TNS_ADMIN 指定目錄）

ORCL =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = 新IP)(PORT = 1521))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = orcl)
    )
  )

客戶端無需重啟，修改即時生效。

驗證步驟

1. 伺服器端：lsnrctl status 確認 Listener 監聽正確 IP/Port。
2. 伺服器端：lsnrctl services 確認服務已註冊。
3. 客戶端：tnsping ORCL 確認解析成功。
4. 客戶端：sqlplus user/pass@ORCL 測試連線。

常見遺漏項目

• 多張網卡：確認 Listener 綁定正確介面，或使用 HOST=0.0.0.0 監聽所有介面。
• SCAN VIP (RAC)：需同步更新 SCAN DNS、SCAN Listener 設定。
• 防火牆/安全群組：新 IP 需開放 1521 (或自訂 Port) 通訊。
• 應用程式連線池：檢查 JDBC URL、DataSource 設定是否使用主機名而非 IP，若用 IP 須同步更新。