9.4.3. Annulation d'un correctif sous forme zip par le système de gestion des correctifs

Résumé

Le système de gestion de correctifs de JBoss EAP 6 permet d'annuler l'application d'un correctif zip précédemment appliqué, via l'interface CLI ou par la console de gestion.

Avertissement

Il n'est pas prévu de pouvoir annuler l'application d'un correctif à l'aide du système de gestion des correctifs, comme une fonctionnalité de désinstallation générale. Il est uniquement destiné à être utilisé immédiatement après l'application d'un correctif qui a eu des conséquences indésirables.

Important

Le systéme de gestion des correctifs a été ajouté dans la version JBoss EAP 6.2. Pour les versions JBoss EAP antérieures à 6.2, le processus de suppression de correctifs sous la forme zip est différent, et vous devrez, à la place, consulter la documentation de la version concernée à l'adresse suivante https://access.redhat.com/site/documentation/.

Pré-requis

  • Un correctif ayant déjà été appliqué par le système de gestion des correctifs de JBoss EAP 6.
  • Accédez à l'interface CLI ou à la console de gestion pour le serveur de JBoss EAP 6. Voir la section Launch the Management CLI ou Log in to the Management Console du guide Administration and Configuration Guide.

Avertissement

Quand vous suivez cette procédure, faîtes attention quand vous spécifiez la valeur de l'option Reset Configuration.
Si défini à TRUE, en retirant le correctif, vous restaurerez également les fichiers de configuration du serveur JBoss EAP 6 à leur état d'avant correctif. Tout changement qui aura lieu sur les fichiers de configuration du serveur JBoss EAP 6 à la suite de ce correctif sera perdu.
Si défini à FALSE, les fichiers de configuration ne seront pas supprimés. Dans un tel cas, il est possible que le serveur ne démarre pas à nouveau après l'opération de restauration, car il y a pu avoir des altérations de configuration comme des altérations d'espace-nom, qui ne seront plus valides et qui devront être réparées manuellement.

Procédure 9.4. Supprimer un correctif zip à une instance de serveur JBoss EAP 6 par l'interface de gestion CLI

  1. Avec l'interface CLI, appliquez la commande patch info pour trouver l'ID du patch à retirer.
    • Avec les correctifs cumulatifs, l'ID du correctif correspond à la première valeur cumulative-patch-id qui apparaît dans la sortie patch info.
    • Les ID de correctifs de bogues ou de sécurité spontanés sont listés comme valeur des premiers patches (correctifs) qui apparaissent dans la sortie patch info, avec le correctif spontané listé en premier.
  2. Avec l'interface CLI, retirez le correctif avec l'ID de correctif de l'étape précédente.
    [standalone@localhost:9999 /] patch rollback --patch-id=PATCH_ID --reset-configuration=TRUE
    L'outil patch avertira s'il y a conflit pour la tentative de suppression de correctif. Consultez Section 9.4.1, « Le Patch Management System (système de gestion des correctifs) » pour voir les options disponibles d'exécution à nouveau de la commande patch pour résoudre les conflits.
  3. Démarrez à nouveau le serveur JBoss EAP 6 pour que la suppression de correctif puisse prendre effet :
    [standalone@localhost:9999 /] shutdown --restart=true

Procédure 9.5. Supprimer un correctif zip à une instance de serveur JBoss EAP 6 par la console de gestion.

  1. Dans la console de gestion :
    • Pour un serveur autonome : cliquez sur l'onglet Runtime (exécution) en haut de l'écran, puis cliquez sur Patch Management (gestion des correctifs).
    • Pour un domaine géré : cliquez sur l'onglet Domain en haut de l'écran, puis sélectionnez l'hôte qui convient sur le menu déroulant Host (hôte), puis cliquez sur Patch Management (gestion des correctifs).
  2. Dans le tableau Recent Patch History (historique récent des correctifs), sélectionnez le correctif que vous souhaitez supprimer, puis cliquez sur Rollback.
    1. Pour un hôte de domaine géré, sélectionnez si vous devez arrêter des serveurs sur l'hôte, sur le prochain écran, puis cliquez sur Next (suite).
  3. Sélectionner vos options pour le processus de suppression, puis cliquez sur Next.
  4. Confirmez vos options et le correctif à supprimer, puis cliquez sur Next.
    1. Si l'option Override all n'est pas sélectionnée, et qu'il n'y a pas de conflit lors du processus d'application du correctif, un message d'avertissement s'affichera. Cliquez sur View error details pour voir le détail des conflits. S'il y a un conflit, vous pouvez annuler l'opération, ou bien, cliquez sur Choose Options et essayez l'opération à nouveau avec la case Override all sélectionnée. La suppression des conflits se traduira par l'annulation du correctif prévalant sur toute modification de l'utilisateur.
  5. Une fois que le correctif aura été supprimé, sélectionnez s'il faut redémarrer le serveur JBoss EAP 6 dès maintenant pour que les changements prennent effet, puis cliquez sur Finish.
Résultat

Le correctif, et parfois aussi les fichiers de configuration du serveur sont retirés de l'instance de serveur de JBoss EAP 6.