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

Összefoglalás

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

A példák a szöveges fájlok szerkesztéséhez mcedit szövegszerkesztőt feltéteznek (Telepítés: apt install mc)

A parancsok root jogot feltételeznek. (állandó root jog: sudo bash)

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.

Az OSTicket 1.14.1 kiadása lesz telepítve.

A példában a webszerver és az adatbázis szerver egy hoston fut. Igény esetén ezek különválaszthatóak.

Az AD integrációban Windows 2019 szervert használtunk.

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édában Apache-Debian 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ó:

ln -s /etc/apache2/sites-available/osticket.conf /etc/apache2/sites-enabled/osticket.conf
service apache2 restart

OSTicket motor telepítése

# ost install
mkdir -p /var/www/osticket-1.14.1
mkdir -p /tmp/osticket
wget https://github.com/osTicket/osTicket/releases/download/v1.14.1/osTicket-v1.14.1.zip -P /tmp
unzip /tmp/osTicket-v1.14.1.zip -d /tmp/osticket
mv /tmp/osticket/upload/* /var/www/osticket-1.14.1/
rm /tmp/osTicket-v1.14.1.zip
rm -R /tmp/osticket
# config file létrehozása
cp /var/www/osticket-1.14.1/include/ost-sampleconfig.php /var/www/osticket-1.14.1/include/ost-config.php
# nyelvi file és pluginok
wget https://s3.amazonaws.com/downloads.osticket.com/lang/1.11.x/hu.phar -P /var/www/osticket-1.14.1/include/i18n/
wget https://s3.amazonaws.com/downloads.osticket.com/plugin/auth-ldap.phar -P /var/www/osticket-1.14.1/include/plugins/
wget https://s3.amazonaws.com/downloads.osticket.com/plugin/auth-passthru.phar -P /var/www/osticket-1.14.1/include/plugins/
wget https://s3.amazonaws.com/downloads.osticket.com/plugin/storage-fs.phar -P /var/www/osticket-1.14.1/include/plugins/
# tulajdonos beállítása
chown -R www-data:www-data /var/www/osticket-1.14.1
# config file szerkeszthetősége
chmod 0666 /var/www/osticket-1.14.1/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-1.14.1/include/ost-config.php
rm -R /var/www/osticket-1.14.1/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-1.14.1/api/cron.php" >> /etc/crontab
service cron reload

E-mail beállítás

OSTicket bug javítása

A PHP 5.6 óta az SSL stream kezelésénél a valid tanúsítvány megkövetelése az alapértelmezett. Erre nincs felkészítve az OSTicket és nem valid tanúsítvány mellett SMTP beállításakor hiba jelentkezik.

Az /include/pear/Net/SMTP.php fájlt kell javítani. A __construct függvényben, a 173. sorban, kell javítani a következőt.

// Eredeti:

if (!$socket_options)
    $socket_options = array(
        'ssl' => array('verify_peer_name' => false)
        );

// Javítás:

if (!$socket_options)
    $socket_options = array(
        'ssl' => array('verify_peer_name' => false,'verify_peer' => false)
        );

Alapértelmezett e-mail beállítás

Az Admin panelen az "Emailek/Emailek" menüpontban kattintsunk az installálláskor megadot alapértelmezett e-mailre.

Az IMAP és az SMTP beállításoknál adjuk meg a megfelelő adatokat. Az Admin panelen nyissuk meg az "Emailek/Beállítások" menüpontot.

Bejóvő emailek: Engedélyezzük az e-mail begyűjtést.

Kimenő email:

Az alapértelmezett MTA-nak vállasszuk az alapértelmezett e-mail-t.

AD integráció

LDAP plugin installálása

Az admin panelen a Bővítmények menüben az "Új bővítmény hozzáadása" gombbal telepíthetjük az már előzőleg letöltött bővítményeket. Az "LDAP Authentication and Lookup" bővítményt telepítsük.

Ezután jelöljük ki és engedélyezzük a bővítményt.

Fájl:OsTicket LDAP 2.png

Konfiguráció

A bővítmény nevére kattintva konfigurálhatjuk azt.

Fájl:OsTicket LDAP 3.png

A képen látható módon töltsük ki a formot a saját Windows domainünknek megfelelően. Az LDAP / AD integrációt engedélyezhetjünk az ügyfeleknek és / vagy az OSTicket kezelőknek.