Wilma Help

Installing Wilma

Linux

Requires:

Python 2.3 or later - usually comes installed on most distributions.
gcc - C++ compiler (needed to create python extension)

Unpack the downloaded file using tar and/or gzip as appropriate. For example:

  tar -xzf Wilma-0.1.1.tar.gz

After changing to the newly created directory, you can run:

  ./setup.py --help install

to get information on the various installation options. Note that setup.py expects python to be in /usr/bin. If it isn't you will either have to edit the first line of setup.py or run these commands as "python setup.py".

In most cases you will only need to run:

  ./setup.py install

if you are installing Wilma as root and wish it to accessible to all users.

If you are installing as an unprivileged user to your home directory, then run:

  ./setup.py install --home ~

Depending on the speed of your machine, it might take a minute or two to compile the C code extension and you may see some warnings from the compiler, which can be ignored in most cases. A file named installed_files.txt will be created which lists all the files installed, which is useful if you wish to uninstall the program.

If you have installed to your home directory, you probably will have to define an environment variable PYTHONPATH so python knows where to look for Wilma. With a bash shell this would be something like:

PYTHONPATH=/home/yourname/lib/python
export PYTHONPATH

You might want to add this to your .bash_profile file. You might also want to add the bin directory in your home directory to your main path if it isn't already.

Windows

Requires:

Python 2.3 or 2.4 - This can be obtained from http://python.org.
The Python for Windows extensions from http://sourceforge.net/projects/pywin32/
Windows XP (probably works fine on Windows 2000 as well).

Both python and the extensions are trivial installs, but be sure that the version (2.3 or 2.4) matches for python, the extensions and Wilma.

To install just run the downloaded executable. Shortcuts will be installed under "All Programs" on your start button for the command line and server versions of Wilma. The server shortcut starts the default local machine only version of the server and loads the Wilma page into your browser (starting it first if necessary).

Mac OS/X

Requires:

OS/X 10.3 or later. (Might work on earlier versions if python 10.3 or later is installed. http://python.org.
Note that Internet Explorer for the Mac will not work with Wilma, but Safari and of course Firefox or Mozilla should work fine.

Prebuilt Application

Most users will probably want to download the prebuilt application. It should be automatically be uncompressed and appear as a disk. Simply drag the Wilma application to whereever you want on your hard disk. Double clicking the resulting Wilma application icon will launch a small server window and place you in your default browser viewing the Wilma browser interface. The server will be run in local user only mode. The equivalent console command would be:

./wilserver.py -b

To run in multiuser mode, you will have to either alter the Wilma.applescript file contained in the application or install from the source distribution.

Source Distribution

Basically follow the instructions for Linux (using the console). If you set it up in your home directory, the PYTHONPATH command will be similar to:

PYTHONPATH=/Users/yourname/lib/python
export PYTHONPATH

and it could be added to your .profile file.