Cet article indique comment télécharger et installer Carto-SI sur vos serveurs.
Carto-SI est disponible en Saas.
Vous pouvez cependant choisir de l’installer en On Premise. Pour accéder au dépôt où se trouvent nos livrables, il vous faudra demander des données d’identification sous la forme d’un identifiant et d’une clé au support.
Liste des notations utilisées dans ce document :
[clé]
: Clé d’identification pour télécharger le logiciel (voir Données d’identification).[dossier_data]
: Dossier contenant les données de Carto-SI. (Voir Procédure d’installation via Docker, Procédure d’Installation Windows ou Procédure d’Installation Linux)[identifiant]
: Identifiant pour télécharger le logiciel (voir Données d’identification).[version]
: Version du logiciel à installer (voir dernière version stable).Avec la licence On Premise, Carto-SI s’installe dans votre système d’information.
Il peut être installé au choix avec :
.exe
, .deb
ou .rpm
en fonction du système d’exploitation.Indépendamment du système d’exploitation Windows ou Unix, les éléments suivants seront nécessaires :
Les installateurs ont été testés sur :
Télécharger directement la dernière version pour votre système d’exploitation :
Consultez ce lien pour connaitre le numéro de la dernière version stable de Carto-SI si elle ne s’affiche pas ci-dessus.
Dans ce document, ce numéro de version est noté [version]
.
Pour le temps de l’installation, définissez une variable VERSION
. Dans les illustrations, nous supposons l’installation de la version 4.1.1.
Sous Windows, dans l’invite de commande qui sera utilisée pour télécharger le logiciel, tapez :
set VERSION=[version]
Sous Linux, dans le terminal qui sera utilisé pour installer le logiciel, tapez :
VERSION=[version]
Lors de votre souscription, un identifiant et une clé de connexion vous sont fournis. Ces données à durée de vie limitée sont nécessaires pour télécharger le logiciel. Dans ce document, ces deux informations sont notées [identifiant]
et [clé]
.
Dans les illustrations, l’identifiant est alice et la clé x15nb163FMjcguvvXHno.
Sous Windows, dans l’invite de commande, tapez :
set IDENTIFIANT=[identifiant]
set CLE=[clé]
Sous Linux, dans le terminal, tapez :
IDENTIFIANT=[identifiant]
CLE=[clé]
Vous devez au préalable avoir installé Docker sur votre environnement.
Définir la variable de version comme explicitée dans Dernière version stable.
Définir les variables d’identification comme explicitées dans Données d’identification.
Choisissez le dossier qui contiendra les données de l’application. Dans ce document, le chemin du dossier sera nommé [dossier_data]
. Dans les illustrations, le dossier est /home/carto-si
.
Sous Linux, dans le terminal, définissez une variable DOSSIER
contenant le chemin avec la commande suivante :
DOSSIER=[dossier_data]
Loggez-vous sur le repository docker de Carto-SI avec la commande suivante :
docker login -u $IDENTIFIANT -p $CLE registry.gitlab.com/cartosi
Lancez le conteneur docker avec la commande suivante :
docker run --rm -v $DOSSIER:/carto-si/data -p 80:80 registry.gitlab.com/c3772/cartosi/carto-si:$VERSION
Le container contient un serveur Java caché derrière un serveur nginx. Il est possible de fournir votre propre configuration.
Pour ce faire, écrivez votre propre fichier de configuration en vous inspirant de la configuration suivante :
server {
listen 80 ;
if ($http_x_forwarded_proto = ‘http’ ) {
return 301 https://$host$request_uri;
}
location / {
root /var/www/html/;
}
location /api {
proxy_pass http://127.0.0.1:9327;
}
}
Définissez une variable d’environnement NGINX_CONFIG
contenant le chemin de votre fichier de configuration. Dans l’illustration, le chemin est /home/carto-si/nginx/carto-si.conf
.
Puis, lancez Carto-SI avec la commande suivante :
docker run --rm -v $DOSSIER:/carto-si/data -v $NGINX_CONFIG:/etc/nginx/sites-available/carto-si.com -p 80:80 -p 443:443 registry.gitlab.com/c3772/cartosi/carto-si:$VERSION
Un installateur au format .exe est disponible pour installer Carto-SI sur Windows.
Définir la variable de version comme explicitée dans Dernière version stable.
Définir les variables d’identification comme explicitées dans Données d’identification.
Téléchargez l’installateur dans votre dossier Download avec la commande suivante :
curl --user %IDENTIFIANT%:%CLE% https://gitlab.com/api/v4/projects/1432924/packages/generic/carto-si/%VERSION%/carto-si_%VERSION%.exe -o %userprofile%\Downloads\carto-si_%VERSION%.exe
Exécutez le programme carto-si_X.X.X.exe que vous venez de télécharger. Après avoir choisi le langage d’installation, acceptez les trois licences intégrées au produit.
Puis indiquez dans quel répertoire sera installé Carto-SI. Ce répertoire contiendra à la fois l’exécutable de Carto-SI et un dossier data
. Dans ce document, le chemin vers ce dossier data
est noté [dossier_data]
.
Laissez-vous guider par l’installateur jusqu’à ce que Carto-SI soit installé.
L’installation configure Windows pour démarrer automatiquement Carto-SI. Quelques dizaines de secondes après la fin de l’installation, vous pouvez vérifier la version installée de Carto-SI en tapant la commande suivante dans une invite de commande :
curl http://localhost/api/version
Vous pouvez vous connecter à la page de login de Carto-SI avec l’URL http://localhost/ (voir Connexion à Carto-SI].
Carto-SI est lancé par l’intermédiaire du service Windows Carto-SI.
Deux raccourcis (Start et Stop) ont été installés dans le menu démarrer.
Des installateurs au format .deb et .rpm sont disponibles pour installer Carto-SI sur Linux.
Définir la variable de version comme explicitée dans Dernière version stable.
Définir les variables d’identification comme explicitées dans Données d’identification.
Sous Debian, téléchargez l’installateur .deb
avec la commande suivante :
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
Sous Red Hat 7, téléchargez l’installateur .rpm
avec la commande suivante :
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
Sous Red Hat 8, téléchargez l’installateur .rpm
avec la commande suivante :
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
Utiliser la commande suivante pour installer Carto-SI sur Debian :
sudo apt install -y ./carto-si_$VERSION-1_all.deb
Utiliser la commande suivante pour installer Carto-SI sur Red Hat 7 :
sudo yum install -y ./carto-si-$VERSION-1.el7.noarch.rpm
Utiliser la commande suivante pour installer Carto-SI sur Red Hat 8 :
sudo yum install -y ./carto-si-$VERSION-1.el8.noarch.rpm
Sous Linux, les données se trouvent dans le dossier /opt/carto-si/data
. Dans ce document, ce dossier est noté [dossier_data]
.
Le service carto-si a été ajouté à systemd
. Vous pouvez lancer et arrêter Carto-SI avec les commandes suivantes :
systemctl start carto-si.service
systemctl stop carto-si.service
Le chemin du fichier de configuration de Carto-SI® est [dossier_data]/conf/carto-si.properties
(voir sur [dossier_data]). Il est composé des propriétés suivantes :
# mail de l’administrateur
mailadmin : admin@carto-si.com
# mot de passe de l'administrateur
password : ****
# clef utilisée pour signer le jeton jwt
jwt-secret : ****
# port de connexion HTTP. 80 sur Windows, 9327 sur Linux et docker.
port-http : 9327
# port de connexion HTTPS
port-https : 443
# niveau de log. Les valeurs valides sont trace, debug, info, warn et error.
log-level : info
A l’aide d’un navigateur, connectez-vous ensuite sur l’URL suivante pour tester Carto-SI :
http://localhost/
Note : les identifiants par défaut sont le mail de l’administrateur et le mot de passe de l’administrateur. Ses informations sont disponibles dans le fichier de configuration.
Entrez cette URL pour consulter la doc des API REST :
http://localhost/apidocs
Entrez cette URL pour vérifier la version de Carto-SI :
http://localhost/api/version
La conception de Carto-SI permet la mise en place d’une sauvegarde simple et sécurisée. Celle-ci pourra s’intégrer dans votre politique de sauvegarde actuelle.
La totalité des données à sauvegarder se trouve dans le répertoire [dossier_data]
de Carto-SI (voir sur [dossier_data])).
Il est demandé à nos clients On Premise de stocker les sauvegardes dans un espace de stockage distinct avec une durée de rétention adaptée à l’entreprise.
En cas de restauration du répertoire, un arrêt-relance de Carto-SI est nécessaire.
Dans le répertoire [dossier_data]
se trouvent la base de données, les logs et les fichiers de conf de Carto-SI
Ce répertoire doit impérativement être sauvegardé.
En cas de modification des fichiers de conf ou des données de [dossier_data]
, le service doit être éteint et relancé pour que les modifications soient prisent en compte.
© Carto-SI