4.19.01 Edge for Private Cloud 版本資訊

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

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

解決方法：

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

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

  或

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

apigee-monit Amazon Linux 1 不支援

解決方法：

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

解決方法：

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

工作階段權杖未失效

使用者點選 Apigee Edge「登出」按鈕時，伺服器不會使工作階段權杖失效。

解決方法：

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

解決方法：

HEAD 要求會掛起 Node.js 目標

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

解決方法：

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

無法解析主機名稱

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

解決方法：

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

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

多個資料中心設定中的 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，記錄訊息仍會包含下列資訊：

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

解決方法：

無法重設系統管理員密碼

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

解決方法：

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