Bug 793190 (JBEPP-274)

Summary: Installation Guide
Product: [JBoss] JBoss Enterprise Portal Platform 5 Reporter: Scott Mumford <smumford>
Component: DocumentationAssignee: Scott Mumford <smumford>
Status: CLOSED NEXTRELEASE QA Contact: ecs-bugs
Severity: high Docs Contact:
Priority: high    
Version: 5.0.0.GACC: epp-bugs
Target Milestone: ---   
Target Release: 5.0.0.GA   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/JBEPP-274
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2012-02-16 02:53:52 UTC Type: Task
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Bug Depends On: 793208, 793209, 793210    
Bug Blocks: 793081    
Attachments:
Description Flags
EPP5_Installation_Guide_QE_notes.txt
none
epp_refguide_notes.txt none

Description Scott Mumford 2010-03-30 04:05:49 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Complexity: Low
Date of First Response: 2010-03-30 02:46:35
project_key: JBEPP

Add Installation Guide to doc suite.

No firm source for content at the moment. Need further info.

Comment 1 Thomas Heute 2010-03-30 06:46:35 UTC
I created the base structure for the installation guide at http://svn.jboss.org/repos/gatein/portal/branches/EPP_5_0_0_Branch_Docs/Enterprise_Portal_Platform_Installation_Guide

Comment 3 Scott Mumford 2010-04-08 02:51:13 UTC
QE for this book currently scheduled with Andrew Ross for Friday 30th April.

To allow for final edits, all feedback is required BEFORE Thursday 29th;


Comment 4 Scott Mumford 2010-04-20 23:52:21 UTC
Subtasks of the above JBEPP-288.:

Initial read through of install guide:
   https://jira.jboss.org/jira/browse/JBEPP-293

Possible modifications to install guide:
   https://jira.jboss.org/jira/browse/JBEPP-294

Server setup and test results:
   https://jira.jboss.org/jira/browse/JBEPP-295

Some questions are still outstanding in these JIRAs.
Unfortunately, without further technical feedback, ECS will be forced to take a 'best guess' approach to finalise the document before QE on 29th April.


Comment 5 Scott Mumford 2010-04-20 23:54:20 UTC
Link: Added: This issue depends JBEPP-293


Comment 6 Scott Mumford 2010-04-20 23:55:14 UTC
Link: Added: This issue depends JBEPP-294


Comment 7 Scott Mumford 2010-04-20 23:55:37 UTC
Link: Added: This issue depends JBEPP-295


Comment 8 Luc Texier 2010-04-23 15:13:48 UTC
I just finished my first round of review

to be fully completed next Monday

Comment 9 Luc Texier 2010-04-28 07:51:25 UTC
Scott, I am done with my review. Back to you.

Comment 10 Scott Mumford 2010-04-28 22:19:03 UTC
Roger that Luc. Thanks for your efforts. Much appreciated.

Comment 11 Scott Mumford 2010-05-04 07:53:41 UTC
Actioned recommendations made in QE Test Summary Report:

https://riddler.bne.redhat.com/Docs_Review/EPP_5-0/Test_Summary_Reports/Installation_Guide/tmp/en-US/html-single/index.html

* Switched references to RHEL to RHEL entity
* Moved ""Applications that run on a 32-bit JVM and do not require more than minimal heap sizes..." para into a note. (section 2.1.3 Getting_Started.xml) 
* Updated reference to CSP holding 'archives' of EPP versions (section 3.1 Installation.xml)
* Removed "Authentication is disabled by default..." (section 4.4 Post_Installation.xml)
* Removed link to download MySQL from external source, recommended RHN instead. (section 5.1.4 DatabaseConfiguration.xml)
* Removed instances of unnecessary <remark> tags

NOTE: Outstanding queries are marked with DOC TODO title.

Comment 13 Scott Mumford 2010-05-07 05:48:30 UTC
All outstanding issues resolved or noted for next release. Released to Brno QE.

Comment 14 Tomas Kyjovsky 2010-05-17 16:47:10 UTC
I finished my review of the doc - no serious issues. I summarized my comments in the attached file.

Comment 15 Tomas Kyjovsky 2010-05-17 16:47:10 UTC
Attachment: Added: EPP5_Installation_Guide_QE_notes.txt


Comment 16 Scott Mumford 2010-05-18 09:27:09 UTC
Thank you, Tomas. I've made the recommended changes (svn revision 3110).

Comment 17 Scott Mumford 2010-05-18 09:30:17 UTC
This document is ready for release. Please contact me directly if there is a need to revise it prior to release.

Comment 18 Viliam Rockai 2010-05-18 13:38:26 UTC
Attachment: Added: epp_refguide_notes.txt


Comment 19 Scott Mumford 2010-05-18 22:56:47 UTC
Minor revision to MySQL D'Base instructions as per Prabhat's comment on JBEPP-276 11/May/10:
https://jira.jboss.org/browse/JBEPP-276?focusedCommentId=12530216&page=com.atlassian.jira.plugin.system.issuetabpanels%3Acomment-tabpanel#action_12530216