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://s.q37.info/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/Notifications/DefaultNotification entry in the xdhqxdh.cfg file from the xdhq repository. Remove then the Configurations/Configuration/Parameters/FaaS/Notifications/Notification[flavour="PYH"] entry.

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.

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.

You may also want to increase the WebSocket timeout, as the default timeout is often too short.

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, faas.q37.info and localhost:53710 values.

Apache version:

<VirtualHost *:80>
	DocumentRoot "/var/www/faas"
	ServerName faas.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 faas.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;
  }
}