Installation

beCPG est distribué sous forme de conteneurs docker et l'installation ainsi que la configuration de l'application sont réalisées par beCPG. La présente section décrit ce que le client doit fournir : une machine virtuelle correctement dimensionnée, un accès réseau et quelques informations préalables.

Dimensionnement de la machine virtuelle

Prérequis matériel

Le dimensionnement dépend du nombre d'utilisateurs concurrents et du volume de produits gérés :

disque :

• 1 disque système de 15 Go comprenant une partition / et une partition SWAP
• 1 disque de données de 50 Go dont le volume dépend principalement des documents

Associé aux produits, on peut décomposer l'espace utilisé pour 1 000 produits ainsi :

• Espace base de données : environ 10 Go
• Espace pour l'index de recherche plein texte : environ 10 Go
• Espace pour les documents associés : 10 Go (1 000 produits * 10 Mo)

¹. Avec ces métriques, N utilisateurs concurrents sont considérés comme 10xN utilisateurs occasionnels. ↩

². 2 CPU sont équivalents à 1 Dual-core ↩

Dimensionnement des modules optionnels

Deux modules sont optionnels et ne sont installés que s'ils ont été souscrits :

• beCPG OLAP — Business Intelligence : cubes d'analyse et tableaux de bord décisionnels ;
• beCPG AI — assistant IA « Chef AI », suggestions et optimisation de recettes.

Ils peuvent être hébergés sur le serveur beCPG ou sur un serveur séparé. Les ressources ci-dessous s'ajoutent au dimensionnement du tableau précédent lorsqu'ils sont installés sur la même machine :

Module beCPG OLAP

• Le disque nécessaire suit le volume de données analysées : compter environ 1 Go pour 1 000 produits, avec un minimum de 10 Go.
• La synchronisation des cubes s'exécute périodiquement (toutes les 2 heures par défaut) ; la charge CPU est concentrée sur ces exécutions.
• Les données du module sont sauvegardées avec le reste de l'instance (voir Sauvegarde).

Module beCPG AI

• Le module ne stocke aucune donnée métier : il n'y a pas de base de données ni de volume supplémentaire à sauvegarder.
• 4 Go de RAM conviennent jusqu'à une dizaine d'utilisateurs simultanés de l'assistant ; prévoir 6 Go au-delà.
• L'optimisation de recettes est un traitement intensif en calcul : réservez 2 CPU, 4 si vous optimisez fréquemment des recettes complexes.
• Un accès HTTPS sortant vers le fournisseur d'IA est indispensable. Sans cet accès, l'assistant est indisponible ; le reste du PLM n'est pas affecté.

Hébergement sur un serveur séparé

Si vous souhaitez isoler ces modules sur une autre machine, prévoyez la RAM et le CPU du tableau ci-dessus plus la base système (2 Go de RAM / 1 CPU) :

Des flux réseaux supplémentaires sont alors à ouvrir entre les deux serveurs ; ils figurent dans la check-list d'installation fournie par beCPG.

⁴. La clé d'API du fournisseur d'IA est fournie et configurée par beCPG, sauf si vous souhaitez utiliser votre propre abonnement. ↩

Prérequis logiciel

beCPG est distribué sous la forme de container docker lui permettant ainsi d'être exécuté sur n'importe quel serveur. beCPG fourni une installation automatique et un support complet pour l'installation des containers dans un environnement Ubuntu Server >= 26.04 LTS 64 bits.³

Ubuntu Server 26.04 LTS 64 bits peut être installé sur un serveur virtualisé, dédié ou dans le cloud.

Adresse de téléchargement des images ISO: [https://www.ubuntu.com/download/server]

³. beCPG peut aussi être déployé sur un environnement Kubernetes type Amazon EKS, Google cloud ou autre. Cependant, ce ne sera pas l'objet de cette documentation. ↩

Le reste de la documentation est basée sur l'utilisation d'une machine virtuelle Linux Ubuntu >= 26.04 LTS 64 bits.

Tutoriel d'installation: https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-server

Prérequis réseau

Les flux réseaux à autoriser sur vos pare-feux sont détaillés dans la check-list d'installation transmise par beCPG en début de projet. Ils doivent être ouverts avant l'intervention d'installation : sans eux, le téléchargement des composants échoue.

Prérequis poste client

Un poste en mesure d'exécuter un navigateur moderne tel que Firefox, un lecteur PDF et une suite office.

• 2 CPU
• 4 GB of RAM
• Espace de stockage temporaire lors de l'édition de documents (l'espace prit par les documents en cours d'édition)

Installation serveur

L'installation est réalisée par beCPG à partir d'un script fourni, exécuté sur la machine virtuelle mise à disposition. Elle installe les composants suivants :

• Git
• Docker et Docker Compose
• Les utilitaires système nécessaires à l'exploitation

Le script crée la partition de données, télécharge les images docker beCPG, puis configure et démarre l'application.

Sur la machine hôte, sous /opt/becpg-srv-instances, vous trouverez le dossier d’installation de beCPG. Les fichiers importants sont :

/opt/becpg-srv-instances/inst1/.env
/opt/becpg-srv-instances/inst1/README.md
/opt/becpg-srv-instances/inst1/docker-compose.yml
/opt/becpg-srv-instances/inst1/docker-compose.override.yml
/opt/becpg-srv-instances/inst1/ssl/000-default.conf
/opt/becpg-srv-instances/inst1/tunning/mysql.cnf
/opt/becpg-srv-instances/inst1/tools/
/opt/becpg-srv-instances/inst1/info/
/opt/becpg-srv-instances/inst1/ids/

Ces fichiers contiennent la configuration et les secrets de l'instance. Ils sont maintenus par beCPG : ne les modifiez pas sans validation préalable du support.

Partition

Par défaut, beCPG créé une nouvelle partition sur le disque données. Cette partition contient toutes les données de l'application, les containers et les volumes docker.

Le point de montage est par défaut /mnt/becpg-data

Exemple de script permettant la création de la nouvelle partition données sur le disque /dev/sdb

mkdir /mnt/becpg-data
mkfs.ext4 /dev/sdb
echo "/dev/sdb    /mnt/becpg-data   ext4    rw,noatime,data=writeback,barrier=0,nobh,errors=remount-ro,x-systemd.automount,x-initrd.mount  0    1" >> /etc/fstab
mount -a

Déploiement d’une nouvelle version de beCPG

Le déploiement de beCPG ainsi que sa mise à jour est réalisé grâce à docker compose. Les commandes sont les suivantes :

cd /opt/becpg-srv-instances/inst1
docker compose pull
docker compose up -d

ou, de façon équivalente :

cd /opt/becpg-srv-instances/inst1
./tools/instance.sh deploy

Une montée de version peut nécessiter une migration de données ou une réindexation. Les mises à jour de version sont planifiées avec beCPG, qui indique la procédure applicable.

Modules optionnels (OLAP / AI)

Les modules beCPG OLAP et beCPG AI sont activés et configurés par beCPG au moment de l'installation ou lors d'une intervention ultérieure. Côté client, il faut avoir prévu :

• les ressources supplémentaires décrites au paragraphe Dimensionnement des modules optionnels ;
• les flux réseaux correspondants, listés dans la check-list d'installation, en particulier l'accès sortant vers le fournisseur d'IA pour le module beCPG AI.

Une fois activés, ces modules apparaissent directement dans l'interface de l'application : le module OLAP alimente les tableaux de bord décisionnels, le module AI l'assistant « Chef AI ». Leur utilisation est décrite dans le manuel utilisateur.