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

Maintainer

• Applikations-Admin: Thomas Käfer
• Moderatoren: Erich N. Pekarek, Christoph Lösch, Christian Pock
• Server-Admin: Christoph Lösch

Mail-Adressen + zugeordnete Kategorien

• forum-discuss at funkfeuer punkt at -> https://forum.funkfeuer.at/c/discuss-community
• forum-fragen at funkfeuer punkt at -> https://forum.funkfeuer.at/c/fragen
• forum at funkfeuer punkt at -> https://forum.funkfeuer.at/c/uncategorized

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.

Backups

Die Backups werden derzeit noch per SMB (über das SIL-Peering direkt) offsite auf einen Server am Node „mh“ abgelegt, solange keine entsprechende Möglichkeit auf FunkFeuer Infrastruktur gegeben ist.

Wünschenswert wäre eine verlässliche Möglichkeit Backups sicher auf FunkFeuer Infrastruktur abzulegen.

Derzeit scheint es diese Möglichkeit noch nicht zu geben.

Mittels Veeam Agent for Linux FREE wird die gesamte virtuelle Maschine täglich offsite gesichert:

vchrizz@forum:~$ sudo veeam

Configure

• Job name: FunkfeuerForum
• Backup mode: Entire machine
• Destination: Shared Folder
• Network: SMB
  • Path: 86.59.13.171 / backup/Funkfeuer
  • Domain:
  • Username: siehe backbone-dokuwiki
  • Password: siehe backbone-dokuwiki
  • Restore Points: 14

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)

CLI

• per SSH (auf forum.funkfeuer.at Port 10) verbinden bzw. einloggen:
  • SSH-Zugriff mit sudo Rechte haben derzeit: Christoph Lösch, Erich N. Pekarek, Thomas Käfer

vchrizz@forum:~$ cd /var/discourse/
vchrizz@forum:/var/discourse$ ./launcher enter app
root@forum-app:/var/www/discourse#