Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Requirement ChecklistComments
Operating System: Debian 12 Minimal Installation without GUI

Do not use newer versions of the operating system unless explicitely specified here.

Debian 12 .iso download location:

Debian 12 iso

Installation Guide:

Debian - Basic OS Installation from ISO (Debian/Win2019) - jtel Portal WIKI - jtel Public WIKI

SSH accessRequired. For on premise installations this can be via a jump server.
root access

Provide the root user password to jtel for installation purposes.

After installation this is no longer required (jtel will access the system using the jtel user).

jtel user

Create a jtel user first before proceeding to create other users. This will ensure that the GID and UID of the user are the first available (1000).

The password will be required by jtel for the jtel user. Please note, we may change the password.

Give jtel user sudo rightsMake sure the jtel user has sudo rights.
No additional packages installedDo not install any additional packages at this stage until the installation is completed.
Internet AccessThe machine must be given internet access for the installation, and also for any subsequent updates or patches to the system. A list of the required sites which will be accessed can be found here: Required Internet Access (jtel Container Stack) 

Network Interface

Requirement: The VM must have a single primary network interface. Provide the interface name before provisioning. Use ip link show or ifconfig -a to identify.

IP-Address configuration

Requirement: Static IP address

Backup Storage

For storage of backups, either an SMB or NFS fileshare must be provided including the following data:

SMB

InformationExplanationExample
TypeSMBThe type of fileshare
IP-AddressThe IP-Address of the Samba share10.10.100.10
PathThe path to the backup directory/srv/jtel-backup
UsernameA User for jtel that was created on the Samba Serverjtel
PasswordThe password of the samba user************
DomainThe domain name where the samba server is located. Optional setting.
SMB VersionThe Samba VersionSMB3.1.1 or higher
Retention daily backupHow long daily backups are kept on the share until they are deleted. If left empty, infinite.14
Retention weekly backupHow long weekly backups are kept on the share until they are deleted. If left empty, infinite.95
Retention monthly backupHow long monthly backups are kept on the share until they are deleted. If left empty, infinite.165

NFS

RequirementExplanationExample
TypeNFSThe type of fileshare
IP-AddressThe IP-Address of the NFS share10.10.100.10
PathThe path to the backup directory/srv/jtel-backup
NFS VersionThe NFS VersionNFSv4.1
Retention daily backupHow long daily backups are kept on the share until they are deleted. If left empty, infinite.14
Retention weekly backupHow long weekly backups are kept on the share until they are deleted. If left empty, infinite.95
Retention monthly backupHow long monthly backups are kept on the share until they are deleted. If left empty, infinite.165

Sizing

Info

Reminder: The Backup Storage should not be part of the actual stack VM, but should be external.

VM Sizing

Up to 20 Concurrent Agents

SizingCPU CoresRAMStorage
Minimal (only recommended for systems with low load or testing purposes)416 GB500 GB
Optimal (recommended for normal operations)832 GB1 TB

Up to 60 Concurrent Agents

SizingCPU CoresRAMStorage
Minimal (only recommended for systems with low load)832 GB1 TB
Optimal (recommended for normal operations)1664 GB2 TB

Up to 200 Concurrent Agents

SizingCPU CoresRAMStorage
Minimal (only recommended for systems with low load)1664 GB2 TB
Optimal (recommended for normal operations)32128 GB4 TB

Over 200 Concurrent Agents

Bespoke calculation based on exact system requirements.

Backup Storage Sizing and Retention Policy

The backup storage, which should be external to the VM itself, will need to be sized accordingly, and also you will need to implement a rotation and retention strategy. 

WORM

We do highly recommend the usage of WORM storage with appropriately configured policies. Since the backup is content based, 

In all cases you will need to consult your data protection officers to determine what are reasonable retention policies for your business.

Retention Policy

We recommend implementing a retention and rotation scheme. This is an example only, for exact retention policies please discuss with your data protection officer.

  • Daily backups, retained for example for 14 days
  • Weekly backups, copied from daily backups as required, retained, for example, for 12 weeks
  • Monthly backups, copied from weekly backups as required, retained, for example, for 24 months

Sizing

Warning

It is impossible to calculate the exact size of backup storage required, as this is a function of:

  • actual system usage
  • features which are activated
  • retention period

We recommend you use a storage system which allows for dynamic growth wherever possible.

The following are guidelines only!

To determine the actual size of the backup storage you require, you should regularly examine your backup storage. In daily, you will find 2 files created each day:

  • One sql.gz file - this contains the database backup
  • One tar.bz2 file - this contains the data directory files backup

The naming of the files follows the following convention:

  • <instance_name>_<version>_<date>_<time>_<machine_name>.sql.gz
  • <instance_name>_<version>_<date>_<time>_<machine_name>.tar.bz2

For example:

  • cmyacd.jtel.online_3.44.1_2026-05-15-020000+0200_cmyacd-debian-vm.sql.gz
  • cmyacd.jtel.online_3.44.1_2026-05-15-020000+0200_cmyacd-debian-vm.tar.bz2

Adding up the size of these two files, and considering some growth thereof, will give you an approximate size of what each day's backup will need.

Use your retention policy to calculate the final sizing of the backup storage.

Here are some examples, using approximate sizes of data observed in the field:


SizingDB Backup SizeFile System Backup SizeDaily Backup SizeExample retention policy aboveCalculated Minimum Backup SizeActual Backup Size (Including Spare Capacity for Growth)
Up to 20 Concurrent Agents50 MB100 MB150 MB150 MB * ( 14 + 12 + 24 )7.5 GB15 GB
Up to 60 Concurrent Agents100 MB400 MB500 MB500 MB * ( 14 + 12 + 24 )25 GB50 GB
Up to 200 Concurrent Agents300 MB1.2 GB1.5 GB1.5 GB * ( 14 + 12 + 24 )75 GB150 GB
Over 200 Concurrent Agents



Bespoke calculation based on exact system requirements.

Performance and Benchmarking

...

Storage Sizing and i/o Performance

Sizing

The system writes a considerable amount of data and logs to disk during high load conditions. It is important, that the underlying disk system on the container host provides enough performance and does not get saturated under load.

...