Zum Inhalt springen

Änderungen von Dokument Kopano Optimierungen

Zuletzt geändert von Jonas Mayer am 2022/05/23 12:53
Von Version 20.1
bearbeitet von Christian Germann
am 2022/05/06 16:04
Änderungskommentar: Es gibt keinen Kommentar für diese Version
Auf Version 6.1
bearbeitet von Jonas Mayer
am 2022/05/02 13:00
Ä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,32 +1,49 @@
1 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="4"/}}
3 +{{toc start="5"/}}
4 4  
5 5  
6 -==== **1. Performance-Optimierung** ====
6 +===== (% style="color:#000000" %)**__Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern durch Versenden per Relayhost__**(%%) =====
7 7  
8 +(% 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.
8 8  
9 -===== (% style="color:#000000" %)**__1.1 Kopano Leistung verbessern__**(%%) =====
10 10  
11 -(% style="color:#000000" %)Kopano ist in der Standardinstallation lediglich für den Betrieb von 10 Benutzern ausgelegt. Das heißt, die Kopano-Serverdienste reservieren mit den Standardeinstellungen sehr wenig Systemressourcen (RAM) und die Plattform arbeitet als Konsequenz sehr langsam, wenn deutlich mehr Benutzer ein Postfach erhalten. Man sollte daher in den meisten Fällen die zugeteilten Systemressourcen (deutlich) erhöhen, um ein vernünftiges Nutzererlebnis zu erzielen.
11 +(% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
12 12  
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.
13 +{{code language="bash"}}
14 +root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
15 +{{/code}}
14 14  
15 15  
16 -(% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
18 +(% 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).
17 17  
18 18  {{code language="bash"}}
19 -root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
21 +ld_kopano::postfix::hashes:
22 +  '%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
23 +    content: |
24 +      %{header}
25 +      <> smtp.meineschule.de
26 +      @meineschule.de smtp.meineschule.de
20 20  {{/code}}
21 21  
22 -Passen Sie die kopano-g1.yaml je nach Größe der Schule an.
23 23  
24 -**kopano-g1.yaml für Kopano <50 Users:**
30 +===== (% style="color:#000000" %)**__Anbindung/Akkulaufzeit von Endgeräten verbessern__**(%%) =====
25 25  
26 -{{code language="yaml"}}
27 -nginx::keepalive_timeout: 3600
28 -nginx::keepalive_requests: 500
32 +(% 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.
29 29  
34 +(% 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).
35 +
36 +
37 +(% style="color:#000000" %)Zum erhöhen der TimeOuts öffnen Sie die kopano-g1.yaml:
38 +
39 +{{code language="bash"}}
40 +root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
41 +{{/code}}
42 +
43 +
44 +(% style="color:#000000" %)Fügen Sie folgende Zeilen am Ende der Datei ein:
45 +
46 +{{code language="bash"}}
30 30  apache::keepalive: 'On'
31 31  apache::keepalive_timeout: '45'
32 32  apache::max_keepalive_requests: '500'
... ... @@ -33,23 +33,43 @@
33 33  apache::mod::prefork::maxclients: '384'
34 34  apache::mod::prefork::serverlimit: '384'
35 35  
36 -ld_kopano::server:
37 - settings:
38 - cache_cell_size: '512M'
39 - cache_object_size: '16M'
40 - cache_indexedobject_size: '32M'
41 - enable_sql_procedures: 'yes'
42 - # The following 2 settings require a cronjob to run periodically instead (in case the value is disabled)
43 - sync_gab_realtime: 'no'
44 - softdelete_lifetime: '0'
53 +nginx::keepalive_timeout: 3600
54 +nginx::keepalive_requests: 500
45 45  {{/code}}
46 46  
47 - **kopano-g1.yaml für Kopano >=50 Users**
48 48  
49 -{{code language="yaml"}}
58 +(% style="color:#000000" %)Zusätzlich müssen Sie die Datei rev-proxy.yaml erstellen/bearbeiten:
59 +
60 +{{code language="bash"}}
61 +root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/rev-proxy.yaml
62 +{{/code}}
63 +
64 +
65 +(% style="color:#000000" %)Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
66 +
67 +{{code language="bash"}}
50 50  nginx::keepalive_timeout: 3600
51 51  nginx::keepalive_requests: 500
70 +{{/code}}
52 52  
72 +
73 +===== (% style="color:#000000" %)**__Kopano Leistung verbessern__**(%%) =====
74 +
75 +(% style="color:#000000" %)Kopano ist in der Standardinstallation lediglich für den Betrieb von 10 Benutzern ausgelegt. Das heißt, die Kopano-Serverdienste reservieren mit den Standardeinstellungen sehr wenig Systemressourcen (RAM) und die Plattform arbeitet als Konsequenz sehr langsam, wenn deutlich mehr Benutzer ein Postfach erhalten. Man sollte daher in den meisten Fällen die zugeteilten Systemressourcen (deutlich) erhöhen, um ein vernünftiges Nutzererlebnis zu erzielen.
76 +
77 +(% 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.
78 +
79 +
80 +(% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
81 +
82 +{{code language="bash"}}
83 +root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
84 +{{/code}}
85 +
86 +
87 +(% style="color:#000000" %)Folgende Parameter können ggf. helfen die Leistung zu verbessern:
88 +
89 +{{code language="yaml"}}
53 53  apache::keepalive: 'On'
54 54  apache::keepalive_timeout: '45'
55 55  apache::max_keepalive_requests: '500'
... ... @@ -56,8 +56,20 @@
56 56  apache::mod::prefork::maxclients: '500'
57 57  apache::mod::prefork::serverlimit: '500'
58 58  
96 +# kopano-g1.yaml für Kopano <50 Users
59 59  ld_kopano::server:
60 60   settings:
99 + cache_cell_size: '512M'
100 + cache_object_size: '16M'
101 + cache_indexedobject_size: '32M'
102 + enable_sql_procedures: 'yes'
103 + # The following 2 settings require a cronjob to run periodically instead (in case the value is disabled)
104 + sync_gab_realtime: 'no'
105 + softdelete_lifetime: '0'
106 +
107 +# kopano-g1.yaml für Kopano >=50 Users
108 +ld_kopano::server:
109 + settings:
61 61   cache_cell_size: '6144M'
62 62   cache_object_size: '32M'
63 63   cache_indexedobject_size: '64M'
... ... @@ -65,20 +65,8 @@
65 65   # The following 2 settings require a cronjob to run periodically instead (in case the value is disabled)
66 66   sync_gab_realtime: 'no'
67 67   softdelete_lifetime: '0'
68 -{{/code}}
69 69  
70 -**kopano-g1.yaml für Kopano >=200 Users**
71 -
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 -apache::mod::prefork::maxclients: '500'
80 -apache::mod::prefork::serverlimit: '500'
81 -
118 +# kopano-g1.yaml für Kopano >=200 Users
82 82  ld_kopano::server:
83 83   settings:
84 84   cache_cell_size: '12288M'
... ... @@ -90,8 +90,9 @@
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:
94 94  
131 +(% 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:
132 +
95 95  {{code language="bash"}}
96 96  root@kopano-g1:~ # /etc/cron.d/kopano-optimization
97 97  {{/code}}
... ... @@ -103,8 +103,6 @@
103 103  {{/code}}
104 104  
105 105  
106 -===== __**1.2 mysql56(% style="color:#000000" %) Leistung verbessern(%%)**__ =====
107 -
108 108  (% style="color:#000000" %)Folgende Einstellung können für die mysql56.yaml gesetzt werden:
109 109  
110 110  {{code language="bash"}}
... ... @@ -121,7 +121,7 @@
121 121   skip-name-resolve: true
122 122   innodb_large_prefix: true
123 123   innodb_file_format: 'Barracuda'
124 - max_allowed_packet: '32M'
160 + max_allowed_packet: '256M'
125 125   max_connections: '150'
126 126   query_cache_limit: '2M'
127 127   query_cache_size: '64M'
... ... @@ -143,11 +143,8 @@
143 143   innodb_write_io_threads: '4'
144 144  {{/code}}
145 145  
182 +(% id="cke_bm_172S" style="color:#000000; display:none" %) (% style="color:#000000" %)Folgende Einstellung können für die mariadb103.yaml gesetzt werden:
146 146  
147 -===== __**1.3 mariadb103 (% style="color:#000000" %)Leistung verbessern(%%)**__ =====
148 -
149 -(% style="color:#000000" %)Folgende Einstellung können für die mariadb103.yaml gesetzt werden:
150 -
151 151  {{code language="bash"}}
152 152  root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/mariadb103.yaml
153 153  {{/code}}
... ... @@ -161,7 +161,7 @@
161 161   bind-address: '0.0.0.0'
162 162   skip-name-resolve: true
163 163   innodb_large_prefix: '1'
164 - max_allowed_packet: '32M'
197 + max_allowed_packet: '256M'
165 165   max_connections: '151'
166 166   query_cache_limit: '2M'
167 167   query_cache_size: '64M'
... ... @@ -185,83 +185,91 @@
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.
189 189  
222 +**mariadb103.yaml für Kopano <50 Users:**
223 +
224 +{{code language="yaml"}}
225 +max_allowed_packet: '256M'
226 +sort_buffer_size: '2M'
227 +innodb_buffer_pool_size: '1G'
228 +
229 +{{/code}}
230 +
231 +
190 190  **mariadb103.yaml für Kopano >= 50 Users:**
191 191  
192 192  {{code language="yaml"}}
235 +max_allowed_packet: '1G'
193 193  sort_buffer_size: '4M'
194 194  innodb_buffer_pool_size: '2G'
195 195  {{/code}}
196 196  
197 -(% class="wikigeneratedid" %)
198 -Quelle: [[https:~~/~~/kb.kopano.io/pages/viewpage.action?pageId=2654253>>https://kb.kopano.io/pages/viewpage.action?pageId=2654253]]
199 199  
241 +===== (% style="color:#000000" %)__**Public Folder erstellen**__(%%) =====
200 200  
201 -===== (% style="color:#000000" %)**__1.4 Anbindung/Akkulaufzeit von Endgeräten verbessern durch Konfiguration von HTTP KeepAlive__**(%%) =====
243 +(% 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:
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.
245 +{{code language="bash"}}
246 +root@kopano-g1:~ # kopano-admin -s
247 +{{/code}}
204 204  
205 -(% 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).
206 206  
250 +===== (% style="color:#000000" %)__**Cronjob für Wartungsaufgaben**__(%%) =====
207 207  
208 -[EINFÜGEN..... keeepAlive Settings in kopano-g1.yaml.... aus dem weiter oben dokumentierten Abschnitt dann entfernen]
252 +(% 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:
209 209  
210 -
211 -(% style="color:#000000" %)Zusätzlich müssen Sie die Datei rev-proxy.yaml erstellen/bearbeiten:
212 -
213 213  {{code language="bash"}}
214 -root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/rev-proxy.yaml
255 +# /etc/cron.d/kopano-optimization
256 +*/30 * * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --sync 2>&1 >/dev/null
257 +0 4 * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --purge-softdelete 30 2>&1 >/dev/null
215 215  {{/code}}
216 216  
217 -(% style="color:#000000" %)Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
218 218  
219 -{{code language="bash"}}
220 -nginx::keepalive_timeout: 3600
221 -nginx::keepalive_requests: 500
222 -{{/code}}
261 +===== (% style="color:#000000" %)**__Netzlaufwerke auf der Kopano-Weboberfläche anzeigen__**(%%) =====
223 223  
263 +(% 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:
224 224  
225 -==== (% style="color:#000000" %)**2. Allgemeine Optimierungen der Einstellungen**(%%) ====
226 226  
266 +(% style="color:#000000" %)Führen Sie den Sync über den kopano-admin durch:
227 227  
228 -===== (% style="color:#000000" %)**__2.1 Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern durch Versenden per Relayhost__**(%%) =====
268 +{{code language="bash"}}
269 +root@kopano-g1:~ # kopano-admin --sync
270 +{{/code}}
229 229  
230 -(% 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.
231 231  
273 +(% style="color:#000000" %)Laden Sie folgendes Skript herunter:
232 232  
233 -(% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
234 -
235 235  {{code language="bash"}}
236 -root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
276 +root@kopano-g1:~ # wget https://files.sbe.de/kopano/install-inject-shares.sh -O /tmp/install-inject-shares.sh
237 237  {{/code}}
238 238  
239 -(% 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).
240 240  
280 +(% style="color:#000000" %)Führen Sie das Skript aus:
281 +
241 241  {{code language="bash"}}
242 -ld_kopano::postfix::hashes:
243 -  '%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
244 -    content: |
245 -      %{header}
246 -      <> smtp.meineschule.de
247 -      @meineschule.de smtp.meineschule.de
283 +root@kopano-g1:~ # bash /tmp/install-inject-shares.sh
248 248  {{/code}}
249 249  
250 250  
251 -===== (% style="color:#000000" %)__**2.2 Fortsetzung...Zugehöriger CronJob für Wartungsaufgaben**__(%%) =====
287 +(% 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:
252 252  
253 -(% 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:
254 -
255 255  {{code language="bash"}}
256 -# /etc/cron.d/kopano-optimization
257 -*/30 * * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --sync 2>&1 >/dev/null
258 -0 4 * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --purge-softdelete 30 2>&1 >/dev/null
290 +root@kopano-g1:~ # inject-shares.sh
259 259  {{/code}}
260 260  
293 +(% style="color:#000000" %)**__Hinweis:__** Falls beim aufrufen des Skripts Mapi Fehler auftreten, bitte folgende Pakete installieren:(%%)
261 261  
262 262  
263 -===== (% style="color:#000000" %)__**2.3 Regelmäßige Synchronisation der Benutzer in das globale Adressbuch**__(%%) =====
296 +{{code language="bash"}}
297 +python-mapi
298 +python-kopano
299 +python3-kopano-utils
300 +kopano-python-utils
301 +{{/code}}
264 264  
303 +
304 +===== (% style="color:#000000" %)__**Synchronisation der Benutzer in das globale Adressbuch**__(%%) =====
305 +
265 265  (% 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.
266 266  
267 267  {{code language="bash"}}