Installation
Prerequisites
| RAM | CPU2 | Competing users 1 | Nb Products/Projects |
|---|---|---|---|
| 16Go | 2 | 0-5 | < 1000 |
| 24Go | 2 | 5-10 | < 5000 |
| 32Go | 4 | 10-30 | < 20000 |
| 64Go | 6 | >30 | > 20000 |
Disk space:
- 1 system disk of 15 GB which include / and swap partitions
- 1 data disk of 50 GB whose volume depends mainly on the documents
Associated with the products, we can decompose the space used for 1,000 products as follows:
- Database space: about 10 GB
- Space for full text search index: about 10 GB
- Space for related documents: 10 GB (1,000 products * 10 MB)
1. With these metrics, N concurrent users are considered 10xN occasional users. ↩
2. 2 CPUs are equivalent to 1 dual-core ↩
Software prerequisites
beCPG is distributed as a docker container allowing it to run on any server. beCPG provides automatic installation and full support for the installation of containers in the following environment Ubuntu Server >= 20.04.4 LTS 64 bits.3
Ubuntu Server 24.04 LTS 64 bits can be installed on a virtualized, dedicated or cloud server.
Download address for ISO images: [https://www.ubuntu.com/download/server]
3. beCPG can also be deployed on a kupernete environment like Amazon EKS, Google cloud or other. However, this will not be the subject of this documentation. ↩
The rest of the documentation is based on the use of a Linux Ubuntu >= 24.04 LTS 64 bits virtual machine .
Installation Tutorial: https://tutorials.ubuntu.com/tutorial/tutorial-install-ubuntu-server
Prerequisite client item
A post able to run a modern browser such as Firefox, a PDF reader and a suite office.
- 2 CPU
- 4 GB of RAM
- Temporary storage space when editing documents (space took by documents in edition)
Server installation
beCPG provides an installation script that can be used and adapted as needed.
chmod + x install_docker_ubuntu_23.2.1.sh
./install_docker_ubuntu_23.2.1.sh
Once executed, the following software components will be installed on the virtual machine:
The installation consists of docker images that are built and distributed by beCPG. Docker Compose is used to start downloading and updating these images.
On the host machine, under /opt/becpg-srv-instances , you will find the installation folder of beCPG. The important files are:
/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
By default, beCPG creates a new partition on the data disk. This partition contains all the data of the application, the containers and the docker volumes.
The mount point is /mnt/becpg-data by default
Sample script to create the new data partition on disk /dev/sdb
mkdir /mnt/becpg-data
mkfs.ext4 /dev/sdb
echo "/dev/sdb/mnt/becpg-data ext4 rw, noatime, errors = remount-ro, x-systemd.automount, x-initrd.mount 0 1" >> /etc/fstab
mount -a
Deploy a new version of beCPG
The deployment of beCPG and its update is are done by docker-compose . The orders are as follows:
cd/opt/becpg-srv-instances/inst1
docker compose pull
docker compose up -d