Bug 793702 (JBEPP-777)

Summary: Docs: Site publisher documentation indicates that gatein-eppspdemo-portal-2.1.2-GA.ear is not needed
Product: [JBoss] JBoss Enterprise Portal Platform 5 Reporter: Matt Davis <mattd>
Component: DocumentationAssignee: Scott Mumford <smumford>
Status: CLOSED NEXTRELEASE QA Contact: ecs-bugs
Severity: high Docs Contact:
Priority: high    
Version: 5.1.0.Docs.GACC: epp-bugs, joao.viragine, smumford, theute
Target Milestone: ---   
Target Release: 5.2.0.Docs.GA   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/JBEPP-777
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-09-19 05:06:44 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:
Bug Depends On:    
Bug Blocks: 793731    

Description Matt Davis 2011-01-26 19:25:49 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Help Desk Ticket Reference: https://c.na7.visual.force.com/apex/Case_View?id=500A0000005g9yu&sfdc.override=1
project_key: JBEPP

Section 2.3 of the Installation Guide  - http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.1/html-single/Site_Publisher_Installation_Guide/index.html#sect-Installation_Guide-Installation-Installation_Instructions - indicates that you can install Site Publisher with or without gatein-eppspdemo-portal-2.1.2-GA.ear.  The steps are given to access the Site Publisher page if the demo application is installed.  It directs you to the documentation if you did not install the demo app; the instructions generically refer you to the "documentation".

Chapter 3 of the Site Publisher User guide - http://docs.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.1/html-single/Site_Publisher_User_Guide/index.html#chap-User_Guide-Get_Started - Gives instructions on registering a new account for Site Publisher, but the images are from the ecmdemo application.

It does not appear that you can access Site Publisher without installing gatein-eppspdemo-portal-2.1.2-GA.ear.  Either the Site Publisher Installation Guide needs to be changed to require users to install the demo application, or the Site Publisher User Guide needs to include instructions on getting started with Site Publisher when the demo application is not installed.  In the 2nd case, the Site Publisher Installation Guide should also be updated to point to the specific documentation location.

Comment 1 Scott Mumford 2011-02-15 05:18:58 UTC
Link: Added: This issue is a dependency of JBEPP-802


Comment 2 Scott Mumford 2011-02-15 05:18:58 UTC
Link: Added: This issue is a dependency of JBEPP-803


Comment 3 Scott Mumford 2011-02-15 07:36:06 UTC
Release Notes Docs Status: Added: Not Required


Comment 4 Thomas Heute 2011-03-24 09:16:56 UTC
The demo isn't required. It's just here to start faster and to demo.

Comment 5 Scott Mumford 2011-03-24 23:45:49 UTC
Reopening JIRA as issue is not resolved.

This is not a problem with the technical mechanics of the demo portal, but that the documentation does not clearly outline the options and processes available to and/or required by end users if they choose not to deploy the demo.

More information is required in the documentation in order to resolve this issue.

Comment 6 Thomas Heute 2011-03-25 16:12:05 UTC
My bad, sorry :/

Comment 7 Scott Mumford 2011-08-15 04:39:28 UTC
Link: Removed: This issue is a dependency of JBEPP-803 


Comment 8 Scott Mumford 2011-09-13 05:10:36 UTC
Some questions about using the SP extension without the ecmdemo site deployed:
Accessing as root, page still shows the "Published/Edit" and the instructions in the SP User Guide section "4.3.1. Create a new site" seem to work.

However, there no quick-edit icons appear over portlets when in edit mode (as stated in SP User Guide "4.4. Contribute Content"). 

Is this because the contents on the ecmdemo pages are SCV/CLV and the standard EPP pages are not? If so, what is the difference between SCV/CLV type content and the content on standard EPP pages? Can standard content be converted to SCV/CLV? How?

Would an admin need to copy and edit the ecmdemo ear and deploy that to get the full SP functionality?

Comment 9 Scott Mumford 2011-09-13 05:19:19 UTC
If some of the files from the demo site need to be duplicated and deployed, which ones would they be?

Comment 10 Scott Mumford 2011-09-13 05:23:21 UTC
As an example of something that seems to be missing without the ecmdemo deployed;
How does a user in this circumstance access Group → Content Explorer on the administrator bar?

Comment 11 Scott Mumford 2011-09-19 05:06:44 UTC
The optional nature of the ecmdemo has been removed from the documentation. This will alleviate any confusion about how to use Site Publisher without it, as most of the existing documentation assumes it is deployed.

The new content is available for review at:
http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_Portal_Platform/5.2/html/Site_Publisher_Installation_Guide/sect-Installation_Guide-Installation-Installation_Instructions.html