Slion.net>Dev>TWiki04x02WindowsInstallationGuide

TWiki 4.2 Windows Installation Guide

Purpose & Scope

This is a step by step TWiki 4.2 Windows installation guide. It should have you running your own TWiki in no time. However security issues and advance settings are out of scope. We will take you through Apache2, Perl and TWiki installation. Basic Apache administration skills could be useful but not strictly required. Basic computer administration skills are assumed.

You've been warned

TWiki is really straightforward to set-up on Windows; however for obvious performance and security reasons we don't recommend you use Windows to run production TWiki server.

Prerequisites

We applied this guide on an x86 machine running Windows XP SP2 yet it should be valid for most Windows installation.

Downloads

• Download the latest Apache2 release. We used apache_2.2.8-win32-x86-no_ssl.msi.
• Download the ActivePerl version of your choice. We used ActivePerl-5.8.8.822-MSWin32-x86-280952.msi
• Download TWiki 4.2 zip file or get the latest TWiki:Codev.DownloadTWiki

Installations

• Install Apache2. Using the default installation settings is just fine.
• Install ActivePerl. Here again using the default installation settings should work just fine.
• Unzip your TWiki release and put it's content on a path without space characters. C:/www/twiki will do just fine.

TWiki configuration

• Go to C:\www\twiki\bin and copy/rename LocalLib.cfg.txt to LocalLib.cfg.
• Edit LocalLib.cfg and replace the line $twikiLibPath = "/absolute/path/to/your/lib"; by $twikiLibPath = "C:/www/twiki/lib";.
• Open a command prompt cmd.exe .
• Go to C:\www\twiki\bin.
• Run perl ..\tools\rewriteshbang.pl.
• Specify C:\Perl\bin\perl.exe at the prompt and confirm.
• Go to C:\www\twiki\tools.
• Run perl rewriteshbang.pl.
• Specify C:\Perl\bin\perl.exe at the prompt and confirm.

Apache2 configuration

• Go to TWiki:TWiki.ApacheConfigGenerator. Correct the settings to suite your specifics or just copy the content of your twiki.conf from that page and put it in C:\Program Files\Apache Software Foundation\Apache2.2\conf\twiki.conf.
• Open C:\Program Files\Apache Software Foundation\Apache2.2\conf\httpd.conf and add the line Include conf/twiki.conf at the very end.
• Restart your Apache server using the service manager or the Apache tray icon.

More TWiki configuration

• Go to http://localhost/twiki/bin/configure.
• You should get 12 warnings in the General path settings section.
• Open the General path settings section.
• Fix the path containing backslashes (\) by replacing them with Linux-like slash (/).
• Click the Next button.
• Enter a new password, confirm and click Change Password and Save button.
• Follow the Return to configuration link.
• Now you should get 52 errors and two warnings.
• Open the Security setup section and select the option none for {LoginManager}.
• Open the Store settings section and select the option RcsLite for {StoreImpl}.
• Open the Mail and Proxies section and provide your email address in the {WebMasterEmail} field.
• Clik the Yes, I've read all the documentation button at the top of the page.
• Clik the Open all options button.
• Search for the {RCS}{SearchAlgorithm} option in the Store settings section and select TWiki::Store::SearchAlgorithms::PurePerl.
• Click the Next button, provide your password and save.
• Follow the Go to the TWiki front page link.

Congratulations

You are done!

Happy TWiki

-- StephaneLenclud - 08 Feb 2008