Version 21 of About this site

Updated 2003-11-12 18:04:45

June 2002 - time to update this info a bit...


This site is hosted by an ISP called "Rackspace" [L1 ], located in San Antonio, TX. 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 Tokelai).

Hardware

The machine is a P5/800 running Unix, and is well-connected to the internet (a couple of TS3's etc). P5? Operating system

The site is a virtual host running under RedHat 7.2, the webserver is Apache 1.3.22.

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 June 2002 (Tcl/Tk 8.4a5 based) version of TclKit, with the built-in MetaKit version 2.4.7 database taking care of storage and searching.

WiKit implementation

WiKit is 5,000 lines of Tcl (half of it is Don Libes' CGI 1.6 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 also being used on Windows, Solaris, and MacOS X.

Obtaining the WiKit software

There are downloads of Wikit at http://www.equi4.com/wikit/ and several builds of TclKit at http://www.equi4.com/tclkit/ . There are also single-file ready-to-run executable versions for several platforms, see [L2 ].

You can obtain an on-the-fly snapshot of this Tcl'ers Wiki from http://mini.net/cgi-bin/wikit.gz - get the wikit.bin package 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