====== Helpdesk / Ticketsystem ======

Das Ticketsystem basiert auf [[http://osticket.com/|osTicket]] und ist unter http://service.pinneberg.freifunk.net/ zu erreichen.

Die Mail-Adresse zur Registrierung von neuen Knoten ([[mailto:keys@freifunk-pinneberg.de]])
ist auf das Ticketsystem eingestellt.

===== Installation =====

Das Installationsarchiv, sowie das deutsche Sprachpaket können von 
http://osticket.com/download heruntergeladen werden.

Eine MySQL-Datenbank wird benötigt
<code>
CREATE DATABASE osticket;
GRANT ALL PRIVILEGES ON osticket.* TO 'osticket'@'localhost' IDENTIFIED BY 'xxxxxxxx';
</code>

Da einige Änderungen in der Übersetzung vorgenommen wurden, wurde die Sprachdatei ''de.phar''
ausgepackt. Textänderungen können damit direkt in ''LC_MESSAGES/messages.mo.php'' vorgenommen werden.
  php -r '$phar = new Phar("de.phar"); $phar->extractTo("./de_DE");'

Damit die Mails direkt von Postfix an das Ticketsystem übergeben werden können,
wird der Mailtransport über die Konfigurationsdatei ''transport'' gesteuert.

Der Transport zu osTicket wird in der Datei ''master.cf'' zentral eingerichtet:

<file conf /etc/postfix/master.cf>
[...]
osticket  unix  -       n       n       -       -       pipe
   flags=Fq user=www-data argv=/var/www/vhosts/service.pinneberg.freifunk.net/api/pipe.php ${sender}
</file>

Hinweis: Die Datei ''pipe.php'' muß Ausführungsberechtigungen besitzen.

===== Konfiguration =====

Konfigurationseinstellungen  können  über die Datei ''include/ost-config.php'' vorgenommen werden.

An vielen Stellen wird ein Avatar angezeigt. Leider gibt es keine  Möglichkeit dieses
auszustellen, ohne den Programmcode zu verändern.

Die zuständige Funktion heißt ''getAvatar()''. Ggf. wäre es sinnvoll eine Avatarquelle
mit dem Namen //Kein Avatar// zu erstellen. Diese würde dann für einen Benutzer ein
Benutzerbild, für eine Gruppe ein Gruppenbild und für eine Organisation ein Organisationsbild
anzeigen. Ggf. selber implementieren?
===== Update =====

  * Neue Version mit Wget in ein temporäres Verzeichnis herunterladen
    * ''wget https://github.com/osTicket/osTicket/releases/download/v1.12.2/osTicket-v1.12.2.zip''
  * Auspacken mit Unzip
  * Backup der aktuellen Installation machen 
    * MySQL: ''/var/backups/mysql'' 
    * OSTicket: ''/var/backups/osticket_yyyy-mm-dd.tar.gz''
      * ''tar -czvf /var/backups/osticket_2019-05-23.tar.gz /var/www/vhosts/service.pinneberg.freifunk.net''
  * Einspielen der Dateien
    * ''cp -aT /tmp/upload /var/www/vhosts/service.pinneberg.freifunk.net''
    * ''cd /var/www/vhosts/service.pinneberg.freifunk.net''
    * ''pipe.php'' wieder ausführbar machen: ''chmod +x api/pipe.php''
    * ''setup''-Verzeichnis löschen
    * Berechtigungen neu einstellen<code>
cd /var/www/vhosts
chgrp -R www-data service.pinneberg.freifunk.net/
chmod -R g+r service.pinneberg.freifunk.net/

</code>