Zum Inhalt springen

Änderungen von Dokument Kopano Optimierungen

Zuletzt geändert von Jonas Mayer am 2022/05/23 12:53
Von Version 17.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,63 +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 -===== (% style="color:#000000" %)**__Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern durch Versenden per Relayhost__**(%%) =====
223 -
224 -(% 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.
225 -
226 -
227 -(% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
228 -
229 -{{code language="bash"}}
230 -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'
231 231  {{/code}}
232 232  
233 -(% 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).
234 234  
235 -{{code language="bash"}}
236 -ld_kopano::postfix::hashes:
237 -  '%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
238 -    content: |
239 -      %{header}
240 -      <> smtp.meineschule.de
241 -      @meineschule.de smtp.meineschule.de
242 -{{/code}}
243 -
244 -
245 245  ===== (% style="color:#000000" %)__**Public Folder erstellen**__(%%) =====
246 246  
247 247  (% 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:
... ... @@ -264,7 +264,7 @@
264 264  
265 265  ===== (% style="color:#000000" %)**__Netzlaufwerke auf der Kopano-Weboberfläche anzeigen__**(%%) =====
266 266  
267 -(% 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:
268 268  
269 269  
270 270  (% style="color:#000000" %)Führen Sie den Sync über den kopano-admin durch:
... ... @@ -273,6 +273,7 @@
273 273  root@kopano-g1:~ # kopano-admin --sync
274 274  {{/code}}
275 275  
272 +
276 276  (% style="color:#000000" %)Laden Sie folgendes Skript herunter:
277 277  
278 278  {{code language="bash"}}
... ... @@ -279,6 +279,7 @@
279 279  root@kopano-g1:~ # wget https://files.sbe.de/kopano/install-inject-shares.sh -O /tmp/install-inject-shares.sh
280 280  {{/code}}
281 281  
279 +
282 282  (% style="color:#000000" %)Führen Sie das Skript aus:
283 283  
284 284  {{code language="bash"}}
... ... @@ -285,6 +285,7 @@
285 285  root@kopano-g1:~ # bash /tmp/install-inject-shares.sh
286 286  {{/code}}
287 287  
286 +
288 288  (% 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:
289 289  
290 290  {{code language="bash"}}
... ... @@ -291,7 +291,7 @@
291 291  root@kopano-g1:~ # inject-shares.sh
292 292  {{/code}}
293 293  
294 -(% 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:(%%)
295 295  
296 296  
297 297  {{code language="bash"}}