Download
nicer version, with sample scripts
versione più carina, con script di esempio
Prerequisites
Most of the following software is usually already present or available for installation thru the native mechanism of your GNU/Linux distribution.
That is not the common case for M$-Windows.
Python >= 2.4 (NOT 3.0!)
First of all you need to install Python: I'm fairly confident that SoL correctly runs with either Python 2.4 or 2.5, I didn't tried Python 2.6 yet, so I recommend sticking with 2.5.
Grab the installer that best fits your operating system from http://www.python.org/download/.
Reportlab 2.2
PIL 1.6
Easy Install
SoL
In the Python world extension modules are often distribuited as .egg files: they are a standard ZIP archive containing everything needed by the module.
The EGG
The easiest way to install SoL is by using easy_install:
- Unix
-
$ easy_install http://darcs.arstecnica.it/our/sol/dist/SoL-1.3.5-py2.5.egg
- M$-Windows
-
C:\> C:\Python25\Scripts\easy_install.exe http://darcs.arstecnica.it/our/sol/dist/SoL-1.3.5-py2.5.egg
issued on the command prompt (StartMenu -> Exec... -> cmd).
Of course these are just examples: you should replace "1.3.5" with the actual latest&greatest version of SoL!.
The repository
Another option is to check out the in development tree, using darcs:
$ darcs get http://darcs.arstecnica.it/our/sol
and then going the standard route:
$ python setup.py install
cjson
SoL requires a patched version of cjson able to deal with datetime values. If everything goes smoothly, the steps above should install this automatically.
- GNU/Linux 32bit egg
- http://darcs.arstecnica.it/our/cjson-1.0.5-datetime/eggs/python_cjson-1.0.5_datetime-py2.5-linux-i686.egg
- GNU/Linux 64bit egg
- http://darcs.arstecnica.it/our/cjson-1.0.5-datetime/eggs/python_cjson-1.0.5_datetime-py2.5-linux-x86_64.egg
- MacOSX 10.3 egg
- http://darcs.arstecnica.it/our/cjson-1.0.5-datetime/eggs/python_cjson-1.0.5_datetime-py2.5-macosx-10.3-i386.egg
- Win32 egg
- http://darcs.arstecnica.it/our/cjson-1.0.5-datetime/eggs/python_cjson-1.0.5_datetime-py2.5-win32.egg
Post-installation and setup
ExtJS
Once SoL is properly installed you need to download the ExtJS framework. This is as easy as executing
- Unix
-
$ python -m sol.websetup
- M$-Windows
-
C:\> C:\Python25\python.exe -m sol.websetup
This will actually download a ZIP file from the ExtJS site, unpacking it in the right place.
Configuration
Create a new directory that will host the instance of the application, say my-sol
mkdir my-sol cd my-sol
Obtain a standard config file
- Unix
-
$ paster make-config SoL config.ini
- M$-Windows
-
C:\my-sol\> C:\Python25\Scripts\paster.exe make-config SoL config.ini
and edit it as appropriate: the default configuration is almost correct, so you can actually use it as-is.
Setup the application
- Unix
-
$ paster setup-app config.ini
- M$-Windows
-
C:\my-sol\> C:\Python25\Scripts\paster.exe setup-app config.ini
Finally run the application server
- Unix
-
$ paster serve config.ini
- M$-Windows
-
C:\my-sol\> C:\Python25\Scripts\paster.exe serve config.ini
and enjoy the visit with your preferred browser
- Unix
-
$ firefox http://localhost:6996/
- M$-Windows
-
C:\> C:\Python25\python.exe -m webbrowser http://localhost:6996/
