新增或移除 Qpid 節點

私有雲 v4.18.05 的邊緣

本文說明如何在現有的 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"

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

    {
  "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。