Zum Inhalt springen

Wiki-Quellcode von Kopano Optimierungen

Version 19.1 von Christian Germann am 2022/05/06 15:51
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="4"/}}
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 durch Konfiguration von HTTP KeepAlive__**(%%) =====
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 [EINFÜGEN..... keeepAlive Settings in kopano-g1.yaml.... aus dem weiter oben dokumentierten Abschnitt dann entfernen]
209
210
211 (% style="color:#000000" %)Zusätzlich müssen Sie die Datei rev-proxy.yaml erstellen/bearbeiten:
212
213 {{code language="bash"}}
214 root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/rev-proxy.yaml
215 {{/code}}
216
217 (% style="color:#000000" %)Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
218
219 {{code language="bash"}}
220 nginx::keepalive_timeout: 3600
221 nginx::keepalive_requests: 500
222 {{/code}}
223
224
225 ==== (% style="color:#000000" %)**2. Allgemeine Optimierungen der Einstellungen**(%%) ====
226
227
228 ===== (% style="color:#000000" %)**__2.1 Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern durch Versenden per Relayhost__**(%%) =====
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
232
233 (% style="color:#000000" %)Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
234
235 {{code language="bash"}}
236 root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
237 {{/code}}
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
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
248 {{/code}}
249
250
251 ===== (% style="color:#000000" %)__**2.2 Fortsetzung...Zugehöriger CronJob für Wartungsaufgaben**__(%%) =====
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 {{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
259 {{/code}}
260
261
262 ===== (% style="color:#000000" %)**__XXXX Eigener Artikel: Netzlaufwerke auf der Kopano-Weboberfläche anzeigen__**(%%) =====
263
264 (% 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:
265
266
267 (% style="color:#000000" %)Führen Sie den Sync über den kopano-admin durch:
268
269 {{code language="bash"}}
270 root@kopano-g1:~ # kopano-admin --sync
271 {{/code}}
272
273 (% style="color:#000000" %)Laden Sie folgendes Skript herunter:
274
275 {{code language="bash"}}
276 root@kopano-g1:~ # wget https://files.sbe.de/kopano/install-inject-shares.sh -O /tmp/install-inject-shares.sh
277 {{/code}}
278
279 (% style="color:#000000" %)Führen Sie das Skript aus:
280
281 {{code language="bash"}}
282 root@kopano-g1:~ # bash /tmp/install-inject-shares.sh
283 {{/code}}
284
285 (% 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:
286
287 {{code language="bash"}}
288 root@kopano-g1:~ # inject-shares.sh
289 {{/code}}
290
291 (% style="color:#000000" %)**__Hinweis:__** Falls beim Aufrufen des Skripts Mapi Fehler auftreten, bitte folgende Pakete installieren:(%%)
292
293
294 {{code language="bash"}}
295 python-mapi
296 python-kopano
297 python3-kopano-utils
298 kopano-python-utils
299 {{/code}}
300
301
302 ===== (% style="color:#000000" %)__**2.3 Regelmäßige Synchronisation der Benutzer in das globale Adressbuch**__(%%) =====
303
304 (% 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.
305
306 {{code language="bash"}}
307 root@kopano-g1:~ # chmod +x /etc/cron.daily/gabsync
308 {{/code}}
309
310 (% 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.