新增或移除 Qpid 節點

本文說明如何在現有的 Edge 安裝中新增及移除 Qpid 伺服器。

如要瞭解如何移除管理伺服器、訊息處理器或路由器，請參閱「移除伺服器」。

新增 Qpid 伺服器

如何新增 Qpid 伺服器：

1. 在管理伺服器上，判斷數據分析和消費者群組的名稱。

   下方許多指令都需要這項資訊。根據預設，數據分析群組的名稱為 axgroup-001，消費者群組的名稱為 consumer-group-001。在區域的靜音設定檔中，您可以使用 AXGROUP 屬性設定數據分析群組的名稱。

   如果不確定數據分析和消費者群組的名稱，請使用下列指令顯示名稱：

   apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

   這個指令會在 name 欄位傳回數據分析群組名稱，並在 consumer-groups 欄位傳回消費者群組名稱。

2. 請按照「安裝 Edge apigee-setup 公用程式」一文所述，使用網際網路或非網際網路程序，在節點上安裝 Edge apigee-setup 公用程式。
3. 使用 apigee-setup.sh 在節點上安裝 Qpid：

   /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

   「-p qs」選項會指定安裝 Qpid。如要瞭解如何建立 configFile，請參閱「在節點上安裝 Edge 元件」。

   安裝完成後，指令碼會顯示 Qpid 伺服器的 UUID。如果之後需要判斷 UUID，請在安裝 Qpid 的主機上使用下列 cURL 指令：

   curl http://qpid_IP:8083/v1/servers/self

4. 將 Qpid 新增至數據分析群組：

   curl -u adminEmail:pword -H "Content-Type: application/json"
     -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"

   在輸出內容中，您會看到新增至 axgroup-001 下 qpid-server 屬性的 Qpid 節點 UUID：

   {
     "name" : "axgroup-001",
     "properties" : {},
     "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
     "uuids" : {
       "qpid-server" : [
         "d6d0480f-8393-465d-a2a1-b4a16a033c55",
         "8398a95c-3640-4bd9-bf7e-1eb89155810a"
       ]
     }
   }

5. 將 Qpid 新增至消費者群組：

   curl -u adminEmail:pword -H "Content-Type: application/json"
     -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers?uuid=QPID_UUID"

   在輸出內容中，您會看到 Qpid 節點的 UUID 已新增至 consumer-group-001 下方的 consumer-groups 屬性：

   "consumer-groups" : [ {
     "name" : "consumer-group-001",
     "consumers" : [
       "d6d0480f-8393-465d-a2a1-b4a16a033c55",
       "8398a95c-3640-4bd9-bf7e-1eb89155810a"
     ]
   } ]

6. 重新啟動所有節點上的所有 edge-qpid-server 元件，確保這些元件採用變更：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

安裝完成。

移除 Qpid 伺服器

如要移除 Qpid 節點，請按照下列步驟操作：

1. 在管理伺服器上，找出數據分析和消費者群組的名稱。下方許多指令都需要這項資訊。
   

   根據預設，數據分析群組的名稱為 axgroup-001，消費者群組的名稱為 consumer-group-001。在區域的靜默設定檔中，您可以使用 AXGROUP 屬性設定數據分析群組的名稱。

   如果不確定數據分析和消費者群組的名稱，請使用下列指令顯示：

   apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

   這個指令會在 name 欄位傳回數據分析群組名稱，並在 consumer-groups 欄位傳回用戶群組名稱。

2. 從用戶群組中移除 Qpid：

   curl -u adminEmail:pword -H "Content-Type: application/json"
     -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers/QPID_UUID"

3. 從數據分析群組中移除 Qpid：

   curl -v -u adminEmail:pword
     -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"

4. 從 Edge 安裝作業中取消註冊 Qpid 伺服器：

   curl -u adminEmail:pword
     -X POST http://ms_IP:8080/v1/servers -d "type=qpid-server&region=dc-1&pod=central&uuid=QPID_UUID&action=remove"

5. 從 Edge 安裝作業中移除 Qpid 伺服器：

   curl -u adminEmail:pword -X DELETE http://ms_IP:8080/v1/servers/QPID_UUID

6. 重新啟動所有節點上的所有 edge-qpid-server 元件，確保這些元件採用變更：

   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
   /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

7. 按照「解除安裝 Edge」一文所述，解除安裝 Qpid。