Installation initiale
Nos tests ont été effectués sur un serveur Ubuntu.
L'installation débute par la création d'un répertoire, par exemple /var/www/pelican.
sudo mkdir -p /var/www/pelican
sudo mkdir -p /var/www/pelican/LogFiles
Donnez des droits suffisants sur ces répertoires, dont notamment la permission à MercatorPelican d'écrire dans le sous-répertoire LogFiles.
Uploadez le contenu du fichier ZIP ci-joint dans /var/www/pelican et donnez ensuite des droits en exécution sur l'application :
chmod +x /var/www/pelican/MercatorPelican.Web
Cette version de MercatorPelican utilise SkiaSharp pour la gestion des images. Pour que ce composant fonctionne correctement, il faut exécuter :
sudo apt-get update
sudo apt install -y libfontconfig1 libfreetype6
💡 Aucun framework ne doit être installé. MercatorPelican sous Linux est publié en mode single file.
Pour démarrer MercatorPelican en mode Kestrel simple :
cd /var/www/pelican
./MercatorPelican.Web
et pour l'arrêter : CTRL-C
Paramétrage de MercatorPelican
Le fichier MercatorPelican.appsettings.json doit être complété afin d'indiquer les paramètres de connexion à la base de données du Mercator qui sera lié à ce MercatorPelican. Il convient au minimum de compléter le bloc MercatorSqlConnectionIni qui doit reprendre les informations présentes habituellement dans le Mercator.connection d'un Mercator desktop :
- SqlServer : adresse IP ou nom du serveur SQL ;
- DataBase : nom de la base de données ;
- ComplSqlPwdDb : le complément de mot de passe ;
- CertThumbPrint : l'empreinte du certificat SSL de connexion, si nécessaire, sinon vide.
Il faut aussi indiquer le port TCP souhaité pour Kestrel dans le paramètre KestrelConfig / Port.
‼️Lors d'une mise à jour, il ne faut pas écraser le fichier MercatorPelican.appsettings.json.
Si ce MercatorPelican est destiné à être utilisé uniquement dans un réseau local, il est possible de se limiter au mode Kestrel simple. Il est toutefois recommandé d'utiliser le protocole HTTPS afin d'éviter toute une série d'avertissements. Pour cela, il faut charger un certificat SSL et référencer son empreinte dans le paramètre KestrelConfig / CertThumbPrint.
Si MercatorPelican est destiné à un usage plus large, alors il faut le faire fonctionner en HTTP (en mettant à blanc KestrelConfig / CertThumbPrint), au travers de NGINX par exemple. S'agissant d'une application Blazor, ces paramètres NGINX sont nécessaires :
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;
}
}
Chargement d'un certificat SSL
Cette procédure fonctionne tant pour les certificats SSL pour HTTPS que pour SQL.
- Uploader le fichier PFX dans le répertoire /var/www/pelican/
- Démarrer MercatorPelican avec le paramètre loadpfx= suivi du nom de votre fichier PFX
- MercatorPelican va demander le mot de passe du certificat et le charger.
- Supprimer le fichier PFX dans le répertoire /var/www/pelican/
A télécharger :
0000003468.zip (62236 Kb - 28/10/2026)