Ajouter un groupe d'analyse

Lorsque vous installez Edge pour le cloud privé, le programme d'installation crée par défaut un seul groupe d'analyse nommé "axgroup-001". Au moment de l'installation, vous pouvez modifier le nom par défaut du groupe d'analyse en incluant la propriété AXGROUP dans le fichier de configuration d'installation:

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

Pour en savoir plus, consultez Installer des composants Edge sur un nœud.

Si vous souhaitez ajouter un groupe d'analyse à votre installation ultérieurement:

  1. Créez et configurez le nouveau groupe d'analyse :
    1. Créez le groupe d'analyse, nommé axgroupNew :
      curl -u sysAdminEmail:passWord -H "Content-Type: application/json"
        -X POST 'https://MS_IP:8080/v1/analytics/groups/ax/axgroupNew'
    2. Ajoutez un groupe de consommateurs au nouveau groupe d'analyse, nommé consumer-group-new. Les noms des groupes de consommateurs sont uniques au sein de chaque groupe d'analyse :
      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. Définissez le type de consommateur du groupe d'analyse sur "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. Ajoutez le nom du centre de données. Par défaut, vous installez Edge avec un centre de données nommé "dc-1". Cependant, si vous avez plusieurs centres de données, ils ont chacun un nom unique. Cet appel est facultatif si vous n'avez qu'un seul centre de données. Nous vous recommandons de l'utiliser si vous avez plusieurs centres de données :
      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. Ajoutez les UUID des serveurs Postgres au nouveau groupe d'analyse. Si vous avez configuré deux serveurs Postgres en tant que paire maître/de secours, spécifiez les deux en tant que liste d'UUID séparés par une virgule.
    1. Pour obtenir les UUID des serveurs Postgres, exécutez la commande cURL suivante sur chaque nœud de serveur Postgres :
      curl -u sysAdminEmail:passWord https://PG_IP:8084/v1/servers/self
    2. Si vous ne disposez que d'un seul serveur Postgres, ajoutez-le au groupe d'analyse :
      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'

      Si plusieurs serveurs Postgres sont configurés en tant que paire maître/de secours, ajoutez-les en spécifiant une liste d'UUID séparés par une virgule :

      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'

      Cette commande renvoie les informations sur le groupe d'analyse, y compris l'UUID du serveur Postgres dans la propriété postgres-server sous uuids :

      {
        "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. Ajoutez le serveur Postgres au datastore du groupe de consommateurs. Cet appel est nécessaire pour acheminer les messages d'analyse des serveurs Qpid vers les serveurs 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"

      Si plusieurs serveurs Postgre sont configurés en tant que paire maître/de secours, ajoutez-les en spécifiant une liste d'UUID séparés par une virgule :

      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"

      L'UUID apparaît dans la propriété datastores de consumer-groups dans la sortie.

  3. Ajoutez les UUID de tous les serveurs Qpid au nouveau groupe d'analyse. Vous devez effectuer cette étape pour tous les serveurs Qpid.
    1. Pour obtenir les UUID des serveurs Qpid, exécutez la commande cURL suivante sur chaque nœud du serveur Qpid :
      curl -u sysAdminEmail:passWord https://QP_IP:8083/v1/servers/self
    2. Ajoutez le serveur Qpid au groupe d'analyse :
      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. Ajoutez le serveur Qpid au groupe de consommateurs :
      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"

      Cet appel renvoie le code suivant, qui affiche l'UUID du serveur Qpid ajouté à la propriété qpid-server sous uuids, et à la propriété consumers sous consumer-groups :

      {
        "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. Provisionner une organisation et un environnement pour le nouveau groupe 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"