[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
20070509-1: README.Debian + apache.conf.gz patches
From: |
boud |
Subject: |
20070509-1: README.Debian + apache.conf.gz patches |
Date: |
Sat, 12 May 2007 04:26:29 +0200 (CEST) |
hi samizdat-devel,
The README.Debian file is quite nice. i installed 20070509-1 from scratch
in a debian-etch distribution following the exact instructions in
README.Debian.
There *were* a few minor changes necessary.
There are also a few ambiguous comments in the examples/apache.conf.gz file.
And i think it would be useful to warn the sysadmin that there are also
config files in /etc/samizdat/ - e.g. /etc/samizdat/sites needs to
be changed if someone is setting up a remote site. (i spent a couple of
hours tracing this "RTFM-pseudo-bug".) Of course, s/he should in principle
also read "install.txt", but since README.Debian seems to be a potential
basis from which to develop a completely one-line
aptitude install samizdat
package at some time in the future for getting into stable (with lots
of checks and failsafes added on), i think this it's important to
keep correcting these "little" bugs.
Anyway, these are my recommended changes.
Any objections?
cheers
boud
--- /20070509-1/usr/share/doc/samizdat/README.Debian 2007-05-09
22:46:40.000000000 +0200
+++ /usr/share/doc/samizdat/README.Debian 2007-05-12 04:03:09.832574912
+0200
@@ -42,8 +42,18 @@
2) Configure Apache:
-cp /usr/share/samizdat/doc/examples/apache.conf \
- /etc/apache2/sites-available/samizdat
+# install configuration file:
+cp /usr/share/doc/samizdat/examples/apache.conf.gz \
+ /etc/apache2/sites-available/samizdat.gz
+gunzip /etc/apache2/sites-available/samizdat.gz
+
+# enable it
+ln -s /etc/apache2/sites-available/samizdat \
+ /etc/apache2/sites-enabled/samizdat
+
+# create relevant directories
+mkdir -p /var/www/samizdat/ /var/www/samizdat/content/
+chown www-data:www-data /var/www/samizdat/content/
mkdir -p /var/log/apache2/samizdat
3) Create PostgreSQL database and configure IDENT access for CGI
@@ -68,7 +78,9 @@
# IPv6 local connections:
host all all ::1/128 md5
-4) http://localhost/samizdat/
+4) Restart apache and samizdat and look at http://localhost/samizdat/
+with a web browser. To test a remote server, first edit apache and
+/etc/samizdat/ configuration files.
Explanations
--- /20070509-1/usr/share/doc/samizdat/apache.conf 2007-04-22
15:51:48.000000000 +0200
+++ /usr/share/doc/samizdat/apache.conf 2007-05-11 22:26:29.069557680
+0200
@@ -84,9 +84,11 @@
# Apache configuration for Samizdat engine - Directory-based site
#
-# Change "/var/www/samizdat/content/" to wherever you want your
-# uploaded files to be stored. Make sure the directory is writable
-# by web server user (www-data)
+# Replace the first "/samizdat" here with your site location for all
+# aliases.
+# Also, change "/var/www/samizdat/content/" to wherever you want your
+# uploaded files to be stored. Make sure the directory is writable by
+# web server user (www-data).
Alias /samizdat/content/ /var/www/samizdat/content/
<Directory /var/www/samizdat/content>
Options Indexes
@@ -102,7 +104,7 @@
</LimitExcept>
</Directory>
-# Replace "/samizdat" with your site location for all aliases
+# Replace the first "/samizdat" here with your site location for all aliases
Alias /samizdat/css/ /usr/share/samizdat/css/
AliasMatch ^/samizdat/(dispatch)\.rb /usr/share/samizdat/cgi-bin/$1.rb
#----------------------------------------------------------------------
- 20070509-1: README.Debian + apache.conf.gz patches,
boud <=