Mercurial > libervia-backend

view INSTALL @ 2316:7b448ac50a69

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
jp (pubsub): new search command: search is a kind of "grep for Pubsub". It's a powerful command which allows to look for specific data in a pubsub node, recurse sub nodes if requested, and execute an action on the result. search allows to look for items with following filter: - simple text search - regex - xpath - python code filters are read an applied in the order in which they appear on the command line. Then flags can be used to modify behaviour, currently there are: - ignore-case to specify if search must be case sensitive or not - invert to invert result of the search (i.e. don't match instead of match) - dot-all which is specific for regex, cf. re module - only-matching which return the matching part instead of the full item Once a item match filters, an action is applied to it, currenlty there are: - print, which do a simple output of the full item (default) - exec, which run a jp command, specifying the service, node and item corresponding to the match - exteral, which run a external command, sending the full item on stdin By default search is only done on requested node, but if max-depth is more than 0, sub nodes will be searched too.
author Goffi <goffi@goffi.org>
date Sat, 08 Jul 2017 21:54:24 +0200
parents 1128feb54180
children e7bd2945518f
line wrap: on
line source

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
Below is are installation instructions, but please check the wiki which may be more up-to-date.

***

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).


The environment variable SAT_INSTALL customises the installation, it contains flags separated by spaces:
	- "nopreinstall" skips all preinstallation checks
	- "autodeb" automatically installs missing packages on Debian-based distributions
	- "nox" disables installation of X-based packages (WxWidgets), this is useful for servers

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):

# apt-get install python-pip python-dev libxml2-dev libxslt-dev
# SAT_INSTALL=autodeb pip install .

On a *buntu, same commands with sudo:

$ sudo apt-get install python-pip python-dev libxml2-dev libxslt-dev
$ sudo SAT_INSTALL=autodeb pip install .


After installing SàT, you need to install the media:

$ mkdir -p ~/sat/media/destination/path
$ cd ~/sat/media/destination/path
wget ftp://ftp.goffi.org/sat_media/sat_media.tar.bz2
tar -jxvf sat_media.tar.bz2

then, create a ~/.sat.conf file which contains:

### sat.conf ###
[DEFAULT]
media_dir=~/sat/media/destination/path
### end sat.conf ###

Of course, replace ~/sat/media/destination/path with the actual path you want to use.
Check the wiki for more information about this configuration file: http://wiki.goffi.org/wiki/Configuration/en

You should now be able to launch sat:
	- to launch the backend, enter
$ sat
	- to stop the backend, enter:
$ sat stop
	- to launch Primitivus, enter:
$ primitivus
	then create a profile.
	- to use jp, follow its help:
$ jp --help

For Libervia, the web interface, check http://wiki.goffi.org/wiki/Libervia/en

If you need help, come the SàT official XMPP room: sat@chat.jabberfr.org