XWiki - Main.Kopano.Allgemein.Kopano Grundinstallation

Wählen Sie die gewünschte Konfigurationsvorlage im (% style="color:#2980b9" %)Puppeteer-LXC(%%) aus dem Verzeichnis ##{{code}}/usr/share/doc/ld-puppet10/templates/mail/{{/code}}## aus.

30

31

* (% style="color:#2980b9" %)**simple**(%%) = Konfiguration für eine Domain (Default)

32

* (% style="color:#2980b9" %)**single**(%%) = Konfiguration für einzelne Postfächer mit unterschiedlichen Zugangsdaten

33

* (% style="color:#2980b9" %)**multiple**(%%) = Konfigurationen für unterschiedliche Domains, z.B. @students.example.com für Schüler und @example.com für Lehrer

34

35

Kopieren Sie die Konfigurationsdateien aus dem entsprechenden Unterordner.

36

37

(% class="box infomessage" %)

38

(((

39

Falls schon Dateien unter /etc/logodidact/hiera/custom.d/ existieren, die Dateien inhaltlich ergänzen und nicht überschreiben.

)))

cp -v /usr/share/doc/ld-puppet10/templates/mail/simple/custom.d/* /etc/logodidact/hiera/custom.d/

44

45

46

* Ersetzen: alle Vorkommen von "example.com" in der kopierten Datei ##kopano-g1.yaml## auf die vorgesehene Mail-Domain

47

* Ersetzen: alle Vorkommen von "pop3.example.com" in der kopierten Datei ##kopano-g1.yaml## auf ihren Posteingangsserver

48

* Ersetzen: alle Vorkommen von "smtp.example.com" in der kopierten Datei ##kopano-g1.yaml## auf ihren Postausgangsserver

49

* Ersetzen: alle Vorkommen vom Schlüsselwort "multidrop" in der kopierten Datei ##kopano-g1.yaml## durch den Benutzernamen ihres Postfach-Benutzers (als Teil der POP3- bzw. SMTP-Authentifizierungsdaten)

50

* Ersetzen: alle Vorkommen vom Schlüsselwort "geheim" in der kopierten Datei ##kopano-g1.yaml## durch das Passwort ihres Postfach-Benutzers (als Teil der POP3- bzw. SMTP-Authentifizierungsdaten)

51

52

Achten Sie darauf, dass die {{code}}kopano-g1.yaml{{/code}} folgende Zeile enthält. Die Zeile gewährleistet, dass der Kopano-Server die mariadb103 als DB verwendet.

53

54

55

ld_kopano::db_server: mariadb103

56

57

58

Bearbeiten Sie die Datei ##{{code}}/etc/logodidact/hiera/custom.d/ldhost.yaml{{/code}}## und passen Sie die nachfolgenden Zeilen inkl. Maildomain(s) wie gewünscht an. Im Beispiel liegt eine Unterscheidung der Maildomain zwischen Lehrern und Schülern vor (d.h. die Vorlage (% style="color:#2980b9" %)**multiple**(%%) wurde verwendet):

59

60

61

ld_legacy::mail::filters:

62

'(zarafaaccount=1)': 'example.com'

63

'(memberof=cn=schueler,ou=groups,dc=schule,dc=local)': 'students.example.com'

64

ld_legacy::mail::zarafa_groups:

- lehrer

- schueler

(% id="cke_bm_113S" style="display:none" %) (%%)Mit {{code}}ld_legacy::mail::filters{{/code}} geben Sie die E-Mail-Adresse für die Benutzer vor.

70

In diesem Fall entspricht '(zarafaaccount=1)' alle Benutzern, bei denen über die LDC Kopano aktiviert worden ist.

71

Alternativ lassen sich auch ldap-filter auf Gruppen bauen, um z.b Lehrer mit einer anderen E-Mail Domäne zu versorgen.

72

73

Die Option {{code}}ld_legacy::mail::zarafa_groups{{/code}} gibt an welche LDAP-Gruppe eine E-Mail-Adresse bekommt und darüber die Mitglieder erreichbar sind.

74

75

76

Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:

77

78

79

==== Freigabe von Kopano über rev-proxy ====

80

81

Erweitern Sie die ##{{code}}/etc/logodidact/hosts/rev-proxy/revproxy.conf{{/code}}## im (% style="color:#2980b9" %)Puppeteer-LXC(%%) um folgende Zeilen, um Kopano über den rev-proxy freizugeben.

82

83

84

[ReverseProxy kopano.ShortName.logoip.de]

Url https://kopano

Template kopano

(% id="cke_bm_2116S" style="display:none" %) (%%)Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:

cd /etc/logodidact/

git add .

git commit -a -m "Kopano über rev-proxy freigegeben."

==== Postfächer aktivieren ====

99

100

===== Kopano-Postfach für existierende Benutzer =====

101

102

Entscheiden Sie nun, welche Benutzer ein Kopano-Konto erhalten sollen und nehmen Sie die Aktivierung wie gewünscht über die Anwendung LogoDIDACT Console (LDC) vor.

103

Für bestehende Konten können Sie in der Benutzerverwaltung die entsprechenden Konten markieren und mittels Rechtsklick das Kontextmenü öffnen und dort {{code}}Kopano-Konto konfigurieren...{{/code}} auswählen.

104

105

[[image:bild2.png||class="img-thumbnail"]]

106

107

Aktivieren Sie das Kopano-Konto für die Benutzer, in dem Sie {{code}}aktiviert{{/code}} aus dem Menü auswählen und mit {{code}}OK{{/code}} bestätigen.

108

109

[[image:bild1.png||class="img-thumbnail"]]

110

111

112

===== Kopano-Postfach als Voreinstellung für neue Benutzer =====

113

114

Damit auch neue Benutzer direkt Kopano nutzen können, empfiehlt es sich, die Kopano-Option über die Import-Funktion zu aktivieren.

115

116

Wechseln Sie dafür in den Reiter {{code}}Importieren{{/code}} und wählen Sie die zu bearbeitende Liste mit einem Rechtsklick aus. Öffnen Sie die Liste, in dem Sie {{code}}Benutzerliste bearbeiten...{{/code}} im Kontexmenü auswählen.

117

118

[[image:bild3.png||class="img-thumbnail"]]

119

120

Klicken Sie auf {{code}}Konfiguration{{/code}} im Reiter des neuen Fensters. Hier können Sie beim Punkt {{code}}Kopano-Konto:{{/code}} {{code}}aktiviert{{/code}} auswählen. Mit dieser Einstellungen bekommen alle neuimportierten Benutzer auch ein Kopano-Konto.

121

122

[[image:bild4.png||class="img-thumbnail"]]

123

124

125

==== Benutzerkonto Admin zum Kopano-Admin ernennen ====

126

127

Laden Sie sich folgendes Skript im (% style="color:#2980b9" %)Logosrv-LXC(%%) herunter, um den Admin aus dem ldap zum Kopano-Admin zu bestimmen.

128

129

130

curl -k "https://files.sbe.de/kopano/set-kopano-admin.sh" -o /root/set-kopano-admin.sh

131

132

133

Führen Sie das heruntergeladene Skript aus

134

135

136

bash /root/set-kopano-admin.sh

==== Lokalisierte Kopano Postfächer ====

141

142

Damit die Ordner der Benutzer bei Ihrer ersten Anmeldung lokalisiert sind, installieren Sie folgendes Paket im (% style="color:#2980b9" %)Kopano-LXC(%%), damit das Tool {{code}}kopano-localize-folders{{/code}} verfügbar wird.

143

144

145

apt install kopano-python-utils

Führen Sie den Befehl wie folgt aus, um die Sprache für einen einzelnen Benutzer (hier: demo1) auf Deutsch zu stellen

150

151

152

kopano-localize-folders -u demo1 --lang de_DE.UTF-8

153

154

155

(% id="cke_bm_805S" style="display:none" %) (%%)Mit folgender Schleife können Sie die Lokalisierung für alle Kopano-Benutzer am Server durchführen

156

157

158

kopano-admin -l | tail -n +5 | head -n -1 | awk '{print $1}' | while read Username;

159

do

160

[ ! -z "$Username" ] && kopano-localize-folders -u $Username --lang de_DE.UTF-8;

done

==== Optional: weitere Installations-Pakete für Kopano im logosrv bereitstellen ====

166

167

Installieren Sie die optionalen Pakete "ld-kopano-deskapp-windows-32bit" und "ld-kopano-ol-extension" im (% style="color:#2980b9" %)logosrv-LXC(%%), damit die Benutzer die zum Server passende Kopano Outlook Extension benutzen können.

168

169

170

aptitude install ld-kopano-ol-extension ld-kopano-deskapp-windows-32bit

171

172

173

Die Setup-Dateien liegen anschießend im Netzlaufwerk (% style="color:#2980b9" %)**P:\Install\Kopano\**(%%) zur Installation an Clients abgespeichert.

174

175

176

==== Optional: Kopano WebApp im Internet freischalten ====

177

178

Bitte lesen Sie sich nach der Grundinstallation den Artikel [[Let’s Encrypt SSL-Zertifikat für Kopano beantragen>>doc:Main.Kopano.Allgemein.Let’s Encrypt SSL-Zertifikat für Kopano beantragen.WebHome]] durch, falls Sie Kopano als Webseite im Internet für den Zugriff durch Benutzer freischalten möchten.

author	version	line-number	content
		1	{{toc start="4"/}}
		2
		3
		4	----
		5
		6
		7	==== Voraussetzungen ====
		8
		9	* samba4-ad ist bereits als LXC-Container am Server aktiviert
		10	* alle Punkte aus dem Artikel [[Kopano Voraussetzungen>>doc:Main.Kopano.Allgemein.Kopano Voraussetzungen.WebHome]] werden erfüllt
		11	* Server muss mindestens über die Puppet Version 1.5.1 verfügen, damit mariadb103 als Container zur Verfügung steht
		12
		13
		14	==== Kopano installieren ====
		15
		16	Aktivieren Sie die Container kopano-g1 und mariadb103 über die //guest.conf// im puppeteer.
		17
		18	{{code language="bash"}}
		19	[Guest kopano-g1]
		20	Ensure running
		21
		22	[Guest mariadb103]
		23	Ensure running
		24	{{/code}}
		25
		26
		27	==== Kopano konfigurieren ====
		28
		29	Wählen Sie die gewünschte Konfigurationsvorlage im (% style="color:#2980b9" %)Puppeteer-LXC(%%) aus dem Verzeichnis ##{{code}}/usr/share/doc/ld-puppet10/templates/mail/{{/code}}## aus.
		30
		31	* (% style="color:#2980b9" %)simple(%%) = Konfiguration für eine Domain (Default)
		32	* (% style="color:#2980b9" %)single(%%) = Konfiguration für einzelne Postfächer mit unterschiedlichen Zugangsdaten
		33	* (% style="color:#2980b9" %)multiple(%%) = Konfigurationen für unterschiedliche Domains, z.B. @students.example.com für Schüler und @example.com für Lehrer
		34
		35	Kopieren Sie die Konfigurationsdateien aus dem entsprechenden Unterordner.
		36
		37	(% class="box infomessage" %)
		38	(((
		39	Falls schon Dateien unter /etc/logodidact/hiera/custom.d/ existieren, die Dateien inhaltlich ergänzen und nicht überschreiben.
		40	)))
		41
		42	{{code language="bash"}}
		43	cp -v /usr/share/doc/ld-puppet10/templates/mail/simple/custom.d/* /etc/logodidact/hiera/custom.d/
		44	{{/code}}
		45
		46	* Ersetzen: alle Vorkommen von "example.com" in der kopierten Datei ##kopano-g1.yaml## auf die vorgesehene Mail-Domain
		47	* Ersetzen: alle Vorkommen von "pop3.example.com" in der kopierten Datei ##kopano-g1.yaml## auf ihren Posteingangsserver
		48	* Ersetzen: alle Vorkommen von "smtp.example.com" in der kopierten Datei ##kopano-g1.yaml## auf ihren Postausgangsserver
		49	* Ersetzen: alle Vorkommen vom Schlüsselwort "multidrop" in der kopierten Datei ##kopano-g1.yaml## durch den Benutzernamen ihres Postfach-Benutzers (als Teil der POP3- bzw. SMTP-Authentifizierungsdaten)
		50	* Ersetzen: alle Vorkommen vom Schlüsselwort "geheim" in der kopierten Datei ##kopano-g1.yaml## durch das Passwort ihres Postfach-Benutzers (als Teil der POP3- bzw. SMTP-Authentifizierungsdaten)
		51
		52	Achten Sie darauf, dass die {{code}}kopano-g1.yaml{{/code}} folgende Zeile enthält. Die Zeile gewährleistet, dass der Kopano-Server die mariadb103 als DB verwendet.
		53
		54	{{code language="yaml"}}
		55	ld_kopano::db_server: mariadb103
		56	{{/code}}
		57
		58	Bearbeiten Sie die Datei ##{{code}}/etc/logodidact/hiera/custom.d/ldhost.yaml{{/code}}## und passen Sie die nachfolgenden Zeilen inkl. Maildomain(s) wie gewünscht an. Im Beispiel liegt eine Unterscheidung der Maildomain zwischen Lehrern und Schülern vor (d.h. die Vorlage (% style="color:#2980b9" %)multiple(%%) wurde verwendet):
		59
		60	{{code language="yaml"}}
		61	ld_legacy::mail::filters:
		62	'(zarafaaccount=1)': 'example.com'
		63	'(memberof=cn=schueler,ou=groups,dc=schule,dc=local)': 'students.example.com'
		64	ld_legacy::mail::zarafa_groups:
		65	- lehrer
		66	- schueler
		67	{{/code}}
		68
		69	(% id="cke_bm_113S" style="display:none" %) (%%)Mit {{code}}ld_legacy::mail::filters{{/code}} geben Sie die E-Mail-Adresse für die Benutzer vor.
		70	In diesem Fall entspricht '(zarafaaccount=1)' alle Benutzern, bei denen über die LDC Kopano aktiviert worden ist.
		71	Alternativ lassen sich auch ldap-filter auf Gruppen bauen, um z.b Lehrer mit einer anderen E-Mail Domäne zu versorgen.
		72
		73	Die Option {{code}}ld_legacy::mail::zarafa_groups{{/code}} gibt an welche LDAP-Gruppe eine E-Mail-Adresse bekommt und darüber die Mitglieder erreichbar sind.
		74
		75
		76	Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
		77
		78
		79	==== Freigabe von Kopano über rev-proxy ====
		80
		81	Erweitern Sie die ##{{code}}/etc/logodidact/hosts/rev-proxy/revproxy.conf{{/code}}## im (% style="color:#2980b9" %)Puppeteer-LXC(%%) um folgende Zeilen, um Kopano über den rev-proxy freizugeben.
		82
		83	{{code language="bash"}}
		84	[ReverseProxy kopano.ShortName.logoip.de]
		85	Url https://kopano
		86	Template kopano
		87	{{/code}}
		88
		89	(% id="cke_bm_2116S" style="display:none" %) (%%)Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git:
		90
		91	{{code language="bash"}}
		92	cd /etc/logodidact/
		93	git add .
		94	git commit -a -m "Kopano über rev-proxy freigegeben."
		95	{{/code}}
		96
		97
		98	==== Postfächer aktivieren ====
		99
		100	===== Kopano-Postfach für existierende Benutzer =====
		101
		102	Entscheiden Sie nun, welche Benutzer ein Kopano-Konto erhalten sollen und nehmen Sie die Aktivierung wie gewünscht über die Anwendung LogoDIDACT Console (LDC) vor.
		103	Für bestehende Konten können Sie in der Benutzerverwaltung die entsprechenden Konten markieren und mittels Rechtsklick das Kontextmenü öffnen und dort {{code}}Kopano-Konto konfigurieren...{{/code}} auswählen.
		104
		105	[[image:bild2.png\|\|class="img-thumbnail"]]
		106
		107	Aktivieren Sie das Kopano-Konto für die Benutzer, in dem Sie {{code}}aktiviert{{/code}} aus dem Menü auswählen und mit {{code}}OK{{/code}} bestätigen.
		108
		109	[[image:bild1.png\|\|class="img-thumbnail"]]
		110
		111
		112	===== Kopano-Postfach als Voreinstellung für neue Benutzer =====
		113
		114	Damit auch neue Benutzer direkt Kopano nutzen können, empfiehlt es sich, die Kopano-Option über die Import-Funktion zu aktivieren.
		115
		116	Wechseln Sie dafür in den Reiter {{code}}Importieren{{/code}} und wählen Sie die zu bearbeitende Liste mit einem Rechtsklick aus. Öffnen Sie die Liste, in dem Sie {{code}}Benutzerliste bearbeiten...{{/code}} im Kontexmenü auswählen.
		117
		118	[[image:bild3.png\|\|class="img-thumbnail"]]
		119
		120	Klicken Sie auf {{code}}Konfiguration{{/code}} im Reiter des neuen Fensters. Hier können Sie beim Punkt {{code}}Kopano-Konto:{{/code}} {{code}}aktiviert{{/code}} auswählen. Mit dieser Einstellungen bekommen alle neuimportierten Benutzer auch ein Kopano-Konto.
		121
		122	[[image:bild4.png\|\|class="img-thumbnail"]]
		123
		124
		125	==== Benutzerkonto Admin zum Kopano-Admin ernennen ====
		126
		127	Laden Sie sich folgendes Skript im (% style="color:#2980b9" %)Logosrv-LXC(%%) herunter, um den Admin aus dem ldap zum Kopano-Admin zu bestimmen.
		128
		129	{{code}}
		130	curl -k "https://files.sbe.de/kopano/set-kopano-admin.sh" -o /root/set-kopano-admin.sh
		131	{{/code}}
		132
		133	Führen Sie das heruntergeladene Skript aus
		134
		135	{{code}}
		136	bash /root/set-kopano-admin.sh
		137	{{/code}}
		138
		139
		140	==== Lokalisierte Kopano Postfächer ====
		141
		142	Damit die Ordner der Benutzer bei Ihrer ersten Anmeldung lokalisiert sind, installieren Sie folgendes Paket im (% style="color:#2980b9" %)Kopano-LXC(%%), damit das Tool {{code}}kopano-localize-folders{{/code}} verfügbar wird.
		143
		144	{{code}}
		145	apt install kopano-python-utils
		146
		147	{{/code}}
		148
		149	Führen Sie den Befehl wie folgt aus, um die Sprache für einen einzelnen Benutzer (hier: demo1) auf Deutsch zu stellen
		150
		151	{{code}}
		152	kopano-localize-folders -u demo1 --lang de_DE.UTF-8
		153	{{/code}}
		154
		155	(% id="cke_bm_805S" style="display:none" %) (%%)Mit folgender Schleife können Sie die Lokalisierung für alle Kopano-Benutzer am Server durchführen
		156
		157	{{code}}
		158	kopano-admin -l \| tail -n +5 \| head -n -1 \| awk '{print $1}' \| while read Username;
		159	do
		160	[ ! -z "$Username" ] && kopano-localize-folders -u $Username --lang de_DE.UTF-8;
		161	done
		162	{{/code}}
		163
		164
		165	==== Optional: weitere Installations-Pakete für Kopano im logosrv bereitstellen ====
		166
		167	Installieren Sie die optionalen Pakete "ld-kopano-deskapp-windows-32bit" und "ld-kopano-ol-extension" im (% style="color:#2980b9" %)logosrv-LXC(%%), damit die Benutzer die zum Server passende Kopano Outlook Extension benutzen können.
		168
		169	{{code language="bash"}}
		170	aptitude install ld-kopano-ol-extension ld-kopano-deskapp-windows-32bit
		171	{{/code}}
		172
		173	Die Setup-Dateien liegen anschießend im Netzlaufwerk (% style="color:#2980b9" %)P:\Install\Kopano\(%%) zur Installation an Clients abgespeichert.
		174
		175
		176	==== Optional: Kopano WebApp im Internet freischalten ====
		177
		178	Bitte lesen Sie sich nach der Grundinstallation den Artikel [[Let’s Encrypt SSL-Zertifikat für Kopano beantragen>>doc:Main.Kopano.Allgemein.Let’s Encrypt SSL-Zertifikat für Kopano beantragen.WebHome]] durch, falls Sie Kopano als Webseite im Internet für den Zugriff durch Benutzer freischalten möchten.

Wiki-Quellcode von Kopano Grundinstallation