Difference: TWikiInstallationGuide (18 vs. 19)

Revision 192001-03-16 - PeterThoeny

Line: 1 to 1
Added:
>
>

TWiki Installation Notes

 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.

Line: 10 to 12
 
twiki/templates web templates outside of htdoc tree (for security) /home/smith/twiki/templates
Read http://TWiki.org/cgi-bin/view/Codev/SourceForgeHowTo in case you want to install TWiki on SourceForge.
Changed:
<
<
Installation steps:
>
>

Installation steps

 
  • 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.
Line: 51 to 53
 
    • 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:
    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)
Changed:
<
<
>
>
 
  • 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 .
Line: 88 to 90
 
    • 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 TWiki.Main 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 TWiki.Main web like Main.UserName or %MAINWEB%.UserName.
Added:
>
>

Contents of Directories

 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 :

Line: 270 to 274
 -rw-rw-r-- 1 twiki twiki 144 Mar 9 1999 zip.gif
Changed:
<
<
-- PeterThoeny - 29 Dec 2000
>
>
-- PeterThoeny - 16 Mar 2001
 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 1999-2024 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback
Note: Please contribute updates to this topic on TWiki.org at TWiki:TWiki.TWikiInstallationGuide.