Mise à jour automatique - Linux

Le processus de mise à jour de la plateforme Navixy consiste généralement en trois parties : mise à jour de la base de données, mise à jour des fichiers de service Java et mise à jour des fichiers de service web. Il est important de suivre attentivement les instructions de mise à jour et de s'assurer que chaque partie de la mise à jour est menée à bien sans rencontrer d'erreurs.

Si des erreurs ou d'autres difficultés surviennent pendant le processus de mise à jour, veuillez contacter le support technique Navixy immédiatement. Des mises à jour initiées et incomplètes peuvent provoquer un dysfonctionnement ou rendre la plateforme indisponible.

Vérification des prérequis

Avant d’installer, veuillez vous assurer que votre système répond aux prérequis suivants :

1. Java Development Kit 21 À partir de mars 2025, la plateforme a déprécié la version 17 et les versions antérieures.

2. MySQL 8.0 À partir de mars 2024, la plateforme a déprécié MySQL 5.7. Cette version a atteint sa fin de vie (EOL) et n’est plus prise en charge.

La non-conformité aux logiciels requis empêchera la nouvelle version de la plateforme de démarrer. Cependant, une mise à jour préalable des prérequis permettra de maintenir la plateforme fonctionnelle.

Début de la mise à jour

Extrayez un paquet de distribution de la plateforme reçu de Navixy, en général il s’agit d’un .tar.gz fichier.

tar -zxvf $PACKAGENAME

(où $PACKAGENAME est le nom de tar.gz fichier)

Il sera extrait dans /navixy-package répertoire, contenant tous les fichiers de la plateforme. Ci-après, ce sera le répertoire principal de la distribution.

Mise à jour automatisée

Pour les instances hébergées sur des serveurs Linux, une solution de mise à jour automatisée est disponible. Il est fortement recommandé d'utiliser le update.sh script. Il effectue une mise à jour pas à pas de la base de données et des fichiers d'application, et vous n'avez pas besoin d'effectuer d'opérations internes manuelles.

Exécutez le update.sh script depuis le /navixy-package répertoire. Si votre plateforme est hébergée sur deux serveurs, exécutez le script sur le serveur d'application (là où les services Java s'exécutent).

root@server:/home/navixy-package# ./update.sh

Le script commencera par une mise à jour de la base de données. Si la base de données est sur un serveur séparé, le script récupérera les données de connexion à partir de la configuration des services Java.

Après la mise à jour de la base de données (qui peut prendre un certain temps), le script mettra à jour les fichiers système de la plateforme.

Si votre instance n'a pas été mise à jour depuis un certain temps, vous pouvez voir le message suivant pendant la mise à jour : Il semble que les services Navixy ne soient pas sous le contrôle de systemd. Voulez-vous créer des services systemd (les services runit seront supprimés) ? (y/n) Il est recommandé de répondre affirmativement. Le fait est que nous avons déprécié la runit méthode de démarrage des services, et utilisons maintenant systemd à cette fin. Le script s'occupera de tout pour vous. Cependant, si vous répondez non pour une raison quelconque, cela ne fera pas planter le système, et runit continuera de fonctionner. Vous pourrez passer à systemd lors de la prochaine mise à jour.

Mise à jour de la base de données (optionnelle)

Vous pouvez effectuer la mise à jour de la base de données séparément du reste de la plateforme si nécessaire. Pour ce faire, exécutez le update-db.sh script depuis le /navixy-package répertoire. Cela peut être fait soit sur le serveur de base de données (localhost) soit depuis un autre serveur en spécifiant l'adresse hôte. Après l'exécution du script, vous verrez le dialogue suivant :

Entrez l'hôte mysql [localhost] :
Entrez le port mysql [3306] :
Entrez le nom d'utilisateur mysql [root] :
Mise à jour de la base de données Navixy..
Entrez le mot de passe :

Les paramètres par défaut sont indiqués entre crochets. S'ils sont identiques aux paramètres réels (la mise à jour est effectuée depuis le serveur de base de données), vous n'avez rien à saisir : appuyez simplement sur Entrée. Si vous souhaitez spécifier un hôte différent, un port personnalisé ou un utilisateur différent, remplissez les paramètres appropriés.

Si quelque chose ne fonctionne pas correctement après la mise à jour, essayez de redémarrer les services de la plateforme en utilisant restart-navixy script. De plus, videz les données de votre navigateur ou vérifiez les problèmes en mode navigation privée.

---

Mise à jour manuelle

La mise à jour automatisée d'une plateforme déployée sur Linux est une solution éprouvée et il est fortement recommandé de l'utiliser. Par conséquent, les informations suivantes sont fournies à titre informatif uniquement et pour des cas d'installations spéciales non standard.

Mise à jour de la base de données

Ouvrir navixy-package/db répertoire et exécutez updates.sql fichier avec la commande suivante :

mysql -uroot -p$ROOTPASSWORD google < updates.sql

(où $ROOTPASSWORD est le mot de passe root MySQL)

Supprimer updates.sql et google.sql du dossier db.

Cela doit être fait afin de ne pas écraser la base de données à l'étape suivante.

rm updates.sql
rm google.sql

Assurez-vous que ces fichiers sont supprimés, puis exécutez tous les autres fichiers sql.

cat *.sql | mysql -uroot -p$ROOTPASSWORD google

Mise à jour des services Java

La mise à jour des services Java consiste simplement à remplacer les fichiers dans les répertoires de services sous /home/java. Ces répertoires sont :

• api-server

• sms-server

• tcp-server

Trouvez les répertoires correspondants dans navixy-package. Vous devez remplacer tous les fichiers à l'exception de config.properties et db.properties dans les conf dossiers. Comparez les config.properties fichiers existants avec ceux du nouveau distributif. Si vous voyez de nouveaux paramètres, ajoutez-les à la configuration existante.

Mise à jour des services Web

Accédez à /var/www répertoire. Remplacez tous les fichiers dans panel-v2 et pro-ui répertoires par les fichiers des répertoires correspondants du package de distribution. Cela ne corrompra aucune configuration, car les fichiers de configuration dans le package sont nommés comme exemple, et ne remplaceront pas les fichiers existants.

Comparez ces fichiers :

• panel-v2/Config.js,

• pro-ui/PConfig.js

• pro-ui/static/app_config.js

avec les exemples dans le paquet de distribution.

Si vous voyez de nouveaux paramètres, ajoutez-les.

Étapes finales

Redémarrez les services Java Navixy. Typiquement, cela se fait avec cette commande :

restart-navixy

Vérifiez que les services ont redémarré avec succès et fonctionnent pendant au moins une minute. Cela indique que le processus de mise à jour est terminé.