Bug 779674 (SOA-2039) - Clean up instructions on how to change the database
Summary: Clean up instructions on how to change the database
Keywords:
Status: CLOSED NEXTRELEASE
Alias: SOA-2039
Product: JBoss Enterprise SOA Platform 5
Classification: JBoss
Component: Documentation
Version: 5.0.0 GA
Hardware: Unspecified
OS: Unspecified
high
high
Target Milestone: ---
: 5.0.2
Assignee: David Le Sage
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2010-04-14 09:47 UTC by Martin Weiler
Modified: 2010-06-17 00:36 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2010-06-17 00:36:26 UTC
Type: Task


Attachments (Terms of Use)


Links
System ID Private Priority Status Summary Last Updated
Red Hat Issue Tracker SOA-2039 0 None None None Never

Description Martin Weiler 2010-04-14 09:47:06 UTC
Date of First Response: 2010-06-09 20:59:27
Help Desk Ticket Reference: https://enterprise.redhat.com/issue-tracker/750653
project_key: SOA

The SOA-P 5.0.0 Administration Guide contains two chapters with instructions on how to change the database:

1- Chapter 1.4.9.  Database Configuration 
http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/5.0.0/html/Administration_Guide/configuration.html#database_configuration

2- Chapter 1.4.10.  Switching Databases 
http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/5.0.0/html/Administration_Guide/configuration.html#Switching_Databases

#2 contains manual instructions and can thus be removed completely, as we recommend using the ant schema tool.
#1 highlights the ant schema tool, but has some confusing XML snippets in between which should be removed for clarity.

The SOA-P 4.3 CP02 docs are much clearer in this respect:
http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/4.3.CP02/html/Administration_Guide/database_configuration.html

Comment 1 Dana Mison 2010-06-10 00:59:27 UTC
Section 1.4.9.  Database Configuration in the version 5 docs need to be replaced with the content from the 4.3.CP04 doc at http://www.redhat.com/docs/en-US/JBoss_SOA_Platform/4.3.CP04/html/Administration_Guide/database_configuration.html

Section 1.4.9 should also mention the prerequisites of 1 - having ant installed, 2 - the database you wish to use must already exist and have a user configured for it (these are details you will need).  If any isn't installed there are some directions in the getting started guide

Section  1.4.10 Switching Databases needs to be a subsection at the end of 1.4.9 (ie 1.4.9.1) and the beginning needs to be reworded to indicate that this is an illustration only of the process that the schema tool does, it is included only for reference.  Doing a manual configuration may prevent the schema tool from being able to function if you need to use it.  You should contact support for assistance if doing a custom configuration.  

Comment 2 David Le Sage 2010-06-11 00:58:52 UTC
Done.  Section 1.4.9 updated and Section 1.4.10 now moved to 1.4.9.1

Comment 5 David Le Sage 2010-06-16 23:56:47 UTC
Hello Len,

Yes it is:

http://documentation-stage.bne.redhat.com/docs/en-US/JBoss_Enterprise_SOA_Platform/5/html-single/ESB_Administration_Guide/#Switching_Databases

Seems to be labeled 1.7 and 1.7.1 in that online version.

Comment 6 Len DiMaggio 2010-06-17 00:36:26 UTC
Verified in the on-line docs


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