新增數據分析群組

Edge for Private Cloud 4.17.01 版

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

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

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

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

1. 建立及設定新的 Analytics 群組：
   1. 建立名為「analyticsNew」的 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 的新分析群組。在每個 Analytics 群組的內容中，消費者群組名稱皆不重複：
      > 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 伺服器，請將其新增至分析群組：
      > 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"
      
      如果您將多個 Postgres 伺服器設為主/備用組合，請指定以半形逗號分隔的 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' -H 'Content-Type:application/json' "https://<MS_IP>:8080/v1/analytics/groups/ax/axgroupNew/consumer-groups/在下列「Up <使用者會把 Qpid 伺服器>這個 Uq 在哪個」
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
      
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"