Installation of the server

---

You don't have to install the server's program to use the Atlas toolkit. The provided bindings automatically connect to a free and public server.

To use another server, you have to modify the needed environment variables accordingly to https://q37.info/s/pkhrq3px.

The daemons

The sources of the software on the server can be found here:

• https://github.com/epeios-q37/xdhwebq-cli,
• https://github.com/epeios-q37/xdhq.

To deploy this software on your own server, retrieve both above repositories and compile them, by launching make in the root of each repository. Then launch <path-to>/xdhwebq-cli/xdhwebq <path-to>/xdhq/xdhqxdh (without the dll/so/dylib… extension).

To change/remove the welcome message displayed in the console from where the application is launched, change/remove the content of the Configurations/Configuration/Parameters/FaaS/Notification entry in the xdhqxdh.cfg file from the xdhq repository.

The web server

Static files

You also need a web server, in which you install the content of the htdocs directory from the xdhwebq-cli repository. If you want to change or remove the banner, and/or also remove the QR Code, you have to modify the prolog.php file accordingly.

The .js files have to be in a faas subdirectory, unless you modify the prolog.php file accordingly.

WebSocket

You have also to configure your web server to provide a WebSocket connection to the xdhwebq-cli daemon via the port defined by the Configurations/Configuration/Parameters/Service entry in the xdhwebq.xcfg file.

Here what your configuration file of your web server should contain. This has to be adapted to fit your environment, particularly the /var/www/FaaS, faas1.q37.info and localhost:53710 values.

Apache version:

<VirtualHost *:80>
    DocumentRoot "/var/www/FaaS"
    ServerName faas1.q37.info
    ProxyPass "/xdh/"  "ws://localhost:53710/"
</VirtualHost>

NGINX version:

map $http_upgrade $connection_upgrade {
    default upgrade;
    '' close;
}

upstream xdh {
    server localhost:53710;
}

server {
  listen 80;

  root /var/www/FaaS;

  server_name faas1.q37.info;

  location /xdh/ {
    proxy_pass http://xdh;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection $connection_upgrade;
    proxy_set_header Host $host;
  }
}