Mise à jour de l'application

Voici comment procéder pour mettre à jour Loxya.

Avant de commencer

Important
Avant tout, il faut impérativement faire une sauvegarde de la base de données !! Conservez bien le fichier SQL de votre sauvegarde. Aussi, il est recommandé de faire une sauvegarde de tous les dossiers du logiciel.

Vérifiez bien la compatibilité de votre serveur avec la nouvelle version du logiciel. En effet, la version minimale de PHP prise en charge par Loxya évolue souvent. Pour connaître la version de PHP minimale requise avant de procéder à l'installation, vous pourrez trouver cette information dans le fichier composer.json, dans le bloc "require", paramètre "php-64bits".

Vous pouvez également consulter le tableau des versions compatibles qui récapitule cela pour chaque version du logiciel.

1. Télécharger et décompacter

Après avoir téléchargé le fichier ZIP de la dernière version du logiciel, il suffit de copier le code source de la nouvelle version dans un autre dossier (pour éviter d'écraser l'ancienne version, au cas où).

2. Copier les paramètres et les données

Ensuite, la première chose à faire est de reprendre le fichier /src/App/Config/settings.json de l'ancienne version pour le copier dans le même dossier de la nouvelle version.

Il faut également copier le contenu du dossier /data de l'ancien dossier dans celui du nouveau dossier.

Note : Pour la mise à jour d'une variante Premium "on-premise" avec la version 1.0, il vous faudra sans doute re-télécharger le module PHP spécifique, qui a également été mis à jour.

3. Configurer l'hôte virtuel

Ensuite, faites pointer le nom de domaine de votre virtual host vers le dossier de la nouvelle version, puis visitez l'URL de votre Loxya pour lancer à nouveau l'assistant d'installation.

4. Utiliser l'assistant d'installation

Repassez sur toutes les étapes de l'assistant d'installation, en veillant bien à renseigner les accès à la base de données que vous utilisiez avec la version précédente.

À l'étape 5 de l'assistant, le logiciel exécutera la migration de votre base de données pour que sa structure soit compatible avec la nouvelle version. Si cette étape échoue, merci de consulter la section problèmes éventuels de la partie "installation".

5. Rétablir le logo et les éventuelles modifications des templates de documents

Si vous utilisez un logo d'en-tête pour les fichiers PDF générés par le logiciel, il faut remettre le fichier du logo dans le dossier src/public/img de la nouvelle version de Loxya.

De même, si vous aviez effectué des modifications des modèles de documents (fiches de sorties, devis et factures), il vous faut re-appliquer ces modification dans les fichiers de la nouvelle version, en les adaptant.

En cas de problème

Tout d'abord, merci de consulter la section problèmes éventuels de la partie "installation", pour voir si votre problème n'est pas déjà solutionné.

Si vous avez des difficultés à mettre à jour votre Loxya, nous pouvons vous aider ! Cette prestation, facturée 70,00 € H.T. vous permettra également de poser toutes vos questions à l'un des développeurs du logiciel directement. Prenez rendez-vous dès maintenant grâce au lien suivant : calendly.com/loxya/support-installation .

Nous pouvons aussi utiliser la plateforme de support pour demander de l'aide à la communauté.