https://wisemapping.atlassian.net/wiki/display/WS/Binary+Download
First install JAVA
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.
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.
Téléchargement
L’application est téléchargée dans le répertoire /var/opt/wisemapping.
#sudo wget -P /var/opt/wisemapping https://bitbucket.org/wisemapping/wisemapping-open-source/downloads/wisemapping-v4.0.3.zip
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.
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 {} \;
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 = [email protected]
# 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.
Configuration MySql
Fichier log
Activation sous Tomcat
L’installation et la configuration étant mise en place, il faut à présent déploier 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
Publication sous Apache
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