Mise à jour d'une installation AmapJ sur un VPS
Dans cette procédure, nous supposons que vous avez installé AmapJ avec l'utilisateur amap1 sur votre VPS, en version V015
La procédure suivante va vous indiquer comment mettre à jour AmapJ et l'upgrader en version V016
Nota : V015 et V016 sont des exemples, ça marchera aussi entre V031 et V032 ...
Préparation de la mise à jour
Se logguer en tant que amap1, et se rendre dans le répertoire install
cd /home/amap1
cd installl
Ensuite, vous créez le répertoire correspondant à la nouvelle version : V016
mkdir V016
Vous telechargez ensuite AmapJ avec la commande suivante , et vous dezippez le tout
cd V016
wget http://amapj.fr/dist/amapj-dist-V016.zip
unzip amapj-dist.zip
Backup des données
Verifiez que personne n'est connecté sur l'application (par le biais de l'interface WEB master). Si personne n'est connecté, arrêtez le serveur.
cd /home/amap1
cd tomcat/bin
sh shutdown.sh
Faites une copie de vos données sur une machine distante.
Pour cela, avec scp ou WinSCP, copiez le contenu du repertoire /home/amap1/amapj-db sur une autre machine sécurisée.
Upgrade du schema de la base - PHASE 1
C'est l'opération la plus délicate.
Il faut d'abord déterminer les requetes SQL de la PHASE 1 : pour cela, allez sur la page "Télécharger", puis "Suivi des versions",
puis rendez vous au niveau de la version V016, puis cliquez sur le lien "Procédure de mise à jour : Instructions"
Redemarrez Tomcat
cd /home/amap1
cd tomcat/bin
sh startup.sh
Connectez vous ensuite avec l'interface WEB master, et executez les requetes SQL de la PHASE 1 UNIQUEMENT, sur les bases indiquées.
En cas d'erreur lors de l'execution des requetes SQL, vous devez abandonner la mise à jour. Pour cela, vous arrêtez de nouveau tomcat, vous restaurez le repertoire /home/amap1/amapj-db et vous redémarrez sur l'ancienne version.
Changement de la version de AmapJ
Arreter Tomcat
Editer le fichier /home/amap1/tomcat/conf/Catalina/localhost/amapj.xml
Remplacer la ligne
<Context path="/" docBase="/home/amap1/install/V015/amapj-war">
par
<Context path="/" docBase="/home/amap1/install/V016/amapj-war">
Redemarrez Tomcat
Upgrade du schema de la base - PHASE 2
Connectez vous ensuite avec l'interface WEB master, et executez les requetes SQL de la PHASE 2 UNIQUEMENT, sur les bases indiquées.
Les requetes de la phase 2 sont aussi indiquées sur la page "Télécharger" / Suivi des versions"
En cas d'erreur lors de l'execution des requetes SQL, vous devez abandonner la mise à jour.
Tests finals
Faites un test final, normalement tout est OK !
Verifiez la version dans l'écran "Maintenance"