# Assistant d'installation Les étapes d'installation varieront selon que vous prévoyez d'utiliser un serveur tout-en-un (généralement utilisé pour de petites instances) ou un serveur séparé pour l'application et la base de données (grande instance de plus de 1000 appareils). Veuillez sélectionner la section appropriée ci-dessous en fonction de votre type d'installation. L'installation nécessite le package de distribution de la plateforme Navixy. Il peut être téléchargé directement sur le serveur en utilisant la commande suivante : ``` wget --content-disposition https://get.navixy.com/latest ``` Une fois le package téléchargé, vous pouvez poursuivre l'installation. ## Option 1. Serveur tout-en-un Tout d'abord, décompressez la build de la plateforme Navixy fournie en tant que `tar.gz` archive. Allez dans le répertoire contenant l'archive et exécutez la commande suivante pour la décompresser (remplacez bien sûr **\** par le nom de fichier réel) : ``` tar -zxvf .tar.gz ``` L'archive sera extraite vers le répertoire `/navixy-package` . Ensuite, ouvrez ce répertoire et exécutez le script d'installation depuis celui-ci : ``` ./install.sh ``` Le script vérifiera la compatibilité du système d'exploitation et d'autres prérequis. Aucune action de votre part n'est requise à cette étape. ### Sélectionnez le rôle du serveur Il vous sera demandé de sélectionner le rôle du serveur pour le déploiement. Vous devez sélectionner **Serveur unique - tous les services sur un seul serveur**. Faites attention à ne pas cliquer sur d'autres options car elles sont destinées au déploiement sur deux serveurs. ![](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-847cd113294e5de3eb2264c8c1c73acb181e3ae9%2Fimage-20230802-134855.png?alt=media) ### Processus d’installation Le script effectuera une vérification logicielle. Vous verrez que les logiciels sont en cours d'installation, y compris Java, Nginx et MySQL. Vous verrez une demande de redémarrage de MySQL, confirmez ceci en saisissant `1`. Ensuite, il vous sera demandé de confirmer l'initialisation des bases de données, répondez positivement à nouveau en saisissant `y`. ![](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-872fc20c2335ea24128efcf0192b718165167dea%2Fimage-20230810-130547.png?alt=media) MySQL vous demandera de spécifier le mot de passe root. Ce n'est pas obligatoire pour la plateforme, vous pouvez donc le laisser vide. Si vous en spécifiez un, assurez-vous de vous en souvenir. Ensuite, le script créera les bases de données et l'utilisateur DB *navixy* avec un mot de passe aléatoire. Ce sera l'utilisateur principal permettant aux services de la plateforme d'interagir avec la base de données. Toutefois, vous n'avez pas besoin de retenir son mot de passe car il sera inséré automatiquement dans les fichiers de configuration. Une fois cela fait, le script remplira la base de données avec les tables système. ![](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-aa8fb97a27855cf0497f8493951589ebf76b90f5%2Fimage-20230810-130559.png?alt=media) Après l'initialisation de la base de données, le script posera la question suivante : ``` Ce script installera la plateforme Navixy sur ce serveur. Continuer ? (y/n) ``` Répondez par l'affirmative avec `y`, et il effectuera les opérations suivantes : * Créer un utilisateur pour les services Java (backend) * Créer les répertoires pour les services Java et les remplir avec les fichiers requis * Copier et configurer les composants web (frontend) * Copier les scripts runit nécessaires au lancement des services Java * Configurer les services Java ### Domaines Le script vous demandera de spécifier un nom de domaine pour votre service. Il s'agit d'un domaine utilisé pour : * Tous les services système dans une installation à domaine unique. * Interface utilisateur et activation des appareils dans une installation à trois domaines. ![On-Premise - installation Ubuntu - Configuration du domaine](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-bc520a00f56721ab711a683264dbbcbd67dd86f0%2Fimage-20230802-140224.png?alt=media) Ensuite, il vous sera demandé les domaines pour l'API et le panneau d'administration. * Pour une installation à domaine unique, laissez ces valeurs vides et appuyez sur Entrée (OK). * Pour les installations à trois domaines, spécifiez respectivement les domaines API et Panel. ![On-Premise - installation Ubuntu - Configuration de l'API](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-4ba633d13f4ee87f5b0f5b551e3eb259a8a23457%2Fimage-20230802-140910.png?alt=media) ![On-Premise - installation Ubuntu - Configuration du panneau](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-541940424f651445512bf3d233c040da5cdc215b%2Fimage-20230802-140938.png?alt=media) Vous verrez une notification concernant la configuration des domaines que vous avez effectuée. Ensuite, il vous sera demandé d'installer les certificats SSL pour votre plateforme. Si vous souhaitez le faire, cliquez sur `Oui` et suivez les invites de l'assistant. Pour des détails sur l'installation du certificat SSL, voir le [Assistant de configuration](https://www.navixy.com/docs/on-premise/fr/on-premise/how-to-guide/installation/advanced-installation/ubuntu-20/configuration-wizard) page. À ce stade, l'installation de base de la plateforme est terminée. Si vous avez besoin de davantage de personnalisation, utilisez le [**./configure.sh**](https://www.navixy.com/docs/on-premise/fr/on-premise/how-to-guide/installation/advanced-installation/ubuntu-20/configuration-wizard) script. ## Option 2. Deux serveurs Tout d'abord, décompressez la build de la plateforme Navixy fournie en tant que `tar.gz` archive. Téléversez et décompressez l'archive sur **les deux serveurs**. Pour décompresser, allez dans le répertoire contenant l'archive et exécutez la commande suivante (remplacez bien sûr **\** par le nom de fichier réel) : ``` tar -zxvf .tar.gz ``` L'archive sera extraite vers le répertoire **navixy-package** répertoire. L'installation suivante doit d'abord être effectuée sur le serveur de base de données, puis sur le serveur d'application. ### Serveur de base de données Ouvrir `/navixy-package` répertoire et exécutez le `install.sh` script depuis celui-ci. ``` ./install.sh ``` Il vous sera demandé de sélectionner le rôle du serveur pour le déploiement. Sélectionnez **#2 SQL server**. ![On-Premise - installation Ubuntu - serveur DB](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-79d6fdad87871602eacd34927d00347410f32a65%2Fimage-20230803-135111.png?alt=media) Le script commencera par un contrôle du système et des logiciels. Vous verrez que MySQL est en cours d'installation et de configuration. Vous verrez une demande de redémarrage de MySQL, confirmez ceci en saisissant `1`. Ensuite, il vous sera demandé de confirmer l'initialisation des bases de données, répondez positivement à nouveau en saisissant `y`. ![](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-913590364567d9e8ca55aba639c085ad75cc458c%2Fimage-20230810-130630.png?alt=media) MySQL vous demandera de spécifier le mot de passe root. Ce n'est pas obligatoire pour la plateforme, vous pouvez donc le laisser vide. Si vous en spécifiez un, assurez-vous de vous en souvenir. Ensuite, le script créera les bases de données et l'utilisateur DB *navixy* avec un mot de passe aléatoire. Ce sera l'utilisateur principal permettant aux services de la plateforme d'interagir avec la base de données. ![](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-19193fde296d45c6e7ba19a9cd1664eb3c0e952e%2Fimage-20230810-130640.png?alt=media) Le script remplira ensuite la base de données avec les tables système. Après l'initialisation de la base de données, vous verrez les informations suivantes concernant le serveur de base de données : * Nom d'utilisateur : *navixy* - c'est l'utilisateur DB spécifié dans les configurations système pour l'interaction avec la base de données. * Mot de passe : *aléatoire* - le mot de passe pour l'utilisateur *navixy* . * Adresse IP : adresse réelle de votre serveur DB. ![](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-b79f8c73ecc3a18d674bbef803fb604f0a8d9ad9%2Fimage-20230810-130655.png?alt=media) Veillez à sauvegarder ces valeurs, car vous en aurez besoin lors de l'installation du serveur d'application. ### Serveur d'application Ouvrir `/navixy-package` répertoire et exécutez le `install.sh` script depuis celui-ci. ``` ./install.sh ``` Il vous sera demandé de sélectionner le rôle du serveur pour le déploiement. Sélectionnez **#3 Serveur d'application**. ![On-Premise - installation Ubuntu - serveur d'application](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-16d6b036536c02960eb0248fa8ba1f3519e124c9%2Fimage-20230803-135805.png?alt=media) Le script téléchargera et installera Java, Nginx et d'autres prérequis pour exécuter la plateforme. Cela sera fait automatiquement et ne requiert pas votre attention. Une fois tous les prérequis installés, le script vous demandera le mot de passe de l'utilisateur SQL. Il s'agit du mot de passe de l'utilisateur *navixy* obtenu après l'installation de la base de données à l'étape précédente. Utilisez `Shift+Insert` pour le coller depuis le presse-papiers. ![On-Premise - installation Ubuntu - identifiants MySQL](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-5a7cbb40bfa5e146358eac6a24b8eb72c09e95d9%2Fimage-20230803-135651.png?alt=media) Vous serez ensuite invité à fournir l'adresse IP de votre serveur de base de données. Saisissez-la. ![On-Premise - installation Ubuntu - configuration MySQL](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-6f4d7d68026f381ca42ce6d824d3f4342265f23a%2Fimage-20230803-135831.png?alt=media) Le script vérifiera que l'IP est valide. Il vous sera alors demandé de confirmer l'installation de la plateforme sur votre serveur. Faites-le en tapant `y` et en appuyant sur `Entrée`. ![On-Premise - installation Ubuntu - serveur d'application](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-baa31dab35969d983f6b9229b44f488135afb8c2%2Fimage-20230810-130708.png?alt=media) ### Domaines Le script vous demandera de spécifier un nom de domaine pour votre service. Il s'agit d'un domaine utilisé pour : * Tous les services système dans une installation à domaine unique. * Interface utilisateur et activation des appareils dans une installation à trois domaines. ![On-Premise - installation Ubuntu - Vérification du domaine](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-bc520a00f56721ab711a683264dbbcbd67dd86f0%2Fimage-20230802-140224.png?alt=media) Ensuite, il vous sera demandé les domaines pour l'API et le panneau d'administration. * Pour une installation à domaine unique, laissez ces valeurs vides et appuyez sur Entrée (OK). * Pour les installations à trois domaines, spécifiez respectivement les domaines API et Panel. ![On-Premise - installation Ubuntu - Vérification de l'API](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-4ba633d13f4ee87f5b0f5b551e3eb259a8a23457%2Fimage-20230802-140910.png?alt=media) ![On-Premise - installation Ubuntu - Vérification du panneau](https://866637922-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkUnMmePH99SsdChtqqu7%2Fuploads%2Fgit-blob-541940424f651445512bf3d233c040da5cdc215b%2Fimage-20230802-140938.png?alt=media) Vous verrez une notification concernant la configuration des domaines que vous avez effectuée. Ensuite, il vous sera demandé d'installer les certificats SSL pour votre plateforme. Si vous souhaitez le faire, cliquez sur `Oui` et suivez les invites de l'assistant. Pour des détails sur l'installation du certificat SSL, voir le [Assistant de configuration](https://www.navixy.com/docs/on-premise/fr/on-premise/how-to-guide/installation/advanced-installation/ubuntu-20/configuration-wizard) page. À ce stade, l'installation de base de la plateforme est terminée. Si vous avez besoin de davantage de personnalisation, utilisez le [**./configure.sh**](https://www.navixy.com/docs/on-premise/fr/on-premise/how-to-guide/installation/advanced-installation/ubuntu-20/configuration-wizard) script.