您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊
本節說明 Private Cloud 功能發布的 Edge 4.19.06 版。
版本摘要
下表摘要列出這個版本的異動內容:
新功能 | 此版本包含以下新功能: ○ LDAP 支援單一登入 (SSO)○ HTTP 部署支援 ○ 可插式分析 ○ 支援 Cassandra 機架 ○ IPv6 支援 ○ 簡化版 New Edge 體驗 ○ 排除 INVALID_TSC 交易 (營利)
如要進一步瞭解這些新功能,請參閱新功能。 |
||
回溯相容性 |
這個版本的 Apigee Edge 私有雲版本推出了下列會影響回溯相容性的問題:
|
||
包含的版本 | 自舊版的 Private Cloud 功能版本以來,這個版本已推出並包含下列版本:
|
||
退休 | 無 | ||
淘汰項目 | 隨著 4.19.06 版本推出,下列項目已淘汰:
詳情請參閱 Apigee 淘汰項目、淘汰作業與 CPS 異動。 |
||
修正錯誤 | 這個版本修正了下列錯誤: ○ UseStringDeduplication 未設定 (140270474)○ ○ MP 錯誤 (111445518) ○ 則失敗 (設為 1114455 18) ○ 則發生 JMX 失敗 (113342838) ○ 備份失敗 (113342838) ○ 備份失敗 (138931337) HEAD 如要進一步瞭解這些修正方法,請參閱「錯誤修正」。 |
||
已知問題 | 此版本包含以下已知問題: ○ Mint 未對交易進行基本評分 (141628497)○ Mint 評等伺服器記憶體流失 (137865184) ○ 中繼資料檔案格式,適用於 apigee-sso 安裝 (135616498) 135616498 8 號備份政策 不支援 12 至 4 列 不適用於備份設定 1 支援 1 份 1 支援 1 支援 1 份 1 中 1 項 通用 8 搭配 1 合 1 支援 支援 1 至 7 間的多重記錄 1 apigee-monit 如要進一步瞭解這些已知問題 (包括解決方法),請參閱已知問題。 |
||
升級路徑
下表列出這個版本的升級路徑:
From 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、邊緣管理和入口網站版本列於「包含的版本」中的所有功能。
除了下列強化功能外,這個版本還包含多項可用性、效能、安全性和穩定性方面的強化措施。
HTTP 部署作業支援
根據預設,Edge 會使用遠端程序呼叫 (RPC) 部署 API Proxy。這個模式非常適合大多數安裝作業,但如果是使用 RPC 進行大量並行呼叫,具有許多 MP 的大型拓撲可能會發生逾時。
因此,Apigee 建議較大型的部署作業使用 HTTP 而非遠端程序呼叫 (RPC)。現已支援啟用 HTTP 部署。
詳情請參閱「啟用 HTTP 部署」。
支援 Cassandra 機架
Apigee 現在起,在 Apigee Edge 上為私有雲機架感知 Cassandra,提供 Cassandra 資源調度作業的一般指南。
詳情請參閱 Cassandra 機架支援。
現成分析功能
根據預設,訊息處理器收集的數據分析資料會上傳至 Qpid 和 Postgres 進行處理。屆時您就能在 Edge UI 中查看分析資料。
在這個功能版本中,您可以設定訊息處理器將數據分析資料寫入磁碟,也可以選擇同時使用這兩個選項。
詳情請參閱將數據分析資料寫入檔案一文。
簡化版 New Edge 體驗安裝程序
使用新指令碼簡化了新 Edge 服務的安裝程序。
詳情請參閱「安裝 New Edge Experience」。
LDAP IDP 支援
除了 SAML 外,採用 Edge UI 和 Edge Management API 呼叫的使用者驗證作業現在也支援 LDAP。LDAP 支援包括直接繫結和間接繫結方法。
詳情請參閱外部 IDP 驗證總覽。
支援 IPv6
根據預設,向 Apigee Edge 適用私人雲端的所有執行階段 API 呼叫都會使用 IPv4。您可以使用新屬性為路由器新增 IPv6 支援。
詳情請參閱在路由器上使用 IPv6 的說明。
排除 INVALID_TSC
交易 (營利)
您現在可以在使用營利功能時,排除 INVALID_TSC
項交易,不將其新增至 Postgres 資料庫。
詳情請參閱「營利服務伺服器屬性」一文。
支援的軟體
此版本支援以下軟體變更:
已新增支援 | 不再支援 |
---|---|
這個版本支援下列平台:
|
這個版本不再支援下列平台:
|
如需支援平台的完整清單,請參閱「支援的軟體和支援的版本」一文。
修正錯誤
本節列出在這個版本中修正的 Private Cloud 錯誤。此外,這個版本也修正了 Edge UI、邊緣管理和入口網站版本中顯示的所有錯誤,如「包含的版本」所示。
問題 ID | 說明 |
---|---|
140270474 |
未設定 UseStringDeduplication 無法在實際工作環境中為edge-message-processor 元件設定 UseStringDeduplication 。
|
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 會覆寫前者。只有在不同的使用者看不到其他 Proxy 時,才會發生這種情況。 |
118851790 |
無法載入 KeyStore 如果機構/環境有超過 100 個 KeyStore,則未載入 Edge UI 中的 KeyStore 和參考資料區段。而是 UI 顯示Internal
Error (Error Fetching Keystores) 錯誤。 |
110988191 |
Analytics (分析) 失敗 如果從 Microgateway 設為未來的日期資料,表示環境的 Analytics (分析) 執行失敗。 |
110785400 |
備份失敗 ZooKeeper、Cassandra 和 OpenLDAP 間歇性地無法正確備份資料,出現以下錯誤:File changed as we read
it.
|
79993247 |
傳送至 Node.js 的 HEAD 要求可能會停止運作,導致連線仍待處理。 |
70291825 |
apigee-postgres 備份/還原 執行 apigee-postgres 備份/還原作業後,系統會備份所有元件的資料。 |
65737520 |
重設 sysadmin 密碼 為含有特殊字元的管理伺服器重設系統管理員密碼會失敗。 |
已知問題
下表列出這個版本的已知問題:
問題 ID | 說明 |
---|---|
141628497 |
一開始未評分交易 首次為機構啟用營利功能時,Private Cloud 邊緣不會針對交易評分。這適用於新機構和現有機構。 營利啟用 API 使用工作 ID 回應,完成時,工作狀態會指出工作成功。不過,一開始所有的營利 API 呼叫都不會由營利處理,也不會評分。這類交易只會顯示在一般數據分析中。 解決方法: 重新啟動任何訊息處理器 (MP),可按照下列步驟進行:apigee-service edge-message-processor restart 啟用營利功能後,重新啟動 MP 會導致 Edge 在啟動時從 ZooKeeper 載入設定。每次重新啟動都會發生這個情形,這表示問題一開始只會發生。 |
137865184 |
次要評分伺服器記憶體流失 在 MX 群組中註冊新的 Qpid 執行個體後,佇列會在沒有取用端的情況下建構,導致佇列深度增加,直到使用所有可用資源為止。 解決方法: 無。 |
135616498 |
apigee-sso 安裝的中繼資料檔案格式 安裝 解決方法: 如要解決這個問題,您可以採取下列其中一種做法:
|
122370980 |
Amazon Linux 1 不支援 解決方法: 無。 |
121095148 |
訊息處理器備份未備份正確的檔案組合 解決方法: 第二次執行備份作業,應會備份正確的檔案組合。 |
76087166 |
多個資料中心設定中的 DataAccessException 在多個資料中心設定中,如果有一個資料儲存庫無法使用,您可能會看到以下錯誤: DataAccessException: Error while accessing datastore; Please retry later 結果是,管理伺服器可能無法啟動,因為其嘗試同時連線至 dc-1 和 dc-2 中的 Cassandra 節點。如果 Cassandra 節點停止運作,就會發生 請注意,預期狀態是管理伺服器不會跨區域連線至資料儲存庫元件。 解決方法 解決方法是在無法使用的資料中心內取消註冊下列 Cassandra 節點類型,然後在 Cassandra 節點再次提供時重新註冊這些類型:
如何取消註冊及重新註冊這些 Cassandra 節點類型:
請注意,這些作業會從 Zookeeper 註冊及取消註冊節點,不會對 Cassandra 叢集造成任何影響。如要進一步瞭解這些指令,請參閱更新資料儲存庫註冊。 |
68722102 |
MessageLogging 政策,在記錄訊息中加入額外資訊 MessageLogging 政策的
解決方法: 無。 |
後續步驟
如要開始使用 Edge for Private Cloud 4.19.06,請點選下列連結: