Wiki-Quellcode von Kopano Grundinstallation
Version 46.1 von jonasmayer@sbede am 2022/05/02 19:32
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | {{toc start="4"/}} | ||
2 | |||
3 | |||
4 | ==== Voraussetzungen ==== | ||
5 | |||
6 | * samba4-ad ist bereits als LXC-Container am Server aktiviert | ||
7 | |||
8 | ==== Kopano installieren ==== | ||
9 | |||
10 | Aktivieren Sie die Container **kopano-g1 **und** mariadb103 **über die //guest.conf// im puppeteer. | ||
11 | |||
12 | {{code language="bash"}} | ||
13 | [Guest kopano-g1] | ||
14 | Ensure running | ||
15 | |||
16 | [Guest mariadb103] | ||
17 | Ensure running | ||
18 | {{/code}} | ||
19 | |||
20 | |||
21 | ==== Kopano konfigurieren ==== | ||
22 | |||
23 | 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. | ||
24 | |||
25 | * (% style="color:#2980b9" %)**simple**(%%) = Konfiguration für eine Domain (Default) | ||
26 | * (% style="color:#2980b9" %)**single**(%%) = Konfiguration für einzelne Postfächer mit unterschiedlichen Zugangsdaten | ||
27 | * (% style="color:#2980b9" %)**multiple**(%%) = Konfigurationen für unterschiedliche Domains, z.B. @students.example.com für Schüler und @example.com für Lehrer | ||
28 | |||
29 | Kopieren Sie die Konfigurationsdateien aus dem entsprechenden Unterordner. | ||
30 | |||
31 | (% class="box infomessage" %) | ||
32 | ((( | ||
33 | Falls schon Dateien unter /etc/logodidact/hiera/custom.d/ existieren, die Dateien inhaltlich ergänzen und nicht überschreiben. | ||
34 | ))) | ||
35 | |||
36 | {{code language="bash"}} | ||
37 | cp -v /usr/share/doc/ld-puppet10/templates/mail/simple/custom.d/* /etc/logodidact/hiera/custom.d/ | ||
38 | {{/code}} | ||
39 | |||
40 | * Ersetzen: alle Vorkommen von "example.com" in der kopierten Datei ##kopano-g1.yaml## auf die vorgesehene Mail-Domain | ||
41 | * Ersetzen: alle Vorkommen von "pop3.example.com" in der kopierten Datei ##kopano-g1.yaml## auf ihren Posteingangsserver | ||
42 | * Ersetzen: alle Vorkommen von "smtp.example.com" in der kopierten Datei ##kopano-g1.yaml## auf ihren Postausgangsserver | ||
43 | * 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) | ||
44 | * 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) | ||
45 | |||
46 | Erstellen oder Erweitern Sie die Datei ##{{code}}/etc/logodidact/hiera/custom.d/ldhost.yaml{{/code}}## um folgende Zeilen: | ||
47 | |||
48 | {{code language="yaml"}} | ||
49 | ld_legacy::mail::filters: | ||
50 | '(zarafaaccount=1)': 'students.example.com' | ||
51 | '(memberof=cn=lehrer,ou=groups,dc=schule,dc=local)': 'example.com' | ||
52 | ld_legacy::mail::zarafa_groups: | ||
53 | - lehrer | ||
54 | - schueler | ||
55 | {{/code}} | ||
56 | |||
57 | (% 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. | ||
58 | In diesem Fall entspricht '(zarafaaccount=1)' alle Benutzern, bei denen über die LDC Kopano aktiviert worden ist. | ||
59 | Alternativ lassen sich auch ldap-filter auf Gruppen bauen, um z.b Lehrer mit einer anderen E-Mail Domäne zu versorgen. | ||
60 | |||
61 | 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. | ||
62 | |||
63 | |||
64 | Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git: | ||
65 | |||
66 | |||
67 | ==== Freigabe von Kopano über rev-proxy ==== | ||
68 | |||
69 | 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. | ||
70 | |||
71 | {{code language="bash"}} | ||
72 | [ReverseProxy kopano.ShortName.logoip.de] | ||
73 | Url https://kopano | ||
74 | Template kopano | ||
75 | {{/code}} | ||
76 | |||
77 | (% id="cke_bm_2116S" style="display:none" %) (%%)Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git: | ||
78 | |||
79 | {{code language="bash"}} | ||
80 | cd /etc/logodidact/ | ||
81 | git add . | ||
82 | git commit -a -m "Kopano über rev-proxy freigegeben." | ||
83 | {{/code}} | ||
84 | |||
85 | |||
86 | ==== Kopano für Benutzer aktivieren ==== | ||
87 | |||
88 | Aktivieren Sie nun über die LogoDIDACT Console (LDC) welche Benutzer ein Kopano-Konto erhalten sollen. | ||
89 | |||
90 | 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. | ||
91 | |||
92 | [[image:bild2.png]] | ||
93 | |||
94 | 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. | ||
95 | |||
96 | [[image:bild1.png]] | ||
97 | |||
98 | |||
99 | Damit auch neue Benutzer direkt Kopano nutzen können, empfiehlt es sich, die Kopano-Option über die Import-Funktion zu aktivieren. | ||
100 | |||
101 | 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. | ||
102 | |||
103 | [[image:bild3.png]] | ||
104 | |||
105 | 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. | ||
106 | |||
107 | [[image:bild4.png]] | ||
108 | |||
109 | |||
110 | ==== Benutzerkonto Admin zum Kopano-Admin ernennen ==== | ||
111 | |||
112 | Laden Sie sich folgendes Skript im (% style="color:#2980b9" %)Logosrv-LXC(%%) herunter, um den Admin aus dem ldap zum Kopano-Admin zu bestimmen. | ||
113 | |||
114 | {{code}} | ||
115 | curl -k "https://files.sbe.de/kopano/set-kopano-admin.sh" -o /root/set-kopano-admin.sh | ||
116 | {{/code}} | ||
117 | |||
118 | Führen Sie das heruntergeladene Skript aus | ||
119 | |||
120 | {{code}} | ||
121 | bash /root/set-kopano-admin.sh | ||
122 | {{/code}} | ||
123 | |||
124 | |||
125 | ==== Lokalisierte Kopano Postfächer ==== | ||
126 | |||
127 | 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. | ||
128 | |||
129 | {{code}} | ||
130 | apt install kopano-python-utils | ||
131 | |||
132 | {{/code}} | ||
133 | |||
134 | Führen Sie den Befehl wie folgt aus, um die Sprache für einen einzelnen Benutzer (hier: demo1) auf Deutsch zu stellen | ||
135 | |||
136 | {{code}} | ||
137 | kopano-localize-folders -u demo1 --lang de_DE.UTF-8 | ||
138 | {{/code}} | ||
139 | |||
140 | (% id="cke_bm_805S" style="display:none" %) (%%)Mit folgender Schleife können Sie die Lokalisierung für alle Kopano-Benutzer am Server durchführen | ||
141 | |||
142 | {{code}} | ||
143 | kopano-admin -l | tail -n +5 | head -n -1 | awk '{print $1}' | while read Username; | ||
144 | do | ||
145 | [ ! -z "$Username" ] && kopano-localize-folders -u $Username --lang de_DE.UTF-8; | ||
146 | done | ||
147 | {{/code}} | ||
148 | |||
149 | |||
150 | ==== Optional: weitere Installations-Pakete für Kopano im logosrv bereitstellen ==== | ||
151 | |||
152 | 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. | ||
153 | |||
154 | {{code language="bash"}} | ||
155 | aptitude install ld-kopano-ol-extension ld-kopano-deskapp-windows-32bit | ||
156 | {{/code}} | ||
157 | |||
158 | Die Setup-Dateien liegen anschießend im Netzlaufwerk (% style="color:#2980b9" %)**P:\Install\Kopano\**(%%) zur Installation an Clients abgespeichert. | ||
159 | |||
160 | |||
161 | ==== Optional: Kopano WebApp im Internet freischalten ==== | ||
162 | |||
163 | 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. |