新增數據分析群組

私有雲 4.18.05 版本

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

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

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

如果之後想要在安裝中加入新的數據分析群組,請按照下列步驟進行:

  1. 建立及設定新的數據分析群組:
    1. 建立一個名為 axgroupNew 的 Analytics (分析) 群組:
      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」的資料中心。 不過,如果您有多個資料中心,每個資料中心都要有不重複的名稱。如果您只有一個資料中心,可以選擇進行此呼叫。如果您有多個資料中心,建議可以採用這個呼叫:
      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-groupsdatastores 屬性中。

  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"

      這個呼叫會回傳下列訊息,您可以在這裡查看 uuids 底下把 qpid-server 新增至 Qpid 伺服器的 UUID,以及 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"