4.19.01 Edge for Private Cloud 版本資訊

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

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

解決方法：

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

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

  或

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

Amazon Linux 1 不支援 apigee-monit

解決方法：

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

解決方法：

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

工作階段符記未失效

當使用者點選 Apigee Edge 登出按鈕時，工作階段符記不會在伺服器上失效。

解決方法：

啟用 JMX 驗證時，Cassandra 作業無法運作

解決方法：

對 Node.js 目標發出的 HEAD 要求停止運作

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

解決方法：

如要解決這個問題，請定義 HEAD 要求的處理常式，明確傳回空白回應。

無法解析主機名稱

安裝或升級 Private Cloud 適用的 Edge 後，主機名稱可能無法解析為位址。

解決方法：

如要解決這個問題，請重新啟動 Edge UI 元件：

/opt/apigee/apigee-service/bin/apigee-service edge-ui restart

多個資料中心設定中的 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_EMAIL 和 ADMIN_PW 是您的 Apigee 憑證 讓他們使用服務帳戶
   • MS_IP 和 MS_PORT 是管理伺服器的 IP 位址和通訊埠 號碼。
   • REGION 是管理伺服器所在的資料中心名稱 定位。
   • GATEWAY_POD 是 Pod 名稱，預設為「閘道」。您可能在 但重新命名為其他網頁，因此請檢查實作方式。
   • 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 欄位的值。您將使用這些 ID 取消註冊節點。

2. 針對各個 Cassandra 節點類型重複執行步驟 1：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 叢集的影響如要進一步瞭解這些指令，請參閱 更新資料儲存庫註冊。

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

MessageLogging 政策的 FormatMessage 元素可控管記錄訊息的格式。如果設為 FormatMessage=false，記錄的訊息不應包含任何 Apigee 產生的資訊。然而，即使您設定了 FormatMessage=false，記錄訊息仍會包含以下資訊：

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

解決方法：

無法重設系統管理員密碼

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

解決方法：

在資料檔案中定義密碼，然後傳遞至 Management API 中的 /users 端點。詳情請參閱重設系統管理員密碼。