[Moin-devel] CVS: dist/wiki/data/text HelpOnInstalling_2fApacheOnUnix,1.3,1.4

[J?rgen Hermann]

Update of /cvsroot/moin/dist/wiki/data/text
In directory usw-pr-cvs1:/tmp/cvs-serv8548

Modified Files:
	HelpOnInstalling_2fApacheOnUnix 
Log Message:
"root" installation added


Index: HelpOnInstalling_2fApacheOnUnix
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/HelpOnInstalling_2fApacheOnUnix,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** HelpOnInstalling_2fApacheOnUnix	22 Feb 2002 20:45:02 -0000	1.3
--- HelpOnInstalling_2fApacheOnUnix	26 Feb 2002 21:39:46 -0000	1.4
***************
*** 12,16 ****
  When you are root or the webmaster on the host you want to install MoinMoin on, you can place the software in a "standard" location, and also better integrate MoinMoin into your webserver. Especially, you can use a "nice" base URL that does not include "cgi-bin" or "moin.cgi" at all.
  
!  <!> TODO: complete this
  
  == Installation into your home directory ==
--- 12,93 ----
  When you are root or the webmaster on the host you want to install MoinMoin on, you can place the software in a "standard" location, and also better integrate MoinMoin into your webserver. Especially, you can use a "nice" base URL that does not include "cgi-bin" or "moin.cgi" at all.
  
! Most GNU/Linux distributions come with Apache pre-installed. In the following description, we assume the file system layout of a SuSE 7.0 system, that is:
!  * `/etc/httpd/httpd.conf` - the main httpd configuration file
!  * `/var/log/httpd/error_log` - log containing error messages
! 
! === Installing MoinMoin ===
! 
! Before creating a wiki instance, you have to download and install the basic MoinMoin software. We assume you already have downloaded the distribution archive to "`/tmp`" [[FootNote(If you want to install the current development version from CVS, replace "/tmp" with your "moin" working directory.)]].
! 
! Open a shell and enter the following commands:
! {{{
! cd /tmp
! tar xfz moin-0.11.tgz
! cd moin-0.11
! python setup.py install --record=install.log
! }}}
! 
! This will install all necessary files into the `sys.prefix` directory of your Python interpreter (usually either "`/usr`" or "`/usr/local`"), and create a "`install.log`" file listing all the files that are created there. The command "`python -c 'import sys; print sys.prefix'`" will tell you where your Python interpreter is installed, we assume "`/usr/local`" here.
! 
! [[FootNote]]
! 
! === Creating a wiki instance ===
! 
! You could run your wiki directly using the sample wiki created in "`/usr/local/share/moin`", but this is not recommended for two reasons:
!  1. updating your wiki is more complicated and more dangerous.
!  1. creating a second wiki instance, even if you currently don't plan for one, is much easier.
! 
! We need to know what user and group your Apache server runs on, so issue this command:
!  `jh at localhost:~ > `'''`egrep "^User|^Group" /etc/httpd/httpd.conf`'''[[BR]]
!  `User wwwrun`[[BR]]
!  `Group nogroup`[[BR]]
! 
! This shows a typical result "`wwwrun.nogroup`", which we will use later on.
! 
! To create an instance named "`mywiki`", enter these commands on a ''root'' shell prompt:
! {{{
! cd /usr/local/share/moin
! mkdir mywiki
! cp -r data mywiki
! cp cgi-bin/* mywiki
! chown -R wwwrun.nogroup mywiki
! chmod a+rx mywiki/*.cgi
! }}}
! 
! "`mywiki`" is the name of your wiki instance, you might want to chose a different name best fitting the intended use of this instance; just don't name it simply "`wiki`", because that would result in problems later on.
! 
! Then, append these lines to "`/etc/httpd/httpd.conf`": {{{
! Alias /wiki/ "/usr/local/share/moin/htdocs/"
! ScriptAlias /mywiki "/usr/local/share/moin/mywiki/moin.cgi"
! }}}
! 
! The first line you only need once; the second line is needed once for each wiki instance (of course, each one with another wiki name and path).
! 
! That is all, '''restart your Apache server''' ("`/etc/rc.d/apache restart`" on SuSE) and try to access your new-born wiki with the URL "`http://127.0.0.1/mywiki/`". You should see the FrontPage, try to edit and save it, and if that works, see if your edit is reflected on the RecentChanges page.
! 
! Finally, edit "`moin_config.py`" and at least change "`sitename`" and "`logo_url`" to some personal values:
! {{{
! sitename = 'My Wiki'
! logo_url = '/images/mywiki-logo.gif'
! }}}
! 
! For a personal or intranet installation, you'll normally also add the line {{{
! allowed_actions = ['DeletePage', 'AttachFile']
! }}}
! 
! === Troubleshooting ===
! 
! The first thing to do when your wiki does not work as expected is to issue the command "`tail /var/log/httpd/error_log`" to display the most recent errors. Usually, you will get a hint on what went wrong, like missing file system permissions.
! 
! The most common problem you might encounter is when you have Python 1.5.2 installed into "`/usr`", and a newer Python distribution into "`/usr/local`"; this is typical for GNU/Linux distributions that still come bundled with version 1.5.2 of Python.
! 
! In that case, if you enter "`python`" on you prompt, you will usually get the more recent Python interpreter, because "`/usr/local/bin`" is in your `PATH`. The situation is different in your webserver environment, and thus you might have to change the bang path of "`moin.cgi`", like this: {{{
! #! /usr/local/bin/python
! 
! """
!     MoinMoin - CGI Driver Script
! ...
! }}}
! 
  
  == Installation into your home directory ==