Mercurial > libervia-backend

comparison INSTALL @ 885:c8a7019cd168

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
better INSTALL instructions
author Goffi <goffi@goffi.org>
date Fri, 28 Feb 2014 14:41:51 +0100
parents 5d08ab99e8dd
children 2be46f391cfa
comparison
equal deleted inserted replaced
884:4054cf716322 885:c8a7019cd168
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
1 *** 4 ***
2 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 5
3 *** 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
8 The environment variable SAT_INSTALL customise the installation, it contains flags separated by spaces:
9 - "nopreinstall" skip all preinstallation checks
10 - "autodeb" automatically install missing packages on Debian based distributions
11 - "nox" disable installation of X based packages (WxWidgets), this is useful for servers
12
13 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):
14
15 # apt-get install python-pip python-dev libxml2-dev libxslt-dev
16 # SAT_INSTALL=autodeb pip install .
17
18 On a *buntu, same commands with sudo:
19
20 $ sudo apt-get install python-pip python-dev libxml2-dev libxslt-dev
21 $ SAT_INSTALL=autodeb sudo pip install .
22
23
24 After installing SàT, you need to install the media:
25
26 $ mkdir -p ~/sat/media/destination/path
27 $ cd ~/sat/media/destination/path
28 wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2
29 tar -jxvf sat_media.tar.bz2
30
31 then, create a ~/.sat.conf file which contains:
32
33 ### sat.conf ###
34 [DEFAULT]
35 media_dir=~/sat/media/destination/path
36 ### end sat.conf ###
37
38 Of course, replace ~/sat/media/destination/path with the actual path you want to use.
39
40 You should now be able to launch sat:
41 - to launch the backend, enter
42 $ sat
43 - to stop the backend, enter:
44 $ sat stop
45 - to launch Primitivus, enter:
46 $ primitivus
47 then create a profile.
48 - to launch Wix, enter
49 $ wix
50 then create a profile.
51 - to use jp, follow its help:
52 $ jp --help
53
54 For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en
55
56 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org