Cómo instalar Zammad 2.0 en Ubuntu 16.04 LTS

• Prerrequisitos
• Paso 1: Configurar el FQDN (nombre de dominio completo)
• Paso 2: Instale los paquetes de OpenJDK 8
• Paso 3: Instale Elasticsearch 5 y el complemento mapper-adjuntos
• Paso 4: instala Zammad 2.0
• Paso 5: Configurar las reglas de SELinux y firewall
• Paso 6: configure el nuevo sistema Zammad desde la interfaz web

Zammad es un sistema de asistencia / tickets de código abierto diseñado para equipos de atención al cliente. Con Zammad, los representantes de servicio al cliente pueden atender fácilmente las consultas y quejas de los clientes desde varios canales, incluidos web, formulario, correo electrónico, chat, Twitter, Facebook, etc.

Prerrequisitos

• Una nueva instancia de servidor Vultr Ubuntu 16.04 LTS x64 con al menos 4 GB de memoria. Digamos que su dirección IP es 203.0.113.1y su nombre de host es helpdesk.
• Un dominio helpdesk.example.comconfigurado para apuntar a la instancia del servidor mencionada anteriormente. Puede obtener más detalles sobre esto en otro tutorial de Vultr .
• Un usuario de sudo .
• La instancia del servidor se ha actualizado al último estado estable .
• En un entorno de producción, se recomienda configurar un archivo de intercambio para optimizar el rendimiento.

Paso 1: Configurar el FQDN (nombre de dominio completo)

Según lo requerido por Zammad, debe configurar correctamente el FQDN en la instancia de su servidor antes de poder acceder de forma remota al sitio de Zammad.

Use el vieditor de texto para abrir el /etc/hostsarchivo.

sudo vi /etc/hosts

Inserte la siguiente línea antes de cualquier línea existente.

203.0.113.1 helpdesk.example.com helpdesk

Guardar y Salir.

:wq!

Use el hostname -fcomando para confirmar el resultado, que se verá así.

helpdesk.example.com

Paso 2: Instale los paquetes de OpenJDK 8

Como lo requiere Zammad, debe instalar Java en la instancia de su servidor antes de poder instalar y ejecutar Zammad.

Instale la última versión estable de OpenJDK 8.

sudo apt install -y openjdk-8-jdk

Una vez instalado OpenJDK 8, puede verificar el resultado.

java -version

La salida se verá así.

openjdk version "1.8.0_131"
OpenJDK Runtime Environment (build 1.8.0_131-8u131-b11-2ubuntu1.16.04.3-b11)
OpenJDK 64-Bit Server VM (build 25.131-b11, mixed mode)

Finalmente, configure la JAVA_HOMEvariable de entorno.

echo "JAVA_HOME=$(readlink -f /usr/bin/java | sed "s:bin/java::")" | sudo tee -a /etc/profile
source /etc/profile

Paso 3: Instale Elasticsearch 5 y el complemento mapper-adjuntos

Zammad usa Elasticsearch para proporcionar la función de búsqueda. En Ubuntu 16.04, puede instalar la última versión estable de Elasticsearch 5 utilizando el repositorio oficial de Elasticsearch DEB como se muestra a continuación.

Primero, descargue e instale la clave de firma pública Elasticsearch 5.

sudo apt install -y wget
wget -qO - https://artifacts.elastic.co/GPG-KEY-elasticsearch | sudo apt-key add -

Luego, instale el apt-transport-httpspaquete.

sudo apt install -y apt-transport-https

Guarde la definición del repositorio en /etc/apt/sources.list.d/elastic-5.x.list.

echo "deb https://artifacts.elastic.co/packages/5.x/apt stable main" | sudo tee -a /etc/apt/sources.list.d/elastic-5.x.list

A continuación, instale Elasticsearch 5.x usando APT.

sudo apt update -y
sudo apt install -y elasticsearch

Finalmente, inicie el servicio Elasticsearch y haga que se inicie automáticamente en el momento del arranque.

sudo systemctl daemon-reload
sudo systemctl start elasticsearch.service
sudo systemctl enable elasticsearch.service

Además, para permitir que Elasticsearch indexe los archivos adjuntos, debe instalar el mapper-attachmentscomplemento Elasticsearch de la siguiente manera.

sudo /usr/share/elasticsearch/bin/elasticsearch-plugin install mapper-attachments

Cuando se le pida que apruebe permisos adicionales, escriba " Y" y luego presione " Enter" para finalizar la instalación.

Reinicie el servicio Elasticsearch para cargar el nuevo complemento.

sudo systemctl restart elasticsearch.service

Paso 4: instala Zammad 2.0

Para facilitar el proceso de instalación, puede utilizar el repositorio oficial de DEB de Zammad para instalar Zammad junto con varias dependencias, incluidas Nginx, PostgreSQL y más, todo al mismo tiempo.

En primer lugar, asegúrese de que la instancia del servidor esté usando un UTF-8entorno local; de lo contrario, PostgreSQL no se puede instalar.

locale

Si encuentra alguna configuración regional distinta de en_US.UTF-8, entonces necesita cambiar a esa configuración regional de la siguiente manera.

sudo apt install -y locales
sudo locale-gen en_US.UTF-8
echo "LANG=en_US.UTF-8" | sudo tee /etc/default/locale

Después de asegurarse de que la configuración regional sea correcta, descargue el repositorio oficial de Zammad DEB.

wget -qO- https://dl.packager.io/srv/zammad/zammad/key | sudo apt-key add -
sudo wget -O /etc/apt/sources.list.d/zammad.list https://dl.packager.io/srv/zammad/zammad/stable/installer/ubuntu/16.04.repo

Instale Zammad y todas las dependencias requeridas usando APT.

sudo apt update -y
sudo apt install -y zammad

Una vez que Zammad se instaló correctamente, el servicio Zammad se iniciará automáticamente. Puede usar el siguiente comando para confirmar el estado del servicio Zammad.

sudo systemctl status zammad.service

Su estado será active (running).

Luego, use los siguientes comandos para hacer que Zammad funcione con Elasticsearch y reconstruya el índice.

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

Agregue espacio de nombre de índice Elasticsearch adicional (opcional).

sudo zammad run rails r "Setting.set('es_index', Socket.gethostname + '_zammad')"

Ignorar los tipos de archivos binarios comunes (opcional).

sudo zammad run rails r "Setting.set('es_attachment_ignore', [ '.png', '.jpg', '.jpeg', '.mpeg', '.mpg', '.mov', '.bin', '.exe', '.box', '.mbox' ] )"

Establezca el tamaño máximo de archivo adjunto (opcional).

sudo zammad run rails r "Setting.set('es_attachment_max_size_in_mb', 50)"

Para permitir que los usuarios accedan de forma remota a Zammad, debe modificar el archivo de configuración de Zammad Nginx.

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

Encuentra la línea.

 server_name localhost;

Reemplace localhostcon el FQDN de su instancia de servidor.

server_name helpdesk.example.com;

Guardar y Salir.

:wq!

Finalmente, reinicie el servicio Nginx para aplicar sus modificaciones.

sudo systemctl restart nginx.service

Paso 5: Configurar las reglas de SELinux y firewall

Use los siguientes comandos para determinar el estado de SELinux en su instancia de servidor.

sudo apt install -y policycoreutils
sestatus

Si SELinux está habilitado en el enforcingmodo en su máquina, debe modificar una regla SELinux de la siguiente manera.

sudo apt install -y selinux selinux-basics selinux-utils selinux-policy-ubuntu setools
sudo setsebool httpd_can_network_connect on -P

Si SELinux está disabledo está habilitado en el permissivemodo, ignore las modificaciones anteriores y continúe.

También debe modificar las reglas de firewall de UFW de la siguiente manera.

sudo ufw app list
sudo ufw allow OpenSSH
sudo ufw allow in "Nginx Full"
sudo ufw enable

Paso 6: configure el nuevo sistema Zammad desde la interfaz web

Apunte su navegador web favorito http://helpdesk.example.com, y luego será llevado a la Zammad getting startedpágina.

Haga clic en el Setup new systembotón para continuar.

En la Administrator Accountventana, ingrese el nombre, apellido, correo electrónico y contraseña del administrador (dos veces), y luego haga clic en el Createbotón.

En la Organizationventana, ingrese el nombre de la organización y la URL del sistema http://helpdesk.example.com, cargue su logotipo (si corresponde) y luego haga clic en el Nextbotón.

En la Email Notificationventana, elija un método de envío de correo electrónico adecuado y luego haga clic en el Continuebotón.

En la Connect Channelsventana, haga clic en el Skipbotón para finalizar la configuración inicial. Todos los canales se pueden personalizar más tarde.

Eso es todo para configurar un sistema operativo de venta de entradas Zammad. Siéntase libre de explorar la interfaz de Zammad e invitar a representantes de servicio al cliente. Gracias por leer.