Bug 779093 (SOA-1492)

Summary: A few updates for the Getting started doc.
Product: [JBoss] JBoss Enterprise SOA Platform 4 Reporter: nwallace <nwallace>
Component: DocumentationAssignee: David Le Sage <dlesage>
Status: CLOSED WONTFIX QA Contact:
Severity: medium Docs Contact:
Priority: medium    
Version: 4.3 CP01   
Target Milestone: ---   
Target Release: FUTURE   
Hardware: Unspecified   
OS: Unspecified   
URL: http://jira.jboss.org/jira/browse/SOA-1492
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2011-03-29 23:45:52 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:

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!