OCI Marketplace 上的 Essbase 需要緊急動作

為了避免服務遺失，在 2026 年 4 月 15 日之前，您必須搭配 OCI 部署上的 Essbase ，使用 2026 年 1 月 28 日之後下載的 Autonomous AI Database 公事包。請依照描述套用修正程式，然後使用 rotate-schema-credentials.sh 命令檔，以新的公事包更新 OCI 部署上的 Essbase 。

附註：

在 21.8.1.0.1 版之前的 OCI 版本上，所有 Essbase 都必須執行此動作。

為何需要執行此動作？

在 2026 年 4 月 15 日之後，DigiCert 將不再信任 G1 根憑證。如果您的 Essbase 例項使用 mTLS 與 2026 年 1 月 28 日之前建立的公事包，您將會失去資料庫連線。為了確保服務不會中斷，rotate-schema-credentials.sh 命令檔需要變更基礎程式庫。

這對我的服務會有何影響？

如果您的 Essbase 市集部署使用 Autonomous AI Database 作為儲存庫，且您在 2026 年 1 月 28 日之前產生公事包，則您的服務將在 2026 年 4 月 15 日後停止運作。舊式錢包使用 G1 根憑證，DigiCert 會失去信任 。

必要動作 - 摘要

在可存取公用網際網路和 Essbase 運算執行處理 /VM 的機器上，下載公事包修正程式檔案，然後將它複製到 Essbase 節點上的 /tmp。將檔案的擁有權變更為 oracle 使用者、停止 Essbase 伺服器，然後套用修補程式。

必要動作 - 步驟

  1. 以 opc 使用者身分登入 Essbase 運算執行處理，然後瀏覽至 /tmp 目錄。

  2. 從下列位置下載 wallet.patch ：

    https://raw.githubusercontent.com/oracle-quickstart/oci-essbase/refs/heads/main/scripts/walletpatch/wallet.patch

    範例：

    wget https://raw.githubusercontent.com/oracle-quickstart/oci-essbase/refs/heads/main/scripts/walletpatch/wallet.patch

  3. 將 wallet.patch 的檔案擁有者變更為 oracle 。

    範例：

    sudo chown oracle:oracle /tmp/wallet.patch

  4. 安裝修補程式公用程式。

    範例：

    sudo yum install -y patch

  5. 切換至 oracle 使用者。

    範例：

    sudo su oracle

  6. 停止 Essbase 。

    範例：

    /u01/config/domains/essbase_domain/esstools/bin/stop.sh

  7. 瀏覽至 /u01/vmtools。

    範例：

    cd /u01/vmtools/

  8. 套用修正程式。

    範例：

    patch -p0 < /tmp/wallet.patch

  9. 執行命令檔以更新您的資料庫公事包。

    範例：

    /u01/vmtools/sysman/rotate-schema-credentials.sh

    (系統會提示您輸入資料庫管理員密碼，並且更新公事包。)

  10. 重新啟動 Essbase。

    範例：

    /u01/config/domains/essbase_domain/esstools/bin/start.sh

  11. 登入 Essbase Web 介面，並確認應用程式是否如預期啟動。

附註：

對於任何其他以公事包為基礎的 Autonomous AI Database 連線，請下載並使用新的公事包。

Essbase 版本 21.5.3 以前的其他步驟

對於 21.5.3 之前的 Essbase 市集版本，在完成上述步驟後，Essbase 應用程式可能無法啟動。

您可能會遇到下列錯誤 -
Error (1350014)
Attempt to execute OCI statement failed. [ORA-29003: SSL transport detected mismatched server certificate.]

解決方案

  1. SSH 進入 Essbase 伺服器，並以 oracle 使用者身分停止 Essbase 。 

    /u01/config/domains/essbase_domain/esstools/bin/stop.sh

  2. 建立舊公事包目錄的備份 (在您的 Essbase 市集清單版本之「公事包目錄位置」底下)。

    公事包目錄位置：

    21c: /u01/config/domains/essbase_domain/config/wallets/wallet

  3. 以下列方式在 sqlnet.ora 和 tnsnames.ora 進行變更，將 <Wallet Directory Location> 取代為上述路徑：

    • sqlnet.ora
      WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="<Wallet Directory Location>"))) SSL_SERVER_DN_MATCH=yes
      to
      WALLET_LOCATION = (SOURCE = (METHOD = file) (METHOD_DATA = (DIRECTORY="<Wallet Directory Location>"))) SSL_SERVER_DN_MATCH=no
    • tnsnames.ora

      附註：

      注意：只有在 tnsnames.ora 設定為 - security= (ssl_server_dn_match=yes) 時，才需要進行下列變更。如果不是，請將 tnsnames.ora 保持原樣並繼續。 
      xxxxxxx_high = (description=
      (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=hostname.oraclecloud.com))
      (connect_data=(service_name=servicename.oraclecloud.com))(security=(ssl_server_dn_match=yes)))

xxxxxxx_low = (description=
      (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=hostname.oraclecloud.com))
      (connect_data=(service_name=servicename.oraclecloud.com))(security=(ssl_server_dn_match=yes)))

xxxxxxx_medium = (description=
        (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=hostname.oraclecloud.com))(connect_data=service_name=servicename.oraclecloud.com))(security=(ssl_server_dn_match=yes)))
      to
      xxxxxxx_high = (description=
      (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=hostname.oraclecloud.com))(connect_data=(service_name=servicename.oraclecloud.com))(security=(ssl_server_dn_match=no)))

xxxxxxx_low = (description=
      (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=hostname.oraclecloud.com))
      (connect_data=(service_name=servicename.oraclecloud.com))(security=(ssl_server_dn_match=no)))

xxxxxxx_medium = (description=
      (retry_count=20)(retry_delay=3)(address=(protocol=tcps)(port=1522)(host=hostname.oraclecloud.com))(connect_data=service_name=servicename.oraclecloud.com))(security=(ssl_server_dn_match=no)))

  4. 其他所有項目都保持不變。遵循這些步驟之後，請啟動 Essbase 伺服器。 

    /u01/config/domains/essbase_domain/esstools/bin/start.sh

  5. 啟動 Essbase 應用程式。

何處可找到其他資訊？

請參閱此連結以瞭解 DigiCert 公告：https://knowledge.digicert.com/general-information/digicert-root-and-intermediate-ca-certificate-updates-2023

如需 OCI Marketplace 部署版本注意事項上的 Essbase ，請參閱：在 OCI 上堆疊部署