Jerry, I indeed created the JIRA myself. I personally consider the configuring of front-ending stuff not part of JSPWiki, in your case it was the ajp , but it could just as well have been Apache proxy_http, WebSphere's plugin config, F5 iRules or whatever you have in front of your container. But we encourage anyone to provide some good documentation on our wiki. (https://jspwiki-wiki.apache.org).
On the other hand I agree with you that the Installer definitely needs improvements, it should be as foolproof as possible and work on both *nix and windows systems. We could take those improvements with JSPWIKI-817. kind regards, Harry On 2 February 2014 17:19, Jerry Malcolm <2ndgenfi...@gmail.com> wrote: > Harry, thanks for the update. I don't know anything about jira or > opening issues. It looks like from your followup post that the issue > has been opened. > > But.... IMHO , here are still some pretty serious problems with the > documented "Getting Started" steps.... My environment is tomcat with > apache httpd (on Windows Server 8). I have a standard "JKMount *.jsp" > config in the httpd.conf for this host which got me to the > Install.jsp. But I have since realized that I needed to add a JkMount > /JSPWiki/**/*.* worker1 (or whatever I named the war file to). > Otherwise, no css, etc will be found. There was no mention of having > to update apache to get it to send all /JSPWiki/ requests to tomcat. > Maybe that's a 'well duh... anybody should know that...' Fine, but a > reminder would have been nice. > > Next... the guide says after configuration that I should then just go > to <host>/JSPWiki/ (with no .jsp name specified). The problem with > that is my Apache is configured to look for "index.html" or > "index.jsp" if no file is specified. JSPWiki has no index.jsp. I > 'guessed' after looking at the folder that I was supposed to request > "Wiki.jsp". At least something came up there. But without > configuration changes, <host>/JSPWiki/ without a jsp name isn't going > anywhere. > > Next.... :-(.... there was zero guidance on "Page Storage -- Please > Configure Me!... What is supposed to be entered there? In the help it > says something about a directory being created if it doesn't exist. > But I entered a directory name and no directory was created at that > location. Was this supposed to be a fully qualified directory or > relative to the war, relative to the webapp, relative to the host, > etc? Why doesn't JSPWiki just pick a logical place to put the pages. > When I'm going through this config page, I don't know enough to know > how to pick things like this with the little guidance given next to > that field on that page. > > Next... it gave a default of '/tmp/' for the log files. That looks > very unix-like. I'm on Windows. I can't find the logs dir. > > Finally, after stuggling through apache configurations, completely > wild guesses at filling in config fields, and further guessing that > perhaps "Wiki.jsp" is the assumed index.jsp... I finally got a page up > that looks reasonably like I should be able to create a wiki page. > Great... So I entered a few characters and hit 'save'. The > subsequent page is blank. I still have no directory where (I think) I > specified I wanted the pages to go. And I'm dead. > > This has been a miserable failure for me at a "simple 2-step then > viola!" quick start to get a wiki up and running. (and I have many > years of experience working with apache, tomcat, webapps, etc... I'm > not a rookie at this). > > Please help....... > > Thx again for any help you can provide... just trying to overcome my > frustration.... > > Jerry >
