Änderungen von Dokument Kopano für lokalen Betrieb einrichten

Zuletzt geändert von superadmin am 2025/07/18 16:45

Von 5.1 nach 6.1 Von 23.1 nach 24.1

Von Version 6.1

bearbeitet von Christian Germann
am 2022/05/20 14:10

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 23.1

bearbeitet von Jonas Mayer
am 2022/05/23 13:47

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Dokument-Autor

@@ -1,1 +1,1 @@
--xwiki:XWiki.cge@sbede
++xwiki:XWiki.jonasmayer@sbede

Inhalt

@@ -1,28 +1,43 @@
--(% style="color:#000000" %)__**Voraussetzung**:__ Funktionale Kopano Einrichtung und Anbindung an die MariaDB103
++{{toc start="5"/}}
--(% style="color:#000000" %)Um Kopano im lokalen Betrieb einzurichten, muss man Anpassungen an Konfigurationsdateien im Puppeteer vornehmen. Dadurch erhalten Benutzer dann [[username@schule.local>>mailto:username@schule.local]] als lokale Mailadresse und können untereinander Nachrichten verschicken.
--**__Wichtig:__** Im lokalen Betrieb können keine Nachrichten an externe Mailadressen versendet werden. Die Kommunikation ist strikt auf interne Adressen beschränkt.
++===== (% style="color:#000000" %)__Voraussetzung__(%%) =====
++Eine abgeschlossene [[Kopano-Grundinstallation>>doc:xwiki:Main.Kopano.Allgemein.Kopano Grundinstallation.WebHome]] mit Anbindung an die MariaDB103 als Datenbank muss gegeben sein.
--(% style="color:#000000" %)Um die Anpassungen vorzunehmen wechselt man in den (% style="color:#3498db" %)Puppeteer (% style="color:#000000" %)und dort in das Verzeichnis(% style="color:#3498db" %) /etc/logodidact/hiera/custom.d/
--(% class="box" %)
++----
++
++===== __Einleitung__ =====
++
++(% style="color:#000000" %)Um Kopano im lokalen Betrieb einzurichten, muss man Anpassungen an Konfigurationsdateien im Puppeteer vornehmen. Dadurch erhalten Benutzer dann [[username@schule.local>>mailto:username@schule.local]] als lokale Mailadresse und können untereinander Nachrichten verschicken.
++
++(% class="box successmessage" %)
  (((
--(% style="color:#000000" %)##cd /etc/logodidact/hiera/custom.d/##
++(% style="font-size:12px" %)**__Hinweis:__**(%%)
++(% style="font-size:12px" %)Im lokalen Betrieb können keine Nachrichten an externe Mailadressen versendet werden. Die Kommunikation ist strikt auf interne Adressen beschränkt.
  )))
--(% style="color:#000000" %)Hier lassen sich diverse .yaml Konfigurationsdateien finden. Für die Einrichtung sind die Nachfolgenden von Relevanz:
++(% style="color:#000000" %)Um die Anpassungen vorzunehmen, wechselt man in den (% style="color:#3498db" %)Puppeteer (% style="color:#000000" %)und dort in das Verzeichnis(% style="color:#3498db" %) /etc/logodidact/hiera/custom.d/
++
  (% class="box" %)
  (((
--(% style="color:#000000" %)##kopano-g1.yaml / rev-proxy.yaml / mariadb103.yaml / ldhost.yaml / samba4-ad.yaml##
++(% style="color:#000000" %)##cd /etc/logodidact/hiera/custom.d/##
  )))
++(% style="color:#000000" %)In diesem Verzeichnis liegen mehrere YAML-Konfigurationsdateien mit Bezug zu Kopano abgespeichert. Für die Einrichtung sind die nachfolgende Dateien von Relevanz:
--(% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)kopano-g1.yaml(% style="color:#000000" %):
-- I.d.R. trägt man in der kopano-g1.yaml Die Maildomain und Zugangsdaten für das Catchall Postfach ein. Da wir jedoch keine externe Maildomain verwenden, bleiben diese Felder auf den Default-Wert bestehen.
++* ##kopano-g1.yaml##
++* ##ldhost.yaml##
++* ##samba4-ad.yaml##
++----
++
++===== (% style="color:#000000" %)__Anpassungen in der __(% style="color:#3498db" %)__kopano-g1.yaml__(%%) =====
++
++(% style="color:#000000" %)Üblicherweise trägt man in der kopano-g1.yaml die gewünschte externe Maildomain sowie Zugangsdaten für das zugehörige Catchall-Postfach der Domain ein. Da wir jedoch keine externe Maildomain verwenden, bleiben diese Felder auf den Default-Wert bestehen.
++
  (% class="box" %)
  (((
  (% style="color:#000000" %)##ld_multidrop::ensure: absent
@@ -49,7 +49,7 @@
      value: 'yes'
    virtual_mailbox_domains:
      value: 'pcre:%{dir_etc}/virtual_mailbox_domains_internal.pcre'
--  # Vordefinierte Absender beim Versand auf Empfänger der lokalen Maildomänen einschränken##(%%)
++  # Einschränken von vordefinierte Absendern auf Empfänger der lokalen Maildomäne##(%%)
  (% style="color:#000000" %)##  smtpd_restriction_classes:
      value: 'local_only'
    local_only:
@@ -81,81 +81,27 @@
    '%{dir_etc}/restricted_senders.pcre':
      content: |
        %{header}
--      # Regular Expression Format: Liste an Absendern, die beim Versand eingeschränkt werden
++      # Regular Expression Format: Liste an Absendern, deren Versand eingeschränkt wird
        /@(.+?\.)?%{::domain}$/ local_only
    '%{dir_etc}/local_domains.pcre':
      content: |
        %{header}
--      # Regular Expression Format: Liste erlaubter Empfängerdomänen (für eingeschränkte Absender)
++      # Regular Expression Format: Liste erlaubter Empfängerdomänen für die eingeschränkten Absender
        /@(.+?\.)?%{::domain}$/ OK
  \\\\ld_kopano::postfix::verbose: false
  \\ld_kopano::ldap_type: openldap
--\\ld_kopano::db_server: mariadb103
--\\# Optimierte Z-Push Webserver-Einstellungen für ActiveSync Devices
--apache::keepalive: 'On'
--apache::keepalive_timeout: '45'
--apache::max_keepalive_requests: '500'
--apache::mod::prefork::maxclients: '384'
--apache::mod::prefork::serverlimit: '384'
--nginx::keepalive_timeout: 3600
--nginx::keepalive_requests: 500##
++\\ld_kopano::db_server: mariadb103##
  )))
--(% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)rev-proxy.yaml(% style="color:#000000" %):
++----
--(% class="box" %)
--(((
--(% style="color:#000000" %)### Kopano: KeepAlive Timeout erhöhen für Z-Push / ActiveSync Devices
--nginx::keepalive_timeout: 3600
--nginx::keepalive_requests: 500##
--)))
++===== (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)ldhost.yaml(%%) =====
++(% style="color:#000000" %)Hier wird die Maildomain festgelegt, die Benutzer im Attribut mail unter (% style="color:#3498db" %)/var/lds/user/username/mail(% style="color:#000000" %) im (% style="color:#3498db" %)logosrv (% style="color:#000000" %)erhalten.
--(% style="color:#000000" %)Anpassungen in der(%%) (% style="color:#3498db" %)mariadb103.yaml(%%):
--
  (% class="box" %)
  (((
--(% style="color:#000000" %)##mysql::server::override_options:
--  mysqldump:
--    max_allowed_packet: '1G'
--  mysqld:
--    innodb_file_per_table: '1'
--    bind-address: '0.0.0.0'
--    skip-name-resolve: true
--    innodb_large_prefix: '1'
--    max_allowed_packet: '256M'
--    max_connections: '151'
--    query_cache_limit: '2M'
--    query_cache_size: '64M'
--    thread_stack: '512K'
--    tmp_table_size: '64M'
--    max_heap_table_size: '64M'
--    sort_buffer_size: '2M'
--    join_buffer_size: '2M'
--    table_open_cache: '500'
--    innodb_autoextend_increment: '1000'
--    innodb_buffer_pool_size: '1G'
--    # The following setting is based on the existing ibdata1 file, check current size and insert it here (rounded to MB)
--    # - Hint: Initial value after first installation = 12M
--    innodb_data_file_path: 'ibdata1:76M:autoextend'
--    innodb_flush_log_at_trx_commit: '2'
--    innodb_flush_method: 'O_DSYNC'
--    innodb_lock_wait_timeout: '120'
--    innodb_log_buffer_size: '8M'
--    innodb_log_file_size: '1G'
--    innodb_log_files_in_group: '3'
--    innodb_read_io_threads: '4'
--    innodb_write_io_threads: '4'
--    wait_timeout: '28800'##
--)))
--
--
--(% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)ldhost.yaml(% style="color:#000000" %):
--Hier wird die Maildomain festgelegt, die Benutzer im Attribut mail unter (% style="color:#3498db" %)/var/lds/user/username/mail(% style="color:#000000" %) im (% style="color:#3498db" %)logosrv (% style="color:#000000" %)erhalten.
--
--(% class="box" %)
--(((
  (% style="color:#000000; font-family:~"Open Sans~",~"Helvetica Neue~",Helvetica,Arial,sans-serif" %)### Kopano: Definition einer Maildomain (abweichend zu schule.local), die Benutzer & Gruppen im LDAP-Feld 'mail' erhalten sollen##(%%)
  (% style="color:#000000" %)###ld_legacy::mail::filters:
  #   '(zarafaaccount=1)': 'example.com'
@@ -165,9 +165,12 @@
  )))
--(% style="color:#000000" %)Nun fehlen noch die Anpassungen in der (% style="color:#3498db" %)samba4-ad.yaml(% style="color:#000000" %):
--Hier wird dem admin die administrativen Rechte zugeteilt. Falls noch andere Benutzer mit administrativen Rechten innerhalb von Kopano vergeben werden sollen, können diese ergänzt werden.
++----
++===== (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)samba4-ad.yaml(%%) =====
++
++(% style="color:#000000" %)Hier kann dem admin die administrativen Rechte zugeteilt. Falls noch andere Benutzer mit administrativen Rechten innerhalb von Kopano ausgestattet werden sollen, können diese ergänzt werden.
++
  (% class="box" %)
  (((
  (% style="color:#000000" %)### Kopano: Definition von Benutzern, die administrative Rechte erhalten sollen
@@ -177,17 +177,45 @@
  )))
--(% style="color:#000000" %)Damit die Änderungen sauber übernommen werden, fehlt noch ein Git commit im (% style="color:#3498db" %)Puppeteer(% style="color:#000000" %).
--
--(% class="box" %)
++(% class="box infomessage" %)
  (((
--(% style="color:#000000" %)##git add *##
++__**Tipp:**__
++Um Benutzerkonten bei Verwendung des OpenLDAP-Verzeichnisdienst zu Kopano-Admins hochzustufen, muss anders vorgegangen werden.
++Wechseln Sie hierzu in den LXC-Container logosrv und aktivieren Sie die Admin-Funktion über folgendes Kommando für alle gewünschten Benutzer:
++
++
++{{box}}
++(% style="color:#16a085" %)### Das Schlüsselwort NAME durch den Benutzernamen austauschen, der zum Kopano-Admin werden soll (üblicherweise admin)##(%%)
++(% style="color:#000000" %)##echo 1 >/var/lds/ldap/ou=users/uid=NAME/zarafaadmin##
++{{/box}}
  )))
++
++----
++
++===== __Vorgenommene Änderungen ins Git einchecken__ =====
++
++(% style="color:#000000" %)Damit die Änderungen sauber übernommen werden, fehlt noch ein {{box}}git commit{{/box}} im (% style="color:#3498db" %)Puppeteer(% style="color:#000000" %).
++
  (% class="box" %)
  (((
--(% style="color:#000000" %)##git commit -am "Kopano für den lokalen Betrieb eingerichtet"##
++(% style="color:#000000" %)##cd /etc/logodidact/
++git add *
++git commit -am "Kopano für den lokalen Betrieb eingerichtet"##
  )))
--(% style="color:#000000" %)und ein (% style="color:#3498db" %)prun in den jeweiligen Containern(% style="color:#000000" %) (Alle Container, die durch die .yaml Konfigurationsdateien angesprochen werden)
++(% style="color:#000000" %)Führen Sie bitte abschließend noch einen {{box}}prun{{/box}}(%%) in den betreffenden LXC-Containern aus (% style="color:#000000" %)(d.h. in allen Container, die durch Anpassungen in den YAML-Dateien Änderungen erhalten).
++
++
++
++----
++
++
++(% class="box successmessage" %)
++(((
++Weitere Optimierungen können in folgendem Artikel nachgelesen werden.
++[[https:~~/~~/kb.logodidact.com/xwiki/bin/view/Main/Kopano/Allgemein/Optimierungen%20von%20Kopano/>>https://kb.logodidact.com/xwiki/bin/view/Main/Kopano/Allgemein/Optimierungen%20von%20Kopano/]]
++)))
++
++