Bug 779027 (SOA-1439)

Summary:	Admin Guide: improve database configuration instructions
Product:	[JBoss] JBoss Enterprise SOA Platform 4	Reporter:	Dana Mison <dmison>
Component:	Documentation, Compatibility	Assignee:	David Le Sage <dlesage>
Status:	CLOSED NEXTRELEASE	QA Contact:
Severity:	high	Docs Contact:
Priority:	high
Version:	4.2 CP04, 4.3 CP02
Target Milestone:	---
Target Release:	4.3 CP05
Hardware:	Unspecified
OS:	Unspecified
URL:	http://jira.jboss.org/jira/browse/SOA-1439
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2011-05-03 19:08:41 UTC	Type:	Feature Request
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:

Description Dana Mison 2009-08-14 04:06:17 UTC

Affects: Documentation (Ref Guide, User Guide, etc.)
Complexity: Low
project_key: SOA

The database configuration sections (1.4. Database Configuration, 1.5. Switching Databases) should be combined into a single chapter. 

It should discuss :
 - what components/services make use of the database
 - database requirements, refer to certified/compatible configuration info
 - info about Hypersonic & its limitations
 - about & how to use the schema tool, and its limitations
 - how to manually perform the configuration for situations where the schema tool will not suffice.

Comment 1 Dana Mison 2011-02-24 23:51:40 UTC

I think it is best to leave the ESB Admin Guide as close as possible to the upstream.  I can add a section to the beginning of the database chapter here that mentions that configuration for the ESB is done with the schema tool and refer users to the install/config steps in the GSG.  I will bring over a lot of the improvements to the GSG from 5.1.0 with this task.

Comment 2 Dana Mison 2011-02-25 01:22:01 UTC

Complexity: Removed: Medium Added: Low

Comment 3 David Le Sage 2011-04-05 23:15:15 UTC

Getting Started Guide backported from 5.1.

Comment 4 David Le Sage 2011-04-05 23:15:15 UTC

Release Notes Docs Status: Added: Not Required

Comment 5 David Le Sage 2011-04-07 23:09:58 UTC

Writer: Added: dlesage

Comment 6 Jiri Pechanec 2011-04-21 12:40:01 UTC

Database schema tool is described in Getting Started Guide - http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/4.3/html/Getting_Started_Guide/chap-setup.html#sect-changing_database

It should be removed from Admin Guide in the same way as is for SOA-P 5.1

Comment 7 David Le Sage 2011-05-03 02:54:16 UTC

I have backported the relevant sections from the 5.1 ESB Admin Guide.

Comment 8 Len DiMaggio 2011-05-03 19:08:41 UTC

Verified the document changes here:

http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/4.3/html/Administration_Guide/index.html