Unable to install JBoss ON server if local storage node is not also installed

Solution Unverified - Updated

Environment

  • Red Hat JBoss Operations Network (ON) 3.3
  • JBoss ON storage node is running on a remote host
  • JBoss ON server install is being attempted without its local storage node

Issue

  • Unable to install server when storage node has not been installed locally

  • Unable to install JON 3.3 Server after installing storage nodes

  • Server install stops with following warning when storage node is located on different host:

      WARN  [org.rhq.server.control.command.Start] It appears that the storage node is not installed. The --storage option will be ignored.

Resolution

Before executing the rhqctl install --server command, perform a temporary installation of a storage node:

  1. Make a backup copy of the rhq-server.properties file as the next step will make unwanted modifications:

     cp /opt/jboss/on/jon-server/bin/rhq-server.properties /opt/jboss/on/jon-server/bin/rhq-server.properties.real

  2. Run the storage node install:

    NOTE: The installation of the storage node will modify rhq-server.properties and replace the rhq.storage.nodes property value with the address of the temporary storage node. It is important that you complete the previous step before proceeding and that all steps are followed in order to ensure that correct version of rhq-server.properties is used when the server installation is performed.

     /opt/jboss/on/jon-server/bin/rhqctl install --storage --agent-preference="rhq.agent.server.bind-address=`hostname`"

  3. Restore the backup copy of rhq-server.properties that was made in the previous step:

     mv /opt/jboss/on/jon-server/bin/rhq-server.properties.real /opt/jboss/on/jon-server/bin/rhq-server.properties

  4. If a local agent is running, stop it:

    IMPORTANT: You must ensure the agent is not started until after the temporary storage node has been shutdown and removed. If the local agent is running and discovers the temporary storage node, it may get added to the storage cluster during the installation of the JBoss ON server.

     /opt/jboss/on/jon-server/bin/rhqctl stop --agent

  5. Proceed with the installation of the JBoss ON server as normal:

    NOTE: This process will start the temporary storage node. As long as a local JBoss ON agent is not running and the temporary storage node's address was not added to the rhq.storage.nodes property in rhq-server.properties or to any storage node that has already been installed, the server installer will not actually use the temporary storage node.

     /opt/jboss/on/jon-server/bin/rhqctl install --server

  6. After the server install is complete, stop the temporary storage node in case it is still running:

     /opt/jboss/on/jon-server/bin/rhqctl stop --storage

  7. Remove the temporary storage node installation:

     rm -r /opt/jboss/on/jon-server/rhq-storage
 rm -r /opt/jboss/on/rhq-data

You can now start the server normally.

Root Cause

When the server install is executed by rhqctl it attempts to start a local storage node using a command similar to:

rhqctl start --storage

Because a local storage node is not installed, the start command emits the warning:

    WARN  [org.rhq.server.control.command.Start] It appears that the storage node is not installed. The --storage option will be ignored.

This warning also indicates that the command returned a status code that indicated that it was unsuccessful. Due to the unsuccessful status, the install is not attempted.

This issue has been captured in This content is not included.Red Hat Bugzilla 1180343 and will be addressed in a future release.

Diagnostic Steps

  • For this issue to apply, the affected server's installation directory can not have a directory named rhq-storage.

  • The command rhqctl install --server does not do anything but product the following output:

      INFO  [org.jboss.modules] JBoss Modules version 1.3.3.Final-redhat-1
  WARN  [org.rhq.server.control.command.Start] It appears that the storage node is not installed. The --storage option will be ignored.
  INFO  [org.rhq.server.control.command.Install] Pausing to ensure RHQ Storage is initialized prior to RHQ Server installation.
  WARN  [org.rhq.server.control.command.Stop] It appears that the storage node is not installed. The --storage option will be ignored.
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.