Mercurial > libervia-backend

comparison INSTALL @ 2619:e7bd2945518f

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
doc (INSTALL): replaced instruction with a simple link to the wiki, to avoid duplication and desynchronisation
author Goffi <goffi@goffi.org>
date Tue, 26 Jun 2018 22:02:59 +0200
parents 1128feb54180
children 457ae6381e2a
comparison
equal deleted inserted replaced
2618:fe9888d3fcb6 2619:e7bd2945518f
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 1 You'll find install instructions on the following link: http://wiki.goffi.org/wiki/Salut_%C3%A0_Toi
2 Below is are installation instructions, but please check the wiki which may be more up-to-date.
3 2
4 *** 3 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org or join us with a web browser via https://chat.jabberfr.org/converse.js/sat@chat.jabberfr.org
5
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).
7
8
9 The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces:
10 - "nopreinstall" skips all preinstallation checks
11 - "autodeb" automatically installs missing packages on Debian-based distributions
12 - "nox" disables installation of X-based packages (WxWidgets), this is useful for servers
13
14 PyGobject is automatically installed on Debian-based distributions if "autodeb" option is set. Indeed, on Debian-based distribution, you can type (with the root account):
15
16 # apt-get install python-pip python-dev libxml2-dev libxslt-dev
17 # SAT_INSTALL=autodeb pip install .
18
19 On a *buntu, same commands with sudo:
20
21 $ sudo apt-get install python-pip python-dev libxml2-dev libxslt-dev
22 $ sudo SAT_INSTALL=autodeb pip install .
23
24
25 After installing SàT, you need to install the media:
26
27 $ mkdir -p ~/sat/media/destination/path
28 $ cd ~/sat/media/destination/path
29 wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2
30 tar -jxvf sat_media.tar.bz2
31
32 then, create a ~/.sat.conf file which contains:
33
34 ### sat.conf ###
35 [DEFAULT]
36 media_dir=~/sat/media/destination/path
37 ### end sat.conf ###
38
39 Of course, replace ~/sat/media/destination/path with the actual path you want to use.
40 Check the wiki for more information about this configuration file: http://wiki.goffi.org/wiki/Configuration/en
41
42 You should now be able to launch sat:
43 - to launch the backend, enter
44 $ sat
45 - to stop the backend, enter:
46 $ sat stop
47 - to launch Primitivus, enter:
48 $ primitivus
49 then create a profile.
50 - to use jp, follow its help:
51 $ jp --help
52
53 For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en
54
55 If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org