Zum Inhalt springen

Ä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 5.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
... ... @@ -3,30 +3,47 @@
3 3  {{toc start="5"/}}
4 4  
5 5  
6 -=== **1. Performance-Optimierung** ===
6 +===== (% style="color:#000000" %)**__Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern__**(%%) =====
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,65 +185,26 @@
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  
190 -**mariadb103.yaml für Kopano >= 50 Users:**
222 +**mariadb103.yaml für Kopano <50 Users:**
191 191  
192 192  {{code language="yaml"}}
193 -sort_buffer_size: '4M'
194 -innodb_buffer_pool_size: '2G'
195 -{{/code}}
225 +max_allowed_packet: '256M'
226 +sort_buffer_size: '2M'
227 +innodb_buffer_pool_size: '1G'
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 -
200 -
201 -===== (% style="color:#000000" %)**__1.4 Anbindung/Akkulaufzeit von Endgeräten verbessern__**(%%) =====
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 -
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 -
207 -
208 -(% style="color:#000000" %)Zusätzlich müssen Sie die Datei rev-proxy.yaml erstellen/bearbeiten:
209 -
210 -{{code language="bash"}}
211 -root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/rev-proxy.yaml
212 212  {{/code}}
213 213  
214 -(% style="color:#000000" %)Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
215 215  
216 -{{code language="bash"}}
217 -nginx::keepalive_timeout: 3600
218 -nginx::keepalive_requests: 500
219 -{{/code}}
232 +**mariadb103.yaml für Kopano >= 50 Users:**
220 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 -root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
234 +{{code language="yaml"}}
235 +max_allowed_packet: '1G'
236 +sort_buffer_size: '4M'
237 +innodb_buffer_pool_size: '2G'
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).
236 236  
237 -{{code language="bash"}}
238 -ld_kopano::postfix::hashes:
239 -  '%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
240 -    content: |
241 -      %{header}
242 -      <> smtp.meineschule.de
243 -      @meineschule.de smtp.meineschule.de
244 -{{/code}}
245 -
246 -
247 247  ===== (% style="color:#000000" %)__**Public Folder erstellen**__(%%) =====
248 248  
249 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:
... ... @@ -266,7 +266,7 @@
266 266  
267 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:
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:
270 270  
271 271  
272 272  (% style="color:#000000" %)Führen Sie den Sync über den kopano-admin durch:
... ... @@ -275,6 +275,7 @@
275 275  root@kopano-g1:~ # kopano-admin --sync
276 276  {{/code}}
277 277  
272 +
278 278  (% style="color:#000000" %)Laden Sie folgendes Skript herunter:
279 279  
280 280  {{code language="bash"}}
... ... @@ -281,6 +281,7 @@
281 281  root@kopano-g1:~ # wget https://files.sbe.de/kopano/install-inject-shares.sh -O /tmp/install-inject-shares.sh
282 282  {{/code}}
283 283  
279 +
284 284  (% style="color:#000000" %)Führen Sie das Skript aus:
285 285  
286 286  {{code language="bash"}}
... ... @@ -287,6 +287,7 @@
287 287  root@kopano-g1:~ # bash /tmp/install-inject-shares.sh
288 288  {{/code}}
289 289  
286 +
290 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 291  
292 292  {{code language="bash"}}
... ... @@ -293,7 +293,7 @@
293 293  root@kopano-g1:~ # inject-shares.sh
294 294  {{/code}}
295 295  
296 -(% style="color:#000000" %)**__Hinweis:__** Falls beim Aufrufen des Skripts Mapi Fehler auftreten, bitte folgende Pakete installieren:(%%)
293 +(% style="color:#000000" %)**__Hinweis:__** Falls beim aufrufen des Skripts Mapi Fehler auftreten, bitte folgende Pakete installieren:(%%)
297 297  
298 298  
299 299  {{code language="bash"}}