broker installation

Broker.md

@@ -3,10 +3,33 @@ Broker is essential part of ReCodEx solution which maintaines almost all communi
 
 ## Description
 
+
 ## Architecture
 
+
 ## Installation
 
+### Dependencies
+Broker has no special dependencies only the ones written in [[Common install|Overall architecture#common-install]] chapter.
+
+### Clone broker source code repository
+```
+$ git clone https://github.com/ReCodEx/broker.git
+$ git submodule update --init
+```
+
+### Install broker
+It's supposed that your current working directory is that one with clonned worker source codes.
+
+- Prepare environment running `mkdir build && cd build`
+- Build sources by `cmake ..` following by `make -j#` where '#' symbol refers to number of your CPU threads.
+- Build binary package by `make package` (may require root permissions).
+Note that `rpm` and `deb` packages are build in the same time. You may need to have `rpmbuild` command (usually as `rpmbuild` or `rpm` package) or edit CPACK_GENERATOR variable _CMakeLists.txt_ file in root of source code tree.
+- Install generated package through your package manager (`yum`, `dnf`, `dpkg`).
+
+_Note:_ If you don't want to generate binary packages, you can just install the project with `make install` (as root). But installation through your distribution's package manager is preferred way to keep your system clean and manageable in long term horizon.
+
+
 ## Configuration and usage
 Following text describes how to set up and run **broker** program. It's supposed to have required binaries installed. For instructions see [[Installation|Broker#installation]] section. Also, using systemd is recommended for best user experience, but it's not required. Almost all modern Linux distributions are using systemd now.