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 update
13. apt-get dist-upgrade (to make sure you have the latest security updates)
14. apt-get install apache2 samba
15. Samba Workgroup: workgroup
16. apt-get install libcgi-session-perl libdigest-sha1-perl libhtml-fromtext-perl libhtml-parser-perl
17. 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'd start by using the existing vm.

-- SvenDowideit - 08 May 2008

didn't have time in May, and now I'm following these instructions, but basing it on JeOS 8.4.1, and using my debian TWiki packages to install TWiki and plugins.

-- SvenDowideit - 22 Oct 2008

Sven, shall TWikiVMJeOS replace TWikiVMDebianStable? If not, why the duplication? Of course I appreciate your efforts of trying to provide an easier updateable package. Thanks to you, and thanks to Steffen who first provided the very successful TWikiVMDebianStable package. Great jobs! Made getting TWiki up and running a snap.

-- FranzJosefGigler - 22 Oct 2008

I suspect it will replace it, but as I just built it today, I'm not going to rush until I get some feedbacks

-- SvenDowideit - 22 Oct 2008