Installation

Prérequis matériel

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 ↩

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 >= 24.04 LTS 64 bits.³

Ubuntu Server 24.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 kupernete 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 >= 24.04 LTS 64 bits.

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

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

beCPG fournit un script d'installation qui peut être utilisé et adapté en fonction des besoins.

chmod +x install_docker_ubuntu_23.2.1.sh
./install_docker_ubuntu_23.2.1.sh

Une fois exécuté, les composants logiciels suivants seront installés sur la machine virtuel:

• Git
• Docker
• Compose

L’installation est constituée d’images docker qui sont construites et distribuées par beCPG. Docker Compose est utilisé pour débuter le téléchargement et la mise à jour de ces images.

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.override.yml
/opt/becpg-srv-instances/inst1/docker-compose.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/stats.sh
/opt/becpg-srv-instances/inst1/taillogs.sh

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