Hallo liebe Leser,

ich habe mich noch ein bisschen mit UDEV beschäftigt, um das Automounting meiner externen Festplatte an der SLUG zu realisieren. Hintergrund ist folgender:

• Die Festplatte ist nicht immer an der SLUG angeschlossen (Strom sparen und Platte vor Verschleiß schützen).
• Die SLUG soll später mal dauerhaft als VPN- und Jabber-Server laufen.
• Beim Anschluss der Festplatte soll diese gemounted und der Samba-Dämon gestartet werden.
• Bei einmaligem Tastendruck soll die Festplatte je nach Mount-Status unmounted oder neu gemounted werden. Gleiches gilt für den Samba-Dämon.
• Zweimaliger Tastendruck fährt die SLUG herunter.
• NFS wird nicht realisiert, da es zu einem sehr langem Bootvorgang führt und danach trotzdem nicht richtig funktioniert, falls die Festplatte schon beim Start angeschlossen ist.

Also, zum Start braucht man erst einmal mehrere Bash-Skripte und Anpassungen in der inittab und in den UDEV Regeln:

Mount-Skript:

Hier wird versucht, die externe Festplatte zu mounten und bei Erfolg den Samba-Dämon zu starten. Zusätzlich wird noch das LED für Disk 2 zuerst blinkend und am Ende auf an geschaltet. Die Datei habe ich unter dem Namen „/usr/bin/mybookMountAndStartServices“ abgelegt. Sie soll bei jedem einzelnen Tastendruck ausgeführt werden, wenn die externe Festplatte nicht gemounted ist.

#!/bin/sh
LOGFILE="/var/log/exthddmount.log"
THIS="mybookMountAndStartServices"
MOUNTDIR="/mnt/MyBook"

# set led 2 to flashing state
leds disk-2 flash

# try to mount
echo "$THIS Try to mount MyBook" >> $LOGFILE
mount $MOUNTDIR

# check mount status
if [ $? == 0 ]
then   echo "$THIS MyBook was mounted. Try to start services." >> $LOGFILE
else    cat /etc/mtab | grep $MOUNTDIR > /dev/null
if [ $? == 0 ]
then  echo "$THIS MyBook is already mounted. Try to start services" >> $LOGFILE
else   echo "$THIS MyBook is not connected or an error occured on mount" >> $LOGFILE
exit 1
fi
fi

# start samba service
sh /etc/init.d/samba start

# set led 2 to on
leds disk-2 on

leds beep -r 1

Umount-Skript:

Das gleiche Skript, nur anders herum. Services werden gestoppt, die Festplatte wird unmounted. Gespeichert wird die File unter „/usr/bin/mybookUmountAndStopServices“.

#!/bin/sh
LOGFILE="/var/log/exthddmount.log"
THIS="mybookUmountAndStopServices"
MOUNTDIR="/mnt/MyBook"

# stop samba service
sh /etc/init.d/samba stop
echo "$THIS Stopped all services" >> $LOGFILE

# umount MyBook
echo "$THIS Umounting MyBook..." >> $LOGFILE
umount $MOUNTDIR
echo "$THIS Umounted MyBook. No you can disconnect it" >> $LOGFILE

# set led 2 to flashing state
leds disk-2 off
leds beep -r 2

Ausführung bei Tastendruck – Inittab:

„Das ist natürlich schön und gut, aber wie und wann werden die Skripte ausgeführt?“ wird sich jetzt mancher denken. Über die Datei „/etc/inittab“ festgelegt werden, was bei der Tastenkombination STRG+ALT+ENTF passiert. Bei der SLUG entspricht dies einem einmaligem Tastendruck. In der Inittab muss die Zeile für den Tastendruck, die ungefähr wie folgende aussieht

ca:12345:ctrlaltdel:/sbin/shutdown -t1 -a -r now

durch folgenden Code ersetzt werden:

ca:12345:ctrlaltdel:/usr/bin/buttonPressControl &

Das Skript, welches hier aufgerufen wird, beschreibe ich im nächsten Abschnitt. Das „&“ am Ende der Zeile ist sehr wichtig.

Tastendruck-Kontrolle:

Die Skripte zum Mount bzw. Umount habe ich schon beschrieben, aber woher weiß die SLUG, welches beim Tastendruck ausgeführt werden soll? Und wie kann man einen zweimaligen Tastendruck erkennen? Ich habe deswegen ein weiteres Skript entworfen, welches sich darum kümmert und das bei jedem Tastendruck aufgerufen wird. Die Erkennung des zweimaligem Tastendrucks ist vielleicht nicht ganz sauber gelöst, aber mir ist auf Anhieb nichts besseres eingefallen.

#!/bin/sh

LOGFILE="/var/log/exthddmount.log"
EXT_HDD_DEV="/dev/mybook"
PIDFILE="/tmp/exthddmount.pid"
THIS="buttonPressControl"

touch $LOGFILE

if [ -e $PIDFILE ]
then
 rm $PIDFILE
 echo "$THIS Pressed a second time within 2 seconds. Shutdown system" >> $LOGFILE
 leds beep -f 800 -r 3 -l80 -d 40
 /sbin/shutdown -t1 -a -h now
else
 # create pid file
 touch $PIDFILE
 sleep 2

 if [ -e $PIDFILE ]
 then
 # beep to indicate start
 leds beep -f 700 -r 2 -l 80 -d 40

 # check if mounted
 cat /etc/mtab | grep /mnt/MyBook > /dev/null
 if [ $? == 0 ]
 then
 # already mounted, now umount and stop services
 sh /usr/bin/mybookUmountAndStopServices
 else
 # not mounted, check if connected
 if [ -e $EXT_HDD_DEV ]
 then
 # connected, but not mounted. Mount now
 sh /usr/bin/mybookMountAndStartServices
 else
 # not connected, do nothing
 echo "$THIS No MyBook connected. Do nothing." >> $LOGFILE
 fi
 fi
 rm $PIDFILE
 fi
fi

UDEV-Regel:

Was fehlt noch? Genau, eine UDEV-Regel, die das Mount-Skript auch bei Systemstart und beim Anschließen der Festplatte ausführt. Damit diese Regel zum Ende erst geprüft wird, habe ich sie „z70-exthddmount.rules“ genannt und in „/etc/udev/rules.d“ abgelegt.

BUS=="usb", KERNEL=="sd?1", SYSFS{serial}=="57442D574341554630363532373631", SYMLINK="mybook", RUN+="/usr/bin/mybookMountAndStartServices"

Dieser Code muss in einer Zeile stehen! Die eindeutige Seriennummer der externen Festplatte erhält man mit dem Programm lsusb:

SLUG:#lsusb -v | egrep "(iProduct | iSerial)"

iProduct                2 OHCI Host Controller
 iSerial                 1 0000:00:01.0
 iProduct                2 OHCI Host Controller
 iSerial                 1 0000:00:01.1
 iProduct                2 U3 Cruzer Micro
 iSerial                 3 08759111AD8169DA
 iProduct                2 EHCI Host Controller
 iSerial                 1 0000:00:01.2
 iProduct                2 My Book
 iSerial                 3 57442D574341554630363532373631

Die unteren beiden Zeilen stehen für meine externe Festplatte. Wer kein MyBook besitzt, muss natürlich nach der Bezeichnung seiner Festplatte suchen.

Fazit:

So das sind alle notwendigen Skripte, um das Automounting zu realisieren. Wenn alle Skripte vorhanden und angepasst sind, sollte die SLUG neu gestartet werden, um die Inittab und die UDEV-Regeln neu zu initialisieren. Wie schon angesprochen funktioniert das Mounten beim Start leider nur mit dem Samba-Dämon reibungslos. Bei NFS hängen sich die Startskripte leider auf, wenn beim Systemstart das Mount-Skript mittels UDEV aufgerufen wird. Wahrscheinlich ist der Zeitpunkt zu früh für NFS. Aber wenn jemand  eine Lösung dafür findet, passe ich das gerne noch an.

Der eingebettete Sourcecode wurde mit dem neuen Sourcecode-Plugin für WordPress erstellt. Hier ist noch eine kleine Anleitung dazu.

Dies ist eine Sache, die mich durch jede Linux-Installation gequält hat Wenn mal alles richtig läuft, komme ich auf so Ideen wie z.B. 5.1-Sound. Nur leider erweist sich die Kombination von ALSA und einer internen Nforce 4 Soundkarte als etwas bockig. Seit einigen Jahren schleppe ich deshalb meine Sound-Config durch jede Neuinstallation (Gentoo, Debian, Kubuntu). Nachdem es jetzt unter meinem frischen Kubuntu 09.04 läuft, gibts hier mal die Config.

Diesmal habe ich die Config global für alle Nutzer unter /etc/asound.conf gelegt. Es funktioniert aber genau so, wenn man sie für den vorgesehenen Nutzer in ~/.asoundrc ablegt. Hier nun die Config:

#-------------------------------                                                                                                                                                    
#  Main hardware control                                                                                                                                                            
#-------------------------------                                                                                                                                                    

pcm.nforce {                                                                                                                                                                        
   type hw                                                                                                                                                                         
   card 0                                                                                                                                                                          
   device 0                                                                                                                                                                        
   channels 6                                                                                                                                                                      
   rate 48000                                                                                                                                                                      
   format "S16_LE"                                                                                                                                                                 
}                                                                                                                                                                                   

pcm.softmixer {                                                                                                                                                                     
   type dmix                                                                                                                                                                       
   ipc_key 1024                                                                                                                                                                    
   ipc_key_add_uid false                                                                                                                                                           
   ipc_perm 0660                                                                                                                                                                   
   slave {                                                                                                                                                                         
     pcm nforce                                                                                                                                                                  
     format "S16_LE"                                                                                                                                                             
     channels 6                                                                                                                                                                  
     rate 48000                                                                                                                                                                  
     period_time 0                                                                                                                                                               
     period_size 1024                                                                                                                                                            
     buffer_size 5120                                                                                                                                                            
   }                                                                                                                                                                               
   bindings {                                                                                                                                                                      
     0 0                                                                                                                                                                         
     1 1                                                                                                                                                                         
     2 4                                                                                                                                                                         
     3 5                                                                                                                                                                         
     4 2                                                                                                                                                                         
     5 3                                                                                                                                                                         
   }                                                                                                                                                                               
}                                                                                                                                                                                   

#-------------------------------
#  Recording                    
#-------------------------------

pcm.recording {
   type        dsnoop
   ipc_key     2589  
   slave {           
     pcm     "hw:0,0"
     format  "S16_LE"
   }                   
}                       

#-------------------------------
#  Upmix                        
#-------------------------------
# upmix stereo to 5.1           
pcm.upmix {                     
   type        route           
   slave.pcm   "softmixer"     
   slave.channels    6         
   ttable {                    
     0.0    1                
     0.2    0.75             
     0.4    0.5              
     1.1    1                
     1.3    0.75             
     1.4    0.5              
   }                           
}                               

pcm.upmix40 {
   type        route
   slave.pcm   "softmixer"
   slave.channels    6    
   ttable {               
     0.0    1           
     1.1    1           
     2.2    1           
     3.3    1           
     0.4    0.5         
     1.4    0.5         
   }                      
}                          

pcm.upmix41 {
   type        route
   slave.pcm   "softmixer"
   slave.channels    6    
   ttable {               
     0.0    1           
     1.1    1           
     2.2    1           
     3.3    1           
     0.4    0.5         
     1.4    0.5         
     4.5    1           
   }                      
}                          

pcm.upmix50 {
   type        route
   slave.pcm   "softmixer"
   slave.channels    6    
   ttable {               
     0.0    1           
     1.1    1           
     2.2    1           
     3.3    1           
     4.4    1           
   }                      
}                          

#-------------------------------
#  Downmix                      
#-------------------------------

pcm.downmix71 {
   type        route
   slave.pcm    "softmixer"
   slave.channels    6     
   ttable {                
     0.0    0.67         
     1.1    0.67         
     2.2    0.67         
     3.3    0.67
     4.4    1
     5.5    1
     6.0    0.33
     6.2    0.33
     7.1    0.33
     7.3    0.33
   }
}

#-------------------------------
#  Overwrite existing devices
#-------------------------------

pcm.!default {
   type           asym
   playback.pcm   "plug:upmix"
   capture.pcm    "plug:recording"
}

ctl.!default {
   type hw
   card 0
}

pcm.!front {
   type        plug
   slave.pcm   "upmix"
}

pcm.!surround40 {
   type         plug
   slave.pcm    "upmix40"
}

pcm.!surround41 {
   type         plug
   slave.pcm    "upmix41"
}

pcm.!surround50 {
   type         plug
   slave.pcm    "upmix50"
}

pcm.!surround51 {
   type        plug
   slave.pcm    "softmixer"
}

pcm.!surround71 {
   type         plug
   slave.pcm    "downmix71"
}

pcm.dsp0 {
   type         plug
  slave.pcm    "softmixer"
}

Wichtig ist, dass die Kanäle auch richtig eingesteckt werden. Ansonsten müssen die vertauschten Kanäle im PCM softmix geändert werden. Bis jetzt gab es bei mir keine Blockaden bei Sound-Ausgabe von unterschiedlichen Programmen. Aber wer weiß schon, wo Skype wieder überall reinpfuscht.

Vor einigen Wochen hat mich es mal wieder extrem angekotzt, dass bei meinen verschiedenen Mailkonten Probleme auftraten. Web.de lässt sich nur alle 15 Minuten abfragen, AOL bringt KMail ständig zum Absturz, usw. Außerdem wäre eine automatische Verteilung und Filterung schön, da im Moment alles quer durcheinander auf meinen Konten eingeht. Die Filtermöglichkeiten von KMail gefallen mir nicht wirklich…

Als Lösung habe ich auserkoren, meine SLUG als Mailserver einzurichten, um alle Mails dort zu sammeln und im Netzwerk bereit zu stellen. Versand über die SLUG sollte auch möglich sein.

Der erste Schritt war nun, sich in die Mailserver-Konfiguration unter Linux einzulesen. Hier habe ich schnell gemerkt, dass dies bei weitem nicht trivial ist (für nen Nicht-Admin ). Zu verstehen, wie die verschiedene Programme eines Mailservers funktionieren hat einige Zeitgedauert, die Einrichtung noch länger. Ich fange also mal ganz von vorn an:

Mail Retrieval Agent: Fetchmail

Dieses Program sorgt dafür, dass Emails von einem entferntem Server abgeholt werden können. Diese gibt es an das lokale Linux-Mailsystem oder den Mail Delivery Agent weiter. Mehr tut es nicht. Als Programm habe ich Fetchmail gewählt, da es in vielen Howtos sehr gut beschrieben wird. Für Fetchmail muss man eine Config-Datei namens .fetchmailrc im Home-Verzeichnis anlegen. Meine Config sieht folgendermaßen aus:


# ~/.fetchmailrc
set postmaster<username>
set bouncemail

# Spam account, dont let messages on the server, fetch old and new messages, use SSL
poll pop3.web.de
protocol POP3
port 995
user „XXXXXXX@web.de“ there     #  username on mailserver
with password „XXXXXXX“             # password on mailserver
is XXXXXXX here                               #  local user name
fetchall
ssl
nokeep
mda ‘procmail -fv’                                  # execute procmail
mda „/usr/bin/procmail -d %s“          # execute procmail

# regular account, leave messages on server, fetch only new messages
poll pop.aim.com
protocol POP3
user „XXXXXXX“ there
with password „XXXXXXX“
is XXXXXXX here
keep
nofetchall
mda ‘procmail -fv’
mda „/usr/bin/procmail -d %s“

# regular account, leave messages on server, fetch only new messages, use SSL
poll pop3.t-online.de
protocol POP3
port 995
user „XXXXXXX“ there
with password „XXXXXXX“
is XXXXXXX here
keep
ssl
nofetchall
mda ‘procmail -fv’
mda „/usr/bin/procmail -d %s“

Hier werden von beispielsweise drei Konten Mails abgeholt und an Procmail weitergegeben (siehe nächstes Kapitel). Ein Konto ist mein Spamkonto für Foren, Shopping und Mailing-Lists. Es kann deshalb sehr schnell voll laufen, weshalb hier alle Mails beim Abholen vom Server gelöscht werden. Die beiden anderen Konten lassen zwecks Redundanz die Mails auf dem Server. Die Kommentare geben an, was das Kommando tut bzw. was in XXXXXXX stehen soll.

Mail Delivery Agent: Procmail (optional)

Dieser Schritt ist optional. Mittels Procmail können Mails gefiltert und an IMAP-Ordner verteilt werden. Auch Spamfiltering mittels Spamassassin ist möglich, dies möchte ich meiner SLUG aber nicht antun. Für mich reicht es hingegen, einkommende Mails in verschiedene IMAP-Ordner zu filtern, was mit einfachen regulären Ausdrücken geht. Im Homeverzeichnis muss dazu eine Datei mit Namen .procmailrc angelegt werden. Meine sieht folgendermaßen aus:


# ~/.procmailrc
PATH="/usr/bin:/usr/local/bin"
MAILDIR="$HOME/mails"
DEFAULT="$HOME/mails/<username>"
LOGFILE="$HOME/mails/procmail.log"
SHELL="/bin/sh"
VERBOSE="on"

#########################################################
##### Filter Mailing Lists like BlueCove, OpenMoko
:0:
* ^To:.*bluecove-users@googlegroups\.com
.MailingLists.BlueCove/

:0:
* ^From:.*skarzhevskyy@gmail\.com
.MailingLists.BlueCove/

:0:
* ^Subject:.*\[BlueCove-users\]
.MailingLists.BlueCove/

:0:
* ^CC:.+@lists\.openmoko\.org
.MailingLists.OpenMoko/

:0:
* ^To:.+@lists\.openmoko\.org
.MailingLists.OpenMoko/

##########################################################
##### Filter Online-Shopping like eBay, Amazon: use From field
:0:
* ^From:.*[Aa]mazon.*
* ^From:.*eBay.*
.Filter.Shopping/

###########################################################
##### Filter by Accout: use the To field

:0:
* ^To:.*XXXXXXXXXXXXXXX\.de
.Kontos.T-Online/

:0:
* ^To:.*XXXXXXXXXXXXXXX\.de
.Kontos.Webde/

:0:
* ^To:.*XXXXXXXXXXXXXXX
.Kontos.AOL/

#############################################################
######### Filter all others to INBOX
:0:
./

Hier werden eingehende Mails erst nach Absendern, Mailinglisten, Shops, etc gefiltert und danach je nach Empfänger auf die verschiedenen Ordner auf dem IMAP-Server. Die Punkte und Slashes sind hier sehr wichtig!!! Trennzeichen für IMAP-Ordnerstrukturen ist der Punkt. An jedem IMAP-Ordnereintrag muss unbeding der Slash angehängt werden. XXXXXXX steht hier wieder für den jeweiligen Empfänger.

IMAP-Server: Dovecot

Um es gleich vorweg zu sagen, Dovecot steht nicht für die Exkremente irgendwelcher Zugvögel, sondern für Taubenschlag. Dovecot ist ein performanter und schlanker IMAP-Server und deshalb sehr geeignet für die SLUG. Dovecot lässt sich sehr einfach mit dem Befehl aptitude install dovecot-common dovecot-imapd installieren. Danach muss evtl. noch die Konfigurationsdatei /etc/dovecot/dovecot.conf angepasst werden. Meine enthält folgendes.


# /etc/dovecot/dovecot.conf
protocols = imap # only IMAP
disable_plaintext_auth = no # insecure
ssl_disable = yes # insecure
mail_location = maildir:%h/mails # mail is at mails-dir in home folder
mail_privileged_group = mail
protocol imap {
}
auth default { # authentication on local users
mechanisms = plain
passdb shadow {
}
userdb passwd {
}
user = root
}

Die vorliegende simple Config stellt Dovecot so ein, dass es nur über IMAP erreichbar ist. Die unsicheren Einstellungen für Plaintext Authentication und SSL sind für mein lokales Netzwerk ausreichend, keinesfalls, wenn der Server im Internet sichtbar sein soll. Für Nutzernamen und Passwörter werden die der lokalen User verwendet.

Mail Transfer Agents (nicht notwendig):

Während der Einrichtung des Mailservers bin ich des Öfteren auf Mail Transfer Agents gestoßen. Diese Programme haben den Zweck, vom Mail Retrieval Agent Mails zu erhalten und an die lokalen Unix-Mailkonten zu verteilen. Zusätzlich übernehmen sie den Mailversand über SMTP entweder an lokale Nutzer oder an andere SMTP-Server. Für meine Konfiguration sind diese jedoch nicht notwendig, da Mails automatisch von Procmail verteilt werden und der Versand weiterhin vom Email-Client aus läuft. Grundsätzlich würde der Versand über den lokalen MTA auch funktionieren. Diese würde dann die gesendeten Emails an einen SMTP-Server weiterleiten, falls der Empfänger nicht lokal existiert. Leider blockt jeder Spam-Filter Mails, deren Absender-Adresse nicht mit der Server-Adresse übereinstimmt.

Cron:

Der Cron-Demon ist ein Linux-Programm zur zeitgesteuerten Ausführung von Programmen. Um die Systemlast auf der SLUG gering zu halten, verwende ich den Cron-Demon um in regelmäßigen Abständen Fetchmail auszuführen. Dazu muss eine Crontab erstellt werden, eine Tabelle der auszuführenden Tasks. Die Crontab wird für einen einzelnen Nutzer mittels crontab -e erstellt. Meine sieht folgendermaßen aus:

# crontab, created by "crontab -e" command
# m h dom mon dow command
00 * * * * /usr/bin/getmails --force &> /dev/null
@reboot /usr/bin/getmails --force &> /dev/null

Die erste Zeile lässt jede Stunde das von mir geschriebene Skript getmails laufen (siehe nächstes Kapitel). Die zweite Zeile tut das gleich, jedoch sofort beim Start des Demons. Alle Mails werden nach /dev/null weiter geleitet Ne, natürlich nicht, sondern nur die Standard- und Fehler-Ausgabe. Fehlt die Ausgabeumleitung, so erhält man bei jedem Lauf des Skripts eine Email mit der Ausgabe.

Getmails:

Das von mir geschriebene Bash-Skript /usr/bin/getmails erweitert die Funktionalität von Fetchmail noch ein bisschen. Es erfüllt folgende Aufgaben:

• Emails werden nur abgerufen, wenn auch der Nutzer am IMAP-Server angemeldet ist. Gut für häufige Checks, ohne die Festplatte aufzuwecken. Sie läuft nur an, wenn auch wirklich neue Mails geholt werden.
• Optische Signale mittels Disk-2-LED: Blinken, wenn Skript läuft, langsames Blinken, wenn Mails gefunden, sonst LED aus.
• Akustische Signale: Beep, wenn Mails gefunden.
• –force Option zum Check, auch wenn der Nutzer nicht angemeldet ist
• Ausgaben sollen geloggt werden

Das Skript sieht so aus:

#!/bin/bash
# usage string
USAGE="Usage: getmails.sh [--force]
This script is wrapper for fetchmail. It executes fetchmail only if the executing user is logged on at the IMAP server (dovecot).
If --force parameter is given, check is performed even if user is not connected."

# default led values
RUNNING=flash
MAILFOUND=slow
NOMAILFOUND=off

# set LED
sudo leds disk-2 „$RUNNING“

# set default variables
PARAMS=$#
USERNAME=$(whoami)
FORCE=“false“
LOGFILE=“/home/$USERNAME/mails/lastlog.log“

# check –force parameter
if [ -z "$1" ]
then
FORCE=“false“
else
if [ "$1" == "--force" ]
then
FORCE=“true“
else
echo $USAGE
exit 1
fi
fi

# Check if user is connected to Dovecot
LOGON=$(ps –user „$USERNAME“ | grep „imap“)

# Debug output
echo „Username: $USERNAME“
echo „Force: $FORCE“
echo „Logon: $LOGON“

if [ "$FORCE" == "true" ]
then
echo „Force email check for user $USERNAME“
fetchmail &> „$LOGFILE“
STATUS=$?
else
if [ -z "$LOGON" ]
then
echo „No user logged in, do nothing.“
else
echo „User logged in, checking emails.“
fetchmail &> „$LOGFILE“
STATUS=$?
fi
fi

echo „Status: $STATUS“

if [ "$STATUS" == "0" ]
then
sudo leds beep -f 500 -n
sudo leds disk-2 „$MAILFOUND“
else
sudo leds disk-2 „$NOMAILFOUND“
fi

Das Skript sollte nach Erstellung als nur vom Root editierbar gesetzt werden, um Manipulation zu vermeiden.

Fazit:

Meine jetzige Konfiguration funktioniert nach einigen Wochen Einarbeitung schon sehr gut. Das Skript wird jede Stunde ausgeführt, voher hatte ich einen viertelstündigen Check, was aber die externe Festplatte sehr oft aufgeweckt hat. Jetzt wird sie nur 1x pro Stunde aufgeweckt und ich erhalte gleichzeitig eine sofortige Rückmeldung von der SLUG, so dass ich dann die Mails mit meinem Mailprogramm anschauen kann.

Als nächstes werde ich mir noch den Webmailer Squirrelmail zu gemüte führen, um Mails auch ohne Mailprogramm lesen zu können. Auch VPN wäre nicht schlecht, um auch von entfernten Rechnern (Arbeit, Handy, etc.) darauf zuzugreifen.

Hier noch eine kleine Info-Sammlung über Declarative Services (DS) in Fragment Bundles (FB). Alle folgenden Infos beziehen sich auf Eclipse Equinox.

Grundsätzlich gilt: es funktioniert. Allerdings unterliegen DS in FB einigen Besonderheiten:

• XML-Files: Die Service-Komponenten-Beschreibungen können beliebig im Host- oder Fragment-Bundle abgelegt werden. Sie können beliebige Klassen aus beiden Bundles reservieren, da ja beide zur Laufzeit zu einem Bundle verschmolzen werden und sich den Classpath teilen.
• Manifest-Files: Jetzt die schlechte Nachricht, das Element Service-Component
darf nur in der Manifest-File des Host-Bundles eingetragen sein, im Manifest des Fragments wird es ignoriert. Es können jedoch mehrere Service-Component-Elemente im Host-Manifest „auf Vorrat“ eingetragen werden, wenn man sich dann an den Fehlermeldungen im Log nicht stört.
• Konflikte: Was passiert, wenn man mehrere gleichnamige XML-Files in Host- und Fragmenten liegen, diese aber unterschiedliche Service-Komponenten deklarieren?? Es steht wahrscheinlich in keiner Spezifkation, was dann geschieht, bei Eclipse Equinox passiert folgendes: Es werden zwei eigenständige Service-Komponenten erstellt und gestartet. Es findet keine Überschreibung oder Überlagerung statt. Man kann sich das so vorstellen, als lägen beide in unterschiedlichen Files im gleichen Bundle. Falls es vorkommt, dass die Service-Komponenten einen identischen Namen haben (too much copy-paste ),  so kollidieren sie so wie im Normalfall.

Jeder, der schon einmal selbst einen ANT Task geschrieben hat, kennt das Problem:

Man kann zwar ANT Scripts debuggen (innerhalb von Eclipse), in einen Task kann man aber nicht springen. Falls der Task wegen Fehlern abbricht, sieht man meist nur eine lapidare Fehlermeldung. Eine Hilfe wäre es zwar, Debugmeldungen via sysout auszugeben, schön ist das jedoch nicht.

Abhilfe schafft hier der Java Remote Debugger: Da ANT selbst eine Java-Anwendung ist, kann man diese im Debug-Modus starten. Zusätzlich meldet man diese Anwendung noch an einem Netzwerksocket als Remote Application an. Danach kann man von außen mittels einer eigenen Debugging-Instanz auf die Anwendung zugreifen und auf alle ihrer Breakpoints reagieren. Das folgende Beispiel bezieht sich auf die Eclipse IDE, mit anderen IDEs sollte es aber auch funktionieren.

So, nun das ganze mal als Code:

echo off
set ECLIPSE_HOME=""
set WORKSPACE=""
set PROJECT=""

%ECLIPSE_HOME%\eclipsec.exe -nosplash -data %WORKSPACE%
  -application org.eclipse.ant.core.antRunner
  -buildfile %WORKSPACE%\%PROJECT%\build.xml
  -vmargs -Xdebug -Xnoagent -Djava.compiler=NONE
  -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
echo on

ANT wird via Batch-File als Eclipse-Headless-Application gestartet und bekommt zusätzlich die Parameter für Remote Debugging angegeben (-Xrunjdwp:…). Dann erstellt man in Eclipse eine neue DebugConfiguration und wählt als Typ Remote Java Application. Weitere Parameter müssen nicht verändert werden. Nach dem Start der Batchfile erscheint eine Console mit den Ausgaben der ANT-Anwendung. Wenn nun die DebugConfiguration gestartet wird, hängt diese sich an den Remote Task an. Hat man nun in einem selbst geschriebenen ANT Task einen Breakpoint, so stoppt die Anwendung genau an diesem Punkt und wechselt in die Debug-Perspektive.

Nachdem ich auf der Arbeit ständig damit hantiere, gibts jetzt ne kleine Anleitung bzw. Checkliste für Declarative Services (DS) unter OSGI. Was sind DS? Ganz einfach: Normalerweise müsste man per Hand codieren, welche Services ein OSGI-Bundle anbietet und welche es verwendet. Dadurch entstehen einige Probleme, vor allem muss man sich selbst darum kümmern, was passieren soll, wenn ein Service mal nicht zur Verfügung steht oder sich im Betrieb verabschiedet. Außerdem ist es für einen Außenstehenden oft schwer einzusehen, welche Services das Bundle verwendet bzw. anbietet. Die Ressourcenbelegung ist auch ein Punkt, da die Services sich sofort bei Bundle-Start registrieren und nicht erst, wenn sie benötigt werden. Hier kommen die Declarativen Services ins Spiel. Mit ihnen kann man Services per XML-Datei konfigurieren.

Die folgende Checkliste wurde unter der Verwendung von Eclipse Equinox erstellt.

Checkliste: Was wird für Declarative Services benötigt?

• Die Implementierung der Deklarative Services erfolgt durch das Bundle org.eclipse.equinox.ds. Dieses Bundle muss immer mit geladen werden, bevor die DS verwendet werden können.
• Zusätzlich wird die Klasse ComponentContext aus dem Bundle org.osgi.service.component benötigt.
• Die eigentliche Implementierung des DS erfolgt als sog. Service Component, also einer Klasse, welche den Service (besser gesagt: das Service Interface) implementiert. Im Gegensatz zu einem Activator wird diese nicht abgeleitet oder implementiert eine Interface. Sie muss trotzdem folgende zwei Funktionen enthalten, damit die ServiceComponent funktioniert. Diese Funktionieren ähnlich wie die start und stop Methoden des Bundle-Activators.
  • protected void activate(Component context){…}
  • protected void deactivate(Component context){…}
    
• Eine Konfigurationsdatei in XML: Diese Datei wird üblicherweise in einem Verzeichnis namens OSGI-INF abgelegt, der Dateiname ist beliebig. Die XML-Datei selbst folgt dem hier zu findenden Schema. Wichtig ist hier, dass alle Inhalte der XML-Datei, also Tags, Attribute aber Paket- und Klassennamen richtig geschrieben sind, ansonsten kann die Service Component nicht aktiviert werden.

• Änderung im Manifest-File des Bundles: Füge eine neue Zeile hinzu, der Inhalt ist Service-Component: OSGI-INF/service.xml (wenn die XML-Datei service.xml heißt)

Beispiel:

Hierzu ein kleines Beispiel: Eine ServiceComponent soll erstellt werden, die einen Service mit dem Interface MyServiceInterface bereitstellt. Sie soll außerdem eine Liste von Services des Interface OtherService beinhalten. Dazu bindet sie diesen Service (der auch über eine Service Component realisiert werden muss) mit der cardinality=“1..n“, so dass mindestens ein OtherService vorhanden sein muss, um die Service Component zu aktivieren. Die einzige Funktion in MyServiceInterface gibt die Anzahl der angebundenen OtherService zurück.

Service Interface:

package org.example.ds
import ...
public interface MyServiceInterface {
    int getCount();
}

Implementierungs-Klasse:

package org.example.ds.internal
import ...
public class MyServiceImplementation implements MyServiceInterface {

    private ComponentContext context;
    private List<OtherService> servicelist = new Vector<OtherService>(0);

    protected void activate(ComponentContext context){
        this.context = context;
    }

    protected void deactivate(ComponentContext context){
        this.context = null;
    }

    protected void bindOtherService(OtherService otherservice){
        this.servicelist.add(otherservice)
    }

    protected void unbindOtherService(OtherService otherservice){
        this.servicelist.remove(otherservice)
    }

    public int getCount(){
        return this.servicelist.size();
    }
}

Die XML-Datei im OSGI-INF Ordner:

<?xml version="1.0" encoding="UTF-8"?>
<component name="myServiceComponent">
    <implementation class="org.example.ds.MyServiceImplementation"/>
    <service>
        <provide interface="org.example.ds.MyServiceInterface"/>
    </service>
    <reference
        name="otherservice"
        interface="org.example.ds.OtherService"
        bind="bindOtherService"
        unbind="unbindOtherService"
        cardinality="1..n"
        policy="static"
    />
</component>

Fehlersuche:

• Das Bundle startet, aber die Service Component nicht. Dies kann viele Ursachen haben:
  • Schreibfehler in der Manifest- oder XML-File. Am besten nochmal nachschauen, ob alle Paket- und Klassennamen stimmen.
  • Eine geforderte Referenz ist nicht verfügbar. Untersuche alle Referenzen, ob deren Service Components vollständig gestartet wurden.
  • Eintrag in der Manifest-File fehlt oder ist ungültig. Mein absoluter Lieblings-Fehler
  • Funktionen wie activate/deactivate bzw. bind/unbind fehlen oder sind ungültig.
• NullPointerException oder andere krude Exceptions werden geworfen: Dies kann auftreten, wenn Klassenmember in der activate-Funtion belegt werden. Diese wird nämlich erst dann aufgerufen, wenn alle Referenzen erfüllt sind, also erst nach den bind-Funktionen. Wenn in bind schon auf das Member zugegriffen wird, ist es dann noch null und die NullPointerException wird geworfen.
• Hilfe, ich sehe nicht ob sich irgendwas tut!!!
  • Der Status einer Service Component kann leider nicht einfach über den status-Befehl abgefragt werden, da Service Components ein relativ neues Konzept sind.
  • Eine Service Component meldet ihre Services sofort an der Service Registry an, der Befehl services gibt also keinerlei Aufschluss über den Status ser Service Component.
  • Am besten kann der Lebenszyklus über den Log-Service verfolgt werden, den Equinox mitliefert. Er kann über das Bundle org.eclipse.equinox.log angebunden werden