Zextras: Cómo descargar e instalar Zextras Carbonio CE 24.x en Ubuntu 22.04 (incluye pasos para dnsmasq, chats y videollamadas)

Saludos amigos, llevo ya unos años escribiendo sobre soluciones de mensajería local y privada. Entre otras, Carbonio es una de mis favoritas ya que el desarrollo continua, aparte de incluir funcionalidades en la versión Community Edition que son casi impensables en otros proyectos similares.

Una de las novedades de Carbonio 24.3.x es que incluye soporte Ubuntu 22.04, que recordemos como SO tiene soporte hasta 2027 ahí es nada. En este vídeo os mostraré el paso a paso para descargar y configurar ésta fantástica suite de mensajería que además incluye el chat y vídeo, sin pagar nada y de manera local.

Cómo descargar e instalar Zextras Carbonio CE 24.x en Ubuntu 22.04 (incluye la configuración de dnsmasq y de Workstream) – en vídeo

Se que a muchos os gustan estos paso a paso en vídeo, escuchando comentarios, poniéndolo en un segundo monitor y comprobando con vuestro progreso. Así que ahí va:

Cómo descargar e instalar Zextras Carbonio CE 24.x en Ubuntu 22.04 (incluye la configuración de dnsmasq y de Workstream) – en blog

El YouTube de arriba cubre todo lo que necesitas saber, además de toda la instalación desde cero, sin embargo, soy consciente de que muchos otros os gusta el copy-paste para conseguir el objetivo más rápido, y tener vuestro servidor en marcha en cuestión de minutos, así que allá vamos.

Preparación del sistema operativo para Carbonio CE

Lo primero que tenemos que hacer es cambiar el usuario normal a root

sudo su 
[sudo] password for oper:

Una vez que somos root, si no hemos configurado la red en el asistente o nos han dado una dirección IP por DHCP, tendremos que editar el siguiente archivo si estamos usando Ubuntu 22.04, ya que viene con la nueva configuración de red netplan:

vi /etc/netplan/50-cloud-init.yaml

Tendremos que introducir lo siguiente:

 This file is generated from information provided by
# the datasource.  Changes to it will not persist across an instance.
# To disable cloud-init's network configuration capabilities, write a file
# /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg with the following:
# network: {config: disabled}
network:
    ethernets:
        ens192:
            addresses:
            - 192.168.1.205/24
            gateway4: 192.168.1.1
            nameservers:
                addresses:
                - [1.1.1.1]
    version: 2

Donde pone direcciones tendremos que cambiarlo por la IP que queramos poner y la puerta de enlace la dirección del router que tengamos en esa red, y Servidor DNS debemos poner o el propio servidor de Carbonio CE si lo vamos a usar como DNS, o un DNS externo.

Una vez que tengamos esto, aplicaremos la configuración:

sudo netplan apply

Si quisiéramos depurar, haríamos lo siguiente:

sudo netplan --debug apply
** (generate:1962): DEBUG: 00:03:23.322: Processing input file /etc/netplan/50-cloud-init.yaml..
** (generate:1962): DEBUG: 00:03:23.322: starting new processing pass
** (generate:1962): DEBUG: 00:03:23.323: ens192: setting default backend to 1
** (generate:1962): DEBUG: 00:03:23.323: Configuration is valid
** (generate:1962): DEBUG: 00:03:23.323: Generating output files..
** (generate:1962): DEBUG: 00:03:23.323: NetworkManager: definition ens192 is not for us (backend 1)
DEBUG:netplan generated networkd configuration changed, restarting networkd
DEBUG:no netplan generated NM configuration exists
DEBUG:ens192 not found in {}
DEBUG:Merged config:
network:
  bonds: {}
  bridges: {}
  ethernets:
    ens192:
      addresses:
      - 192.168.1.205/24
      gateway4: 192.168.1.1
      nameservers:
        addresses:
        - [1.1.1.1]
  vlans: {}
  wifis: {}

DEBUG:Skipping non-physical interface: lo
DEBUG:device ens192 operstate is up, not changing
DEBUG:{}
DEBUG:netplan triggering .link rules for lo
DEBUG:netplan triggering .link rules for ens192

También debemos verificar que nuestro archivo Hosts está correctamente configurado:

vim /etc/hosts

Estoy asumiendo que ya has configurado correctamente el nombre de host, por si acaso, ejecuta la siguiente línea:

sudo hostnamectl set-hostname carbonio.jorgedelacruz.es

Deberíamos tener algo como lo siguiente en el fichero de /etc/hosts, donde es importante que tengamos nuestra IP local, con el nombre de host+dominio y luego el nombre de host

127.0.0.1       localhost
192.168.1.205    carbonio.jorgedelacruz.es     carbonio

# The following lines are desirable for IPv6 capable hosts
::1     localhost ip6-localhost ip6-loopback
ff02::1 ip6-allnodes
ff02::2 ip6-allrouters

Zextras recomienda deshabilitar la IPv6, un poco extremo, pero bueno no creo que genera muchos problemas:

sudo sysctl -w net.ipv6.conf.all.disable_ipv6=1 && sudo sysctl -w net.ipv6.conf.default.disable_ipv6=

Reiniciaremos el equipo con un simple reinicio en la consola:

reboot

Instalación de Servidor DNS (Opcional si tenéis vuestros DNS en orden)

Si ya tuvieráis vuestra zona de DNS preparada y os resuelve el MX a la IP que queréis, y demás, no hay que hacer estos pasos, pero me he encontrado muchos casos en los que no es así, por ello, os ánimo a seguir estos pasos. Instalaremos el servidor DNS dnsmasq, que es bastante sencillo y muy conveniente para laboratorios o entornos pequeños.

El primer comando que ejecutaremos será el de instalación del paquete, donde haremos clic en Y cuando nos lo pida:

apt-get install dnsmasq

Ahora editaremos la configuración de dnsmasq para añadir las entradas necesarias:

server=1.1.1.1
domain=jorgedelacruz.es
mx-host=jorgedelacruz.es,carbonio.jorgedelacruz.es,0
address=/carbonio.jorgedelacruz.es/192.168.1.205
host-record=jorgedelacruz.es,192.168.1.205
host-record=carbonio.jorgedelacruz.es,192.168.1.205

Una vez guardado el archivo, tendremos que desactivar el servicio de caché de DNS que viene por defecto en Ubuntu 22.04:

sudo systemctl disable systemd-resolved
sudo systemctl stop systemd-resolved

Y ahora, activar, e iniciar nuestro dnsmasq:

sudo systemctl enable dnsmasq
sudo systemctl start dnsmasq

Pruebas para comprobar los DNS

Dos pruebas básicas que debemos hacer antes de instalar Carbonio es comprobar que el MX resuelve bien, y también que nuestra entrada DNS de tipo A resuelve, podemos comprobarlo con la herramienta dig:

Comprobación del MX:

dig mx jorgedelacruz.es

; <<>> DiG 9.16.1-Ubuntu <<>> mx jorgedelacruz.es
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 52733
;; flags: qr aa rd ra ad; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 2

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;jorgedelacruz.es.              IN      MX

;; ANSWER SECTION:
jorgedelacruz.es.       0       IN      MX      0 carbonio.jorgedelacruz.es.

;; ADDITIONAL SECTION:
carbonio.jorgedelacruz.es. 0    IN      A       192.168.1.205

;; Query time: 4 msec
;; SERVER: 127.0.0.53#53(127.0.0.53)
;; WHEN: Thu Dec 01 09:51:42 UTC 2022
;; MSG SIZE  rcvd: 102

Comprobación de Host A:

dig carbonio.jorgedelacruz.es

; <<>> DiG 9.16.1-Ubuntu <<>> carbonio.jorgedelacruz.es
;; global options: +cmd
;; Got answer:
;; ->>HEADER<<- opcode: QUERY, status: NOERROR, id: 20042
;; flags: qr aa rd ra; QUERY: 1, ANSWER: 1, AUTHORITY: 0, ADDITIONAL: 1

;; OPT PSEUDOSECTION:
; EDNS: version: 0, flags:; udp: 4096
;; QUESTION SECTION:
;carbonio.jorgedelacruz.es.     IN      A

;; ANSWER SECTION:
carbonio.jorgedelacruz.es. 0    IN      A       192.168.1.205

;; Query time: 0 msec
;; SERVER: 127.0.0.53#53(127.0.0.53)
;; WHEN: Thu Dec 01 09:51:55 UTC 2022
;; MSG SIZE  rcvd: 70

Podemos ver en la prueba anterior que lanzamos una consulta y nos devuelve una respuesta y que el Servidor que se encarga de responder es 127.0.0.1, la IP local 192.168.1.11 también funcionaría, si no tienes estos resultados, por favor revisa la configuración, o deja un comentario para que pueda ayudarte.

Instalación de PostgreSQL 16

Antes de instalar Carbonio 24.x, necesitaremos tener perfectamente instalado y configurado PostgreSQL 16. Lo primero que haremos será añadir el repositorio oficial de PostgreSQL a nuestro servidor:

sudo sh -c 'echo "deb https://apt.postgresql.org/pub/repos/apt $(lsb_release -cs)-pgdg main" > /etc/apt/sources.list.d/pgdg.list'

Vamos ha añadir también la KEY de PostgreSQL para validarnos contra sus repositorios:

wget --quiet -O - https://www.postgresql.org/media/keys/ACCC4CF8.asc | sudo apt-key add -

Cuando ya tenemos todo de manera correcta, sin errores espero, lanzamos un apt-get update:

sudo apt-get update && sudo apt-get upgrade

Y finalmente lanzamos la instalación de PostgreSQL 16, que tardará apenas unos segundos:

sudo apt install postgresql-16 -y

Configuración específica de PostgreSQL para Carbonio 24.x

Necesitaremos unos pequeños pasos para Carbonio, el primero de ellos es irnos al fichero de configuración /etc/postgresql/16/main/pg_hba.conf y al final del todo tendremos que añadir las líneas que contienen MD5, con vuestras propias IPs por supuesto:

# DO NOT DISABLE!
# If you change this first entry you will need to make sure that the
# database superuser can access the database using some other method.
# Noninteractive access to all databases is required during automatic
# maintenance (custom daily cronjobs, replication, and similar tasks).
#
# Database administrative login by Unix domain socket
local   all             postgres                                peer

# TYPE  DATABASE        USER            ADDRESS                 METHOD

# "local" is for Unix domain socket connections only
local   all             all                                     peer
# IPv4 local connections:
host    all             all             127.0.0.1/32            scram-sha-256
host    all             all             127.0.0.1/32            md5
host    all             all             192.168.1.205/32        md5
# IPv6 local connections:
host    all             all             ::1/128                 scram-sha-256
# Allow replication connections from localhost, by a user with the
# replication privilege.
local   replication     all                                     peer
host    replication     all             127.0.0.1/32            scram-sha-256
host    replication     all             ::1/128                 scram-sha-256

Haremos un restart del servicio:

sudo systemctl restart postgresql

Además de ellos, hay que lanzar dos comandos para crear la zona de admins de Carbonio, para ello capturaremos una contraseña en una variable en nuestro terminal:

read -s -p "Password:" DB_ADM_PWD

Y una vez hemos introducido la contraseña, que deberíais guardar en algún lugar seguro, ejecutaremos los siguientes comandos:

su - postgres -c "psql --command=\"CREATE ROLE carbonio_adm WITH LOGIN SUPERUSER encrypted password '$DB_ADM_PWD';\""
su - postgres -c "psql --command=\"CREATE DATABASE carbonio_adm owner carbonio_adm;\""

Volvemos a reiniciar el servicio y ¡ya estaría todo!

sudo systemctl restart postgresql

Instalando Carbonio CE 24.x en Ubuntu 22.04 LTS

Es el momento de instalar el nuevo software Carbonio CE, que se puede encontrar en el siguiente enlace.

• https://www.zextras.com/carbonio-community-edition/#discoverproduct

Eso nos enviará un correo electrónico con las instrucciones, una vez que hayamos añadido el repositorio Zextras adecuado, será tan sencillo como obtener el fichero para tener el repositorio:

sudo apt-get update && sudo apt-get upgrade

Veremos que el nuevo repositorio de Zextras se actualiza también, una vez que termina, vamos a ejecutar la instalación:

sudo apt install -y service-discover-server \
carbonio-directory-server \
carbonio-files-db \
carbonio-mailbox-db \
carbonio-docs-connector-db \
carbonio-tasks-db \
carbonio-proxy \
carbonio-webui \
carbonio-files-ui \
carbonio-tasks-ui \
carbonio-files-public-folder-ui \
carbonio-user-management \
carbonio-mta \
carbonio-appserver \
carbonio-storages-ce \
carbonio-files-ce \
carbonio-preview-ce \
carbonio-docs-connector-ce \
carbonio-tasks-ce \
carbonio-docs-editor \
carbonio-prometheus

Esto tardará alrededor de 2-5 minutos, y cuando termine, tenemos que iniciar la configuración, y el último paso del proceso:

carbonio-bootstrap

Esto proceso no tarda mucho, y veremos algo tal que así:

Una vez termina este proceso, necesitaremos configurar el servicio de Carbonio CE Mesh, para ello tan sencillo cómo:

service-discover setup-wizard

Esto nos pedirá algunos datos, como la IP que escuchará el servicio de Mesh, así como una pass:

Y ya con todo esto, un último comando:

pending-setups -a

Nos pedirá la contraseña que hemos puesto al servicio Mesh:

Instalar y configurar los paquetes de Carbonio Workstream (Chats, video-conferencias y más)

Vamos ahora a realizar una tarea algo pesada, ya que se trata de instalar muchos servicios pequeños para hacer funcionar Workstream, y tener nuestras videollamadas y chat funcionando. Vamos allá! Es una secuencia de comandos, con lo que no podéis realizar todos a la vez, uno a uno:

Comenzaremos con el paquete de carbonio-message-dispatcher-db

apt install carbonio-message-dispatcher-db -y
pending-setups -a

PGPASSWORD=$DB_ADM_PWD carbonio-message-dispatcher-db-bootstrap carbonio_adm 127.0.0.1

Ahora, carbonio-message-dispatcher

apt install carbonio-message-dispatcher -y
pending-setups -a

PGPASSWORD=$DB_ADM_PWD carbonio-message-dispatcher-migration carbonio_adm 127.78.0.10 20000

Nota: A mí no me ha funcionado éste último comando con esa IP. Para hacerlo funcionar he tenido que lanzarlo hacia 127.0.0.1. Usarlo solo en caso de emergencia:

PGPASSWORD=$DB_ADM_PWD carbonio-message-dispatcher-migration carbonio_adm 127.0.0.1

Seguimos, ahora carbonio-message-broker:

apt install carbonio-message-broker -y
pending-setups -a

Uno más, carbonio-ws-collaboration-db:

apt install carbonio-ws-collaboration-db -y
pending-setups -a

PGPASSWORD=$DB_ADM_PWD carbonio-ws-collaboration-db-bootstrap carbonio_adm 127.0.0.1

Este, para la parte de Files:

PGPASSWORD=$DB_ADM_PWD carbonio-files-db-bootstrap carbonio_adm 127.0.0.1

Otro más, carbonio-ws-collaboration-ce:

apt install carbonio-ws-collaboration-ce -y
pending-setups -a

El penúltimo, carbonio-videoserver-ce:

apt install carbonio-videoserver-ce -y
pending-setups -a

Y el último, gran trabajo, carbonio-ws-collaboration-ui:

apt install carbonio-ws-collaboration-ui -y

Dos pequeños comandos para terminar, uno para activar la funcionalidad de chat para todos los usuarios ya que la activamos en el Class Of Service por defecto, y el otro comando para darle una contraseña al usuario Zextras (usar la que queráis):

su - zextras -c "carbonio prov mc default carbonioFeatureChatsEnabled TRUE"
su - zextras -c "carbonio prov sp zextras@$(hostname -d) C4rb0ni0123"

Comprobar que todos los servicios están bien y reboot

Es un paso pequeño, pero importante para troubleshoot algún día cuando las cosas vayan mal, observa el resultado de estos cuatro comandos:

consul members
su - zextras -c "zmcontrol -v"
su - zextras -c "zmcontrol status"
systemctl list-units carbonio*

Si todo está bien, dale un último reinicio:

reboot now

Arrancar los servicios por primera vez

Aunque este orden no debería ser necesario en cada reboot, en el primero os lo dejo aquí para lo tengáis a mano, es importante hacerlo en éste orden:

su - zextras -c 'zmcontrol restart'
systemctl restart carbonio-tasks
systemctl restart carbonio-message-broker
systemctl restart carbonio-message-dispatcher
systemctl restart carbonio-ws-collaboration
systemctl restart carbonio-videoserver

Ya está. Ahora puedes ir a las URLs habituales para ver el webmail y la Consola de Administración:

• Interfaz de usuario: https://carbonio.jorgedelacruz.es,  – Recuerda usar tu propio fqdn o IP
• Interfaz de administración: https://carbonio.jorgedelacruz.es:6071/login , – Recuerda usar tu propia fqdn o IP