Symptômes

Avec une configuration FileJournal par défaut en place, en fonction de l'activité sur le référentiel, de nombreux fichiers journaux seront créés au fil du temps. Cela peut éventuellement entraîner un problème d'espace disque et des problèmes de performance dans les applications qui utilisent CRX.

Cause

La configuration par défaut du journal permet d'obtenir en théorie un nombre illimité de fichiers journaux tournants.

Résolution

Selon la configuration, la configuration diffère légèrement et se fait dans le repository.xml. Pour plus d'informations sur les paramètres de configuration individuels, veuillez vous référer à l'article de configuration du journal.
 
 REMARQUE : Sauvegardez l'instance avant d'appliquer toute modification.

Version CQ / CRX Emplacement
5.2.x / 1.4.2 crx-quickstart/server/runtime/0/_crx/WEB-INF/repository.xml
5.3 / 2.0 crx-quickstart/repository/repository.xml
5.5 / 2.3 crx-quickstart/repository/repository.xml

Outre la reconfiguration du FileJournal, le journal existant doit être nettoyé. Remarque : comme condition préalable pour les environnements CRX en grappe, nous vous conseillons vivement de laisser se synchroniser complètement tous les nœuds de grappe à la même révision que le maître avant d'appliquer les changements suivants :

  1. Arrêtez (toutes les) instances CRX.
  2. Si vous disposez d'une grappe de nœuds multiples, vérifiez que tous les nœuds sont synchronisés avec la révision en cours.
    1. Pour chaque nœud de grappe, vérifiez que le numéro de révision dans crx-quickstart/repository/revision.log correspond à crx-quickstart/repository/shared/journal/revision
    2. Les numéros de révision sont stockés au format binaire, vous pouvez donc utiliser la commande diff sous Linux pour les comparer. Sous Windows, vous pouvez utiliser un outil diff à capacité binaire tel que WinMerge.
  3. Supprimer TOUS les fichiers sous crx-quickstart/repository/shared/journal.
  4. Supprimez crx-quickstart/repository/revision.log.
  5. Appliquez la reconfiguration du journal.
  6. Démarrez (toutes) les instances CRX.

 

Environnement hors grappe

Dans un environnement hors grappe où CRX fonctionne en mode autonome, configurez la taille maximale d'un fichier journal à 100 Mo et limitez le nombre de fichiers autorisés à 1. Cela est plus que suffisant pour une telle configuration.

<Journal class="com.day.crx.core.journal.FileJournal"> <param name="sharedPath" value="${rep.home}/shared"/> <param name="maximumSize" value="104857600" /> <param name="maximumFiles" value="1" /> </Journal> 

 

Environnement en grappe

Si CRX s'exécute dans une grappe avec d'autres instances CRX, ajustez le nombre de fichiers journaux tournants. Le journal garde en principe une trace de chaque opération de sauvegarde du référentiel, donc en fonction de la durée pendant laquelle un nœud de grappe esclave peut être déconnecté avant de pouvoir rattraper la dernière révision de l'instance du nœud de grappe maître, les 2 paramètres suivants peuvent être configurés pour correspondre aux exigences :

  • maximumAge : âge maximal d'un fichier journal avant sa suppression.
  • maximumFiles : nombre maximal de rotations des journaux.

 

<Journal class="com.day.crx.core.journal.FileJournal"> <param name="sharedPath" value="${rep.home}/shared"/> <param name="maximumSize" value="104857600" /> <param name="maximumAge" value="P1M" /> <param name="maximumFiles" value="10" /> </Journal> 
Rotation d'un Tarjournal dans un groupage sans partage
À partir de CRX 2.2 et au-delà, vous utliserez un nouveau TarJournal lequel exécute le journal en utilisant le format de fichier TarPM amélioré et le protocole de synchronisation de grappe, et fonctionne en mode sans partage.  La valeur par défaut de la taille maximale du fichier est de 256 Mo. Bien que cette valeur par défaut soit exacte dans la plupart des cas. La valeur maximale est de 1 Go. Pour plus d'informations sur d'autres paramètres, cliquez ici. Les changements s'appliquent lors de la prochaine exécution de l'optimisation de Tar.  Un exemple de rotation se produisant après toutes les 24 heures est indiqué sous
<Journal class="com.day.crx.persistence.tar.TarJournal">     <param name="maxFileSize" value="256"/>     <param name="maximumAge" value="PT24H"/> </Journal> 

Application

CRX1.4.2, CRX2.0, CRX2.2, CRX2.3

Ce produit est distribué sous licence Creative Commons Attribution - Pas d’utilisation commerciale - Partage à l’identique 3.0 non transposé  Les publications Twitter™ et Facebook ne sont pas couvertes par les dispositions Creative Commons.

Mentions légales   |   Politique de confidentialité en ligne