summaryrefslogtreecommitdiff
path: root/TWiki/TWikiInstallationGuide.mdwn
diff options
context:
space:
mode:
authorPeter Thoeny <web-hurd@gnu.org>2001-03-16 08:46:08 +0000
committerPeter Thoeny <web-hurd@gnu.org>2001-03-16 08:46:08 +0000
commit0c54ed612be0fe9d4a31a1f1817dbda0a1f7ac39 (patch)
tree852d36a398df1e1a048cd9cae9e13e77a15af688 /TWiki/TWikiInstallationGuide.mdwn
parenta20e13a60d4d7a7f3b37d4ac20f150e18b6a8fd7 (diff)
none
Diffstat (limited to 'TWiki/TWikiInstallationGuide.mdwn')
-rw-r--r--TWiki/TWikiInstallationGuide.mdwn10
1 files changed, 7 insertions, 3 deletions
diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn
index 452bf6b0..4112846d 100644
--- a/TWiki/TWikiInstallationGuide.mdwn
+++ b/TWiki/TWikiInstallationGuide.mdwn
@@ -1,3 +1,5 @@
+## <a name="TWiki_Installation_Notes"> TWiki Installation Notes </a>
+
These installation steps use the Apache web server on Linux as an example. TWiki should run on other web servers and Unix systems as well. (TWiki on Windows is possible, but has not been documented well. More on that at <http://TWiki.org/cgi-bin/view/Codev/TWikiOnWindows> )
**_Note:_** Below installation steps assume user `nobody` for all files manupulated by the cgi scripts (executed by the web server), and user `twiki` for all other files. You need to replace user `nobody` with an other user in case the web server executes the script with a different user ( default for Debian is `www-data` ). Also, you can substitute user `twiki` with your own user name.
@@ -39,7 +41,7 @@ These installation steps use the Apache web server on Linux as an example. TWiki
Read <http://TWiki.org/cgi-bin/view/Codev/SourceForgeHowTo> in case you want to install TWiki on SourceForge.
-Installation steps:
+### <a name="Installation_steps"> Installation steps </a>
* Request the TWiki distribution (in Unix ZIP format) from <http://TWiki.org/download.html> .
* Create directory `/home/httpd/twiki` and unzip the TWiki distribution into this directory.
@@ -81,7 +83,7 @@ Installation steps:
* If you use `.htaccess`, edit the file and add the file extension to `edit`, `view`, `preview`, etc.
* Note in case the cgi scripts are **_not_** running as user `nobody`: The `*,v` RCS repository files delivered with the installation package are locked by user `nobody` . In case the user is different (e.g. `www-data` ), it is not possible to check in files, this has the effect that the topic version number does not increase when saving a topic. In this case you need to unlock all repository files and lock them as user `www-data` (check the rcs man pages), or simply delete all the repository files. A simple way to switch the locker of the RCS files is to use sed: <br />`for f in *,v; do sed 's/nobody\:/www-data\:/' $f > x; mv x $f; done`
* Security issue: Directories `twiki/data` , `twiki/templates` and all its subdirectories should be set so that they are **not** visible as a URL. (Alternatively, move the directries to a place where they are not visible, and change the variables in `twiki/bin/wikicfg.pm` accordingly)
-* Enable email notification of topic changes, [Notification of Changes](TWikiDocumentation#notification) has more. Using your browser, edit also the [[WebNotify]] topic in all webs and set the users you want to notify.
+* Enable email notification of topic changes, [[TWikiDocumentation]] has more. Using your browser, edit also the [[WebNotify]] topic in all webs and set the users you want to notify.
* Add the [TWiki:Main.PoweredByTWikiLogo](http://TWiki.org/cgi-bin/view/Main/PoweredByTWikiLogo) to your %MAINWEB%.WebHome topic.
* Optional: You can add new rendering rules or new %VARIABLES%. To insure an easy upgrade of TWiki it is recommended to do this customization in `twiki/bin/wikicfg.pm` , not `twiki/bin/wiki.pm` .
@@ -118,6 +120,8 @@ Installation steps:
* In case you want usage statistics for this web: Copy file `WebStatistics.txt` from the `twiki/data/Main` directory to the new data directory. Edit topic WebStatistics in the new web and delete old usage entries.
* Note that user home topics are only located in the %WIKITOOLNAME%.%MAINWEB% web, so don't try to move them or create them in other webs. From any web you can refer to users located in the %WIKITOOLNAME%.%MAINWEB% web like <code>%MAINWEB%.UserName</code> or <code>%MAINWEB%.UserName</code>.
+### <a name="Contents_of_Directories"> Contents of Directories </a>
+
Here are contents of directories showing file permissions. Please note that this is for debugging reasons only and does not exactly reflect the distribution:
Directory `twiki/bin` :
@@ -280,4 +284,4 @@ Directory `twiki/pub/icn/` :
-rw-rw-r-- 1 twiki twiki 152 Mar 9 1999 xls.gif
-rw-rw-r-- 1 twiki twiki 144 Mar 9 1999 zip.gif
--- [[Main/PeterThoeny]] - 29 Dec 2000 <br />
+-- [[PeterThoeny]] - 16 Mar 2001 <br />