Introducción

UVdesk es un sistema de tickets de asistencia técnica de código abierto en el que puede confiar. En esta guía, vemos cómo instalarlo en Ubuntu 20.04 LTS Focal Fossa.

UVdesk ofrece una solución de asistencia técnica basada en SaaS y código abierto para agilizar el proceso de soporte global y brindar el mejor servicio al cliente.

UVdesk Open Source es un software de servicio de asistencia gratuito totalmente funcional, diseñado en marcos muy famosos que son reconocidos por todos los desarrolladores como Symfony, un marco PHP.

Prerrequisitos

UVdesk necesita los siguientes paquetes de software instalados antes de que se pueda ejecutar y servir:

Para instalar UVdesk Ticketing System, siga los pasos a continuación.

Si desea instalar UVdesk Ticketing System en un servidor remoto, continúe leyendo, de lo contrario, omita el primer párrafo "Conectando al servidor" y lea el siguiente.

Conexión al servidor

Para acceder al servidor, necesita conocer la dirección IP. También necesitará su nombre de usuario y contraseña para la autenticación. Para conectarse al servidor como root, escriba el siguiente comando:

ssh [email protected]_DEL_SERVER

A continuación, deberá ingresar la contraseña del usuario root.

Si no usa el usuario raíz, puede iniciar sesión con otro nombre de usuario usando el mismo comando, luego cambie la raíz a su nombre de usuario :

ssh [email protected]_DEL_SERVER

Luego se le pedirá que ingrese su contraseña de usuario.

El puerto estándar para conectarse a través de ssh es 22 , si su servidor usa un puerto diferente, deberá especificarlo usando el parámetro -p , luego escriba el siguiente comando:

ssh [email protected]_DEL_SERVER -p PORTA

Actualiza e instala

Una vez en la terminal de tu nuevo servidor Ubuntu actualízalo e instala las herramientas imprescindibles que usaremos en nuestro proceso de instalación:

sudo apt update && sudo apt upgrade
sudo apt install git unzip curl apache2 libapache2-mod-fcgid -y

Hay algunos módulos necesarios para la configuración de FastCGI y necesitamos habilitarlos. Esto se puede hacer ejecutando este comando:

sudo a2enmod actions fcgid alias proxy_fcgi rewrite
sudo systemctl restart apache2

Instalar y configurar la base de datos

Usaremos MariaDB para esta configuración.

Después de instalar la base de datos, como se sugiere en los requisitos previos, el siguiente paso es crear una base de datos y un usuario para UVdesk . Así que sigamos adelante y logremos esto como se muestra a continuación. Puede nombrar su base de datos y su usuario de manera diferente y asegúrese de usar una contraseña segura.

Inicie sesión en la base de datos:

mysql -u root -p

Cree una base de datos para UVdesk:

CREATE DATABASE uvdeskdb;

Crea un usuario con contraseña:

CREATE USER 'uvdeskadmin'@'localhost' IDENTIFIED BY 'StrongPassword';

Asigne los privilegios de usuario recién creados a la base de datos de UVdesk:

GRANT ALL PRIVILEGES ON uvdeskdb . * TO 'uvdeskadmin'@'localhost';
FLUSH PRIVILEGES;
exit;

Instalar y configurar PHP

Para que se sirvan las páginas de UVdesk , debe haber un servidor web. Usaremos Apache para esta guía. Además, UVdesk requiere PHP, también tendremos que configurarlo.

Instale php-fpm y sus dependencias:

sudo apt install software-properties-common
sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php
sudo apt install php-{cli,fpm,json,common,mysql,zip,gd,mbstring,curl,xml,bcmath,imap,intl,mailparse} php-pear

Compruebe si php-fpmestá funcionando:

sudo systemctl status php7.4-fpm

Debería recibir un mensaje de salida similar al siguiente:

● php7.4-fpm.service - The PHP 7.4 FastCGI Process Manager
     Loaded: loaded (/lib/systemd/system/php7.4-fpm.service; enabled; vendor preset: enabled)
     Active: active (running) since Thu 2021-01-07 23:24:49 CET; 9s ago
       Docs: man:php-fpm7.4(8)
    Process: 137808 ExecStartPost=/usr/lib/php/php-fpm-socket-helper install /run/php/php-fpm.sock /etc/php/7.4>
   Main PID: 137795 (php-fpm7.4)
     Status: "Ready to handle connections"
      Tasks: 3 (limit: 2286)
     Memory: 11.2M
     CGroup: /system.slice/php7.4-fpm.service
             ├─137795 php-fpm: master process (/etc/php/7.4/fpm/php-fpm.conf)
             ├─137806 php-fpm: pool www
             └─137807 php-fpm: pool www

Jan 07 23:24:49 TEST-SERVER-1 systemd[1]: Starting The PHP 7.4 FastCGI Process Manager...
Jan 07 23:24:49 TEST-SERVER-1 systemd[1]: Started The PHP 7.4 FastCGI Process Manager.

Agregar configuraciones PHP recomendadas

Abrir sus archivos inia php-fpmy modifica los parámetros que se muestran a continuación. Incluyen configuraciones de límite de memoria y zona horaria. Agrega el tuyo date.timezoney cambia memory_limita 512 MB.

sudo nano /etc/php/7.4/fpm/php.ini
memory_limit = 512M

[Date]

date.timezone = Europe/Rome

Luego reinicia php-fpm:

sudo systemctl restart php7.4-fpm

Instalación del compositor PHP

v1Se requiere Composer para instalar las dependencias de UVdesk. Realice los siguientes pasos para configurar la versión 1 de Composer:

cd ~
curl -sS https://getcomposer.org/installer -o composer-setup.php
sudo php composer-setup.php --install-dir=/usr/local/bin --filename=composer --version=1.10.17

Verifique si el compositor se instaló correctamente ejecutando el comando para verificar la versión:

composer -V
Composer version 1.10.17 2020-10-30 22:31:58

Instalar UVdesk

Crearemos un directorio en el que colocar los archivos de UVdesk. Esto también nos ayudará a configurar el directorio raíz que nuestro servidor web buscará para servir archivos.

sudo mkdir /var/www/udvesk && cd /var/www/udvesk
sudo chown $USER:$USER /var/www/ -R

Usemos ahora el compositor para recuperar e instalar los archivos UVdesk en nuestro directorio raíz.

Primero, borre el caché:

cd /var/www/udvesk
composer clear-cache

Luego crea el proyecto con el siguiente comando:

composer create-project uvdesk/community-skeleton helpdesk-project

Cuando se complete la instalación, debería ver un banner como se muestra a continuación:

_   ___     ______            _       ____                                      _ _
| | | \ \   / /  _ \  ___  ___| | __  / ___|___  _ __ ___  _ __ ___  _   _ _ __ (_) |_ _   _
| | | |\ \ / /| | | |/ _ \/ __| |/ / | |   / _ \| '_ ` _ \| '_ ` _ \| | | | '_ \| | __| | | |
| |_| | \ V / | |_| |  __/\__ \   <  | |__| (_) | | | | | | | | | | | |_| | | | | | |_| |_| |
 \___/   \_/  |____/ \___||___/_|\_\  \____\___/|_| |_| |_|_| |_| |_|\__,_|_| |_|_|\__|\__, |
                                                                                       |___/

Welcome to the UVDesk Community project! UVDesk Community is an open-source e-commerce helpdesk system
which is built on top of reliable set of tools to provide you and your customers with the best support
solution possible.

To start things off, here are a few commands to help you setup:

  * Configuring your project:

    php bin/console uvdesk:configure-helpdesk

  * Run your project through a local php web server:

    php bin/console server:run


Made with 💖  by the UVDesk Team. Happy helping :)

Configurar Apache para UVdesk

Necesitamos realizar algunos cambios en la configuración predeterminada de Apache agregando los detalles que necesitamos para UVdesk. Haga una copia de seguridad del archivo predeterminado y cree uno nuevo con nuevas configuraciones.

cd /etc/apache2/sites-enabled/
sudo mv 000-default.conf 000-default.conf.bak

Cree un nuevo archivo y agregue los detalles que se muestran a continuación. Si tiene un FQDN , sustitúyalo por en lugar de esempio.com:

sudo vim /etc/apache2/sites-enabled/uvdesk.conf
Listen 8080
<VirtualHost *:8080>
    ServerName example.com
    ServerAlias www.example.com
    DocumentRoot /var/www/udvesk/helpdesk-project/public

    <Directory /var/www/udvesk/helpdesk-project/public>
        Options -Indexes +FollowSymLinks +MultiViews
        AllowOverride All
        Require all granted
    </Directory>

    <FilesMatch \.php$>
        # 2.4.10+ can proxy to unix socket
        SetHandler "proxy:unix:/var/run/php/php7.4-fpm.sock|fcgi://localhost"
    </FilesMatch>

    ErrorLog /var/log/apache2/uvdesk-error.log
    CustomLog /var/log/apache2/uvdesk-access.log combined
</VirtualHost>

En el archivo de configuración principal de Apache, Allow override en la siguiente parte del archivo de configuración

<Directory /var/www/>
        Options Indexes FollowSymLinks
        AllowOverride All ##Like this
        Require all granted
</Directory>

Cambie los permisos en el directorio raíz y reinicie el servidor web:

sudo chown -R www-data:www-data /var/www/udvesk
sudo chmod -R 755 /var/www/udvesk
sudo systemctl restart apache2

Si tiene un firewall UFW habilitado, permita el puerto 8080en el firewall:

sudo ufw allow 8080/tcp

Abra su navegador favorito y conéctese a la IP o FQDN de su servidor. http://ip-or-server-fqdn:8080. Debería ver una página como se muestra a continuación. Haga clic en " Comencemos ":

En la página siguiente, UVdesk verificará que su servidor cumpla con todos los requisitos necesarios para funcionar. Si todo va bien, haga clic en " Continuar ".

A continuación, deberá agregar los detalles de la base de datos que creamos en los pasos anteriores. Cuando termine, haga clic en " Continuar ".

La siguiente página presenta un formulario para agregar una cuenta de superadministrador en el sistema. Escriba su información, luego presione " Continuar ".

Después de eso, para que UVdesk configure el sistema, debe ingresar el prefijo preferido. Se puede ingresar cualquier prefijo para miembros / personal y clientes que prefiera. Después de ingresar, haga clic en " Continuar ".

Después de eso, lo único que le queda por hacer es instalar UVdesk. Haga clic en " Instalar ahora " para iniciar el proceso.

Una vez que se complete la instalación, UDdesk le presentará dos enlaces: Admin y Frontend . Puede hacer clic en ambos para verlos.

Al hacer clic en el enlace " Panel de administración ", accederá a un formulario de inicio de sesión para administrar UVdesk. Ingrese las credenciales de superadministrador que creamos e inicie sesión.

Se le presentará la pantalla del panel de control de UVdesk.

Conclusión

En este tutorial hemos visto cómo instalar y configurar UVdesk Ticketing System en Ubuntu 20.04 LTS.