A JBOSS_HOME environment variable set in the user env that is executing apply-update causes jboss-cli updates to fail when updating JBoss ON

Solution Verified - Updated

Environment

  • Red Hat JBoss Operations Network (ON) 3.3.6, 3.3.7
  • Environment variable JBOSS_HOME set in user's profile or environment
  • apply-updates is executed to update existing JBoss ON server installation

Issue

  • JBOSS_HOME environment variable set causes jboss-cli update to fail

  • apply-updates script logs a WARNING message:

      Failed to apply jboss-cli updates, these may need to be applied manually. Continuing...

Resolution

This is a bug, reported in the This content is not included.Red Hat Bugzilla 1366324 and will be fixed in a following releases of JBoss ON.

Although the WARNING message was shown, JBoss ON was properly updated and there is no need to execute any other jboss-cli command manually.

Root Cause

As part of the update process for a JBoss ON server, its jboss-cli utility is used to executed configuration updates in the underlying application server. However, jboss-cli will use the environment variable JBOSS_HOME if defined as the location for the applications server's files. The apply-updates utility does not explicitly set this value so if the user's environment includes a value for JBOSS_HOME, it will get passed to the invocation of jboss-cli resulting in a failure.

Diagnostic Steps

  • Check to see if the environment variable JBOSS_HOME is defined in the environment of the user who is executing apply-updates. If a value is assigned and it is not the complete path to the internal EAP instance that JBoss ON is using, this issue applies.
SBR
Product(s)
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.