Bug 792945 (JBEPP-23) - extend EAP installation guide to include portal installation
Summary: extend EAP installation guide to include portal installation
Keywords:
Status: CLOSED NEXTRELEASE
Alias: JBEPP-23
Product: JBoss Enterprise Portal Platform 4
Classification: JBoss
Component: docs-Portlet_Bridge_Overview
Version: 4.3.0.GA
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: 4.3.0.GA
Assignee: Scott Mumford
QA Contact: ecs-bugs
URL: http://jira.jboss.org/jira/browse/JBE...
Whiteboard:
Depends On: JBEPP-3
Blocks:
TreeView+ depends on / blocked
 
Reported: 2008-11-19 17:05 UTC by Prabhat Jha
Modified: 2012-02-16 22:41 UTC (History)
1 user (show)

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2012-02-16 03:44:31 UTC
Type: Task


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker JBEPP-23 0 None Closed extend EAP installation guide to include portal installation 2012-02-16 23:13:58 UTC

Description Prabhat Jha 2008-11-19 17:05:35 UTC
Date of First Response: 2008-11-26 19:29:11
project_key: JBEPP

I believe this should not be as extensive as reference guide in terms of effort. :-)

We only need to add portal database configuration stuff to EAP installation guide. Difference will be instead of EAP bundle, it will be EPP bundle which will have portal already in it. 

I see that there is another document https://svn.jboss.org/repos/jbossas/projects/docs/enterprise/4.3.4/Portal_EAP which has database configuration part. So seems like it's just a matter of merging them.

Comment 1 Prabhat Jha 2008-11-19 17:06:00 UTC
Link: Added: This issue depends JBEPP-3


Comment 2 Joshua Wulf 2008-11-27 00:29:11 UTC
Which version of the EAP installation guide should this be based on?


Comment 3 Prabhat Jha 2008-11-27 01:13:45 UTC
It will be based on EAP 4.3_CP03 release.

Comment 4 Prabhat Jha 2008-12-01 04:14:13 UTC
Scott,

For this release of EPP, we need to strip down few things from EAP installation guide and add some new stuff. Here are the details:

1. There is no graphical installer for EPP. So  Installation using the graphical installer part from EAP guide needs to go away.
2. RHN part also needs to go away. (Basically there should be only zip download)
3. Add database part.

My suggestion is based on what I see at http://www.redhat.com/docs/manuals/jboss/jboss-eap-4.2.0.cp01/doc/Installation_Guide/index.html. I hope not much has changed in EAP 4.3 CP03.



Comment 5 Scott Radvan 2008-12-03 02:11:17 UTC
>  3. Add database part. 

What content relating to database setup is needed?

Comment 6 Prabhat Jha 2008-12-03 03:21:29 UTC
If you checkout https://svn.jboss.org/repos/jbossas/projects/docs/enterprise/4.3.4/Portal_EAP  and build it, you will see that the resulting doc has database configuration for different databases. Please let me know if you have trouble building this doc.

Comment 7 Scott Radvan 2008-12-03 05:19:36 UTC
New revision has been uploaded to svn - https://svn.jboss.org/repos/portal/docs/enterprise/trunk/Installation_Guide/ - comments appreciated.

Comment 8 Prabhat Jha 2008-12-03 15:28:46 UTC
Ok, the format looks good. I will make some changes to content. It will be simple stuff like version and some more portal related stuff.

Comment 9 Prabhat Jha 2008-12-04 01:44:22 UTC
I made some changes. Please synch up your code with repository and see how everything looks. 

On another note, can you add DB descriptor parts for other databases? I think they were present in old installation guide that I pointed on my previous comment.

Comment 10 Scott Radvan 2008-12-04 02:04:06 UTC
Looks fine to me. Regarding 2.1.2 "Installing and Configuring 32-bit Sun JDK 5.0 on a generic Linux platform" - I've been asked to check if this configuration is supported? And further to that, are other databases?

Comment 11 Prabhat Jha 2008-12-04 02:33:41 UTC
For section 2.1.2, if that's what it says for EAP then it's true for EPP as well. 

I did not understand what you mean by "And further to that, are other databases?". What I meant is similar instruction for Oracle, Mssql, Postgresql to what you have for MySQL.

Comment 12 Scott Radvan 2008-12-04 02:41:53 UTC
OK that's fine regarding 2.1.2.

My other question was if these other databases (besides MySQL) are supported. If they are in a previous guide I will track them down, but was just making sure.

Comment 13 Prabhat Jha 2008-12-04 03:15:51 UTC
Yes, following DBs are supported;

1. MySQL 4 & MySQL5
2. Oracle 9i, Oracle 10g
3. PostgreSQL
4. MSSQL
5. Hypersonic 

Sybase and DB2 are not officially supported.

Comment 14 Joshua Wulf 2008-12-04 03:50:37 UTC
Prabhat,
 
Here are a few other things I've noticed in this version:

1.1 Feedback

The JIRA information should be for JBEPP project and component "Documentation". Version is unset (currently says "<version>") **Should be 4.3.0.GA**

Chapter 2  

2.1.1 FYI: The supported configurations page linked to has up to date information for JBEAP, but no mention of JBEPP.

2.2 FYI: The components version page linked to has information about the level of the JBEAP that is included in JBEPP, but does not include the JBEPP component.

Chapter 3

3.2 Installing. 

This section currently has inconsistent references to file names - some references are jboss-eap, one is jboss-epp

Chapter 4

4.1 Should the directory name change from EnterprisePlatform to something like EnterprisePortalPlatform?



Comment 15 Prabhat Jha 2008-12-04 04:02:17 UTC
I am glad you are paying attention to details. Please go ahead with your changes. Once doc is tagged for GA release, we will update the version. Goal at this stage is to have everything else ready so that the only thing that's left is version number changes. 


3.2. jboss-eap reference should be changed to jboss-epp.
4.1 Please go ahead.

I will take a look at the rest.


Comment 16 Scott Radvan 2008-12-04 04:32:35 UTC
3.2. jboss-eap reference changed to jboss-epp.
4.1 directory name change from EnterprisePlatform to EnterprisePortalPlatform

These changes have been made and uploaded.

Comment 17 Scott Radvan 2008-12-04 22:09:39 UTC
Prabhat,

I can not find the documentation for the descriptors for Oracle, Postgres, MSSQL etc. - it doesn't seem to be in the guide you previously linked..

Can you please direct me to where it is so I can import it into this guide?



Comment 18 Prabhat Jha 2008-12-05 20:56:26 UTC
Some of what Josh pointed out earlier have been fixed. 

Scott, for other databases, please mention that sample descriptors can be found at jboss-epp-4.3/setup when jboss-epp-4.3.zip is exploded.

Comment 19 Prabhat Jha 2008-12-08 16:38:47 UTC
I am going to mark this as resolved for now. If there is any minor modifications, we should be able to do it. We will let you know otherwise.

Comment 20 Scott Radvan 2012-02-16 22:41:15 UTC
Changing to default assignee for component.


Note You need to log in before you can comment on or make changes to this bug.