Yes, this is a prolem in the docs.
The install.txt tells you to put the jars in the $TOMCAT_HOME/lib and
then when you run the war-webmacro ant job, it puts all the jars in the
war-webmacro/lib directory. They should only be in the latter place,
thus the war-webmacro document should tell you to remove the jars from
the $TOMCAT_HOME/lib after you run the ant job....
Also the other path problem you mentioned needs to be fixed in the
docs...
I'll fix these things tomorrow.
-Nissim
"tb.dinesh" wrote:
>
> Hi Jon and others,
>
> I have been following Turbine and other activity
> for a while and we thought of trying to use it.
> -- I missed the sumit as I had to be out of town that day :(
> Certainly wish I could have made it.
>
> We have been trying to use WebMacro and Turbine.
> Let me say we are impressed with Turbine functionality,
> of what we have seen. Hoping we can manage to understand
> the intricacies.. eventually.
>
> Our current set up is Apache with jserv, with lots of
> servlets with html code in it! :) So time to move to
> webmacro or JSP. Webmacro certainly appears clean.
>
> We have configured Turbine with jserv, and then
> have run around a lot figuring out how to get webmacro
> to work as documented in turbine/docs.
>
> Firstly, the docs indicate: better use tomcat with webmacro.
> So we started with tomcat. Thought of switching the development
> efforts to tomcat. After a couple of days of trying to configure
> tomcat, turbine and webmacro as per documentation (and
> our intution) I thought of asking for help.
>
> Here I am also writing all the typos (or points for doc upgrades).
>
> 1. there seem to be some documentation by Jon.
> The docs are mostly for jserv. Jon even claimed
> he only assits in development of tomcat. But does
> not use it. However, there is what looks like a nice
> facility in Turbine to generate a structure that can
> be useful for using Turbine and webmacro with Tomcat
> turbine-war-webmacro/ directory
> [probably due to updating of certain tomcat features
> this has not been usable, see below]
>
> 2. other documentation by others.
> The docs appear to indicate that tomcat is the way
> of the future and just start using it now, with webmacro.
> However, there are missing parts while reading the
> few docs pages on what to make of it, while trying
> the examples or pointers during installation.
> Jon says: try the example by typing:
> http://www.mycompany.com/servlets/Turbine/screen/HelloWorld
> which is valid only in jserv (using default settings)
> When I started following this but somehow by trial and error found
> that i had to use servlet not servlets while using tomcat.
> http://www.mycompany.com/servlet/Turbine/screen/HelloWorld
> reacts. However, the rest of the docs about using turbine-war-webmacro
> also have little inconsistencies that make it hard to understand
> how to get it all going.
>
> One of the big problems is that according to the docs, we end
> up creating two sets of Turbine instantiations.
> (one in tomcat/conf/TurbineResources.properties
> [we put this in ROOT/WEB-INF/conf -- and changed ROOt web.xml
> appropriately, see below]
> and
> another in
> turbine-war-webmacro/WEB-INF/conf/TurbineResources.properties
> )
> The two seem to get a tad confused with each other.
> If ever the tomcat/conf/TurbineResources.properties
> been seen by turbine, it will want to use the defaults in there,
> even if we are interested in :/turbine-war-webmacro/servlet/Turbine
> We have been able to progress with turbine-war-webmacro only if
> we never use the :/servlet/Turbine instantiation.
>
> Is this expected or is it expected that turbine picks up the
> TurbineResource.properties in the context and scopes it
> appropriately?
>
> 3. possibly the changing status of tomcat:
> the docs say use full path in web.xml
> but tomcat does not accept full path at all.
> only thing that makes sense to it is relative to WEB-INF
> [see below]
>
> 4. webmacro docs
> The docs are mostly for servletrunner.
> so not much help there for jserv or tomcat.
> we used the webmacro-jdk1.2-CVS.jar files in turbine.
> However, only accidentaly (once) have we been able
> to make webmacro read the appropriate
> WebMacroResources.properties file.
>
> According to tomcat, WEB-INF/classes is the place for classes
> and putting the WebMacroResources.properties here should
> make webmacro see that file. (ie., in the classpath).
> According to webmacro, the best place for it is where
> the webmacro jar file is... which is WEB-INF/lib/ (created by
> turbine). According to docs of turbine.. this file should be in
> WEB-INF/conf (however, it is created in /classes). When the
> webmacro properties is in the lib/ dir, I think the file was noticed
> as the webmacro logs were updated.
> But Turbine never seem to resolve [template, screen/error.wm]
>
> I hope that the above kind of indicate where our problems or confusion
> might be. If any one who uses tomcat and webmacro with turbine, and
> are willing to share some thoughts or even the various turbine properties
> and web macro properties files, and the config layout (of tomcat) that
> woul dbe great.
> As of now, we have not put much effort into getting webmacro to work
> with jserv and turbine (or even just jserv) as according to the docs,
> that is a harder route than the tomcat one (:servlet 2.2 requirements)
>
> thanks much for any help, also thanks all for the great dev activity..
> even though the docs appear not to be updated.. it certainly makes
> the whole this want to be tried.. so thanks for the effort on docs!
> Hope you dont mind my detailed remarks to the list.
>
> -dinesh
>
> The typos/inconsistencies in the documentation:
>
> from ../turbine/docs/install.txt
>
> ----------------------------------------------------------------------------
> ---
> INSTALLATION WITH TOMCAT
> ----------------------------------------------------------------------------
> ---
> The following instructions assume that you have followed the above
> instructions for either source compilation or release distribution. It
> also assumes that you have working Tomcat installation which can be
> found at http://jakarta.apache.org.
>
> TOMCAT_HOME=/path/to/tomcat
>
> #1. Put all necessary Turbine-related jars (Turbine, ECS, Village,
> JNDI) into $TOMCAT_HOME/lib.
>
> #2. Add the path to the jars to the existing Tomcat CLASSPATH found in
> $TOMCAT_HOME/bin/tomcat.sh
>
> #3. Make necessary adjustments to TurbineResources.properties and copy into
> $TOMCAT_HOME/conf
>
> #4. Add the following xml to $TOMCAT_HOME/conf/web.xml. It
> will be a child of the <web-app> element.
>
> <servlet>
> <servlet-name>Turbine</servlet-name>
> <servlet-class>Turbine</servlet-class>
> <init-param>
> <param-name>properties</param-name>
>
> <param-value>/path/to/$TOMCAT_HOME/conf/TurbineResources.properties</param-v
> alue>
> </init-param>
> </servlet>
>
> #5. Restart Tomcat
> -----------------
>
> Tomcat does not appear to understand either the full path to
> TurbineResources.properties
> or any relative paths to $TOMCAT_HOME/conf
> only /WEB-INF/.. style relative paths work. this makes it impossible to
> refer to a path such as tomcat/conf/TurbineResources.properties
> (which is where the file is and is supposed to be, according to the docs)
>
> Error: 503
>
> Location: /servlet/Turbine
>
> java.lang.Exception: Turbine::init(ServletConfig) - The Turbine Resources
> File -
> '/usr/local/tomcat/webapps/ROOT/usr/local/tomcat/conf/TurbineResources.prope
> rties' does not exist. Please create it or change the 'properties' Init
> Parameter
> Value to a file name that exists and contains the TurbineResources.
>
> ----------
>
> > . build-turbine.sh war-webmacro
>
> ...
>
> Please edit
> ../turbine-war-webmacro/WEB-INF/conf/TurbineResources.properties and
> ../turbine-war-webmacro/WEB-INF/conf/WebMacro.properties to specify the
> correct settings
> as defined in the ../docs/install.txt file. The TemplatePath= Webmacro
> setting will be the path to your WAR archive/WEB-INF/templates
>
> The file ../turbine-war-webmacro/WEB-INF/conf/WebMacro.properties does not
> exist
>
> The file is in ../turbine-war-webmacro/WEB-INF/classes/WebMacro.properties
>
> Also the same error/typo is in the docs file ../docs/war-webmacro.html:
>
> In the conf/ directory, the build script will place a copy of the
> turbine/conf/Webmacro.properties and the
> turbine/conf/TurbineResources.properties files.
>
> Also the next line says:
> In the various templates directories, the build script will copy the
> various turbine/examples/webmacro/ .wm files.
>
> However, the examples in turbine/examples/webmacro/ are kind of different
> than the ones in WEB-INF
>
> Another typo:
> "you will want to define the modules= line"
>
> modules= should be modules.packages= (twice)
>
> ------------------------------------------------------------
> To subscribe: [EMAIL PROTECTED]
> To unsubscribe: [EMAIL PROTECTED]
> Search: <http://www.mail-archive.com/turbine%40list.working-dogs.com/>
> Problems?: [EMAIL PROTECTED]
------------------------------------------------------------
To subscribe: [EMAIL PROTECTED]
To unsubscribe: [EMAIL PROTECTED]
Search: <http://www.mail-archive.com/turbine%40list.working-dogs.com/>
Problems?: [EMAIL PROTECTED]
