summaryrefslogtreecommitdiff
path: root/INSTALL
diff options
context:
space:
mode:
authorSimeon Simeonov2018-06-30 12:22:35 +0200
committerSimeon Simeonov2018-06-30 12:22:35 +0200
commit29ea2f46a81c516a08767eafdab9698d5cbd6150 (patch)
tree84ce1067a40eda5b5f262b8b1de56e3317a0406d /INSTALL
parent63ddf50344cf1e4f2f9b75ce3b0c4db940a3be47 (diff)
Documentation cleanups. INSTALL -> INSTALL.md, README -> README.md
Diffstat (limited to 'INSTALL')
-rw-r--r--INSTALL98
1 files changed, 0 insertions, 98 deletions
diff --git a/INSTALL b/INSTALL
deleted file mode 100644
index f26a6f9..0000000
--- a/INSTALL
+++ /dev/null
@@ -1,98 +0,0 @@
1Installation Instructions
2-------------------------
3
4Refer to README for a basic information about the different BEINC components
5and their software requirements!
6
7
8Installing the dependencies
9~~~~~~~~~~~~~~~~~~~~~~~~~~~
10
11
12Gentoo GNU/Linux 2014, 2015
13..........................
14
15# emerge -va dev-python/pyopenssl dev-python/twisted-web dev-python/notify-python dev-python/pyosd
16
17
18Ubuntu GNU/Linux
19................
20
21# apt-get install python-openssl python-twisted-web python-notify2 python-pyosd
22
23
24FreeBSD 9, 10
25.............
26
27# cd /usr/ports/security/py-openssl
28# make install clean
29
30# cd /usr/ports/www/py-twistedWeb
31# make install clean
32
33# cd /usr/ports/devel/py-notify
34# make install clean
35
36# cd /usr/ports/misc/py-osd
37# make install clean
38
39
40Intallation using virtualenv and pip
41....................................
42
43Very often you are not the administrator of the server hosting your BEINC server
44This is where virtualenv may become handy (provided that it has been installed):
45$ virtualenv beinc_installation
46$ cd beinc_installation
47$ source bin/activate
48$ pip install Twisted
49$ pip install pyopenssl
50$ cd beinc-<version>
51$ ./beinc_server.py -h
52
53
54Installing and setting up BEINC
55~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
56
57Unpack the latest version of BEINC
58$ tar zxvf beinc-<version>.tar.gz
59
60$cd beinc-<version>
61Read the README file
62
63You should now have a basic understanding about the different BEINC components
64and how they interact with each other.
65beinc_server.py and beinc_weechat.py are using a .json configuration file.
66Read beinc_config_sample.json.readme where every configuration option is explined.
67Decide on a use-strategy and place the different components to their locations:
68
69beinc_server.py:
70Create a configuration file based on beinc_config_sample.json, defining your instances
71Start the BEINC server:
72$ ./beinc_server.py -H 10.0.0.44 -p 9678
73The example loads the server listening on 10.0.0.44, port 9678 using the default
74~/.beinc_server.json as a configuration file and usually gives you the Twisted
75log console
76
77beinc_poller.py:
78$ ./beinc_poller.py -h
79The example lists all available command options
80$ ./beinc_poller.py -n weechat -t 10 -f 7 --cert-file /home/sgs/weechat_cert.crt \
81 -p /home/sgs/.weechat_beinc_passwd https://10.0.0.44:9678
82Starts polling from the instance (target) defined above,
83defining an OSD timeout of 10 seconds, polling frequency of 7 seconds,
84checking whether the server's SSL certificate was signed (issued) by /home/sgs/weechat_cert.crt,
85extracting the target's password from /home/sgs/.weechat_beinc_passwd
86
87beinc_generic_client.py:
88$ ./beinc_generic_client.py -h
89The example lists all available command options
90
91beinc_weechat.py:
92Create a configuration file based on beinc_config_sample.json, defining your targets
93and copy it (or symlink it) to ~/<weechat-dir>/beinc_weechat.json
94(weechat-dir is usually ~/.weechat)
95Copy (or symlink) beinc_weechat.py to ~/<weechat-dir>/python/autoload/
96Load the script in Weechat by typing: /python load beinc_weechat.py
97Make sure that all your targets look as they should: /beinc target list
98Test if your targets are displaying / relaying your messages: /beinc broadcast Test