Client Web IoTRoutes 

       IoTRoutes Web Client  est une application web permettant l'accès et la manipulation de la plateforme IoTRoutes hébergé localement ou même en cloud. Il Suffit l'installer le site web et le configurer afin qu'il communique avec la plateforme. Après avoir configurer les serveusr Back-End, comme décrit dans la section précédente, vous pouvez commencer à déployer le client web en suivant les étapes ci-dessous:

Avant de commencer, veuillez Télécharger et décompresser les fichiers depuis la page de téléchargement sur  https://github.com/IoTRoutes/iotroutes.web .

Dans le dossier assets , veuillez ajuster le contenu du fichier appSettings.json qui contient l'adresse du serveur AOS, le titre et le logo de l'application.

Windows : 

• Prérequis : 
  • Windows Server (2012 R2 or later recommended)
  • IIS installed (Web Server (IIS) role in Server Manager)
  • Avoir activé le module de réécriture d'URL (URL Rewrite) dans IIS .
• Etapes:
  • Installer et configurer IIS comme décrit dans la documentation officielle, voir ce lien .
  • Créer un dossier racine pour héberger l'application web sous votre IIS exemple C:\inetpub\wwwroot\IoTRoutes.web et copier les fichiers décompressés que vous les avez téléchargé précédemment depuis le lien de IoTRoutes-web.
  • Ouvrir le gestionnaire IIS s'il est encore fermé et configurer l'application web comme suit :
    • Ajouter un site web pour héberger Le client IoTRoutes: Cliquer avec le bouton droits sur "Sites" et "Ajouter Site Web". Entrer le nom de site "IoTRoutes-Web" et le chemin "C:\inetpub\wwwroot\IoTRoutes.Web" (selon le dossier créé à précédemment) .
    • Ajuster les entrées du fichier de configuration appsettings.json qui est situé sous le dossier assets du l'application web . Ce fichier contient les paramètres permettant client de se connecter à l'AOS.  Assurer vous que le lien est correcte et il est accessible, (voir la documentation dans ce lien IoTRoutes-AOS).

    • Vérifier les permissions et Firewall : Assurez-vous que le dossier dispose des autorisations de lecture/exécution pour IIS_IUSRS. 

      Autoriser le trafic entrant sur le port que vous avez configuré IIS pour écouter (par défaut : 80 ou 443 pour HTTPS)

Ubuntu

Voici les étapes pour déployer IoTRoutes Web Client sur un serveur Ubuntu (avec Nginx, qui est recommandé pour servir les applications en production). Ces Etapes ne détaillent pas les commandes Ubuntu , veuillez vous référer à la documentation .

• Prérequis : 

  • Un serveur Ubuntu (local ou distant)

  • Accès root ou sudo

  • Nginx installé

  • Le dossier IoTRoutes web client téléchargé depuis le lien des téléchargement ici et décompressé.

• Etapes
  •  Avant de copier assurer vous que la structure du dossier à envoyer est correcte (Exemple un dossier racine IoTRoutes.web contenant les fichiers décompressé). 
  • Accéder au fichier appSettings.json sous le dossiers assets et assurer que l'url de l'AOS est bien configuré et il est accessible,  (voir la documentation dans ce lien IoTRoutes-AOS).

  • Copier les fichiers vers Ubuntu :  Utilisez scp ou un outil comme rsync

    scp -r sourecePath/iotroutes.web/ user@your-server-ip:/var/www/iotroutes.web

  •  Installer Nginx (si ce n'est pas fait).

    sudo apt update
    sudo apt install nginx

  • Configurer Nginx pour servir votre application web IoTRoutes client.

    • Créez un nouveau fichier de configuration Nginx :

      sudo nano /etc/nginx/sites-available/iotroutes.web

      voici un exemple de contenu à ajuster

      server {
          listen 80;
          server_name your-domain.com;  # ou l'adresse IP du serveur
      
          root /var/www/iotroutes.web;
          index index.html;
      
          location / {
              try_files $uri $uri/ /index.html;
          }
      
          location ~* \.(?:ico|css|js|gif|jpe?g|png|woff2?|eot|ttf|svg)$ {
              expires 1M;
              access_log off;
              add_header Cache-Control "public";
          }
      }
      

    • Activer la config et redémarrer Nginx

      sudo ln -s /etc/nginx/sites-available/iotroutes.web /etc/nginx/sites-enabled/
      sudo nginx -t  # vérifier que tout est OK
      sudo systemctl reload nginx
      

    • Vérifier Permissions: Assurez-vous que Nginx a le droit de lire les fichiers

    • Tester dans le navigateur.

Suivant : Accéder à IoTRoutes Web