Inicio de VPSie

Volver a la base de conocimientos

Si busca optimizar su soporte al cliente con un sistema de tickets eficiente, Zammad es una solución potente y de código abierto que vale la pena considerar. En esta guía, le mostraremos los pasos para instalar Zammad en Debian 12, ayudándole a poner su sistema de soporte en marcha rápidamente. Ya sea que sea nuevo en Zammad o simplemente esté actualizando, esta guía asegurará que todo esté configurado sin problemas. ¡Comencemos!

Para comenzar, asegúrese de haber creado una cuenta de VPSie si aún no lo ha hecho. A continuación, proceda a desplegar un servidor Debian 12 configurado según sus necesidades específicas.

Cree su cuenta ahora

Una vez desplegado el servidor, inicie sesión en la interfaz de línea de comandos mediante SSH. Antes de instalar paquetes, es esencial actualizar su sistema operativo Debian para garantizar que todos los paquetes existentes estén actualizados. Abra una terminal y ejecute el siguiente comando:

sudo apt update && sudo apt upgrade -y

Instalar dependencias

Comience ejecutando el siguiente comando para instalar los paquetes esenciales necesarios para gestionar el repositorio. Elasticsearchrequiere Java para ejecutarse. Sin embargo, las versiones más recientes incluyen su propio entorno de ejecución de Java. Para garantizar que se cumplan todas las dependencias, instale los siguientes paquetes:

sudo apt install curl apt-transport-https ca-certificates gnupg -y

Importe la clave GPG para verificar la autenticidad de los paquetes de Elasticsearch.

wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo gpg --dearmor -o /usr/share/keyrings/elasticsearch-keyring.gpg

Cree un nuevo archivo de lista de fuentes APT para Elasticsearch.

echo "deb [signed-by=/usr/share/keyrings/elasticsearch-keyring.gpg] https://artifacts.elastic.co/packages/8.x/apt stable main" | sudo tee /etc/apt/sources.list.d/elasticsearch.list

Actualice la lista de paquetes.

sudo apt update

Después de actualizar el repositorio, instale las dependencias de Zammad ejecutando el siguiente comando.

sudo apt install libimlib2 elasticsearch postgresql postgresql-common redis-server nginx nodejs locales -y

Ejecute el siguiente comando para iniciar y habilitar Elasticsearch.

sudo systemctl start elasticsearch
sudo systemctl enable elasticsearch
sudo systemctl status elasticsearch

Puede verificar la instalación de cada paquete comprobando sus versiones o estados:

PostgreSQL:

psql --version
sudo systemctl is-enabled postgresql

Redis:

redis-server --version
sudo systemctl is-enabled redis

Nginx:

nginx -v
sudo systemctl is-enabled nginx

Node.js:

node -v

Locales:

locale -a

Cada comando debe devolver información de versión o un estado que indique que el servicio está activo y comprobar si el servicio está habilitado para iniciarse automáticamente al arrancar

Configuración de dependencias

Abra el archivo de configuración de PostgreSQL postgresql.conf para editarlo. Este archivo suele estar ubicado en el directorio de datos de PostgreSQL.

sudo nano /etc/postgresql/15/main/postgresql.conf


Nota: El número de versión (15) y la ruta del directorio pueden variar según su versión de PostgreSQL y la ubicación de instalación.


A continuación, localice el parámetro max_connections en el archivo de configuración. Si el parámetro está comentado (precedido por #), descoménte lo eliminando el símbolo #. Luego, establezca el valor en 2000:

max_connections = 2000

Después de realizar los cambios, guarde el archivo y salga del editor:


Aplique los cambios reiniciando el servicio de PostgreSQL:

sudo systemctl restart postgresql

A continuación, configure Elasticsearch instalando el plugin ingest-attachment necesario para Zammad. Use el siguiente comando elasticsearch-plugin:

Use el comando elasticsearch-plugin para instalar el plugin ingest-attachment. Este comando debe ejecutarse como usuario root o con sudo.

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

Después de instalar el plugin, reinicie el servicio de Elasticsearch para cargar el nuevo plugin.

sudo systemctl restart elasticsearch

Puede verificar que el plugin se instaló correctamente listando todos los plugins instalados.

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin list

Finalmente, verifique que Elasticsearch esté en ejecución usando curl.

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

Ahora, configure el idioma predeterminado en en_US.UTF-8. Primero, debe generar el idioma en_US.UTF-8 si no está disponible.

sudo locale-gen en_US.UTF-8

Luego, configure el idioma predeterminado en en_US.UTF-8 agregando una nueva configuración al archivo /etc/default/locale.

echo "LANG=en_US.UTF-8" > /etc/default/locale

Aplique los cambios a su sesión actual:

source /etc/default/locale

Compruebe la configuración actual de idioma para confirmar que en_US.UTF-8 esté establecido como predeterminado.

locale

Instalar Zammad

Para instalar Zammad usando paquetes del repositorio oficial de Zammad, siga estos pasos:

Descargue y agregue la clave GPG de Zammad a su sistema:

curl -fsSL https://dl.packager.io/srv/zammad/zammad/key | \
gpg --dearmor | tee /etc/apt/trusted.gpg.d/pkgr-zammad.gpg> /dev/null

Cree un nuevo archivo para el repositorio de Zammad:

echo "deb [signed-by=/etc/apt/trusted.gpg.d/pkgr-zammad.gpg] https://dl.packager.io/srv/deb/zammad/zammad/stable/debian 12 main"| \
tee /etc/apt/sources.list.d/zammad.list > /dev/null

Actualice su lista de paquetes para incluir el nuevo repositorio de Zammad:

sudo apt update

Ahora se ha añadido el repositorio de Zammad y su sistema está listo para instalar Zammad desde él. Puede instalar Zammad con el siguiente comando:

sudo apt install zammad

Una vez completada la instalación, ejecute los siguientes comandos de Zammad para configurar la integración con Elasticsearch y reconstruir el índice de búsqueda:

sudo zammad run rake searchindex:rebuild

A continuación, ejecute el siguiente comando para reiniciar todos los servicios de Zammad. Zammad incluye varios servicios, como zammad, zammad-web, zammad-worker y zammad-websocket.

sudo systemctl restart zammad zammad-web zammad-worker zammad-websocket
 

Para verificar el estado de Zammad y sus servicios relacionados, use los siguientes comandos:

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

Estos comandos le mostrarán si cada servicio está activo y en ejecución, o si hay problemas que deban resolverse.

Configurar el servidor web Nginx

De forma predeterminada, Zammad genera una configuración de bloque de servidor de Nginx ubicada en /etc/nginx/sites-available/zammad.conf. Para configurar Zammad para producción, debe modificar la configuración del dominio y protegerlo con HTTPS.

Primero, abra el archivo de configuración con el editor nano:

sudo nano /etc/nginx/sites-available/zammad.conf

Actualice la opción server_name con su dominio o ip:

server_name {your_ip/your_domain};

Guarde el archivo y salga del editor.

A continuación, verifique la sintaxis de la configuración de Nginx y reinicie el servicio de Nginx para que los cambios surtan efecto:

sudo nginx -t
sudo systemctl restart nginx

Asegúrese de que la prueba de sintaxis de Nginx sea exitosa antes de continuar.

Acceder a la interfaz web de Zammad

Abra su navegador web y vaya a la URL de instalación de Zammad http://{your-domain/ip}.

Una vez que acceda a la interfaz web, haga clic en Configurar un nuevo sistema para iniciar el proceso de instalación.

zammad

Cree su cuenta de administrador.

Introduzca el nombre de su organización y haga clic en Siguiente.

Puede configurar las notificaciones por correo electrónico más adelante; haga clic en Omitir por ahora.

Haga clic en Omitir para la configuración del canal de conexión.

Ahora debería poder acceder al panel de administración de Zammad.


Configurar Zammad en Debian 12 es un proceso sencillo que puede mejorar significativamente sus capacidades de atención al cliente. Ya sea que gestione una pequeña empresa o una gran corporación, las funciones de Zammad le ayudarán a optimizar sus operaciones de soporte y ofrecer una mejor experiencia tanto a su equipo como a sus clientes. Disfrute explorando Zammad y sus potentes herramientas; su sistema de soporte está ahora listo para generar un impacto positivo.

Volver a la base de conocimientos