From 8e33b384f6d5e98e39b49bf8e2bbc8c974be43ce Mon Sep 17 00:00:00 2001 From: MikeMannix Date: Sat, 15 Sep 2001 00:17:23 +0000 Subject: none --- TWiki/TWikiInstallationGuide.mdwn | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'TWiki') 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: @@ -84,14 +84,14 @@ Request and download the TWiki 01-Sep-2001 distribution in Unix ZIP format from ### Step 2: Check the Server Directory Settings * 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 **twiki/lib/TWiki.cfg** configuration file, which you will set later on. ### Step 3: Enable Perl File Permissions * 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 **twiki/bin** directory must be changed (alternatively you can create a symbolic link from **/usr/bin/perl** ). - * **IMPORTANT:** On most ISP virtual domain accounts, Perl CGI scripts require a **.cgi** extension to run. Some systems need **.pl**, the regular Perl extension. Change all **twiki/bin** scripts appropriately if necssary. + * **IMPORTANT:** On most ISP virtual domain accounts, Perl CGI scripts require a **.cgi** extension to run. Some systems need **.pl**, the regular Perl extension. Change all **twiki/bin** scripts appropriately if necessary. * To be able to edit the Perl scripts and **.tmpl** files it is necessary to **chown** and **chgrp -R twiki** so all the files have the owner you want. * The CGI scripts execute as **nobody**. Set the file permission of all Perl scripts in the **twiki/bin** directory as executable to **-rwxr-xr-x** (755). * Set the permission of all files below `twiki/data` so that they are writable by user `nobody`. A simple way is to **chmod** them to **-rw-rw-r--** (664) and to **chown** them to **nobody**. @@ -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 **cgi** or **pl** 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:
`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
-- [[Main/PeterThoeny]] - 13 Sep 2001
+-- [[MikeMannix]] - 14 Sep 2001
-- [[Main/PeterThoeny]] - 13 Sep 2001
-- cgit v1.2.3