Bug 779093 (SOA-1492) - A few updates for the Getting started doc.
Summary: A few updates for the Getting started doc.
Keywords:
Status: CLOSED WONTFIX
Alias: SOA-1492
Product: JBoss Enterprise SOA Platform 4
Classification: JBoss
Component: Documentation
Version: 4.3 CP01
Hardware: Unspecified
OS: Unspecified
medium
medium
Target Milestone: ---
: FUTURE
Assignee: David Le Sage
QA Contact:
URL: http://jira.jboss.org/jira/browse/SOA...
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2009-09-15 09:44 UTC by nwallace
Modified: 2011-03-29 23:45 UTC (History)
0 users

Fixed In Version:
Doc Type: Bug Fix
Doc Text:
Clone Of:
Environment:
Last Closed: 2011-03-29 23:45:52 UTC
Type: Bug


Attachments (Terms of Use)


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

Description nwallace 2009-09-15 09:44:09 UTC
Affects: Documentation (Ref Guide, User Guide, etc.)
Complexity: Low
project_key: SOA

Having a go at being a user, I've noticed a couple of points that could do with being added to the Getting Started Guide.

Under the Quickstarts section 3.1 point 1, this should be added just after the first sentance.

"If this is your first deployment, edit the supplied file quickstarts.properties-example, leave the AS details commented out for the moment but remove the comments from the jbpm username and password and save the file as quickstarts.properties. (Remember this is just for testing!)"

Quickstarts section 3.1 point 6. is wrong. None of the quickstart messages will appear on the console screen as by default (production) messages to the screen are turned off. They are in the server log though so perhaps it should read something like...

6. You should now see a "Hello World" message appear in your application server's log, jboss-as/server/production/log/server.log. By default (production) messages that are normally sent to the console screen turned off so all the quickstart messages can only be found in the log.

Add a note just after the "That's it! The Quickstart ran successfully. Your environment is properly configured." line to say...

"Make certain that you undeploy a quickstart when finished with it as failure to do so will lead to future failures."

Comment 1 nwallace 2009-09-15 10:04:02 UTC
Just found a typo too.

Section 2.2, paragraph after item 3, towards the end 

The server should now by accessible at: http://localhost:8080.

"by" should be "be"


Comment 2 nwallace 2009-09-15 10:13:44 UTC
Torn as where to put this one but I'll put it here for the mo.

ant help-quickstarts points the user to section 2.2 of the Getting_Started_Guide.pdf for info relating to jndi settings. There's no info!


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