[[Vorlage(Getestet, bionic)]] [[Vorlage(Fortgeschritten)]] {{{#!vorlage Wissen [:Pakete_installieren: Installation von Programmen] [:Terminal: Ein Terminal öffnen] [:Editor: Einen Editor öffnen] }}} [[Inhaltsverzeichnis()]] [[Bild(citadellogo,, align=left)]] [http://www.citadel.org/ Citadel] {en} ist eine freie [wikipedia:Groupware:]-Lösung. Mit Citadel ist es möglich, Kalenderdaten, Adressen, Notizen und E-Mails auf einem Server über eine moderne, mehrsprachige Web-Oberfläche mit einem Browser zu verwalten. Darüber hinaus sind praktische Extras wie ein Chat oder die Unterstützung von OpenID (ab Version 7.37) integriert. Besonders nützlich ist die E-Mail-Funktion. Mit ihr kann man innerhalb weniger Minuten einen eigenen E-Mail-Server aufsetzen, der auch E-Mails von anderen Dienstleistern abrufen bzw. einsammeln kann. Das Programm hat seine Wurzel in "Bulletin-Board-Systemen" (BBS) der 90er Jahre, den Vorläufern heutiger Webforen. Das Programm unterteilt einzelne Bereiche in sogenannte "Räume" (ursprünglich "Chat Rooms"). Nicht jeder Raum muss öffentlich sein, so ist z.B. der eigene Posteingang logischerweise ein privater Raum. Diese Aufteilung spiegelt sich in der Verwaltung des Systems wieder und ist - nach einer kurzen Eingewöhnungsphase - relativ einfach und intuitiv. Der vielleicht entscheidende Vorteil gegenüber anderen Groupware-Lösungen: da bereits alle benötigten Komponenten enthalten sind, kann auf die Installation separater [:Serverdienste:] wie [:Apache:], [:Postfix:] oder [:MySQL:] verzichtet werden (was die Nutzung dieser Dienste aber nicht grundsätzlich ausschließt). {{{#!vorlage Hinweis Die Weboberfläche war sehr "wählerisch", was den eingesetzten Browser angeht. Der Internet Explorer von Windows wurde beispielsweise nicht unterstützt. Empfehlenswerte und getestete Programme sind im Abschnitt [#Browser Browser] aufgeführt. }}} = Installation = [[Bild(Wiki/Icons/synaptic.png, 48, align=right)]] Citadel ist in den offiziellen Paketquellen enthalten. Für ein Testsystem kann folgendes Metapaket installiert [1] werden: {{{#!vorlage Paketinstallation citadel-suite, universe }}} Wer dagegen einen Server einrichten will, braucht nur die Pakete: {{{#!vorlage Paketinstallation citadel-server, universe citadel-mta, universe, Mail Transport Agent citadel-webcit, universe, Weboberfläche }}} Während der Installation werden einige Dinge abgefragt. Die folgende Tabelle bietet eine Überblick. {{{#!vorlage Warnung Die hier beschriebenen Voreinstellungen beziehen sich auf eine Installation auf einem System ohne Apache, PHP, MySQL oder einer anderen Groupware-Installation. Ansonsten sollten die Standardports für `http://` und `https://` in Citadel geändert werden, damit sie nicht mit bereits benutzten Ports kollidieren (beispielsweise auf `8000` und `44300`). }}} ||<-3 rowclass="titel"> Fragen und Antworten bei der Installation || || || Frage || Erläuterung || || 1. || IP-Adresse || Unter welcher IP-Adresse soll der Server erreichbar sein? Frei wählbar, Vorgabe: `0.0.0.0` (beim Erstkontakt mit Citadel empfohlen) || || 2. || externer Authentifizierungsmodus || Zur Auswahl stehen ''intern'' (eigene Benutzerverwaltung) oder ''extern'' (via `/etc/passwd` oder LDAP). Vorgabe: `nein` (=intern) || || 3. || Benutzername des Citadel-Administrators || Nur bei interner Benutzerverwaltung frei wählbar. Vorgabe: `admin`. || || 4. || Administrator-Passwort|| frei wählbar || || 5. || Integration mit Apache-Webservern || Welcher Webserver soll genutzt werden? Zur Auswahl stehen Apache und intern. || || 6. || HTTP-Port von WebCit || Frei wählbar, Vorgabe: `80` ([wikipedia:Internet_Assigned_Numbers_Authority:IANA]-Standardport: `504`) || || 7. || HTTPS-Port von WebCit || Frei wählbar, Vorgabe: `443` || || 8. || Sprache des WebCit-Servers || Sprachauswahl bei der Anmeldung einschränken. Zur Verfügung stehen neben Deutsch und Englisch weitere Sprachen. Benutzerdefiniert überlässt dem Benutzer bei der Anmeldung die Wahl. || Falls man aus Versehen eine falsche Antwort gegeben hat, kann man die Fragen 1-4 mit {{{#!vorlage Befehl sudo dpkg-reconfigure citadel-server }}} und die Fragen 5-8 mit {{{#!vorlage Befehl sudo dpkg-reconfigure citadel-webcit }}} erneut aufrufen. Zusätzlich werden ein Benutzer und eine Gruppe `citadel` auf dem System angelegt. == Manuell == Alternativ kann eine manuelle Installation durchgeführt werden. Besonders bequem gelingt dies mit [http://www.citadel.org/doku.php/installation:easyinstall:easyinstall Easy Install] {en}. Hiermit wird Citadel mitsamt Webcit installiert. Für die manuelle Installation mit EasyInstall wird zlib benötigt. Dies kann man, wenn nicht installiert, über das folgende Paket installieren: {{{#!vorlage Paketinstallation zlib1g-dev }}} = Konfiguration = [[Bild(./citadel_login.jpg, 220, right)]] Wenn bei der Installation (siehe oben) nichts anderes ausgewählt wurde, erreicht man die Weboberfläche "WebCit" über einen Browser folgendermaßen: * `http://` oder verschlüsselt (ein "self-signed"-Zertifikat wird während der Installation erstellt): * `https://` Bei einer lokalen Testinstallation bzw. direkt auf dem Server funktionieren auch: * `http://localhost und https://localhost` Ansonsten noch die verwendete Portnummer (`:Port`) an die Adresse anhängen. Es erscheint eine Anmeldung, bei der man während der Installation angegebenen Administrator-Benutzernamen verwendet. Empfehlenswert ist nun - neben den nachfolgend beschriebenen Schritten - die Lektüre von [http://www.citadel.org/doku.php?id=documentation:system_administration_manual] {en} und der [http://www.citadel.org/doku.php/faq:start FAQ] {en}. == Passwort == Falls nicht bereits während der Installation geschehen, wird als erster wichtiger Schritt ein Administrator-Kennwort vergeben: * ''"Erweitert -> Ändern Sie Ihr Passwort"'' == Serverdienst steuern == Nach einer Neukonfiguration sollte der Server neu gestartet werden. Obwohl diese Funktion auch über die interne Verwaltungsoberfläche verfügbar ist, werden [:Serverdienste:] traditionell über die Kommandozeile bedient. Die möglichen Optionen liefert der Befehl: {{{#!vorlage Befehl sudo service citadel }}} == Benutzer-Anmeldung == Als nächstes sollte man die Funktion, dass Benutzer sich selbst (auf dem Anmeldeportal) registrieren können, deaktivieren. Nur wenn man wirklich möchte, dass sich Benutzer frei anmelden können, kann die Funktion aktiviert bleiben - dieses sollte mit Vorsicht genossen werden. Zum Deaktivieren geht man unter: * ''"Verwaltung -> Systemvorgaben bearbeiten -> Zugang"'' Hier wird ein Haken bei ''"Erzeugen von Accounts am Anmeldeportal verbieten"'' gesetzt. == Benutzer-Verwaltung == Falls man die interne Benutzerverwaltung verwendet, können die notwendigen Funktionen über * ''"Verwaltung -> Benutzer bearbeiten/löschen/anlegen"'' gefunden werden. [[Bild(citadelerweitert.png, 320, align=right)]] == Banner einrichten == Auf dem Anmeldebildschirm können eigene Informationen oder Hinweise untergebracht werden. Die entsprechende Dateien befinden sich im Ordner '''/etc/citadel/messages/''' und können nur mit [:sudo:Root-Rechten] eingesehen und geändert werden. == Design ändern == Um das Design der Weboberfläche zu ändern, editiert [3] man die Datei '''/usr/share/citadel-webcit/static.local/webcit.css''' mit [:sudo:Root-Rechten]. HTML- bzw. CSS-Kenntnisse werden vorausgesetzt (siehe auch [http://www.citadel.org/doku.php?id=documentation:webcit:start Customizing WebCit] {en}). Anschließend muss man den WebCit-Server neu starten. = Benutzung = Prinzipiell findet die Kommunikation mit dem Citadel-Server über die Weboberfläche "WebCit" statt. Unabhängig davon lassen sich E-Mails mit jedem beliebigen E-Mail-Client abrufen. Für Kommandozeilen-Nutzer steht mit dem Paket '''citadel-client''' ein eigener Textmodus zur Verfügung. == Browser == Die Weboberfläche verwendet für optimalen Benutzerkomfort neben DOM, JavaScript und CSS intensiv AJAX. Während der Entwicklung getestete und __empfohlene__ Browser: * [:Firefox:] 3.0+ * [:Opera:] 9.5+ * [:Chromium: Chromium bzw. Google Chrome] (oder andere moderne, auf Webkit basierende [:Internetanwendungen#Webbrowser:Browser]) * Safari 3.0+ Anmerkung: das + hinter der Version steht für "oder neuer". Ältere Versionen können Probleme bereiten. == externe E-Mail-Programme == ##aasche: SMTP moeglich? wie funktioniert der Postausgang? {{{#!vorlage Hinweis Das Versenden von E-Mails ins Internet erfordert unter Umständen einen registrierten Domainnamen (FQDN), da ansonsten heutzutage viele Provider-Mailserver von einem Spamversuch ausgehen und den Weitertransport blockieren. }}} Statt der Weboberfläche können auch externe E-Mail-Programme zur Kommunikation mit dem Citadel-Server eingesetzt werden. Als Posteingangs- und Postausgangsserver wird der Citadel-Server angegeben, als Typ ''"IMAP"''. Benutzername und Passwort entsprechen den in Citadel hinterlegten Daten. Auch eine verschlüsselte Verbindung über SSL ist möglich. Weitere Details sind in der Dokumentation unter [http://www.citadel.org/doku.php/doku.php?id=faq:start#gettingfavoriteclientsworking Getting Favorite Clients Working] {en} nachzulesen. == E-Mail-Sammeldienst == Das Abrufen von E-Mail-Konten bei anderen Dienstleistern ("Providern") erfolgt über POP3. Zur Konfiguration wählt man im Hauptmenü links zuerst ''"Posteingang"'', dann direkt ''"Erweitert"'' aus. Unterhalb von ''"Erweiterte Raum-Kommandos"'' jetzt ''"Diesen Raum bearbeiten oder löschen"'' und dann die entsprechenden Daten bei ''"Sammeldienste"'' eintragen. == Kalender == In Kombination mit [http://www.citadel.org/doku.php?id=faq:favoriteclient:groupdav_urls#how.do.i.use.citadel.s.calendar.address.book.etc.from.korganizer.or.other.groupdav.client GroupDAV] {en} und geeigneten Client-Programmen lassen sich Kalenderdaten ([wikipedia:iCalendar:]) auch extern nutzen und teilen. = Problemlösungen = == Weboberfläche auf Englisch == Sollte WebCit auf englisch sein, fehlen vermutlich die deutschen Sprachpakete auf dem eigenen Rechner: {{{#!vorlage Paketinstallation language-pack-de language-pack-de-base }}} Wem das immer noch nicht hilft, findet in der [http://www.citadel.org/doku.php?id=faq:troubleshooting:webcit_built_successfull_with_locale_support_but_it_s_nailed_to_one#webcit.built.successfull.with.locale.support.but.it.s.nailed.to.one FAQ] {en} weitere Lösungsansätze. = Links = * [wikipedia:Citadel/UX:Citadel] - Wikipedia * [http://www.citadel.org/ Projektseite] {en} * [http://www.citadel.org/doku.php/doku.php?id=documentation:start Dokumentation] {en} und [http://www.citadel.org/doku.php/doku.php?id=faq:start FAQ] {en} * [http://www.citadel.org/doku.php/doku.php?id=mailing_lists Support] {en} - Mailinglisten * [http://www.citadel.org/doku.php?id=installation:themes Themes] {en} - bisher nur eins * [https://translations.launchpad.net/citadel/trunk Übersetzerteam auf Launchpad] {en} * [:Serverdienste:] {Übersicht} Übersichtsseite # tag: Netzwerk, Internet, Server, Groupware