Installeer MercatorPelican in webmodus op Linux

Eerste installatie

Onze tests werden uitgevoerd op een Ubuntu-server.

De installatie begint met het aanmaken van een map, bijvoorbeeld /var/www/pelican.

sudo mkdir -p /var/www/pelican
sudo mkdir -p /var/www/pelican/LogFiles

Geef voldoende rechten op deze mappen, met name de toestemming voor MercatorPelican om te schrijven in de submap LogFiles.

Upload de inhoud van het bijgevoegde ZIP-bestand in /var/www/pelican en geef vervolgens uitvoeringsrechten op de toepassing:

chmod +x /var/www/pelican/MercatorPelican.Web

Deze versie van MercatorPelican gebruikt SkiaSharp voor het beheer van afbeeldingen. Opdat dit onderdeel correct zou werken, moet u het volgende uitvoeren:

sudo apt-get update
sudo apt install -y libfontconfig1 libfreetype6

💡 Er hoeft geen enkel framework geïnstalleerd te worden. MercatorPelican op Linux wordt gepubliceerd in single file-modus.

Om MercatorPelican te starten in eenvoudige Kestrel-modus:

cd /var/www/pelican
./MercatorPelican.Web

en om het te stoppen: CTRL-C

Parametrering van MercatorPelican

Het bestand MercatorPelican.appsettings.json moet aangevuld worden om de verbindingsparameters aan te geven van de database van de Mercator die aan deze MercatorPelican gekoppeld wordt. Minstens het blok MercatorSqlConnectionIni moet aangevuld worden, dat de gegevens moet bevatten die gewoonlijk in de Mercator.connection van een Mercator desktop staan:

• SqlServer: IP-adres of naam van de SQL-server;
• DataBase: naam van de database;
• ComplSqlPwdDb: het wachtwoordcomplement;
• CertThumbPrint: de vingerafdruk van het SSL-certificaat van de verbinding, indien nodig, anders leeg.

Ook de gewenste TCP-poort voor Kestrel moet opgegeven worden in de parameter KestrelConfig / Port.

‼️Bij een update mag het bestand MercatorPelican.appsettings.json niet overschreven worden.

Als deze MercatorPelican uitsluitend bedoeld is voor gebruik in een lokaal netwerk, kan men zich beperken tot de eenvoudige Kestrel-modus. Het is echter aanbevolen om het HTTPS-protocol te gebruiken om een hele reeks waarschuwingen te vermijden. Hiervoor moet een SSL-certificaat geladen worden en moet de vingerafdruk ervan vermeld worden in de parameter KestrelConfig / CertThumbPrint.

Als MercatorPelican bedoeld is voor ruimer gebruik, dan moet het in HTTP werken (door KestrelConfig / CertThumbPrint leeg te laten), bijvoorbeeld via NGINX. Aangezien het om een Blazor-toepassing gaat, zijn deze NGINX-parameters nodig:

server {
    listen 80;
    server_name pelican.example.com;

    location / {
        proxy_pass http://127.0.0.1:5000;
        proxy_http_version 1.1;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;

        # SignalR / Blazor Interactive Server
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";

        proxy_read_timeout 100s;
        proxy_send_timeout 100s;
    }
}

Een SSL-certificaat laden

Deze procedure werkt zowel voor SSL-certificaten voor HTTPS als voor SQL.

• Upload het PFX-bestand in de map /var/www/pelican/
• Start MercatorPelican met de parameter loadpfx= gevolgd door de naam van uw pfx-bestand
• MercatorPelican zal het wachtwoord van het certificaat vragen en het laden.
• Verwijder het PFX-bestand uit de map /var/www/pelican/