Beispiel-Konfigurationsdatei  avanti.con

[general]        # Globale Einstellungen
# ACHTUNG: KEINEN KOMMENTAR VOR [general] SETZEN, SONST CRASH!
# Dies ist die Datei "avanti.con". Kommentare beginnen mit Doppelkreuz
# Das Format ist ähnlich einer Windows "INI"-Datei.
# Sections werden in eckige Klammern gesetzt.

port=4949        # Der TCP/IP-Port, unter dem der                 
	# avanti-Server von außen angesprochen 
	# werden kann. Standard: 4949. 


AnonymousAccess=yes # Nur-Lese-Zugriff auch *ohne* Paßwort erlaubt?

loglevel = default # Was soll mitgeloggt werden, was nicht?

	# (Siehe Erklärung unten)


logfile=c:\temp\av.log # Optional
 

                # Wenn "logfile=..." angegeben wird,

                # werden die Log-Meldungen nicht mehr

                # auf den Bildschirm (stderr) sondern in 

                # die angegebene Datei ausgegeben. 

               

                # Sinnvoll insbesondere für den Betrieb
                # als Daemon unter Unix, oder als Systemdienst 
                # unter Windows XP/VISTA/7/8, da in dieser 
                # Betriebsart keine Konsole  existiert, 
                # auf die Meldungen ausgegeben werden könnten.


 


prefork=1 #     Bis auf weiteres stets 1 setzen, sonst Leistungseinbuße

max_cputime = 120 #     ist die Zeit in Millisekunden, die dem acon-Prozeß zugebilligt wird, bevor
                  #      avanti das Warten aufgibt. Wenn man keine abgebrochenen Jobs 
                  #      beobachtet, nicht dran drehen.

IniFileTimeCheck #   Bis auf weiteres wirkungslos



# Nun folgen die einzelnen Datenbanken. 
# Jede Datenbank hat ihre eigene Section.

# Die Datenbank "avdemo".

[avdemo]
directory = c:\allegro\demo2
access = 3         # Berechtigungsstufe für anon. Zugriff (0 .. 3)
konfiguration = a
indexparameter = cat

# Es folgen die zugelassenen Benutzer.  
# Format: "name=PASSWORD:Berechtigungsstufe"
opac=OPAC:0
master=AVANTI:3
admin=ALLEGRO:2

# hier könnte noch eine Datenbank kommen, z.B. "opac"

[opac]
directory = c:\daten\katalog
access = 3
...

Die Loglevel-Einstellung

loglevel = default ## das ist die Standardeinstellung
loglevel = default,io,data ## Standard, plus "io"- und "data"-Events
loglevel = default,!slave ## Standard, aber "slave"-Events weglassen
	## (Das Ausrufungszeichen bedeutet Negation)

loglevel = all,!data,!slave ## alles außer "data" und "slave"

loglevel = none ## gar nichts protokollieren

[2003-09-19 17:23:24] (NOTE) avanti server listening on port 4949
[2003-09-19 17:23:39] (NOTE) <conn 0> opened
[2003-09-19 17:23:39] (SLAVE) <conn 0> slave started (prefork = 5)
[2003-09-19 17:23:39] (SLAVE) <conn 0> forking '/some/where/../bin/acon' (5 times)
[2003-09-19 17:23:50] (SLAVE) <conn 0> job done
[2003-09-19 17:23:56] (SLAVE) <conn 0> job done
[2003-09-19 17:24:49] (SLAVE) <conn 0> slave finished ok
[2003-09-19 17:24:49] (NOTE) <conn 0> closed
[2003-09-19 17:24:54] (NOTE) avanti server shutting down

Aufruf und Funktionstest

• unter Windows über das Startmenü mit Start -> Programme -> avanti -> avanti Server 
• unter Unix über die Shell mit dem Kommando <installationsverzeichnis>/bin/avanti &
  

• Windows: Aufruf über das Startmenü
  
  Start -> Ausführen -> "telnet localhost 4949" eintippen -> OK
  
  Es öffnet sich ein Fenster.
  
  
• Unix: Eingabe des Kommandos
  
  telnet localhost 4949 
  
  Es erscheint die Meldung "Connected to localhost" (oder ähnlich).
  

Installation als Systemdienst (Win XP/Vista/7/8)

Der avanti-Server kann auch als Systemdienst betrieben werden. Der Server wird dann automatisch beim Hochfahren des Rechners gestartet, und läuft im Hintergrund, auch wenn niemand eingeloggt ist - ideal für einen unbewachten Betrieb des Rechners.

Es empfiehlt sich hierfür zunächst, in der Datei avanti.con mittels  logfile=... eine Logdatei anzugeben, da der Server in dieser Betriebsart keine Log-Meldungen auf dem Bildschirm anzeigen kann.

Um das Programm als Systemdienst zu installieren:

• Aufrufen einer cmd Shell als Administrator
• Wechsel in den Ordner, wo avanti.exe liegt, z.B. c:\allegro
• Aufruf : avanti.exe -install c:\allegro
    Dienst ist dann installiert
  

Entfernen des Systemdienstes

Restart des UNIX-Servers

killproc -SIGHUP $AVANTI
pidofproc $AVANTI > /var/run/avanti.pid

Die avanti-Kommandosprache

• Eine avanti-Anfrage (ein "Job") gliedert sich in drei Teile: das Präfix, die eigentliche Befehlssequenz, und das Postfix.
  
  
  • Das Präfix  besteht aus einer einzigen Zeile, die mit einem "&"-Zeichen eingeleitet wird. Danach folgt ein Verzeichnispfad. Er bezieht sich auf den Rechner, auf dem der avanti-Server ausgeführt wird. In diesem Verzeichnis erwartet der avanti-Server u.a. die allegro-Parameterdateien für den Export von Datensätzen sowie auch die CFG-Datei.
    Die Präfixzeile ist optional. Fehlt sie, so werden die Dateien nur im jeweiligen Datenbank-Verzeichnis gesucht.
    
    
  • Es folgt die eigentliche Befehlssequenz  in der FLEX-Makrosprache.
    
    
  • Das Postfix dient zur Datenbankauswahl und besteht aus zwei Zeilen:
    
    
    @ DB=datenbankname ID=user/passwort
    AVANTI:EOJ
    
    
    Die erste Zeile wird mit der Sequenz "@" + Leerzeichen eingeleitet und spezifiziert den Namen der Datenbank, auf die sich der Suchauftrag bezieht. Falls die Datenbank passwortgeschützt ist,  muß dieses Passwort ebenfalls übermittelt werden. Diese Angaben müssen mit denen in der Datei avanti.con übereinstimmen! Die zweite Zeile kennzeichnet das Ende der Anfrage.
    
  
  Ein Beispiel für eine vollständige Anfrage:
  
  
  & c:\allegro\
  find per shakesp?
  xport p e-marc.apr
  download set
  @ DB=avdemo ID=opac/OPAC
  AVANTI:EOJ
  
  
• Die Antwort des avanti-Servers endet immer mit der Sequenz "AVANTI:EOR".  Danach wird die TCP/IP-Verbindung offengehalten, und es kann eine weitere Anfrage gestellt werden. Alternativ kann der Client die Verbindung schließen.

• Wird acon als Konsolprogramm benutzt, genügt die Befehlssequenz.



---


[1]

Das Client-Server-Modell beruht auf einer Trennung der zu erfüllenden Aufgabe (z.B. einer Datenbankrecherche) in zwei Programme: das erste ist der "Kunde" (engl. Client), der den Auftrag vom Benutzer entgegennimmt, und ihn an das zweite Programm den "Dienstleister" (engl. Server) weiterleitet.  Der Server erledigt den Auftrag, und gibt das Resultat an den Client zurück, der das Ergebnis dem Benutzer in geeigneter Form präsentiert.

Da es sich dabei um verschiedene Programme handelt, können sich Server und Client durchaus auf unterschiedlichen Rechnern befinden. Die Weiterleitung der Aufträge geschieht dann über ein Netzwerk (z.B. das Internet), mit einem vorher vereinbarten Kommunikations-Protokoll, hier TCP/IP.


[2]

acon liest eine Anfrage von Standard-Input, schreibt die Antwort nach Standard-Output, und schreibt Log-Meldungen nach Standard-Error. Das Ende der Anfrage wird durch das Dateiende (end-of-file-condition) gekennzeichnet.