Compilation des JSP
Fini les lenteurs au démarrage de vos applications JPlatform.
Les bénéfices
Après chaque redémarrage ou déploiement, la première consultation de chaque page est souvent plus lente. En effet, le serveur doit compiler ses JSP et JPlatform remplir ses caches. Le module fait ce travail à leur place, au démarrage et en arrière-plan.
Si vous déployez régulièrement des mises à jours sur vos plateformes Jalios, vos administrareurs, contributeurs et utilisateurs ne se pleindrons plus des lenteurs perçues au démarrage.
- Des temps de réponse normaux dès le redémarrage, que ce soit en back office ou en front office.
- Un redémarrage qui passe inaperçu : le préchargement tourne en tâche de fond et vos utilisateurs ne subissent pas la remise en route.
- Un contrôle automatique après chaque déploiement : les pages en erreur sont signalées dans les logs ce qui permet d'anticiper des remontées utilisateurs.
- Un fonctionnement sûr : les appels restent sur le serveur qui démarre et ne sortent jamais du site.
Les fonctionnalités
Le module déclenche deux traitements au démarrage de JPlatform, activables séparément.
- Préchargement des pages
- Le module appelle réellement les pages du site, comme le ferait un visiteur. Les JSP sont compilées et les caches remplis.
- Les pages essentielles sont trouvées automatiquement (page de connexion, recherche, barre latérale, portails par défaut, portails d'impression, applications, accueil...).
- Une liste de pages est livrée par défaut, essentiellement des écrans d'administration et d'espaces de travail, et vous pouvez y ajouter vos propres pages.
- Pour les pages réservées à des membres ou aux administrateurs, les appels peuvent être faits au nom d'un compte technique, avec une clé d'authentification temporaire.
- Compilation des JSP par répertoire
- Le module compile toutes les JSP des répertoires choisis (
/custom/et/front/par défaut), sans appel HTTP ni compte utilisateur. - La compilation rattrape les JSP que les pages appelées n'ont pas sollicitées.
- Le module compile toutes les JSP des répertoires choisis (
Chaque traitement se termine par un bilan dans les logs (pages réussies, non authentifiées, en accès refusé, hors site ou en erreur, nombre de JSP compilées et en échec).
Les clients aiment
Informations détaillées
Prérequis techniques
Compatibilité JSync
Ce module est compatible jSync, il fonctionnera sans problème sur un environnement à plusieurs réplicas.
Compatibilité JDK
Ce module est compatible avec la version 11 de JDK (Java Development Kit).
Serveur Tomcat
Nécessite un serveur d'application Tomcat pour la détection automatique de l'adresse locale. Sur un autre serveur, renseigner l'adresse locale de l'instance (propriété jcmsplugin.jspcompilation.url-warmup.local-server-url, à surcharger dans la configuration de l'instance).
Compte de service
Nécessite un compte de service dédié pour précharger les écrans réservés : il doit être administrateur pour les écrans d'administration de la liste livrée par défaut.
Configuration du module
Ajouter ce module via le gestionnaire de modules depuis l'administration technique et redémarrer JPlatform.
Choisir le compte au nom duquel les pages sont préchargées, de préférence un compte de service dédié, et le renseigner depuis l'écran des propriétés du module ou dans le custom.prop (propriété $id.jcmsplugin.jspcompilation.url-warmup.member). Sans compte, les appels sont anonymes et les écrans réservés aboutissent sur la page de connexion.
Vérifier que les racines de navigation du site (paramètre « Racines de navigation » des propriétés du portail, propriété JPlatform display.navigate-root) correspondent à l'arborescence actuelle : ce sont elles qui déterminent les catégories préchargées. Si elles ne sont pas renseignées, aucune catégorie de navigation n'est préchargée.
La liste des répertoires compilés est volontairement réduite pour rester rapide. Le répertoire le plus utile à ajouter ensuite est /types/, qui contient les gabarits des contenus et des portlets.
Pour vérifier le bon fonctionnement après le redémarrage, chercher [url-warmup] Terminé et [path-warmup] Terminé dans les logs et contrôler les lignes WARN. Les traitements ne sont lancés qu'au démarrage et ne peuvent pas être relancés à la main.
- Nom technique jcmsplugin.jspcompilation.url-warmup.enabled.boolean
- Description Appelle en HTTP, au démarrage, les pages principales du site (portails, navigation, recherche, connexion) et les URLs listées ci-dessous. Les pages sont entièrement affichées : JSP compilées et caches remplis. Exécuté avant la compilation des JSP par chemin.
- Nom technique jcmsplugin.jspcompilation.url-warmup.urls.area
- Description Une URL par ligne, relative au site (ex. admin/admin.jsp) ou absolue.
- Nom technique $id.jcmsplugin.jspcompilation.url-warmup.member.chooser-member
- Description Membre au nom duquel les URLs sont appelées, pour afficher les pages réservées aux membres. Utilisé uniquement par le préchargement des URLs. Si vide, les appels sont anonymes. Choisir un compte technique aux droits limités.
- Nom technique jcmsplugin.jspcompilation.url-warmup.navigate-root.level.max
- Description Nombre de niveaux de catégories préchargés à partir des racines de navigation du site (propriété JPlatform display.navigate-root). Valeurs : 0 = aucune catégorie ; 1 = les racines seules ; 2 = les racines et leurs sous-catégories directes ; et ainsi de suite ; -1 ou vide = toute l'arborescence. Chaque catégorie correspond à un appel HTTP au démarrage : sur une arborescence profonde, préférez une valeur de 2 ou 3.
- Nom technique jcmsplugin.jspcompilation.path-warmup.enabled.boolean
- Description Compile toutes les JSP trouvées sous les chemins ci-dessous, sans appel HTTP ni compte utilisateur. Exécuté après le préchargement des URLs.
- Nom technique jcmsplugin.jspcompilation.path-warmup.paths.area
- Description Liste des répertoires de la webapp dont les JSP sont compilées (ex. / pour toute l'application).
- Nom technique jcmsplugin.jspcompilation.path-warmup.max-thread-count
- Description Nombre de threads utilisés pour la compilation des JSP. Plus le nombre est élevé, plus le traitement est rapide et plus l'utilisation CPU est élevée.
Evolutions
- Préchargement des pages par de vrais appels HTTP : liste de 44 pages livrée par défaut, essentiellement des écrans d'administration et d'espaces de travail, et pages essentielles du site calculées automatiquement (connexion, recherche, portails, navigation).
- Appels possibles au nom d'un membre, par une clé d'authentification temporaire limitée au serveur.
- Appels dirigés vers l'instance qui démarre et non vers l'URL publique, avec attente de l'ouverture du serveur.
- Deux traitements activables séparément, bilan détaillé par type de résultat et documentation intégrée.
Corrections
- Les redirections hors du site ne sont plus suivies ; les redirections internes et les pages de connexion sont correctement comptabilisées ; le bilan de compilation est toujours écrit.
- Les propriétés
jcmsplugin.jspcompilation.max-thread-countetjcmsplugin.jspcompilation.pathssont remplacées parjcmsplugin.jspcompilation.path-warmup.max-thread-countetjcmsplugin.jspcompilation.path-warmup.paths.
