diff options
author | MikeMannix <MikeMannix> | 2001-09-15 00:17:23 +0000 |
---|---|---|
committer | MikeMannix <MikeMannix> | 2001-09-15 00:17:23 +0000 |
commit | 8e33b384f6d5e98e39b49bf8e2bbc8c974be43ce (patch) | |
tree | 3ea506303e7ff182c174b83c24d84536a6075d3b /TWiki/TWikiInstallationGuide.mdwn | |
parent | b1118ab23d2d4c2066ec4a56b725365c45e4ea08 (diff) |
none
Diffstat (limited to 'TWiki/TWikiInstallationGuide.mdwn')
-rw-r--r-- | TWiki/TWikiInstallationGuide.mdwn | 10 |
1 files changed, 5 insertions, 5 deletions
diff --git a/TWiki/TWikiInstallationGuide.mdwn b/TWiki/TWikiInstallationGuide.mdwn index b6e17ec7..011b4be6 100644 --- a/TWiki/TWikiInstallationGuide.mdwn +++ b/TWiki/TWikiInstallationGuide.mdwn @@ -12,7 +12,7 @@ These installation steps use the Apache web server on Linux as an example. TWiki * * **User `nobody` ** is used for all files manipulated by the CGI scripts (executed by the Web server), and user `twiki` for all other files. Replace user `nobody` with another user if your Web server executes scripts under a different name (default for Debian is `www-data`). Also, you can substitute user `twiki` with your own username. -* * **You have control** over the Web server configuraton files. In case you don't - you may be installing on an ISP-hosted server - follow the steps but use these directories instead: +* * **You have control** over the Web server configuration files. In case you don't - you may be installing on an ISP-hosted server - follow the steps but use these directories instead: <table border="1" cellpadding="1" cellspacing="0"> <tr> @@ -84,14 +84,14 @@ Request and download the TWiki 01-Sep-2001 distribution in Unix ZIP format from ### <a name="Step_2_Check_the_Server_Director"> Step 2: Check the Server Directory Settings </a> * Restart Apache by `/etc/rc.d/rc5.d/S85httpd restart` . -* Test if the `twiki/bin` directory is cgi-enabled: +* Test if the `twiki/bin` directory is CGI-enabled: * Enter the URL of that directory into your browser ( `http://your.domain.com/twiki/bin` ). It is not set correctly as cgi-bin in case you get something like `"Index of /twiki/bin"` . It is OK if you get a message like `"Forbidden. You don't have permission to access /twiki/bin/ on this server."` * Execute the `testenv` script from your browser ( `http://your.domain.com/twiki/bin/testenv` ). It shows a table with all CGI environment variables. It also tests the settings in your <code>**twiki/lib/TWiki.cfg**</code> configuration file, which you will set later on. ### <a name="Step_3_Enable_Perl_File_Permissi"> Step 3: Enable Perl File Permissions </a> * Make sure Perl 5 and the Perl CGI library are installed on your system. Default location of Perl executable is `/usr/bin/perl`. In case Perl is installed in a different location, the first line of all Perl scripts in the <code>**twiki/bin**</code> directory must be changed (alternatively you can create a symbolic link from <code>**/usr/bin/perl**</code> ). - * **IMPORTANT:** On most ISP virtual domain accounts, Perl CGI scripts require a <code>**.cgi**</code> extension to run. Some systems need <code>**.pl**</code>, the regular Perl extension. Change all <code>**twiki/bin**</code> scripts appropriately if necssary. + * **IMPORTANT:** On most ISP virtual domain accounts, Perl CGI scripts require a <code>**.cgi**</code> extension to run. Some systems need <code>**.pl**</code>, the regular Perl extension. Change all <code>**twiki/bin**</code> scripts appropriately if necessary. * To be able to edit the Perl scripts and <code>**.tmpl**</code> files it is necessary to <code>**chown**</code> and <code>**chgrp -R twiki**</code> so all the files have the owner you want. * The CGI scripts execute as <code>**nobody**</code>. Set the file permission of all Perl scripts in the <code>**twiki/bin**</code> directory as executable to <code>**-rwxr-xr-x**</code> (755). * Set the permission of all files below `twiki/data` so that they are writable by user `nobody`. A simple way is to <code>**chmod**</code> them to <code>**-rw-rw-r--**</code> (664) and to <code>**chown**</code> them to <code>**nobody**</code>. @@ -104,7 +104,7 @@ Request and download the TWiki 01-Sep-2001 distribution in Unix ZIP format from * Set the file extension in the `$scriptSuffix` variable to <code>**cgi**</code> or <code>**pl**</code> if required. * Make sure RCS is installed. Set `$rcsDir` in `twiki/lib/TWiki.cfg` to mach the location of your RCS binaries. * 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/lib/TWiki.cfg` accordingly) +* **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 directories to a place where they are not visible, and change the variables in `twiki/lib/TWiki.cfg` accordingly) * Enable email notification of topic changes, [[MonitoringSiteActivity]] has more. * Add the TWiki:Main/PoweredByTWikiLogo to your %MAINWEB%.WebHome topic. @@ -165,4 +165,4 @@ Complete a Standard Installation and your new TWiki site should be up and runnin See [[TWikiDocumentation]] for an installed system snapshot and descriptions of all files in the TWiki 01-Sep-2001 distribution. --- [[MikeMannix]] - 07 Sep 2001 <br /> -- [[Main/PeterThoeny]] - 13 Sep 2001 <br /> +-- [[MikeMannix]] - 14 Sep 2001 <br /> -- [[Main/PeterThoeny]] - 13 Sep 2001 <br /> |