Configuration de la taille du tas de mémoire sur les processeurs de messages

Vous consultez la documentation Apigee Edge.
Accédez à la documentation Apigee X. info

Le processeur de messages d'Apigee Edge est un composant basé sur Java qui utilise une taille de mémoire de tas par défaut de 512 Mo. Toutefois, cette taille peut ne pas être suffisante pour tous les cas d'utilisation sur Apigee Edge. Vous devrez peut-être ajuster la taille de la mémoire de tas pour vos processeurs de messages en fonction de vos exigences en matière de trafic et de traitement, ou pour résoudre tout problème lié à la mémoire.

La taille de la mémoire de tas d'une application Java est contrôlée par les paramètres de ligne de commande Java -Xms (taille minimale du tas) et -Xmx (taille maximale du tas). Sur les processeurs de messages Apigee Edge, ces paramètres sont contrôlés par les propriétés bin_setenv_min_mem et bin_setenv_max_mem. Pour en savoir plus sur ces propriétés, consultez la section Modifier les paramètres de mémoire Java.

Ce document explique comment configurer la taille de la mémoire de tas sur les processeurs de messages d'Apigee Edge.

Avant de commencer

Modifier la taille de la mémoire de tas sur les processeurs de messages

Cette section explique comment modifier la taille de la mémoire de tas sur les processeurs de messages. La mémoire de tas minimale et maximale peut être configurée via les propriétés bin_setenv_min_mem et bin_setenv_max_mem sur le composant Message Processor.

Pour modifier la taille de la mémoire de tas sur les processeurs de messages, procédez comme suit :

  1. Ouvrez le fichier /opt/apigee/customer/application/message-processor.properties sur la machine du processeur de messages dans un éditeur. Si le fichier n'existe pas déjà, créez-le. Exemple : 
    vi /opt/apigee/customer/application/message-processor.properties
  2. Ajoutez les lignes suivantes à ce fichier : 
    bin_setenv_min_mem=minimum_heap_in_megabytes
bin_setenv_max_mem=maximum_heap_in_megabytes

    Par exemple, si vous souhaitez modifier la taille minimale et maximale du tas de mémoire sur le processeur de messages pour qu’elles soient respectivement de 1 Go et 2 Go, ajoutez les lignes suivantes à ce fichier : 

    bin_setenv_min_mem=1024m
bin_setenv_max_mem=2048m
  3. Enregistrez les modifications.
  4. Assurez-vous que ce fichier de propriétés appartient à l'utilisateur apigee. Exemple : 
    chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
  5. Redémarrez le processeur de messages à l'aide de la commande suivante : 
    /opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
  6. Si vous avez plusieurs processeurs de messages, répétez ces étapes sur tous les processeurs de messages.

Vérifier la taille de la mémoire de tas sur les processeurs de messages

Cette section explique comment vérifier si les modifications de la mémoire de tas ont bien été appliquées aux processeurs de messages.

Même si vous avez utilisé les propriétés bin_setenv_min_mem et bin_setenv_max_mem pour modifier la taille de la mémoire de tas sur le processeur de messages, vous devez vérifier que les paramètres de ligne de commande Java -Xms et -Xmx ont été définis avec les nouvelles valeurs comme suit :

  1. Recherchez si les paramètres de ligne de commande -Xms et -Xmx ont été définis avec les nouvelles valeurs pour le processeur de messages à l'aide de la commande suivante : 
    ps -ef | grep message-processor | egrep -o 'Xms[0-9a-z]+|Xmx[0-9a-z]+' | tr '\r' ' '
  2. Si la mémoire de tas minimale et maximale a été modifiée sur le processeur de messages, la commande précédente affiche la nouvelle valeur pour -Xms et -Xmx.

    Voici un exemple de résultat de la commande précédente après avoir modifié la taille minimale et maximale du tas de mémoire sur le processeur de messages : 

    Xms1024m
Xmx2048m

    Dans l'exemple de résultat, notez que les nouvelles valeurs pour la taille minimale et maximale du tas ont été définies.

  3. Si vous voyez toujours les anciennes valeurs pour -Xms et -Xmx, vérifiez que vous avez correctement suivi toutes les étapes décrites dans Modifier la taille de la mémoire de tas sur les processeurs de messages. Si vous avez manqué une étape, répétez-les toutes correctement.
  4. Si vous ne parvenez toujours pas à modifier la mémoire de tas, contactez l'assistance Apigee Edge.

Et ensuite ?