Item4718: Improve the installation doc for how to setup apache config for configure

(08:27:09) zr_: hi, my question: I installed Twiki and when I go to /bin/configure, I get a request for user credentials. When I press cancel I get a 404 error page.
(08:32:00) zr_: actually, I get a 401 page
(08:34:22) CDot: zr_: I will help you, but you must answer my questions quickly and concisely
(08:34:26) CDot: deal?
(08:35:24) zr_: sure
(08:35:28) zr_: bring it on me
(08:35:34) CDot: first, what platform
(08:35:39) zr_: linux Centos
(08:35:49) CDot: where di you get the install package?
(08:36:00) zr_: twiki? directly from the website
(08:36:09) CDot: did you read the installation instructions?
(08:36:23) zr_: yes
(08:36:26) zr_: I have TWiki-4.1.2.tgz
(08:36:30) CDot: did you follow them?
(08:36:36) zr_: yes, I did
(08:36:48) CDot: how did you generate your apache config?
(08:37:12) zr_: I used the suggested config file included in the archive
(08:37:45) CDot: which suggested config file?
(08:38:05) zr_: twiki_httpd_conf.txt
(08:38:16) ***CDot is fetching it
(08:38:55) CDot: do you see the line: <FilesMatch "^configure.*"> in that file?
(08:39:15) zr_: yes
(08:39:30) CDot: do you see the lines:
(08:39:30) CDot: Allow from 127.0.0.1 192.168.1.10
(08:39:30) CDot: Require user JohnDoe
(08:39:58) zr_: yes
(08:40:06) CDot: do you have a user "JohnDoe", or is your IP address 192.168.1.10?
(08:40:20) zr_: aahhh, now I understand
(08:40:25) zr_: I see a pattern here
(08:40:30) zr_: lemme fix this
(08:43:07) zr_: yes, that was defintely it
(08:43:13) zr_: thank you so very much for the patience and help
(08:43:15) CDot: thank you, zr_, this was most useful. I will capture this dialog in a bug report.

How many of these do we get in IRC in an average week? Please, let's not wait another release to fix this!

-- TWiki:Main/CrawfordCurrie - 25 Sep 2007

If the fix is just documentation then for sure we can improve INSTALL.html a bit more with an example. But people still may not read the docs and those we cannot rescue. There will always be a need to setup Apache. Assigning to myself.

-- KennethLavrsen - 01 Oct 2007

Gave the installation doc a good make over. Enough to close this one.

-- TWiki:Main.KennethLavrsen - 25 Nov 2007