1
0
Fork 0
mirror of https://github.com/ThomasGsp/HyperProxmox.git synced 2025-02-12 19:22:30 +00:00

Update config doc

This commit is contained in:
Tlams 2018-05-01 10:33:43 +01:00
parent 14170e60de
commit 2c2195b83a
2 changed files with 60 additions and 16 deletions

View file

@ -8,11 +8,6 @@ key_pub: private/keys/Ragnarok.pub.key
admin_mail: tlams@localhost admin_mail: tlams@localhost
[web]
user: www-data
[api]:
user: hyperproxmox
[databases] [databases]
; Databases configurations ; Databases configurations

View file

@ -7,19 +7,24 @@ vi /opt/HyperProxmox/code/scripts/main/private/conf/config
[system] [system]
; System configurations ; System configurations
user: hyperproxmox user: hyperproxmox
```
User created in the "Backend" page.
This user will run Hyperproxmox.
``` bash
; If not exist at startup, the key will be auto-generate. ; If not exist at startup, the key will be auto-generate.
key_pvt: private/keys/Ragnarok.pvt.key key_pvt: private/keys/Ragnarok.pvt.key
key_pub: private/keys/Ragnarok.pub.key key_pub: private/keys/Ragnarok.pub.key
```
Directory and private/public key generated to protect the critical data in MongoDB.
Private key is setup with an passphrase.
``` bash
admin_mail: tlams@localhost admin_mail: tlams@localhost
```
Receive alerts and information by mail. Currently not implemented.
[web] ``` bash
user: www-data
[api]:
user: hyperproxmox
[databases] [databases]
; Databases configurations ; Databases configurations
; NOSQL databases, should use a password ; NOSQL databases, should use a password
@ -32,7 +37,13 @@ redis_user:
redis_password: redis_password:
redis_ip: 127.0.0.1 redis_ip: 127.0.0.1
redis_port: 6379 redis_port: 6379
```
Databases setting for backed.
User / Password are not currently supported.
Don't expose your database on 0.0.0.0 or without firewall.
``` bash
[deploy] [deploy]
; Maximum concurrent deployment ; Maximum concurrent deployment
; A high value can overcharge your physicals servers ; A high value can overcharge your physicals servers
@ -42,43 +53,81 @@ concurrencydeploy: 2
; If your infrastructure isn't very large, you should'nt reduce this delay. ; If your infrastructure isn't very large, you should'nt reduce this delay.
; A low delay can overcharge your physicals servers ; A low delay can overcharge your physicals servers
delayrounddeploy: 15 delayrounddeploy: 15
```
Currently not implemented (machine provision)
``` bash
[walker] [walker]
; Delay in seconds between to crawl (update) ; Delay in seconds between to crawl (update)
walker: 300 walker: 300
```
Delay minimum between to crawling on your Proxmox infrastructure.
A lock block a new crawl if the precedent is not terminated. If this situation append, the next crawl is
canceled and reported to the next windows.
A delay too short can generate massive(and useless) data if your infrastructure is large !
```
``` bash
; Lock file -- prevent concurrent crawling ; Lock file -- prevent concurrent crawling
walker_lock: /tmp/hyperproxmoxwalker.lock walker_lock: /tmp/hyperproxmoxwalker.lock
```
Lock file. The directory have to be writable by Hyperproxmox user.
``` bash
; Set an unique ID (change comment part) ; Set an unique ID (change comment part)
uid = False uid = False
```
Work but useless in this version.
HyperProxmox will set an unique ID in the comment area (machine configuration),
with in the future the goal to have the possibility to follow an virtual machine in the infrastructure.
The currents comments are not deleted, just reported after this ID.
``` bash
[logger] [logger]
; logs level 1: "INFO", 2: "WARNING", 3: "ERROR", 4: "CRITICAL", 5: "DEBUG" ; logs level 1: "INFO", 2: "WARNING", 3: "ERROR", 4: "CRITICAL", 5: "DEBUG"
logs_level = 5 logs_level = 5
```
Log level definite the logs verbosity.
In production, you should definite this setting on "WARNING".
In "DEBUG", hyperproxmox can generate lot of logs.
This system is currently only implemented on the main functions.
``` bash
; Limit IO write, if debug level is active, this value is overwrite to 0 ; Limit IO write, if debug level is active, this value is overwrite to 0
bulk_write = 1 bulk_write = 1
; Buffer size ; Buffer size
bulk_size = 1000 bulk_size = 1000
```
The goal is to limit the I/O usage on your hard drive.
HyperProxmox will save the logs in memory and write on the disk only when the buffer(bulk_size) is full.
``` bash
; log output ; log output
logs_dir = /var/log/hyperproxmox/ logs_dir = /var/log/hyperproxmox/
``` ```
Logs directory have to be writable by Hyperproxmox user.
#### Purge system #### Purge system
You should setup an cron to purge old data. You should setup an cron to purge old data (not an obligation).
This cron allow the possibility to delete automatically old data in your database.
``` bash ``` bash
RET=4 # older than the current date less this delay in days RET=90 # older than the current date less this delay in days
DATETIMESTAMP=$(($(date +%s)-$((86400*$RET)))) DATETIMESTAMP=$(($(date +%s)-$((86400*$RET))))
curl -H -XPOST -d '{ "action": "purge", "type":"strict", "date": $DATETIMESTAMP }' localhost:8080/api/v1/administration/purge 0 0 * * * hyperproxmox curl -H -XPOST -d '{ "action": "purge", "type":"strict", "date": $DATETIMESTAMP }' localhost:8080/api/v1/administration/purge >/var/log/hyperproxmox/purge.log 2>&1
``` ```
* action: actiontype (only purge is currently available) * action: actiontype (only purge is currently available)
* type: purge type (strict = all data before this date) * type: purge type (strict = all data before this date)
* date: delete data before this date - in seconds(timestamp) * date: delete data before this date - in seconds(timestamp)
Currently, just one mod is available: stric.
It's mean that ALL data will be delete before the date.
Some others possibility should be available in the future, like keep one day per week.
[Readme](03-frontend.md) <-- Previous | Next --> [Usage - First start](05-first_start.md) [Frontend](03-frontend.md) <-- Previous | Next --> [Usage - First start](05-first_start.md)