Carto-SI (api)For Developers

Installation de Carto-SI sur Linux

Ce guide vous accompagne pas à pas dans l'installation de Carto-SI sur votre serveur Linux.

🎯 Vue d'ensemble

Temps d'installation estimé : 20-30 minutes

Systèmes supportés :

  • Debian 10, 11, 12
  • Ubuntu 18.04, 20.04, 22.04, 24.04 LTS
  • CentOS 7, 8
  • Rocky Linux 8, 9, 10
  • RHEL 7, 8, 9, 10

✅ Prérequis

Avant de commencer, vérifiez que votre système répond aux exigences :

Configuration matérielle minimale

  • RAM : 4 Go minimum
  • Disque : 5 Go minimum
  • CPU : 2 cœurs minimum

📦 Étape 1 : Télécharger l'installateur

Définition la variables VERSION

Définir une variable d'environnement VERSION qui contient le numéro de version que vous souhaitez télécharger. La dernière version stable est: 4.8.14.

Fichier CSV contenant la liste des utilisateurs
export VERSION=4.8.14

Définition des variables d’identification

Définir la variable d'identification IDENTIFIANT et CLE.

Code(shell)
 
export IDENTIFIANT=example.com
export CLE=x15nb163FMjcguvvXHno

💡 Où trouver vos identifiants ?

Les identifiants sont fournis lors de votre souscription par e-mail (objet : [Carto-SI] Identifiant pour télécharger le logiciel). Ils ont une durée de validité limitée.

Télécharger avec votre navigateur

Voici les liens permettant de télécharger la dernière version de Carto-SI:

Télécharger Carto-SI pour Debian 10 & 11 / Ubuntu 18 & 20

Télécharger Carto-SI (Java 17) pour Debian 12 / Ubuntu 22 & 24

Télécharger Carto-SI pour CentOS 7 & RHEL 7

Télécharger Carto-SI pour RHEL 8 & 9 (Rocky Linux 8 & 9)

Télécharger Carto-SI pour RHEL 10 (Rocky Linux 1O)

Télécharger l'archive tar de Carto-SI

Si vous choisissez de télécharger le livrable via votre navigateur, vous devrez renseigner vos identifiants dès l'apparition de la fenêtre contextuelle suivante :

Vérifier la version de Carto-SI sous Windows.

Télécharger par ligne de commande

Debian 10 / 11 ou Ubuntu 18 / 20
Code(bash)
 
curl --user ${IDENTIFIANT}:${CLE} \
  https://gitlab.com/api/v4/projects/1432924/packages/generic/carto-si/${VERSION}/carto-si_${VERSION}-1_all.deb \
  -o carto-si_${VERSION}-1_all.deb
Debian 12 ou Ubuntu 22 / 24
Code(bash)
 
curl --user ${IDENTIFIANT}:${CLE} \
  https://gitlab.com/api/v4/projects/1432924/packages/generic/carto-si/${VERSION}/carto-si-java17_${VERSION}-1_all.deb \
  -o carto-si-java17_${VERSION}-1_all.deb
CentOS 7 / RHEL 7
Code(bash)
 
curl --user ${IDENTIFIANT}:${CLE} \
  https://gitlab.com/api/v4/projects/1432924/packages/generic/carto-si/${VERSION}/carto-si-${VERSION}-1.el7.noarch.rpm \
  -o carto-si-${VERSION}-1.el7.noarch.rpm
RHEL 8 / 9 (Rocky Linux 8 & 9)
Code(bash)
 
curl --user ${IDENTIFIANT}:${CLE} \
  https://gitlab.com/api/v4/projects/1432924/packages/generic/carto-si/${VERSION}/carto-si-${VERSION}-1.el8.noarch.rpm \
  -o carto-si-${VERSION}-1.el8.noarch.rpm
RHEL 10 (Rocky Linux 10)
Code(bash)
 
curl --user ${IDENTIFIANT}:${CLE} \
  https://gitlab.com/api/v4/projects/1432924/packages/generic/carto-si/${VERSION}/carto-si-${VERSION}-1.el10.noarch.rpm \
  -o carto-si-${VERSION}-1.el10.noarch.rpm

Téléchargement de l'archive

Code(shell)
 
curl --user $IDENTIFIANT:$CLE \
  https://gitlab.com/api/v4/projects/1432924/packages/generic/carto-si/$VERSION/carto-distribution-$VERSION-bin.tar.gz \
  -o carto-distribution-$VERSION-bin.tar.gz

🔧 Étape 2 : Installer Carto-SI

Installation sur Debian / Ubuntu

Debian 10 / 11 ou Ubuntu 18 / 20

Code(bash)
 
sudo apt install -y ./carto-si_${VERSION}-1_all.deb

Debian 12 ou Ubuntu 22 / 24

Code(bash)
 
sudo apt install -y ./carto-si-java17_${VERSION}-1_all.deb

CentOS 7 / RHEL 7

Code(bash)
 
sudo yum install -y ./carto-si-${VERSION}-1.el7.noarch.rpm

RHEL 8 / 9 (Rocky Linux 8 & 9)

Code(bash)
 
sudo yum install -y ./carto-si-${VERSION}-1.el8.noarch.rpm

RHEL 10 (Rocky Linux 10)

Code(bash)
 
sudo yum install -y ./carto-si-${VERSION}-1.el10.noarch.rpm

Appel API version

La commande suivante permet de vérifier la version de Carto-SI :

Code(bash)
 
# Tester l'API (sans authentification)
curl http://localhost/api/version

Vous devriez voir la page de connexion de Carto-SI.

🔐 Première connexion

Définition des identifiants administrateur

Pour se connecter à Carto-SI, il est nécessaire de définir les identifiants administrateur. Ces identifiants sont spécifiés dans le fichier de configuration se trouvant sur le chemin suivant :

Code(bash)
 
vi /opt/carto-si/data/conf/carto-si.properties

Recherchez les lignes :

Code
 
mailadmin : admin@carto-si.com
password : $argon2id$v=19$m=15360,t=2,p=1$7QdBqMuTKFWUC2NINchT

Modifiez le champ password avec un nouveau mot de passe sécurisé, puis redémarrer Carto-SI. Ce nouveau mot de passe sera automatiquement haché. Pensez à copier (dans votre gestionnaire de mot de passe) le mot de passe, car il ne sera plus visible.

Code(bash)
 
systemctl restart carto-si.service

Se connecter

  1. Dans votre Navigateur préféré, connectez-vous au serveur.
  2. Entrez l'email administrateur ( mailadmin du fichier carto-si.properties)
  3. Entrez le mot de passe (saisi dans le fichier de configuration carto-si.properties)
  4. Cliquez sur Connexion

Bienvenue dans Carto-SI ! 🎉

Last modified on