Mettre à jour le logiciel

Voici comment procéder pour mettre à jour Loxya sur votre propre serveur (on-premise).

SaaS
Si vous disposez d'une instance hébergée par nos soins, il vous suffit de nous contacter (en répondant simplement au message qui vous informe de la nouvelle version), et nous nous chargeons de mettre à jour votre Loxya pour vous !

Cette documentation est à jour avec la version 1.3 de 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 ouvrez un terminal sur ce dossier pour lancer à nouveau l'assistant d'installation, avec la commande ./bin/console install.

4. Utiliser l'assistant d'installation

Attention
Si vous effectuez une mise à jour depuis une version antérieure à la version 1.3, que vous utilisez le module de facturation et que vous aviez modifié les modèles des documents (factures et devis) dans l'ancienne version, alors il faut impérativement répliquer les changements que vous aviez effectué dans ces modèles AVANT de lancer cette étape, car ces documents vont être "figés" dans le dossier /data lors de la migration de la base de données. Les fichiers à modifier sont les suivants :
- src/views/pdf/estimate/legacy.twig pour les devis,
- src/views/pdf/invoice/legacy.twig pour les factures.

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 "mise à jour de la base de données" de l'assistant, le logiciel exécutera les migrations 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, les tâches CRON et les éventuelles modifications des templates de documents

Vérifiez la présence et la bonne marche des tâches CRON que vous avez définies pour Loxya. Si une nouvelle tâche CRON est présente dans le fichier src/App/Config/CRON.json, alors il faut l'ajouter !

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 .