Installation Wisemapping

De EjnTricks

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

Hand-icon.png Votre avis

Nobody voted on this yet

 You need to enable JavaScript to vote


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/wisemapping dans lequel les binaires sont installés.

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

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/wisemapping.

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/wisemapping/4.0.3

#sudo unzip /var/opt/wisemapping/wisemapping-v4.0.3.zip -d /var/opt/wisemapping
#sudo rm /var/opt/wisemapping/wisemapping-v4.0.3.zip

Ceci entraine la création du répertoire wisemapping-v4.0.3 dont le contenu est le suivant.

#sudo ls -l /var/opt/wisemapping/wisemapping-v4.0.3
total 424
-rw-rw-r--  1 root root   1614 sept.  3  2014 about.html
drwxrwxr-x  2 root root   4096 sept.  3  2014 bin
drwxr-xr-x  3 root root   4096 oct.  29  2015 config
drwxrwxr-x  2 root root   4096 oct.  29  2015 contexts
drwxrwxr-x  2 root root   4096 sept.  3  2014 contexts-available
drwxrwxr-x  2 root root   4096 sept.  3  2014 etc
drwxrwxr-x 10 root root   4096 sept.  3  2014 lib
-rw-rw-r--  1 root root  11358 sept.  3  2014 LICENSE-APACHE-2.0.txt
-rw-rw-r--  1 root root  16560 sept.  3  2014 LICENSE-ECLIPSE-1.0.html
drwxrwxr-x  2 root root   4096 sept.  3  2014 logs
-rw-rw-r--  1 root root   6262 sept.  3  2014 notice.html
drwxrwxr-x  6 root root   4096 sept.  3  2014 overlays
-rw-rw-r--  1 root root   1490 sept.  3  2014 README.txt
drwxrwxr-x  2 root root   4096 sept.  3  2014 resources
drwxr-xr-x  2 root root   4096 oct.  29  2015 service
-rw-rw-r--  1 root root   2277 sept.  3  2014 start.ini
-rw-rw-r--  1 root root  46325 sept.  3  2014 start.jar
-rwxr-xr-x  1 root root     89 oct.  29  2015 start.sh
-rw-rw-r--  1 root root 279704 sept.  3  2014 VERSION.txt
drwxrwxr-x  3 root root   4096 oct.  29  2015 webapps

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

#sudo mv /var/opt/wisemapping/wisemapping-v4.0.3 /var/opt/wisemapping/4.0.3

Seul le contenu du répertoire webapps sera utilisé afin de mettre à disposition sous Tomcat. le reste est utile dans le cadre d'une exécution autonome.

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.

#sudo chown -R tomcat8:tomcat8 /var/opt/wisemapping/4.0.3/webapps/wisemapping
#sudo find /var/opt/wisemapping/4.0.3/webapps/wisemapping -type d -exec chmod 0700 {} \;
#sudo find /var/opt/wisemapping/4.0.3/webapps/wisemapping -type f -exec chmod 0600 {} \;


Icon-Configuration-Settings.png Configurations

L'objectif est de déploiée l'application sous Tomcat et de l'exposer derrière un serveur Apache. La configuration de l'application permet de spécifier l'URL racine pour l'application et la service REST, utilisés dans le cadre de l'administration.

Paramètre Valeur
site.baseurl Configuration de l'URL racine de l'application
documentation.services.basePath Configuration de l'URL racine pour la documentation des services rest.

Comme l'application va être exposée derrière un serveur Apache, il est nécessaire de modifier les URLs racine avec par exemple http://NOM_SERVEUR/wisemapping.

Ces paramètres se situent dans le fichier webapps/wisemapping/WEB-INF/app.properties. Le premier paramètre se situe dans la section Site configuration, où les commentaires invitent à effectuer la modification.

##################################################################################
# Site configuration
##################################################################################

# Site administration user. This user will have special permissions for operations such as removing users, set password
# etc.
admin.user = admin@wisemapping.org

# Base URL where WiseMapping is deployed. By default, It will be automatically inferred.
# If you are planning to put wisemapping behind an Apache using an Apache Proxy setup, you must enable this property.
#site.baseurl = http://example.com:8080/wisemapping
site.baseurl = http://NOM_SERVEUR/wisemapping


# Site Homepage URL. This will be used as URL for homepage location.
site.homepage = c/home

Le second paramètre se configure dans la section REST Documentation.

# REST Documentation
#
# This properties are used for REST API Documentation( http://localhost:8080/wisemapping/doc/rest/index.html)
# Change the URL for proper documentation console setup.
#documentation.services.basePath=http://localhost:8080/service
documentation.services.basePath=http://NOM_SERVEUR/wisemapping/service
documentation.services.version=3.0.1

Attention', la valeur par défaut ne contient pas le context, par défaut wisemapping, de l'application et il est nécessaire de le rajouter.


Icon-database.png Configuration MySql

Icon-log.png Fichier log

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/wisemapping/4.0.3/webapps/wisemapping /var/lib/tomcat8/webapps/wisemapping
#sudo chown -h tomcat8:tomcat8 /var/lib/tomcat8/webapps/wisemapping

Configuration-icon.png Publication sous Apache

Browser Icon.png Premier accès

Après installation, l'accès à l'application est disponible. Une page d'authentification est alors présentée à l'utilisateur.


A noter qu'il est possible par défaut de créer un compte, car ceux-ci sont stockés dans la base de données. Un mécanisme de vérification est mis en place à l'aide de Google recaptcha qui est activé par défaut dans le fichier WEB-INF/app.properties dans la section Users Registration Configuration.

##################################################################################
# Users Registration  Configuration
##################################################################################

# Enable captcha confirmation
google.recaptcha.enabled = true

# ReCaptcha is the default captcha. Public and private keys are required.
# More Info: http://www.google.com/recaptcha .
google.recaptcha.privateKey = 6LeQ4tISAAAAAMfHMPRKyHupTfA-KE4QeTCnLXhK
google.recaptcha.publicKey =  6LeQ4tISAAAAALzCGKNgRv8UqsDx7Cb0vq4wbJBr


Viewer icon.png Voir Aussi

Procédure d'installation sous Framasoft : http://framacloud.org/cultiver-son-jardin/installation-de-wisemapping/