Bug 1158247

Summary:	[docs] --run-data-migrator options change in Installation Guide
Product:	[JBoss] JBoss Operations Network	Reporter:	Jared MORGAN <jmorgan>
Component:	Documentation	Assignee:	Jared MORGAN <jmorgan>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Mike Foley <mfoley>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	JON 3.3.0	CC:	ahovsepy, fbrychta, jmorgan, loleary, mfoley, mmurray, myarboro, snegrea
Target Milestone:	GA
Target Release:	JON 3.3.1
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:	1082805	Environment:	[Install_Guide] Turned out to be minor fixes after the 3.3.0 Install issues were rolled-in. Minor changes only.
Last Closed:	2015-03-03 09:55:51 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:
Bug Depends On:	1082805
Bug Blocks:

Comment 1 Jared MORGAN 2014-10-28 23:37:55 UTC

> After a discussion with Larry, the initial feature will not be fixed as is.
> I tried a couple of permutations to fix the original code but all of them
> were clunky for the user and made the code brittle.
> 
> 
> Here is the plan that was agreed with Larry:
> 
> 1) Remove all the options form the --run-data-migration argument. The only
> possible way to use that argument is to do the migration right away. For a
> fine control over the migration process, users should use the actual
> data-migration tool.
> 
> 2) Update the documentation with the new behaviour of the upgrade arguments
> 
> 3) Clarify the documentation about the effects of the data migration.
> Currently it is wrong about losing all the data from C* if run at a later
> time.

So I need to remove the suggestions that the migration can be re-run later from both spots in the Installation Guide below. And specifically delete the info about monitoring data being lost.

[Upgrading the JBoss ON Server and Components(https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.2/html/Installation_Guide/managing-servers.html#upgrade-proc)
    It is possible to migrate the historical monitoring data by running the upgrade with the --run-data-migrator later. However, any new monitoring data collected between the server upgrade and the data migration will be lost. 
    
[The rhqctl Control Script](https://access.redhat.com/site/documentation/en-US/Red_Hat_JBoss_Operations_Network/3.2/html/Admin_and_Config/control-scripts.html)
    Upgrades all JBoss ON services. This can be rerun to migrate historical metric data after a server migration.

These are small changes. However due to the work remaining for BZ release notes, I'm going to have to push this to JON Async and do this along with the other tasks.

Comment 3 Jared MORGAN 2015-02-17 21:24:22 UTC

This fix is now live in the docs.

Comment 4 Filip Brychta 2015-02-26 14:40:51 UTC

What was actually changed? Should the fix be visible in doc for JON 3.2 as well?

Comment 5 Jared MORGAN 2015-02-27 00:49:29 UTC

(In reply to Filip Brychta from comment #4)
> What was actually changed? Should the fix be visible in doc for JON 3.2 as
> well?

It turned out to be minor grammar changes after the rushed update to 3.3.0 upgrade procedures on GA day. 

This should only be visible in the 3.3 docs set.