ab2admin(1M) (Installation und Verwaltung eines AnswerBook2-Servers)

Installation und Verwaltung eines AnswerBook2-Servers

ab2admin(1M)

Name

ab2admin- Befehlszeilenoberfläche für die Verwaltung von AnswerBook2

SYNOPSIS

/usr/lib/ab2/bin/ab2admin

-h

Befehl

-o

Befehl

Argumente

DESCRIPTION

Der Befehl ab2admin dient als Befehlszeilenoberfläche zur Verwaltung von AnswerBook2-Buchreihendatenbanken und -Dokumenten auf einem bestimmten AnswerBook2-Server. Er ermöglicht die Installation bzw. Deinstallation von AnswerBook1- und AnswerBook2-Buchreihendatenbanken auf einem Server, die Suche nach lokalen Buchreihen sowie die Aktualisierung der Serverdatenbank. Außerdem können Sammlungen und Bücher aufgelistet werden.

Die ab2admin-Serververwaltung umfaßt folgende Funktionen: Anhalten, Starten und erneutes Starten des Servers, Ein- oder Ausschalten der Protokolldateien des Servers sowie Umkehren der Protokolldateien. Der Server kann so konfiguriert werden, daß Links zu Büchern, die auf anderen AnswerBook2-Servern gespeichert sind, aufgelöst werden.

Zudem kann mit ab2admin der Zugriff auf den Server durch Hinzufügen oder Löschen von Benutzern im Benutzerpool kontrolliert werden. Die Zugriffssteuerung kann aktiviert oder deaktiviert werden.

Mit Hilfe von ab2admin kann eine Verbindung zu jedem beliebigen AnswerBook2-Server (lokal oder entfernt) hergestellt werden. Bestimmte Funktionen (wie Stop, Start und Neustart) sind nur für den lokalen AnswerBook2-Server verfügbar. Ist der AnswerBook2-Server durch ein Paßwort geschützt, müssen vor der Ausführung einer Verwaltungsaufgabe Benutzer-ID und Paßwort eingegeben werden.

Um ab2admin interaktiv zu benutzen, geben Sie in der Befehlszeile ab2admin und danach nach Aufforderung die betreffenden Befehle ein. Das Programm kann auch mit Hilfe der Option -o nur über die Befehlszeile ausgeführt werden.

OPTIONS

Folgende Optionen werden unterstützt:

-h [Befehl]: Zeigt allgemeine und spezifische Hilfe zu einem Befehl Hilfe an.
-o Untergeordneter Befehl [ Argumente]: Die unterstützten untergeordneten Befehle sind unten aufgeführt.

Untergeordnete Befehle

Unterstützte untergeordnete Befehle für die Option -o :

access_off [ -m Server] [ -p Server_Port_Nummer ]: Deaktiviert die Protokolldatei für den Serverzugriff.
access_on [ -m Server] [ -p Server_Port_Nummer]: Aktiviert die Protokolldatei für den Serverzugriff.
add_admin -u user_id[ -m Server] [ -p Server_Port_Nummer]: Fügt einen Benutzer der Liste der autorisierten Serververwalter hinzu.
add_coll -d Pfad [ -m Server] [ -p Server_Port_Nummer ]: Fügt Sammlungen aus AnswerBook1 oder AnswerBook2 zu einer bestimmten Datenbank des AnswerBook2-Servers hinzu.
add_server -M Alternativ_Server -P Alternativ_Server_Port_Nummer [ -m Server ] [ -p Server_Port_Nummer ]: Fügt einen alternativen Server zum angegebenen Server hinzu.
auth_off [ -m Server ] [ -p Server_Port_Nummer]: Deaktiviert die Verifikation für die Serververwaltung.
auth_on [ -m Server ] [ -p Server_Port_Nummer]: Aktiviert die Verifikation für die Serververwaltung.
autostart_no [ -m Server ] [ -p Server_Port_Nummer]: Verhindert automatischen Start des AnswerBook2-Servers beim (erneuten) Systemstart.
autostart_yes [ -m Server ] [ -p Server_Port_Nummer]: Bewirkt automatischen Start des AnswerBook2-Servers beim (erneuten) Systemstart.
browser [ -m Server ] [ -p Server_Port_Nummer]: Startet einen Web-Browser für den Zugriff auf die Seiten der AnswerBook2-Verwaltung.
change_password -u admin_id [ -m Server] [ -p Server_Port_Nummer ]: Ändert das Paßwort des autorisierten Verwalters.
del_admin -u user_id [ -m Server] [ -p Server_Port_Nummer ]: Löscht einen Benutzer aus der Liste der autorisierten Serververwalter.
del_coll -t collection_title [ -m Server] [ -p Server_Port_Nummer ]: Löscht Sammlungen von AnswerBook1 oder AnswerBook2 aus einer bestimmten Datenbank des Servers.
del_server -M Alternativ_Server -P Alternativ_Server_Port_Nummer [ -m Server] [ -p Server_Port_Nummer]: Löscht zusätzlichen Server aus der Serverliste für den angegebenen Server.
error_off [ -m Server ] [ -p Server_Port_Nummer]: Deaktiviert die Fehlerprotokolldatei des Servers.
error_on [ -m Server ] [ -p Server_Port_Nummer]: Aktiviert die Fehlerprotokolldatei des Servers.
help [ Befehl]: Listet alle Informationen zu einem bestimmten Befehl oder zu allen Befehlen auf.
list [ -m Server ] [ -p Server_Port_Nummer]: Listet die auf dem festgelegten Server verfügbaren AnswerBook1- und AnswerBook2-Sammlungen auf. Diese Liste umfaßt die in den Sammlungen enthaltenen Bücher.
list_server [ -m Server ] [ -p Server_Port_Nummer]: Listet alle für den festgelegten Server definierten zusätzlichen Server auf.
menu: Zeigt eine Zusammenfassung der Befehlsoptionen an.
modify_server_name -s new_server_name [ -m Server] [ -p Server_Port_Nummer ]: Ändert die Bezeichnung des Servers.
modify_server_port -a new_server_port_number [ -m Server] [ -p Server_Port_Nummer]: Ändert die Portadresse des Servers.
restart: Startet lokalen AnswerBook2-Server erneut. Erfordert den Zugriff auf die Programmbasis.
rotate_access [ -m Server ] [ -p Server_Port_Nummer]: Speichert die Zugriffsprotokolldatei des Servers und setzt diese zurück.
rotate_error [ -m Server ] [ -p Server_Port_Nummer]: Speichert die Fehlerprotokolldatei des Servers und setzt diese zurück.
scan [ -m Server ] [ -p Server_Port_Nummer ]: Sucht nach lokalen Sammlungen (AnswerBook1 oder AnswerBook2) und aktualisiert die Sammlungen in der Datenbank des festgelegten Servers.
start: Startet lokalen AnswerBook2-Server. Erfordert den Zugriff auf das root-Verzeichnis.
start -D: Startet lokalen AnswerBook2-Server im Testmodus. Erfordert den Zugriff auf das root-Verzeichnis.
stop: Hält den lokalen AnswerBook2-Server an. Erfordert den Zugriff auf das root-Verzeichnis.
view_access [ -m Server ] [ -p Server_Port_Nummer]: Zeigt den Inhalt der Zugriffsprotokolldatei des Servers an.
view_config [ -m Server ] [ -p Server_Port_Nummer]: Zeigt die Serverkonfiguration an.
view_error [ -m Server ] [ -p Server_Port_Nummer]: Zeigt den Inhalt der Fehlerprotokolldatei des Servers an.

ANWENDUNG

Beenden: Interaktiven Betrieb beenden.
q: Interaktiven Betrieb beenden.
Auf Wiedersehen: Interaktiven Betrieb beenden.
Beenden: Interaktiven Betrieb beenden.
? [Befehl]: Hilfe zum interaktiven Betrieb.
h [Befehl]: Hilfe zum interaktiven Betrieb.

EXAMPLES

Beispiel 1 Auflisten der auf einem Server verfügbaren AnswerBook2-Buchreihen

So listen Sie die auf dem Server foo.com verfügbaren Buchreihen mit Hilfe der Portadresse 8888 auf:

Beispiel% ab2admin -o Liste -m foo.com -p 8888

Beispiel 2 Auflisten von Buchreihen im interaktiven Modus

So verwenden Sie den Befehl ab2admin im interaktiven Modus, um die oben beschriebene Operation auszuführen:

Beispiel% ab2admin
>> Liste -m foo.com -p 8888

Beispiel 3 Installieren einer AnswerBook2-Buchreihendatenbank

So installieren Sie eine AnswerBook2-Buchreihendatenbank mit Hilfe des Dienstprogramms pkgadd:

Beispiel# pkgadd -d package_directory/ SUNWabsdk

Die Verzeichnisstruktur der Buchreihendatenbank wird standardmäßig in folgendes Systemverzeichnis kopiert: /opt/answerbooks/

Beispiel 4 Installieren einer in der Datenbank des Server nicht aktualisierten AnswerBook2-Buchreihendatenbank

So installieren Sie eine AnswerBook2-Buchreihendatenbank, die in das System eingeführt wurde (über den Befehl pkgadd), in der Datenbank des Servers aber nicht aktualisiert wurde:

Beispiel# ab2admin -o add_coll -d
/opt/answerbooks/english/solaris_2.6/SUNWabsdk

Hinweis: -d Pfad muß die Datei collinfo (für eine AnswerBook2-Buchreihendatenbank) oder die Datei ab_cardcatalog (für eine AnswerBook1-Buchreihendatenbank) enthalten.

Beispiel 5 Überprüfung der Definition einer AnswerBook1-Buchreihendatenbank

So überprüfen Sie die Definition einer AnswerBook1-Buchreihendatenbank:

Beispiel% cat /opt/SUNWans/ab_cardcatalog
:id=SUNWab_10_4: \
:version=: \
:title=Solaris XGL 3.1 AnswerBook: \
:tocpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/toc: \
:pspath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/ps: \
:indexpath=/net/elirium.Eng/export/answerbook/Solaris_2.4/SUNWAxg/inde

Beispiel 6 Überprüfung der Definition einer AnswerBook2-Buchreihendatenbank

So überprüfen Sie die Definition einer AnswerBook2-Buchreihendatenbank:

Beispiel% cat/opt/answerbooks/english/solaris_2.6/SUNabsd/collinfo
dwCollections {
  coll.45.4 dwCollection
}
dwSetParam coll.45.4 {
  location /opt/answerbooks/english/solaris_2.6/SUNWabsdk
  title "Solaris 2.6 Software Developer AnswerBook Vol 1"
  type EbtCollection
}

FILES

/var/log/ab2/catalog/local.socat: Katalogdatei
/var/log/ab2/catalog/remote.socat: Katalogdatei
/var/log/ab2/catalog/delegate.socat: Katalogdatei
/var/log/ab2/catalog/libcat.socat: Katalogdatei
/var/log/ab2/logs/access_8888.log: Standard-Zugriffsprotokolldatei
/var/log/ab2/logs/errors_8888.log: Standard-Fehlerprotokolldatei
/usr/lib/ab2/dweb/data/config/ab2_collections.template: AnswerBook2-Buchreihendatenbank
/var/log/ab2/catalog/ab1_cardcatalog: AnswerBook1-Buchreihendatenbank
/usr/lib/ab2/dweb/data/config/admin_passwd: Datei mit Benutzername:Paßwort

ATTRIBUTES

Weitere Informationen finden Sie unter Attribute(5) für die Erläuterung folgender Attribute:

ATTRIBUT-TYP	ATTRIBUTWERT
Verfügbarkeit	`SUNWab2u`