|
|
# Setup JetConf with JukeBox backend
|
|
|
## Requirements
|
|
|
# Setup JetConf with backend
|
|
|
## 1. Install Python, if not installed
|
|
|
*JetConf* requires Python 3.5 or newer:
|
|
|
|
|
|
```bash
|
|
|
$ sudo apt-get install python3
|
|
|
$ sudo apt-get install python3-pip
|
|
|
```
|
|
|
|
|
|
## Dependencies
|
|
|
- [JetConf](https://gitlab.labs.nic.cz/labs/jetconf) server installed
|
|
|
|
|
|
## 2. Install [JetConf](https://gitlab.labs.nic.cz/labs/jetconf) server
|
|
|
```bash
|
|
|
$ python3 -m pip install jetconf
|
|
|
```
|
|
|
From source
|
|
|
```bash
|
|
|
$ git clone https://gitlab.labs.nic.cz/labs/jetconf.git
|
|
|
$ cd jetconf
|
|
|
$ python3 setup.py install
|
|
|
```
|
|
|
|
|
|
- [JukeBox](https://gitlab.labs.nic.cz/jetconf/jetconf-jukebox) or other backend installed
|
|
|
|
|
|
## 3. Install JetConf backend
|
|
|
For example [jetconf-jukebox](https://gitlab.labs.nic.cz/jetconf/jetconf-jukebox)
|
|
|
```bash
|
|
|
$ git clone https://gitlab.labs.nic.cz/jetconf/jetconf-jukebox.git
|
|
|
$ cd jetconf-jukebox
|
|
|
$ python3 setup.py install
|
|
|
```
|
|
|
- [Generated JetConf Server and Client Certificates](https://gitlab.labs.nic.cz/labs/jetconf/wikis/certificates)
|
|
|
|
|
|
## Setting up Configuation
|
|
|
## 4. Server and Client certificates
|
|
|
To generate Server and Client certificates for testing purposes follow [this](https://gitlab.labs.nic.cz/labs/jetconf/wikis/certificates) guide otherwise you will need Certificates generated and signed by real Certification Authority.
|
|
|
|
|
|
Create working directory for your certificates and configurations.
|
|
|
## 5. Create working directory for your certificates and configurations.
|
|
|
Move or generate your server certificate files to this directory.
|
|
|
```bash
|
|
|
$ mkdir jukebox_conf
|
|
|
$ cd jukebox_conf
|
|
|
```
|
|
|
Move or [generate](https://gitlab.labs.nic.cz/labs/jetconf/wikis/certificates) your server certificate files to this directory
|
|
|
|
|
|
## 6. Create .yaml file and write our configuration
|
|
|
*JetConf* is started with specific configuration written to `.yaml` structured file. All possible configurations are described [here](https://gitlab.labs.nic.cz/labs/jetconf/wikis/jetconf-config)
|
|
|
|
|
|
Create `DOC_ROOT` direcory for http server.
|
... | ... | @@ -40,8 +43,7 @@ Create `DOC_ROOT` direcory for http server. |
|
|
$ cd jukebox_conf
|
|
|
$ mkdir doc-root
|
|
|
```
|
|
|
|
|
|
Create `.yaml` file and write our configuration. Example configuration for JukeBox
|
|
|
Example configuration for JukeBox
|
|
|
```bash
|
|
|
GLOBAL:
|
|
|
TIMEZONE: "Europe/Prague"
|
... | ... | @@ -69,15 +71,14 @@ NACM: |
|
|
ALLOWED_USERS: ["lojza@mail.cz"]
|
|
|
```
|
|
|
|
|
|
## Running JetConf
|
|
|
|
|
|
## 7. Run JetConf with your configuration file
|
|
|
The configuration file can be passed to Jetconf with command line argument
|
|
|
```bash
|
|
|
$ jetconf -c jukebox-config.yaml
|
|
|
```
|
|
|
Now, JetConf should be running witch your configuration.
|
|
|
Now, JetConf is running witch your configuration.
|
|
|
|
|
|
## JetConf Clients
|
|
|
## 8. JetConf Clients
|
|
|
* [Curl](https://gitlab.labs.nic.cz/labs/jetconf/wikis/curl-installation) - A Swiss-knife tool for HTTP/2,
|
|
|
* [jetscreen](https://gitlab.labs.nic.cz/jetconf/jetscreen) - Interactive graphical JetConf client written in Angular 2
|
|
|
|