OTOBO Installationsanleitung

Dieses Dokument unterliegt dem Copyright der OTRS AG (https://otrs.com), Zimmersmühlenweg 11, 61440 Oberursel, Deutschland.

Anpassungen und Ergänzungen unterliegen dem Copyright © der Rother OSS GmbH (https://otobo.de), Oberwalting 31, 94339 Leiblfing, Deutschland.

Nutzungsbedingungen OTRS: Dieses Dokument darf im Rahmen der GNU Free Documentation License in Version 1.3 oder jeder neueren, von der Free Software Foundation veröffentlichten Version, kopiert, verbreitet und/oder verändert werden; ohne unveränderliche Abschnitte, und ohne Umschlagtexte. Eine Kopie der Lizenz finden Sie auf der GNU-Website.

Nutzungsbedingungen Rother OSS: Dieses Dokument darf im Rahmen der GNU Free Documentation License in Version 1.3 oder jeder neueren, von der Free Software Foundation veröffentlichten Version kopiert, verbreitet und/oder verändert werden; ohne unveränderliche Abschnitte, und ohne Umschlagtexte. Den rechtlich bindenden Originaltext der Lizenz finden Sie auf der GNU-Website, eine Kopie im Abschnitt „COPYING“ dieses Dokuments.

Veröffentlicht durch: Rother OSS GmbH, Oberwalting 31, 94339 Leiblfing, Deutschland (https://otobo.de).

Autoren: OTRS AG (Originalversion), Rother OSS GmbH (Installationsanleitung OTOBO - https://otobo.de).

Inhalt

• Einleitung
  • Über dieses Handbuch
• Hardware- und Software-Anforderungen
  • Hardware-Anforderungen
  • Software-Anforderungen
• OTOBO Installation
  • Vorbereitung: Deaktivieren Sie SELinux (sofern aktiv)
  • Schritt 1: OTOBO entpacken und installieren
  • Schritt 2: Ergänzende Programme und Perl-Module installieren
  • Schritt 3: OTOBO-Benutzer anlegen
  • Schritt 4: Standard-Konfigurationsdatei aktivieren
  • Schritt 5: Apache-Webserver konfigurieren
    • Apache ohne SSL-Unterstützung konfigurieren
    • Apache mit SSL-Unterstützung kofigurieren
  • Schritt 6: Dateiberechtigungen anpassen
  • Schritt 7: Datenbank anlegen
  • Schritt 8: Elasticsearch-Cluster aufsetzen
    • Beispiel für eine Elasticsearch-Installation unter Ubuntu 18.04 LTS
    • Elasticsearch-Installation auf anderen Linux-Distributionen
    • Elasticsearch-Modul installieren
    • Elasticsearch konfigurieren
  • Schritt 9: Grundlegende Systemkonfiguration
  • Schritt 10: Erste Anmeldung
  • Schritt 11: OTOBO Daemon starten
  • Schritt 12: CronJobs für den OTOBO-Benutzer
  • Schritt 13: Bash Auto-Completion einrichten (optional)
  • Schritt 14: Weiterführende Informationen
• Installation mit Docker und Docker Compose
  • Technische Voraussetzungen
  • Installation
    • 1. Clone the otobo-docker repo
    • 2. Create an initial .env file
    • 3. Configure the password for the database admin user
    • 4. Set up a volume with SSL configuration for the nginx webproxy (optional)
    • 5. Start the Docker containers with Docker Compose
    • 6. Install and start OTOBO
  • Ergänzende technische Informationen
    • Liste der Docker Container
    • Übersicht über die Docker Volumes
    • Docker-Umgebungsvariablen
  • Weiterführende Themen
    • Individuelle Konfiguration des nginx-Webproxy
    • Single Sign On Using the Kerberos Support in Nginx
    • Individuelle Ports definieren
    • Startvorgang gewisser Dienste überspringen
    • Prepare offline installation
    • Customizing OTOBO Docker Compose
    • Docker Image individualisieren
    • Lokale Images erstellen
    • Automatische Installation
    • Einige nützliche Befehle
  • Ressourcen
• Migration from OTRS 6 or OTRS 7 / ((OTRS)) Community Edition to OTOBO version 10.1
  • Übersicht über die unterstützen Migrationsmöglichkeiten
  • Migrationsvoraussetzungen
  • Schritt 1: Neues OTOBO-System installieren
  • Schritt 2: SecureMode in OTOBO deaktivieren
  • Schritt 3: OTOBO-Daemon stoppen
  • Optionaler Schritt: Für leichteren Zugriff /opt/otrs einhängen
  • Optionaler Schritt: Installieren von sshpass und rsync, wenn /opt/otrs über SSH kopiert werden soll
  • Schritt 4: OTRS / ((OTRS)) Community Edition Quellsystem vorbereiten
    • Alle relevanten Services und den OTRS Daemon stoppen
    • Löschen Sie die Caches und die Betriebsdaten
  • Optionaler Schritt für Docker: Erforderliche Daten im Container verfügbar machen
    • /opt/otrs in das Volume otobo_opt_otobo kopieren
  • Schritt 5: Migration durchführen!
  • Schritt 6: Nach der erfolgreichen Migration!
  • Bekannte Probleme bei der Migration
    • 1. Login after migration not possible
    • 2. Final page of the migration has a strange layout due to missing CSS files
    • 3. Migration stops due to MySQL errors
    • 4. Errors in Step 5 when migrating to PostgreSQL
    • 5. Problems with the Deployment the Merged System Configuration
  • Schritt 7: Manuelle Aufgaben und Anpassungen
    • 1. Password policy rules
    • 2. Under Docker: Manually migrate cron jobs
  • Spezielle Themen
    • Migration von Oracle zu Oracle
    • Optionaler Schritt: Gestreamlinte Migration der Datenbank (nur für Experten und Spezialszenarien)
• Updates
  • Schritt 1: Alle relevanten Dienste und den OTOBO Daemon stoppen
  • Schritt 2: Dateien und Datenbank sichern
    • Beispiel für eine Standardinstallation mit Ubuntu und MySQL
  • Schritt 3: Neues Release installieren
    • Alte Konfigurationsdateien wiederherstellen
    • Artikeldaten wiederherstellen
    • Bereits installierte Standardstatistiken wiederherstellen
    • Dateiberechtigungen anpassen
    • Apache-Konfigurationsdateien überprüfen
  • Schritt 4: Überprüfung auf neu benötigte perl-Module
  • Schritt 5: Aktualisieren bereits installierter Pakete und Konfiguration neukonfigurieren
  • Schritt 6: Nur für Minor- oder Major-Release-Upgrades (zum Beispiel für ein Upgrade von 10.0 auf 10.1)
  • Schritt 7: Dienste starten
• Aktualisieren einer Docker-basierte OTOBO-Installation
  • Docker Compose-Dateien aktualisieren
  • Docker Compose .env-Datei überprüfen
  • Docker Images abrufen
  • OTOBO aktualisieren
• Backup und Wiederherstellung
  • Backup
  • Wiederherstellen
  • Sonderfalll: OTOBO und Docker
• Backup und Wiederherstellung mit Docker
  • Sonderfalll: OTOBO und Docker
• Kerberos Single Sign On in der OTOBO Docker-Installation
  • Active Directory User erstellen
  • Active Directory Keytab-Datei erstellen
  • Create a new volume for your custom nginx configuration
  • Neue OTOBO .env*-Datei anlegen
  • OTOBO starten
  • In OTOBO angeben, dass die Kerberos-Authentifizierung verwendet werden soll
  • Den Browser so konfigurieren, dass er Kerberos SSO versteht
  • Fehlererkennung und Problembehebung
    • Kerberos Fehlerbehebung
• Kundenoberfläche an Corporate Identity anpassen
  • Farben im Kundenbereich anpassen
  • Logos und Bilder bearbeiten
    • Bilder und Text für den Kundenlogin anpassen
    • Anpassen der Kunden-Dashboard-Kacheln und Optionen
• Perlmodule installieren
  • Docker-basierte OTOBO Installationen
• Performance Tuning
  • Ticket-Indexmodul
  • Ticket-Suchindex
  • Dokumentensuche
    • Heap-Größe
    • Festplattennutzung
  • Artikelspeicher
  • Tickets archivieren
  • Caching
    • Redis Cache Server installieren
    • RAM-Disk-Caching
  • Cluster
• Dokumentationshistorie