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:
- Apache instalado en su servidor. Si aún no lo ha instalado, puede leer esta guía: Cómo instalar Apache en Ubuntu 20.04 LTS .
- Base de datos MySQL o MariaDB instalada en su servidor. Puede leer una de las siguientes guías: Cómo instalar MySQL en Ubuntu 20.04 LTS o Cómo instalar MariaDB en Ubuntu 20.04 LTS .
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 root@IP_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 nome_utente@IP_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 nome_utente@IP_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-fpm
está 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 ini
a php-fpm
y modifica los parámetros que se muestran a continuación. Incluyen configuraciones de límite de memoria y zona horaria. Agrega el tuyo date.timezone
y cambia memory_limit
a 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
v1
Se 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 8080
en 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.