Zum Inhalt springen

Wiki-Quellcode von Kopano Optimierungen

Version 17.1 von Christian Germann am 2022/05/04 13:01
Zeige letzte Bearbeiter
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
3 {{toc start="5"/}}
4
5
6 ==== **1. Performance-Optimierung** ====
7
8
9 ===== (% style="color:#000000" %)**__1.1 Kopano Leistung verbessern__**(%%) =====
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.
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.
14
15
16 (% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
17
18 {{code language="bash"}}
19 root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
20 {{/code}}
21
22 Passen Sie die kopano-g1.yaml je nach Größe der Schule an.
23
24 **kopano-g1.yaml für Kopano <50 Users:**
25
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 apache::mod::prefork::maxclients: '384'
34 apache::mod::prefork::serverlimit: '384'
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'
45 {{/code}}
46
47 **kopano-g1.yaml für Kopano >=50 Users**
48
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 apache::mod::prefork::maxclients: '500'
57 apache::mod::prefork::serverlimit: '500'
58
59 ld_kopano::server:
60 settings:
61 cache_cell_size: '6144M'
62 cache_object_size: '32M'
63 cache_indexedobject_size: '64M'
64 enable_sql_procedures: 'yes'
65 # The following 2 settings require a cronjob to run periodically instead (in case the value is disabled)
66 sync_gab_realtime: 'no'
67 softdelete_lifetime: '0'
68 {{/code}}
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
82 ld_kopano::server:
83 settings:
84 cache_cell_size: '12288M'
85 cache_object_size: '256M'
86 cache_indexedobject_size: '512M'
87 enable_sql_procedures: 'yes'
88 # The following 2 settings require a cronjob to run periodically instead (in case the value is disabled)
89 sync_gab_realtime: 'no'
90 softdelete_lifetime: '0'
91 {{/code}}
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
95 {{code language="bash"}}
96 root@kopano-g1:~ # /etc/cron.d/kopano-optimization
97 {{/code}}
98
99 {{code language="bash"}}
100 # /etc/cron.d/kopano-optimization
101 */30 *  * * *     root   [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --sync 2>&1 >/dev/null
102 0 4  * * *     root   [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --purge-softdelete 30 2>&1 >/dev/null
103 {{/code}}
104
105
106 ===== __**1.2 mysql56(% style="color:#000000" %) Leistung verbessern(%%)**__ =====
107
108 (% style="color:#000000" %)Folgende Einstellung können für die mysql56.yaml gesetzt werden:
109
110 {{code language="bash"}}
111 root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/mysql56.yaml
112 {{/code}}
113
114 {{code language="yaml"}}
115 mysql::server::override_options:
116 mysqldump:
117 max_allowed_packet: '1G'
118 mysqld:
119 innodb_file_per_table: true
120 bind-address: '0.0.0.0'
121 skip-name-resolve: true
122 innodb_large_prefix: true
123 innodb_file_format: 'Barracuda'
124 max_allowed_packet: '32M'
125 max_connections: '150'
126 query_cache_limit: '2M'
127 query_cache_size: '64M'
128 thread_stack: '512K'
129 tmp_table_size: '64M'
130 max_heap_table_size: '64M'
131 sort_buffer_size: '2M'
132 join_buffer_size: '2M'
133 table_open_cache: '500'
134 innodb_autoextend_increment: '1000'
135 innodb_buffer_pool_size: '2G'
136 innodb_flush_log_at_trx_commit: '2'
137 innodb_flush_method: 'O_DSYNC'
138 innodb_lock_wait_timeout: '120'
139 innodb_log_buffer_size: '8M'
140 innodb_log_file_size: '1G'
141 innodb_log_files_in_group: '3'
142 innodb_read_io_threads: '4'
143 innodb_write_io_threads: '4'
144 {{/code}}
145
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 {{code language="bash"}}
152 root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/mariadb103.yaml
153 {{/code}}
154
155 {{code language="yaml"}}
156 mysql::server::override_options:
157 mysqldump:
158 max_allowed_packet: '1G'
159 mysqld:
160 innodb_file_per_table: '1'
161 bind-address: '0.0.0.0'
162 skip-name-resolve: true
163 innodb_large_prefix: '1'
164 max_allowed_packet: '32M'
165 max_connections: '151'
166 query_cache_limit: '2M'
167 query_cache_size: '64M'
168 thread_stack: '512K'
169 tmp_table_size: '64M'
170 max_heap_table_size: '64M'
171 sort_buffer_size: '2M'
172 join_buffer_size: '2M'
173 table_open_cache: '500'
174 innodb_autoextend_increment: '1000'
175 innodb_buffer_pool_size: '1G'
176 # The following setting is based on the existing ibdata1 file, check current size and insert it here (rounded to MB)
177 innodb_data_file_path: 'ibdata1:12M:autoextend'
178 innodb_flush_log_at_trx_commit: '2'
179 innodb_flush_method: 'O_DSYNC'
180 innodb_lock_wait_timeout: '120'
181 innodb_log_buffer_size: '8M'
182 innodb_log_file_size: '1G'
183 innodb_log_files_in_group: '3'
184 innodb_read_io_threads: '4'
185 innodb_write_io_threads: '4'
186 {{/code}}
187
188 Passen Sie die {{code}}mariadb103.yaml{{/code}} noch folgendermaßen an für Große Umgebungen mit vielen Postfächern.
189
190 **mariadb103.yaml für Kopano >= 50 Users:**
191
192 {{code language="yaml"}}
193 sort_buffer_size: '4M'
194 innodb_buffer_pool_size: '2G'
195 {{/code}}
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 {{/code}}
213
214 (% style="color:#000000" %)Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
215
216 {{code language="bash"}}
217 nginx::keepalive_timeout: 3600
218 nginx::keepalive_requests: 500
219 {{/code}}
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
231 {{/code}}
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
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 ===== (% style="color:#000000" %)__**Public Folder erstellen**__(%%) =====
246
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:
248
249 {{code language="bash"}}
250 root@kopano-g1:~ # kopano-admin -s
251 {{/code}}
252
253
254 ===== (% style="color:#000000" %)__**Cronjob für Wartungsaufgaben**__(%%) =====
255
256 (% 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:
257
258 {{code language="bash"}}
259 # /etc/cron.d/kopano-optimization
260 */30 * * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --sync 2>&1 >/dev/null
261 0 4 * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --purge-softdelete 30 2>&1 >/dev/null
262 {{/code}}
263
264
265 ===== (% style="color:#000000" %)**__Netzlaufwerke auf der Kopano-Weboberfläche anzeigen__**(%%) =====
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:
268
269
270 (% style="color:#000000" %)Führen Sie den Sync über den kopano-admin durch:
271
272 {{code language="bash"}}
273 root@kopano-g1:~ # kopano-admin --sync
274 {{/code}}
275
276 (% style="color:#000000" %)Laden Sie folgendes Skript herunter:
277
278 {{code language="bash"}}
279 root@kopano-g1:~ # wget https://files.sbe.de/kopano/install-inject-shares.sh -O /tmp/install-inject-shares.sh
280 {{/code}}
281
282 (% style="color:#000000" %)Führen Sie das Skript aus:
283
284 {{code language="bash"}}
285 root@kopano-g1:~ # bash /tmp/install-inject-shares.sh
286 {{/code}}
287
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
290 {{code language="bash"}}
291 root@kopano-g1:~ # inject-shares.sh
292 {{/code}}
293
294 (% style="color:#000000" %)**__Hinweis:__** Falls beim Aufrufen des Skripts Mapi Fehler auftreten, bitte folgende Pakete installieren:(%%)
295
296
297 {{code language="bash"}}
298 python-mapi
299 python-kopano
300 python3-kopano-utils
301 kopano-python-utils
302 {{/code}}
303
304
305 ===== (% style="color:#000000" %)__**Synchronisation der Benutzer in das globale Adressbuch**__(%%) =====
306
307 (% 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.
308
309 {{code language="bash"}}
310 root@kopano-g1:~ # chmod +x /etc/cron.daily/gabsync
311 {{/code}}
312
313 (% 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.