Ab Version 2.0.2 erhält Ticketix seine Updates mit seiner Lizenz von ARN. Die Seite Neuigkeiten zeigt die installierte Version unter Aktuelle Version sowie ein verfügbares Update. Sie können weiterhin manuell mit dem offiziellen Update-Paket (dem Update-ZIP) aktualisieren, zum Beispiel wenn der Server ARN nicht erreichen kann.
So finden Sie es: Einrichtung → System → Neuigkeiten (nur Administratoren). Auch die Versionsangabe oben auf jeder Verwaltungsseite öffnet diese Seite.
Über die Seite Neuigkeiten aktualisieren
Ticketix fragt alle 12 Stunden bei ARN nach Updates: über die geplante Aufgabe oder wenn ein Administrator den Verwaltungsbereich öffnet. Sie können auch auf der Seite Neuigkeiten auf Nach Updates suchen klicken.
- Wenn ein Update verfügbar ist, zeigt die obere Leiste Aktualisierung und die neue Version. Neuigkeiten zeigt die Neueste Version, die Paketgröße, die Versionshinweise und den Update-Typ: Pflicht (installiert sich selbst) oder Optional (wartet auf einen Administrator).
- Ein Pflicht-Update installiert sich selbst. Jedes andere Update wartet, bis ein Administrator auf Version … installieren klickt und bestätigt.
- Nur Administratoren können ein Update installieren.
Was während des Updates passiert:
- Ticketix lädt das Paket über HTTPS von ARN herunter und prüft die Signatur von ARN, die Prüfsumme und die Größe. Es prüft das gesamte Paket, bevor es etwas ändert. Ab Ticketix 2.3.0 wird eine Version mit der Herausgebersignatur von ARN Smart nur installiert, wenn diese Signatur zum Paket passt; andernfalls wird das Update mit „The publisher signature of Ticketix … does not match the package“ abgelehnt.
- Es sichert die Datenbank und die Dateien, die sich ändern, in
storage/updates. - Es schreibt die neuen Dateien. Etwa eine Minute lang zeigen andere Seiten eine kurze Wartungsmeldung.
- Die nächste aufgerufene Seite führt das Datenbank-Upgrade der neuen Version aus.
- Schlägt das Upgrade fehl, stellt Ticketix die vorherigen Dateien und die Datenbank wieder her, und Neuigkeiten zeigt den Grund an. Bei Erfolg zeigt Neuigkeiten eine Zeile wie „Updated from 2.1.3 to 2.1.4 on …“. Die Datenbanksicherung wird gelöscht; die Dateien der vorherigen Version bleiben bis zum nächsten Update in
storage/updates, und Neuigkeiten zeigt sie unter Dateien der vorherigen Version.
config.php, config.local.php, der Ordner storage, .htaccess und setup.php werden nie verändert. Ein Update löscht keine Dateien, die eine neue Version nicht mehr verwendet.
Wichtig: Ticketix behält nach einem erfolgreichen Update keine Datenbanksicherung. Erstellen Sie eigene regelmäßige Sicherungen der Datenbank, von
config.phpund des Ordnersstorage, einschließlichstorage/ai-secret.key.
Für Updates von ARN benötigt der Server die PHP-Erweiterungen ZIP und cURL, HTTPS-Zugriff auf licence.arnsmart.com sowie Schreibzugriff von PHP auf den Anwendungsordner und auf storage. Neuigkeiten warnt, wenn eine Erweiterung fehlt oder PHP einen Ordner nicht beschreiben kann; aktualisieren Sie manuell, bis das Problem behoben ist. Die Seite warnt auch, wenn die geplante Aufgabe einen Tag lang nicht gelaufen ist: Ohne sie sucht Ticketix nur dann nach Updates und installiert ein Pflicht-Update, wenn ein Administrator den Verwaltungsbereich öffnet. Siehe Geplante Aufgabe (Cron) einrichten.
Update von 2.0.2, 2.1.0 oder 2.1.1
Die Seite Neuigkeiten der Versionen 2.0.2, 2.1.0 und 2.1.1 lehnt Pakete, die den Ordner api der Ticket-API enthalten, mit der Meldung „The update package contains a file that is not allowed: api/ticket-create.php“ ab, bevor etwas geschrieben wird. Aktualisieren Sie eine solche Installation einmal manuell mit dem Update-ZIP der aktuellen Version (siehe unten). Ab 2.1.2 werden spätere Versionen wieder über die Seite Neuigkeiten installiert.
Manuell aktualisieren
Verwenden Sie das Update-ZIP, wenn der Server ARN nicht erreichen kann, sowie einmalig für das Update von 2.0.2, 2.1.0 oder 2.1.1.
Bevor Sie beginnen
- Laden Sie das Update-ZIP der neuen Version aus Ihrem ARN-Konto herunter und lesen Sie die enthaltene
README.md. - Verwenden Sie das Update-ZIP, nicht das Installations-ZIP. Das Update-ZIP enthält keine
config.php, keinen Ordnerstorageund keine Kundendaten. - Prüfen Sie, ob der Server die Anforderungen weiterhin erfüllt: PHP 8.3 oder neuer mit den Erweiterungen PDO, mbstring, OpenSSL, cURL, ZIP, fileinfo und Sodium.
- Halten Sie sich bereit, einen ARNA-Aktivierungscode für dieses Produkt und diese Domain anzufordern, falls eine neue Lizenzaktivierung nötig ist.
- Informieren Sie Ihr Team. Beim Update auf Ticketix 2.0.1 oder neuer von einer früheren Version werden alle Administratoren und Agenten bei ihrer nächsten Anmeldung aufgefordert, die Zwei-Faktor-Authentifizierung einzurichten.
Zuerst sichern
Erstellen Sie eine vollständige Sicherung und bewahren Sie sie außerhalb des Servers auf:
- die Anwendungsdateien;
- die Datenbank (bei SQLite die Datenbankdatei im Ordner
storage); config.php(undconfig.local.php, falls vorhanden);- den gesamten Ordner
storage.
Wichtig: Bewahren Sie
storage/ai-secret.keyzusammen mit Ihrenstorage-Sicherungen auf. Die Datei verschlüsselt die gespeicherten Schlüssel der KI-Anbieter und die Authenticator-Secrets der Zwei-Faktor-Authentifizierung. Ohne sie müssen die KI-Schlüssel erneut eingegeben werden, und Authenticator- sowie Backup-Codes funktionieren nicht mehr.
Update anwenden
- Stoppen Sie die geplante Aufgabe und, wenn möglich, schreibende Zugriffe auf die Website (zum Beispiel mit einer Wartungsseite auf dem Webserver).
- Entpacken Sie das Update-ZIP über den bestehenden Anwendungsordner. Das ZIP löscht keine Dateien. Ab Ticketix 2.0.2 enthält es keine
setup.php; das Datenbank-Upgrade benötigt sie nicht. - Löschen oder ändern Sie weder
config.php,config.local.php, den Ordnerstorage,.envnoch serverspezifische Zugriffsregeln. - Das Update-ZIP ändert die
.htaccessnicht. Stellen Sie unter Apache sicher, dass Ihre bestehenden Regeln weiterhin den Zugriff auf die Konfigurationsdateien sowie auf die Ordnercore,scripts,langundstorageverweigern. Behalten Sie unter Nginx die entsprechenden Regeln bei und erlauben Sie PHP im Ordnerapi. - Öffnen Sie den Administrationsbereich. Die erste Anfrage führt das einmalige Datenbank-Upgrade unter einer Sperre aus. Andere Anfragen warten darauf.
- Schließen Sie die Lizenzaktivierung auf dem Bildschirm Lizenz ab, wenn Ticketix Sie dazu auffordert.
- Prüfen Sie die Administrator-Anmeldung, bestehende Tickets, die Einstellungen und die Mailverbindung.
- Schalten Sie die geplante Aufgabe und den Datenverkehr wieder ein.
Update von einer Version vor 2.0.0
Tragen Sie die öffentliche Adresse der Installation, einschließlich eines eventuellen Unterordners, ohne abschließenden Schrägstrich in config.php ein:
'app_url' => 'https://support.example.com/ticketix',
Ohne diese Angabe enthalten E-Mails, die die geplante Aufgabe versendet (zum Beispiel Antworten aus der Warteschlange oder die Bestätigung eines aus eingehender E-Mail erstellten Tickets), nur einen Pfad, der sich in einem E-Mail-Programm nicht öffnen lässt. Neue Installationen erhalten app_url bei der Einrichtung.
Wenn die Aktualisierung fehlschlägt
Stellen Sie die alten Anwendungsdateien, die Konfigurationsdateien, den Ordner storage und die Datenbanksicherung gemeinsam wieder her. Nur den alten Code wiederherzustellen reicht nicht aus.
Von SQLite zu MySQL wechseln
Ab Ticketix 2.3.1 verwenden neue Installationen MySQL. Eine Installation, die mit SQLite läuft, funktioniert nach dem Update weiter, und jede Verwaltungsseite zeigt „Diese Website läuft noch mit SQLite“ mit Zu MySQL verschieben an, bis ihre Daten in MySQL liegen.
- Legen Sie eine leere MySQL-Datenbank (
utf8mb4) und einen Benutzer mit vollen Rechten darauf an. Ticketix lehnt eine Datenbank ab, die bereits Ticketix-Tabellen enthält; es überschreibt niemals eine solche. - Klicken Sie als Administrator auf Zu MySQL verschieben. Geben Sie im Bildschirm Datenbank Host, Port, Datenbankname, Benutzer und Passwort ein und klicken Sie auf Zu MySQL verschieben. Bei einer großen Installation kann dies einige Minuten dauern; das Ergebnis bleibt auch nach einem Neuladen auf dem Bildschirm.
- Während die Daten kopiert werden, kann die Website gelesen werden, aber Änderungen wie neue Tickets, Antworten und Einstellungen werden mit der Bitte abgelehnt, es in einer Minute erneut zu versuchen, und die geplante Aufgabe überspringt ihren Lauf.
- Bevor etwas kopiert wird, wird jeder Wert anhand seiner MySQL-Spalte geprüft. Ein Text, der länger als seine Spalte ist, eine Zahl, die die Spalte nicht aufnehmen kann, oder zwei Werte, die MySQL als gleich ansieht (es unterscheidet nicht zwischen Groß- und Kleinschreibung), stoppen den Wechsel, und der Bildschirm listet Tabelle, Spalte und Zeile auf, die korrigiert werden müssen. Nichts wird gekürzt. Ungültige UTF-8-Zeichen werden ersetzt und aufgelistet.
- Jede Tabelle wird mit ihren IDs kopiert und verglichen. Nur wenn alle Tabellen übereinstimmen, schreibt Ticketix die neuen Datenbankangaben in
config.phpund verwendet MySQL; die vorherige Datei wird alsstorage/backups/config-before-mysql-….phpaufbewahrt. Schlägt etwas fehl oder stimmt nicht überein, läuft die Website weiter mit SQLite. - Die SQLite-Datei (
storage/support.db, sofernconfig.phpkeine andere Datei angibt) wird niemals verändert oder gelöscht; bewahren Sie sie als Sicherung auf. Prüfen Sie anschließend die Administrator-Anmeldung, einige Tickets mit ihren Anhängen und die Wissensdatenbank.
Um zu SQLite zurückzukehren, stellen Sie die vorherige config.php wieder her und löschen Sie storage/database-move.json. Änderungen, die nach dem Wechsel vorgenommen wurden, existieren nur in MySQL.
Nach dem Update
- Öffnen Sie Neuigkeiten und prüfen Sie Aktuelle Version.
- Jeder Administrator und Agent richtet bei der nächsten Anmeldung die Zwei-Faktor-Authentifizierung ein, falls noch nicht geschehen. Siehe Zwei-Faktor-Authentifizierung und Passwort zurücksetzen.
- Wenn Sie KI nutzen, öffnen Sie die KI-Einstellungen, testen Sie jede Verbindung und prüfen Sie das Modell jeder Aufgabe. Siehe KI verbinden und KI-Limits festlegen.
- Nach einem Update auf 2.0.2 oder höher von einer früheren Version: Jedes Logo wird in einer eigenen Datei gespeichert. Wenn das Portal- oder Administrationslogo ein anderes Logo zeigt, laden Sie es unter Einrichtung → Portal → Allgemein erneut hoch.
Nach dem Update von 2.0.2 auf 2.1 oder höher
- Das Administrationsmenü wird in die Gruppen Arbeit, Inhalt, Einblicke und Einrichtung gegliedert. Export und Neuigkeiten befinden sich unter Einrichtung → System, Ihr Profil im Benutzermenü oben rechts. Selbst hinzugefügte Menülinks bleiben erhalten.
- Neue Community-Themen und Antworten von Gästen warten unter Inhalt → Community, Moderationswarteschlange, auf Freigabe, statt sofort zu erscheinen. Wählen Sie unter Einrichtung → Portal → Allgemein die Option Anmeldung erforderlich, wenn Gäste nur lesen sollen. Vor dem Update verfasste Beiträge bleiben unverändert.
- Eine früher bearbeitete Vorlage „Guest ticket verification“ behält ihr
{{verify_link}}. Fügen Sie{{ticket_link}}hinzu, um den neuen Link zu nutzen, der das Ticket direkt öffnet. Siehe E-Mail-Vorlagen und die E-Mail zum geschlossenen Ticket. - Dateien früherer Versionen, die 2.1 nicht mehr verwendet, verbleiben auf dem Server; sie sind harmlos. Die
README.mddes Update-ZIPs listet sie auf, falls Sie sie löschen möchten. - Tickets, die vor 2.1.4 per E-Mail eröffnet wurden, behalten den Kanal Portal und ihren gespeicherten Text; Kunden, die vor 2.1.3 aus E-Mails angelegt wurden, behalten den gespeicherten Namen. Ändern Sie einen Namen auf der Kundenseite.
Nach dem Update auf 2.2.0
- KI-Antwortentwürfe nutzen die Wissensdatenbank-Artikel des Ticketprodukts, wenn dessen oberste Kategorie den Produktschlüssel als Adresse hat. Prüfen Sie die Adressen Ihrer Produktkategorien unter Inhalt → Wissensdatenbank, Registerkarte Kategorien; die Schlüssel sind unter Einrichtung → Support → Produkte aufgeführt. Siehe KI-Assistent und Triage bei Tickets nutzen.
Nach dem Update auf 2.2.1 oder 2.3.0
- Nichts zu ändern: 2.2.1 und 2.3.0 ändern weder Daten noch Einstellungen. 2.3.0 ergänzt die oben beschriebene Prüfung der Herausgebersignatur.
- Ab 2.2.1 öffnet sich die vollständige Mitarbeitersuche über Alle Ergebnisse im Suchfenster und für Administratoren über Einrichtung → Portal → Suchen; die Ticketliste hat eine Schaltfläche Export; der Kanal eines Tickets wird in der Sprache der Oberfläche angezeigt. Siehe Portalsuche und Mitarbeitersuche und Tickets erstellen, organisieren und schließen.
Nach dem Update auf 2.3.1
- Die Versionen 2.1.2 bis 2.3.0 installieren 2.3.1 über den Bildschirm Neuigkeiten.
- Eine Installation mit SQLite verschiebt ihre Daten nach MySQL, wie oben unter „Von SQLite zu MySQL wechseln“ beschrieben.
- Das Datenbank-Upgrade weist jedem Artikel, jedem Community-Thema und jedem Sucheintrag eine Sprache zu und baut den Suchindex einmalig neu auf, sodass arabische, kyrillische und andere nicht-lateinische Texte gefunden werden. Danach schreibt die geplante Aufgabe neue und geänderte Artikel, Themen und Antworten in den Suchindex; lassen Sie sie weiterlaufen.
- Bestehende Artikel und Themen erhalten die Standardsprache der Website. Wenn Ihre Artikel auf Englisch sind, die Standardsprache aber Türkisch oder Arabisch ist, wählen Sie sie in der Artikelliste aus und verwenden Sie Sprache ändern.
- Das Portal kann auch auf Japanisch und Deutsch angezeigt werden. Seit 2.3.2 aktiviert das Update sie für die meisten Websites; siehe „Nach dem Update auf 2.3.2“ weiter unten.
- Nur ein Administrator kann eine Kundennachricht oder eine gesendete Antwort löschen; ein Agent löscht nur seine eigenen internen Notizen. Siehe Antworten, Notizen hinzufügen und gemeinsam an einem Ticket arbeiten.
- Eine Antwort-E-Mail wird einem Ticket nur hinzugefügt, wenn sie vom Ticketinhaber oder einem Kontakt desselben Kunden stammt oder die
[ARN:…]-Referenz des Tickets im Betreff enthält. Ein Kollege, der ohne diese Referenz von einer anderen Adresse antwortet, eröffnet ein neues Ticket. Siehe E-Mail zu Ticket, Postfächer und das Mail Center.
Nach dem Update auf 2.3.2
- Die Versionen 2.1.2 bis 2.3.1 installieren 2.3.2 über den Bildschirm Neuigkeiten. An der Konfiguration ist nichts zu ändern.
- Die Sprachlinks oben im Portal werden zu einem einzigen Sprachmenü (🌐 und die aktuelle Sprache). Siehe Sprachen und übersetzte Inhalte.
- Enthielten die gespeicherten Portalsprachen der Website Englisch, Türkisch und Arabisch, fügt das Update einmalig 日本語 und Deutsch hinzu. War eine dieser drei ausgeblendet, bleibt die Liste unverändert, und Einrichtung → Portal → Allgemein zeigt „New visitor languages are available“ an, bis die Seite gespeichert wird; aktivieren Sie dort die gewünschten Sprachen. Eine Sprache, die Sie später entfernen, bleibt entfernt.