*** empty log message ***

This commit is contained in:
alba 2002-08-04 19:38:56 +00:00
parent 599b0a2076
commit 25cb56e5fe
5 changed files with 95 additions and 37 deletions

View File

@ -2,7 +2,7 @@
Installation
=======================================
2002-08-03
2002-08-04
Installation of lampadas is a bloody mess.
Report all problems, suggestions and flames to
@ -23,7 +23,8 @@ A summary of the process:
1. Install a lot of tools, modules, packages
2. Build documentation in directory 'doc'
3. Install postgresql database
4. Install Apache with mod_python and python 2.x
4. Install apache, python 2.x and mod_python
5. Configure Apache
=======================================
0. Copy/extract lampadas files
@ -39,7 +40,7 @@ This directory can be operated read-only after configuration.
1. Install a lot of tools, modules, packages
=======================================
The prefered way to verify this step is with a bash script you'll
The preferred way to verify this step is with a bash script you'll
find in this directory:
./configure
@ -67,7 +68,7 @@ least the files 'bin/setenv.sh' and 'conf/lampadas.conf'.
2. Build documentation in directory 'doc'
=======================================
This step is very optional. First of all it's just documenation,
This step is very optional. First of all it's just documentation,
nothing vital. And then the installation kit (lampadas-*.tar.gz)
already contains all rendered output.
@ -93,9 +94,9 @@ You still need to create user accounts and configure authentication,
though. Local accounts are the easiest case since that requires no
passwords or network control.
Usually there is only one priviledged account (called 'postgres')
Usually there is only one privileged account (called 'postgres')
with access to the postmaster. You will need two other accounts.
One for database management, one for the webserver.
One for database management, one for the web server.
See 'bin/setenv.sh' for the value of LAMPADAS_WWW_USER.
It should have been set by ./configure.
@ -104,12 +105,12 @@ since user postgres has no password set):
su - postgres -c "createuser -A -d lampadas"
The webserver requires less permissions:
The web server requires less permissions:
su - postgres -c "createuser -A -D $LAMPADAS_WWW_USER"
'lampadas' should be your account for installation and maintenance,
chose something aproriate. You won't need root access again for
chose something appropriate. You won't need root access again for
the database. Log in with the new account ('lampadas' in above
example) and create a database instance called 'lampadas'
(must match value of LAMPADAS_DB in 'bin/setenv.sh'):
@ -129,20 +130,21 @@ This tool requires a lot of environment variables defined by
bin/lampadasdb insert
=======================================
4. Install Apache with mod_python and python 2.x
4. Install apache, python 2.x and mod_python
=======================================
This is a problem on Red Hat 7.x, where '/usr/bin/python' is a
Python 1.x. Read 'doc/INSTALL.redhat' how to roll your own.
Lampadas requires Python 2.x. This is a problem On Red Hat 7.x, where
'/usr/bin/python' is a Python 1.x. Read 'doc/INSTALL.redhat' how to
roll your own.
On the other hand Red Hat has no problems with compilation of
pypgsql-2.1. My experience on both Debian 3.0r0 and SuSE 7.3
is that 'python setup.py build' breaks because of missing header
files. Just add the result of
files. Add the result of
pg_config --includedir
to variable C_INCLUDE_PATH. In the simpliest case this means
to variable C_INCLUDE_PATH. In the simplest case this means
export C_INCLUDE_PATH=`pg_config --includedir`
@ -155,3 +157,41 @@ I also found that you can safely ignore the message
gcc: unrecognized option `-R/usr/local/pgsql/lib'
and just continue with 'python setup.py install'.
=======================================
5. Configure Apache
=======================================
./configure makes no guesses about Apache. You can use pre-fabricated
packages or roll your own. On the other hand you have to perform any
modification to 'httpd.conf' manually.
We need 'mod_python' (is described in the next chapter) and we need
the following standard modules:
mod_alias
mod_env
mod_rewrite
Go sure the corresponding 'LoadModule' line is active. If your
'httpd.conf' contains a 'ClearModuleList' statement you also need
a 'AddModule' for every module.
Directory 'conf' contains examples of virtual hosts. Probably the
easiest way to add such a configuration to your Apache is an include
statement in 'httpd.conf':
include /home/alba/cvs/LDP/lampadas/conf/test.httpd.conf
./configure patches the path names in directory 'conf', so this
part of the configuration should work (minus the mod_python stuff).
You can (and should) modify the value of statement 'ServerName', though.
You need to map the virtual server name to your local IP address.
If you don't have a DNS under your control a entry in /etc/hosts
should do:
127.0.0.1 test.lampadas.org
Before direct your web browser to 'http://test.lampadas.org' go sure
that you don't access a proxy for that domain or address '127.0.0.1'.

View File

@ -50,3 +50,6 @@ dist:
pwd=`pwd`; \
dir=`basename $$pwd`; \
tar -C .. -X exclude -vzcf lampadas-$$today.tar.gz $$dir
update: ; cvs -z9 update -d -P > update.cvs
diff: ; cvs -z9 diff > diff.cvs

View File

@ -311,7 +311,7 @@ check_python_import()
#
patch_xsl()
{
local prefix='^\([[:space:]]*<xsl:import[[:space:]]*href=\"\)'
local prefix='^\([[:space:]]*<xsl:import[[:space:]]\{1,\}href=\"\)'
local postfix='\(\".*\)$'
for file in xsl/*.xsl; do
@ -334,7 +334,7 @@ patch_xsl()
patch_setenv_sh()
{
local file=$1
local prefix='^[[:space:]]*export[[:space:]]*LAMPADAS_'
local prefix='^[[:space:]]*export[[:space:]]\{1,\}LAMPADAS_'
echo -n "Patching ${file} ... "
sed -e "s|\(${prefix}ROOT=\).*|\1\"${PWD}\"|" \
@ -347,6 +347,9 @@ patch_setenv_sh()
return 1
fi
echo "Ok"
echo -n "Sourcing in ${file} ... "
. ${file}
echo "Ok."
return 0
}
@ -357,29 +360,39 @@ create_setenv_csh()
{
local input=$1
local output=$2
local prefix='^[[:space:]]*export[[:space:]]*'
local prefix='^[[:space:]]*export[[:space:]]\{1,\}'
echo -n "Sourcing in ${input} ... "
echo -n "Generating ${output} ... "
(
. ${input}
echo "Ok."
echo -n "Generating ${output} ... "
echo "# Generated by configure. Do not modify."
echo ""
sed -ne "s/${prefix}\([[:alnum:]_]\{1,\}\)=.*/\1/p" \
< ${input} \
| while read var
do
echo "setenv ${var} \"${!var}\""
done
) > ${output}
(
echo "# Generated by configure. Do not modify."
echo ""
sed -ne "s/${prefix}\([[:alnum:]_]*\)=.*/\1/p" \
< ${input} \
| while read var
do
echo "setenv ${var} \"${!var}\""
done
) > ${output}
echo "Ok."
return 0
}
echo "Ok."
return 0
)
return 1
#
# patch_http_conf
#
patch_http_conf()
{
local prefix='\([[:space:]'\'']*\)[[:alnum:]\.\-_/]*'
for file in "$@"; do
echo -n "Patching ${file} ... "
sed -e "s#${prefix}/pylib\>#\1${LAMPADAS_LIB}#g" \
-e "s#${prefix}\(/www/\)#\1${LAMPADAS_ROOT}\2#g" \
< ${file} > ${file}.tmp \
&& mv -f ${file}.tmp ${file} \
&& echo "Ok."
done
}
#
@ -387,7 +400,7 @@ create_setenv_csh()
#
if [ ! -x ${PWD}/configure ]; then
echo "ERROR: Can't find myself in current directory."
echo "Please start me ./configure"
echo "Please start this script as ./configure"
exit -1
fi
@ -424,3 +437,4 @@ echo "No errors."
patch_xsl || exit -1
patch_setenv_sh bin/setenv.sh || exit -1
create_setenv_csh bin/setenv.sh bin/setenv.csh || exit -1
patch_http_conf conf/*.conf || exit -1

View File

@ -6,7 +6,7 @@ m4_dnl it in translations when the translation is up to date.
m4_dnl "menu_name" is the short name of the page, which is
m4_dnl typically listed in sidebar menus.
insert([index], [|strproject|], [Splash Page],
insert([index], [|strproject|], [Splash-Seite],
[
|tabsplashlanguages|
], 0)
@ -90,7 +90,7 @@ insert([contribute], [Mitarbeit bei |strproject|],
[
Als Mitglied der Lampadas-Gemeinde arbeiten Sie mit
hunderten oder gar tausenden Anderen zusammen an Dokumentation
die über\'s Netz weltweit veröffentlicht wird.
die über's Netz weltweit veröffentlicht wird.
<p>Lampadas soll weltweite Mitarbeit so einfach wie möglich machen.
Wir können viele Arten von Hilfe brauchen.

View File

@ -1,6 +1,7 @@
*/.*
*~
*.bak
*.cvs
*.gz
*/CVS
*/core*