2) Installing APyaX

2.1) Prerequisites

APyaX requires Python 2.5 to be installed on the server. Python can be downloaded from

http://www.python.org

You can also download binary distributions for a variety of platforms from ActiveState:

http://www.activestate.com/Products/activepython/

Operating system providers also usually offer the option of installing Python, for example by using apt-get on Debian based linux systems.

The "python" command should be installed on your path. To check, try to execute the command "python -V" to print the python version number.

2.2) Installation Steps

This is as simple as uncompressing and untarring the velocikit package after downloading it from SourceForge:

http://sourceforge.net/projects/velocikit

The package can be unpacked using the following commands

gunzip VelociKit-0.4.tar.gz

tar xvf VelociKit-0.4.tar


This should create a sub-directory VelociKit-0.4. Run the distutils setup script to install VelociKit, including the APyaX dispatcher and generator


cd VelociKit-0.4/src/

python setup.py install


2.3) Running the APyaX Examples

The examples included with the APyaX package demonstrate the basic capabilities of APyaX. To run an example, open a shell and go to either of the following directories...

cd VelociKit-0.4/web/

...and execute

./run.sh

This script will first invoke another script, build.sh, to run the generator tool and convert .phtml files (source XHTML files which reference python scripts) into ready-to-deploy .html files. Then run.sh will start a basic web server to serve the files and run python scripts.

Once the basic web server is running, point your browser at http://localhost:8080 to load a root page with links to various VelociKit examples including:

Hello World

calls python on the server to retrieve a localized greeting

Simple Tutorial

a simple example which queries the python server environment and displays details in the web browser

Examples

A number of different examples demonstrate a range of APyaX features