Mercurial > libervia-web
annotate INSTALL @ 748:0d5889b9313c
browser side: fixed group panel drop and contact_list click on GroupLabel
author | Goffi <goffi@goffi.org> |
---|---|
date | Mon, 23 Nov 2015 16:39:11 +0100 |
parents | 47c21905e002 |
children | 9ad1a551c26d |
rev | line source |
---|---|
420
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
1 Libervia's installation is currently a bit tricky. Full installation and |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
2 configuration instructions are given on the Salut à Toi wiki: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
3 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
4 http://wiki.goffi.org/w/index.php?title=Libervia/en |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
5 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
6 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
7 == Prerequesites == |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
8 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
9 These steps are detailed on the Salut à Toi wiki: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
10 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
11 * install and configure Salut à Toi |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
12 * install and configure a local XMPP server (we recommend using Prosody) |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
13 * install sat_pubsub |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
14 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
15 == Dependencies == |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
16 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
17 * you need to install the txJSON-RPC dependency. The installation script of the current |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
18 stable release is buggy, and it's fixed on the Bazaar repository, so you need to install |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
19 Bazaar or git and clone the repository: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
20 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
21 bzr branch lp:txjsonrpc |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
22 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
23 or |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
24 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
25 git clone git://github.com/oubiwann/txjsonrpc |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
26 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
27 Then you can install it: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
28 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
29 cd txjsonrpc |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
30 python setup.py install '''(as root, "sudo python setup.py install" for *buntu)''' |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
31 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
32 * install python2-gobject2 from your distribution repositories |
731
47c21905e002
fixes the INSTALL since http://pyj.be has been down for a while (Oliver)
souliane <souliane@mailoo.org>
parents:
496
diff
changeset
|
33 * install pyjamas. We use the version which used to be on http://pyj.be, not the fork |
47c21905e002
fixes the INSTALL since http://pyj.be has been down for a while (Oliver)
souliane <souliane@mailoo.org>
parents:
496
diff
changeset
|
34 from http://pyjs.org. Since http://pyj.be has been down for a while, you can retrieve |
47c21905e002
fixes the INSTALL since http://pyj.be has been down for a while (Oliver)
souliane <souliane@mailoo.org>
parents:
496
diff
changeset
|
35 the package from our FTP. |
420
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
36 |
731
47c21905e002
fixes the INSTALL since http://pyj.be has been down for a while (Oliver)
souliane <souliane@mailoo.org>
parents:
496
diff
changeset
|
37 wget ftp://ftp.goffi.org/pyjamas/pyjamas.tar.bz2 |
47c21905e002
fixes the INSTALL since http://pyj.be has been down for a while (Oliver)
souliane <souliane@mailoo.org>
parents:
496
diff
changeset
|
38 tar xjf pyjamas.tar.bz2 |
420
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
39 cd pyjamas |
731
47c21905e002
fixes the INSTALL since http://pyj.be has been down for a while (Oliver)
souliane <souliane@mailoo.org>
parents:
496
diff
changeset
|
40 python bootstrap.py |
420
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
41 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
42 You can need to force a python version if libervia's compilation doesn't work, for example: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
43 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
44 python2.6 boostrap.py |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
45 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
46 Salut à Toi and Libervia are being developped with Python 2.7.3. |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
47 You can check that it works by compiling the helloworld example: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
48 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
49 cd examples/helloworld |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
50 ./build.sh |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
51 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
52 If you have no error message, it should be allright. |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
53 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
54 == Install Libervia == |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
55 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
56 * to install Libervia using setuptools, the pyjsbuild executable should be accessible |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
57 from your environment variable "PATH". The easiest would be: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
58 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
59 cd pyjamas |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
60 sudo ln -sf bin/pyjsbuild /usr/bin/pyjsbuild |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
61 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
62 * clone libervia repository: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
63 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
64 hg clone http://repos.goffi.org/libervia |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
65 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
66 * install Libervia: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
67 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
68 cd libervia |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
69 python setup.py install |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
70 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
71 * create an account "libervia@yourserver.tld" (replace "yourserver.tld" by "example.net" |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
72 or something else) on your XMPP server, create a profile on SàT named "libervia", and |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
73 plug the SàT profile to this account. |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
74 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
75 == Configuration == |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
76 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
77 You can configure the Libervia service from the SàT configuration file, for example: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
78 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
79 [libervia] |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
80 connection_type=both |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
81 port=8080 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
82 port_https=8443 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
83 ssl_certificate=libervia.pem |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
84 redirect_to_https=1 |
496
0924710b666a
browser_side: remove the annoying (esp. when editing a message) scrolling each time you select a microblog entry
souliane <souliane@mailoo.org>
parents:
420
diff
changeset
|
85 security_warning=1 |
420
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
86 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
87 Check the wiki for more information: http://wiki.goffi.org/wiki/Configuration/en |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
88 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
89 == Usage == |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
90 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
91 The four components must be launched in the following order: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
92 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
93 * prosody |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
94 * sat_pubsub (with the xmpp domain and password as declared in prosodi.cfg.lua) |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
95 * sat |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
96 * libervia's web server |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
97 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
98 Your command input would look like that: |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
99 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
100 cd prosody && prosodyctl start |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
101 twistd sat_pubsub --jid=sat-pubsub.<xmpp_domain> --secret=<password> |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
102 sat |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
103 libervia |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
104 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
105 You can now drop your web browser on http://localhost:8080/libervia.html |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
106 |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
107 If you encounter any issue, you can ask for help on MUC room sat@chat.jabberfr.org |
ac0018e4391b
misc: INSTALL: convert line delimiters to UNIX
souliane <souliane@mailoo.org>
parents:
419
diff
changeset
|
108 or use the dev mailing list: http://lists.goffi.org |