新增數據分析群組

Edge for Private Cloud 4.18.01 版

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

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

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

如果日後想在安裝作業中新增數據分析群組，請按照下列程序操作：

1. 建立及設定新的數據分析群組：
   1. analyticsNew
   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"
      
      這項呼叫會傳回下列內容，您可以在 uuids 下方的 qpid-server 屬性，以及 consumer-groups 下方的 consumers 屬性中，查看新增至 Qpid 伺服器的 UUID：
      {
      "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 -X POST "https://<MS_IP>:8080/v1/analytics/groups/ax/axgroupNew/scopes?org=org_name&env=env_name" -H "Content-Type: application/json"