Kamailio Deployment

Como es sabido, Kamailio implementa un script de fisrt_boot_installer.tpl, que puede ser invocado utilizando tecnología de provisioning, o bien ser ejecutado manualmente con una previa parametrización de las variables implicadas.

Para obtener nuestro script, se debe lanzar el siguiente comando:

curl https://gitlab.com/omnileads/omlkamailio/-/raw/master/deploy/first_boot_installer.tpl?inline=false > first_boot_installer.sh && chmod +x first_boot_installer.sh

So, once we have the script, we go to work on the variables, removing comments and setting their values ​​inside the script. We are going to list and explain each of these variables that should be set before running the script.

Installation Variables

• oml_infras_stage: Se refiere al proveedor de infraestructura implicado. La idea es aprovechar las APIs de los proveedores cloud para determinar cuestiones como parámetros de la red. Si vamos a instalar OnPremise o en alguna nube que no está dentro del listado, asignar onpremise como valor para la variable. Posibles valores: onpremise, aws, digitalocean, vultr, linode.
• oml_nic: Aquí debemos indicar la interfaz de red sobre la que se levantará el servicio de Kamailio.
• oml_kamailio_release: Aquí debemos indicar qué versión del componente se desea desplegar. Para ello, se deberá revisar el archivo .gitmodules de la versión de OMniLeads que se desee desplegar, y tomar el parámetro branch del componente, como valor de ésta variable.
• oml_redis_host, oml_acd_host y oml_rtpengine_host: Se mencionan éstas 3 variables de forma agrupada, ya que tienen que ver con el hecho de declarar la dirección de red de cada uno de éstos componentes con los cuales Kamailio necesita interactuar en su labor.
• oml_kamailio_shm_size y oml_kamailio_pkg_size: Se indican los valores de memoria en MB que utilizará Kamailio (shared memory y private memory, respectivamente).

Installation Execution

Finally, we can launch the script first-boot-instaler.sh. This can be done as user_data of a cloud instance, through some command line utility to manage the infrastructure, or directly copying the file to the destination Linux host and launching the execution of it.

Una vez ejecutado el script y finalizado el deploy, debemos comprobar que el componente se encuentra operativo, lanzando el siguiente comando:

systemctl status kamailio