Änderungen von Dokument Kopano für lokalen Betrieb einrichten

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

Von 23.1 nach 22.1

Von Version 22.1

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

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

Auf Version 1.1

bearbeitet von Michael Ecer
am 2022/05/03 09:26

Ä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.jonasmayer@sbede
++xwiki:XWiki.michaelecer@sbede

Inhalt

@@ -1,46 +1,32 @@
--{{toc start="5"/}}
++(% style="color:#000000" %)__**Voraussetzung**:__ Funktionale Kopano Einrichtung und Anbindung an die MariaDB103
--===== (% style="color:#000000" %)__Voraussetzung__(%%) =====
++(% 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.
--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/
------
--
--===== __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" %)
++(% class="box" %)
  (((
--(% 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" %)##cd /etc/logodidact/hiera/custom.d/##
  )))
++(% 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" %)##cd /etc/logodidact/hiera/custom.d/##
++(% style="color:#000000" %)##kopano-g1.yaml / rev-proxy.yaml / mariadb103.yaml / ldhost.yaml / samba4-ad.yaml##
  )))
--(% 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:
--* ##kopano-g1.yaml##
--* ##ldhost.yaml##
--* ##samba4-ad.yaml##
++(% 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.
------
--
--===== (% 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
++(% style="color:#000000" %)##~-~--
++ld_multidrop::ensure: absent
  \\ld_kopano::amavisd_new::configs:
    '@local_domains_maps': "( new_RE( qr'[@.](.*~\~\.?%{::domain})$'i ) )"
  \\ld_kopano::postfix::configs:
@@ -49,7 +49,7 @@
    sender_dependent_relayhost_maps:
      value: 'pcre:%{dir_etc}/sender_dependent_relayhost_maps_internal.pcre'
    smtp_sender_dependent_authentication:
--    value: 'yes'
++     value: 'yes'
    smtp_sasl_auth_enable:
      value: 'yes'
    smtp_sasl_password_maps:
@@ -64,26 +64,15 @@
      value: 'yes'
    virtual_mailbox_domains:
      value: 'pcre:%{dir_etc}/virtual_mailbox_domains_internal.pcre'
--  # Einschränken von vordefinierte Absendern auf Empfänger der lokalen Maildomäne##(%%)
--(% style="color:#000000" %)##  smtpd_restriction_classes:
--    value: 'local_only'
--  local_only:
--    value: 'check_recipient_access pcre:%{dir_etc}/local_domains.pcre, reject'
--  smtpd_recipient_restrictions:
--    value: 'check_sender_access pcre:%{dir_etc}/restricted_senders.pcre, permit_mynetworks,permit_sasl_authenticated, reject_invalid_hostname, reject_non_fqdn_hostname, reject_non_fqdn_recipient, reject_non_fqdn_sender, reject_unknown_recipient_domain, reject_unknown_sender_domain, reject_unauth_destination, reject_unauth_pipelining, reject'
--\\\\ld_kopano::postfix::hashes:
++\\ld_kopano::postfix::hashes:
    '%{dir_etc}/smtp_generic_maps.hash':
      content: |
        %{header}
--      # Umschreibung der Absender-Domain bei externem Mailversand
--      # (Dummy-Eintrag, durch Empfängerfilterung nicht genutzt)
        @%{::fqdn} @example.com
    '%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
      content: |
        %{header}
--      # Bounce-Nachrichten mit Null-Sender via Relayhost versenden
        <> smtp.example.com
--      # Mails an externe Empfänger via Relayhost versenden
        @example.com smtp.example.com
    '%{dir_etc}/smtp_sasl_password_maps.hash':
      content: |
@@ -93,48 +93,93 @@
      content: |
        %{header}
        example.com ACCEPT
--  '%{dir_etc}/restricted_senders.pcre':
--    content: |
--      %{header}
--      # 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 die eingeschränkten Absender
--      /@(.+?\.)?%{::domain}$/ OK
--\\\\ld_kopano::postfix::verbose: false
++\\ld_kopano::postfix::verbose: false
  \\ld_kopano::ldap_type: openldap
--\\ld_kopano::db_server: mariadb103##
++\\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##
  )))
------
++(% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)rev-proxy.yaml(% style="color:#000000" %):
--===== (% style="color:#000000" %)Anpassungen in der (% style="color:#3498db" %)ldhost.yaml(%%) =====
++(% 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" %)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; 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:
++(% 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" %)##~-~--##(%%)##
++(% 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'
  # Kopano: Definition von Gruppen, die eine Mailadresse erhalten sollen und dadurch anschreibbar werden
  ld_legacy::mail::zarafa_groups:
--  - elehrer##
++  - elehrer(%%)##
  )))
------
++(% 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
++(% style="color:#000000" %)##~-~--
++# Kopano: Definition von Benutzern, die administrative Rechte erhalten sollen
  # (Einstellung wird nicht benutzt, sofern Kopano an das OpenLDAP angebunden ist, was dem Standard entspricht)
  ld_samba4::ad::kopano::admins:
    - 'admin'##
@@ -141,45 +141,17 @@
  )))
--(% class="box infomessage" %)
--(((
--__**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:
--
++(% style="color:#000000" %)Damit die Änderungen sauber übernommen werden, fehlt noch ein Git commit im (% style="color:#3498db" %)Puppeteer(% style="color:#000000" %).
--{{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" %)##cd /etc/logodidact/
--git add *
--git commit -am "Kopano für den lokalen Betrieb eingerichtet"##
++(% style="color:#000000" %)##git add .##
  )))
--
--(% 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" %)
++(% class="box" %)
  (((
--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/]]
++(% style="color:#000000" %)##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)