Wiki-Quellcode von Kopano Grundinstallation
Version 43.1 von cge@sbede am 2022/05/02 16:52
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{toc start="4"/}} | ||
| 2 | |||
| 3 | |||
| 4 | ==== Voraussetzungen ==== | ||
| 5 | |||
| 6 | * samba4-ad ist 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 | {{code language="bash"}} | ||
| 67 | cd /etc/logodidact/ | ||
| 68 | git add . | ||
| 69 | git commit -a -m "Kopano LXC-Container, Abhängigkeiten und Einstellungen konfiguriert." | ||
| 70 | {{/code}} | ||
| 71 | |||
| 72 | |||
| 73 | ==== Freigabe von Kopano über rev-proxy ==== | ||
| 74 | |||
| 75 | 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. | ||
| 76 | |||
| 77 | {{code language="bash"}} | ||
| 78 | [ReverseProxy kopano.ShortName.logoip.de] | ||
| 79 | Url https://kopano | ||
| 80 | Template kopano | ||
| 81 | {{/code}} | ||
| 82 | |||
| 83 | (% id="cke_bm_2116S" style="display:none" %) (%%)Übernehmen Sie die neuen Dateien bzw. die Änderungen ins Git: | ||
| 84 | |||
| 85 | {{code language="bash"}} | ||
| 86 | cd /etc/logodidact/ | ||
| 87 | git add . | ||
| 88 | git commit -a -m "Kopano über rev-proxy freigegeben." | ||
| 89 | {{/code}} | ||
| 90 | |||
| 91 | |||
| 92 | ==== Kopano für Benutzer aktivieren ==== | ||
| 93 | |||
| 94 | Aktivieren Sie nun über die LogoDIDACT Console (LDC) welche Benutzer ein Kopano-Konto erhalten sollen. | ||
| 95 | |||
| 96 | 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. | ||
| 97 | |||
| 98 | |||
| 99 | [[image:grafik.png]] | ||
| 100 | |||
| 101 | |||
| 102 | [[image:grafik.png]] | ||
| 103 | |||
| 104 | |||
| 105 | ==== Benutzerkonto Admin zum Kopano-Admin ernennen ==== | ||
| 106 | |||
| 107 | Laden Sie sich folgendes Skript im (% style="color:#2980b9" %)Logosrv-LXC(%%) herunter, um den Admin aus dem ldap zum Kopano-Admin zu bestimmen. | ||
| 108 | |||
| 109 | {{code}} | ||
| 110 | curl -k "https://files.sbe.de/kopano/set-kopano-admin.sh" -o /root/set-kopano-admin.sh | ||
| 111 | {{/code}} | ||
| 112 | |||
| 113 | Führen Sie das heruntergeladene Skript aus | ||
| 114 | |||
| 115 | {{code}} | ||
| 116 | bash /root/set-kopano-admin.sh | ||
| 117 | {{/code}} | ||
| 118 | |||
| 119 | |||
| 120 | ==== Lokalisierte Kopano Postfächer ==== | ||
| 121 | |||
| 122 | 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. | ||
| 123 | |||
| 124 | {{code}} | ||
| 125 | apt install kopano-python-utils | ||
| 126 | |||
| 127 | {{/code}} | ||
| 128 | |||
| 129 | Führen Sie den Befehl wie folgt aus, um die Sprache für einen einzelnen Benutzer (hier: demo1) auf Deutsch zu stellen | ||
| 130 | |||
| 131 | {{code}} | ||
| 132 | kopano-localize-folders -u demo1 --lang de_DE.UTF-8 | ||
| 133 | {{/code}} | ||
| 134 | |||
| 135 | (% id="cke_bm_805S" style="display:none" %) (%%)Mit folgender Schleife können Sie die Lokalisierung für alle Kopano-Benutzer am Server durchführen | ||
| 136 | |||
| 137 | {{code}} | ||
| 138 | kopano-admin -l | tail -n +5 | head -n -1 | awk '{print $1}' | while read Username; | ||
| 139 | do | ||
| 140 | [ ! -z "$Username" ] && kopano-localize-folders -u $Username --lang de_DE.UTF-8; | ||
| 141 | done | ||
| 142 | {{/code}} | ||
| 143 | |||
| 144 | |||
| 145 | ==== Optional: weitere Installations-Pakete für Kopano im logosrv bereitstellen ==== | ||
| 146 | |||
| 147 | 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. | ||
| 148 | |||
| 149 | {{code language="bash"}} | ||
| 150 | aptitude install ld-kopano-ol-extension ld-kopano-deskapp-windows-32bit | ||
| 151 | {{/code}} | ||
| 152 | |||
| 153 | Die Setup-Dateien liegen anschießend im Netzlaufwerk (% style="color:#2980b9" %)**P:\Install\Kopano\**(%%) zur Installation an Clients abgespeichert. | ||
| 154 | |||
| 155 | |||
| 156 | ==== Optional: Kopano WebApp im Internet freischalten ==== | ||
| 157 | |||
| 158 | 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. |