On 9/22/08, Gregor Ebersberg <[EMAIL PROTECTED]> wrote: > On Sunday 21 September 2008 01:43:22 pm [EMAIL PROTECTED] wrote: > > I was surprised you felt Tomcat was necessary. The installation > > instructions at: > > http://lenya.apache.org/docu20/installation20/install20.html > > explain the standalone implementation first. What caused you to think > > that Tomcat was needed? We are always seeking to improve the > > documentation. Should we add a line stating, "We recommend the Jetty > > standalone installation for beginners."? > > That is certainly a way to respond, if this is an issue at all. > > However, my problem was even more rooted in my lack of knowledge: I had to > look up what Jetty is. And I did so only after encountering the term in some > of the answers on this list. So same on me but only briefly. > > I would opt for explaining all names in the documentation text (and not > relaying on the user following a link, if you think you can take advantage of > hypertext) iff (if and only if) the name is crucial in the understanding of > the documentation text's meaning. In the case of >Jetty<, I needed to be > aware that Jetty provides http server functionality to understand that I > don't need Tomcat with Apache altogether. > > On the other hand, if I understood this bit, this also means that I have to > abandon my Apache server to use Lenya in a ready-made out-of-the-box fashion > (and it is still a question whether someone else finds this useful). Perhaps > abandoning Apache is improbable for the average newbie that the Lenya > community is poised to convince of Lenya's value. > > Perhaps it's much easier to explain explicitly in the documentation that the > port numbers in the URLs will vanish once Lenya is properly and permanently > installed on the new user's host. And meanwhile new users have to endure the > port numbers in the URLs but, of course, need not worry about them since they > vanish if the new user decides to install Lenya permanently. > > I even thought all visitors need to go through the start screen, e.g. the one > set up as the main demo site at http://lenya.zones.apache.org:9999/index.html > (linked in the second line of text on http://lenya.apache.org . Is it > possible to first lead the visitors of the Lenya home page to a working > example of content served by a Jetty instance including a prominant link to > the Lenya management of that content? (Of course since the transition from > forrest to Lenya, as far as I read, the whole content is managed by Lenya, > but new visitors can only learn from what they are aware of. > > Thank you so much, > Gregor
I think you understand. The following is meant as a draft of what could be added to the documentation. Would this text have prevented your confusion? === Lenya is a Java Servlet. Running Lenya requires a servlet engine/Web server. Two popular (and well-tested) choices are: 1. Jetty - a free non-Apache simple servlet engine/Web server included with Lenya. 2. Tomcat - Apache's robust servlet engine/Web server. Tomcat also offers integration with Apache httpd. Lenya on Jetty defaults to using port 8888 to avoid conflicts with Tomcat's default port 8080 and the default port 80 for Web servers. The port for any Web server (including Jetty) is configurable so Lenya can use port 80 (if not conflicting with other Web servers) to avoid requiring the port number in URLs. Many Web servers can proxy to the Lenya standalone (Jetty) server. This often requires URL and Cookie rewriting. The advantage is the URL rewriting can create more concise URLs e.g. removing the Publication and Area names from URLs. We recommend evaluations (and beginners) use the standalone Jetty installation with the understanding that URLs can be improved for production. === solprovider --------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
