Instalación de osTicket en un servidor con Linux Debian 10

En este manual te enseñaremos cómo instalar osTicket en tu servidor.

info Para la realización del manual se ha usado un servidor Debian 10 totalmente vacío (sin SWPanel). La mayor parte de la instalación se realizará a través de la consola.

Requisitos

Para poder instalar el software osTicket necesitas cumplir una serie de requisitos previos:

• Un servidor actualizado (en nuestro caso un Debian 10)
• Un entorno LAMP (Linux, Apache, MariaDB/MySQL y PHP)
• Un usuario con permisos sudo (usaremos el usuario root)
• Acceso a Internet (para descargar el software)

Preparación del servidor

Ejecutamos los siguientes comandos desde el terminal con el usuario root:

1. Actualizamos el sistema

sudo apt update && sudo apt -y upgrade

2. Instalamos el programa unzip

sudo apt install -y unzip

3. Instalamos Apache

sudo apt install apache2 apache2-utils

4. Habilitamos el inicio automático de Apache al reiniciar nuestro sistema

systemctl enable apache2

5. Configuramos www-data (usuario de apache) como propietario de la raíz web

chown www-data:www-data /var/www/ -R

6. Instalamos MariaDB

sudo apt install mariadb-server mariadb-client

7. Habilitamos el inicio automático de MariaDB al reiniciar nuestro sistema

systemctl enable mariadb

8. Instalamos PHP 7.3

apt install php7.3 libapache2-mod-php7.3 php7.3-mysql php-common php7.3-cli php7.3-common php7.3-json php7.3-opcache php7.3-readline

9. Habilitamos el modulo Apache php 7.3

a2enmod php7.3

10. Reiniciamos el servidor web

systemctl restart apache2

Instalación del software

Ejecutamos los siguientes comandos desde el terminal con el usuario root:

1. Descargamos el programa desde el sitio de desarrollo

wget -q https://github.com/osTicket/osTicket/releases/download/v1.15.2/osTicket-v1.15.2.zip

2. Descomprimimos el fichero descargado

unzip -q osTicket-v1.15.2.zip

3. Movemos la carpeta que contiene la aplicación al directorio raíz

mv upload/ /var/www/osticket

4. Borramos la carpeta scripts (no la vamos a utilizar)

rm -r scripts

5. Borramos el fichero zip (ya no lo necesitamos)

rm -r osTicket-v1.15.2.zip

6. Crearemos el archivo de configuración inicial de osTicket

cp /var/www/osticket/include/ost-sampleconfig.php /var/www/osticket/include/ost-config.php

7. Damos permiso de escritura al fichero de configuración de la aplicación

chown www-data: /var/www/osticket/include/ost-config.php

Base de datos

Vamos a crear la base de datos para que funcione correctamente con la aplicación

1. Conectamos con la base de datos con el usuario root y su contraseña

mysql -u root -p

(introduciremos la contraseña del usuario root y pulsaremos intro)

2. Crearemos la Base de Datos con el nombre "osticket"

create database osticket charset utf8mb4 collate utf8mb4_unicode_ci;

3. Crearemos el usuario y contraseña de la Base de Datos (Sustituir las X por la contraseña deseada)

create user osticket@localhost identified by 'XXXXXXXX';

4. Daremos los permisos necesarios al usuario sobre la Base de Datos

grant all privileges on osticket.* to osticket@localhost;

5. Cerraremos la conexión con la Base de Datos

exit

Servidor web

Vamos a configurar el servidor web para que funcione correctamente con la aplicación.

1. Creamos una configuración para el servicio web de osticket

nano /etc/apache2/sites-available/osticket.conf

2. El contenido del fichero será:

Alias /osticket /var/www/osticket

3. Cerramos el archivo guardando los cambios presionando Ctrl+X y presionando y+intro.

4. Activamos la nueva configuración

a2ensite osticket.conf

5. Recargamos la configuración del servidor web

systemctl reload apache2

PHP

Instalamos las extensiones necesarias para que funcione correctamente la aplicación.

1. Para la versión 7.3 (la que recomienda la aplicación)

apt install -y php7.3-apcu php7.3-gd php7.3-imap php7.3-intl php7.3-mbstring php7.3-xml

2. Reiniciamos el servidor web para que los cambios tengan efecto

systemctl reload apache2

Instalación web

La última fase de la instalación es configurar la aplicación a través de un explorador web donde nos permitirá crear el usuario administrador y nos pedirá los datos de la base de datos.

Para poder acceder a esta configuración, abriremos un explorador web y buscaremos http://dominio/osticket o en su defecto http://nombre-de-la-maquina/osticket.

La primera página nos mostrará una serie de comprobaciones, si hemos seguido el manual, las tendremos todas correctas y haremos clic en Continue.

En la siguiente página nos dejará crear el usuario administrador, su contraseña y nos pedirá los datos de conexión de la base de datos. Una vez introducidos haremos clic en Install Now. Datos requeridos:

System Settings

• Helpdesk Name (Ponemos el nombre de nuestra compañía)
• Default Email (Ponemos un correo de nuestra compañía)

Admin User

• First Name (Ponemos el nombre del usuario administrador)
• Last Name (Ponemos el apellido del usuario administrador)
• Email Address (Ponemos el mail del usuario administrador)
• Username (No existe, lo creamos ahora)
• Password (No existe, lo creamos ahora)
• Retype Password (Volvemos a poner el pasword)

Database Settings

• MySQL Table Prefix (lo dejamos tal y como está)
• MySQL Hostname (lo dejamos tal y como está)
• MySQL Database (nombre de la base de datos --> osticket)
• MySQL Username (usuario de la base de datos -->osticket)
• MySQL Password (la contraseña de la base de datos que pusimos -->XXXXXXXX)

El proceso de instalación tardará un momento y nos mostrará una última página donde nos informará del resultado exitoso de la operación y nos sugerirá que demos permiso al archivo de configuración de la aplicación.

1. Borraremos el instalador web de la aplicación

rm -rf /var/www/osticket/setup/

2. Daremos permisos al fichero de configuración

chmod 0644 /var/www/osticket/include/ost-config.php

success Listo! Ya podremos acceder a nuestro servicio de osTicket usando la URL: http://dominio/osticket

Para acceder al backend lo haremos a través de la misma URL pero añadiendo "/scp" al final (http://dominio/osticket/scp).

Modificar el idioma (opcional)

Para poder modificar el idioma de la aplicación tenemos que descargar el fichero del idioma que nos interesa desde la página oficial de la aplicación, pasar el archivo por FTP y descomprimirlo en la ubicación correcta. Como el servidor que usamos es un Debian 10 vacío, lo primero será crear un usuario e instalar el servicio de FTP.

1. Creamos un usuario en el sistema para el FTP

adduser testftp

• Introducimos la contraseña y presionamos intro.
• Repetimos la contraseña y presionamos intro.
• Hacemos 5 intros, presionamos y + intro.

2. Instalación de vsftp desde los repositorios de Debian 10

sudo apt -y install vsftpd

3. Configuramos el servicio de FTP modificando su fichero de configuración

nano /etc/vsftpd.conf

4. Modificamos:

...
write_enable=YES
...
ssl_enable=YES
...

5. Cerramos el fichero con Ctrl + x y lo guardamos con y + intro.

6. Reiniciamos el servicio para que las modificaciones tengan efecto

systemctl reload vsftpd 

7. Descargamos el paquete de idioma de la web oficial de [osTicket] (https://osticket.com/download/) haciendo clic en Language pack, seleccionando el idioma (Spanish - Español) y haciendo clic en Download.

8. Pasamos por FTP el paquete de idioma al servidor con algún cliente FTP como Filezilla.

9. Descomprimimos el paquete en el directorio correcto.

unzip /home/testftp/osTicket-lang.zip -d /var/www/osticket/include/i18n/ 

10. Entramos en el backend con la URL http://dominio/osticket/scp

11. Usamos las credenciales del usuario administrador para entrar.

12. Hacemos clic en la pestaña settings

13. Buscamos la opción Primary Language y seleccionamos "español (España)"

14. Bajamos al final de la página y hacemos clic en Save Changes

info Listo! Si cambiamos de pestaña o salimos, ya nos modifica el idioma.