suppliers:hvac.io:vigilia:installation
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
suppliers:hvac.io:vigilia:installation [2015/12/04 19:29] – [Adding Vigilia as a Service] frozenlock | suppliers:hvac.io:vigilia:installation [2020/07/22 15:01] – old revision restored (2015/08/06 23:10) 95.91.41.38 | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== | + | ====== Installation ====== |
- | //**For self-hosted version only.** | + | For self-hosted version only. To use the HVAC.IO servers instead, |
- | + | ||
- | To use the HVAC.IO servers instead, jump to [[.:recording]].// | + | |
The installation is separated in 3 main components: | The installation is separated in 3 main components: | ||
Line 9: | 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. | ||
- | |||
- | 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 27: | Line 23: | ||
- | Download and install by following the instructions on this [[https://www.percona.com/doc/percona-tokumx/installation.html|page]]. | + | Download and install by following the instructions on this [[http://www.tokutek.com/tokumx-for-mongodb/download-community/|page]]. |
- | Once the database is installed, make sure everything works as intended by running the command | ||
- | **mongo** in the shell. | ||
- | |||
- | The command should be recognized AND it should connect successfully. | ||
- | |||
- | {{: | ||
- | |||
- | You can stop the process by pressing Ctrl-C in the shell. | ||
===== Vigilia Server ===== | ===== Vigilia Server ===== | ||
Line 65: | Line 53: | ||
< | < | ||
- | (where <port number> is the port you want to use. If you don't know which one to take, use 47900.) | + | (where <port number> is the port you want to use.) |
- | + | ||
- | After a few seconds, the server should be up and running. | + | |
- | You can now take your browser and go to: | + | |
- | < | + | |
- | + | ||
- | === Create Admin Account === | + | |
- | + | ||
- | If Vigilia is able to connect to the database, you will be invited to create an account. | + | |
- | The first account created will have the administrator rights. | + | |
- | + | ||
- | === Load License === | + | |
- | + | ||
- | Now that you have the administrator rights, you should load the license files. | + | |
- | 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: | + | |
- | + | ||
- | {{: | + | |
- | + | ||
- | === Configure Service (optional) === | + | |
- | + | ||
- | If you want the application to start automatically when your server boot up, you should make sure to [[#Adding Vigilia as a Service|create a service]] (shown below), or configure your web server (like Tomcat) to use vigilia-server.jar. | + | |
- | + | ||
- | === Good to Go === | + | |
- | + | ||
- | Once your Vigilia server is up and running, you can follow the steps to [[suppliers: | + | |
- | + | ||
- | + | ||
- | ===== 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. | + | |
- | + | ||
- | For this, you'll have to add Vigilia as a service. | + | |
- | + | ||
- | Start by creating a file named " | + | |
- | + | ||
- | Open it and paste the following: | + | |
- | + | ||
- | + | ||
- | <code bash vigilia.conf> | + | |
- | + | ||
- | description " | + | |
- | author " | + | |
- | + | ||
- | start on runlevel [2345] | + | |
- | stop on runlevel [!2345] | + | |
- | + | ||
- | + | ||
- | #Respawn the process if it crashes | + | |
- | #If it respawns more than 10 times in 60 seconds stop | + | |
- | respawn | + | |
- | respawn limit 10 60 | + | |
- | + | ||
- | expect fork | + | |
- | + | ||
- | #replace PATH-TO-THE-JAR with something like / | + | |
- | #replace PORT with the desired port number | + | |
- | script | + | |
- | cd PATH-TO-THE-JAR | + | |
- | java -jar vigilia-server.jar PORT & | + | |
- | end script | + | |
- | + | ||
- | </ | + | |
- | + | ||
- | Now, once you replaced PATH-TO-THE-JAR and PORT with their correct values, move the file to /etc/init: | + | |
- | < | + | Obviously, if you want the application to start automatically when your server boot up, you should make sure to create a service, or configure your web server (like Tomcat) to use vigilia-server.jar. |
- | sudo mv vigilia.conf / | + | |
- | </ | + | |
- | That's it! | ||
- | Now reboot and Vigilia should start automatically. | ||
- | To get more info about Upstart and services, see http:// | + | ===== Loggers ===== |
+ | Wacnet... |
suppliers/hvac.io/vigilia/installation.txt · Last modified: 2020/10/04 01:53 by 173.249.2.13