4.19.06 Edge for Private Cloud 版本資訊

Mint 最初不會評估交易

首次為機構啟用營利功能時，Private Cloud 適用的 Edge 不會立即評估交易。這項規定適用於新機構和現有機構。

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

解決方法：

apigee-service edge-message-processor restart

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

Mint 評分伺服器記憶體流失

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

解決方法：

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

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

解決方法：

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

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

  或

• 使用以網址為準的中繼資料位置

apigee-monit Amazon Linux 1 不支援

解決方法：

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

解決方法：

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

多個資料中心設定中的 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 叢集造成任何影響。如要進一步瞭解這些指令，請參閱更新資料存放區註冊。

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

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

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

解決方法：