9.2. Appliquer des correctifs dans Red Hat JBoss BPM Suite 6.3

Dans Red Hat JBoss BPM Suite, l'outil de correction client est distribué comme un fichier zip comprenant des scripts .sh et .bat simples, permettant une application de mises à jour facilitée et automatique sur une installation Red Hat JBoss BPM Suite 6.1 (ou version ultérieure).

Le script nécessite deux paramètres obligatoires : <path-to-distribution-root> et <type-of-distribution>. Par exemple, la commande suivante applique les mises à jour au lot JBoss EAP suivant :

$ ./apply-updates.sh ~/EAP_HOME/jboss-eap-6.4 eap6.x

Les types de distribution suivants sont pris en charge :

Les outils de migration et démarrage rapide sont également inclus dans le correctif et peuvent être téléchargés en tant que fichier zip.

Avant d'appliquer une mise à jour, le script client effectue une sauvegarde de la distribution spécifiée et copie le fichier de distribution ou le répertoire dans le sous-répertoire backup/<current-timestamp>. Le répertoire de sauvegarde de niveau supérieur est créé au même niveau de fichier système que le apply-updates.

L'outil de correction client fournit une fonctionnalité liste noire permettant d'indiquer au script les fichiers devant être mis à jour. Cette fonctionnalité est très utile et permet de conserver vos fichiers de configuration et d'éviter qu'ils ne soient supprimés automatiquement par le processus de mise à jour. Vous pouvez également indiquer des fichiers autres que des fichiers de configuration, si besoin.

Pour spécifier les fichiers de la liste noire, ouvrez le fichier blacklist.txt présent dans la distribution de correction. Saisissez le chemin d'accès relatif aux fichiers ne devant pas être mis à jour. Chaque fichier doit être précisé sur une ligne individuelle.

# lines with a '#' are comment lines, like this one
# blank lines are ignored

# we have made changes to the web.xml that must be preserved
WEB-INF/web.xml

# this file has custom modifications
styles/base.css

Les fichiers spécifiés dans le fichier blacklist.txt et dont le contenu du correctif est mis à jour ne seront pas pris en compte par l'outil de mise à jour. À la place, l'outil copie le nouveau fichier mis à jour au même emplacement et y ajoute le suffixe new. Par exemple, après l'exécution de l'outil de correction, ces deux fichiers existeront dans le dossier styles, continuant avec le fichier blacklist.txt dans l'exemple ci-dessus.

$ ls styles
base.css base.css.new

Il est maintenant de votre responsabilité de comparer le contenu des deux documents et de fusionner les modifications.

Que se passe-t-il si vous souhaitez conserver des fichiers qui ne sont plus distribués ? Placez-les également dans le fichier blacklist.txt. L'outil de mise à jour de correction ne supprimera pas ces fichiers, et créera à la place un fichier marqueur vide avec le suffix removed. Vous pourrez ensuite décider de conserver ou supprimer ces fichiers manuellement.

Sur la base du même exemple, si le fichier base.css a été supprimé et qu'il était listé dans le fichier blacklist.txt, le contenu du répertoire des styles sera, suite à l'exécution de l'outil de correction, semblable à ce qui suit :

$ ls styles
base.css base.css.removed