1 Reply Latest reply on Oct 20, 2006 4:10 PM by marklittle

    Updates Needed for the Getting Started Guide

    flindet

      Hi,

      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!