新しい分析グループの追加

Edge for Private Cloud v4.19.01

Edge for Private Cloud をインストールする際に、デフォルトでインストーラは「axgroup-001」という名前の単一の分析グループを作成します。インストール時に、分析グループのデフォルト名を変更するには、インストール構成ファイルに AXGROUP プロパティを含めます。

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

詳細については、ノードに Edge コンポーネントをインストールするをご覧ください。

後で新しい分析グループをインストールに追加する場合:

新しい分析グループを作成して構成します。
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"
```

Postgres サーバーの UUID を新しい分析グループに追加します。マスター / スタンバイペアとして機能するように 2 台の Postgres サーバーを構成した場合は、2 台とも UUID のカンマ区切りのリストとして指定します。

Postgres サーバーの UUID を取得するには、すべての Postgres サーバーノードで次の cURL コマンドを実行します。
```
curl -u sysAdminEmail:passWord https://PG_IP:8084/v1/servers/self
```

単一の 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'

複数の Postgre サーバーがマスター / スタンバイのペアとして構成されている場合は、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" : {
      }
    }

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 プロパティに表示されます。

すべての Qpid サーバーの UUID を新しい分析グループに追加します。すべての Qpid サーバーでこの手順を実行する必要があります。

Qpid サーバーの UUID を取得するには、すべての Qpid サーバーノードで次の cURL コマンドを実行します。
```
curl -u sysAdminEmail:passWord https://QP_IP:8083/v1/servers/self
```

分析グループに 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'

コンシューマグループに 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" : {
      }
    }

新しい 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"