====== Graphivac Server Installation ======

Graphivac server runs on [[http://www.java.com|Java]], meaning it can work on Linux, Windows and Mac.

===== Java =====

Make sure you have Java on your machine. (preferably 8 or higher) 

To do so, open a command window and type
<code> java -version </code>

You should see the current Java installed, if any:

{{:suppliers:hvac.io:vigilia:installation:java-version.png|}}

===== Graphivac Server =====

The entire Graphivac server is contained within a single .jar file.

This makes it surprisingly easy to update: just download the latest compiled version and overwrite the .jar file.
(Your license and configurations are stored separately and will continue to work as expected.)

The application can be started with the following command:

<code> java -jar graphivac-server.jar <port number> </code> 
(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:
<code> http://localhost:<port number> </code>

NB: When downloading new versions, you might need to rename the java file.
===== Adding Graphivac as a Service =====

You might want to make sure the Graphivac 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 Graphivac as a service.

Start by creating a file named "**graphivac.conf**".

Open it and paste the following:


<code bash graphivac.conf>

description "Graphivac Server"
author "Christian Fortin, HVAC.IO"

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 /home/hvacio/graphivac
#replace PORT with the desired port number
script
    cd PATH-TO-THE-JAR
    java -jar graphivac-server.jar PORT &
end script

</code>

Now, once you replaced PATH-TO-THE-JAR and PORT with their correct values, move the file to /etc/init:

<code>
sudo mv graphivac.conf /etc/init/graphivac.conf
</code>

That's it!
Now reboot and Graphivac should start automatically.

To get more info about Upstart and services, see http://upstart.ubuntu.com/cookbook/.