TWiki On Debian Etch

Abstract

I just setup TWiki 4.2 on a minimal installation of debian etch. It is the base of our documentation for all the IT stuff.
The original docu on our wiki is in german. I want to translate it now step by step. Can I also publish the german version here?

The base things

• A minimal debian etch network installation without any user except root
• install less, vim, ntp, openssh-server, openssh-client Yes, the minimal installation is without less an ssh
• install apache
  • Cause the site will also host other sites, I install libapache2-mod-php5

aptitude install libapache2-mod-php5 

Installation TWiki

Install additional packages and configure

• I want the german userinterface cause my colleagues never see a wiki. So I must reconfigure the locales with dpkg-reconfigure locales and choose de_DE ISO-8859-1, de_DE.UTF-8.UTF-8, de_DE@euro ISO-8859-15. de_DE.UTF-8 UTF-8 as standard.
  • for additional docu see nstallationWithI18N
• And a few packages for perl

aptitude install patch rcs libarchive-tar-perl libapache-htpasswd-perl libdigest-sha1-perl /
libfreezethaw-perl libhtml-tree-perl unzip lynx ncftp ftp curl libunicode-maputf8-perl /
libwww-perl libnet-smtpauth-perl

Base install

• Like TWikiInstallationGuide

mkdir /Quellen
cd /Quellen
mkdir downloads-twiki
cd downloads-twiki
wget http://twiki.org/p/pub/Codev/Release/TWiki-4.2.0.tgz
mkdir /var/www/twiki
cd /var/www/twiki/
tar xvzf /Quellen/downloads-twiki/TWiki-4.2.0.tgz
chown -R www-data:www-data /var/www/twiki
cp -a bin/LocalLib.cfg.txt bin/LocalLib.cfg 

• In /var/www/twiki/bin/LocalLib.cfg edit the twikiLibPath to /var/www/twiki/lib";
• Go to ApacheConfigGenerator and make a apache config
• Paste the contents to the new file /etc/apache2/conf.d/twiki.conf
• restart apache.

Configure it

• Go to http://your.domain.name/twiki/bin/configure
• The first time you visit this page you can only edit the path settings.
  • Normaly all is okay -> klick next and save it
• Go again to http://your.domain.name/twiki/bin/configure
  • This is for the german user interface
  • Under Localisation
    • {UserInterfaceInternationalisation} on
    • Turn off all languages except german
    • {DisplayTimeValues} to servertime
    • {UseLocale} on
    • {Site}{Locale} to de_DE.iso885915@euro
  • Under security I want the apache login manager
    • {LoginManager} auf Apache Login
  • Under Mail and Proxies
    • {WebMasterEmail} set it to your mailaddress
    • {SMTP}{MAILHOST} your mailserver
    • {SMTP}{SENDERHOST} your wiki server name
    • {SMTP}{Username} Only if you need it for sasl (smtpauth)
    • {SMTP}{Password} Only if you need it for sasl

Make yourself admin

• got to http://your.domain.name/twiki/bin/view
• register yourself
  • mail working?
• Goto http://your.domain.name/twiki/bin/view/Main/TWikiAdminGroup and follow the instructions

cronscripts and sessions

• Goto http://your.domain.name/twiki/bin/configure
  • Under Security setup
    • {Sessions}{ExpireAfter} -1

• Cronscripts for Mail, Statistics and auto session expire
  • add the following to /etc/crontab

00 2   * * *   root    cd /var/www/twiki && perl -I bin tools/mailnotify -q
10 2    * * *   www-data cd /var/www/twiki/bin && ./statistics >/dev/null 2>&1
00 0    * * *   www-data cd /var/www/twiki && perl -I bin tools/tick_twiki.pl >/dev/null 2>&1

Extensions / Plugins

• On our firewall we have a forwarding for tcp_ port 80 to our proxy
  • After try 3 hours download extensions with different configs I gave up and turn the forwarding off for the IP of twiki.org
  • If anyone have a solution please comment or mail it.

raw edit

• IN TWiki 4.2 TinyMCEPlugin is the default editor
  • I want the rawedit back but only for me
• add Set TINYMCEPLUGIN_DISABLE = on to your Personal Preferences
  • this disable TinyMCEPlugin for you

The End

Any comments and suggestions welcome.

-- Contributors: OlafBerg - 20 Mar 2008

Discussion