4.19.06 Edge for Private Cloud 版本資訊

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

本節說明 Edge for Private Cloud 功能發布版本 4.19.06。

版本摘要

下表彙整這個版本的異動內容:

新功能

這個版本包含下列新功能:

○ 支援 LDAP 單一登入
○ 支援 HTTP 部署
○ 可外掛的 Analytics
○ 支援 Cassandra 機架
○ 支援 IPv6
○ 簡化 New Edge 體驗的安裝程序
○ 排除 INVALID_TSC 交易 (營利)

如要進一步瞭解這些新功能,請參閱「新功能」。

回溯相容性

這個版本的 Apigee Edge 私有雲導入了下列影響回溯相容性的問題:

     
  • 由於修正了問題 132443137 (如公開雲端 19.03.01 版發行說明所述),訊息處理器現在會忽略開頭為 X-Apigee-* 的標頭。因此,您必須重構使用 X-Apigee-* 標頭的任何程式碼,並將這些標頭替換為支援的標頭。

  • Cassandra 記錄檔的名稱已變更。現在:

    /opt/apigee/var/log/apigee-cassandra/system.log
包含的發布版本

自上一個 Edge for Private Cloud 功能版本發布以來,已發布下列版本,並納入這個版本:

○ Edge:
   19.07.23 (UI)
   19.03.01
   19.02.19
   19.02.04
   19.01.23
   19.01.14
   18.12.04
   18.08.31
   18.07.31
○ 入口:
   19.07.08
   19.05.23
   19.05.08
   19.04.18
   19.03.20
   19.02.27
   19.02.21
   19.02.04
   19.01.16
淘汰 無
淘汰項目

4.19.06 版發布後,下列項目將遭到淘汰:

  • 4.18.01:Apigee Edge for Private Cloud 4.18.01 版已淘汰。

詳情請參閱「Apigee 淘汰、停用和 CPS 異動」。

修正錯誤

這個版本修正了下列錯誤:

○ UseStringDeduplication 未設定 (140270474)
○ MP 錯誤 (111445518)
○ 發生 JMX 的 Cassandra 失敗 (113342838)
○ 13 節點升級 (138931337)
○ 具有相同名稱的 Proxy (119802562)
○ 金鑰儲存區未載入 (118851790)
○ Analytics 失敗 (110988191)
○ 備份失敗 (110785400)
○ 對 Node.js 的 HEAD 要求 (79993247)
○ apigee-postgres 備份/還原 (70291825)
○ 重設系統管理員密碼 (65737520)

如要進一步瞭解各項修正,請參閱「錯誤修正」。

已知問題

這個版本包含下列已知問題:

○ Mint 一開始未評估交易 (141628497)
○ Mint 評估伺服器記憶體流失 (137865184)
○ apigee-sso 安裝的中繼資料檔案格式 (135616498)
○ Amazon Linux 1 不支援 apigee-monit (122370980)
○ 訊息處理器 備份未備份正確的檔案集 (121095148)
○ 多資料中心設定中的 DataAccessExceptions (76087166)
○ MessageLogging 政策會在記錄訊息中加入額外資訊 (68722102)

如要進一步瞭解各項已知問題 (包括解決方法),請參閱「已知問題」。

升級路徑

下表列出這個版本的升級路徑:

4.19.01 以上版本 直接從 4.19.01 升級至 4.19.06
4.18.05 版起 直接從 4.18.05 升級至 4.19.06
4.18.01 版起 直接從 4.18.01 升級至 4.19.06

新功能

本節列出此版本的新功能。此外,這個版本也包含「隨附版本」中列出的 Edge UI、Edge Management 和入口網站版本的所有功能。

除了下列強化功能,這個版本也包含多項可用性、效能、安全性及穩定性強化功能。

支援 HTTP 部署作業

根據預設,Edge 會使用 RPC 部署 API Proxy。雖然這個模式適用於大多數安裝作業,但如果拓撲較大且包含許多 MP,透過 RPC 進行大量並行呼叫時,可能會發生逾時問題。

因此,Apigee 建議大型部署作業使用 HTTP 而非 RPC 進行部署。現已支援啟用 HTTP 部署作業。

詳情請參閱「啟用 HTTP 部署作業」。

Cassandra 機架支援

Apigee 現在提供一般指引,讓 Apigee Edge for Private Cloud 上的 Cassandra 支援機架感知功能,進而擴大 Cassandra 的作業規模。

詳情請參閱「Cassandra 機架支援」。

可外掛的數據分析

根據預設,訊息處理器收集的 Analytics 資料會上傳至 Qpid 和 Postgres 進行處理。然後在 Edge 使用者介面中查看分析資料。

透過這項功能版本,您可以設定訊息處理器將數據分析資料寫入磁碟,也可以選擇同時使用這兩種選項。

詳情請參閱「將 Analytics 資料寫入檔案」。

簡化新版 Edge 體驗的安裝程序

我們提供新指令碼,簡化了 New Edge 體驗的安裝程序。

詳情請參閱「安裝 New Edge Experience」。

支援 LDAP IDP

除了 SAML 之外,現在還支援使用 Edge UI 和 Edge 管理 API 呼叫驗證 LDAP 使用者。LDAP 支援直接繫結和間接繫結方法。

詳情請參閱「外部 IDP 驗證總覽」。

支援 IPv6

根據預設,對 Apigee Edge for Private Cloud 的所有執行階段 API 呼叫都會使用 IPv4。您可以使用新屬性,在路由器中新增 IPv6 支援。

詳情請參閱「在路由器上使用 IPv6」。

排除 INVALID_TSC 交易 (營利)

現在使用營利功能時,可以排除 INVALID_TSC 交易,避免這類交易新增至 Postgres 資料庫。

詳情請參閱「營利伺服器屬性」。

支援的軟體

這個版本對支援的軟體進行了下列變更:

已新增支援 停止支援

這個版本新增了對下列平台的支持:

  • Red Hat Enterprise Linux (RHEL) 6.10
  • CentOS 6.10
  • Oracle Linux 6.9

這個版本不再支援下列平台:

  • Red Hat Enterprise Linux (RHEL) 6.9
  • CentOS 6.9
  • Oracle 6.8

如需支援平台的完整清單,請參閱「支援的軟體和版本」。

修正錯誤

本節列出這個版本修正的私有雲錯誤。此外,這個版本也包含「Included Releases」中顯示的 Edge UI、Edge Management 和 Portal 版本的所有錯誤修正。

問題 ID 說明
140270474

UseStringDeduplication 未設定

UseStringDeduplication 未在正式環境中為 edge-message-processor 元件設定。
111445518

MP 錯誤

訊息處理器每 5 分鐘就會持續記錄下列錯誤訊息:
2019-06-29 00:02:05,775 Apigee-Timer-6 ERROR CMgmt -
  ConnectorServiceImpl.refreshToken() : Connector Management API auth token
  generation failed: 0 null
113342838

透過 JMX 瞭解 Cassandra 故障情形

啟用 JMX 驗證後,Cassandra 作業無法運作
138931337

13 節點升級

從 17.09、18.01 和 18.05 升級 13 節點安裝項目時發生錯誤。
119802562

名稱相同的 Proxy

如果同一機構的兩位使用者建立的 Proxy 名稱相同,後者會覆寫前者。只有在不同使用者無法看到其他 Proxy 時,才會發生這種情況。
118851790

無法載入 KeyStore

如果機構/環境的 Keystore 超過 100 個,Edge UI 中的 Keystore 和參照部分就不會載入。但使用者介面卻顯示 Internal Error (Error Fetching Keystores) 錯誤。
110988191

Analytics 失敗

如果從設為未來日期的 Microgateway 提供資料,Analytics 就會無法運作。
110785400

備份失敗

ZooKeeper、Cassandra 和 OpenLDAP 間歇性無法正確備份資料,並顯示以下錯誤:File changed as we read it.
79993247

HEAD 要求至 Node.js

HEAD 對 Node.js 目標的要求可能會停滯,導致連線待處理。
70291825

apigee-postgres 備份/還原

執行 apigee-postgres 備份/還原作業時,系統會備份所有元件的資料。
65737520

重設系統管理員密碼

如果管理伺服器的系統管理員密碼含有特殊字元,重設密碼就會失敗。

已知問題

下表列出這個版本的已知問題:

問題 ID 說明
141628497

Mint 最初不會評估交易

首次為機構啟用營利功能時,私有雲專用的 Edge 不會對交易進行評估。這項規定適用於新機構和現有機構。

營利啟用 API 會回傳工作 ID,完成後,工作狀態會顯示成功。不過,系統不會處理或評估最初發出的任何營利 API 呼叫。這些交易只會顯示在一般數據分析中。

解決方法:

重新啟動所有訊息處理器 (MP),方法如下:
apigee-service edge-message-processor restart

啟用營利功能後,重新啟動 MP 會導致 Edge 在啟動時從 ZooKeeper 載入設定。每次重新啟動時都會發生這種情況,因此問題只會出現在一開始。

137865184

Mint 評分伺服器記憶體流失

在 mxgroup 中註冊新的 Qpid 執行個體時,佇列會建構但沒有消費者,導致佇列深度不斷增加,直到用盡所有可用資源為止。

解決方法:

無。
135616498

apigee-sso 安裝的中繼資料檔案格式

安裝 apigee-sso 時,如果使用 metadata.xml 檔案而非網址,且 metadata.xml 檔案結尾未包含新行 (CRLF),系統就不會完整讀取 metadata.xml 檔案。

解決方法:

如要解決這個問題,請採取下列任一做法:

  • 在 metadata.xml 檔案結尾新增 CRLF

    或

  • 使用網址式中繼資料位置
122370980

apigee-monit Amazon Linux 1 不支援這項功能

解決方法:

無。
121095148

訊息處理器備份未備份正確的檔案集

解決方法:

再次執行備份,這次應該就能備份正確的檔案集。

76087166

多個資料中心設定中的 DataAccessException

在多個資料中心設定中,如果其中一個資料儲存庫無法使用,您可能會看到下列錯誤:

DataAccessException: Error while accessing datastore;
Please retry later

因此,管理伺服器可能會無法啟動,因為它會嘗試連線至 dc-1 和 dc-2 中的 Cassandra 節點。如果 Cassandra 節點關閉,就會發生 DataAccessExceptions。這也可能導致 API 流量中斷,訊息處理器會在嘗試擷取 KVM 時回報 DataAccessExceptions。

請注意,預期狀態是管理伺服器不會連線至跨區域的資料存放區元件。

解決方法

解決方法是在無法使用的資料中心取消註冊下列 Cassandra 節點類型,然後在 Cassandra 節點再次可用時重新註冊:

  • kms-datastore
  • dc-datastore
  • keyvaluemap-datastore

如要取消註冊並重新註冊這些 Cassandra 節點類型,請按照下列步驟操作:

  1. 使用下列 curl 指令取得 Cassandra 節點的 UUID:
    curl -u ADMIN_EMAIL:ADMIN_PW \
      "http://MS_IP:MS_PORT/v1/servers?region=REGION&pod=GATEWAY_POD \
      &type=CASSANDRA_NODE_TYPE"

    地點:

    • ADMIN_EMAIL 和 ADMIN_PW 是 Apigee 帳戶的憑證。
    • MS_IP 和 MS_PORT 是管理伺服器的 IP 位址和通訊埠號碼。
    • REGION 是管理伺服器所在的資料中心名稱。
    • GATEWAY_POD 是 Pod 名稱,預設為「gateway」。不過,您可能已將其重新命名為其他名稱,因此請檢查您的實作項目。
    • CASSANDRA_NODE_TYPE 是 kms-datastore、dc-datastore 和 keyvaluemap-datastore 其中之一。

    例如:

    curl -u nickdanger@google.com:myP@$$w0rD
      "http://192.168.0.1:8080/v1/servers?region=dc-1&pod=gateway&type=dc-datastore"

    回應格式如下:

    {
      "internalIP" : "POD_IP_ADDRESS",
      "isUp" : [true|false],
      "pod" : "GATEWAY_POD",
      "reachable" : [true|false],
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : [ "kms-datastore", "dc-datastore", "keyvaluemap-datastore" ],
        "uUID" : "POD_UUID"
    }

    例如:

    {
      "internalIP" : "192.168.1.11",
      "isUp" : false,
      "pod" : "gateway",
      "reachable" : false,
      "region" : "dc-1",
      "tags" : {
        "property" : [ ]
      },
      "type" : "dc-datastore",
      "uUID" : "13cee956-d3a7-4577-8f0f-1694564179e4"
    }

    請注意回應中 uUID 欄位的值,您會使用這些節點取消註冊節點。

  2. 針對每個 Cassandra 節點類型重複步驟一:kms-datastore、dc-datastore 和 keyvaluemap-datastore。請務必記下傳回的 UUID。
  3. 使用下列指令取消註冊節點:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers/UUID" -X DELETE

    其中 UUID 是先前指令回應中傳回的 UUID。

  4. 針對步驟 1 和 2 中收集到的每個 UUID 重複執行步驟 3。
  5. 使用下列指令重新註冊節點:
    curl -u ADMIN_EMAIL:ADMIN_PW "http://MS_IP:MS_PORT/v1/servers -d \
      "Type=kms-datastore&Type=dc-datastore&Type=keyvaluemap-datastore& \
      Type=counter-datastore&Type=cache-datastore&InternalIP=POD_IP_ADDRESS& \
      region=REGION&pod=GATEWAY_POD" -H \
      'content-type: application/x-www-form-urlencoded' -X POST

請注意,這些作業會向 Zookeeper 註冊及取消註冊節點,不會對 Cassandra 叢集造成任何影響。如要進一步瞭解這些指令,請參閱「更新資料存放區註冊」。

68722102

MessageLogging 政策,包括記錄訊息中的額外資訊

MessageLogging 政策的 FormatMessage 元素會控管記錄訊息的格式。當 FormatMessage=false 時,記錄的訊息不應包含任何 Apigee 產生的資訊。不過,即使您設定 FormatMessage=false,記錄訊息仍會包含下列資訊:

  • 優先順序分數
  • 時間戳記

解決方法:

無。

下一步

如要開始使用 Edge for Private Cloud 4.19.06,請點選下列連結:

新安裝人數:
新安裝服務總覽
現有安裝數:
升級路徑