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
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.
Konfiguráció
A bővítmény nevére kattintva konfigurálhatjuk azt.
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.
