TWiki


This is how I set up the TWiki site on sage.

Installation

Basically followed instructions at http://twiki.org/cgi-bin/view/TWiki04/TWikiInstallationGuide.

1. Using cpan2tgz, install Perl modules used by TWiki (see System Requirements):

Algorithm::Diff
CGI::Carp
Config
Cwd
Data::Dumper
Error
FileHandle
IO::File
Text::Diff
Time::Local
CGI::Session
CGI::Cookie
Digest::base
Digest::SHA1
Jcode
Locale::Maketext::Lexicon
Net::SMTP
Unicode::Map
Unicode::Map8
Unicode::MapUTF8
Unicode::String
URI

2. Download TWiki-4.0.4.tgz from http://twiki.org.

3. Create directory /usr/local/opt/twiki and unpack TWiki-4.0.4.tgz into it.

4. Set ownership and permissions of files:

cd /usr/local/twiki
chown -R apache: *    # "apache" is the user that apache runs as
chmod -R u+w *

5. Set up TWiki configuration files:

cd /usr/local/opt/twiki/bin
cp LocalLib.cfg.txt LocalLib.cfg
vim LocalLib.cfg
Set twikiLibPath to /usr/local/opt/twiki/lib

cd /usr/local/opt/twiki/lib
cp LocalSite.cfg.txt LocalSite.cfg
vim LocalSite.cfg
Set DefaultUrlHost to http://sage.wingpath.private
Change all occurrences of /home/httpd to /usr/local/opt

cd /usr/local/twiki
cp twiki_httpd_conf.txt twiki_httpd.conf
vim twiki_httpd.conf
Change all occurrences of /home/httpd to /usr/local/opt

6. Edit web server configuration and restart web server:

vim /etc/apache2/httpd.conf
Add following line at end of file:
include "/usr/local/opt/twiki/twiki_httpd.conf
/etc/rc.d/rc.httpd restart

7. Use web browser to view http://sage.wingpath.private/twiki/bin/configure. Deal with any errors or warnings that are displayed, then click next to set up the administrator's password.

8. Use web browser to view http://sage.wingpath.private/twiki/bin/view. This should display the "Welcome to the Main Web" page.

Configuration

Use web browser to view http://sage.wingpath.private/twiki/bin/configure, and set following:

Authentication-LoginManager: TWiki::Client::TemplateLogin
Passwords-PasswordManager: TWiki::Users::HtPasswdUser
Registration-NeedVerification: no
Localisation-UseLocale: yes
Localisation-Site-Locale: en_GB.utf8

Register as a user at TWikiRegistration.

On TWikiAdminGroup page, click edit and set GROUP to list of TWiki users who are allowed administration access.

Creating a new web

I added a separate web for Wiley documents using the form on the ManagingWebs page.