4.19.01 Edge 的 Private Cloud 版本資訊

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

安裝 apigee-sso 並使用 metadata.xml 檔案 (而不是網址) 時，如果中繼資料.xml 檔案結尾沒有新一行 (CRLF)，中繼資料不會完全讀取。

解決方法：

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

• 在 metadata.xml 檔案尾端加上 CRLF

  或

• 使用網址位置來當做中繼資料

Amazon Linux 1 不支援 apigee-monit

解決方法：

訊息處理工具未備份正確的檔案組

解決方法：

執行第二次備份，系統應該會備份正確的檔案組合。

工作階段符記未失效

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

解決方法：

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

解決方法：

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

傳送至 Node.js 目標的 HEAD 要求可能會停止運作，因而造成連線中斷。

解決方法：

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

無法解析主機名稱

安裝 Edge 或升級私有雲後，主機名稱可能無法解析為位址。

解決方法：

如要解決這個問題，請重新啟動 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 名稱，預設為「閘道」。但您可能已將名稱重新命名為其他內容，因此請檢查導入方式。
   • 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 節點類型重複步驟 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 端點。詳情請參閱「重設系統管理員密碼」。