Projekte/Forum

0xFF-Discourse
Starttermin	23 Feb. 18
Status	Aktiv
[[Description::https://forum.funkfeuer.at Ziel des 0xFF-Projekts, Discourse einzusetzen, ist die Verbesserung der Kommunikation durch ein zeitgemäßes Tool, das unterschiedliche Kommunikationsformen zusammenführt. Wir erhoffen uns daraus ein besseres Miteinander. Löst altes Forum ab. Technologie: Docker + Discourse VM-Host: Ford]]
Projekt

Einrichtung und Konfiguration

• Set up Discourse in the cloud in under 30 minutes (auf experimenteller Basis, privat gehostete VM)
  • Konfiguration anpassen: /var/discourse/containers/app.yml
• Move your Discourse Instance to a Different Server (von bisher experimentellem www.forum.wien.funkfeuer.at)
  • Cannot get email working on new install (spezielle SMTP Einstellungen notwendig für Smarthost mail.funkfeuer.at)
    • SMTP connection problem, docker installation (notwendige Anpassung vor Installation)
      • in app.yml bei mail settings hinzufügen: DISCOURSE_SMTP_AUTHENTICATION: login
      • app.yml: #DISCOURSE_SMTP_ENABLE_START_TLS: true # (optional, default true)
    • Mail Einstellungen - Versandmethode:
      • notification email: forum@funkfeuer.at
      • address: mail.funkfeuer.at
      • port: 587 (SSL Zertifikat muss validieren!)
      • user_name: siehe backbone-dokuwiki
      • password: siehe backbone-dokuwiki
  • docker-mailserver (POP3 Mailbox notwendig, forum@funkfeuer.at und forum-*@funkfeuer.at wird von mail.funkfeuer.at weitergeleitet auf forum.funkfeuer.at)
  • Setting up Let’s Encrypt with Multiple Domains (wegen Migration auf forum.funkfeuer.at)
  • Emojis Not Displaying / Old Avatar Styles (korrigiert imgsrc von alter URL auf aktuelle URL)
• Running other websites on the same machine as Discourse (für statische HTML Kopie des alten PunBB Forums auf oldforum.funkfeuer.at)

Plugins

• Install a Plugin
  • discourse-data-explorer
  • discourse-whos-online
  • discourse-ldap-auth
    • Allowance of variables in "bind_dn" and "password" field.
    • Manueller Patch: Can I bind against the current user ("docker restart app" nach Modifikation notwendig)
    • LDAP Einstellungen: (-> "Aktuell wird einmal täglich (um 22Uhr) die Datenbank synchronisiert.")
      • ldap hostname: ldap.funkfeuer.at
      • ldap port: 636 (SSL Zertifikat muss validieren!)
      • ldap method: ssl
      • ldap base: ou=Users,dc=funkfeuer,dc=at
      • ldap uid: uid
      • ldap bind dn: uid=%{username},ou=Users,dc=funkfeuer,dc=at
      • ldap password: %{password}
      • ldap filter: uid=%{username}

Themes

• Changing the “Like” icon NEW: Change the Like icon (as theme component)
• How do I install a Theme or Theme Component?
  • Slick - Gallery Component
  • Tiles - Gallery Component
  • Slick + Tiles - Gallery Components - both at the same time
• Changing Max Attachment Size

Wartung/Fehlersuche

Für den Fall, dass nach einem Upgrade ein Theme oder ein Plugin streikt (Seite ladet nicht fertig, Fehler in Browser-Console, ..)

• Discourse Safe-Mode (Direktlink zum Forum)
• Discourse Safe-Mode (Erklärung)

Gute Anlaufstelle um die gängisten Probleme und deren Lösung zu finden: https://meta.discourse.org/

Ein ./launcher rebuild app des Docker Containers (wie z.B. bei neu hinzugefügten Plugins notwendig), dauert in etwa 30 Minuten!

• App Admin-Benutzer: siehe backbone-dokuwiki
• App Admin-Passwort: siehe backbone-dokuwiki

Upgrades

Upgrades lassen sich hier einspielen: https://forum.funkfeuer.at/admin/upgrade (Zugriff nur mit Administrator-Rechten)

Bei jedem ./launcher rebuild app wird der Docker Container erneuert und die Discourse Instanz auf die letzte getestete Version aktualisiert.

Hier eine Schritt-für-Schritt Anleitung die ebenfalls im Forum beschrieben ist.

WebUI

• App-Administration: https://forum.funkfeuer.at/admin (Zugriff nur mit Administrator-Rechten)
• App-Logging: https://forum.funkfeuer.at/logs (Zugriff nur mit Administrator-Rechten)