~~~ ~~~ Running the installer ~~~ ~~~

The installer must run as ROOT, with Python 2.7.

If you are installing the Twister Server, you should be connected to internet,
or ELSE, before running the installer, you must manually install :
 - Python-DEV and
 - python-mysql.

The Twister Client doesn't have any required dependencies; pExpect is optional.

The installer will guide you through all the steps, in order.

These are the steps :
1 - Select what you wish to install (client, server, or both)
2 - Select the user you want to install for (if there's only 1 user, this step is skipped)

Twister will be installed in the home of the selected user, in the folder `twister`.
If the folder is already present, you are asked to backup your data in order to continue,
because everything is DELETED, excepting the `config` folder.

Any dependencies that are old, or missing, will be downloaded and installed.
If all the requirements are met, the client or server files are copied, but nothing is installed.


~~~ Twister Framework dependencies ~~~

- Python 2.7 : (www.python.org/)
    - The Central Engine, the Execution Process, the Test Runner, the Resource Allocator
      and the reporting framework are all written in Python;
    - Older python versions are not supported;

- BeautifulSoup : (www.crummy.com/software/BeautifulSoup/)
    - XML and HTML documents parser;
    - BeautifulSoup is included in `trd_party` folder and should not be installed;

- MySQL-python : (mysql-python.sourceforge.net/)
    - Connects to MySQL databases. It is only used by the Central Engine;
    - MySQL-python requires the python2.7-dev headers in order to compile;

- CherryPy : (www.cherrypy.org/)
    - High performance, minimalist Python web framework;
    - CherryPy is used to serve the reports and the Java Applet;

- Mako : (www.makotemplates.org/)
    - Hyperfast and lightweight templating for the Python platform;
    - Mako is used for templating the report pages;

- Beaker : (beaker.readthedocs.org/)
    - Library for caching and sessions, in web applications and stand-alone Python scripts;
    - Beaker is optional; it is used by Mako, to cache the pages for better performance;

- pExpect : (sourceforge.net/projects/pexpect/)
    - Spawn child applications, control them, respond to expected patterns in their output;
    - pExpect is optional; it is used by the Python test cases to connect to FTP/ Telnet;