Ajouter ou supprimer des nœuds Qpid

Ce document explique comment ajouter et supprimer un serveur Qpid dans une installation Edge existante.

Pour savoir comment supprimer un serveur de gestion, un processeur de messages ou un routeur, consultez Supprimer un serveur.

Ajouter un serveur Qpid

Pour ajouter un serveur Qpid :

  1. Sur le serveur de gestion, déterminez le nom des groupes "analytics" et "consumer".

    De nombreuses commandes ci-dessous nécessitent ces informations. Par défaut, le nom du groupe d'analyse est axgroup-001 et celui du groupe de consommateurs est consumer-group-001. Dans le fichier de configuration silencieux d'une région, vous pouvez définir le nom du groupe d'analyse à l'aide de la propriété AXGROUP.

    Si vous n'êtes pas sûr des noms des groupes d'analyse et de consommateurs, utilisez la commande suivante pour les afficher :

    apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

    Cette commande renvoie le nom du groupe d'analyse dans le champ name et le nom du groupe de consommateurs dans le champ consumer-groups.

  2. Installez l'utilitaire Edge apigee-setup sur le nœud en suivant la procédure avec ou sans Internet, comme décrit dans Installer l'utilitaire apigee-setup d'Edge.
  3. Utilisez apigee-setup.sh pour installer Qpid sur le nœud :
    /opt/apigee/apigee-setup/bin/setup.sh -p qs -f configFile

    L'option "-p qs" spécifie l'installation de Qpid. Pour en savoir plus sur la création d'un fichier configFile, consultez Installer des composants Edge sur un nœud.

    Une fois l'installation terminée, le script affiche l'UUID du serveur Qpid. Si vous devez déterminer l'UUID ultérieurement, exécutez la commande cURL suivante sur l'hôte sur lequel vous avez installé Qpid :

    curl http://qpid_IP:8083/v1/servers/self
  4. Ajoutez Qpid au groupe "analytics" :
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"

    Dans le résultat, vous voyez l'UUID du nœud Qpid ajouté à la propriété qpid-server sous axgroup-001 :

    {
      "name" : "axgroup-001",
      "properties" : {},
      "scopes" : [ "VALIDATE~test", "sgilson~prod" ],
      "uuids" : {
        "qpid-server" : [
          "d6d0480f-8393-465d-a2a1-b4a16a033c55",
          "8398a95c-3640-4bd9-bf7e-1eb89155810a"
        ]
      }
    }
  5. Ajoutez Qpid au groupe de clients :
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X POST "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers?uuid=QPID_UUID"

    Dans le résultat, l'UUID du nœud Qpid ajouté à la propriété consumer-groups s'affiche sous consumer-group-001 :

    "consumer-groups" : [ {
      "name" : "consumer-group-001",
      "consumers" : [
        "d6d0480f-8393-465d-a2a1-b4a16a033c55",
        "8398a95c-3640-4bd9-bf7e-1eb89155810a"
      ]
    } ]
  6. Redémarrez tous les composants edge-qpid-server sur tous les nœuds pour vous assurer que la modification est prise en compte par ces composants :
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready

L'installation est terminée.

Supprimer un serveur Qpid

Pour supprimer un nœud Qpid, procédez comme suit :

  1. Sur le serveur de gestion, déterminez le nom des groupes "analytics" et "consumer". De nombreuses commandes ci-dessous nécessitent ces informations.

    Par défaut, le nom du groupe d'analyse est axgroup-001 et celui du groupe de consommateurs est consumer-group-001. Dans le fichier de configuration silencieux d'une région, vous pouvez définir le nom du groupe d'analyse à l'aide de la propriété AXGROUP.

    Si vous n'êtes pas sûr des noms des groupes d'analyse et de consommateurs, utilisez la commande suivante pour les afficher :

    apigee-adminapi.sh analytics groups list --admin adminEmail --pwd adminPword --host localhost

    Cette commande renvoie le nom du groupe "analytics" dans le champ "name" et le nom du groupe "consumer" dans le champ "consumer-groups".

  2. Supprimez Qpid du groupe "consumer" :
    curl -u adminEmail:pword -H "Content-Type: application/json"
      -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/consumer-groups/CONSUMER_GROUP/consumers/QPID_UUID"
  3. Supprimez Qpid du groupe "analytics" :
    curl -v -u adminEmail:pword
      -X DELETE "http://ms_IP:8080/v1/analytics/groups/ax/AX_GROUP/servers?uuid=QPID_UUID&type=qpid-server"
  4. Annulez l'enregistrement du serveur Qpid de l'installation Edge :
    curl -u adminEmail:pword
      -X POST http://ms_IP:8080/v1/servers -d "type=qpid-server&region=dc-1&pod=central&uuid=QPID_UUID&action=remove"
  5. Supprimez le serveur Qpid de l'installation Edge :
    curl -u adminEmail:pword -X DELETE http://ms_IP:8080/v1/servers/QPID_UUID
  6. Redémarrez tous les composants edge-qpid-server sur tous les nœuds pour vous assurer que la modification est prise en compte par ces composants :
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server restart
    /opt/apigee/apigee-service/bin/apigee-service edge-qpid-server wait_for_ready
  7. Désinstallez Qpid comme décrit dans Désinstaller Edge.