Ajouter ou supprimer des nœuds Qpid

Edge for Private Cloud v4.18.05

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

Ajouter un serveur Qpid

Pour ajouter un serveur Qpid:

  1. Sur le serveur de gestion, déterminez le nom des groupes d'analyse et de consommateurs.

    La plupart des commandes ci-dessous nécessitent ces informations. Par défaut, le nom du groupe d'analyse est axgroup-001 et le nom du groupe de consommateurs est consumer-group-001. Dans le fichier de configuration silencieuse 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 Analytics et grand public, 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 à l'aide de la procédure Internet ou autre, comme décrit dans la section Installer l'utilitaire de configuration 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 » indique d'installer Qpid. Pour en savoir plus sur la création d'un configFile, consultez la page 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, utilisez 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 d'analyses :
    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 consommateurs :
    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, vous voyez l'UUID du nœud Qpid ajouté à la propriété consumer-groups 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:

  1. Sur le serveur de gestion, déterminez le nom des groupes d'analyse et de consommateurs. La plupart des commandes ci-dessous nécessitent ces informations.

    Par défaut, le nom du groupe d'analyse est axgroup-001 et le nom du groupe de consommateurs est consumer-group-001. Dans le fichier de configuration silencieuse 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 Analytics et grand public, 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 "Nom" et le nom du groupe de consommateurs dans le champ "Consumer-groups".

  2. Supprimez Qpid du groupe de consommateurs :
    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. Supprimer Qpid du groupe d'analyse :
    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 la section Désinstaller Edge.