Updates Needed for the Getting Started Guide
flindet Oct 20, 2006 12:36 PMHi,
I thought about posting this as a JIRA entry, but I wasn't sure this was appropriate. If you'd rather see this and similar posts as JIRA entries, let me know.
The Getting Started guide for JBossESB 4.0 Beta 1 Maintenance Pack 1 has areas regarding directory structure and file placement that seem to be out of date. These lead to some confusion, and so I'm hoping they can be addressed.
In "Configuring the JBossESB Environment" reference is made to C:\jboss-esb\product\config. However, this directory does not exist. This is where "deployment.properties" should exist, but as far as I could tell, "deployment.properties" does not exist. Instead, I found "deployment.properties-example" in C:\jboss-esb\product\install. I made a copy of that, renaming it to "deployment.properties" and leaving it in C:\jboss-esb\product\install. However, from the Getting Started guide alone, I cannot determine if my action was correct. Please update this portion of the document with the current directory and clearer instructions regarding the creation of "deployment.properties".
After configuring "deployment.properties", we are told to go to C:\jboss-esb\product\config, which doesn't exist, and run "ant configure.jboss". I was unable to locate the "configure.jboss" target. As an example, here are the targets from C:\jboss-esb\product\
flindet@HQHDC-7Y2GF61 ~/Eclipse/workspace/JBossESB4.0Beta1MP1/product $ ant -projecthelp Buildfile: build.xml Main targets: Other targets: clean compile deploy deploy-instr dist earinstr install instr-report jar javadoc org.jboss.esb.clean org.jboss.esb.compile org.jboss.esb.core.compile org.jboss.esb.core.jar org.jboss.esb.internal.init org.jboss.esb.jar org.jboss.esb.javadocs org.jboss.esb.purge org.jboss.esb.samples.javadocs org.jboss.esb.test purge test Default target: test flindet@HQHDC-7Y2GF61 ~/Eclipse/workspace/JBossESB4.0Beta1MP1/product $
In "A Simple Standalone Test Example" references are made to the samples in <ESB_HOME>/docs/samples/TestJBossESB. However, this directory is no longer valid. The proper directory seems to be <ESB_HOME>/product/samples/TestJBossESB. The supporting sample directorys such as inputDir and outputOkDir suffer from the same problem.
In this same section reference is made to C:\jboss-esb\product\docs\Install\database. However, the correct directory seems to be C:\jboss-esb\product\install\database.
Hopefully, these reminders for the Getting Started guide will help. Thanks for the examples. They really help!