Le pedimos a Gemini, la inteligencia artificial de Google cómo instalar y configurar Znuny en linux
Explicanos detalladamente cómo instalar y configurar Znuny en linux
Znuny es el sucesor espiritual y el fork comunitario de OTRS. Es un sistema de gestión de servicios (ITSM) de "clase empresarial" que destaca por su potencia y modularidad. A diferencia de otras herramientas basadas en PHP, Znuny utiliza Perl, lo que requiere una configuración de servidor específica y robusta.Aquí tienes la guía técnica detallada para desplegarlo en un entorno Linux (como Ubuntu 24.04/22.04).
1. El Ecosistema: Stack LAMP + Perl
Para que Znuny funcione, no basta con Apache y MariaDB ; necesitas un conjunto extenso de módulos de Perl que gestionan desde el procesamiento de XML hasta la comunicación con servidores de correo.
Instalación de dependencias
Ejecuta el siguiente comando para instalar el servidor web, la base de datos y las librerías necesarias:
Bash
sudo apt update
sudo apt install apache2 mariadb-server libapache2-mod-perl2 git -y
# Instalación de módulos de Perl críticos
sudo apt install libapache-dbi-perl libarchive-zip-perl libauthen-ntlm-perl libcgi-pm-perl libcrypt-openssl-rsa-perl libcrypt-ssleay-perl libdbd-mysql-perl libencode-hanextra-perl libgd-gd2-perl libgd-graph-perl libgd-text-perl libio-socket-ssl-perl libjson-xs-perl libmail-imapclient-perl libnet-dns-perl libnet-ldap-perl libpdf-api2-perl libtemplate-perl libtext-csv-xs-perl libxml-libxml-perl libxml-libxslt-perl libxml-parser-perl libyaml-libyaml-perl -y
2. Preparación de la Base de Datos
Znuny maneja grandes cantidades de datos y archivos adjuntos, por lo que MariaDB requiere ajustes específicos en su configuración para evitar errores de paquetes grandes.
Optimiza MariaDB : Edita /etc/mysql/mariadb.conf.d/50-server.cnf y añade lo siguiente bajo la sección [mysqld]:
max_allowed_packet = 64M
innodb_log_file_size = 256M
innodb_buffer_pool_size = 1G (o el 50% de tu RAM)
Reinicia el servicio: sudo systemctl restart mariadb.
Crea la base de datos:
SQL
CREATE DATABASE znuny CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'znuny_user'@'localhost' IDENTIFIED BY 'TuPasswordSegura';
GRANT ALL PRIVILEGES ON znuny.* TO 'znuny_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
3. Instalación de Znuny
Por seguridad, el sistema debe correr bajo su propio usuario y no como root.
Crear usuario de sistema: sudo useradd -d /opt/otrs -c 'Znuny user' -g www-data -s /bin/bash otrs.
Descargar y extraer:
Bash
cd /opt
sudo wget https://download.znuny.org/releases/znuny-latest.tar.gz
sudo tar -xzf znuny-latest.tar.gz
sudo mv znuny-* otrs
```
---
## 4. Configuración de Permisos y Módulos
Znuny incluye herramientas de diagnóstico que son vitales antes de iniciar el instalador web.
1. **Verificar módulos de Perl**:
```bash
sudo /opt/otrs/bin/otrs.CheckModules.pl
```
*Si falta algún módulo marcado como "Not installed", instálalo mediante `apt`*.
2. **Establecer permisos**:
```bash
cd /opt/otrs
sudo cp Kernel/Config.pm.dist Kernel/Config.pm
sudo bin/otrs.SetPermissions.pl --web-group=www-data
```
---
## 5. Configuración del Servidor Web Apache
Debes habilitar el módulo de Perl en Apache y vincular la configuración que Znuny trae por defecto.
1. **Vincular configuración**: `sudo ln -s /opt/otrs/scripts/apache2-httpd.include.conf /etc/apache2/sites-available/znuny.conf`.
2. **Activar sitio y módulos**:
```bash
sudo a2enmod perl
sudo a2enmod headers
sudo a2ensite znuny.conf
sudo systemctl restart apache2
```
---
## 6. Asistente de Instalación Web 🌐
Accede a `http://tu-ip-o-dominio/otrs/installer.pl` desde tu navegador.
* **Paso 1**: Acepta la licencia.
* **Paso 2**: Introduce las credenciales de la base de datos creadas en el Paso 2.
* **Paso 3**: Define el FQDN (ej. `tickets.tuempresa.com`) y el idioma.
* **Final**: Anota la contraseña generada para el usuario `root@localhost`.
---
## 7. Activación de Demonios (El "Corazón" del sistema)
Znuny no procesará correos ni tareas automáticas si su demonio interno no está activo.
1. **Iniciar el Daemon**: `sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl start`.
2. **Configurar Cron**:
```bash
cd /opt/otrs/var/cron
for foo in *.dist; do sudo -u otrs cp $foo ${foo%%.dist}; done
sudo -u otrs /opt/otrs/bin/Cron.sh start
```
---
### Mantenimiento Preventivo
| Tarea | Propósito | Comando |
| :--- | :--- | :--- |
| **Limpiar Caché** | Resuelve lentitud o errores visuales. | `sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Cache::Delete` |
| **Loader** | Refresca archivos JS y CSS tras cambios. | `sudo -u otrs /opt/otrs/bin/otrs.Console.pl Maint::Loader::CacheCleanup` |
| **Estado** | Verifica si el motor está vivo. | `sudo -u otrs /opt/otrs/bin/otrs.Daemon.pl status` |
Znuny es excepcionalmente estable una vez configurado, pero recuerda siempre realizar los cambios de archivos o ejecución de scripts como el usuario `otrs` para no romper los permisos del sistema.
¿Te gustaría que te explicara cómo configurar el primer buzón de correo para que Znuny empiece a convertir tus emails en tickets automáticamente?