IoTRoutes Web Client

            IoTRoutes Web Client is a web application that allows access and manipulation of the IoTRoutes platform hosted locally or even in the cloud. You just need to install the website and configure it to communicate with the platform. After configuring the back-end servers, as described in the previous section, you can start deploying the web client by following the steps below:

Before you begin, please download and unzip the files from the download page on  https://github.com/IoTRoutes/iotroutes.

In the assets folder, please adjust the contents of the appSettings.json file which contains the AOS server address, title and logo of the application.

Windows : 

• Prerequisites: 
  • Windows Server (2012 R2 or later recommended)
  • IIS installed (Web Server (IIS) role in Server Manager)
  • The URL Rewrite module must be enabled in IIS.
• Steps:
  • Iinstall and configure IIS as described in the official documentation, see IIS link .
  • Create a root folder to host the web application under your IIS example C:\inetpub\wwwroot\IoTRoutes.web and copy the unzipped files that you downloaded earlier from the IoTRoutes-web link.
  • Open IIS Manager if it is still closed and configure the web application as follows:
    • Add a website to host the IoTRoutes client: Right-click on "Sites" and "Add Website". Enter the site name "IoTRoutes-Web" and the path "C:\inetpub\wwwroot\IoTRoutes.Web" (according to the folder created previously) .
    • Adjust the entries in the appsettings.json configuration file, which is located under the assets folder of the web application. This file contains the settings that allow the client to connect to the AOS. Make sure the link is correct and accessible (see the documentation in the IoTRoutes-AOS kink).

    • Check permissions and Firewall: Make sure the folder has read/execute permissions for IIS_IUSRS. 

      Allow incoming traffic on the port you configured IIS to listen on (default: 80 or 443 for HTTPS)

Ubuntu

Here are the steps to deploy IoTRoutes Web Client on an Ubuntu server (using Nginx, which is recommended for serving applications in production). These steps do not detail Ubuntu commands, please refer to the documentation.

• Prerequisites: 
  • An Ubuntu server (local or remote)
  • Root or sudo access
  • Nginx installed
  • Download and unzip the IoTRoutes web client folder from the github link here.
• Steps
  •  Before copying, make sure that the structure of the folder to be sent is correct (Example: a root folder IoTRoutes.web containing the unzipped files).
  • Access the appSettings.json file under the assets folder and ensure that the AOS URL is configured correctly and is accessible, (see the documentation in this link) IoTRoutes on-premise).

  • Copy files to Ubuntu: Use scp or a tool like rsync

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

  •  Install Nginx (if it is not done).

    sudo apt update
    sudo apt install nginx

  • Configure Nginx to serve your IoTRoutes client web application.

    • Create a new Nginx configuration file :

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

      Here is an example of content to adjust

      server {
          listen 80;
          server_name your-domain.com;  # or Server IP address
      
          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";
          }
      }
      

    • Enable the config and restart Nginx

      sudo ln -s /etc/nginx/sites-available/iotroutes.web /etc/nginx/sites-enabled/
      sudo nginx -t  
      sudo systemctl reload nginx
      

    • Check Permissions: Make sure Nginx has permission to read the files

    • Test in browser.

Next : Access to IoTRoutes Web