Creation log for TWiki vm (Debian stable)

The TWiki vm based on Debian stable can be found at TWikiVMDebianStable, this is a log on its creation.

The vm is based on a Debian stable CD image (ISO image) downloaded from http://cdimage.debian.org/debian-cd/3.1_r1/i386/iso-cd/debian-31r1a-i386-netinst.iso.

Installation

1. Boot the downloaded Debian ISO image
2. type linux26 at boot prompt for 2.6 kernel install
3. English / American settings for language / country / keymap
4. Hostname: twiki-vm, Domain name: .lan
5. Erase entire disk -> Std. partitioning and swap layout - all files in one partition
6. Wait while installing base installation
7. Install GRUB boot loader
8. Choose apt-mirror: http / mirrors.kernel.org
9. Software selection: none (to keep vm package small)
10. Reboot
11. Log in as root
12. apt-get install apache2 samba
13. Samba Workgroup: workgroup
14. apt-get install libcgi-session-perl libdigest-sha1-perl libhtml-fromtext-perl libhtml-parser-perl
15. dpkg-reconfigure locales (select all locales, default locale en_US)

Samba setup

Replace content in /etc/samba/smb.conf with these lines (purpose of this configuration is to make everything as easy as possible for Windows users):

[global]
   workgroup = workgroup
   server string = %h server (Samba %v)
   dns proxy = no
   log file = /var/log/samba/log.%m
   max log size = 10000
   security = user

[root]
   browseable = yes
   writable = yes
   delete readonly = yes
   path = /
   veto oplock files = /*.*/
   hide dot files = no
   guest only = yes
   public = yes
   create mask = 0755
   directory mask = 0755
   force user = root
   force group = root

[twiki]
   browseable = yes
   writable = yes
   delete readonly = yes
   path = /home/httpd/twiki
   veto oplock files = /*.*/
   hide dot files = no
   guest only = yes
   public = yes
   create mask = 0755
   directory mask = 0755
   force user = www-data
   force group = www-data 

This creates two shares, one for "root work" and one for "twiki work".

Apache setup

Replace /etc/apache2/sites-available/default with the following content:

NameVirtualHost *
<VirtualHost *>
   ServerAdmin webmaster@localhost

   ErrorLog /home/httpd/twiki/apache-logfiles/error.log
   CustomLog /home/httpd/twiki/apache-logfiles/access.log combined
 
   DocumentRoot /home/httpd/twiki
   Options ExecCGI Indexes Includes FollowSymLinks MultiViews 
   Include /home/httpd/twiki/twiki_httpd.conf
</VirtualHost> 

TWiki setup

1. Create /home/httpd/twiki and /home/httpd/twiki/apache-logfiles and set permissions (chown -R www-data:www-data /home/httpd)
2. Unzip TWiki release to /home/httpd/twiki
3. cp /home/httpd/twiki/twiki_httpd_conf.txt /home/httpd/twiki/twiki_httpd.conf
4. Follow standard TWiki setup procedure
5. replace shebang line in the bin/view scripts to use speedy_cgi

Comments / Questions

What is necessary to get X11 support on this build such that PNG images can be supported for Plugins.EasyTimelinePlugin and other graphic plugins including Plugins.PloticusPlugin?

-- WinWorcester - 22 May 2006

I'm guessing these instructions are not 100% complete - I'll start by using the existing vm.

-- SvenDowideit - 08 May 2008