software:citadel-administration

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen Revision Vorhergehende Überarbeitung
Nächste Überarbeitung		 Vorhergehende Überarbeitung
software:citadel-administration [2009/08/25 12:09] – stsoftware:citadel-administration [2012/02/06 22:29] (aktuell) – st
Zeile 1: Zeile 1:
 +====== Citadel Groupware Administration ======
  
 +
 +===== Installation =====
 +
 +==== Debian Lenny ====
 +
 +Für [[http://www.citadel.org/doku.php/installation:debian|Debian i386 and amd64 gibt es vorgefertigte Pakete]] eine [[http://debian.citadel.org/|Anleitung findet sich hier]].
 +
 +<code bash>
 +nano /etc/apt/sources.list
 +</code>
 +und die folgenden Zeile eintragen
 +<file>
 +deb http://debian.citadel.org/debian/ lenny main 
 +</file>
 +<code bash>
 +aptitude update
 +aptitude install citadel-suite
 +</code>
 +
 +Bei der Installation wird nach dem Einrichten eines Webservers gefragt. Dazu kann man Apache konfigurieren lassen oder einen eigenen Webserver auf Port 8504 (standardmäßig) einrichten lassen.
 +
 +
 +===== Konfiguration =====
 +
 +Standardmäßig öffnet citadel eine Menge Ports:
 +
 +^ Port (Dienst) ^ Aufgabe ^
 +| 25 (SMTP) + 587 (submission: SMTP MSA) | SMTP nimmt eMails externe Benutzer an, SMTP MSA nur Nachrichten berechtigter Nutzer |
 +| 110 (POP3) + 995 (pop3s) | eMail-Abruf |
 +| 143 (imap) + 993 (imaps) | eMail-Abruf |
 +| 465 | ? |
 +| 504 (citadel-Port) | Replikation |
 +| 2020 | ManageSieve-Server-Port (Filter auf dem Server) |
 +| 5222 (xmpp-client) | Jabber |
 +| 443 (SSL) + 8504 | Webmail, kann auch auf Port 80 o.ä- konfiguriert sein. |
 +
 +Die Konfiguration und Benutzung kann auch über die Shell erfolgen (Befehl: ''citadel'').
 +
 +==== Nachrichten ====
 +Die Nachrichten (Begrüßung, Verabschiedung, ...) lassen sich im Ordner ''/usr/share/citadel-server/messages/'' anpassen.
 +
 +==== Replikation ====
 +Die Replikation setzt lediglich vorraus, das sich Partner von Zeit zu Zeit verständigen können. Dabei werden allerdings für Räume repliziert, die eMail-Ordner der Benutzer sind dabei nicht enthalten.
 +
 +:!: Die Namen der Server (node names) sollten sinnvoll und sorgfältig geplant werden, eine spätere Änderung erfordert die Anpassung der Adressbücher aller Benutzer auf diesem Server. 
 +
 +Für die Einrichtung der Replikationsfunktion benötigt man
 +  - den Node Name
 +  - die IP oder den FQDN des andere Servers
 +  - eine shared secret auf beiden Maschinen.
 +
 +Die Pfade für die Replikation werden selbsterlernt, etwa wenn ein Server nur über eine Zwischenstation erreicht werden kann.
 +
 +
 +==== Räume freigeben ====
 +Aus Performancegründen sollte man nur wirklich global benötigte Räume freigeben, z.B. einen Raum "Ankündigungen". Diese kann Uni oder Bi-direktional freigegeben werden, wenn also beide Standorte die jeweils anderen Nachrichten erhalten wollen, muss auf beiden Servern freigegeben werden.
 +
 +
 +==== SMS-Benachrichtigungen ====
 +In der Konfiguration wird leider bei den Push-Mail Einstellungen "External pager tool" mit "Externe Pager-Server URL" übersetzt. FIXME
 +
 +Als Zusatzprogramm ist [[http://www.citadel.org/doku.php/installation:calendar.paging.script|Calendar Paging]] interessant: Hier werden Benutzer bei neuen Terminen benachrichtigt.
 +
 +
 +==== Aliase ====
 +
 +Internet-Aliase können einfach in die vcard des Benutzers eingetragen werden (Verwaltung -> Benutzer anlegen/bearbeiten). 
 +
 +siehe [[http://www.citadel.org/doku.php/faq:systemadmin:how_do_i_configure_email_aliases_for_a_user|How do I configure email aliases for a user?]].
 +
 +
 +==== SSL-Zertifikat ====
 +
 +Die SSL-Schlüssel kommen unter dem Dateinamen ''citadel.cer'' (öffentlicher Schlüssel) und ''citadel.key'' (privater Schlüssel) in die Ordner
 +
 +  * /etc/ssl/webcit
 +  * /etc/ssl/citadel
 +
 +
 +===== Diagnose =====
 +
 +
 +  * Netzwerkverkehr zwischen Webcit und Citadel mitschneiden: <code>tcpdump -w webcit.pcap -i lo</code>
 +
 +
 +==== Citadel mit Debugging-Fähigkeiten bauen ====
 +
 +Vorraussetzungen: Debian (hier: Etch), Citadel aus deb-Paketquelle.
 +
 +Relevante Doku:
 +  * [[http://www.citadel.org/doku.php/faq:mastering_your_os:gdb#debugging|Debugging]]
 +  * [[http://www.citadel.org/doku.php/faq:installation:compile_debs|How Do I Compile The .debs From Source?]]
 +
 +
 +Am Beispiel der Version 7.66: 
 +
 +
 +**Vorbereitungen**:
 +  *  dpkg-dev muss installiert sein (aptitude install dpkg-dev).
 +  * in der /etc/apt/sources.list muss diese Zeile vorhanden sein: <file>deb-src http://debian.citadel.org/source stable source</file>
 +
 +
 +
 +  - mkdir tmp
 +  - cd tmp
 +  - Source-Paket mit folgendem Befehl herunterladen: <code>apt-get source citadel-server</code>
 +  - <code>cd /citadel-7.66/debian</code>
 +  - <code>nano rules</code>
 +  - die Zeile #to enable debugging: export DEB_BUILD_OPTIONS="debug profiling threadoff" durch Zeilenumbruch aktivieren:<file>#to enable debugging:
 +export DEB_BUILD_OPTIONS="debug profiling threadoff"
 +</file>
 +  - abspeichern ("STRG-X" und "J")
 +  - cd ..
 +  - Das Paket muss neu gebaut werden: <code>dpkg-buildpackage</code>
 +    - Falls gleich eine Fehlermeldung wegen fehlender Abhängigkeiten kommt: <file>dpkg-checkbuilddeps: Nicht erfüllte Bauabhängigkeiten: debhelper (>= 4) po-debconf bison autotools-dev libdb-dev libical-dev (>= 0.43) libldap2-dev libncurses5-dev libpam0g-dev libsieve2-dev libssl-dev libexpat1-dev libcitadel-dev (>= 7.42) libcurl4-openssl-dev | libcurl3-openssl-dev zlib1g-dev
 +
 +</file>also alle diese Pakete nachinstallieren (evtl. ist später libcurl4-openssl-dev statt libcurl3-openssl-dev nötig): <code>aptitude install debhelper po-debconf bison autotools-dev libdb-dev libical-dev libldap2-dev libncurses5-dev libpam0g-dev libsieve2-dev libssl-dev libexpat1-dev libcitadel-dev libcurl3-openssl-dev zlib1g-dev
 +</code>
 +  - erneut dpkg-buildpackage aufrufen
 +    - erneut fehlt ein Paket (berkley-db): <file>dpkg-checkbuilddeps: Nicht erfüllte Bauabhängigkeiten: libdb-dev</file>
 +    - "libdb-dev" ist ein virtuelles Paket, das bereitgestellt wird von: libdb4.4-dev libdb4.3-dev libdb4.2-dev libdb3-dev 
 +    - ich nehme libdb4.4: <code>aptitude install libdb4.4-dev</code>
 +
 +  - cd ..
 +  - Nun können wir das Paket Installieren (Dateinamen werden bei anderen Versionen anders lauten, auf Meldung am Ende des "dpkg-buildpackage"-Aufrufs achten!): <code>dpkg -i citadel-suite_7.66-86_all.deb citadel-common_7.66-86_all.deb citadel-doc_7.66-86_all.deb</code>
 +
 +
 +===== Debian Programmers =====
 +
 +
 +http://www.citadel.org/doku.php/installation:sourcecode
 +http://www.citadel.org/doku.php/faq:installation:compile_debs
 +
 +<code bash>
 +aptitude install build-essential curl g++ gettext shared-mime-info libssl-dev gnome-icon-theme
 +aptitude install libcitadel-dev quilt 
 +./bootstrap
 +./buildpackages debian
 +</code>
 +
 +
 +==== Sourcecode from debian-package ====
 +
 +<code bash>
 +apt-get source webcit
 +chmod +x *.sh
 +chmod +x bootstrap buildpackages get_ical_data.sed
 +</code>