| | |
|
TWikiInstallationGuide 18 - 26 Feb 2001 - Main.PeterThoeny
|
| |
Note: The ScriptAlias must come before the Alias in Apache, otherwise it will fail to correctly set up /twiki/bin/ , due to the fact that it sees that as being just another subdirectory of the /twiki/ alias.
| |
<
< | Alias /twiki/ "/home/httpd/twiki" | >
> | Alias /twiki/ "/home/httpd/twiki/" | | | <Directory "/home/httpd/twiki/bin">
Options +ExecCGI
SetHandler cgi-script |
|
|
TWikiInstallationGuide 17 - 30 Dec 2000 - Main.PeterThoeny
|
| |
-
- If needed, create customized templates in the new templates directory. (Non existing templates are inherited from
twiki/templates )
- If you want to use a category table, copy the three files
twikicatitems.tmpl , twikicatedit.tmpl and twikicatview.tmpl from the twiki/templates/Know directory to the new templates directory, and customize it. More on that in TWiki Category Table.
- 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.
| | | Here are contents of directories showing file permissions. Please note that this is for debugging reasons only and does not exactly reflect the distribution: | | | -rw-rw-r-- 1 twiki twiki 144 Mar 9 1999 zip.gif
| |
<
< | -- PeterThoeny? - 24 Nov 2000
| >
> | -- PeterThoeny? - 29 Dec 2000
|
|
|
TWikiInstallationGuide 16 - 11 Dec 2000 - Main.PeterThoeny
|
| |
- Make sure PERL 5 and the PERL CGI library is 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 need to be changed (alternatively you can create a symbolic link from /usr/bin/perl ).
- 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 scripts execute as
nobody . Set the file permission of all Perl scripts in the twiki/bin directory as executable to -rwxr-xr-x .
| |
<
< |
- Set the file permission of all files below
twiki/data to 666 ( -rw-rw-rw- ).
- Set the file permission of the
twiki/data directory and all its subdirectories to 777 ( drwxrwxrwx ).
- Set the file permission of the
twiki/pub directory to 777 ( drwxrwxrwx ).
| >
> |
- 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 666 ( -rw-rw-rw- ).
- Set the permission of the
twiki/data directory and all its subdirectories so that files in there are writable by user nobody. A simple way is to chmod them to 777 ( drwxrwxrwx ).
- Set the permission of the
twiki/pub directory and all its subdirectories so that files in there are writable by user nobody. A simple way is to chmod them to 777 ( drwxrwxrwx ).
| | |
- Edit the file
twiki/bin/wikicfg.pm and set the variables at the beginning of the file to your needs.
- Make sure RCS is installed. Set
$rcsDir in twiki/bin/wikicfg.pm to mach the location of your RCS binaries.
- Point your browser at http://your.domain.com/twiki/bin/view and start TWiki-ing away!
|
|
|
TWikiInstallationGuide 15 - 29 Nov 2000 - Main.PeterThoeny
|
| |
- Edit the file
twiki/bin/wikicfg.pm and set the variables at the beginning of the file to your needs.
- Make sure RCS is installed. Set
$rcsDir in twiki/bin/wikicfg.pm to mach the location of your RCS binaries.
- Point your browser at http://your.domain.com/twiki/bin/view and start TWiki-ing away!
| |
>
> |
- Using your browser, edit the TWikiPreferences topic in the TWiki.TWiki web to set the WIKIWEBMASTER email address, the WEBCOPYRIGHT message and other preferences.
| | |
- Note in case the cgi scripts must have a file extension like
.pl or .cgi:
- Add the extension to all the scripts (except for the
.pm ones) in twiki/bin
- Edit
wikicfg.pm and set the file extension in the $scriptSuffix variable.
- 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
| >
> |
- 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)
| |
<
< | | >
> |
- Enable email notification of topic changes, Notification of Changes has more. Using your browser, edit also the WebNotify topic in all webs and set the users you want to notify.
| | |
- 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 .
|
|
|
TWikiInstallationGuide 14 - 25 Nov 2000 - Main.PeterThoeny
|
| |
- Now add
ScriptAlias for /twiki/bin and Alias for /twiki to file httpd.conf .
Note: The ScriptAlias must come before the Alias in Apache, otherwise it will fail to correctly set up /twiki/bin/ , due to the fact that it sees that as being just another subdirectory of the /twiki/ alias.
- Here are example
httpd.conf entries:
| |
<
< | ScriptAlias /twiki/bin/ "/home/httpd/twiki/bin/"
Alias /twiki/ "/home/httpd/twiki/pub/"
| >
> | ScriptAlias /twiki/bin/ "/home/httpd/twiki/bin/"
Alias /twiki/ "/home/httpd/twiki"
| | | <Directory "/home/httpd/twiki/bin">
Options +ExecCGI | |
<
< | SetHandler? cgi-script | >
> | SetHandler cgi-script | | | Allow from all
</Directory>
<Directory "/home/httpd/twiki/pub"> | |
<
< | Options FollowSymLinks? +Includes
AllowOverride? None | >
> | Options FollowSymLinks +Includes
AllowOverride None | | | Allow from all
</Directory>
- Restart Apache by
/etc/rc.d/rc5.d/S85httpd restart .
| | | -rw-rw-r-- 1 twiki twiki 144 Mar 9 1999 zip.gif
| |
<
< | -- PeterThoeny? - 13 Nov 2000
| >
> | -- PeterThoeny? - 24 Nov 2000
|
|
| Revision 18 | r18 - 26 Feb 2001 - 17:53:31 - PeterThoeny? |
| Revision 17 | r17 - 30 Dec 2000 - 07:58:31 - PeterThoeny? |
| Revision 16 | r16 - 11 Dec 2000 - 00:56:49 - PeterThoeny? |
| Revision 15 | r15 - 29 Nov 2000 - 02:39:21 - PeterThoeny? |
| Revision 14 | r14 - 25 Nov 2000 - 08:11:28 - PeterThoeny? |
| Revision 13 | r13 - 14 Nov 2000 - 02:19:16 - PeterThoeny? |
|
|
|
This site is powered by the TWiki collaboration platform.
All material on this collaboration platform is the property of the contributing authors.
All material marked as authored by Eben Moglen is available under the license terms CC-BY-SA version 4.
|
|
| | |