suppliers:hvac.io:vigilia:installation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionLast revisionBoth sides next revision | ||
suppliers:hvac.io:vigilia:installation [2017/08/26 00:05] – [Database] frozenlock | suppliers:hvac.io:vigilia:installation [2020/10/04 01:52] – old revision restored (2020/10/02 09:00) 173.249.2.13 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== Vigilia | + | ====== Vigilia Installation ====== |
- | //**Requires a Viglia Server licence**. To use the HVAC.IO servers instead, jump to [[.:recording]].// | + | //**For self-hosted version only.** To use the HVAC.IO servers instead, |
The installation is separated in 3 main components: | The installation is separated in 3 main components: | ||
Line 7: | Line 7: | ||
* [[# | * [[# | ||
* [[#Vigilia Server]] | * [[#Vigilia Server]] | ||
- | * [[.:recording#client_side_loggers|Loggers]] | + | * [[# |
They can all be installed on the same machine, or on separate servers and devices, depending on your network architecture. | They can all be installed on the same machine, or on separate servers and devices, depending on your network architecture. | ||
Line 14: | Line 14: | ||
Once this is done, you might want to take a look at [[#Adding Vigilia as a Service]] | Once this is done, you might want to take a look at [[#Adding Vigilia as a Service]] | ||
===== Database ===== | ===== Database ===== | ||
- | For the time being, Vigilia only supports TokuMX. | + | For the time being, Vigilia only supports |
It is a fork of MongoDB, which features mind boggling increase in performance and reduction in the database size. | It is a fork of MongoDB, which features mind boggling increase in performance and reduction in the database size. | ||
(The choice was not made lightly; we tried many databases before settling with this one.) | (The choice was not made lightly; we tried many databases before settling with this one.) | ||
Line 24: | Line 24: | ||
250 to 500 Go should be plenty of space to store many years of data for networks composed of hundreds of thousands of objects. (Tokumx compression is really useful for this!) | 250 to 500 Go should be plenty of space to store many years of data for networks composed of hundreds of thousands of objects. (Tokumx compression is really useful for this!) | ||
- | To install TokuMX, add the following PPA and enter the following in your shell : | ||
- | sudo apt install | + | Download and install |
- | + | ||
- | (Alternatively, | + | |
- | + | ||
- | (If it doesn' | + | |
Once the database is installed, make sure everything works as intended by running the command | Once the database is installed, make sure everything works as intended by running the command | ||
Line 39: | Line 34: | ||
{{: | {{: | ||
- | You can stop the process by pressing Ctrl-C in the shell. | ||
===== Vigilia Server ===== | ===== Vigilia Server ===== | ||
Line 74: | Line 68: | ||
< | < | ||
- | === Create Admin Account === | ||
- | If Vigilia is able to connect to the database, you will be invited | + | If you want the application to start automatically when your server boot up, you should make sure to [[#Adding Vigilia as a Service|create |
- | The first account created will have the administrator rights. | + | |
- | === Load License | + | ===== Loggers ===== |
- | Now that you have the administrator rights, you should load the license files. | + | Loggers are software able to scan a BACnet network and send the data back to a Vigilia server. |
- | On the upper right, you should see your username. Click on it and go to **Server Administration**. Then click on **License**. Select the license files and click upload. | + | |
- | You should see something similar to this: | + | The only publicly available logger is Wacnet (min version 1.8). |
- | {{:suppliers: | + | To start logging a network, **begin by running Wacnet**. |
+ | Then go and configure a few things in the **[[http://localhost:47800/vigilia/ | ||
- | === Configure Service (optional) | + | ==== Step 1: Connect to a Vigilia server ==== |
- | If you want the application | + | The first thing to configure is a Vigilia |
- | === Good to Go === | + | It should have the following form: |
- | Once your Vigilia server is up and running, you can follow the steps to [[suppliers: | + | < |
+ | http://<vigilia-IP-or-adrress>/ | ||
+ | </ | ||
- | ===== Adding Vigilia as a Service ===== | + | Make sure Wacnet can see the provided URL! |
- | ==== (Upstart Users) ==== | + | |
+ | |||
+ | |||
+ | |||
+ | {{: | ||
+ | |||
+ | ==== Step 2: Project credentials ==== | ||
+ | |||
+ | You have to provide a **project ID** and a **logging key/ | ||
+ | Both are available through the project configurations on the Vigilia server. | ||
+ | |||
+ | Here's an example : | ||
+ | * Project-id : 5371147be4b0222b740851a2 | ||
+ | * Logging key: asdi34h5ha | ||
+ | |||
+ | Make sure Wacnet has access to the project : | ||
+ | |||
+ | {{: | ||
+ | |||
+ | |||
+ | ==== Start Logging ==== | ||
+ | |||
+ | When Wacnet starts, it searches for Vigilia configurations. If it finds some, **it will start logging automatically**. | ||
+ | |||
+ | To start the logging without restarting Wacnet, expand the details part of the page and click on " | ||
+ | |||
+ | {{: | ||
+ | |||
+ | ===== Adding Vigilia as a Service ===== | ||
You might want to make sure the Vigilia server always starts as soon as the server boots, or that it restores itself in case of a crash. | You might want to make sure the Vigilia server always starts as soon as the server boots, or that it restores itself in case of a crash. | ||
Line 110: | Line 131: | ||
- | < | + | < |
description " | description " | ||
Line 145: | Line 166: | ||
To get more info about Upstart and services, see http:// | To get more info about Upstart and services, see http:// | ||
- | |||
- | |||
- | ===== Troubleshooting ===== | ||
- | |||
- | ==== Database Crash ==== | ||
- | |||
- | If you database is becoming quite large (thousands of files in the dbpath), it's possible that your OS is going to refuse opening that much files simultaneously. | ||
- | |||
- | In Linux, you can change the number of allowed files by editing the file ''/ | ||
- | |||
- | < | ||
- | tokumx soft nofile 1000000 | ||
- | tokumx hard nofile 1000000 | ||
- | </ | ||
- | |||
suppliers/hvac.io/vigilia/installation.txt · Last modified: 2020/10/04 01:53 by 173.249.2.13