Wiki-Quellcode von Kopano Optimierungen

Version 1.8 von Jens Gruber am 2022/05/02 11:09

version	line-number	content
1.1	1	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
	4	===== __Zustellbarkeit der Unzustellbarkeits-Nachrichten verbessern__ =====
	5
	6	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.
	7
	8
	9	Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
	10
	11	{{code language="bash"}}
	12	root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
	13	{{/code}}
	14
	15
1.2	16	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).
1.1	17
	18	{{code language="bash"}}
	19	ld_kopano::postfix::hashes:
	20	'%{dir_etc}/sender_dependent_relayhost_maps_external.hash':
	21	content: \|
	22	%{header}
	23	<> smtp.meineschule.de
	24	@meineschule.de smtp.meineschule.de
	25	{{/code}}
	26
1.3	27
1.4	28	===== __Anbindung/Akkulaufzeit von Endgeräten verbessern__ =====
	29
	30	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.
	31
	32	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).
	33
	34
	35	Zum erhöhen der TimeOuts öffnen Sie die kopano-g1.yaml:
	36
	37	{{code language="bash"}}
	38	root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
	39	{{/code}}
	40
	41
	42	Fügen Sie folgende Zeilen am Ende der Datei ein:
	43
	44	{{code language="bash"}}
	45	apache::keepalive: 'On'
	46	apache::keepalive_timeout: '45'
	47	apache::max_keepalive_requests: '500'
	48	apache::mod::prefork::maxclients: '384'
	49	apache::mod::prefork::serverlimit: '384'
	50
	51	nginx::keepalive_timeout: 3600
	52	nginx::keepalive_requests: 500
	53	{{/code}}
	54
	55
	56	Zusätzlich müssen Sie die Datei rev-proxy.yaml erstellen/bearbeiten:
	57
	58	{{code language="bash"}}
	59	root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/rev-proxy.yaml
	60	{{/code}}
	61
	62
	63	Ergänzen/Befüllen Sie die Datei mit folgendem Inhalt:
	64
	65	{{code language="bash"}}
	66	nginx::keepalive_timeout: 3600
	67	nginx::keepalive_requests: 500
	68	{{/code}}
	69
1.5	70
	71	===== __Kopano Leistung verbessern__ =====
	72
	73	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.
	74
	75	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.
	76
	77
	78	Bearbeiten Sie in die Datei kopano-g1.yaml im puppeteer Container:
	79
	80	{{code language="bash"}}
	81	root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/kopano-g1.yaml
	82	{{/code}}
	83
	84
	85	Folgende Parameter können ggf. helfen die Leistung zu verbessern:
	86
	87	{{code language="bash"}}
	88	apache::keepalive: 'On'
	89	apache::keepalive_timeout: '45'
	90	apache::max_keepalive_requests: '500'
	91	apache::mod::prefork::maxclients: '500'
	92	apache::mod::prefork::serverlimit: '500'
	93
	94	ld_kopano::server:
	95	settings:
	96	cache_cell_size: '6144M'
	97	cache_object_size: '16M'
	98	cache_indexedobject_size: '32M'
	99	enable_sql_procedures: 'yes'
1.6	100	# The following 2 settings require a cronjob to run periodically instead (in case the value is disabled)
	101	sync_gab_realtime: 'no'
1.5	102	softdelete_lifetime: '0'
	103	{{/code}}
	104
1.6	105
	106	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:
	107
	108	{{code language="bash"}}
	109	root@kopano-g1:~ # /etc/cron.d/kopano-optimization
	110	{{/code}}
	111
	112	{{code language="bash"}}
	113	# /etc/cron.d/kopano-optimization
	114	/30 * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --sync 2>&1 >/dev/null
	115	0 4 * * * root [ -x /usr/sbin/kopano-admin ] && /usr/sbin/kopano-admin --purge-softdelete 30 2>&1 >/dev/null
	116	{{/code}}
	117
	118
	119	Folgende Einstellung können für die mysql56.yaml gesetzt werden:
	120
	121	{{code language="bash"}}
	122	root@puppeteer:~ # vim /etc/logodidact/hiera/custom.d/mysql56.yaml
	123	{{/code}}
	124
	125	{{code language="bash"}}
	126	mysql::server::override_options:
	127	mysqldump:
	128	max_allowed_packet: '1G'
	129	mysqld:
	130	innodb_file_per_table: true
	131	bind-address: '0.0.0.0'
	132	skip-name-resolve: true
	133	innodb_large_prefix: true
	134	innodb_file_format: 'Barracuda'
	135	max_allowed_packet: '256M'
	136	max_connections: '150'
	137	query_cache_limit: '2M'
	138	query_cache_size: '64M'
	139	thread_stack: '512K'
	140	tmp_table_size: '64M'
	141	max_heap_table_size: '64M'
	142	sort_buffer_size: '2M'
	143	join_buffer_size: '2M'
	144	table_open_cache: '500'
	145	innodb_autoextend_increment: '1000'
	146	innodb_buffer_pool_size: '2G'
	147	innodb_flush_log_at_trx_commit: '2'
	148	innodb_flush_method: 'O_DSYNC'
	149	innodb_lock_wait_timeout: '120'
	150	innodb_log_buffer_size: '8M'
	151	innodb_log_file_size: '1G'
	152	innodb_log_files_in_group: '3'
	153	innodb_read_io_threads: '4'
	154	innodb_write_io_threads: '4'
	155	{{/code}}
	156
1.8	157
	158	===== __Lokalisierung der Ordner-Strukturen__ =====
	159
	160
	161	Zur Lokalisierung der Ordnernamen empfiehlt es sich, Standard-Sprache für die Kopano-Postfächer auf "Deutsch" umzustellen. Führen Sie folgende Schritte durch:
	162
	163
	164	Wechseln Sie in den Kopano Container:
	165
	166	{{code language="bash"}}
	167	root@ldhost:~ # lxc-ssh -n kopano-g1
	168	{{/code}}
	169
	170
	171	Führen Sie folgenden Befehl im Kopano Container aus:
	172
	173	{{code language="bash"}}
	174	root@kopano-g1:~ # echo 'default_store_locale = de_DE.UTF-8 ' >/etc/kopano/admin.cfg
	175	{{/code}}
	176
	177
	178	Nach ausführen des Befehls werden neu angelegte Kopano-Postfächer mit der korrekten Sprache erstellt. Für bereits erstellte/vorhandene Postfächer muss man einen extra Schritt durchführen. Setzen sie hierfür folgenden Befehl im Kopano Container ab:
	179
	180	{{code language="bash"}}
	181	root@kopano-g1:~ # kopano-localize-folders -u [username] --lang de_DE.UTF-8
	182	{{/code}}
	183
	184
1.7	185