Version 24 of About this site

Updated 2003-11-27 16:42:51

November 2003 - time to update this info a bit...


This site is hosted by an ISP called "IPX Server" [L1 ], located in Nürnberg, Germany. Its domain name has been set up as mini.net. It also has a "persistent url": http://purl.org/tcl/wiki/ and a rad cool redirect: http://wiki.tcl.tk/ (yes, there's a Tokelau [L2 ]).

With thanks to the previous provider, Rackspace (TX, US), whose server hosted mini.net for many years. I hope the coming years will be just as stable and will serve us as well, for years to come. The site has plenty of cpu cycles, disk space, and bandwidth to spare (and upgrades are an email away). It is intended to be a long-term setup, just like the previous spot.

Hardware

The machine is a Pentium/700 running Unix, and is well-connected to the internet (a couple of TS3's etc).

Operating system

This Tclers' Wiki site is part of mini.net, is a virtual host running under SuSE 8.2, the webserver is Apache 1.3.27.

Software

These pages use Wikit through CGI (it can also be used in a local Tk mode). Each page access used to launch a new process, and the machine performed amazingly well. Nowadays, most accesses don't even get this far because there is a static page cache for all pages. This was added in 2001 to cope with arbitrary load (and spiders and web-grabbers).

Wikit is powered by the March 2003 (Tcl/Tk 8.4.4 based) version of Tclkit, with the built-in Metakit version 2.4.9.2 database taking care of storage and searching.

Wikit implementation

Wikit is a few thousand lines of open-source Tcl (half of it is Don Libes' CGI 1.6.1 script package). In this most recent release of wikit, all scripts are stored as a single starkit file, while all pages are stored as a second Metakit datafile (it's not using VFS to get better search performance from Metakit).

Wikit is portable, it's being used on Windows, Linux, MacOS X, and a whole slew of other machines.

Obtaining the Wikit software

See the home page of Wikit at http://www.equi4.com/wikit.html - there are also single-file ready-to-run executable versions (starpacks) for several platforms, see [L3 ].

You can obtain an on-the-fly snapshot of this Tcl'ers Wiki from http://mini.net/cgi-bin/wikit.gz - get the wikit.kit starkit and Tclkit, and you'll have a pretty effective way of accessing and searching all the knowledge in this wiki off-line.

-jcw


Running your own local copy of the Tcl Wiki

Here's my cookbook approach to acquiring the necessary files to run your own copy of the Tcl Wiki on your own server. This was last updated on 15 July 2003.

Assumptions:

  • Apache Web Server
  • UNIX Operating System
  • Your version of the Wiki will be accessed from this URL: http://www.foobar.com/tcl/wiki
  • Your htdocs root is /usr/local/apache/www/

Download these files:

In your htdocs directory, create the tcl/wiki directory:

  • cd /usr/local/apache/www
  • mkdir -p tcl/wiki

Copy the 3 downloaded files to /usr/local/apache/www/tcl/wiki and uncompress as necessary.

Rename wikit to wikit.tkd

In the tcl/wiki directory, create a shell script called 'wiki'

  #!/bin/sh
  WIKIT_BASE=http://www.foobar.com/tcl/wiki
  export WIKIT_BASE
  exec /usr/local/apache/www/tcl/wiki/tclkit wikit.kit wikit.tkd

Set permissions for wikit.tkd to 0777, and wiki to 0555.

Add this entry in your httpd.conf and restart Apache:

  <Directory "/usr/local/apache/www/tcl/wiki">
      options ExecCGI
      SetHandler cgi-script
      Allow from all
  </Directory> 

That's it. Enter http://www.foobar.com/tcl/wiki in your favorite browser and surf away.

Marty Backe - 14 Jul 2002


TR 13 Jan 2003 - I found the above description of setting up the wiki was not working for me. The WIKIT_BASE had to be set up as

 WIKIT_BASE=http://www.foobar.com/tcl/wiki/
 export WIKIT_BASE

Note the slash at the end, which was needed, otherwise it wouldn't work.


Category Tcler's Wiki Category Wikit