Cómo instalar el sistema de soporte al cliente Zammad en Rocky Linux 9

Zammad es una solución de soporte al cliente/sistema de tickets de código abierto basada en Ruby y PostgreSQL. Ayuda a las organizaciones a gestionar las comunicaciones a través de varios canales de correo electrónico, chat y redes sociales.

En esta guía, aprenderás cómo instalar el sistema de tickets Zammad en el servidor Rocky Linux. Ejecutarás Zammad con PostgreSQL, Nginx y Elasticsearch.

Prerrequisitos

Antes de comenzar, asegúrate de tener lo siguiente:

• Un servidor Rocky Linux 9.
• Un usuario no root con privilegios de administrador.
• Un nombre de dominio apuntando a una dirección IP del servidor.
• Un SELinux con estado permisivo.

Instalando dependencias

En esta sección, instalarás las dependencias para Zammad, esto incluye el repositorio EPEL, la base de datos PostgreSQL, el servidor web Nginx, Redis y Node.js.

Primero que nada, agrega el repositorio EPEL a tu sistema Rocky Linux con lo siguiente.

sudo dnf install epel-release -y

Ahora configura la configuración regional predeterminada a en_US.UTF-8 con el siguiente comando.

sudo localectl set-locale LC_CTYPE=en_US.UTF-8

Ahora ejecuta el siguiente comando para habilitar el repositorio de Node.js para la versión 18.

sudo dnf module enable nodejs:18 -y

A continuación, ejecuta el comando dnf a continuación para instalar las dependencias para Zammad, incluyendo Nginx, PostgreSQL, Redis y Node.js.

sudo dnf install imlib2 nginx postgresql-server postgresql-contrib libpq-devel redis nodejs

Ingresa y para confirmar y proceder.

Después de que la instalación haya finalizado, ejecuta el siguiente comando para inicializar el servidor PostgreSQL.

sudo postgresql-setup initdb

Inicia y habilita los servicios para Nginx, PostgreSQL y Redis con el siguiente comando.

sudo systemctl start nginx postgresql redis  
sudo systemctl enable nginx postgresql redis

Por último, verifica la versión de Node.js usando el siguiente comando. Asegúrate de tener Node.js 18.0+ instalado.

node --version

Instalando Elasticsearch

Después de instalar las dependencias, necesitarás instalar Elasticsearch. En esta sección, instalarás Elasticsearch 7.x para Zammad.

Ahora ejecuta el siguiente comando para agregar la clave GPG para el repositorio de Elasticsearch.

rpm --import https://artifacts.elastic.co/GPG-KEY-elasticsearch

Agrega el repositorio de Elasticsearch para el servidor Rocky Linux con el siguiente comando.

echo "[elasticsearch-7.x]  
name=Repositorio de Elasticsearch para paquetes 7.x  
baseurl=https://artifacts.elastic.co/packages/7.x/yum  
gpgcheck=1  
gpgkey=https://artifacts.elastic.co/GPG-KEY-elasticsearch  
enabled=1  
autorefresh=1  
type=rpm-md"| tee /etc/yum.repos.d/elasticsearch-7.x.repo

A continuación, instala Elasticsearch en tu sistema con el siguiente comando. Ingresa y para confirmar la instalación y acepta la clave GPG cuando se te solicite.

sudo dnf install elasticsearch

Después de que la instalación haya finalizado, instala el plugin ingest-attachment en tu instalación de Elasticsearch usando el siguiente comando.

/usr/share/elasticsearch/bin/elasticsearch-plugin install ingest-attachment

Ingresa y para confirmar la instalación.

Ahora recarga el administrador de systemd y comienza el servicio de elasticsearch usando el siguiente comando.

sudo systemctl daemon-reload  
sudo systemctl start elasticsearch

Una vez iniciado, verifica Elasticsearch con el comando curl a continuación. Si tu instalación es exitosa, obtendrás información detallada sobre tu versión de Elasticsearch.

curl -X GET 'http://localhost:9200'

Aumentar conexiones máximas en PostgreSQL

Para PostgreSQL, necesitas aumentar el max_connections predeterminado en el archivo postgresql.conf. Esto es necesario para Zammad.

Así que inicia sesión como usuario postgres con el siguiente comando.

su - postgres

Abre la configuración de PostgreSQL data/postgresql.conf usando el editor nano.

nano data/postgresql.conf

Cambia el max_connections predeterminado a 2000 como sigue:

max_connections = 2000

Guarda el archivo y sal.

Ahora ejecuta el comando systemctl a continuación para reiniciar el servicio de PostgreSQL y aplicar tus cambios.

sudo systemctl restart postgresql

Configurando Firewalld

Por defecto, firewalld está habilitado en Rocky Linux. Así que ahora necesitas abrir ambos servicios HTTP y HTTPS y permitir el tráfico a Zammad.

Agrega ambos servicios HTTP y HTTPS a firewalld usando el siguiente comando.

sudo firewall-cmd --zone=public --add-service=http --permanent  
sudo firewall-cmd --zone=public --add-service=https --permanent

Ahora recarga firewalld para aplicar nuevas reglas para HTTP y HTTPS.

sudo firewall-cmd --reload

Verifica la lista de reglas en firewalld usando el siguiente comando. Verás ambos servicios HTTP y HTTPS disponibles en firewalld.

sudo firewall-cmd --list-all

Instalando el sistema de soporte al cliente Zammad

Ahora que tienes las dependencias instaladas y configuradas, puedes comenzar la instalación de Zammad, que se puede hacer a través del gestor de paquetes DNF.

Agrega la clave GPG para el repositorio de Zammad usando el siguiente comando.

sudo rpm --import https://dl.packager.io/srv/zammad/zammad/key

Ahora agrega el repositorio de Zammad a tu servidor Rocky Linux con el siguiente comando.

sudo wget -O /etc/yum.repos.d/zammad.repo \  
https://dl.packager.io/srv/zammad/zammad/develop/installer/el/9.repo

A continuación, instala zammad con el comando dnf a continuación. Cuando se te solicite, escribe y para confirmar la clave gpg y la instalación de Zammad.

sudo dnf install zammad

Después de que la instalación haya finalizado, ejecuta el siguiente comando para verificar los servicios de Zammad, incluyendo zammad, zammad-web, zammad-worker y zammad-websocket.

sudo systemctl status zammad  
sudo systemctl status zammad-web  
sudo systemctl status zammad-worker  
sudo systemctl status zammad-websocket

Asegúrate de que cada servicio de Zammad esté en funcionamiento.

Por último, ejecuta el siguiente comando para configurar la integración entre Zammad y Elasticsearch.

zammad run rails r "Setting.set('es_url', 'http://localhost:9200')"  
zammad run rake zammad:searchindex:rebuild

Después de que el comando se ejecute, esto creará un índice de elasticsearch para Zammad.

Configurando Nginx como un proxy inverso

Ahora que has instalado Zammad, configurarás Nginx como un proxy inverso, y por defecto, Zammad proporciona una configuración de muestra que está disponible en el directorio /opt/zammad/contrib.

Copia la configuración de Nginx para Zammad a /etc/nginx/conf.d/zammad.conf y ábrelo usando el comando del editor nano.

cp /opt/zammad/contrib/nginx/zammad.conf /etc/nginx/conf.d/zammad.conf  
sudo nano /etc/nginx/conf.d/zammad.conf

Dentro de la opción server_name, cámbiala por tu dominio.

server_name zammad.howtoforge.local;

Guarda y sal del archivo.

Ahora verifica tu configuración de Nginx para asegurarte de que tienes la sintaxis correcta. Si es exitoso, deberías obtener una salida ‘syntax is ok‘.

sudo nginx -t

Por último, ejecuta el siguiente comando para reiniciar el servicio de Nginx y aplicar una nueva configuración de bloque de servidor para Zammad.

sudo systemctl restart nginx

Con esto, tu instalación de Zammad debería estar lista y accesible.

Asegurando Zammad con HTTPS

Ahora que Nginx está configurado, aseguraremos Zammad a través de certificados SSL/TLS. Instalarás Certbot y generarás certificados SSL utilizando certbot de Letsencrypt.

Instala Certbot y el plugin de Nginx usando el comando dnf a continuación. Escribe y para confirmar la instalación.

sudo dnf install certbot python3-certbot-nginx

Después de que la instalación esté completa, ejecuta el comando certbot a continuación para generar certificados SSL/TLS y asegurar tu instalación de Zammad. Asegúrate de cambiar la información de la dirección de correo electrónico y el nombre de dominio por tu información.

sudo certbot --nginx --agree-tos --redirect --hsts --staple-ocsp --email [email protected] -d zammad.howtoforge.local

Una vez completado, tus certificados SSL/TLS estarán disponibles en el directorio /etc/letsencrypt/live/domain.com, y tu Zammad también estará asegurado con HTTPS automáticamente.

Configurando la instalación de Zammad

Lanza tu navegador web y visita https://zammad.hwomdian.io/. Si tu instalación es exitosa, se te pedirá lo siguiente:

Haz clic en Configurar un nuevo sistema para comenzar a configurar Zammad.

Escribe los detalles de tu usuario administrador y la contraseña para Zammad, luego haz clic en Crear.

Escribe el nombre de tu organización, sube tu logo y haz clic en Siguiente para continuar.

Para la configuración del correo electrónico, haz clic en Saltar. Puedes configurar esto después de finalizar la instalación.

Ahora verás el panel de control de Zammad como el siguiente.

Conclusión

¡Felicidades! Has completado la instalación del sistema de tickets Zammad en el servidor Rocky Linux 9. Tienes Zammad ejecutándose con la base de datos PostgreSQL, Nginx como proxy inverso, Elasticsearch, y también asegurado con HTTPS a través de Certbot.