OSTicket telepítése Apache / MySQL környezetben

Összefoglalás

A leírás Ubuntu 20.04 operációs rendszeren készült.

A parancsok root jogot feltételeznek.

A szükséges Apache webszerver, MySQL adatbázis szerver és PHP futtatókörnyezet az operációs rendszer tárolójából telepítjük.

Dokumentáció: https://docs.osticket.com/en/latest/

osTicket weboldal: https://osticket.com/

Futtató környezet telepítése

Webszerver, adatbáziszerver és Php futtatókörnyezet telepítése

apt install -y apache2 mysql-server php php-mysql php-imap php-xml php-mbstring php-gd php-json php-intl php-apcu php-ldap

Adatbázis létrehozása

Feltételezve, hogy a mysql root felhasználónak konzolból nincs jelszava (telepítés alapértelmezett)

SQL futtatása:

• ost: adatbázis neve
• ostuser: adatbázis felhasználó neve
• password: adatbázis felhasználó jelszava

mysql -uroot -e "CREATE DATABASE ost CHARACTER SET utf8; CREATE USER 'ostuser'@'%' IDENTIFIED BY 'password'; GRANT ALL PRIVILEGES ON ost.* TO 'ostuser'@'%';"

Webszerver konfigurálása

A példában Apache-Ubuntu alapértelmezések lesznek használatban: A /var/www/ könyvtár és a www-data user lesz használva.

Apache konfiguráció létrehozása:

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

• ServerName: domain név, ami alatt a OSTicket elérhető lesz. (A domaint konfigurálni kell a kiszolgáló IP címéhez)
• ServerAlias: további domain nevek.
• ServerAdmin: webmester e-mail címe.
• DocumentRoot: A könyvtár, ahová az OSTicket motor telepítve lesz.
• VirtualHost: a *:443 a https, a *:80 a http konfiguráció, ha csak az egyik kell, a másik elhagyható
• https konfiguráció
  • SSLCertificateFile: tanúsítvány fájl
  • SSLCertificateKeyFile: privát kulcs file
  • Include (opcionális): tanúsítvány lánc fájl

<IfModule mod_ssl.c>
    <VirtualHost *:443>
        ServerName mydomain.com
        ServerAlias www.mydomain.com
        ServerAdmin webmaster@mydomain.com
        DocumentRoot /var/www/osticket-1.14.1

        ErrorLog ${APACHE_LOG_DIR}/error.log
        CustomLog ${APACHE_LOG_DIR}/access.log combined

        SSLEngine on
        SSLCertificateFile  /etc/ssl/certs/ssl-cert-snakeoil.pem
        SSLCertificateKeyFile       /etc/ssl/private/ssl-cert-snakeoil.key
        #Include       /etc/ssl/certs/ssl-chain.conf
    </VirtualHost>
</IfModule>

<VirtualHost *:80>
	ServerName mydomain.com
	ServerAlias www.mydomain.com
	ServerAdmin webmaster@mydomain.com
	DocumentRoot /var/www/osticket-1.14.1
	
	ErrorLog ${APACHE_LOG_DIR}/error.log
	CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Apache konfiguráció:

a2ensite osticket.conf
service apache2 reload

OSTicket motor telepítése

# ost install
mkdir -p /var/www/osticket
mkdir -p /tmp/osticket
wget https://github.com/osTicket/osTicket/archive/refs/tags/v1.17.tar.gz -P /tmp
tar xzvf /tmp/v1.17.tar.gz -C /tmp/osticket/
mv /tmp/osticket/osTicket-1.17/* /var/www/osticket/
rm /tmp/v1.17.tar.gz
rm -R /tmp/osticket
# config file létrehozása
cp /var/www/osticket/include/ost-sampleconfig.php /var/www/osticket/include/ost-config.php
# tulajdonos beállítása
chown -R www-data:www-data /var/www/osticket
# config file szerkeszthetősége
chmod 0666 /var/www/osticket/include/ost-config.php

Az OSTicket telepítése böngészőben, a beállított domain használatával folytatható. pl: https://mydomain.com

Ha minden feltétel adott, kezdődhet a telepítés.

Értelemszerűen kell megadni az adatokat. Az adatbázis beállításoknál az Adatbázis létrehozása részben megadott adatokat kell használni.

Ha minden rendben az OSTicket feltelepül. A https://mydomain.com/scp oldaon lesz elérhető az admin panel. A webhost gyökerében a felhasználói felület érhető el.

Biztonsági okokból a config fájt csak olvashatóvá kell tenni és a setup könyvtárat törölni kell.

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

Cron időzítés beállítása

Ahhoz, hogy időzített feladatokat tudjon végrehajtani az OSTicket, be kell állítani a cron-t.

echo "*/5 * * * * www-data /usr/bin/php /var/www/osticket/api/cron.php" >> /etc/crontab
service cron reload