JBoss EAP `installer revert` from EAP 8.1 Update 7.x and Update 8.x does not succeed

Solution Verified - Updated

Environment

  • Red Hat JBoss Enterpise Application Platform (EAP)
    • 8.1 Update 7.x
    • 8.1 Update 8.x

Issue

  • The JBoss CLI installer cannot successfully revert from update 7-8 to prior updates or revisions:
installer history
installer revert --revision=...
shutdown --perform-installation
...
PRSP000272: Failed to apply the candidate changes due to: /private/tmp/jboss-eap-8.1/standalone/tmp/installation-manager/prepared-server/.galleon

The incomplete update changes have been rolled back. Please resolve above error and try to perform update again. 
20:30:31,540 ERROR [org.wildfly.prospero] (main) PRSP000272: Failed to apply the candidate changes due to: /private/tmp/jboss-eap-8.1/standalone/tmp/installation-manager/prepared-server/.galleon: org.wildfly.prospero.api.exceptions.ApplyCandidateException: PRSP000272: Failed to apply the candidate changes due to: /private/tmp/jboss-eap-8.1/standalone/tmp/installation-manager/prepared-server/.galleon 
  at org.jboss.prospero//org.wildfly.prospero.actions.ApplyCandidateAction.applyUpdate(ApplyCandidateAction.java:224)
  at org.jboss.prospero//org.wildfly.prospero.cli.commands.RevertCommand.applyCandidate(RevertCommand.java:76)
  at org.jboss.prospero//org.wildfly.prospero.cli.commands.RevertCommand$ApplyCommand.call(RevertCommand.java:184)
  at org.jboss.prospero//org.wildfly.prospero.cli.commands.RevertCommand$ApplyCommand.call(RevertCommand.java:148)
  at org.jboss.prospero//picocli.CommandLine.executeUserObject(CommandLine.java:2045)
  at org.jboss.prospero//picocli.CommandLine.access$1500(CommandLine.java:148)
  at org.jboss.prospero//picocli.CommandLine$RunLast.executeUserObjectOfLastSubcommandWithSameParent(CommandLine.java:2465)
  at org.jboss.prospero//picocli.CommandLine$RunLast.handle(CommandLine.java:2457)
  at org.jboss.prospero//picocli.CommandLine$RunLast.handle(CommandLine.java:2419)
  at org.jboss.prospero//picocli.CommandLine$AbstractParseResultHandler.execute(CommandLine.java:2277)
  at org.jboss.prospero//picocli.CommandLine$RunLast.execute(CommandLine.java:2421) 
  at org.jboss.prospero//picocli.CommandLine.execute(CommandLine.java:2174)
  at org.jboss.prospero//org.wildfly.prospero.cli.CliMain.execute(CliMain.java:141)
  at org.jboss.prospero//org.wildfly.prospero.cli.CliMain.main(CliMain.java:68)
  at org.jboss.modules.Module.run(Module.java:345)
  at org.jboss.modules.Module.run(Module.java:313)
  at org.jboss.modules.Main.main(Main.java:612) 
Caused by: java.nio.file.NoSuchFileException: /private/tmp/jboss-eap-8.1/standalone/tmp/installation-manager/prepared-server/.galleon
  at java.base/sun.nio.fs.UnixException.translateToIOException(UnixException.java:92) 
  at java.base/sun.nio.fs.UnixException.rethrowAsIOException(UnixException.java:106) 
  at java.base/sun.nio.fs.UnixException.rethrowAsIOException(UnixException.java:111)
  at java.base/sun.nio.fs.UnixFileAttributeViews$Basic.readAttributes(UnixFileAttributeViews.java:55)
  at java.base/sun.nio.fs.UnixFileSystemProvider.readAttributes(UnixFileSystemProvider.java:148)
  at java.base/java.nio.file.Files.readAttributes(Files.java:1851)
  at java.base/java.nio.file.FileTreeWalker.getAttributes(FileTreeWalker.java:226)
  at java.base/java.nio.file.FileTreeWalker.visit(FileTreeWalker.java:277)
  at java.base/java.nio.file.FileTreeWalker.walk(FileTreeWalker.java:323)
  at java.base/java.nio.file.Files.walkFileTree(Files.java:2804) 
  at org.jboss.prospero//org.jboss.galleon.util.IoUtils.copy(IoUtils.java:160)
  at org.jboss.prospero//org.wildfly.prospero.actions.ApplyCandidateAction.updateMetadata(ApplyCandidateAction.java:404)
  at org.jboss.prospero//org.wildfly.prospero.actions.ApplyCandidateAction.applyUpdate(ApplyCandidateAction.java:204)
  ... 16 more

2026-08-20 20:30:31,3N ERROR [management-cli-installer] - The operation was unsuccessful. The candidate server was not installed correctly. Check server logs for more information.

Resolution

  • Update to EAP 8.1 Update 9+
  • If needing to revert from Update 7.x - 8.x, use the standalone jboss-eap-installation-manager instead, for example:
./jboss-eap-installation-manager.sh revert perform --revision=<hash>

Root Cause

SBR
Product(s)
Components
Category
Tags

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.