Mercurial > libervia-web

comparison INSTALL @ 777:c3358ea316e5

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
update INSTALL file
author souliane <souliane@mailoo.org>
date Mon, 30 Nov 2015 11:44:29 +0100
parents 8aa2a199d6e3
children 1028a9c366d3
comparison
equal deleted inserted replaced
776:627b9073a2ec 777:c3358ea316e5
1 Libervia's installation is currently a bit tricky. Full installation and 1 Libervia's installation is currently a bit tricky. Please note that this file instructs
2 configuration instructions are given on the Salut à Toi wiki: 2 a minimal configuration of Libervia. For a complete procedure including the installation
3 and configuration of your XMPP server and enabling the blog and directory features,
4 please consult this page on the Salut à Toi wiki:
3 5
4 http://wiki.goffi.org/w/index.php?title=Libervia/en 6 http://wiki.goffi.org/w/index.php?title=Libervia/en
5
6 7
7 == Prerequesites == 8 == Prerequesites ==
8 9
9 These steps are detailed on the Salut à Toi wiki: 10 These steps are detailed on the Salut à Toi wiki:
10 11
12 * install and configure a local XMPP server (we recommend using Prosody) 13 * install and configure a local XMPP server (we recommend using Prosody)
13 * install sat_pubsub 14 * install sat_pubsub
14 15
15 == Dependencies == 16 == Dependencies ==
16 17
17 * you need to install the txJSON-RPC dependency. The installation script of the current 18 * you need to install the txJSON-RPC dependency (as root):
18 stable release is buggy, and it's fixed on the Bazaar repository, so you need to install 19 pip install txJSON-RPC
19 Bazaar or git and clone the repository: 20 * install python2-gobject2 from your distribution repositories. For example:
20 21 apt-get install python-gobject2
21 bzr branch lp:txjsonrpc
22
23 or
24
25 git clone git://github.com/oubiwann/txjsonrpc
26
27 Then you can install it:
28
29 cd txjsonrpc
30 python setup.py install '''(as root, "sudo python setup.py install" for *buntu)'''
31
32 * install python2-gobject2 from your distribution repositories
33 * install pyjamas. We use the version which used to be on http://pyj.be, not the fork 22 * install pyjamas. We use the version which used to be on http://pyj.be, not the fork
34 from http://pyjs.org. Since http://pyj.be has been down for a while, you can retrieve 23 from http://pyjs.org. Since http://pyj.be has been down for a while, you can retrieve
35 the package from our FTP. 24 the package from our FTP.
36 25
37 wget ftp://ftp.goffi.org/pyjamas/pyjamas.tar.bz2 26 wget ftp://ftp.goffi.org/pyjamas/pyjamas.tar.bz2
38 tar xvjf pyjamas.tar.bz2 27 tar xvjf pyjamas.tar.bz2
39 cd pyjamas 28 cd pyjamas
40 python bootstrap.py 29 python2.7 bootstrap.py
41 30
42 You may need to force the python version if libervia's compilation doesn't work: 31 Note that we force the python version to 2.7. Salut à Toi and Libervia will be ported
43 32 to Python 3 after the Twisted framework which is our main dependency.
44 python2.7 boostrap.py
45
46 Salut à Toi and Libervia are being developped with Python 2.7.3.
47 You can check that it works by compiling the helloworld example: 33 You can check that it works by compiling the helloworld example:
48 34
49 cd examples/helloworld 35 cd examples/helloworld
50 ./build.sh 36 ./build.sh
51 37
66 * install Libervia: 52 * install Libervia:
67 53
68 cd libervia 54 cd libervia
69 python setup.py install 55 python setup.py install
70 56
71 * create an account "libervia@yourserver.tld" (replace "yourserver.tld" by "example.net" 57 * create an account "libervia@example.net" (replace "example.net" with your
72 or something else) on your XMPP server, create a profile on SàT named "libervia", and 58 domain or virtual host) on your XMPP server, create a profile on SàT named
73 plug the SàT profile to this account. 59 "libervia", and plug the SàT profile to this account with jp or primitivus.
60 jp profile create libervia -j libervia@yourserver.tld -p <libervia_password>
74 61
75 == Configuration == 62 == Configuration ==
76 63
77 You can configure the Libervia service from the SàT configuration file, for example: 64 You can configure the Libervia service from the SàT configuration file, for example:
78 65
79 [libervia] 66 [libervia]
80 connection_type=both 67 port = 8080
81 port=8080 68 port_https = 8443
82 port_https=8443 69 port_https_ext = 8443
83 ssl_certificate=libervia.pem 70 connection_type = both
84 redirect_to_https=1 71 ssl_certificate = libervia.pem
85 security_warning=1 72 redirect_to_https = 0
73 security_warning = 1
74 passphrase = <libervia_password>
75 data_dir = ~/workspace/libervia
86 76
87 Check the wiki for more information: http://wiki.goffi.org/wiki/Configuration/en 77 Check the wiki for more information: http://wiki.goffi.org/wiki/Configuration/en
88 78
89 == Usage == 79 == Usage ==
90 80