[Moin-devel] CVS: dist/wiki/data/text HelpOnInstalling_2fTroubleShooting,NONE,1.1 HelpOnInstalling,1.11,1.12 HelpOnInstalling_2fApacheOnUnix,1.9,1.10 HelpOnPageCreation,1.7,1.8 HelpOnSmileys,1.3,1.4 MoinMoin_2fInstallDocs,1.1,1.2 MoinMoin_2fInstallationsAnleitung,1.2,1.3
J?rgen Hermann
jhermann at users.sourceforge.net
Fri Mar 22 11:17:19 EST 2002
Update of /cvsroot/moin/dist/wiki/data/text
In directory usw-pr-cvs1:/tmp/cvs-serv19585
Modified Files:
HelpOnInstalling HelpOnInstalling_2fApacheOnUnix
HelpOnPageCreation HelpOnSmileys MoinMoin_2fInstallDocs
MoinMoin_2fInstallationsAnleitung
Added Files:
HelpOnInstalling_2fTroubleShooting
Log Message:
Troubleshooting...
--- NEW FILE: HelpOnInstalling_2fTroubleShooting ---
=== Built-in test ===
There's a built-in diagnostic mode that's useful when doing an install; just append "`?test`" to the URL of your wiki: {{{
lynx --dump http://`hostname`/mywiki?test
}}}
If you see an import error here, but "`python -c "import MoinMoin"`" works, it's likely a result of missing file permissions or a wrong PYTHONBPATH setting within the web server environment.
Index: HelpOnInstalling
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/HelpOnInstalling,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -r1.11 -r1.12
*** HelpOnInstalling 9 Mar 2002 16:20:41 -0000 1.11
--- HelpOnInstalling 22 Mar 2002 19:16:52 -0000 1.12
***************
*** 8,11 ****
--- 8,13 ----
/BasicInstallation explains the "`setup.py`" step of the installation in more detail. This applies equally to all scenarios, and you should read it before trying a live installation.
+ /TroubleShooting helps with fixing any general problems you might encounter, which apply to any installation platform.
+
After a successful installation, you might want to read more about configuration and other options that you, as the wiki administrator, can set up. HelpOnAdministration contains links to pages that cover these topics.
Especially, the HelpOnConfiguration and HelpOnUpdating pages provide additional information regarding wiki setup and maintenance. MoinMoin:MoinMoinWinCvs and MoinMoin:MoinMoinUnixCvs describe how to run your wiki using the current development version from the MoinMoin:SourceForge CVS repository.
Index: HelpOnInstalling_2fApacheOnUnix
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/HelpOnInstalling_2fApacheOnUnix,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -r1.9 -r1.10
*** HelpOnInstalling_2fApacheOnUnix 15 Mar 2002 22:17:51 -0000 1.9
--- HelpOnInstalling_2fApacheOnUnix 22 Mar 2002 19:16:52 -0000 1.10
***************
*** 76,80 ****
=== 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.
--- 76,82 ----
=== 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. Also, always consult the HelpOnInstalling/TroubleShooting page for further hints on your problem.
!
! ==== Dueling Pythons ====
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.
***************
*** 89,93 ****
--- 91,113 ----
}}}
+ ==== Distutils does not work ====
+
If you have problems with the '''distutils''' install step, note that you need to have the Python development package installed on some Unix distributions. On Mandrake, you need to "`rpm -i python-devel-2.1.1-3mdk.i586.rpm`".
+
+ ==== Missing file permissions ====
+
+ If you are root, the installed files may be readable only by root, but they must also be readable by the web server before the wiki will work. This includes both the Python modules and the site itself. For the data directory, the web server also needs ''write'' access. To fix this, first find out where the Python module directory is; look in `install.log`, or run the command:
+
+ {{{
+ python -c "import sys; print '%s/lib/python%s/site-packages' % ( sys.prefix, sys.version[:3] )"
+ }}}
+
+ For the example below, we'll assume that the Python module directory is `/usr/local/lib/python2.1/site-packages`.
+ Make the files world-readable using the following commands: {{{
+ cd /usr/local
+ chmod -R a+rX lib/python2.1/site-packages/MoinMoin share/moin
+ }}}
+
+ /!\ Note that by making everything under `/usr/local/share/moin` world-readable, local users can read the files containing your wiki. You don't really need to do that, since the `mywiki` directory is owned by the webserver. If you don't want that, you do a "`chmod -R o-rwx share/moin/mywiki`" after the above commands.
Index: HelpOnPageCreation
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/HelpOnPageCreation,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -r1.7 -r1.8
*** HelpOnPageCreation 13 Mar 2002 20:54:30 -0000 1.7
--- HelpOnPageCreation 22 Mar 2002 19:16:52 -0000 1.8
***************
*** 23,25 ****
|| @''''''MAILTO@ || A fancy mailto: link with the user's data ||
! Note that saving template or form definition pages does ''not'' expand variables. Other than that, variable expansion is very gloabl and happens anywhere on the page, including code displays, comments, processing instructions and other "special" areas of a page you might think are excluded.
--- 23,25 ----
|| @''''''MAILTO@ || A fancy mailto: link with the user's data ||
! Note that saving template or form definition pages does ''not'' expand variables. Other than that, variable expansion is very global and happens anywhere on the page, including code displays, comments, processing instructions and other "special" areas of a page you might think are excluded.
Index: HelpOnSmileys
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/HelpOnSmileys,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -r1.3 -r1.4
*** HelpOnSmileys 4 Mar 2002 20:42:20 -0000 1.3
--- HelpOnSmileys 22 Mar 2002 19:16:52 -0000 1.4
***************
*** 26,27 ****
--- 26,30 ----
|| {{{ |) }}} || |) || tired.gif ||
|| {{{ ;)) }}} || ;)) || lol.gif ||
+ |||||| ''Added with version 0.12'' ||
+ || {{{ (./) }}} || (./) || checkmark.gif ||
+ || {{{ (OK) }}} || (OK) || thumbs-up.gif ||
Index: MoinMoin_2fInstallDocs
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/MoinMoin_2fInstallDocs,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -r1.1 -r1.2
*** MoinMoin_2fInstallDocs 27 Feb 2002 21:00:43 -0000 1.1
--- MoinMoin_2fInstallDocs 22 Mar 2002 19:16:52 -0000 1.2
***************
*** 10,13 ****
--- 10,15 ----
[#basic-install Basic Installation] explains the "`setup.py`" step of the installation in more detail. This applies equally to all scenarios, and you should read it before trying a live installation.
+ [#trouble-shooting Trouble-shooting] helps with fixing any general problems you might encounter, which apply to any installation platform.
+
After a successful installation, you might want to read more about configuration and other options that you, as the wiki administrator, can set up. MoinMoin:HelpOnAdministration contains links to pages that cover these topics.
Especially, the MoinMoin:HelpOnConfiguration and MoinMoin:HelpOnUpdating pages provide additional information regarding wiki setup and maintenance. MoinMoin:MoinMoinWinCvs and MoinMoin:MoinMoinUnixCvs describe how to run your wiki using the current development version from the MoinMoin:SourceForge CVS repository.
***************
*** 27,30 ****
--- 29,36 ----
[[Anchor(basic-install)]]
[[Include(HelpOnInstalling/BasicInstallation)]]
+ ------
+ [[Anchor(trouble-shooting)]]
+ ------
+ [[Include(HelpOnInstalling/TroubleShooting, "Trouble-shooting", 1)]]
------
[[Anchor(unix-install)]]
Index: MoinMoin_2fInstallationsAnleitung
===================================================================
RCS file: /cvsroot/moin/dist/wiki/data/text/MoinMoin_2fInstallationsAnleitung,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -r1.2 -r1.3
*** MoinMoin_2fInstallationsAnleitung 4 Mar 2002 21:27:01 -0000 1.2
--- MoinMoin_2fInstallationsAnleitung 22 Mar 2002 19:16:52 -0000 1.3
***************
*** 15,18 ****
--- 15,20 ----
Dieser Schritt ist immer durchzuführen, deshalb empfiehlt es sich, die dort enthaltenen Information in jedem Fall durchzulesen, bevor Sie den Installationsvorgang beginnen.
+ [#trouble-shooting Fehlerbehebung] hilft bei der Beseitigung von allgemeinen Fehlern, die auf jeder Plattform auftreten können.
+
Nachdem Sie die Software erfolgreich aufgespielt haben, sollte der nächste Schritt darin bestehen, mehr über die Konfigurationsoptionen und optionale Erweiterungen zu erfahren, die Sie als Wikiadministrator einrichten können.
Die Seite MoinMoin:HilfeZurAdministration enthält dazu Verweise auf weitere Seiten, die diese Themen abdecken.
***************
*** 37,40 ****
--- 39,46 ----
[[Anchor(basic-install)]]
[[Include(HilfeZurInstallation/BasisInstallation)]]
+ ------
+ [[Anchor(trouble-shooting)]]
+ ------
+ [[Include(HilfeZurInstallation/FehlerBehebung, "Fehlerbehebung", 1)]]
------
[[Anchor(unix-install)]]
More information about the Moin-devel
mailing list