There have been some relevant changes to install and upgrade for Standalone Storage Nodes: These RHQ wiki pages have been updated with the changes and the JON docs need to also include the changes: https://docs.jboss.org/author/display/RHQ/RHQ+Storage+Node+Installation section: Installation Steps https://docs.jboss.org/author/display/RHQ/Upgrading+RHQ section: rhq-server.properties
(In reply to Jay Shaughnessy from comment #0) > There have been some relevant changes to install and upgrade for Standalone > Storage Nodes: > > These RHQ wiki pages have been updated with the changes and the JON docs > need to also include the changes: > > https://docs.jboss.org/author/display/RHQ/RHQ+Storage+Node+Installation > section: Installation Steps The way I understand it, the important info from this is the command to use. If that is correct, I believe the information is already in the Installation Guide (Installing Storage Nodes Before Installing the Server) http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html-single/Installation_Guide/index.html#storage-server-preinstall I need to verify whether my understanding is correct, and if not will need some assistance finding the right place for it.
(In reply to Jay Shaughnessy from comment #0) > There have been some relevant changes to install and upgrade for Standalone > Storage Nodes: > > These RHQ wiki pages have been updated with the changes and the JON docs > need to also include the changes: > > https://docs.jboss.org/author/display/RHQ/Upgrading+RHQ > section: rhq-server.properties Just confirming that the whole section needs to be consumed in the enterprise docs, or just elements? The best place I can see for this info is in http://documentation-devel.engineering.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.3/html-single/Installation_Guide/index.html#upgrade-proc, in Step 7 (Optional). If required, I would elaborate in this step and call out the two points about rhq.autoinstall.database and rhq.server.high-availability.name. And "Upgrading RHQ 4.12 (or earlier) Standalone Storage Nodes" seems to be important. Just checking that RHQ 4.12 is JON 3.3 and 4.12 is JON 3.2 in this admonition.
Hi Jared, in response to Comment 2: The relevant change to Standalone Storage Node installation is at "Installation Steps:bullet 1" in https://docs.jboss.org/author/display/RHQ/RHQ+Storage+Node+Installation - the step about setting the db properties in rhq-server.properties. I didn't see this in the JON docs you referenced. ------------ Unrelated but something I noticed: in the docs: at 2.10, step 3. When using the --agent-preference option on Windows, there is this caveat: https://docs.jboss.org/author/display/RHQ/Windows+Installation#WindowsInstallation-RHQrunsasWindowsServices
Hi Jared, in response to Comment 3: In general, yes, the upgrade section has been revised in the wiki to be more structured as steps, and has a decent amount of updated content. The whole thing could be re-done in the JON docs. But here are a few specific comments regarding the current JON content, in case you want to keep a lot of it as is: 3.1.2: recommended change: "Installs and configures a new storage database node for monitoring data" --> "Upgrades or Installs a JBoss ON Storage Node. 3.1.2: The "Warning" and "Important" blurbs are only relevant to 3.1.2 (the data migrator is only relevant when upgrading from releases without storage nodes). 3.1.2: The upgrade --start option no longer exists, there is no automatic start after upgrade. To ensure that the entire RHQ topology is upgraded, including the update of the storage cluster schema (which is now a separate step), We require that startup be performed explicitly. 3.1.2: The upgrade --run-data-migrator option no longer exists. To ensure that the entire RHQ topology is upgraded, including the installation of the storage cluster schema (which is now a separate step), We require that data migration be executed after upgrade, using the command line utility. The --delete-data and --delete-only options were used only with --run-data-migrator, so they are no longer applicable. 3.1.2: The --storage-data-root-dir existed previously and has not changed, but is not mentioned in this section. It is applicable only to 3.1, or versions without storage nodes. 3.1.2: The --list-versions and --storage-schema options have been added. 3.1.3 I would probably suggest rewriting this section based on the current content of the RHQ Wiki: https://docs.jboss.org/author/display/RHQ/Upgrading+RHQ - Note that the "RHQ 4.8 Upgrades (Only)" section is not relevant to JON. - Note that the "Pre RHQ 4.8 Upgrades (Only) section is relevant to JON 3.1 ------------- Unrelated minor issue 3.1.1: "minimal loss monitoring data" -> "minimal loss OF monitoring data" Unrelated minor issue 3.1.2: "new storage database node" -> "new Jboss ON Storage Node"
Thanks for the review comments here Jay. I've incorporated them all in Comment #7 and they are ready for review. See the thread on the internal mailing list for further internal details. This work is going out live Monday afternoon my time to meet the US GA date. Issues identified after this date will need to be addressed post GA in an urgent update.
based on comment #11 ... there is more work to be done by doc. so i am setting the BZ to ASSIGNED.
I found an issue in the Release Notes concerning the upgrade instructions. This document declares a sub-set of the full upgrade procedure. If followed, a customer would experience the failure originally identified and fixed in this issue. I am correcting the issue now.