Änderungen von Dokument Kopano Optimierungen

Zuletzt geändert von Jonas Mayer am 2022/05/23 12:53

Von Version 16.1
bearbeitet von Christian Germann
am 2022/05/04 13:01
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 28.1
bearbeitet von Jonas Mayer
am 2022/05/23 12:45
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.cge@sbede
1 +XWiki.jonasmayer@sbede
Inhalt
... ... @@ -1,9 +1,9 @@
1 -(% style="color:#000000" %)Es gibt mehrere Anpassungen die sich anbieten um den laufenden Betrieb von Kopano zu verbessern. Folgende Maßnahmen können optional genutzt werden:
1 +(% style="color:#000000" %)Es gibt mehrere Anpassungen, die sich anbieten, um den laufenden Betrieb von Kopano zu verbessern. Folgende Maßnahmen können optional genutzt werden:
2 2  
3 -{{toc start="5"/}}
3 +{{toc start="4"/}}
4 4  
5 5  
6 -=== **1. Performance-Optimierung** ===
6 +==== **1. Performance-Optimierung** ====
7 7  
8 8  
9 9  ===== (% style="color:#000000" %)**__1.1 Kopano Leistung verbessern__**(%%) =====
... ... @@ -13,7 +13,7 @@
13 13  (% style="color:#000000" %)Um die Einstellungen Puppet-gerecht zu definieren, hilft nachfolgende Auflistung von YAML-Einstellungen. Bei der Auswahl der Werte muss man die **Hardware-Ressourcen** des Servers berücksichtigen, im Beispiel wird von einem leistungsstarken Server mit **32GB** **RAM** und **2 CPU-Sockets** und insgesamt **32 Kernen** ausgegangen.
14 14  
15 15  
16 -(% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
16 +(% style="color:#000000" %)Bearbeiten Sie die Datei kopano-g1.yaml im puppeteer Container:
17 17  
18 18  {{code language="bash"}}
19 19  root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
... ... @@ -24,12 +24,6 @@
24 24  **kopano-g1.yaml für Kopano <50 Users:**
25 25  
26 26  {{code language="yaml"}}
27 -nginx::keepalive_timeout: 3600
28 -nginx::keepalive_requests: 500
29 -
30 -apache::keepalive: 'On'
31 -apache::keepalive_timeout: '45'
32 -apache::max_keepalive_requests: '500'
33 33  apache::mod::prefork::maxclients: '384'
34 34  apache::mod::prefork::serverlimit: '384'
35 35  
... ... @@ -47,12 +47,6 @@
47 47   **kopano-g1.yaml für Kopano >=50 Users**
48 48  
49 49  {{code language="yaml"}}
50 -nginx::keepalive_timeout: 3600
51 -nginx::keepalive_requests: 500
52 -
53 -apache::keepalive: 'On'
54 -apache::keepalive_timeout: '45'
55 -apache::max_keepalive_requests: '500'
56 56  apache::mod::prefork::maxclients: '500'
57 57  apache::mod::prefork::serverlimit: '500'
58 58  
... ... @@ -70,12 +70,6 @@
70 70  **kopano-g1.yaml für Kopano >=200 Users**
71 71  
72 72  {{code language="yaml"}}
73 -nginx::keepalive_timeout: 3600
74 -nginx::keepalive_requests: 500
75 -
76 -apache::keepalive: 'On'
77 -apache::keepalive_timeout: '45'
78 -apache::max_keepalive_requests: '500'
79 79  apache::mod::prefork::maxclients: '500'
80 80  apache::mod::prefork::serverlimit: '500'
81 81  
... ... @@ -90,7 +90,7 @@
90 90   softdelete_lifetime: '0'
91 91  {{/code}}
92 92  
93 -(% id="cke_bm_884S" style="color:#000000; display:none" %) (% style="color:#000000" %)Zusätzlich muss im Kopano-Container ein Cron-Job eingerichtet werden, sofern man im Abschnitt **ld_kopano::server** die Parameter **sync_gab_realtime** / **softdelete_lifetime** im deaktivierten Zustand eingetragen hat:
75 +(% id="cke_bm_884S" style="color:#000000; display:none" %) (% style="color:#000000" %)Zusätzlich muss im Kopano-Container ein neuer CronJob eingerichtet werden, sofern man im Abschnitt **ld_kopano::server** die Parameter **sync_gab_realtime** / **softdelete_lifetime** im deaktivierten Zustand eingetragen hat:
94 94  
95 95  {{code language="bash"}}
96 96  root@kopano-g1:~ # /etc/cron.d/kopano-optimization
... ... @@ -185,7 +185,7 @@
185 185   innodb_write_io_threads: '4'
186 186  {{/code}}
187 187  
188 -Passen Sie die {{code}}mariadb103.yaml{{/code}} noch folgendermaßen an für Große Umgebungen mit vielen Postfächern.
170 +Passen Sie die {{code}}mariadb103.yaml{{/code}} noch folgendermaßen an für große Umgebungen mit vielen Postfächern.
189 189  
190 190  **mariadb103.yaml für Kopano >= 50 Users:**
191 191  
... ... @@ -198,41 +198,22 @@
198 198  Quelle: [[https:~~/~~/kb.kopano.io/pages/viewpage.action?pageId=2654253>>https://kb.kopano.io/pages/viewpage.action?pageId=2654253]]
199 199  
200 200  
201 -===== (% style="color:#000000" %)**__1.4 Anbindung/Akkulaufzeit von Endgeräten verbessern__**(%%) =====
183 +==== (% style="color:#000000" %)**2. Allgemeine Optimierungen der Einstellungen**(%%) ====
202 202  
203 -(% style="color:#000000" %)Bei Verwendung des ActiveSync-Protokolls bzw. Kopano Z-Push zur Anbindung von Endgeräten (Smartphones, Tablets, MS Outlook 2013/2016/2019 Clients) empfiehlt es sich, auf die HTTP-KeepAlive Einstellungen für die Webserver-Dienste in der Verbindungskette (Rev-Proxy → Kopano-Server) Einfluss zu nehmen.
204 204  
205 -(% style="color:#000000" %)Der KeepAlive-Wert wird bewusst hoch gewählt, damit Verbindungen zwischen Client und Kopano-Server nger offen gehalten werden können. Dadurch schont man die Batterie und Laufzeit von mobilen Geräten, da es sich u.a. auf den Standby-Betrieb von Smartphones auswirkt (der nicht permanent unterbrochen wird zum Starten einer neuen Verbindung).
186 +===== (% style="color:#000000" %)**__2.1 Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern durch Versenden per Relayhost__**(%%) =====
206 206  
188 +(% style="color:#000000" %)Es ist möglich, die Zustellbarkeit der Unzustellbarkeits-Nachrichten für den Absender zu verbessern. Dafür ist es notwendig den SMTP-Server des gewählten Mailproviders als Smarthost einzutragen.
207 207  
208 -(% style="color:#000000" %)Zusätzlich müssen Sie die Datei rev-proxy.yaml erstellen/bearbeiten:
209 209  
210 -{{code language="bash"}}
211 -root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/rev-proxy.yaml
212 -{{/code}}
191 +(% style="color:#000000" %)Bearbeiten Sie dazu die Datei {{box}}kopano-g1.yaml{{/box}} im puppeteer Container:
213 213  
214 -(% style="color:#000000" %)Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
215 -
216 216  {{code language="bash"}}
217 -nginx::keepalive_timeout: 3600
218 -nginx::keepalive_requests: 500
219 -{{/code}}
220 -
221 -
222 -
223 -(% class="wikigeneratedid" %)
224 -===== (% style="color:#000000" %)**__Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern durch Versenden per Relayhost__**(%%) =====
225 -
226 -(% style="color:#000000" %)Es ist möglich die Zustellbarkeit der Unzustellbarkeits-Nachrichten für den Absender zu verbessern. Dafür ist es notwendig den SMTP-Server des gewählten Mailproviders als Smarthost einzutragen.
227 -
228 -
229 -(% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
230 -
231 -{{code language="bash"}}
232 232  root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
233 233  {{/code}}
234 234  
235 -(% style="color:#000000" %)Die Zeile "ld_kopano::postfix::hashes:" beschreibt das Handling für den Null-Sender. Fügen Sie nun die Zeile "<> smtp.meineschule.de" ein (Ergänzen Sie die smtp Adresse durch die von ihnen genutzte).
197 +(% style="color:#000000" %)Im Abschnitt **ld_kopano::postfix::hashes:** kann eine zusätzliche Zeile für das Handling des Null-Senders hinzugefügt werden, den Postfix für Bounce-Nachrichten verwendet.
198 +Fügen Sie dort die Zeile "<> smtp.meineschule.de" zum Mapping hinzu und ersetzen Sie die SMTP-Adresse auf der rechten Seite durch den von Ihnen genutzten Smarthost.
236 236  
237 237  {{code language="bash"}}
238 238  ld_kopano::postfix::hashes:
... ... @@ -244,72 +244,64 @@
244 244  {{/code}}
245 245  
246 246  
247 -===== (% style="color:#000000" %)__**Public Folder erstellen**__(%%) =====
210 +(% style="color:#000000" %)Darüber hinaus ist es empfehlenswert, im Vorhinein durch den Kopano-Dienst **kopano-spooler** die Annahme von E-Mails zu verweigern, die von fremden (d.h. nicht intern definierten) **__Absender__domänen** stammen.
211 +Dazu muss folgender Parameter abweichend zur Standardeinstellung in derselben Konfigurationsdatei {{box}}kopano-g1.yaml{{/box}} definiert werden:
248 248  
249 -(% style="color:#000000" %)Es kann sich anbieten einen Public Folder als gemeinsamen Ordner für alle Benutzer zu erstellen. Hierfür müssen Sie folgenden Befehl eingeben:
250 -
251 -{{code language="bash"}}
252 -root@kopano-g1:~ # kopano-admin -s
213 +{{code language="yaml"}}
214 +# Disable mail redirects from foreign domains (sender) in Kopano
215 +ld_kopano::spooler:
216 + settings:
217 + allow_redirect_spoofing: 'no'
253 253  {{/code}}
254 254  
220 +(% style="font-size: 12px; color: rgb(0, 0, 0)" %)**Hinweis:** Weiterführende Informationen zur Einstellung können unter [[diesem Link>>http://manpages.ubuntu.com/manpages/impish/man5/kopano-spooler.cfg.5.html||target="_blank"]] nachgelesen werden.
255 255  
256 -===== (% style="color:#000000" %)__**Cronjob für Wartungsaufgaben**__(%%) =====
257 257  
258 -(% style="color:#000000" %)Durch das Anlegen eines zusätzlichen Cronjobs, lassen sich Wartungsaufgaben automatisch zu bestimmten Zeiten durchführen. Folgenden Cronjob können Sie bei Bedarf erstellen:
223 +===== (% style="color:#000000" %)__**2.2 Regelmäßige Synchronisation der Benutzer in das globale Adressbuch**__(%%) =====
259 259  
225 +(% style="color:#000000" %)Durch einen Cronjob ist es möglich Benutzer in das Globale Adressbuch einzupflegen. Hierbei handelt es sich um eine Erweiterung für die Kopano Outlook Extension, damit Benutzer mit Kopano-Postfach automatisch im Adressbuch anwählbar sind.
226 +
260 260  {{code language="bash"}}
261 -# /etc/cron.d/kopano-optimization
262 -*/30 * * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --sync 2>&1 >/dev/null
263 -0 4 * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --purge-softdelete 30 2>&1 >/dev/null
228 +root@kopano-g1:~ # chmod +x /etc/cron.daily/gabsync
264 264  {{/code}}
265 265  
231 +(% style="color:#000000" %)__**Hinweis:**__ Dies stellt eine Erweiterung zum regulären ActiveSync-Protokoll durch Z-Push dar. Die Funktionsweise basiert auf einem synchronisierten Kontaktordner namens „Z-Push-KOE-GAB“ als Unterordner im Public Store / Öffentlichen Ordner.
266 266  
267 -===== (% style="color:#000000" %)**__Netzlaufwerke auf der Kopano-Weboberfläche anzeigen__**(%%) =====
268 268  
269 -(% style="color:#000000" %)Empfehlenswert ist das Einbinden der Netzlaufwerke H: P: T: des logoDIDACT-Servers auf der Kopano Weboberfläche. Gehen Sie wie folgt vor um den Nutzern dies zu ermöglichen:
234 +===== (% style="color:#000000" %)**__2.3 Anbindung/Akkulaufzeit von Endgeräten verbessern durch Konfiguration von HTTP KeepAlive__**(%%) =====
270 270  
236 +(% style="color:#000000" %)Bei Verwendung des ActiveSync-Protokolls bzw. Kopano Z-Push zur Anbindung von Endgeräten (Smartphones, Tablets, MS Outlook 2013/2016/2019 Clients) empfiehlt es sich, auf die HTTP-KeepAlive Einstellungen für die Webserver-Dienste in der Verbindungskette (Rev-Proxy → Kopano-Server) Einfluss zu nehmen.
271 271  
272 -(% style="color:#000000" %)hren Sie den Sync über den kopano-admin durch:
238 +(% style="color:#000000" %)Der KeepAlive-Wert wird bewusst hoch gewählt, damit Verbindungen zwischen Client und Kopano-Server länger offen gehalten werden können. Dadurch schont man die Batterie und Laufzeit von mobilen Geräten, da es sich u.a. auf den Standby-Betrieb von Smartphones auswirkt (der nicht permanent unterbrochen wird zum Starten einer neuen Verbindung).
273 273  
274 -{{code language="bash"}}
275 -root@kopano-g1:~ # kopano-admin --sync
276 -{{/code}}
277 277  
278 -(% style="color:#000000" %)Laden Sie folgendes Skript herunter:
241 +(% style="color:#000000" %)Bearbeiten Sie die Datei kopano-g1.yaml im puppeteer Container:
279 279  
280 280  {{code language="bash"}}
281 -root@kopano-g1:~ # wget https://files.sbe.de/kopano/install-inject-shares.sh -O /tmp/install-inject-shares.sh
244 +root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
282 282  {{/code}}
283 283  
284 -(% style="color:#000000" %)Führen Sie das Skript aus:
247 +(% style="color:#000000" %)Erweitern Sie die Datei um die folgenden Einstellungen:
285 285  
286 -{{code language="bash"}}
287 -root@kopano-g1:~ # bash /tmp/install-inject-shares.sh
288 -{{/code}}
249 +{{code language="yaml"}}
250 +nginx::keepalive_timeout: 3600
251 +nginx::keepalive_requests: 500
289 289  
290 -(% style="color:#000000" %)Das Installationsskript legt einen CronJob an, der zyklisch einmal pro Tag die Netzlaufwerke für alle Kopano-Benutzer registriert. Dieser Vorgang kann unmittelbar nach der Installation durch die Eingabe von folgendem Befehl direkt angestoßen werden:
291 -
292 -{{code language="bash"}}
293 -root@kopano-g1:~ # inject-shares.sh
253 +apache::keepalive: 'On'
254 +apache::keepalive_timeout: '45'
255 +apache::max_keepalive_requests: '500'
294 294  {{/code}}
295 295  
296 -(% style="color:#000000" %)**__Hinweis:__** Falls beim Aufrufen des Skripts Mapi Fehler auftreten, bitte folgende Pakete installieren:(%%)
297 -
298 298  
259 +(% style="color:#000000" %)Zusätzlich müssen Sie die Datei rev-proxy.yaml erstellen/bearbeiten und dort ebenfalls HTTP KeepAlive Einstellungen setzen:
260 +
299 299  {{code language="bash"}}
300 -python-mapi
301 -python-kopano
302 -python3-kopano-utils
303 -kopano-python-utils
262 +root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/rev-proxy.yaml
304 304  {{/code}}
305 305  
265 +(% style="color:#000000" %)Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
306 306  
307 -===== (% style="color:#000000" %)__**Synchronisation der Benutzer in das globale Adressbuch**__(%%) =====
308 -
309 -(% style="color:#000000" %)Durch einen Cronjob ist es möglich Benutzer in das Globale Adressbuch einzupflegen. Hierbei handelt es sich um eine Erweiterung für die Kopano Outlook Extension, damit Benutzer mit Kopano-Postfach automatisch im Adressbuch anwählbar sind.
310 -
311 311  {{code language="bash"}}
312 -root@kopano-g1:~ # chmod +x /etc/cron.daily/gabsync
268 +nginx::keepalive_timeout: 3600
269 +nginx::keepalive_requests: 500
313 313  {{/code}}
314 -
315 -(% style="color:#000000" %)__**Hinweis:**__ Dies stellt eine Erweiterung zum regulären ActiveSync-Protokoll durch Z-Push dar. Die Funktionsweise basiert auf einem synchronisierten Kontaktordner namens „Z-Push-KOE-GAB“ als Unterordner im Public Store / Öffentlichen Ordner.