Le défi des personnalisations serveur lors des mises à jour MAS
Dans les architectures IBM Maximo Application Suite (MAS), les personnalisations avancées au niveau du serveur d’applications WebSphere Liberty posaient historiquement un problème de maintenance récurrent : à chaque application d’un patch ou d’une mise à jour de MAS Manage, les fichiers d’origine étaient écrasés par la nouvelle image de base.
Les équipes techniques et partenaires d’intégration devaient alors réappliquer manuellement leurs modifications sur des fichiers critiques tels que web.xml ou file-dash-size.config. Pour répondre à ce besoin, un mécanisme de hooks de personnalisation exécutés directement durant le build de l’image Liberty permet d’intégrer des scripts shell au sein de l’archive de personnalisation (Customization Archive).
Injection des hooks durant le build de l’image Liberty
Trois cas d’usage concrets résolus par les hooks Liberty
L’utilisation d’un script shell exécuté au moment de la construction du conteneur permet d’automatiser proprement trois scénarios métiers et techniques fréquents :
1. Ajout de polices personnalisées pour les rapports et workflows
Les entreprises ayant des chartes graphiques strictes ou des besoins d’affichage spécifiques peuvent embarquer des fichiers de polices (.ttf, .otf) dans l’archive de personnalisation et les copier dans les répertoires système des pods maxinst et des pods de bundles serveur. Cela garantit un rendu fidèle des rapports BIRT et de la visualisation graphique des nœuds de Workflow.
2. Fusion dynamique d’éléments dans web.xml
Plutôt que de remplacer intégralement le fichier web.xml (ce qui risque de casser les nouvelles fonctionnalités introduites par un patch IBM), le script hook peut fusionner uniquement les balises XML personnalisées (filtres de sécurité, paramètres de session, servlets spécifiques) avec le fichier web.xml natif de la nouvelle version.
3. Positionnement de fichiers dans l’arborescence Liberty (ex: JAR JVM)
Par défaut, l’archive de personnalisation dépose les fichiers supplémentaires (additional-server-files) à la racine du serveur Liberty. Grâce au hook de build, il est désormais possible de déplacer ces fichiers vers un sous-répertoire précis de Liberty, par exemple pour installer un fichier JAR de fournisseur JVM (JVM provider jar file) ou un pilote spécifique au bon emplacement du classpath.
Exemple d’implémentation dans un script de hook
Voici un exemple de structure de script shell exécuté lors de la phase de personnalisation pour copier une police système, déplacer une librairie JVM et sauvegarder avant fusion un fichier XML :
#!/bin/bash
set -e
LIBERTY_DIR="/opt/ibm/wlp/usr/servers/defaultServer"
CUSTOM_TMP="/tmp/customization/additional-server-files"
# 1. Installation de polices personnalisées pour les rapports et workflows
if [ -d "${CUSTOM_TMP}/fonts" ]; then
mkdir -p /usr/share/fonts/custom-mas
cp -f ${CUSTOM_TMP}/fonts/*.ttf /usr/share/fonts/custom-mas/
fc-cache -fv
fi
# 2. Déplacement d'un JAR JVM provider vers le répertoire lib de Liberty
if [ -f "${CUSTOM_TMP}/jvm/custom-security-provider.jar" ]; then
mkdir -p "${LIBERTY_DIR}/lib/global"
mv "${CUSTOM_TMP}/jvm/custom-security-provider.jar" "${LIBERTY_DIR}/lib/global/"
fi
# 3. Fusion contrôlée d'un fragment XML dans web.xml (exemple avec xmllint / python)
if [ -f "${CUSTOM_TMP}/xml/custom-web-fragment.xml" ]; then
cp "${LIBERTY_DIR}/apps/maximo.war/WEB-INF/web.xml" "${LIBERTY_DIR}/apps/maximo.war/WEB-INF/web.xml.bak"
python3 "${CUSTOM_TMP}/scripts/merge_web_xml.py" \
"${LIBERTY_DIR}/apps/maximo.war/WEB-INF/web.xml" \
"${CUSTOM_TMP}/xml/custom-web-fragment.xml"
fi
Bonnes pratiques et critères de validation
Pour garantir la stabilité de vos builds MAS Manage lors de l’utilisation de ces hooks :
| Contrôle technique | Recommandation et vérification |
| Idempotence du script | Le script shell doit pouvoir être exécuté plusieurs fois sans dupliquer les entrées dans web.xml ni provoquer d’erreur si un dossier existe déjà (mkdir -p, cp -f). |
Gestion des erreurs (set -e) |
Toujours interrompre le script en cas de code retour non nul afin d’éviter la génération silencieuse d’une image serveur incomplète. |
| Validation XML | Après toute fusion sur web.xml ou file-dash-size.config, valider la syntaxe du fichier généré (xmllint --noout) avant la fin du build. |
| Tests de non-régression | Tester systématiquement le rendu des rapports, l’affichage des workflows et le démarrage des pods maxinst et bundle en environnement de recette. |
Limites et précautions
- Maintenance du code de fusion : L’injection via script shell offre une liberté totale en attendant des mécanismes natifs basés sur XPath, mais la logique de fusion XML reste sous la responsabilité de l’équipe projet.
- Compatibilité des mises à jour majeures : Bien que cette approche élimine le besoin de re-customiser à chaque patch mineur, il reste indispensable de vérifier la structure cible du
web.xmld’IBM lors d’un changement de version majeure de MAS.
À retenir : Les hooks de build Liberty industrialisent les personnalisations bas niveau de MAS Manage en les rendant reproductibles et résistantes aux montées de patchs.
Références
- IBM Documentation : Customizing Maximo Manage.
Commentaires
Une question ou un retour d’expérience sur cette procédure ? Partagez-le ici.
Connectez-vous pour participer à la discussion.
Se connecter