4.19.06 Edge for Private Cloud 版本資訊

查看 Apigee Edge 說明文件。
前往 Apigee X說明文件
資訊

本節說明適用於 Private Cloud 功能版本的 Edge 4.19.06 版,

版本摘要

下表摘要列出這個版本的變更:

新功能

此版本包含以下新功能:

○ LDAP 對單一登入 (SSO) 的支援
○ HTTP 部署支援
○ 插入式分析
○ Cassandra 機架支援
○ IPv6 支援
○ 簡化新版 Edge 體驗的安裝程序
○ 排除 INVALID_TSC 筆交易 (營利)

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

回溯相容性

這個版本導入了下列影響回溯相容性的問題 Apigee Edge for Private Cloud:

     
  • 由於修正了問題 132443137 ( 19.03.01 公開 Cloud 版本資訊),訊息處理器現在會忽略開頭為 X-Apigee-*。因此,您必須重構任何使用 X-Apigee-* 標頭,並替換為支援的標頭。

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

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

自舊版 Private Cloud 功能發布以來,下列版本 出現且包含於此版本:

○ 邊緣:
19.07.23 (使用者介面)
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:適用於 Private Cloud 的 Apigee Edge 4.18.01 版現已淘汰。

若需更多資訊,請參閲 Apigee 淘汰、淘汰和 CPS 變更

修正錯誤

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

○ UseStringDeduplication 未設定 (140270474)
○ MP 錯誤 (111445518)
○ JMX 發生 Cassandra 失敗 (113342838)
○ 13 個節點升級作業 (138931337)
○ 相同名稱 Proxy (119802562)
○ KeyStore 無法載入 (118851790)
○ Analytics 失敗 (110988191)
○ 備份失敗 (110785400)
HEAD 傳送至 Node.js (79993247)
○ apigee-postgres 備份/還原 (70291825)
○ 重設 sysadmin 密碼 (65737520)

如要進一步瞭解這些修正項目,請參閱錯誤修正

已知問題

此版本包含以下已知問題:

○ Mint 一開始未對交易評分 (141628497)
○ Mint 評分伺服器記憶體流失 (137865184)
○ apigee-sso install (135616498) 的中繼資料檔案格式
apigee-monit 不適用於 Amazon Linux 1 (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 管理和入口網站版本中 包含的版本

除了下列強化功能以外,這個版本還包含多個可用性。 效能、安全性和穩定性

支援 HTTP 部署

根據預設,Edge 會使用 RPC 部署 API Proxy。雖然大多數人 大量安裝、大型拓撲可能會因大量 MP 下載而逾時 並行呼叫是透過 RPC 進行

因此,Apigee 建議大型部署作業使用 HTTP,而不要使用遠端程序呼叫 (RPC) 可能面臨擴充性、監控、持續整合 和部署等方面的挑戰現在支援啟用 HTTP 部署功能。

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

支援 Cassandra 機架

Apigee 現在透過讓 Cassandra 制定 Cassandra 資源調度作業,提供一般的指引 適用於 Private Cloud 機架感知的

若需更多資訊,請參閲 Cassandra 機架支援

插入式數據分析

根據預設,Message Processor 收集的分析資料會上傳到 Qpid 和 Postgres 以便處理。接著,您就可以在 Edge UI 中查看數據分析資料。

透過這個功能發布版本,您可以設定訊息處理器,將數據分析資料寫入以下作業: 或同時選擇兩種做法

若需更多資訊,請參閲 將數據分析資料寫入檔案

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

只要使用新的指令碼,就能簡化新版邊緣服務的安裝作業。

詳情請參閱「安裝新版邊緣體驗」。

LDAP IDP 支援

透過 Edge UI 和 Edge Management API 呼叫驗證使用者現在支援 LDAP 流程 。LDAP 支援同時包含直接繫結和間接繫結方法。

詳情請參閱外部平台總覽 IdP 驗證

支援 IPv6

根據預設,對 Private Cloud 適用的 Apigee Edge 所有執行階段 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

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

修正錯誤

本節列出這個版本修正的私有雲錯誤。此外,這個 版本包含所有 Edge UI、Edge 管理和入口網站版本中 (如 包含的版本

問題 ID 說明
140270474

未設定 UseStringDeduplication

UseStringDeduplication 不是 針對實際工作環境中的 edge-message-processor 元件 環境
111445518

影片像素錯誤

訊息處理器每 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

當機構/環境中擁有超過 100 個 KeyStore 時,KeyStore 是 無法載入 Edge UI 中的「reference」部分。反之,UI 會顯示 Internal Error (Error Fetching Keystores) 錯誤。
110988191

分析失敗

當 Microgateway 中 設為未來的日期。
110785400

備份失敗

ZooKeeper、Cassandra 和 OpenLDAP 偶爾無法 正確備份資料,並出現以下錯誤:File changed as we read it.
79993247

對 Node.js 發出的 HEAD 要求

對 Node.js 目標發出的 HEAD 要求可能會停止運作,導致連線處於待處理狀態。
70291825

apigee-postgres 備份/還原

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

重設 sysadmin 密碼

為包含特殊要求的管理伺服器重設系統管理員密碼 字元就會失敗

已知問題

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

問題 ID 說明
141628497

一開始就沒有評分交易

在您首次為機構啟用營利功能時,Edge for Private Cloud 不會為交易評分。這項規定適用於新的機構和現有機構。

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

解決方法:

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

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

137865184

薄荷評分伺服器記憶體流失

當已在 mxgroup 中註冊新的 Qpid 執行個體時,在沒有取用者的情況下建立的佇列會建構無取用者,導致佇列深度增加,直到佇列使用完所有可用資源為止。

解決方法:

無。
135616498

Apigee-sso install 的中繼資料檔案格式

在安裝 apigee-sso 並使用 metadata.xml 檔案 (而非網址) 時,如果 metadata.xml 檔案結尾沒有換行符號 (CRLF),則 metadata.xml 檔案無法完整讀取。

解決方法:

如要解決這個問題,您可以採取下列其中一種做法:

  • 將 CRLF 新增至 metadata.xml 檔案的結尾

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

Amazon Linux 1 不支援 apigee-monit

解決方法:

無。
121095148

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

解決方法:

再次執行備份作業,系統應會備份正確的檔案集。

76087166

多個資料中心設定中的 DataAccessException

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

DataAccessException: Error while accessing datastore;
Please retry later

結果是管理伺服器嘗試連線至 Cassandra 時,可能並未啟動 分別位於 dc-1 和 dc-2 的節點上如果 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_EMAILADMIN_PW 是您的 Apigee 憑證 讓他們使用服務帳戶
    • MS_IPMS_PORT 是管理伺服器的 IP 位址和通訊埠 號碼。
    • REGION 是管理伺服器所在的資料中心名稱 定位。
    • GATEWAY_POD 是 Pod 名稱,預設為「閘道」。您可能在 但重新命名為其他網頁,因此請檢查實作方式。
    • CASSANDRA_NODE_TYPE是以下其中一個值:kms-datastoredc-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 欄位的值。您將使用這些 ID 取消註冊節點。

  2. 針對各個 Cassandra 節點類型重複執行步驟 1:kms-datastoredc-datastorekeyvaluemap-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,請點選下列連結:

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