Mettre à jour Velnex

Velnex vérifie chaque nuit si une nouvelle version existe ; rien n’est jamais installé sans vous. Un badge apparaît alors sur Système → Mises à jour (vous pouvez aussi cliquer sur Rechercher une mise à jour). Toutes les mises à jour sont incluses tant que la licence est active.

Avant de commencer

Faites une sauvegarde de la base de données (voir « Sauvegardes ») : la mise à jour sauvegarde les fichiers qu’elle remplace, pas la base.

Installer

Système → Mises à jour → Installer la version x.y.z. Le site passe en maintenance une à deux minutes, le temps de :

1. télécharger la nouvelle version ;
2. vérifier sa signature : un paquet non signé par Velnex est refusé ;
3. sauvegarder les fichiers remplacés et mettre le site en maintenance ;
4. copier les nouveaux fichiers (votre .env, le dossier storage/ — extensions comprises — et bootstrap/cache ne sont jamais touchés) ;
5. mettre à jour la base de données, les permissions de l’équipe, et vider les caches.

Relancez ensuite les services de fond, pour qu’ils utilisent le nouveau code :

systemctl restart velnex-queue velnex-console

Si la mise à jour échoue

Velnex remet automatiquement les fichiers d’origine en place et affiche l’erreur. Le déroulement est visible dans Déroulement de la dernière installation et l’historique dans Historique.

1. Lisez l’erreur, puis le journal : tail -n 100 /var/www/velnex/storage/logs/laravel.log.
2. Causes fréquentes :
   • dossier non accessible en écriture par www-data : chown -R www-data:www-data /var/www/velnex ;
   • licence inactive sur ce domaine, ou serveur de licences injoignable ;
   • un dossier .git dans l’installation (installation modifiée à la main) : la mise à jour en un clic est refusée.
3. Corrigez et relancez la mise à jour.

Les modifications de base de données déjà appliquées ne sont pas annulées : si le site ne fonctionne plus, restaurez la sauvegarde de la base faite avant, puis contactez le support avec l’erreur affichée.

Les extensions

Les thèmes et extensions du marketplace se mettent à jour séparément : Système → Extensions → Mettre à jour vers …. Après une mise à jour de Velnex, une extension peut demander une version plus récente de son côté : vérifiez cette page.