新增數據分析群組

安裝 Edge for Private Cloud 時,安裝程式預設會建立名為「axgroup-001」的單一數據分析群組。安裝時,您可以在安裝設定檔中加入 AXGROUP 屬性,變更數據分析群組的預設名稱:

# Specify the analytics group.
# AXGROUP=axgroup-001          # Default name is axgroup-001.

詳情請參閱「在節點上安裝 Edge 元件」。

如果日後想在安裝項目中新增數據分析群組,請按照下列步驟操作:

  1. 建立及設定新的數據分析群組:
    1. 建立名為 axgroupNew 的數據分析群組:
      curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew'
    2. 將名為 consumer-group-new 的用戶群組新增至新的數據分析群組。在每個數據分析群組中,消費者群組名稱不得重複:
      curl -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups?name=consumer-group-new"
    3. 將數據分析群組的消費者類型設為「ax」:
      curl -u sysAdminEmail:passWord -X POST -H "Content-Type:application/json"
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/properties?propName=consumer-type&propValue=ax"
    4. 新增資料中心名稱。根據預設,您會使用名為「dc-1」的資料中心安裝 Edge。不過,如果您有多個資料中心,每個資料中心都會有專屬名稱。如果您只有一個資料中心,則不一定要執行這項呼叫;如果您有多個資料中心,則建議執行這項呼叫:
      curl -u sysAdminEmail:passWord -X POST -H "Content-Type:application/json"
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/properties?propName=region&propValue=dc-1"
  2. 將 Postgres 伺服器的 UUID 新增至新的數據分析群組。如果您已將兩個 Postgres 伺服器設為主要/待命配對,請以半形逗號分隔的 UUID 清單指定這兩個伺服器。
    1. 如要取得 Postgres 伺服器的 UUID,請在每個 Postgres 伺服器節點上執行下列 cURL 指令:
      curl -u sysAdminEmail:passWord https://PG_IP:8084/v1/servers/self
    2. 如果只有一個 Postgres 伺服器,請將其新增至數據分析群組:
      curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/servers?uuid=UUID&type=postgres-server&force=true'

      如果您有多個 Postgres 伺服器設為主要/待命配對,請指定以半形逗號分隔的 UUID 清單來新增這些伺服器:

      curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/servers?uuid=UUID_Master,UUID_standby&type=postgres-server&force=true'

      這個指令會傳回數據分析群組的相關資訊,包括 uuids 下 postgres-server 屬性中的 Postgres 伺服器 UUID:

      {
        "name" : "axgroupNew",
        "properties" : {
          "region" : "dc-1",
          "consumer-type" : "ax"
        },
        "scopes" : [ ],
        "uuids" : {
          "qpid-server" : [ ],
          "postgres-server" : [ "2cb7211f-eca3-4eaf-9146-66363684e220" ]
        },
        "consumer-groups" : [ {
          "name" : "consumer-group-new",
          "consumers" : [ ],
          "datastores" : [ ],
          "properties" : {
          }
        } ],
        "data-processors" : {
        }
      }
    3. 將 Postgres 伺服器新增至用戶群組的資料儲存庫。這項呼叫是將數據分析訊息從 Qpid 伺服器轉送至 Postgres 伺服器的必要步驟:
      curl -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups/consumer-group-new/datastores?uuid=UUID"

      如果有多個 Postgre 伺服器設為主要/待命配對,請以半形逗號分隔的 UUID 清單指定這些伺服器,藉此新增伺服器:

      curl -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups/consumer-group-new/datastores?uuid=UUID_Master,UUID_standby"

      UUID 會顯示在輸出內容中 consumer-groups 的 datastores 屬性。

  3. 將所有 Qpid 伺服器的 UUID 新增至新的數據分析群組。您必須對所有 Qpid 伺服器執行這個步驟。
    1. 如要取得 Qpid 伺服器的 UUID,請在每個 Qpid 伺服器節點上執行下列 cURL 指令:
      curl -u sysAdminEmail:passWord https://QP_IP:8083/v1/servers/self
    2. 將 Qpid 伺服器新增至數據分析群組:
      curl  -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/servers?uuid=UUID&type=qpid-server'
    3. 將 Qpid 伺服器新增至用戶群組:
      curl  -u sysAdminEmail:passWord -X POST -H 'Accept:application/json'
        -H 'Content-Type:application/json'
        "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups/consumer-group-new/consumers?uuid=UUID"

      這項呼叫會傳回下列內容,您可以在其中看到 Qpid 伺服器的 UUID 已新增至 uuids 下方的 qpid-server 屬性,以及 consumer-groups 下方的 consumers 屬性:

      {
        "name" : "axgroupNew",
        "properties" : {
          "region" : "dc-1",
          "consumer-type" : "ax"
        },
        "scopes" : [ ],
        "uuids" : {
            "qpid-server" : [ "fb6455c3-f5ce-433a-b98a-bdd016acd5af" ],
            "postgres-server" : [ "2cb7211f-eca3-4eaf-9146-66363684e220" ]
        },
        "consumer-groups" : [ {
          "name" : "consumer-group-new",
          "consumers" : [ "fb6455c3-f5ce-433a-b98a-bdd016acd5af" ],
          "datastores" : [ "2cb7211f-eca3-4eaf-9146-66363684e220" ],
          "properties" : {
          }
        } ],
        "data-processors" : {
        }
      }
  4. 為新的 AX 群組佈建組織和環境:
    curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
      -X POST "https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew/scopes?org=org_name&env=env_name"