Passer au contenu principal
Version : 8.7.x

Comment configurer un conteneur Docker ?

Info

Pour obtenir des performances comparables à celles de l'appliance, l'hôte x86 doit satisfaire aux exigences suivantes :

ComposantsExigence minimaleRecommandation
CPU4 cœurs de classe d'efficacité (p. ex. Intel N100/N200) ou 2 cœurs de classe i3/i5-U, 8e génération ou supérieure4 cœurs de classe i3/i5-U, 8e génération ou supérieure
RAM4 Go8 Go
StockageSSD de 64 Go (SATA ou NVMe)≥ 64 Go SSD (NVMe de préférence)

Pour mettre en place un SiteManager virtuel, vous avez besoin d'une installation Docker sur votre système serveur. Après l'installation de Docker, créez un fichier docker-compose.yml dans un répertoire de votre choix.

Info

Lors de l'utilisation du registre Kentix360, il est nécessaire d'adapter les références d'image dans le fichier docker-compose.yml. Mettez à jour les images utilisées avec la nouvelle adresse du registre. Ensuite, une nouvelle connexion au nouveau registre doit être effectuée.

Astuce

Actuellement, l'ancien et le nouveau registre sont tous deux disponibles. Il est toutefois recommandé de passer rapidement au nouveau registre, car l'ancien sera abandonné à l'avenir.

docker-compose.yml
version: "3"
services:
sitemanager:
# ***** Remplacer
# image: kentix360.com:5000/sitemanager:latest
# ***** par
image: registry.kentixone.com/sitemanager:latest
environment:
- address=192.168.178.137
- license=D2EE-09EA-7C9B-C174-7BB2-9C8D-59F3-903E
volumes:
- webserver_shared:/var/www/shared
- data:/media/data/
- mount:/mnt/
ports:
- "192.168.178.137:443:443"
- "192.168.178.137:80:80"
volumes:
webserver_shared:
data:
mount:

Ce fichier permet de configurer tous les paramètres nécessaires. L'élément principal est ici l'adresse IP ou le domaine sous lequel l'interface web doit être accessible. Les noms du conteneur et des volumes virtuels peuvent également être modifiés à volonté.

Connexion Docker​

Avant de démarrer la stack, une connexion Docker au serveur doit être effectuée. Utilisez la commande « docker login » et saisissez « license » comme nom d'utilisateur et « votre licence Docker personnelle » comme mot de passe.

# ***** remplacer
# sudo docker login kentix360.com:5000
# ***** par
sudo docker login registry.kentixone.com

Identifiants :

  • Utilisateur : license
  • Mot de passe : [votre licence Docker personnelle]

Si la connexion réussit, vous devriez voir le message suivant :

Authenticating with existing credentials...
Login Succeeded

Démarrer la stack​

Après une authentification réussie, démarrez la stack avec la commande « docker-compose up ». Sous Linux/macOS, vous devez l'exécuter avec « sudo ».

sudo docker compose up

Le téléchargement de l'image du conteneur peut prendre un certain temps. Dès que vous voyez le message suivant, le conteneur a été construit et démarré avec succès :

Creating "yourFolder"_sitemanager_1 ... done
Attaching to "yourFolder"_sitemanager_1

Vous devriez maintenant voir les journaux de processus en direct du conteneur. Ils indiquent la progression du démarrage et l'adresse avec laquelle le conteneur a démarré. Si vous ne souhaitez pas suivre le processus dans la console, démarrez la stack en mode détaché en ajoutant « -d » :

sudo docker compose up -d

Le SiteManager virtuel devrait maintenant être accessible à l'adresse IP que vous avez configurée.

Mettre à jour le conteneur Docker​

Si une installation de conteneur existe comme décrit ci-dessus, vous pouvez mettre à jour le conteneur Docker avec la séquence de commandes suivante :

sudo docker compose down

# ***** remplacer
# sudo docker pull kentix360.com:5000/sitemanager:latest
# ***** par
sudo docker pull registry.kentixone.com/sitemanager:latest

sudo docker compose up -d

Cela arrête le conteneur et supprime toutes les données qui ne sont pas stockées sur un volume. Veuillez également tenir compte des éventuelles remarques de migration applicables.

Remarque importante concernant la migration 8.x.x → 8.3.0

Si vous prévoyez de migrer un conteneur Docker vers la version 8.3.0 ou ultérieure, veuillez noter ce qui suit. En raison d'une entrée de configuration manquante, les images des caméras peuvent être supprimées lors de la mise à jour.

Cela se produit si aucun volume dédié aux images des caméras n'est défini dans le fichier Docker Compose, par exemple :

  • mount:/mnt/

Procédure en cas de configuration erronée​

Recherchez le nom actuel de votre conteneur. Vous pouvez le faire avec la commande suivante :

sudo docker ps

Un exemple de sortie ressemble à ceci :

CONTAINER ID   IMAGE                                       COMMAND                  CREATED          STATUS          PORTS                                                   NAMES
01b2a337f77e kentix360.com:5000/sitemanager:latest. "/usr/bin/supervisor…" 19 seconds ago Up 16 seconds 161-162/tcp, 0.0.0.0:443->443/tcp, 0.0.0.0:81->80/tcp sitemanager-1
01b2a337f77e registry.kentixone.com/sitemanager:latest. "/usr/bin/supervisor…" 19 seconds ago Up 16 seconds 161-162/tcp, 0.0.0.0:443->443/tcp, 0.0.0.0:81->80/tcp sitemanager-1

Le nom se trouve dans la dernière colonne du tableau, ici « sitemanager-1 ». Si plusieurs conteneurs Docker existent, vous pouvez identifier le bon grâce au nom de l'image.

Sauvegardez les images des caméras avec la commande suivante :

sudo docker exec {docker-name} mv /mnt/kentix /media/data/sd_card

Mettez ensuite à jour le conteneur. Une fois le conteneur Docker mis à jour et démarré, vous pouvez restaurer les images avec la commande suivante :

sudo docker exec {docker-name} mv /media/data/sd_card/kentix /mnt

Ces étapes garantissent que tous les enregistrements des caméras sont conservés après la mise à jour. En outre, vous devriez compléter votre fichier Docker Compose en y ajoutant le volume pour les images des caméras.

Astuce

Redirection de ports SNMP :

  • Ouvrir les ports UDP 161 et 162 pour la communication SNMP (v2/v3)

  • Ouvrir en plus les ports UDP 41 000 et 41 001 pour les réponses en retour

Note

Commandes avec et sans sudo

Sous Linux, chaque commande s'exécute au nom d'un utilisateur. Sans sudo, il s'agit de l'utilisateur connecté (p. ex. admin). Avec sudo, la commande est exécutée avec les droits d'administrateur en tant qu'utilisateur root.

Chaque utilisateur dispose de ses propres paramètres et identifiants enregistrés. Ce qu'un utilisateur enregistre n'est pas visible pour un autre.