Set up a TWiki VM with Virtual Box and CentOS 6.3 / 64 Bit minimal

Create and configure the VM:

Using Virtual Box on MacOS/X (Mountain Lion)

• Create new VM (Linux/!RedHat 64 bit)
• Name: TWiki - 60 GB disk (dynamic growth, min 2 GB)
• 2 MB memory (min 512 MB)
• Network devices NAT
• internal, connected
• Launch from CentOS-6.3-x86_64-minimal.iso
• Activate eth0 + eth1 with DHCP

ifconfig -a --> IP addresses: 10.0.2.15 + 192.168.243.101

Basic setup of CentOS:

yum update
yum install wget
yum install perl
yum install rcs
yum install zip
yum install unzip
yum install httpd
chown apache:apache /var/www/html
yum install make
yum install gcc
yum install gd
yum install gd-devel
yum install php

vi /etc/sysconfig/iptables
  ... add the following lines after "-A INPUT ... dport 22 ...":
-A INPUT -m state --state NEW -m tcp -p tcp --dport 80 -j ACCEPT
-A INPUT -m state --state NEW -m tcp -p tcp --dport 443 -j ACCEPT

/etc/init.d/iptables restart
chkconfig --level 2345 httpd on

Install Perl modules for TWiki

First some modules with yum

yum install perl-CPAN
yum install perl-CGI
yum install perl-YAML
yum install perl-IPC-Cmd
yum install perl-Module-CoreList
yum install perl-ExtUtils-CBuilder
yum install perl-Module-Build

Then use CPAN to get the latest and the rest

In the next step you will see messages like "Shall I follow ... right now? [yes]" or "Enter arithmetic or Perl expression: exit". You can simply press <return>.

perl -MCPAN -e shell
  install Term::ReadKey
  install Bundle::CPAN
  reload cpan
  install Encode
  install Error
  install HTML::Parser
  install Text::Diff
  install Time::Local
  install Authen::SASL
  install CGI::Session
  install Digest::SHA1
  install Locale::Maketext::Lexicon
  install URI
  install FreezeThaw
  install GD
  install HTML::Tree
  install Time::Timezone
  install Unicode::MapUTF8
  install Encode::compat

Download and install TWiki

cd /var/www/html
wget http://freefr.dl.sourceforge.net/project/twiki/TWiki%20for%20all%20Platforms/TWiki-5.1.1/TWiki-5.1.1.tgz
tar xvfz TWiki-5.1.1.tgz 
chown -R apache:apache twiki

cp twiki/bin/LocalLib.cfg.txt twiki/bin/LocalLib.cfg
chown apache:apache twiki/bin/LocalLib.cfg

Basic TWiki configuration

vi twiki/bin/LocalLib.cfg
  ... set $twikiLibPath = "/var/www/html/twiki/lib";

cp twiki/twiki_httpd_conf.txt /etc/httpd/conf.d/twiki_httpd.conf

... I'm using username "root" for access control

cd twiki/data
htpasswd -c .htpasswd root
  set password
chown apache:apache .htpasswd

vi /etc/httpd/conf.d/twiki_httpd.conf
  :%s_/home/httpd_/var/www/html_g
  :%s/JohnDoe/root/g
  ... go to section starting "<FilesMatch "^configure.*">"
  ... replace "Allow from 127.0.0.1 192.168.1.10" if you run configure from another address
      ... for example "Allow from all"

/etc/init.d/httpd restart

Continue with web based configuration as per documentation

--> http://192.168.243.101/twiki/bin/configure

Next Steps

This is a very basic installation:

• DHCP only (can be modified in /etc/sysconfig/network-scripts/ifcfg-eth0 and ifcfg-eth1)
• Unpolished Apache configuration (see detailed hints in TWikiOnRedHat)
• Running in VirtualBox UI - to run it in the background use
  • nohup VBoxHeadless --startvm TWiki --vrdp on & to start,
  • VBoxManage controlvm TWiki savestate to put it to sleep,
  • VBoxManage controlvm TWiki resume to wake it up again.

http://twiki.org/cgi-bin/view/Support/SID-01452

   Header set X-UA-Compatible "IE=EmulateIE8"

-- Contributors: ThomasGutzmann - 2012-08-23

Discussion

Thank you Thomas for contributing this doc!

-- PeterThoeny - 2012-08-23