Jukebox Operation Broker 1.3

Transkript

1 P0 21. Oktober 2005 c positix GmbH

2 c positix GmbH Im Stillbungert Hennef Linux ist eingetragenes Warenzeichen von Linus Torvalds, Jukeman ist eingetragenes Warenzeichen der ixos Software AG, Microsoft ist eingetragenes Warenzeichen der Microsoft Corporation, Redmond, Wash., US, Windows ist eingetragenes Warenzeichen der Microsoft Corporation, Redmond, Wash., US, UNIX ist eingetragenes Warenzeichen der X/Open Company Limited, Reading, Berkshire, GB, SuSE ist eingetragenes Warenzeichen der Suse Linux AG, Nürnberg, positix ist eingetragenes Warenzeichen. Sonstige in diesem Dokument verwendeten Hard- und Softwarebezeichnungen können ebenfalls eingetragene Warenzeichen sein, insbesondere außerhalb der Bundesrepublik Deutschland. Deren Nennung findet ohne Gewährleistung der freien Verwendung statt. Auch ohne besondere Kennzeichnung berechtigt die Wiedergabe von Waren- und Handelsnamen nicht zu der Annahme, dass diese Namen frei von Schutzrechten sind.

3 Inhaltsverzeichnis 1 Einführung 5 2 Installation und Konfiguration Systemvoraussetzungen Hardwareanforderungen Softwarevoraussetzungen Installation Konfiguration Konfigurationsdatei Beispielkonfigurationen QStar PoINT Jukebox- und Medienverwaltung Gerät aktivieren (cdadm attach) Gerät deaktivieren (cdadm detach) Laufwerk deaktivieren (cdadm detach) Laufwerk aktivieren (cdadm attach) Fach deaktivieren (cdadm detach) Fach aktivieren (cdadm attach) Medium in Gerät einsetzen (cdadm insert) Medium aus Gerät entfernen (cdadm remove) Laufwerk be- und entladen (cdadm movecd) Medieninhalt ermitteln (cdadm testcd) Zustandsdaten ermitteln (cdadm survey) Geräteinformationen Fachinformationen Laufwerksinformationen Zeilensortierung Zeilenfilterung Spaltenquotierung Test auf Serververfügbarkeit (cdadm null) Server herunterfahren (cdadm down) Doppelseitige Medien 21 5 Imagedatei erstellen 22 6 Recording cdglow Recordingvorgang Zukünfige Entwicklungen 26 8 Nicht-implementierte Jukeman-Funktionen 26 A Versionshistorie 26

4 4

5 5 1 Einführung Möchte man automatische Medienwechselsysteme, auch Jukeboxen genannt, für seine Datenspeicherung einsetzen, so bieten sich üblicherweise zwei Ansätze an. Einerseits kann man die Steuerung der Jukeboxrobotik und die Ressourcenverwaltung selber übernehmen. Dies bietet den Vorteil, dass man die spezifischen Eigenheiten von Jukeboxsystemen für sich ausnutzen kann. Allerdings muss hierfür ein geeignetes Softwaresystem erstellt werden und die einzusetzenden Anwendungen entsprechend angepasst werden. Man sieht sich also vor umfangreichen und kostenintensiven Programmieraufgaben. Alternativ kann man auf bestehende Jukeboxsoftwaresysteme aufsetzen, die einem zumindest die Robotiksteuerung und Ressourcenverwaltung abnehmen. Die Notwendigkeit zur Anpassung der Anwendungen bleibt nach wie bestehen. Daher haben sich spezielle Jukeboxsoftwaresysteme etabliert, die nach außen als Fileserver fungieren und die Medieninhalte in einem Dateisystem anbieten. Herkömmliche Anwendungen können dann auf die Inhalte mit gewöhnlichen Dateioperationen zugreifen. Da aber Jukeboxsysteme aufgrund ihres Aufbaus zusätzliche Verwaltung verlangen, kommt man meist nicht ohne die Erstellung einer anwendungsspezifischen Jukeboxadministration aus. Nun existieren aber eine ganze Reihe solcher Jukeboxsoftwaresysteme mit transparentem Dateizugriff, die zwar im Wesentlichen die gleiche Funktionalität anbieten, deren Verwaltung aber gravierend voneinander abweicht. Man kann nun entweder für jedes System ein entsprechendes Administrationsmodul erstellen, was wiederum mit viel Programmier- und Testaufwand verbunden ist oder man schränkt sich auf ein System ein, wodurch man von dem jeweiligen Hersteller abhängig wird. Genau an dieser Stelle setzt Jukebox Operation Broker (JOB) ein. Diese Software bietet eine einheitliche Schnittstelle für unterschiedliche Jukeboxsoftwaresysteme. Selbstverständlich können dabei nicht alle speziellen Fähigkeiten der jeweiligen Systeme unterstützt werden, man muss sich auf einen gemeinsamen Nenner beschränken. In der Praxis stellt sich dies aber als unwesentlich heraus, da die meisten Anwendungen ohnehin nur die Grundfunktionalität der Jukeboxadministration verwenden. Die fundamentale Aufgabe eines Jukeboxsoftwaresysteme ist natürlich der Zugriff auf die Mediendateien. Der lesende Zugriff wird über einen speziellen Dateisystemtreiber zur Verfügung gestellt und benötigt seitens der Applikationen keinen zusätzlichen Verwaltungsaufwand. Um schreibend auf die Meiden zugreifen zu können, sind zuvor immer administrative Schritte notwendig, wie etwa die Bereitstellung geeigneter Medien, deren Formatierung, usw. Als übliche Verwaltungsaufgaben fallen hingegen Einfügen und Entnehmen von Medien, als auch die Konfiguration der Jukeboxen und deren Laufwerke an. Wenn Ihre Anwendung also keine speziellen Eigenschaften eines bestimmen Jukeboxsoftwaresystems mit transparentem Dateizugriff verwendet, so hilft Ihnen JOB flexibel und herstellerunabhängig zu agieren. Um dies zu erreichen, muss eine einheitliche Verwaltungsschnittstelle existieren. Um nicht noch eine weitere zu definieren, wurde die Schnittstelle eines bereits existierenden Jukeboxsoftwaresystems als Grundlage verwendet. Aus zwei Gründen fiel die Wahl auf die Kommandozeilenschnittstelle von EMC Jukeman. Denn einerseits hat Jukeman als eines der dienstältesten Programme weite Verbreitung gefunden und ist in zahlreichen Archiv- bzw. Dokumentenmanagementsysteme berücksichtigt worden. Andererseits bildet diese Schnittstelle alle wesentlichen Verwaltungsaufgaben mit nur wenigen Kommandozeilenpro-

6 6 INSTALLATION UND KONFIGURATION gramm und kompakter Aufrufsyntax ab. Aber JOB bietet mehr, als eine bloße Kommandoübersetzung. Die besonderen Vorteile dieses Systems sind u.a.: Einheitliche Schnittstelle für unterschiedliche Jukeboxsoftwaresysteme Dieser Punkt wurde oben eingehend erörtert und ist für die meisten Anwender der ausschlaggebende Faktor. Paralleler Einsatz verschiedener Jukeboxsoftwaresysteme JOB ermöglicht es, Jukeboxsoftwaresysteme verschiedener Hersteller gleichzeitig zu fahren. Man kann also zum Beispiel den Altdatenbestand weiterhin mit Jukeman, neue Daten hingegen mit QStar- oder PoINT-Software pflegen. Remote-Fähigkeit Selbstverständlich kann JOB entfernte Server verwalten, sofern dies von dem jeweils eingesetzten Jukeboxsoftwaresystem unterstützt wird. Implizite Serverermittlung Beim Einsatz mehrerer Jukeboxserver und entsprechender Konfiguration von JOB kann die explizite Serverangabe bei Verwaltungsfunktionen entfallen. Dies ist nützlich für bestehende Verwaltungsprogramme, die nur einen einzelnen Server unterstützen. Intern verwendet JOB eine C++-Bibliothek, die unabhängig vom der Kommandozeilenschnittstelle verwendet werden kann. Für neu zu erstellende Anwendungen oder solche, die keine Kommandozeilenaufrufe verwenden sollen, wäre die Verwendung dieser Bibliothek eine gute Alternative. Fragen Sie uns danach! 2 Installation und Konfiguration 2.1 Systemvoraussetzungen Hardwareanforderungen Die Anforderungen an die Hardware sind äußerst gering. Es werden lediglich 2 MB an Festplattenspeicher und 4 MB an Arbeitsspeicher benötigt. Letztere ist als zusätzlicher Arbeitsspeicherbedarf zu verstehen. Sie müssen zudem noch den vom Betriebssystem und den Administrationsprogrammen des Jukeboxsoftwaresystems benötigten Arbeitsspeicher hinzurechnen Softwarevoraussetzungen Betriebssystem. Folgende Betriebssysteme werden unterstützt: Microsoft Windows 2000, 2003, XP Linux für x86-systeme mit Kernel 2.4 und GCC 3, z.b. SuSE Linux 9.0, Red Hat Linux 9.0. Sonstige Linux-Varianten auf Anfrage. UNIX-Derivate auf Anfrage.

7 Installation 7 Jukeboxsoftwaresystem. Folgende Jukeboxsoftwaresysteme werden unterstützt: EMC ArchiveXtender Jukeman Edition für Windows NT/2000, Versionen 3.03 und 3.04 QStar CD/DVD Axxess 4.10 QStar CD/DVD Master 4.10 PoINT Jukebox Manager V4.1 Es wird eine korrekte Installation der Software und insbesondere der anzusteuernden Geräte (Jukeboxen) vorausgesetzt. Auf jedem Rechner darf höchstens ein Jukeboxsoftwareserver laufen. Inwieweit ältere oder neuere Versionen oben aufgeführter Systeme unterstützt werden, ist im Einzelfall zu prüfen. Sofern sich die Schnittstelle bzw. das Ein-/Ausgabeverhalten der eingesetzten Systeme sich nicht unterscheidet, sollte einem Einsatz von JOB nichts entgegenstehen. 2.2 Installation Kopieren Sie die Programme aus dem Verzeichnis bin des Distributionsmediums in ein geeignetes Verzeichnis Ihres Systems. Wenn Sie ein übergeordnetes Verwaltungsprogramm für Jukeman einsetzen, achten Sie darauf, dass dieses anstelle der Jukeman- Programme die von JOB verwendet. Wichtiger Hinweis. Bei Verwendung der PoINT-Software dürfen Sie die Programme von JOB nicht in das Installationsverzeichnis des PoINT-Jukeboxmanagers kopieren, da ansonsten Aufrufe der Kommandozeilenprogramme mit einer busy-fehlermeldung quittiert werden. 2.3 Konfiguration Im Regelfalle muss JOB noch konfiguriert werden. Hierzu werden in eine Textdatei entsprechende Daten eingetragen. Die Programme cdadm sowie cdglow von JOB suchen diese Textdatei wie folgt: 1. Wenn beim Programmaufruf die Option -px:cfg angegeben worden ist, so wird deren Wert als Angabe der Konfigurationsdatei verwendet. 2. Wenn die Umgebungsvariable POSITIX JOB definiert ist, wird deren Wert als Angabe der Konfigurationsdatei verwendet. 3. Fehlt obige Umgebungsvariable oder benennt besitzt der jeweilige Benutzer für die entsprechende Datei keine Leseberechtigung, so wird bei UNIX oder Linux die Datei /etc/positix/job.cfg bei Windows-Systemen hingegen C:\positix\etc\job.cfg verwendet. 4. Fehlt auch diese Datei oder fehlt die Leseberechtigung so startet das aufgerufene Programm mit einer Standardkonfiguration.

8 8 INSTALLATION UND KONFIGURATION Konfigurationsdatei Die nach obigen Verfahren ermittelte Konfigurationsdatei muss eine Textdatei sein. Die verwendbaren Zeichenkodierungen hängen von den Betriebssystemeinstellungen ab. Im Zweifel sollte nur ASCII verwendet werden. Typischerweise sind auf Computersystemen im europäischen Sprachraum ISO-8859-Kodierungen und andere 8-Bit- Zeichensätze ebenfalls einsetzbar. Die Konfigurationsdatei wird zeilenweise vom aufgerufenen Programm eingelesen. Hierbei wird Leerraum am Anfang und Ende der Zeile ignoriert. Zeilen die nur aus Leerraum bestehen sowie Zeilen, deren erstes druckbares Zeichen # (ASCII-Code 35) ist, werden ignoriert. Ansonsten wird eine Zeile in seine Wörter zerlegt. Ein Wort wird durch eine der beiden nachstehenden Bedingungen definiert. 1. Jede Folge druckbarer Zeichen, die nicht mit einem Anführungszeichen (ASCII 34) beginnt und durch ein Leerraumzeichen beendet wird ist ein Wort. Das terminierende Leerraumzeichen ist nicht Bestandteil des Wortes. 2. Beginnt eine Folge druckbarer Zeichen mit einem Anführungszeichen, so erstreckt sich das zugehörige Wort bis zu einer Folge von Anführungszeichen ungerader Länge. Das erste und letzte Anführungszeichen sind nicht Bestandteil des Wortes. Hierbei wird jede maximale Teilfolge von Anführungszeichen gerader Länge als Folge von Anführungszeichen der halben Länge zu einem Bestandteil des Wortes. Leerraumzeichen werden als Leerzeichen interpretiert. Mit anderen Worten: Enthält ein Wort Leer- oder Anführungszeichen so muss das Wort mit Anführungszeichen umschlossen werden. Anführungszeichen innerhalb dieser Klammerung werden durch doppelte Anführungszeichen angegeben. Beispiele. Die Zeile install qstar "c:\program Files\QStar" besteht aus den Wörtern install, qstar sowie c:\program Files\QStar. Die Zeile device "jbx"""1" localhost besteht aus den Wörtern device, jbx 1 und localhost. Das erste Wort einer jeden Zeile spezifiziert eine Konfigurationsanweisung. Die restlichen Wörter geben Parameter an. Im Folgenden werden die möglichen Konfigurationsanweisungen erörtert. Die jeweils möglichen Wortsequenzen werden beschrieben, indem für jedes Wort entweder das zu notierende Wort in Kleinbuchstaben oder ein Platzhalter in Großbuchstaben angegeben wird. Platzhalter, die durch eckige Klammern eingefasst sind deuten an, dass das zugehörige Wort fehlen darf. Angabe der verwendeten Jukeboxsoftwaresysteme. Dies geschieht durch eine Zeile in der Konfigurationsdatei der folgenden Form: install [NAME] SYSTEM PATH Hierbei gibt NAME einen Bezeichner an, unter dem die Installation im weiteren Verlauf der Konfiguration benannt wird. Fehlt dieser Bezeichner, so wird SYSTEM als Name verwendet. Jeder Installationsname darf höchstens einmal verwendet werden. Der Parameter SYSTEM spezifiziert das Jukeboxsoftwaresystem. Die zulässigen Werte und deren Bedeutung sind:

9 Konfiguration 9 jukeman EMC ArchiveXtender Jukeman Edition qstar QStar CD/DVD Axxess bzw. QStar CD/DVD Master point PoINT Jukebox Manager Man beachte, dass die Pfadangabe sich immer auf das lokale System bezieht, also auf das System, auf dem ein JOB-Programm aufgerufen wird. Existiert in der Konfiguration keine install-angabe, so wird implizit folgende Anweisung verwendet: install jukeman /usr/local/jukeman Ohne install-angabe wird also Jukeman verwendet, der im Verzeichnis /usr/local/ jukeman installiert sein muss. Offensichtlich muss daher unter Windows eine Konfigurationsdatei angelegt werden. Lizenznummer Aus gegebenen Anlass verwendet JOB ab Version 1.3 Lizenznummern zur Identifikation der Installation. Diese wird mittels der Direktive licnum spezifiziert: licnum LIZENZNUMMER Die Lizenznummer wird Ihnen von Ihrem Lieferanten von JOB mitgeteilt. Lizenzschlüssel JOB muss für die Verwendung von PoINT und QStar lizenziert werden. Man benötigt eine Lizenz für jede Installation. Die Direktive license spezifiziert den Lizenzschlüssel einer Installation: license INSTALLATION SCHLÜSSEL Die korrekte Lizenzierung der Installation INSTALLATION wird durch den Schlüssel SCHLÜSSEL sowie der Lizenznummer (s.o.) nachgewiesen. In den Installationsabschnitten zu den einzelnen Jukeboxserver-Software-Systemen wird beschrieben, wie ein solcher Schlüssel zu ermitteln ist. Wenn der Lizenzschlüssel für eine Installation außer Jukeman nicht angegeben ist, läuft JOB im Demonstrationsmodus, in dem nur die Fächer 1 13 einer Jukebox angesprochen werden können. Bei einem ungültigen Lizenzschlüssel wird ein Fehler gemeldet. Die license-direktive muss hinter der zugehörigen install-direktive stehen. Datei zur Fehlerprotokollierung Leider protokollieren nicht alle Jukeman-Anwendungen die Kommandoaufrufe und deren Resultate. Daher wird ab Version 1.3 die Möglichkeit angeboten, Fehlermeldungen von cdadm in eine Datei zu schreiben. Hierzu dient die Direktive errlog DATEINAME Der DATEINAME gibt die Protokolldatei an. Sie sollten hier immer eine absolute Pfadangabe verwenden. Wenn keine Direktive angegeben ist, so werden keine Fehler in einer Datei protokolliert. Angabe der anzusteuernden Server (Hosts) Da JOB die gleichzeitige Verwendung verschiedener Jukeboxsoftwaresysteme unterstützt, sollte zu jedem Jukeboxserver die verwendete Software angegeben werden. Das Zeilenformat einer solchen Angabe ist host NAME INSTALLATION Der Parameter NAME benennt den Serverrechner entweder durch seinen Netzwerknamen oder seine IP-Adresse. Die Bezeichnung localhost steht für den Rechner von

10 10 INSTALLATION UND KONFIGURATION dem aus das jeweilige Programm aufgerufen wurde. Der Wert von INSTALLATION spezifiziert ein über eine install-anweisung definierte Installation eines Jukeboxsoftwaresystems. Das bedeutet, es muss zuvor eine install-anweisung erfolgt sein, deren erster Parameter mit dem Wert von INSTALLATION übereinstimmt. Werden keine host-angaben gemacht, so können dennoch mehrere Server verwendet werden. Die zu verwendende Jukeboxsoftware bestimmt sich dann durch die erste install-anweisung der Konfigurationsdatei. Doppelseitige Medien Mit der Direktive double-sided können Sie Jukeboxen spezifieren, die doppelseitige Medien beinhalten: double-sided [NAME...] Hinter dem Schlüsselwort double-sided können Sie beliebig viele Jukeboxnamen angeben. Jede dieser Jukeboxen wird als doppelseitig betrachtet, d.h. sie kann Laufwerke auch mit den Medienrückseiten beladen. Geben Sie nur double-sided an, also ohne Jukeboxnennungen, so werden alle Jukeboxen als doppelseitig betrachtet. Geräteumleitungen Da mehrere Server mit unterschiedlicher Jukeboxsoftware unterstützt werden, kann es erforderlich sein, Geräteumleitungen zu definieren. Diese können ebenfalls dazu verwendet werden, um auf explizite Serverangaben bei Kommandoaufrufen zu verzichten. Das Zeilenformat einer Geräteumleitung ist device NAME HOST [TRUENAME] Wenn bei einem Aufruf eines JOB-Programms die Gerätebezeichnung NAME verwendet und auf eine explizite Serverangabe verzichtet wird, so wird das Kommando auf das Gerät TRUENAME des Servers HOST umgeleitet. Fehlt die Angabe von TRUENAME wird hierfür NAME eingesetzt. Konfigurationsdatei einlesen Um die Installation von mehreren Servern und Clients zu vereinfachen, kann die Konfiguration auf mehrere Dateien aufgeteilt werden. Die Anweisung include veranlasst, dass die angegebene Datei ebenfalls eingelesen wird. Das Format lautet: include DATEINAME Dabei wirkt include so, als ob der Inhalt der Datei DATEINAME an der Stelle der include-anweisung stünde. Es wird nicht geprüft, ob die angegebene Datei bereits eingelesen wird oder wurde. Zyklische include-anweisungen (Datei A liest B ein und diese wiederum direkt oder indirekt Datei A) werden somit nicht entdeckt Beispielkonfigurationen Ersetzung von Jukeman Wenn eine Jukeman-Installation vollständig durch ein anderes System ersetzt werden soll, so reichen hierfür wenige Konfigurationszeilen aus. Im ersten Beispiel wird ausschließlich QStar auf dem lokalen Server eingesetzt, wobei QStar in /sys/qstar installiert ist. licnum pxjob-evaluation install qstar /sys/qstar license qstar IhrL-izen-zSch-lues-selF-uerQ-Star0

11 Konfiguration 11 Soll hingegen eine QStar-Installation ein bestehendes Jukeman-System ergänzen, so kann dies durch eine Konfigurationsdatei der folgenden Art erreicht werden: licnum pxjob-evaluation install jukeman /usr/local/jukeman install qstar /sys/qstar license qstar IhrL-izen-zSch-lues-selF-uerQ-Star0 host jserv jukeman host qserv qstar Die Auswahl des Servers muss dann über die entsprechende Kommandozeilenoption geschehen. Ist dies nicht erwünscht, so müssen die angeschlossenen Jukeboxen der jeweiligen Server ermittelt werden. Für unser Beispiel sei an den Jukeman-Server eine Jukebox juke und ein Einzellaufwerk single angeschlossen, am QStar-Server hingegen eine Jukebox namens jb. Folgende Konfigurationsdatei bewirkt, dass die Angabe eines Gerätes den zugehörigen Server automatisch auswählt: licnum pxjob-evaluation install jukeman /usr/local/jukeman install qstar /sys/qstar license qstar IhrL-izen-zSch-lues-selF-uerQ-Star0 host jmserv jukeman host qsserv qstar device juke jserv device single jserv device jb qserv In diesem Beispiel bleiben die Gerätenamen erhalten. Man kann diese aber auch umbenennen: licnum pxjob-evaluation install jukeman /usr/local/jukeman install qstar /sys/qstar license qstar IhrL-izen-zSch-lues-selF-uerQ-Star0 host jmserv jukeman host qsserv qstar device d1 jserv juke device d2 jserv single device d3 qserv jb Nun benennt d1 das Gerät juke auf dem Server jserv, d2 das Gerät single auf demselben Server und schließlich d3 das Gerät jb auf dem Server qserv. Allgemeines Beispiel Es sind drei Jukeboxsoftwareinstallationen vorhanden: Eine Jukeman-Installation auf dem Server jm sowie zwei QStar-Installationen, eine auf dem Server jukeserver und eine auf dem lokalen Server, der aber eine andere QStar-Installation verwendet. Aus historischen Gründen ist sowohl auf jm als auch auf jukeserver ein Gerät namens jb installiert. Diese Mehrdeutigkeit soll aufgelöst werden. Hierzu kann folgende Konfigurationsdatei dienen. # Lizenznummer

12 12 INSTALLATION UND KONFIGURATION licnum pxjob-evaluation # Verwendete Jukeboxsysteme install qstar qstar /sys/qstar install altqstar qstar /usr/local/qstar install jukeman /usr/local/jukeman # Lizenzschlüssel license qstar IhrL-izen-zSch-lues-selF-uerQ-Star0 license altqstar IhrL-izen-zSch-lues-selF-uerQ-Star1 # Server host localhost altqstar host jm jukeman host jukeserver qstar # Geräteumleitungen device jb1 jm jb device jb2 jukeserver jb 2.4 QStar Unter QStar werden alle von JOB betreuten Medien im Volumeset pxjob zusammengefasst. Hierbei werden alle Medien als betreut betrachtet, wenn sie bei den Kommandos cdadm insert/import oder cdadm testcd verwendet werden. Beim Export eines Mediums wird dieses zuvor aus dem Volumeset pxjob entfernt. Damit dies funktioniert, muss vor der Verwendung von JOB ein entsprechendes Volumeset erstellt werden. Dies geschieht über folgendes QStar-Kommando: vlcrset -H localhost -T cd pxjob Wenn ganze Volumesets gemounted werden sollen, so muss hierfür ein ein Cache eingerichtet werden, zum Beispiel mit 1 MB Größe (16384 Blöcke zu 64K): mkdir -p /var/qstar/cache/pxjob vlcache -p c /var/qstar/cache/pxjob pxjob Für die Ausführung vieler QStar-Kommandos sind besondere Rechte erforderlich. Daher müssen auch die Programme von JOB unter Benutzerkonten mit entsprechenden Rechten ausgeführt werden. Die hierfür zugelassenen Benutzerkonten sind in der Datei install/priv.users im QStar-Installationsverzeichnis eingetragen. Einzelheiten zu den QStar-Kommandos und der QStar-Konfiguration entnehme man dem zugehörigen System Administrator s Guide. Falls das Programm cdglow von JOB zur Erstellung eines Datenabbildes verwendet werden soll, so muss die Umgebungsvariable PATH den Pfad zum Programm mkiso von QStar enthalten. Desweiteren muss die Option RECORD DI- RECT in der QStar-Konfigurationsdatei vl/files/conf im entsprechenden Installationsverzeichnis auf Allowed gesetzt werden. Lizenzierung. JOB verlangt für die Steuerung der QStar-Software eine entsprechende Lizenz. Hierzu befolgen Sie zunächst den QStar-eigenen Lizenzierungsvorgang. Dadurch erhalten Sie einen Lizenzschlüssel für die QStar-Software. Senden

13 PoINT 13 Sie diesen Schlüssel an den Händler, über den Sie JOB erworben haben. Dieser übermittelt Ihnen dann einen Lizenzschlüssel für JOB, den Sie in der Konfigurationsdatei von JOB vermöge der license-direktive eintragen. 2.5 PoINT Das in JOB verwendete PoINT Jukebox Manager SDK bietet keine Möglichkeit, die Herkunft des Mediums in einem Laufwerk zu ermitteln. Da diese Information aber für viele Anwendungen nötig ist, speichert JOB bei Verwendung des cdadm-unterkommandos movecd die Ladezustand des Laufwerkes in einer Datei im Verzeichnis positix_job im Installationsverzeichnis des Jukebox Managers. Daher muss sichergestellt sein, dass ein Schreibzugriff auf das Installationsverzeichnis des Jukebox Managers bei der Verwendung von cdadm movecd möglich ist. Als bessere Alternative empfiehlt es sich, dort zuvor ein Verzeichnis positix_job zu erstellen und dieses mit passenden Zugriffsrechten zu versehen. Werden die Laufwerke ohne Mitwirkung von JOB be- oder entladen, so sind die Inhalte der entsprechenden Dateien im Verzeichnis positix_job ungültig. In diesem Falle muss der Inhalt von Hand geändert werden. Einem Laufwerk ist dort eine Textdatei mit dem Namensmuster GERÄT-LAUFWERKSNUMMER zugeordnet. Laufwerksnummern werden hierbei von Null an gezählt. So steht beispielsweise die Nummer des Herkunftsfaches des 1. Laufwerkes des Gerätes jb in der Datei jb-0. Wenn das Programm point_iso9660 von JOB eingesetzt werden soll, um Imagedateien zu erzeugen, so muss zuvor die Umgebungsvariable POINT JBM auf das Installationsverzeichnis des PoINT Jukeboxmanagers gesetzt werden. Fehlt dieses Umgebungsvariable, so wird das zum Aufruf von point_iso9660 aktuelle Verzeichnis als Installationsverzeichnis betrachtet. Bei der Verwendung von cdglow von JOB zum Schreiben von Images muss darauf geachtet werden, dass dieses Programm nur auf dem lokalen Rechner eingesetzt werden kann. Hierzu muss JOB natürlich für diesen Rechner konfiguriert werden. Der lokale Rechner muss mit dem Hostnamen localhost in der Konfigurationsdatei eingetragen sein. Lizenzierung. JOB verlangt für die Steuerung der PoINT-Software eine entsprechende Lizenz. Hierzu befolgen Sie zunächst den PoINT-eigenen Lizenzierungsvorgang. Dadurch erhalten Sie einen Lizenzschlüssel für den PoINT Jukebox Manager. Senden Sie diesen Schlüssel an den Händler, über den Sie JOB erworben haben. Dieser übermittelt Ihnen dann einen Lizenzschlüssel für JOB, den Sie in der Konfigurationsdatei von JOB vermöge der license-direktive eintragen. 3 Jukebox- und Medienverwaltung Dieser Abschnitt beschreibt das Kommandozeilenprogramm cdadm. Dies ist wiederum in Unterkommandos gegliedert, die durch bestimmte Kommandoworte als Parameter spezifiziert werden. Die Aufrufsyntax ist wie folgt, wobei die Aufrufkonventionen und Shell-Syntax des unterliegenden Betriebssystems und Kommandozeileninterpreters zu beachten sind. cdadm [OPTIONEN-A] KOMMANDO [OPTIONEN-B] [ARGUMENTE] Hierbei steht [OPTIONEN-A] für keine, eine oder mehrere der folgenden Optionen:

14 14 JUKEBOX- UND MEDIENVERWALTUNG -h SERVER spezifiziert den anzusteuernden Jukeboxserver. Dieser muss in der JOB- Konfiguration angeben sein. Das Kommando bezieht sich also auf den Server SERVER. Wenn keine explizite Serverangabe verwendet wird, so wird immer der lokale Server verwendet, sofern nicht durch eine device-konfigurationsangabe eine Umleitung aktiviert wird. -px:show bewirkt, dass die verwendete Konfiguration von JOB in die Standardausgabe geschrieben wird. Diese Option dient vornehmlich zur Erkennung von Konfigurationsfehlern. -px:cfg=datei spezifiziert die zu verwendende Konfigurationsdatei als DATEI. Diesbezügliche Angaben aus Umgebungsvariablen oder Standardkonfigurationsdateien werden durch diese Option nichtig. Nach diesen Optionen folgt die eigentliche Kommandospezifikation, die durch KOM- MANDO eingeleitet wird. Manche der Kommandos erlauben zusätzliche Optionen (OPTIONEN-B) und die meisten erfordern weitere Argumente (ARGUMENTE). Die Kommandos werden in den folgenden Abschnitten beschrieben. Dabei wird auf die Beschreibung der obigen Optionen verzichtet. Die Syntaxbeschreibungen der einzelnen Kommandos verwenden dabei durchgängig folgende Platzhalter: GERÄT steht für ein Gerät, etwa für eine Jukebox oder ein Einzellaufwerk. Das Gerät muss beim zuständigen Jukeboxserver bekannt und korrekt eingerichtet sein. Man beachte, dass bei Geräteumleitungen nicht nur der zuständige Server, sondern auch ein anderer Gerätename angegeben werden kann. LAUFWERK steht für eine Laufwerksnummer. Laufwerke werden von 1 aufsteigend durchnumeriert. FACH steht für eine Fachnummer. Fächer (slots) werden von 1 aufsteigend durchnumeriert. Deren physische Zuordnung hängt aber sowohl von der Jukebox als auch vom Jukeboxsoftwaresystem ab, was aber für die Anwendung ohne Belang ist. Das Ergebnis einer Operation lässt sowohl durch die Ausgabe als auch durch den Exit-Status des Programms ermitteln. Die erfolgreiche Durchführung eines Kommandos wird durch den Exit-Status 0 (Null) angegeben. Es werden üblicherweise dann keine zusätzlichen Ausgaben getätigt. Im Gegensatz dazu wird bei nicht-erfolgreicher Ausführung die Meldung *error* CODE ausgegeben, wobei CODE für den entsprechenden numerischen Fehlercode steht. Im Regelfall wird vor dieser Meldung eine textuelle Fehlermeldung in englischer Sprache ausgegeben, die einen Hinweis auf die Fehlerursache gibt. Die Fehlermeldung stammt von unterliegenden Jukeboxsoftwaresystem. Der numerische Code wird ebenfalls als Exit-Status des Programms verwendet. Man beachte aber, dass bei vielen Betriebssystemen nur vorzeichenlose 8-Bit-Zahlen als Exit-Status erlaubt sind. Daher kann der Exit-Status vom gemeldeten Fehlercode abweichen. Desweiteren kann nicht garantiert werden, dass reguläre Programmausgaben nicht ebenfalls zu einer Ausgabe von *error* führen, weile *error* prinzipiell Bestandteil einer regulären Ausgabe sein kann. Dieses Verhalten wurde von der

15 Gerät aktivieren (cdadm attach) 15 Referenzschnittstelle (Jukeman) übernommen. Im Fehlerfalle ist aber der Exit-Status immer von Null verschieden. Zuletzt soll angemerkt werden, dass alle Kommandos recht generisch sind. Je nach eingesetzter Jukeboxsoftware und -hardware kann das Verhalten im Detail variieren. Dies gilt insbesondere beim Einsatz von Geräten, die zwar ähnlich wie eine Jukebox behandelt werden, aber physisch keine sind, wie etwa Einzellaufwerke oder Festplattenpartionenen. Daher lassen sich nicht alle möglichen Fälle beschreiben. Stattdessen wird lediglich die Intention eines Kommandos und einige Sonderfälle, soweit bekannt, beschrieben. 3.1 Gerät aktivieren (cdadm attach) cdadm attach GERÄT Aktiviert das Gerät GERÄT. Das Gerät muss beim zuständigen Jukeboxserver bekannt und korrekt eingerichtet sein. Beispiel cdadm attach jb Aktiviert am lokalen Server das Gerät jb. 3.2 Gerät deaktivieren (cdadm detach) cdadm detach GERÄT Deaktiviert das Gerät GERÄT. Das Gerät muss beim zuständigen Jukeboxserver bekannt und korrekt eingerichtet sein. Beispiel cdadm detach jb Deaktiviert am lokalen Server das Gerät jb. 3.3 Laufwerk deaktivieren (cdadm detach) cdadm detach GERÄT -d LAUFWERK Deaktiviert das Laufwerk mit der Nummer LAUFWERK des Gerätes GERÄT. Die genauen Auswirkungen sind abhängig von der Jukeboxsoftware. Normalerweise sind aber alle Laufwerke aktiviert, sofern sie nicht explizit deaktiviert wurden. Beispiel cdadm detach jb -d 2 Deaktiviert am lokalen Server das 2. Laufwerk des Gerätes jb. 3.4 Laufwerk aktivieren (cdadm attach) cdadm attach GERÄT -d LAUFWERK c Aktiviert das Laufwerk mit der Nummer LAUFWERK des Gerätes GERÄT. Die genauen Auswirkungen sind abhängig von der Jukeboxsoftware. Normalerweise sind aber alle Laufwerke aktiviert, sofern sie nicht explizit deaktiviert wurden.

16 16 JUKEBOX- UND MEDIENVERWALTUNG Beispiel cdadm attach jb -d 1 Aktiviert am lokalen Server das 1. Laufwerk des Gerätes jb. 3.5 Fach deaktivieren (cdadm detach) cdadm detach GERÄT -s FACH Deaktiviert das Fach mit der Nummer FACH des Gerätes GERÄT. Die genauen Auswirkungen sind abhängig von der Jukeboxsoftware. Normalerweise sind aber alle Fächer aktiviert, sofern sie nicht explizit deaktiviert wurden. Beispiel cdadm detach jb -s 125 Deaktiviert am lokalen Server das Fach 125 des Gerätes jb. 3.6 Fach aktivieren (cdadm attach) cdadm attach GERÄT -s FACH Aktiviert das Fach mit der Nummer FACH des Gerätes GERÄT. Die genauen Auswirkungen sind abhängig von der Jukeboxsoftware. Normalerweise sind aber alle Fächer aktiviert, sofern sie nicht explizit deaktiviert wurden. Beispiel cdadm attach jb -s 207 Aktiviert am lokalen Server das Fach 207 des Gerätes jb. 3.7 Medium in Gerät einsetzen (cdadm insert) cdadm insert GERÄT FACH Sofern ein Medium im Mailslot des angegebenen Gerätes liegt, wird das Medium in das angegeben Fach des Gerätes transportiert. Die genauen Auswirkungen sind abhängig vom Gerät als auch von der Jukeboxsoftware. Anstelle von insert kann auch import angegeben werden. Beispiel cdadm insert jb 42 Fügt das Medium im Mailslot in das Fach 42 des Gerätes jb ein. 3.8 Medium aus Gerät entfernen (cdadm remove) cdadm remove GERÄT FACH Transportiert das Medium im angegebenen Fach und Gerät in den Mailslot des Gerätes. Die genauen Auswirkungen sind abhängig vom Gerät als auch von der Jukeboxsoftware. Anstelle von remove kann auch export angegeben werden.

17 Laufwerk be- und entladen (cdadm movecd) 17 Beispiel cdadm remove jb 98 Transportiert das Medium aus Fach 98 des Gerätes jb nach dessen Mailslot. 3.9 Laufwerk be- und entladen (cdadm movecd) Die Beladung eines Laufwerkes geschieht über folgendes Kommando: cdadm movecd GERÄT LAUFWERK FACH Das Medium des spezifizierten Faches und Gerätes wird in das angegebene Laufwerk des Gerätes transportiert. Die Angabe des Faches 0 (Null) führt zum Entladen des Laufwerkes, siehe weiter unten. Beispiel cdadm movecd jb Transportiert das Medium aus Fach 431 des Gerätes jb nach Laufwerk 6 desselben Gerätes. Soll ein Laufwerk wieder entladen werden, so erfolgt dies über das Kommando cdadm movecd GERÄT LAUFWERK Alternativ kann auch cdadm movecd GERÄT LAUFWERK 0 verwendet werden. Letzere Form entspricht der zum Beladen eines Laufwerkes, mit dem Unterschied, dass als Fachnummer 0 (Null) verwendet wird. Anmerkungen. Sowohl bei QStar als auch bei PoINT führt das Beladen zur Deaktivierung des Faches und des Laufwerkes, da die Operation ansonsten nicht erlaubt ist. Beim Entladen werden die Elemente wieder aktiviert. Bei PoINT lässt sich die Herkunft eines Mediums in einem Laufwerk nicht über das eingesetzte SDK ermitteln, vgl. Abschnitt 2.5. Daher kann es zu Irritationen kommen, wenn der Zustand eines Laufwerkes ohne JOB geändert wird Medieninhalt ermitteln (cdadm testcd) cdadm testcd GERÄT FACH Der Inhalt des Medium in angegebenen Fach wird von der Jukeboxmanagementsoftware eingelesen und ggf. in dessen Dateisystem eingehangen. Beispiel cdadm testcd jb 43 Hängt das Medium aus Fach 43 des Gerätes jb in das Dateisystem der für das Gerät zuständigen Jukeboxsoftware ein.

18 18 JUKEBOX- UND MEDIENVERWALTUNG 3.11 Zustandsdaten ermitteln (cdadm survey) Die folgenden Kommandos dienen zur Ermittlung von Zustandsdaten. Man beachte, dass immer nur Daten über den angefragten Host (Option -h) geliefert werden. Sind mehrere Jukeboxsoftwaresysteme und somit mehrere Hosts im Einsatz, so muss für jeden Host eine eigene Abfrage durchgeführt werden. Anmerkung. ausgegeben. Gerätenamen werden wie bei Jukeman immer mit angehängtem.dev Geräteinformationen cdadm survey -d +SPALTEN Gibt Informationen über konfigurierte Geräte aus. Die auszugebenden Informationen werden durch SPALTEN angegeben. Für jedes konfigurierte Gerät des befragten Jukeboxsoftwaresystems wird eine Zeile ausgegeben. Die erlaubten SPALTEN sind dabei: d Gerätename n Fachanzahl r Laufwerksanzahl Fachinformationen cdadm survey -s +SPALTEN Gibt Informationen über die Fächer aller konfigurierten Geräte aus. Die auszugebenden Informationen werden durch SPALTEN angegeben. Für jedes Fach eines konfigurierten Gerätes des befragten Jukeboxsoftwaresystems wird eine Zeile ausgegeben. Die erlaubten SPALTEN sind dabei: d Gerätename s Fachnummer o Volumename des Mediums, soweit vorhanden r Volumename des Mediums im RockRidge-Format, soweit vorhanden p Volumename des Mediums im 8.3-Format, soweit vorhanden h Volumename des Mediums im HighSierra-Format, soweit vorhanden m Medientyp l Fachstatus Medientyp: CD-ROM CD-ROM recordable CD-R, CD-RW? unbekannter Medientyp Fachstatus: u Status unbekannt n Kein echtes Fach e Leeres Fach f Beladenes Fach Laufwerksinformationen cdadm survey -r +SPALTEN

19 Zustandsdaten ermitteln (cdadm survey) 19 Gibt Informationen über die Laufwerke aller konfigurierten Geräte aus. Die auszugebenden Informationen werden durch SPALTEN angegeben. Für jedes Laufwerk eines konfigurierten Gerätes des befragten Jukeboxsoftwaresystems wird eine Zeile ausgegeben. Die erlaubten SPALTEN sind dabei: d Name des Gerätes, in dem das Laufwerk installiert ist i Laufwerksnummer n Interner Name des Laufwerkes t Laufwerkstyp r Recorderindikator s Nummer des Herkunfsfach des Mediums, wenn Laufwerk beladen, 0 sonst f Laufwerksstatus Interner Name des Laufwerkes: Der Wert dieses Eintrages hängt von der jeweiligen Jukeboxsoftware ab. Dies ist ein Name, der vom zugehörigen Recordingprogramm als Laufwerksbezeichner verwendet wird. Laufwerkstyp: Diese Werte sind von SCSI-Geräteklassen inspiriert worden. Über die Jukeboxsoftware ist im Regelfall kein Zugriff auf die unterliegenden Geräte möglich. Zudem müssen dies nicht immer SCSI-Geräte sein. Daher kann die Korrektheit dieser Werte nicht gewährleistet werden 0 Festplatte 4 CD-Recorder 5 CD-ROM 7 Optisches Laufwerk Rekorderindikator: r Laufwerk ist ein Rekorder - Laufwerk ist kein Rekorder Laufwerksstatus: f Laufwerk ist defekt oder nicht vorhanden - Laufwerk ist verfügbar Zeilensortierung Die Zeilen können vor der Ausgabe sortiert werden. Hierzu muss nach der Angabe der auszugebenden Spalten ein Sortierkriterium angegeben werden, das eines der beiden folgenden Format besitzt: s:spalten s-:spalten Die erste Variante bestimmt eine aufsteigende, die zweite eine absteigende Sortierung. Alle Zeilen der Sortierspezifikationen werden lexikographisch bezüglich der Teilordnungen auf den SPALTEN geordnet. Die jeweilige Teilordnung ergibt sich aus dem Typen der entsprechende Spalte, also entweder eine numerische oder eine lexikographische Ordnung, und der angegebenen Sortierrichtung, aufsteigend oder absteigend. Die lexikographische Ordnung von Zeichenkette richtet sich nach der Zeichenkodierung.

20 20 JUKEBOX- UND MEDIENVERWALTUNG Beispiel. Auszugeben sind die Fachbelegungen aller Jukeboxen, sortiert nach aufsteigendem Gerätenamen, aufsteigender Fachnummer, absteigendem Originalvolumenamen und aufsteigendem Medientyp. Die Spalten sollen in der Reihenfolge Gerät, Fachnummer, Medientyp, Volumename ausgegeben werden. Dies führt zu dem Kommando cdadm survey -s +dsmo s:ds s:-o s:m Die Zeilensortierung kann mit einer Zeilenfilterung kombiniert werden, wie im nächsten Abschnitt erläutert wird Zeilenfilterung Es können bestimmte Zeilen der Ausgabe herausgefiltert werden. Als Anzeigekriterium können Spaltenwerte auf Gleichheit oder Ungleichheit mit einem angegebenen Wert getestet werden. Sind alle Kriterien erfüllt, so wird die entsprechende Zeile ausgegeben, ansonsten nicht. Ein Filterkriterium kann eines der beiden folgenden Formate annehmen: SPALTE=WERT SPALTE!WERT Die erste Form bewirkt, dass nur Zeilen ausgegeben werden, deren SPALTE den Wert WERT annimmt. Demgegenüber wird bei der zweiten Form nur dann die entsprechende Zeile ausgegeben, wenn der Spaltenwert nicht WERT annimmt. Man beachte, dass für jedes Kriterium immer nur eine Spalte angegeben werden darf. Es wird immer auf exakte Übereinstimmung geprüft, bei alphanumerischen Spalten wird also Groß- /Kleinschreibung berücksichtigt. Beispiel. Es sollen alle Fächer der Jukebox jb1 ausgegeben werden, die kein beschreibbares Medium beinhalten, aber dennoch belegt sind. Neben der Fachnummer soll auch der Medientyp ausgegeben werden. cdadm survey -s +sm d=jb1.dev m!recordable l=f Anmerkung. Bei den meisten UNIX-Shells ist das Ausrufezeichen mit einer speziellen Funktion belegt, so dass obiges Beispielkommando zu einer Fehlermeldung führt. Durch Quotierung kann dies umgangen werden: cdadm survey -s +sm d=jb1.dev m!recordable l=f Die Zeilenfilterung kann mit der Zeilensortierung kombiniert werden. Sollen zum Beispiel alle Fächer mit beschreibbaren Medien aller Jukeboxen außer jb2 nach Jukeboxen aufwärts und Fachnummern abwärts sortiert ausgegeben werden, so kann folgendes Kommando verwendet werden: cdadm survey -s +ds m=recordable d!jb2.dev s:d s:-s Spaltenquotierung Die Werte einer Spalte können quotiert, d.h. von einem bestimmten Zeichen umschlossen werden. Hierzu kann vor der Angabe einer Ausgabespalte ein Quotierungszeichen spezifiziert werden, das durch einen einleitenden Doppelpunkt eingeführt wird. Die Quotierungszeichen ändern den Spaltenwert bezüglich einer etwaigen Sortierung oder Filterung nicht.