En esta ocasión veremos cómo instalar osTicket en Debian 9 Stretch paso a paso, un sistema open source de soporte de usuarios o helpdesk mediante tickets, que podrás usar sobre tu servidor o VPS Debian.
Antes de instalar osTicket en Debian 9 Stretch
Para poder seguir los pasos de esta guía de instalación de osTicket en Debian 9 Stretch deberías asegurarte de que tu sistema cumpla estos requerimientos:
- Una máquina Debian 9 Stretch actualizada.
- Un entorno o pila LAMP (servicio web con PHP 7.2 a 7.4 y bases de datos).
- Un usuario con permisos de sudo, o en sufecto el mismo root.
- Acceso a Internet.
Si todavía no dispones del entorno mínimo sería conveniente consultar antes nuestra guía de instalación de la pila LAMP en Debian 9 Stretch. También es importante tener configurado el soporte HTTPS, pero por motivos didácticos en este tutorial trabajamos sobre HTTP.
Además, necesitamos también alguna herramienta del sistema, así que actualizamos la lista de paquetes disponibles en los repositorios de Debian 9 Stretch:
~$ sudo apt update
E instalamos las herramientas:
~$ sudo apt install -y unzip
Cómo descargar osTicket para Debian 9 Stretch
Vamos a descargar osTicket para Debian 9 Stretch desde el sitio del proyecto, donde encontraremos paquetes para las últimas revisiones de las ramas 1.16 y 1.15.
La rama 1.16 require PHP 8.0 y actualmente presenta algún que otro problema, mientras que la rama 1.15 funciona con PHP desde la versión 7.2 a la 7.4 y funciona bastante bien, por lo que será esta última versión la que instalaremos en este tutorial.
En este tutorial copiaremos el enlace del paquete en formato .zip y lo descargaremos desde consola con el comando wget:
~$ wget -q https://github.com/osTicket/osTicket/releases/download/v1.15.6/osTicket-v1.15.6.zip
Descargar paquetes de idiomas para osTicket
El paquete de osTicket viene exclusivamente en inglés, así que si queremos disfrutar de la aplicación en otro idioma debemos descargar paquetes adicionales. Para ello visitaremos la sección de descargas del sitio oficial seleccionando la sección «Language Packs«:
En este caso el sistema de descarga es un poco especial, ya que seleccionaremos el idioma o idiomas que nos interesen y cuando lo hayamos hecho seguiremos el enlace «Download«, que se mostrará en la zona inferior de la página. Se abrirá un formulario de suscripción a la lista de correo, pero podemos continuar con la descarga simplemente siguiendo el enlace «No Thanks«, que nos redireccionará a una página de descarga automática de un fichero .zip que contiene el o los paquetes de idiomas.
Si estamos navegando en una máquina distinta a aquella en la que haremos la instalación, de alguna forma debemos cargar este paquete (FTP, scp, etc.) en el directorio del usuario con el que haremos la instalación.
Cómo instalar osTicket en Debian 9 Stretch
El proceso de instalar osTicket en Debian 9 Stretch consiste básicamente en preparar los requisitos del sistema e integrar la aplicación en el servicio web que tengamos instalado. Vamos a ver detalladamente las tareas que llevaremos a cabo.
Archivos de osTicket
Descomprimimos el paquete de la aplicación que descargamos antes en un directorio temporal:
~$ unzip -q osTicket-v1.15.6.zip -d osticket
Movemos la carpeta de la aplicación a su ubicación definitiva:
~$ sudo mv osticket/upload/ /var/www/osticket
Ya podemos borrar el directorio temporal:
~$ sudo rm -rf osticket/
Si descargamos también un paquete de idiomas y lo tenemos en el directorio de trabajo, lo descomprimiremos directamente en la ruta include/i18n/ de la aplicación:
~$ sudo unzip osTicket-lang.zip -d /var/www/osticket/include/i18n/
Ahora creamos el archivo de configuración de osTicket a partir de un archivo de ejemplo que incluye el paquete:
~$ sudo cp /var/www/osticket/include/ost-sampleconfig.php /var/www/osticket/include/ost-config.php
Y cambiamos la propiedad del directorio de la aplicación al usuario con el que corre el servicio web:
~$ sudo chown -R www-data: /var/www/osticket/
Servicio web
Para integrar la aplicación en el servicio web crearemos un alias de Apache que apunte al directorio de instalación de osTicket:
~$ sudo nano /etc/apache2/sites-available/osticket.conf
El contenido es simplemente el alias que nos interese, /osticket en este caso:
Alias /osticket /var/www/osticket
Guardamos y cerramos el archivo, y activamos la configuración:
~$ sudo a2ensite osticket
Finalmente, recargamos la configuración del servicio web:
~$ sudo systemctl reload apache2
PHP
La aplicación osTicket requiere la disponibilidad en Debian 9 Stretch de ciertas extensiones, que instalaremos con apt. Como debido a los requerimientos de osTicket debemos usar una versión del repositorio alternativo, indicaremos la misma en el nombre de cada paquete; por ejemplo, para PHP 7.4:
~$ sudo apt install -y php7.4-apcu php7.4-gd php7.4-imap php7.4-intl php7.4-mbstring php7.4-xml
Aplicamos los cambios recargando la configuración del servicio web:
~$ sudo systemctl reload apache2
Base de datos
Como cualquier aplicación web compleja, osTicket trabajará sobre el servicio de bases de datos que tengamos funcionando en Debian 9, MariaDB/MySQL en este caso. Conectamos con el cliente de consola mysql y un usuario administrador:
~$ mysql -u root -p
Creamos la base de datos para osTicket:
> create database osticket;
En MariaDB o MySQL 5 creamos el usuario de la forma habitual:
> create user osticket@localhost identified by 'XXXXXXXX';
Pero si trabajamos con MySQL 8 es importante especificar el plugin de acceso compatible:
> create user osticket@localhost identified with mysql_native_password by 'XXXXXXXX';
Concedemos los permisos al usuario sobre la nueva base:
> grant all privileges on osticket.* to osticket@localhost;
Y cerramos la conexión:
> exit
Instalador web
El último paso para instalar osTicket en Debian 9 Stretch es lanzar el instalador web, para lo que accederemos desde un navegador a la dirección de la aplicación, según hayamos configurado el alias.
Por ejemplo, la máquina Debian 9 sobre la que hemos desarrollado el tutorial es accesible en el dominio debian9.local.lan, por lo que teniendo en cuenta que hemos configurado el alias /osticket usaríamos http://debian9.local.lan/osticket como URL:
La página inicial del instalador web de osTicket comprobará todos los requisitos que, si has seguido los pasos anteriores, se cumplirán en su totalidad.
Continuamos con la información básica del sitio y el administrador:
En «Ajustes del sistema» introduciremos un nombre para el sitio, el correo electrónico del sitio y seleccionaremos el idioma principal.
En cuanto al administrador, cumplimentaremos los datos de identificación y acceso, teniendo en cuenta que el correo electrónico no puede ser el mismo que el que hemos introducido antes para el sitio.
Y en la configuración de la base de datos introduciremos los datos tal y como los creamos en pasos anteriores.
En unos instantes finalizará la instalación con éxito:
Aprovecharemos este momento para borrar el directorio de instalación de osTicket, desde consola:
~$ sudo rm -rf /var/www/osticket/setup/
En la página de finalización de instalación veremos que la dirección de la aplicación para visitar en modo usuario será la misma que la que acabamos de utilizar para la instalación. Pero también se nos mostrará la dirección del panel de control, que básicamente es la ruta ampliada /osticket/scp.
Visitaremos la página principal de osTicket en Debian 9:
Ya podremos crear tickets de asistencia como usuario invitado siguiendo el enlace «Abrir un nuevo Ticket«:
El proceso de crear el ticket es sencillo, sólo hay que rellenar la información necesaria y pulsar el botón «Crear Ticket«.
Ahora accederemos al panel de control, accesible añadiendo a la dirección IP o dominio de la máquina Debian 9 el alias y la ruta /scp. En este ejemplo tendríamos http://debian9.local.lan/osticket/scp como URL de acceso:
Accedemos con el usuario administrador que configuramos durante la instalación, mostrándose la lista de tickets (que es accesible en el enlace «Panel de agente«):
Veremos la lista de tickets del sistema, incluyendo uno automático de bienvenida y aquellos que hayamos creado para probar el sistema (si lo hemos hecho).
¡Y ya podemos trabajar con nuestro nuevo sistema de helpdesk en Debian 9 Stretch!
Conclusión
Ahora que sabes cómo instalar osTicket en Debian 9 Stretch podrás disfrutar de un potente sistema de helpdesk mediante tickets para instalar en tu red local o a través de Internet. Sencillo de usar y con las ventajas que ofrece el código abierto.
Si te han surgido preguntas o dudas, tienes alguna sugerencia de mejora o quieres notificar algún error, estaré encantado de leer tus comentarios.
Y si ya estás listo para recibir tickets de usuarios gracias a esta guía de instalación de osTicket en Debian 9 Stretch y quieres agradecérnoslo, puedes hacerlo dejando una propina de tan solo 1 $ y deshacerte de la molesta calderilla que nunca usas en PayPal:
¡Gracias!
