Installation Lavagna

De EjnTricks

Cet article présente l'installation de Lavagna sur une machine Ubuntu.


Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


Bug-icon.png Déploiement Tomcat

Attention, les versions 1.7.0.2 et 1.1-M1 ne démarrent pas correctement sous Tomcat 8, du fait du mode de chargement du driver de la base de données. Des fixs ont été mis en place dans la branche de développement. Cependant, cette article présente la philosophie de la mise en place. Afin d'assurer le fonctionnement sous Tomcat 8, la version en cours de développement, relativement stable, sera utilisée pour une mise à jour.


System-Install-icon.png Installation initiale

Par défaut, l'application dispose de son propre serveur d'application. Dans le cadre de cette installation, elle est installée sur un serveur Tomcat avec une structure légèrement différente que les autres applications. Afin de faciliter les montées de versions, elle ne sera pas placée directement dans le répertoire webapps de Tomcat.

Folder-icon.png Initialisation

L'application va être installée sous /var/opt/ avec une organisation qui doit permettre de faciliter les montées de version. Un répertoire commun est mis en place /var/opt/lavagna dans lequel les binaires sont installés.

#sudo mkdir -p /var/opt/lavagna
#sudo chown tomcat8:tomcat8 /var/opt/lavagna

A noter les droits d'accès pour le compte Tomcat, tomcat8, car l'application sera exécutée par celui-ci.

Download-icon.png Téléchargement

L'application est téléchargée dans le répertoire /var/opt/lavagna.

System-Install-icon.png Installation

L'archive est décompressée et modifier pour être disponible sous un répertoire portant le numéro de version, à savoir /var/opt/lavagna/1.1-M1

#sudo unzip /var/opt/lavagna/lavagna-1.1-M1-distribution.zip -d /var/opt/lavagna
#sudo rm /var/opt/lavagna/lavagna-1.1-M1-distribution.zip

Ceci entraine la création du répertoire lavagna-1.1-M1 dont le contenu est le suivant.

#sudo ls -l /var/opt/lavagna/lavagna-1.1-M1
total 60
drwxr-xr-x 3 root root  4096 oct.   6 17:08 bin
drwxr-xr-x 2 root root  4096 oct.   6 17:08 lavagna
-rw-rw-r-- 1 root root 35147 oct.   6 17:07 LICENSE.txt
-rw-rw-r-- 1 root root 11171 oct.   6 17:08 NOTICE.txt
-rw-rw-r-- 1 root root  2036 oct.   6 17:07 README.txt

Il est donc renommé pour n'avoir que le numéro de version.

#sudo mv /var/opt/lavagna/lavagna-1.1-M1 /var/opt/lavagna/1.1-M1

Icon File Owner.png Propriétaire fichiers

L'objectif est de rendre disponible l'application dans un serveur Tomcat, et il est préférable de positionner les droits d'accès pour restreindre au compte de démarrage, soit tomcat8 dans le cadre de cette installation. Attention, la distribution téléchargée contient les fichiers de démarrage pour Windows et Linux, et il faut conserver les authorisations sur ceux-ci.

#sudo chown -R tomcat8:tomcat8 /var/opt/lavagna/1.1-M1
#sudo chmod -R go-rwx /var/opt/lavagna/1.1-M1

Multiples-icon.png Gestion des versions

Le déploiement de nouvelles versions doit être le plus simple possible. L'emplacement de l'instance active ne doit pas contenir le numéro de version, mais plutôt être un lien générique qui sera modifié. Ce lien est créé sous /var/opt/lavagna/installed.

#sudo ln -s /var/opt/lavagna/1.1-M1 /var/opt/lavagna/installed
#sudo chown -h tomcat8:tomcat8 /var/opt/lavagna/installed


Icon-database.png Configuration MySql

Vues-icon.png Activation sous Tomcat

L'installation et la configuration étant mise en place, il faut à présent déployer l'application sous Tomcat. Il suffit de créer un lien dans le répertoire webapps du serveur, comme si elle avait été installée dedans.

#sudo service tomcat8 stop
#sudo ln -s /var/opt/lavagna/installed/lavagna/lavagna.war /var/lib/tomcat8/webapps/lavagna.war
#sudo chown -h tomcat8:tomcat8 /var/lib/tomcat8/webapps/lavagna.war


Configuration-icon.png Publication sous Apache

Network Admin.png Initialisation

Run-icon.png Post installation

Après installation, il ne faut pas oublier de modifier les droits d'accès du compte MySql, comme indiqué dans la procédure configuration MySQL.

mysql> REVOKE ALL on lavagna.* FROM 'lavagna'@'127.0.0.1';
Query OK, 0 rows affected (0.00 sec)

mysql> GRANT SELECT, INSERT, UPDATE, DELETE, TRIGGER, EXECUTE ON lavagna.* TO 'lavagna'@'127.0.0.1';
Query OK, 0 rows affected (0.00 sec)
 
mysql> FLUSH PRIVILEGES;
Query OK, 0 rows affected (0.00 sec)


Update icon.png Update

Comme indiqué en début d'article, les versions officielles sont problématiques avec Tomcat 8. Les versions en cours de développement seront utilisées après la version 1.1-M1. Git n'est pas installé sur la machine, mais le code source est téléchargé pour être compilé à l'aide de Maven.

#mvn package -DskipTests=true
.
.
.
[INFO] Building zip: /tmp/lavagna-master/target/lavagna-1.1-M2-SNAPSHOT-distribution.zip
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 55.676 s
[INFO] Finished at: 2017-01-30T21:03:41+01:00
[INFO] Final Memory: 89M/948M
[INFO] ------------------------------------------------------------------------

Cela génère donc les différentes distributions, que l'on peut déployer. Il suffit ensuite de faire l'installation comme si la version avait été télécharége.

#sudo unzip /tmp/lavagna-master/target/lavagna-1.1-M2-SNAPSHOT-distribution.zip -d /var/opt/lavagna
#sudo mv /var/opt/lavagna/lavagna-1.1-M2-SNAPSHOT /var/opt/lavagna/1.1-M2
#sudo chown -R tomcat8:tomcat8 /var/opt/lavagna/1.1-M2
#sudo chmod -R go-rwx /var/opt/lavagna/1.1-M2
#sudo rm /var/opt/lavagna/installed
#sudo ln -s /var/opt/lavagna/1.1-M2 /var/opt/lavagna/installed
#sudo chown -h tomcat8:tomcat8 /var/opt/lavagna/installed


Viewer icon.png Voir Aussi

Documentation officielle: http://help.lavagna.io/