Mercurial > libervia-backend
annotate INSTALL @ 1193:226c4c28cf64
SàT 0.5.0 released
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Tue, 09 Sep 2014 08:15:35 +0200 |
| parents | 4c6bc3454780 |
| children | 101c06fbda31 |
| rev | line source |
|---|---|
| 885 | 1 You can install SàT automatically using easy_install or pip, and it is available in several GNU/Linux distributions. The full instructions are available on the wiki: http://wiki.goffi.org/wiki/Salut_%C3%A0_Toi |
| 2 Below is are installation instructions, but check wiki which may be more up-to-date | |
| 3 | |
|
587
952322b1d490
Remove trailing whitespaces.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
548
diff
changeset
|
4 *** |
| 885 | 5 |
| 6 You can automatically install SàT and his dependencies using easy_install or pip. You will however need to install Python's headers (needed to build some packages), WxPython which is available in most Gnu/Linux distributions, PyGObject and developments version of libxml2 and libxslt (to compile lxml python library). | |
| 7 | |
| 1191 | 8 NOTE: pyfeed are xe are mandatory dependencies, they should be on http://pypi.python.org (PYthon Package Index, the officiel repository for Python projects) and so being automatically installed; but there are not yet there (their author should do it soon), so you have to install them manually until then. |
| 9 You can download them respectively on http://www.blarg.net/%7Esteveha/pyfeed-0.7.4.tar.gz and http://www.blarg.net/%7Esteveha/xe-0.7.4.tar.gz, then decompress them and do « python setup.py install » on both. | |
| 10 An other way is to use the (unsecure) pip options --process-dependency-links and --allow-all-external when installing sat, options which are or will be removed soon from pip. | |
| 11 | |
| 12 | |
| 885 | 13 The environment variable SAT_INSTALL customise the installation, it contains flags separated by spaces: |
| 14 - "nopreinstall" skip all preinstallation checks | |
| 15 - "autodeb" automatically install missing packages on Debian based distributions | |
| 16 - "nox" disable installation of X based packages (WxWidgets), this is useful for servers | |
| 17 | |
| 18 WxPython and PyGobject are automatically installed on Debian based distributions if "autodeb" option is set. Indeed, on Debian based distribution, you can type (with the root account): | |
| 19 | |
| 20 # apt-get install python-pip python-dev libxml2-dev libxslt-dev | |
| 21 # SAT_INSTALL=autodeb pip install . | |
| 22 | |
| 23 On a *buntu, same commands with sudo: | |
| 24 | |
| 25 $ sudo apt-get install python-pip python-dev libxml2-dev libxslt-dev | |
|
1100
2be46f391cfa
setup: SAT_INSTALL environment variable handles "clean" and "purge" options
souliane <souliane@mailoo.org>
parents:
885
diff
changeset
|
26 $ sudo SAT_INSTALL=autodeb pip install . |
| 885 | 27 |
| 28 | |
| 29 After installing SàT, you need to install the media: | |
| 30 | |
| 31 $ mkdir -p ~/sat/media/destination/path | |
| 32 $ cd ~/sat/media/destination/path | |
| 33 wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2 | |
| 34 tar -jxvf sat_media.tar.bz2 | |
| 35 | |
| 36 then, create a ~/.sat.conf file which contains: | |
| 37 | |
| 38 ### sat.conf ### | |
| 39 [DEFAULT] | |
| 40 media_dir=~/sat/media/destination/path | |
| 41 ### end sat.conf ### | |
| 42 | |
| 43 Of course, replace ~/sat/media/destination/path with the actual path you want to use. | |
| 44 | |
| 45 You should now be able to launch sat: | |
| 46 - to launch the backend, enter | |
| 47 $ sat | |
| 48 - to stop the backend, enter: | |
| 49 $ sat stop | |
| 50 - to launch Primitivus, enter: | |
| 51 $ primitivus | |
| 52 then create a profile. | |
| 53 - to launch Wix, enter | |
| 54 $ wix | |
| 55 then create a profile. | |
| 56 - to use jp, follow its help: | |
| 57 $ jp --help | |
| 58 | |
| 59 For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en | |
| 60 | |
| 61 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org |