Bug 1038765

Summary:	Upgrade instructions are incorrect
Product:	[JBoss] JBoss Enterprise Application Platform 6	Reporter:	dereed
Component:	Documentation	Assignee:	Tom WELLS <twells>
Status:	CLOSED CURRENTRELEASE	QA Contact:	Russell Dickenson <rdickens>
Severity:	high	Docs Contact:
Priority:	unspecified
Version:	6.2.0	CC:	jmartisk, lcarlon, lcosti, smumford, wfink
Target Milestone:	GA	Keywords:	Documentation
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:	Build Name: 14873, Installation Guide-6.2-1 Build Date: 07-11-2013 09:21:49 Topic ID: 12710-550313 [Specified]
Last Closed:	2013-12-15 17:02:18 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:

Description dereed 2013-12-05 18:57:58 UTC

Title: Upgrade the JBoss EAP 6 ZIP Installation

Describe the issue:
Step 3 of the upgrade instructions were altered in 6.2 to say that configuration files should be manually merged, and previous files should not be used (https://bugzilla.redhat.com/show_bug.cgi?id=983951).

This is not correct.  Copying the configuration from an older 6.x release *is* a supported and recommended way of updating.

Suggestions for improvement:

The docs should be reverted to the previous version of this step that says to copy the configuration directories.

Additional information:

Comment 1 Scott Mumford 2013-12-05 23:50:38 UTC

The step in question has been rolled back to before the erroneous changes were made.

Moving this bug to MODIFIED pending a rebuild to Stage for verification.

Comment 2 Scott Mumford 2013-12-06 01:19:49 UTC

The updated book has been pushed to stage and is available for review here:

http://documentation-devel.engineering.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/6.2/html/Installation_Guide/sect-Upgrade_Instructions.html#Upgrade_the_JBoss_Enterprise_Application_Platform_6_ZIP_Installation

(direct link to section)

Moving to ON_QA for verification. Once verified the updated content will be pushed to the live site for customer consumption.

Comment 3 wfink 2013-12-06 07:14:12 UTC

Maybe we should add a note that, with this appoach, new features are not automaticaly activated (i.e. new subsystems) as you will have exact the former configuration.
And it is necessary to compare the provided, original configuration files or documentation. This might only be a case if they want to use it in the future.

Comment 4 Jan Martiska 2013-12-06 07:48:34 UTC

Agree with Wolf's suggestion, sending back to ASSIGNED, add these two little notes please.

Comment 5 Lucas Costi 2013-12-09 03:15:16 UTC

The following note has been added to step 3:

"New features in the new release, such as new subsystems, may not be activated if configuration files are copied from an older JBoss EAP 6 installation. To use these new features, it is necessary to compare and update the old configuration files with the ones from the new version."

Topic 12710 updated to revision 567287.

The changes will be reflected in the next document build, and the status will be changed to ON_QA when it is ready for review.

Comment 6 Lucas Costi 2013-12-10 22:41:21 UTC

Change on-stage and ready for review (revision 2.0-22):

http://documentation-devel.engineering.redhat.com/docs/en-US/JBoss_Enterprise_Application_Platform/6.2/html/Installation_Guide/sect-Upgrade_Instructions.html#Upgrade_the_JBoss_Enterprise_Application_Platform_6_ZIP_Installation

Comment 7 Jan Martiska 2013-12-11 09:01:57 UTC

Looks OK to me. If anyone has objections, raise them ASAP ;)