Bug 793431 (JBEPP-515)

Summary: Docs: Installation Guide
Product: [JBoss] JBoss Enterprise Portal Platform 5 Reporter: Scott Mumford <smumford>
Component: unspecifiedAssignee: Scott Mumford <smumford>
Status: CLOSED NEXTRELEASE QA Contact:
Severity: high Docs Contact:
Priority: high    
Version: unspecifiedCC: epp-bugs, mposolda, prabhat.jha, smumford
Target Milestone: ---   
Target Release: 5.1.0.Docs.GA   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/JBEPP-515
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2010-12-13 04:25:31 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: 793548, 793486, 793572, 793573, 793595    
Bug Blocks: 793372    

Description Scott Mumford 2010-09-30 03:26:25 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
project_key: JBEPP

A tracker for issues relating to the EPP Installation Guide.

Please open separate JIRAs for new issues and link them to this tracker.

Comment 1 Scott Mumford 2010-09-30 03:27:44 UTC
Link: Added: This issue is a dependency of JBEPP-455


Comment 2 Scott Mumford 2010-11-01 04:16:29 UTC
No Release Note Required: JIRA pertains to documentation not product

Comment 3 Scott Mumford 2010-11-01 04:16:29 UTC
Release Notes Docs Status: Added: Not Required


Comment 4 Scott Mumford 2010-11-11 12:46:25 UTC
Link: Added: This issue depends JBEPP-569


Comment 5 Scott Mumford 2010-11-26 03:16:52 UTC
Link: Added: This issue depends JBEPP-673


Comment 6 mposolda 2010-11-26 15:19:12 UTC
Chapter 2.2 - Location should be $JBOSS_HOME/server/[configuration]/deploy/ gatein.ear/02portal.war/WEB-INF/web.xml instead of $JBOSS_HOME/server/[configuration]/gatein.ear/02portal.war/WEB-INF/web.xml 

Chapter 5.4.4 Setup Tomcat configuration - I think that this section should be removed in EPP installation guide, no sense to talk about Tomcat here. Only JBoss paragraph 5.3.4 should remain.

Comment 7 Andrew Ross 2010-12-01 02:17:36 UTC
4.4. Disabling Authentication
 - examples refer to HTTP GET and POST methods in web.xml

Comment 8 Scott Mumford 2010-12-01 06:06:44 UTC
Fixed. Thanks Andrew.

Comment 9 Prabhat Jha 2010-12-02 16:17:56 UTC
In Section 2.1, it currently has: "Unfortunately existing JBoss Enterprise Portal Platform 5.0 or 5.0.1 installations cannot be upgraded in order to deploy JBoss Enterprise Portal Platform 5.1.0"  Both EPP 5 and 5.0.1 can be upgraded to 5.1.0.

For SP installation guide, we need to mention that SP can not be installed with EPP 5.0 or EPP 5.0.1

Comment 10 Prabhat Jha 2010-12-02 19:26:12 UTC
The section "5.4.4. Setup Tomcat configuration to use your key" needs to be removed.

Comment 11 Prabhat Jha 2010-12-02 19:37:51 UTC
For mysql example, since there is example of DB create script for gateinjcr, there should be same for gateinidm.  This way gatein-ds.xml will be more consistent and complete.

Comment 12 Scott Mumford 2010-12-08 05:39:13 UTC
Prabhat,
The section 2.1 about not upgrading has been removed and the Tomcat section had already been removed.

Sorry, but I'm not sure what you mean in your last comment. Can you explain a little more?

Should the command <mysql> CREATE DATABASE gateinjcr;> in step two of the "Creating a MySQL Database" procedure be repeated as <mysql> CREATE DATABASE gateinidm;>

That way the line "Do the same with gateinidm." would be replaced with an example of the step.

Is there more to it that should be documented? Should the whole procedure be repeated, and if so, what needs to be different?


Comment 13 Prabhat Jha 2010-12-08 05:52:43 UTC
Nope..that should be enough. Usually I like it when an example is complete so instead of "do the same with blah", it's better to say "do this". It's about same amount of work for you anyway. ;-)

Comment 14 Scott Mumford 2010-12-09 03:37:46 UTC
Done. Thanks Prabhat.

Comment 15 mposolda 2010-12-09 13:24:12 UTC
- Just noticed that warning about disable POST method in login servlet before going to production is duplicated. Same thing is mentioned in section "2.3. Recommended Practices" and in section "4.4. Disabling Authentication" in the final paragraph "Disabling Pre-configured Accounts".

- Site publisher add-on is mentioned in both section "2.1. Upgrading and Add-ons" and in "Chapter 6. Installing Add-ons". I think it may be good to add all these informations into one section? Or at least add some link from section 2.1 into chapter 6 .

- There is still note "MORE INFO NEEDED HERE ON HOW TO DO THIS." in section "2.1. Upgrading and Add-ons". I believe that this is known issue so I am only reminding it :-)

Comment 16 Scott Mumford 2010-12-13 04:25:10 UTC
Marek;

The duplicated sections (Disabling the POST method the and mentions of Site Publisher) are ok to stay as they are. They're in context in those places.
Thanks for the shout about it though.

And the "MORE INFO NEEDED" para in sect 2.1 has been replace by some info.

Thanks.

Comment 17 Scott Mumford 2010-12-13 04:25:31 UTC
Closing this JIRA as EPP core docs development is stopping for the 5.1.0 release.
For minor issues, please open a JIRA against EPP 5.1.1.
Only re-open this JIRA for blocker or critical issues.