Mercurial > libervia-backend
annotate INSTALL @ 1422:be1fccf4854d
tmp (wokkel): licenses fixes:
the licenses headers were wrong, it was fixed: original work from Adrien Cossa is directly under AGPL v3 (with his agreement), work derivated from Wokkel is sublicensed to AGPL v3 as allowed by the original license, to stay consistent with the rest of the code base.
Theses files (and only these ones) can be relicensed again to fill Wokkel license if Ralph plan to merge them upstream...
| author | Goffi <goffi@goffi.org> |
|---|---|
| date | Thu, 23 Apr 2015 10:57:40 +0200 |
| parents | e2e75c3c7c7b |
| children | 1128feb54180 |
| 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 |
| 1202 | 2 Below is are installation instructions, but please check the wiki which may be more up-to-date. |
| 885 | 3 |
|
587
952322b1d490
Remove trailing whitespaces.
Emmanuel Gil Peyrot <linkmauve@linkmauve.fr>
parents:
548
diff
changeset
|
4 *** |
| 885 | 5 |
| 1202 | 6 You can automatically install SàT and its 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). |
| 885 | 7 |
| 1202 | 8 NOTE: pyfeed and xe are mandatory dependencies, they should be on http://pypi.python.org (PYthon Package Index, the official repository for Python projects) and so being automatically installed; but they are not yet there (their author should do it soon), so you have to install them manually until then. |
|
1203
6e08ee45bf0a
misc: updated urls of pyxe an pyfeed
Matteo Cypriani <mcy@lm7.fr>
parents:
1202
diff
changeset
|
9 You can download them respectively on http://home.avvanta.com/%7Esteveha/pyfeed-0.7.4.tar.gz and http://home.avvanta.com/%7Esteveha/xe-0.7.4.tar.gz, then decompress them and do « python setup.py install » on both. |
| 1202 | 10 An other way is to use the (insecure) pip options --process-dependency-links and --allow-all-external when installing sat, options which will soon be (or already are) removed from pip. |
| 1191 | 11 |
| 12 | |
| 1202 | 13 The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces: |
| 14 - "nopreinstall" skips all preinstallation checks | |
| 15 - "autodeb" automatically installs missing packages on Debian-based distributions | |
| 16 - "nox" disables installation of X-based packages (WxWidgets), this is useful for servers | |
| 885 | 17 |
| 1202 | 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): |
| 885 | 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. | |
|
1410
e2e75c3c7c7b
quick_frontend, primitivus: fixes a couple of issues:
souliane <souliane@mailoo.org>
parents:
1291
diff
changeset
|
44 Check the wiki for more information about this configuration file: http://wiki.goffi.org/wiki/Configuration/en |
| 885 | 45 |
| 46 You should now be able to launch sat: | |
| 47 - to launch the backend, enter | |
| 48 $ sat | |
| 49 - to stop the backend, enter: | |
| 50 $ sat stop | |
| 51 - to launch Primitivus, enter: | |
| 52 $ primitivus | |
| 53 then create a profile. | |
| 54 - to use jp, follow its help: | |
| 55 $ jp --help | |
| 56 | |
| 57 For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en | |
| 58 | |
| 59 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org |