新增數據分析群組

Edge for Private Cloud 4.18.05

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

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

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

如果之後想在安裝項目中新增新的數據分析群組，請按照下列步驟操作：

  1. 建立及設定新的 Analytics 群組：
    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. 將 Analytics 群組的消費者類型設為「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 新增至新的 Analytics 群組。如果您已將兩部 Postgres 伺服器設為主/備用組合，請將兩者都指定為以半形逗號分隔的 UUID 清單。
    1. 如要取得 Postgres 伺服器的 UUID，請在每個 Postgres 伺服器節點上執行下列 cURL 指令： 
      curl -u sysAdminEmail:passWord https://PG_IP:8084/v1/servers/self
    2. 如果您只有一個 Postgres 伺服器，請將該伺服器加入 Analytics 群組： 
      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 伺服器新增至 Analytics 群組： 
      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"