4.50.00.11 - Edge for Private Cloud 版本資訊

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。
info

我們已於 2021 年 9 月 23 日發布新版 Apigee Edge for Private Cloud。

更新程序

更新這個版本會更新下列 RPM 清單中的元件:

  • edge-analytics-4.50.00-0.0.40046.noarch.rpm
  • apigee-sso-4.50.00-0.0.21034.noarch.rpm
  • apigee-tomcat-8.5.64-0.0.917.noarch.rpm
  • apigee-machinekey-1.1.0-0.0.20008.noarch.rpm
  • apigee-lib-4.50.00-0.0.1019.noarch.rpm
  • apigee-cassandra-2.1.22-0.0.2527.noarch.rpm
  • apigee-cassandra-client-2.1.22-0.0.2512.noarch.rpm
  • apigee-setup-4.50.00-0.0.1128.noarch.rpm
  • apigee-service-4.50.00-0.0.1428.noarch.rpm
  • apigee-configutil-4.50.00-0.0.613.noarch.rpm
  • edge-gateway-4.50.00-0.0.20140.noarch.rpm
  • edge-management-server-4.50.00-0.0.20140.noarch.rpm
  • edge-message-processor-4.50.00-0.0.20140.noarch.rpm
  • edge-postgres-server-4.50.00-0.0.20140.noarch.rpm
  • edge-qpid-server-4.50.00-0.0.20140.noarch.rpm
  • edge-router-4.50.00-0.0.20140.noarch.rpm
  • edge-mint-gateway-4.50.00-0.0.30233.noarch.rpm
  • edge-mint-management-server-4.50.00-0.0.30233.noarch.rpm
  • edge-mint-message-processor-4.50.00-0.0.30233.noarch.rpm
  • edge-management-ui-4.50.00-0.0.20020.noarch.rpm
  • edge-ui-4.50.00-0.0.20198.noarch.rpm
  • edge-management-ui-static-4.50.00-0.0.20033.noarch.rpm
  • apigee-validate-4.50.00-0.0.624.noarch.rpm
  • apigee-mtls-4.50.00-0.0.20224.noarch.rpm
  • apigee-adminapi-4.50.00-0.0.607.noarch.rpm

如要查看目前安裝的 RPM 版本是否需要更新,請輸入:

apigee-all version

如要更新安裝項目,請在 Edge 節點上執行下列程序:

  1. 在所有 Edge 節點上:

    1. 清除 Yum 存放區:
      sudo yum clean all
    2. 下載最新的 Edge 4.50.00 bootstrap_4.50.00.sh 檔案至 /tmp/bootstrap_4.50.00.sh:
      curl https://software.apigee.com/bootstrap_4.50.00.sh -o /tmp/bootstrap_4.50.00.sh
    3. 安裝 Edge 4.50.00 apigee-service 公用程式和依附元件:
      sudo bash /tmp/bootstrap_4.50.00.sh apigeeuser=uName apigeepassword=pWord

      其中 uName:pWord 是您從 Apigee 收到的使用者名稱和密碼。 如果省略 pWord,系統會提示你輸入。

    4. 更新 apigee-setup 公用程式:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-setup update
    5. 更新 apigee-lib 公用程式:
      sudo /opt/apigee/apigee-service/bin/apigee-service apigee-lib update
    6. 使用 source 指令執行 apigee-service.sh 指令碼:
      source /etc/profile.d/apigee-service.sh
  2. 更新管理伺服器上的 apigee-validate 公用程式:
    /opt/apigee/apigee-service/bin/apigee-service apigee-validate update
  3. 更新 apigee-adminapi 公用程式:
    /opt/apigee/apigee-service/bin/apigee-service apigee-adminapi update
  4. 更新 apigee-machinekey 公用程式:
    /opt/apigee/apigee-service/bin/apigee-service apigee-machinekey update
  5. 更新 apigee-config 公用程式:
    /opt/apigee/apigee-service/bin/apigee-service apigee-configutil update
  6. 更新所有 Cassandra 節點:
    /opt/apigee/apigee-setup/bin/update.sh -c cs -f configFile

    其中 configFile 指定用於安裝 Apigee Edge for Private Cloud 的設定檔。例如:/opt/silent.conf。

  7. 在所有 Edge 節點上,執行邊緣程序的 update.sh 指令碼:
    /opt/apigee/apigee-setup/bin/update.sh -c edge -f configFile
  8. 在所有節點上執行單一登入的 update.sh 指令碼:
    /opt/apigee/apigee-setup/bin/update.sh -c sso -f configFile
  9. 在所有節點上執行 UI 的 update.sh 指令碼:
    /opt/apigee/apigee-setup/bin/update.sh -c ui -f configFile
  10. 如果您使用新版 Edge,請執行下列指令:
    /opt/apigee/apigee-setup/bin/update.sh -c ue -f configFile
  11. 如果您使用 Apigee mTLS,請按照「升級 Apigee mTLS」一文所述的程序操作。詳情請參閱「Apigee mTLS 簡介」。

支援的軟體異動

這個版本支援的軟體沒有任何異動。

淘汰與停用

這個版本沒有任何新淘汰或停用的項目。

新功能

這個版本推出下列新功能:

nodetool 修復工具的新包裝函式

包裝函式會在執行 nodetool 修復前,對磁碟空間 (Cassandra 掛接位置) 進行健全性檢查。此外,這個包裝函式也支援 JMX 驗證,以及透過 JMX 相關設定的 SSL。

在 LDAP 政策中,新增對 <BaseDN> 元素動態字串替換的支援。

LDAP 政策的 <BaseDN> 元素會指定 LDAP 的基本層級,所有資料都位於這個層級之下。在此版本中,我們已在元素中新增 ref 屬性,您可以使用該屬性指定包含 <BaseDN> 值的流程變數,例如 apigee.baseDN。ref 的優先順序高於明確的 BaseDN 值。如果您同時指定 ref 和值,系統會優先採用 ref。如果 ref 無法在執行階段解析,則會使用 value。

修正錯誤

本節列出此版本修正的私有雲錯誤。

問題 ID 說明
197513151

修正傳統 UI 中 jQuery 指令碼路徑不一致的問題

151852439

由於 .properties 檔案設定錯誤,導致使用者介面的強化記錄功能無法運作

這個問題已修正。
194875545

從開發人員應用程式頁面導覽至開發人員時發生 404 錯誤

這個問題已修正。
179769806

公司未顯示在 Edge 使用者介面中

這個問題已修正。
188039112

Edge UI 中自行簽署的憑證信任問題

這個問題已修正。
195932618

console.log() 導致記錄過多

這個問題已修正。
193216745

Cassandra 設定指令碼中的資料中心名稱排序方式有小錯誤。

這個問題已修正。
1195932115

Apigee SSO 在回應中傳回的堆疊追蹤記錄不正確。

這個問題已修正。請注意,堆疊追蹤記錄仍會記錄。
79591934

apigee-validate 失敗,並顯示不明訊息

這個問題已修正。改善 apigee-validate 指令碼的錯誤記錄功能。
174732169

系統記錄訊息遭到錯誤捨棄

這個問題已修正。
193239069

從 Gateway 和 Machinekey 元件中移除舊版金鑰

197760258

權限 API 發生故障,導致 Edge UI 與 Gateway 之間出現相容性問題

修正了啟用外部 LDAP 驗證時發生的問題。
194485178

從所有 HTTP 要求和回應限制屬性中移除開頭和結尾的空格

193918953

從閘道元件中移除部分未使用的設定

112262604

執行 Postgres 容錯移轉時,需要更新 Mint 管理伺服器

我們已建立強化版指令碼,可變更 Mint Management Server 的 Postgres 連線詳細資料。請參閱處理 PostgreSQL 資料庫容錯移轉。
197301743

Java 1.8.0_3XX 中的大型 SSL 握手訊息會導致問題

這個問題已修正。
188526117

ip 指令未加上絕對路徑前置字元

這個問題已修正。Apigee 指令現在會完整限定指令路徑。
171240470

啟用 Cassandra JMX 驗證或 SSL 時,管理更新作業會失敗

新增功能:在管理伺服器上執行設定或更新時,提供 Cassandra JMX 驗證和 SSL 設定。
193564174

Edge UI Analytics 資訊主頁無法擷取資料

修正環境名稱中含有半形句號時,Analytics 查詢會失敗的錯誤。
167960487

維度文字中含有保留字 AND/OR,導致 Analytics 報表無法正常運作。

這個問題已修正。
132402519

router.properties 的 IP 位址清單中有多餘的空白字元,導致路由器無法啟動

這個問題已修正。多餘的空白現已移除。
184573211

Apigee SSO 模組不再預設啟用 Java 管理擴充功能 (JMX)。

修正安全性問題

以下列出已在這個版本中修正的已知安全性問題。 為避免發生這些問題,請安裝最新版 Edge Private Cloud。

問題 ID 說明
不適用

由於系統會正常記錄設定檔差異變更,因此 Edge for Private Cloud 會記錄密碼。如要避免記錄設定變更,請按照下列步驟操作:

  • 如果已安裝 Edge 元件,請執行下列任一步驟:
    • 將 LOGGER_PRINT_CONFIG_DELTA=false 設為環境變數。 這會停止記錄該節點上所有元件的設定差異。
    • 如要停止記錄特定元件的設定差異,請將 logger.print.config.delta=false 加入該元件的客戶專屬設定檔。這樣一來,系統就會停止記錄該元件的設定變更。 詳情請參閱「如何設定 Edge」。
  • 如果您要安裝 Edge 元件,可以在 silent.conf 檔案中新增下列項目,防止系統記錄設定變更:
    CONFIG_DELTA_LOG=n

    這會將元件設定為不記錄設定變更。

不適用 提升平台儲存密碼和相關資料的安全性。
CVE-2015-9251 當執行跨網域 Ajax 要求時,如果 jQuery 中沒有 dataType 選項,跨網站指令碼 (XSS) 問題就會修正。
不適用 新增額外防護措施,防範 SAML 聲明重送攻擊。

已知問題

如需完整清單,請參閱「Edge for Private Cloud 的已知問題」。