Installation manuelle - Windows

Cette page décrit le processus d'installation manuelle de la solution Navixy On-premise sous Windows. Nous recommandons d'utiliser Windows Server 2016 ou une version plus récente. Si vous souhaitez installer la plateforme sur une autre version de Windows, par exemple des versions desktop, vous pouvez néanmoins appliquer ce guide, car les principes de base et les logiciels sont les mêmes. Cependant, seules les versions Server sont considérées comme une solution fiable.

L'installation entièrement manuelle de Navixy On-premise pour Windows est fournie aux clients qui ont besoin d'un contrôle total sur le processus d'installation ou qui ont des exigences de configuration personnalisées. En général, il est recommandé d'effectuer une installation automatisée sur Linux, car elle est beaucoup plus simple et flexible non seulement pour l'installation initiale, mais aussi pour l'administration et la maintenance futures. Les instructions d'installation sous Windows sont disponibles pour les clients qui s'orientent exclusivement vers cet OS en raison d'exigences d'entreprise ou d'autres raisons internes.

Bien que la plateforme utilise les mêmes logiciels tiers sur Linux et Windows, la principale différence de fonctionnement réside dans la manière dont les services fonctionnent sous Windows :

Les services Java sont convertis en services Windows à l'aide du logiciel YAJSW.
Nginx n'est pas un service mais un programme ordinaire s'exécutant en arrière-plan.

Pour effectuer l'installation, vous avez besoin d'un compte Windows avec privilèges administrateur. Peu importe s'il s'agit d'un compte local ou de domaine car la plateforme n'est liée en rien à l'infrastructure de domaine. Vous avez uniquement besoin de droits suffisants pour l'installer.

Installer les logiciels prérequis

Téléchargez et installez les prérequis décrits dans le Logiciels serveur document. En substance, vous aurez besoin de ces composants pour faire fonctionner la plateforme :

MySQL 8.0 - seul Server est requis, les autres composants sont optionnels ;
- Microsoft Visual C++ peut être requis pour l'installation. L'assistant d'installation vous en informera.
Java SE Development Kit 21;
Nginx - n'importe quelle version récente (il n'est pas nécessaire de l'installer, il suffit de l'extraire) ;

En plus des composants de base, il est également recommandé d'installer les logiciels suivants pour faciliter le travail ultérieur :

Un utilitaire d'archivage capable de décompresser les fichiers tar.gz - par exemple 7-Zip.
Éditeur de texte avancé pour travailler avec les configurations et les grands fichiers journaux - par exemple Notepad++.

Il est fortement recommandé d'installer les logiciels tiers uniquement depuis des ressources officielles - de préférence depuis les liens ci‑dessous. Si un logiciel est installé depuis des ressources non fiables, l'opérabilité n'est pas garantie.

Configuration de MySQL

Après l'installation de MySQL Server, vous devez appliquer des modifications à sa configuration pour que la plateforme Navixy fonctionne correctement avec la base de données. La configuration est spécifiée dans my.ini fichier situé au chemin suivant :

C:\ProgramData\MySQL\MySQL Server 8.0\my.ini

Dans ce fichier vous devez définir les paramètres ci‑dessous sous la [mysqld] section. S'ils sont déjà présents, modifiez-les en conséquence.

default-time-zone='+00:00'
sql-mode="NO_ENGINE_SUBSTITUTION"
innodb_buffer_pool_size=10G

Le innodb_buffer_pool_size ce paramètre est la quantité de RAM allouée à MySQL. Il est fortement recommandé de définir ce paramètre à 70 % de la RAM totale sur votre serveur (en gigaoctets).

Après avoir modifié la configuration, enregistrez le fichier et redémarrez MySQL depuis la console Services de Windows (services.msc) pour appliquer les modifications.

Variables d'environnement

Java et MySQL bin les dossiers doivent être spécifiés dans la variable d'environnement système PATH de Windows. Ces dossiers sont (par défaut) les suivants :

C:\Program Files\Java\jdk-21\bin
C:\Program Files\MySQL\MySQL Server 8.0\bin

Le dossier d'installation de Java doit également être ajouté à la nouvelle variable système JAVA_HOME . Ceci est requis pour que les services backend fonctionnent correctement

Les noms de dossiers peuvent varier d'une version à l'autre, donc vérifiez d'abord les chemins réels.

Vous pouvez mettre à jour les variables d'environnement avec les commandes suivantes depuis la ligne de commande :

setx /m Path "%PATH%;C:\Program Files\Java\jdk-21\bin;C:\Program Files\MySQL\MySQL Server 8.0\bin"
setx /m JAVA_HOME "C:\Program Files\Java\jdk-21"

Cela créera les valeurs requises.

Vous pouvez également mettre à jour manuellement les variables Path et JAVA_HOME dans les propriétés système.

En conséquence, vous devez avoir les éléments suivants :

Après l'enregistrement des variables, ouvrez la ligne de commande et vérifiez les versions des logiciels avec les commandes suivantes :

mysql -V
java -version

Si les versions sont renvoyées, alors les variables sont configurées correctement.

Si vous voyez des erreurs comme n'est pas reconnu en tant que commande interne ou externe, vérifiez les chemins que vous avez spécifiés précédemment.

Décompresser la plateforme

Le paquet de distribution Navixy est fourni sous la forme d'une archive .tar.gz. La dernière version est toujours disponible en téléchargement au lien suivant :

⬇️ Télécharger le paquet Navixy On-premise

Placez‑le dans n'importe quel dossier sur votre serveur et extrayez‑le.

Le paquet contient de nombreux dossiers imbriqués, donc faites attention à ne pas dépasser la limite Windows de 255 caractères dans le chemin de fichier.

Placez le dossier navixy-package depuis l'archive dans un répertoire tel que : C:\distrib\navixy-package

Dorénavant, ceci sera le dossier principal de la distribution. Plus loin dans cette instruction vous trouverez des chemins comme ...navixy-package/db, ce qui signifie que les opérations doivent être effectuées depuis ce dossier et ses sous‑dossiers.

Après avoir décompressé la plateforme et préparé tous les prérequis, vous êtes prêt à lancer l'installation de la plateforme Navixy.

Bases de données Navixy

Tout d'abord, vous devez effectuer la configuration de la base de données MySQL. Il est recommandé de travailler avec MySQL depuis la ligne de commande. Connectez‑vous à MySQL en tant que root utilisateur avec le mot de passe que vous avez défini lors de l'installation de MySQL :

mysql -uroot -p

Exécutez le bloc de requêtes ci‑dessous. Remplacez <PASSWORD> par un nouveau mot de passe pour navixy l'utilisateur, souvenez‑vous en, vous en aurez besoin plus tard.

CREATE USER navixy@'%' IDENTIFIED BY '<PASSWORD>' WITH MAX_QUERIES_PER_HOUR 0 MAX_UPDATES_PER_HOUR 0 MAX_CONNECTIONS_PER_HOUR 0 MAX_USER_CONNECTIONS 0;
CREATE DATABASE google CHARACTER SET utf8 COLLATE utf8_general_ci;
CREATE DATABASE tracking CHARACTER SET utf8 COLLATE utf8_general_ci;
GRANT USAGE ON *.* to navixy@'%';
GRANT ALL PRIVILEGES ON google.* TO navixy@'%';
GRANT ALL PRIVILEGES ON tracking.* TO navixy@'%';

Cela créera des bases de données vides pour une utilisation ultérieure.

Quittez MySQL et revenez à la ligne de commande.

Contenu de la base de données

Changez le répertoire dans la ligne de commande en ...navixy-package\db.

Exécutez la commande suivante pour importer la structure des tables de données métier :

mysql -uroot -p google < google.sql

Après cela, supprimez le fichier updates.sql et google.sql avec les commandes suivantes, car ils ne sont pas nécessaires à l'étape suivante :

del updates.sql
del google.sql

Maintenant, importez les fichiers restants dans la base de données en utilisant cette commande :

type *.sql | mysql -uroot -p google

Serveur de fichiers

Connectez‑vous à MySQL à nouveau et exécutez la requête SQL ci‑dessous. Cela permettra de téléverser des fichiers depuis l'application mobile et l'interface web vers votre serveur, ce qui est requis lors de l'utilisation des formulaires de service terrain, de la maintenance des véhicules et d'autres fonctionnalités. Changez api.domain.com pour votre domaine API, et changez https vers http si vous n'utilisez pas SSL.

INSERT INTO google.file_storages (id, engine, config) values (1, 'local_fs', '{"base_path":"./files/","base_upload_url":"https://api.domain.com/file/upload","base_download_url":"https://api.domain.com/file/dl","secret":"s3cCr3Et","upload_credentials_ttl":"10m","is_dynamic_preview_enabled": true,"dynamic_preview_pattern":"(.+)/file/dl/(.+)","dynamic_preview_replace":"$1/file/preview/$2","security_module":{"type":"hashid","salt":"S4lTh45hV4lu3","ttl":"7d","min_length":8}}');

Les valeurs de secret et salt sont recommandées d'être un hachage aléatoire de lettres et de chiffres.

Clé de licence

Enfin, appliquez la clé de licence (empreinte), qui doit être fournie par Navixy. Elle se présente comme une longue chaîne de symboles aléatoires.

Insérez l'empreinte dans la base de données avec la requête ci‑dessous. Changez <FINGERPRINT> par la valeur reçue) :

UPDATE google.variables SET value='<FINGERPRINT>' WHERE var='fingerprint';

L'empreinte est dynamique. Elle est mise à jour chaque fois que votre serveur se connecte au auth.navixy.com serveur de licences. Cela se produit tous les 3 jours et à chaque démarrage du service. Vous n'avez donc pas besoin de la stocker séparément de la plateforme car elle change constamment. Aussi, pour cette raison, vous ne pouvez pas l'utiliser sur plusieurs instances. La clé ne peut être utilisée que pour une seule instance Navixy On-premise.

Frontend

L'étape suivante consiste à configurer le frontend de la plateforme Navixy On-premise - configurer le serveur web Nginx et les fichiers statiques de l'interface utilisateur.

Create nginx dossier sur le disque C:.

md nginx

Copiez la distribution Nginx décompressée dans le C:\nginx.

Fichiers statiques

Créez un dossier nommé www dans C:\nginx. Copiez les dossiers panel-v2 et pro-ui depuis navixy-package dans celui‑ci. Ce sont les dossiers contenant les fichiers statiques du site Navixy - en réalité, tout son contenu visible. Maintenant vous devez renommer les fichiers de configuration :

Ouvrir \panel-v2 dossier et renommez le fichier PConfig.example.sa.js vers PConfig.js.
Ouvrir \pro-ui et renommez Config.example.sa.js vers Config.js.
Ouvrir \pro-ui\static et renommez app_config.example.sa.js vers app_config.js.

Dans toutes les étapes ci‑dessus, supprimez simplement .example.sa du nom des fichiers. Faites attention à ne pas confondre des fichiers aux noms similaires dans les dossiers.

Nginx

Ajoutez les lignes suivantes au bloc http du fichier C:\nginx\conf\nginx.conf :

include conf.d/*.conf;
server_names_hash_bucket_size 64;

Copiez un dossier nommé include from ...navixy-package\windows\nginx vers dans le dossier C:\nginx\conf

Créez un dossier nommé conf.d dans dans le dossier. Ce dossier contiendra la configuration du site de la plateforme.

Copiez ces fichiers depuis ...navixy-package\windows\nginx vers le nouveau dossier C:\nginx\conf\conf.d :

map.conf
navixy.conf

Si vous allez utiliser la protection SSL sur votre serveur, de sorte que votre site s'ouvre via HTTPS, copiez également ce fichier :

navixy_ssl.conf

Maintenant, configurez navixy.conf et navixy_ssl.conf selon la page Configurations Nginx . Ce sont les principaux fichiers de configuration pour le serveur web, donc prenez un soin particulier lors de leur édition.

Pour configurer la plateforme afin qu'elle fonctionne via HTTPS, vous aurez besoin d'un certificat SSL valide émis pour votre domaine, ainsi que de sa clé privée. En l'absence du certificat et de sa clé privée correspondante, le serveur web avec l'option « 443 ssl » ne pourra pas démarrer. Pour en savoir plus sur les certificats SSL et leur fonctionnement sur la plateforme, veuillez consulter Installation des certificats SSL page.

Une fois tout cela réalisé - exécutez nginx.exe en tant qu'administrateur. Assurez‑vous qu'il est actif dans le Gestionnaire des tâches (normalement il a deux processus ou plus). S'il cesse de fonctionner, vérifiez C:\nginx\logs\error.log pour les erreurs et agissez en conséquence.

Backend

Cette partie consiste en deux étapes : la configuration des services Java et leur conversion en services Windows.

Services Java - pré-configuration

Create java dossier sur le disque C:.

md java

Copiez les dossiers suivants depuis ...navixy-package vers C:\java:

api-server
sms-server
tcp-server

Dans chacun de ces dossiers, déplacez le sous‑dossier conf depuis le sous‑répertoire dist vers le dossier du service. Utilisez les commandes suivantes dans la ligne de commande pour faciliter cela.

move C:\java\api-server\dist\conf C:\java\api-server\
move C:\java\sms-server\dist\conf C:\java\sms-server\
move C:\java\tcp-server\dist\conf C:\java\tcp-server\

Ouvrez chacun des trois sous‑dossiers conf un par un et trouvez les fichiers db.properties à l'intérieur. Ce sont les fichiers de configuration des services de la plateforme pour se connecter à la base de données. Pour assurer le bon fonctionnement de chaque service, vous devez mettre à jour les informations de connexion à la base de données pour chacun d'eux. Modifiez les lignes suivantes dans les fichiers de configuration (<PASSWORD> se réfère au mot de passe que vous avez précédemment créé pour l'utilisateur « navixy »)

db.username=navixy
db.password=<PASSWORD>

Si votre base de données est hébergée sur un serveur séparé, vous devez également changer la ligne db.connectionString dans les mêmes fichiers. Spécifiez l'adresse réelle de votre serveur de base de données à la place de localhost, mais ne changez rien d'autre dans cette chaîne.

Services Java - API-server

Ouvrez le fichier C:\java\api-server\conf\config.properties.

Modifiez les lignes suivantes :

api.externalBaseUrl= - URL de votre domaine API (avec http:// ou https:// au début). i
feedback.toEmail=test@localhost - adresse pour recevoir les demandes d'assistance/retours des utilisateurs.
feedback.defaultFromEmail=do-not-reply@localhsot - expéditeur par défaut des emails d'aide.
feedback.substituteFromEmail=false - bascule indiquant si les messages d'aide sont envoyés depuis l'expéditeur par défaut (false) ou depuis l'adresse email personnelle de l'utilisateur (true).

Si vous n'avez pas de domaine dédié pour l'API, votre domaine de base est spécifié ici avec /api ajouté, par exemple : https://my.domain.com/api

Services Java - SMS-server

Ce service ne requiert pas de configuration et utilise les paramètres par défaut.

Services Java - TCP-server

Ouvrez le fichier C:\java\tcp-server\conf\config.properties.

Modifiez les lignes suivantes :

externalIP=127.0.0.1 - spécifiez l'adresse IP de votre interface utilisateur à la place de 127.0.0.1.
externalHostname=myhost.ru - spécifiez le domaine de votre interface utilisateur à la place de myhost.ru.

Les paramètres ci‑dessus seront utilisés pour l'activation automatique des appareils.

Services Java - conversion en services Windows

À cette étape, un logiciel tiers est utilisé - il s'appelle YAJSW (Yet Another Java Service Wrapper). Il s'agit d'un freeware utilisé pour exécuter des applications Java en tant que services Windows. Plus d'informations sont disponibles sur la page web du projet. Le logiciel lui‑même est inclus dans le paquet Navixy.

Copiez le dossier nommé wrapper from ...navixy-package\windows vers C:\java.

Exécutez la ligne de commande en tant qu'administrateur et changez le répertoire comme suit :

cd C:\java\wrapper\bat

Exécutez setenv.bat depuis ce répertoire dans la ligne de commande.

setenv.bat

Exécutez les commandes suivantes, une par une :

wrapper.bat -i ../conf/wrapper.api-server.conf
wrapper.bat -i ../conf/wrapper.sms-server.conf
wrapper.bat -i ../conf/wrapper.tcp-server.conf

Cela installera les services Java de la plateforme en tant que services Windows classiques.

Ouvrez le "Services" console. Vous pouvez la rechercher dans le menu Démarrer, ou simplement exécuter ce qui suit dans cmd :

services.msc

Parcourez la liste des services et trouvez les services Navixy nouvellement installés. Lancez‑les un par un.

Navixy api-server
Navixy sms-server
Navixy tcp-server

Assurez‑vous que les services restent opérationnels dans le temps - ils doivent avoir un statut « Running » en permanence. Si l'un d'eux plante, vérifiez leurs journaux pour d'éventuelles erreurs.

Étapes finales

Accès au panneau Admin

Une fois que tout est installé et lancé, vous devez vérifier la disponibilité du domaine de votre panneau Admin dans votre navigateur. Lorsque vous le saisissez dans la barre d'adresse, vous devriez être dirigé vers la page de connexion. Si le domaine ne vous redirige pas vers la page correcte, vérifiez à nouveau la configuration de votre serveur web pour vous assurer qu'elle est correcte.

Envisagez de changer votre mot de passe pour le panneau Admin dès que vous vous connectez au système, car les identifiants sont par défaut :

nom d'utilisateur : admin
mot de passe : admin

Accès à l'interface utilisateur

Pour que l'interface utilisateur soit disponible, vous devez d'abord spécifier son domaine dans Admin panel → Service Preferences, comme décrit dans ce document : Nom de domaine.

Si ce qui précède n'est pas fait, l'interface utilisateur ne pourra pas s'ouvrir.

Mises à jour

Pour mettre à jour Navixy déployé sur un système Windows vers la version la plus récente, veuillez vous référer à ce document : Update on Windows

Dépannage

Si vous rencontrez des problèmes pendant le processus d'installation ou de configuration, veuillez consulter les Dépannage pages pour des solutions possibles.

PrécédentInstallation automatique - Windows SuivantMise à jour

Mis à jour il y a 4 mois

Ce contenu vous a-t-il été utile ?