Selon vos besoins en termes de trafic et de traitement, vous devrez peut-être modifier la taille de la mémoire du tas ou la taille des métadonnées de classe pour vos nœuds exécutant des composants Private Cloud basés sur Java.
Cette section fournit les tailles de mémoire du tas Java par défaut et recommandées, ainsi que la procédure à suivre pour modifier les valeurs par défaut. Enfin, cette section explique comment modifier d'autres paramètres JVM à l'aide de fichiers de propriétés.
Tailles de mémoire du tas par défaut et recommandées
Le tableau suivant répertorie les tailles de mémoire du tas Java par défaut et recommandées pour les composants Private Cloud basés sur Java :
| Composant | Nom du fichier de propriétés | Par défaut Taille du tas |
Recommandé Taille du tas |
|---|---|---|---|
| Runtime (durée d'exécution) | |||
| Cassandra | n/a | Configuration automatique1 | Configuration automatique1 |
| Processeur de messages | message‑processor.properties |
512 Mo | 3 à 6 Go2 |
| Routeur | router.properties |
512 Mo | 512 Mo |
| Analytics | |||
| Serveur Postgres | postgres‑server.properties |
512 Mo | 512 Mo |
| Serveur Qpid | qpid‑server.properties |
512 Mo | 2 à 4 Go |
| Gestion | |||
| Serveur de gestion | management‑server.properties |
512 Mo | 512 Mo |
Nouvelle interface utilisateur Edge (edge-management-ui) |
n/a | Application native3 | Application native3 |
| SymasLDAP | n/a | Application native3 | Application native3 |
| ZooKeeper | zookeeper.properties |
2 048 Mo | 2 048 Mo |
| Remarques | |||
1 Cassandra calcule dynamiquement la taille maximale du tas au démarrage. Actuellement, elle correspond à la moitié de la mémoire totale du système, avec un maximum de 8 192 Mo. Pour savoir comment définir la taille du tas, consultez Modifier la taille de la mémoire du tas. |
|||
| 2 Pour les processeurs de messages, Apigee vous recommande de définir la taille du tas
entre 3 et 6 Go. N'augmentez la taille du tas au-delà de 6 Go qu'après avoir effectué
des tests de performances.
Si l'utilisation du tas approche la limite maximale lors de vos tests de performances, augmentez la limite maximale. Pour savoir comment définir la taille du tas, consultez Modifier la taille de la mémoire du tas. |
|||
| 3 Tous les composants Private Cloud ne sont pas implémentés en Java. Comme elles ne sont pas basées sur Java, les applications qui s'exécutent de manière native sur la plate-forme hôte n'ont pas de tailles de tas Java configurables. Elles s'appuient plutôt sur le système hôte pour la gestion de la mémoire. | |||
Pour déterminer la quantité totale de mémoire qu'Apigee vous recommande d'allouer à vos composants basés sur Java sur un nœud, additionnez les valeurs listées ci-dessus pour chaque composant de ce nœud. Par exemple, si votre nœud héberge à la fois les serveurs Postgres et Qpid, Apigee vous recommande de combiner l'allocation de mémoire entre 2,5 et 4,5 Go.
Pour obtenir la liste du matériel requis (tel que la RAM), consultez Exigences d'installation.
Modifier les tailles de mémoire du tas
Pour modifier les paramètres de mémoire du tas, modifiez le fichier de propriétés du composant. Par exemple, pour
le processeur de messages, modifiez le
/opt/apigee/customer/application/message-processor.properties fichier.
Si le fichier message-processor.properties n'existe pas, ou si le fichier .properties correspondant pour un composant Edge n'existe pas, créez-le, puis modifiez le propriétaire du fichier en définissant l'utilisateur "apigee", comme illustré dans l'exemple suivant :
chown apigee:apigee /opt/apigee/customer/application/message-processor.properties
Si le composant est installé sur plusieurs machines, comme le processeur de messages, vous devez modifier le fichier de propriétés sur toutes les machines qui hébergent le composant.
Le tableau suivant répertorie les propriétés que vous modifiez pour modifier les tailles du tas :
| Propriété | Description |
|---|---|
bin_setenv_min_mem |
Taille minimale du tas. La valeur par défaut est basée sur les valeurs listées dans Tailles de mémoire du tas par défaut et recommandées. Ce paramètre correspond à l'option Java |
bin_setenv_max_mem |
Taille maximale du tas. La valeur par défaut est basée sur les valeurs listées dans Tailles de mémoire du tas par défaut et recommandées. Ce paramètre correspond à l'option Java |
bin_setenv_meta_space_size |
Taille par défaut des métadonnées de classe. La valeur par défaut est définie sur la valeur de
Ce paramètre correspond à l'option Java |
Lorsque vous définissez des propriétés de taille du tas sur un nœud, utilisez le suffixe "m" pour indiquer les mégaoctets, comme illustré dans l'exemple suivant :
bin_setenv_min_mem=4500m bin_setenv_max_mem=4500m bin_setenv_meta_space_size=1024m
Après avoir défini les valeurs dans le fichier de propriétés, redémarrez le composant :
/opt/apigee/apigee-service/bin/apigee-service component restart
Exemple :
/opt/apigee/apigee-service/bin/apigee-service edge-message-processor restart
Modifier d'autres propriétés JVM
Pour les paramètres Java qui ne sont pas contrôlés par les propriétés listées ci-dessus, vous pouvez également définir les éléments suivants dans le fichier de propriétés correspondant pour n'importe quel composant Edge :
bin_setenv_ext_jvm_opts: définissez n'importe quelle propriété Java non spécifiée par d'autres propriétés. Exemple :bin_setenv_ext_jvm_opts=-XX:MaxGCPauseMillis=500
Toutefois, n'utilisez pas
bin_setenv_ext_jvm_optspour définir-Xms,-Xmxou-XX:MetaspaceSize, car ces valeurs sont contrôlées par les propriétés listées ci-dessus.
Pour obtenir des conseils supplémentaires sur la configuration de la mémoire pour les composants Private Cloud, consultez cet article sur les forums Edge.