Instal·lació d' osTicket en un servidor amb Linux Debian 10

En aquest manual t'ensenyarem com instal·lar osTicket al teu servidor.

info Per a la realització del manual s'ha fet servir un servidor Debian 10 totalment buit (sense SWPanel). La major part de la instal·lació es realitzarà a través de la consola.

Requisits

Per poder instal·lar el software osTicket necessites complir una sèrie de requisits previs:

• Un servidor actualitzat (en el nostre cas un Debian 10)
• Un entorn LAMP (Linux, Apache, MariaDB/MySQL i PHP)
• Un usuari amb permisos sudo (usarem l'usuari root)
• Accés a Internet (per descarregar el software)

Preparació del servidor

Executem les ordres següents des del terminal amb l'usuari root:

1. Actualitzem el sistema

sudo apt update && sudo apt -y upgrade

2. Instal·lem el programa unzip

sudo apt install -y unzip

3. Instal·lem Apache

sudo apt install apache2 apache2-utils

4. Habilitem l'inici automàtic d'Apache en reiniciar el nostre sistema

systemctl enable apache2

5. Configurem www-data (usuari d'apache) com a propietari de l'arrel web

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

6. Instal·lem MariaDB

sudo apt install mariadb-server mariadb-client

7. Habilitem l'inici automàtic de MariaDB en reiniciar el nostre sistema

systemctl enable mariadb

8. Instal·lem 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. Habilitem el mòdul Apache php 7.3

a2enmod php7.3

10. Reiniciem el servidor web

systemctl restart apache2

Instal·lació del software

Executem les ordres següents des del terminal amb l'usuari root:

1. Descarreguem el programa des del lloc de desenvolupament

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

2. Descomprimim el fitxer descarregat

unzip -q osTicket-v1.15.2.zip

3. Movem la carpeta que conté l'aplicació al directori arrel

mv upload/ /var/www/osticket

4. Esborrem la carpeta scripts (no la utilitzarem)

rm -r scripts

5. Esborrem el fitxer zip (ja no ho necessitem)

rm -r osTicket-v1.15.2.zip

6. Crearem el fitxer de configuració inicial de osTicket

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

7. Donem permís d'escriptura al fitxer de configuració de l'aplicació

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

Base de dades

Crearem la base de dades perquè funcioni correctament amb l'aplicació

1. Connectem amb la base de dades amb l'usuari root i la contrasenya

mysql -u root -p

(introduirem la contrasenya de l'usuari root i premerem intro)

2. Crearem la Base de Dades amb el nom "ostiquet"

create database osticket charset utf8mb4 collate utf8mb4_unicode_ci;

3. Crearem l'usuari i la contrasenya de la Base de Dades (Substituir les X per la contrasenya desitjada)

create user osticket@localhost identified by 'XXXXXXXX';

4. Donarem els permisos necessaris a l'usuari sobre la base de dades

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

5. Tancarem la connexió amb la Base de Dades

exit

Servidor web

Configurarem el servidor web perquè funcioni correctament amb l'aplicació.

1. Creem una configuració per al servei web d'ostiquet

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

2. El contingut del fitxer serà:

Alias /osticket /var/www/osticket

3. Tanquem el fitxer desant els canvis prement Ctrl+X i prement y+intro.

4. Activem la nova configuració

a2ensite osticket.conf

5. Recarreguem la configuració del servidor web

systemctl reload apache2

PHP

Instal·lem les extensions necessàries perquè funcioni correctament l'aplicació.

1. Per a la versió 7.3 (la que recomana l'aplicació)

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

2. Reiniciem el servidor web perquè els canvis tinguin efecte

systemctl reload apache2

Instal·lació web

L'última fase de la instal·lació és configurar l'aplicació a través d'un navegador web on ens permetrà crear l'usuari administrador i demanarà les dades de la base de dades.

Per poder accedir a aquesta configuració, obrirem un explorador web i buscarem http://domini/osticket o si no n'hi ha http://nom-de-la-maquina/osticket.

La primera pàgina ens mostrarà una sèrie de comprovacions, si hem seguit el manual, les tindrem totes correctes i farem clic a Continue.

A la següent pàgina ens deixarà crear l'usuari administrador, la contrasenya i ens demanarà les dades de connexió de la base de dades. Un cop introduïts farem clic a Install Now. Dades requerides:

System Settings

• Helpdesk Name (Posem el nom de la nostra companyia)
• Default Email (Posem un correu de la nostra companyia)

Admin User

• First Name (Posem el nom de l'usuari administrador)
• Last Name (Posem el cognom de l'usuari administrador)
• Email Address (Posem el email de l'usuari administrador)
• Username (No existeix, ho creem ara)
• Password (No existeix, ho creem ara)
• Retype Password (Tornem a posar el pasword)

Database Settings

• MySQL Table Prefix (ho deixem tal com està)
• MySQL Hostname (ho deixem tal com està)
• MySQL Database (nom de la base de dades --> osticket)
• MySQL Username (usuari de la base de dades -->osticket)
• MySQL Password (la contrasenya de la base de dades que vam posar -->XXXXXXXX)

El procés d'instal·lació trigarà un moment i ens mostrarà una darrera pàgina on ens informarà del resultat exitós de l'operació i ens suggerirà que donem permís a l'arxiu de configuració de l'aplicació.

1. Esborrarem l'instal·lador web de l'aplicació

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

2. Donarem permisos al fitxer de configuració

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

success Fet! Ja podrem accedir al nostre servei d' osTicket usant la URL: http://dominio/osticket

Per accedir al backend ho farem a través de la mateixa URL però afegint-hi "/scp" al final (http://domini/osticket/scp).

Modificar l'idioma (opcional)

Per poder modificar l'idioma de l'aplicació hem de descarregar el fitxer de l'idioma que ens interessa des de la pàgina oficial de l'aplicació, passar l'arxiu per FTP i descomprimir-lo a la ubicació correcta. Com que el servidor que fem servir és un Debian 10 buit, el primer serà crear un usuari i instal·lar el servei d' FTP.

1. Creem un usuari al sistema per a l' FTP

adduser testftp

• Introduïm la contrasenya i pressionem intro.
• Repetim la contrasenya i pressionem intro.
• Fem 5 intros, pressionem i + intro.

2. Instal·lació de vsftp des dels repositoris de Debian 10

sudo apt -y install vsftpd

3. Configurem el servei de FTP modificant el seu fitxer de configuració

nano /etc/vsftpd.conf

4. Modifiquem:

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

5. Tanquem el fitxer amb Ctrl + x i el guardem amb y + intro.

6. Reiniciem el servei perquè les modificacions tinguin efecte

systemctl reload vsftpd 

7. Descarreguem el paquet d'idioma de la web oficial de [osTicket] (https://osticket.com/download/) fent clic a Language pack, seleccionant l'idioma (Spanish - Español) i fent clic a Download.

8. Passem per FTP el paquet d'idioma al servidor amb algun client FTP com a Filezilla.

9. Descomprimim el paquet al directori correcte

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

10. Entrem al backend amb la URL http://domini/osticket/scp

11. Fem servir les credencials de l'usuari administrador per entrar

12. Fem clic a la pestanya settings

13. Busquem l'opció Primary Language i seleccionem "espanyol (Espanya)"

14. Baixem al final de la pàgina i fem clic a Save Changes

info Fet! Si canviem de pestanya o en sortim, ja ens modifica l'idioma.