Kapitel 9 SunPlex Agent Builder

Dieses Kapitel beschreibt SunPlex Agent Builder und Cluster Agent Module für Agent Builder. Beides sind Tools, welche die Erstellung von Ressourcentypen bzw. Datendiensten automatisieren, die unter Ressourcengruppen-Manager (RGM) ausgeführt werden sollen. Ein Ressourcentyp ist im Wesentlichen ein Wrapper um eine Anwendung. Dadurch kann die Anwendung in einer Cluster-Umgebung unter der Steuerung von RGM ausgeführt werden.

Agent Builder stellt eine bildschirmbasierte Benutzeroberfläche für die Eingabe einfacher Informationen zur Anwendung und zum zu erstellenden Ressourcentyp bereit. Ausgehend von den Informationen, die Sie eingeben, generiert Agent Builder die folgende Software:

• Einen Satz Quelldateien—C, Korn-Shell (ksh) oder GDS (Generic Data Service, generischer Datendienst)—für einen Failover- bzw. Scalable-Ressourcentyp, entsprechend den Rückmeldemethoden des Ressourcentyps.

• Eine angepasste RTR-Datei (Resource Type Registration, Ressourcentypregistrierung), wenn Sie C- bzw. Korn-Shell-Quellcode erstellen.

• Angepasste Dienstprogrammskripts zum Starten, Stoppen und Entfernen einer Instanz (Ressource) des Ressourcentyps sowie angepasste Online-Dokumentation zur Verwendung der einzelnen Dateien.

• Ein Solaris-Paket, das die Binärdateien (wenn Sie C-Quellcode generieren), eine RTR-Datei (wenn Sie C- bzw. Korn-Shell-Quellcode generieren), sowie die Dienstprogrammskripts enthält.

Dieses Kapitel behandelt folgende Themen:

• Verwenden von Agent Builder

• Verzeichnisstruktur

• Ausgabe

• Navigieren in Agent Builder

• Cluster Agent Module für Agent Builder

Verwenden von Agent Builder

Dieser Abschnitt beschreibt, wie Agent Builder verwendet wird, einschließlich der Aufgaben, die vor dem Einsatz von Agent Builder ausgeführt werden müssen. Der Abschnitt erläutert auch, auf welche Arten Agent Builder nach dem Generieren des Ressourcentypcodes eingesetzt werden kann.

Analysieren der Anwendung

Bevor Sie Agent Builder verwenden, müssen Sie entscheiden, ob die Anwendung den Kriterien für hohe Verfügbarkeit bzw. Skalierbarkeit entspricht. Agent Builder kann diese Analyse nicht ausführen, die lediglich auf den Laufzeiteigenschaften der Anwendung basiert. Analysieren der Eignung einer Anwendung enthält weitere Informationen zu diesem Thema.

Agent Builder ist möglicherweise nicht immer in der Lage, einen vollständigen Ressourcentyp für Ihre Anwendung zu erstellen. In den meisten Fällen kann Agent Builder jedoch zumindest eine teilweise Lösung liefern. Kompliziertere Anwendungen benötigen zum Beispiel eventuell zusätzlichen Code, den Agent Builder nicht standardmäßig generiert, wie Code zum Hinzufügen von Validierungsprüfungen für zusätzliche Eigenschaften oder zum Einstellen von Parametern, die Agent Builder nicht vorgibt. In diesen Fällen müssen Sie Änderungen an dem generierten Quellcode oder an der RTR-Datei vornehmen. Agent Builder ist für diese flexible Arbeitsweise besonders geeignet.

Agent Builder fügt an bestimmten Stellen des generierten Quellcodes Kommentare ein. Hier können Sie Ihren eigenen spezifischen Ressourcentypcode hinzufügen. Nachdem Sie den Quellcode geändert haben, können Sie das von Agent Builder generierte Makefile verwenden, um den Quellcode neu zu kompilieren und das Ressourcentyppaket neu zu generieren.

Selbst wenn Sie den gesamten Ressourcentypcode selbst schreiben und keinen von Agent Builder generierten Code verwenden, können Sie das von Agent Builder bereitgestellte Makefile und die Struktur zum Erstellen eines Solaris-Pakets für Ihren Ressourcentyp nutzen.

Installieren und Konfigurieren von Agent Builder

Agent Builder muss nicht eigens installiert werden. Das Tool ist im SUNWscdev-Paket enthalten, das standardmäßig als Teil einer Sun Cluster-Standardsoftwareinstallation installiert wird. Weitere Informationen hierzu finden Sie im Sun Cluster Software Installation Guide for Solaris OS. Folgende Informationen sollten vor der Verwendung von Agent Builder überprüft werden.

• Java ist in der $PATH-Variable enthalten. Agent Builder hängt von Java (Java Development Kit, Version 1.3.1 oder höher) ab, und wenn Java nicht in der $PATH-Variable vorhanden ist, gibt scdsbuilder eine Fehlermeldung zurück.

• Sie haben die Softwaregruppe “Entwicklersystemunterstützung” von Solaris 8 oder höher installiert.

• Der cc-Compiler ist in der $PATH-Variablen enthalten. Agent Builder verwendet den ersten Eintrag von cc in der $PATH-Variablen, um den Compiler zu identifizieren, mit dem C-Binärcode für den Ressourcentyp generiert wird. Wenn cc nicht in $PATH enthalten ist, deaktiviert Agent Builder die Option, C-Code zu generieren (siehe Verwenden des Bildschirms “Create”).

Mit Agent Builder kann auch ein anderer Compiler als der cc-Standard-Compiler verwendet werden. Eine Möglichkeit ist das Erstellen einer symbolischen Verknüpfung in $PATH von cc zu einem anderen Compiler, wie gcc. Es kann auch die Compiler-Spezifikation im Makefile (aktuell CC=cc) in den vollständigen Pfad für einen anderen Compiler geändert werden. Ändern Sie zum Beispiel im von Agent Builder generierten Makefile CC=cc in CC=Pfadname/gcc. In diesem Fall können Sie Agent Builder nicht direkt ausführen, sondern müssen die Befehle make und make pkg ausführen, um Datendienstcode und ein Paket zu generieren.

Starten von Agent Builder

Agent Builder wird durch die Eingabe des folgenden Befehls gestartet:

% /usr/cluster/bin/scdsbuilder

Der Startbildschirm von Sun Builder wird angezeigt (siehe die folgende Abbildung).

Abbildung 9–1 Startbildschirm

Auf Agent Builder kann über eine Befehlszeilenschnittstelle zugegriffen werden (siehe Verwenden der Befehlszeilenversion von Agent Builder), wenn der Zugriff auf die GUI-Version nicht möglich ist.

Agent Builder verfügt über zwei Bildschirme, die Sie durch die Erstellung eines neuen Ressourcentyps führen:

1. Create—In diesem Bildschirm geben Sie grundlegende Informationen zu den zu erstellenden Ressourcentyp ein, wie den Namen und das Arbeitsverzeichnis (das heißt das Verzeichnis, in dem Sie die Ressourcentypvorlage erstellen und konfigurieren) für die generierten Dateien. Hier wird auch festgelegt, welche Art Ressource erstellt wird (Scalable oder Failover), ob die Basisanwendung Netzwerkunterstützung hat (das heißt, ob sie das Netzwerk für die Kommunikation mit den Clients verwendet), sowie der zu generierende Codetyp (C, ksh oder GDS). Weitere Informationen zu GDS (Generic Data Service) finden Sie in Kapitel 10. Sie müssen die Informationen in diesen Bildschirm eingeben und Create auswählen, um die entsprechende Ausgabe zu generieren, bevor der Bildschirm “Configure” angezeigt werden kann.

2. Configure—Auf diesem Bildschirm werden Sie aufgefordert, einen Befehl zum Starten der Anwendung anzugeben. Optional können Sie Befehle zum Stoppen und Testen der Anwendung angeben. Wenn Sie diese Befehle nicht angeben, verwendet die generierte Ausgabe Signale zum Stoppen der Anwendung und stellt einen Standard-Testsignalmechanismus bereit (siehe die Beschreibung des Testsignal-Befehls in Verwenden des Bildschirms “Configure”). Über diesen Bildschirm können auch die Zeitüberschreitungswerte für jeden dieser drei Befehle geändert werden.

Wenn Sie Agent Builder vom Arbeitsverzeichnis für einen vorhandenen Ressourcentyp aus starten, initialisiert Agent Builder die Bildschirme “Create” und “Configure” mit den Werten des vorhandenen Ressourcentyps.

Siehe Navigieren in Agent Builder bei Fragen zur Verwendung der Schaltflächen oder Menübefehle für die Agent Builder-Bildschirme.

Verwenden des Bildschirms “Create”

Als erster Schritt für die Erstellung eines Ressourcentyps muss der Bildschirm “Create” ausgefüllt werden. Dieser Bildschirm wird beim Starten von Agent Builder angezeigt. Die folgende Abbildung zeigt den Bildschirm “Create” nach der Eingabe von Informationen in die Felder.

Abbildung 9–2 Bildschirm “Create”

Der Bildschirm “Create” enthält die folgenden Felder, Optionsfelder und Kontrollkästchen:

• Vendor Name — Ein Name zur Identifizierung des Ressourcentypherstellers. In der Regel wird das Börsensymbol des Herstellers angegeben. Es ist jedoch ein beliebiger Name gültig, der den Hersteller eindeutig identifiziert. Es dürfen nur alphanumerische Zeichen verwendet werden.

• Application Name — Der Name des Ressourcentyps. Es dürfen nur alphanumerische Zeichen verwendet werden.

  ---

  Hinweis –

  Der vollständige Name des Ressourcentyps setzt sich aus Herstellername und Anwendungsname zusammen. Dieser vollständige Name darf nicht länger als neun Zeichen sein.

  ---

• Working Directory — Das Arbeitsverzeichnis, unter dem Agent Builder eine Verzeichnisstruktur erstellt, in der alle für den Zielressourcentyp erstellten Dateien abgelegt werden. In einem Arbeitsverzeichnis kann jeweils nur ein Ressourcentyp erstellt werden. Agent Builder initialisiert dieses Feld mit dem Pfad zu dem Verzeichnis, von dem aus Sie Agent Builder gestartet haben. Sie können jedoch einen anderen Namen eingeben oder die Schaltfläche Browse verwenden, um ein anderes Verzeichnis zu suchen.

  Unter dem Arbeitsverzeichnis erstellt Agent Builder ein Unterverzeichnis mit dem Ressourcentypnamen. Wenn zum Beispiel SUNW der Herstellername und ftp der Anwendungsname ist, nennt Agent Builder das Unterverzeichnis SUNWftp.

  Agent Builder legt alle Verzeichnisse und Dateien für den Zielressourcentyp unter diesem Unterverzeichnis ab (siehe Verzeichnisstruktur).

• Scalable oder Failover — Geben Sie an, ob der Zielressourcentyp Failover oder Scalable sein soll.

• Network Aware — Geben Sie an, ob die Basisanwendung über Netzwerkunterstützung verfügt, das heißt, ob sie das Netzwerk für die Kommunikation mit den Clients verwendet. Aktivieren Sie das Kontrollkästchen, um Netzwerkunterstützung anzugeben bzw. lassen Sie es deaktiviert, um Ohne Netzwerkunterstützung anzugeben. Korn-Shell-Code erfordert, dass die Anwendung über Netzwerkunterstützung verfügt. Daher aktiviert Agent Builder dieses Kontrollkästchen und stellt es abgeblendet dar, wenn Sie das Optionsfeld ksh oder GDS aktivieren.

• C, ksh — Geben Sie die Sprache des generierten Quellcodes an. Obwohl sich diese Optionen gegenseitig ausschließen, können Sie mit Agent Builder einen Ressourcentyp mit ksh-generiertem Code erstellen und dann dieselben Informationen zum Erstellen von C-generiertem Code verwenden (siehe Klonen eines vorhandenen Ressourcentyps).

• GDS — Gibt an, dass dieser Dienst ein generischer Datendienst ist. Informationen zum Erstellen und Konfigurieren eines generischen Datendienstes finden Sie in Kapitel 10.

Wenn sich der cc-Compiler nicht in $PATH befindet, stellt Agent Builder das C-Optionsfeld abgeblendet dar und aktiviert das Feld ksh. Informationen zum Angeben eines anderen Compilers finden Sie im Hinweis am Ende von Installieren und Konfigurieren von Agent Builder.

Klicken Sie nach Eingabe der erforderlichen Informationen auf die Schaltfläche Create. Das Ausgabeprotokoll unten im Bildschirm zeigt an, welche Aktionen Agent Builder ausführt. Sie können im Menü “Edit” den Befehl Save Output Log verwenden, um die Informationen im Ausgabeprotokoll zu speichern.

Anschließend zeigt Agent Builder entweder eine Erfolgsmeldung oder eine Warnmeldung an, die darauf hinweist, dass dieser Schritt nicht ausgeführt werden konnte, und dass Sie dem Ausgabeprotokoll weitere Einzelheiten entnehmen können.

Wenn Agent Builder erfolgreich beendet wird, können Sie auf Next klicken, um den Bildschirm “Configure” anzuzeigen. Dort können Sie die Generierung des Ressourcentyps fertig stellen.

Obwohl sich der Prozess zum Generieren eines vollständigen Ressourcentyps aus zwei Schritten zusammensetzt, können Sie Agent Builder nach Beenden des ersten Schritts (Create) beenden, ohne die eingegebenen Informationen oder die von Agent Builder geleistete Arbeit zu verlieren (siehe Wiederverwenden fertiger Arbeiten).

Verwenden des Bildschirms “Configure”

In der folgenden Abbildung wird der Bildschirm “Configure” gezeigt. Dieser Bildschirm wird angezeigt, nachdem Agent Builder die Erstellung des Ressourcentyps beendet hat und Sie im Bildschirm “Create” auf Next geklickt haben. Auf den Bildschirm “Configure” kann erst dann zugegriffen werden, wenn der Ressourcentyp erstellt worden ist.

Abbildung 9–3 Bildschirm “Configure”

Der Bildschirm “Configure” enthält folgende Felder:

• Start Command — Die vollständige Befehlszeile, die an eine beliebige UNIX-Shell übergeben werden kann, um die Basisanwendung zu starten. Die Angabe dieses Befehls ist erforderlich. Sie können ihn in das dafür vorgesehene Feld eingeben oder mit der Schaltfläche Browse die Datei suchen, die den Startbefehl für die Anwendung enthält.

  Die vollständige Befehlszeile muss alle erforderlichen Parameter zum Starten der Anwendung enthalten, wie Hostnamen, Port-Nummern, einen Pfad zu Konfigurationsdateien usw. Wenn für die Anwendung ein Hostname an der Befehlszeile angegeben werden muss, können Sie die von Agent Builder definierte $hostnames-Variable verwenden (siehe Verwenden der $hostnames-Variablen von Agent Builder).

  Der Befehl darf nicht in doppelten Anführungszeichen stehen (““).

  ---

  Hinweis –

  Wenn die Basisanwendung über mehrere unabhängige Prozessbaumstrukturen verfügt, von denen jede unter einer eigenen Markierung unter PMF-Steuerung gestartet wird, kann kein einzelner Befehl angegeben werden. Stattdessen müssen Sie eine Textdatei mit den einzelnen Befehlen zum Starten jeder Prozessbaumstruktur erstellen und im Textfeld “Start Command“ den Pfad zu dieser Datei angeben. In Erstellen von Ressourcentypen mit mehreren unabhängigen Prozessbaumstrukturen finden Sie Informationen zu einigen speziellen Eigenschaften, die diese Datei erfüllen muss, um ordnungsgemäß zu funktionieren.

  ---

• Stop Command — Die vollständige Befehlszeile, die an eine beliebige UNIX-Shell übergeben werden kann, um die Basisanwendung zu stoppen. Sie können den Befehl in das dafür vorgesehene Feld eingeben oder die Schaltfläche “Browse” verwenden, um die Datei zu suchen, die den Stopp-Befehl für die Anwendung enthält. Wenn für die Anwendung ein Hostname an der Befehlszeile eingegeben werden muss, können Sie die von Agent Builder definierte $hostnames-Variable verwenden (siehe Verwenden der $hostnames-Variablen von Agent Builder).

  Dieser Befehl ist optional. Wenn Sie keinen Stopp-Befehl angeben, verwendet der generierte Code die folgenden Signale (in der Stop-Methode), um die Anwendung zu stoppen.

  • Die Stop-Methode sendet SIGTERM, um die Anwendung zu stoppen, und wartet 80% des Zeitüberschreitungswertes darauf, dass die Anwendung beendet wird.

  • Wenn das SIGTERM-Signal nicht erfolgreich ist, sendet die Stop-Methode SIGKILL, um die Anwendung zu stoppen, und wartet während 15% des Zeitüberschreitungswertes darauf, dass die Anwendung beendet wird.

  • Wenn SIGKILL nicht erfolgreich ist, wird die Stop-Methode erfolglos beendet (die restlichen 5% des Zeitüberschreitungswertes werden als Überlauf betrachtet).

  ---

  Achtung –

  Stellen Sie sicher, dass der Stopp-Befehl keine Antwort zurückgibt, bevor die Anwendung vollständig gestoppt wurde.

  ---

• Probe Command — Ein Befehl, der in regelmäßigen Abständen ausgeführt werden kann, um die Anwendung auf Fehler zu überprüfen und einen entsprechenden Beendigungsstatus zwischen 0 (Erfolg) und 100 (Totalfehlschlag) zurückzugeben. Dieser Befehl ist optional. Sie können den gesamten Pfad zum Befehl eingeben oder mit der Schaltfläche “Browse” die Datei suchen, die den Befehl für das Testen der Anwendung enthält.

  In der Regel wird ein einfacher Client der Basisanwendung angegeben. Wenn Sie keinen Testsignal-Befehl angeben, stellt der generierte Code einfach Verbindungen mit dem von der Ressource verwendeten Port her und trennt diese wieder. Wenn dieser Vorgang erfolgreich verläuft, wird die Anwendung als fehlerfrei deklariert. Der Testsignal-Befehl kann nur für Anwendungen mit Netzwerkunterstützung verwendet werden. Agent Builder generiert immer einen Testsignal-Befehl. Für Anwendungen ohne Netzwerkunterstützung wird dieser jedoch deaktiviert.

  Wenn für die Anwendung an der Testsignal-Befehlszeile ein Hostname angegeben werden muss, können Sie die von Agent Builder definierte $hostnames-Variable verwenden (siehe Verwenden der $hostnames-Variablen von Agent Builder).

• Timeout — (für jeden Befehl) — Ein Zeitüberschreitungswert in Sekunden für jeden Befehl. Sie können einen neuen Wert angeben oder den von Agent Builder vorgegebenen Standardwert (300 Sekunden für “start” und “stop”, 30 Sekunden für “probe”) akzeptieren.

Verwenden der $hostnames-Variablen von Agent Builder

Für viele Anwendungen, insbesondere Anwendungen mit Netzwerkunterstützung, muss der Hostname, auf dem die Anwendung Kundenanforderungen abhört und beantwortet, der Anwendung an der Befehlszeile angegeben werden. Daher ist der Hostname in vielen Fällen ein Parameter, der für Start-, Stopp- und Testsignal-Befehle für den Zielressourcentyp angegeben werden muss (auf dem Bildschirm “Configure”). Der Hostname, auf dem die Anwendung abhört, ist jedoch Cluster-spezifisch—er wird festgelegt, wenn die Ressource auf einem Cluster ausgeführt wird und kann nicht festgelegt werden, wenn Agent Builder den Ressourcentypcode generiert.

Zum Beheben dieses Problems stellt Agent Builder die $hostnames-Variable bereit, die Sie an der Befehlszeile für die Start-, Stopp- und Testsignal-Befehle angeben können. Sie geben die $hostnames-Variable genau so an, wie Sie dies mit einem tatsächlichen Hostnamen tun würden, zum Beispiel:

/opt/network_aware/echo_server -p Port-Nummer -l $hostnames

Wenn eine Ressource des Zielressourcentyps auf einem Cluster ausgeführt wird, ersetzt der für diese Ressource konfigurierte LogicalHostname bzw. SharedAddress-Hostname für die Ressource (in der Ressourceneigenschaft Network_resources_used der Ressource) den Wert der $hostnames-Variablen.

Wenn Sie die Eigenschaft Network_resources_used mit mehreren Hostnamen konfigurieren, enthält die $hostnames alle Hostnamen, durch Komma voneinander getrennt.

Erstellen von Ressourcentypen mit mehreren unabhängigen Prozessbaumstrukturen

Agent Builder kann Ressourcentypen für Anwendungen erstellen, die über mehr als eine unabhängige Prozessbaumstruktur verfügen. Diese Prozessbaumstrukturen sind unabhängig in dem Sinn, dass sie PMF-Monitoren einzeln starten und anhalten. PMF startet jede dieser Prozessbaumstrukturen mit ihrer eigenen Markierung.

Agent Builder ermöglicht das Erstellen von Ressourcentypen mit mehreren unabhängigen Prozessbaumstrukturen nur dann, wenn der angegebene generierte Quellcode C ist. Für das Erstellen dieser Ressourcentypen für ksh oder für GDS kann Agent Builder nicht eingesetzt werden. Der Code zum Erstellen dieser Ressourcentypen für ksh oder für GDS muss manuell geschrieben werden.

Im Fall einer Basisanwendung mit mehreren unabhängigen Prozessbaumstrukturen können Sie keinen einzelnen Befehl für das Starten der Anwendung angeben. Stattdessen muss eine Textdatei erstellt werden, in der jede Zeile den vollständigen Pfad zum Start-Befehl für eine der Prozessbaumstrukturen der Anwendung enthält. Diese Datei darf keine Leerzeilen enthalten. Sie können diese Textdatei im Textfeld “Start Command” im Bildschirm “Configure” angeben.

Wenn sichergestellt ist, dass diese Datei nicht über Ausführungsberechtigungen verfügt, kann Agent Builder die Datei, die dem Starten von mehreren Prozessbaumstrukturen dient, von einem einfachen ausführbaren Skript mit mehreren Befehlen unterscheiden. Wenn die Textdatei Ausführungsberechtigungen enthält, werden zwar die Ressourcen auf einem Cluster ohne Probleme oder Fehler hochgeladen. Alle Befehle werden jedoch unter einer einzigen PMF-Markierung gestartet, was die Möglichkeit ausschließt, die Prozessbaumstrukturen einzeln mit PMF zu überwachen und neu zu starten.

Wiederverwenden fertiger Arbeiten

Agent Builder bietet mehrere Möglichkeiten zur weiteren Nutzung bereits fertig gestellter Arbeiten.

• Sie können einen mit Agent Builder erstellten vorhandenen Ressourcentyp klonen.

• Sie können den von Agent Builder generierten Quellcode bearbeiten und dann den Code neu kompilieren, um ein neues Paket zu erstellen.

Klonen eines vorhandenen Ressourcentyps

Führen Sie dieses Verfahren aus, um einen von Agent Builder erstellten vorhandenen Ressourcentyp zu klonen.

1. Laden Sie einen vorhandenen Ressourcentyp in Agent Builder. Dafür gibt es zwei Möglichkeiten:

   1. Starten Sie Agent Builder von dem Arbeitsverzeichnis aus, das die rtconfig-Datei für einen mit Agent Builder erstellten vorhandenen Ressourcentyp enthält. Daraufhin lädt Agent Builder die Werte für diesen Ressourcentyp in die Bildschirme “Create” und “Configure”.

   2. Verwenden Sie im Menü “File” den Befehl Load Resource Type.

2. Ändern Sie das Arbeitsverzeichnis im Bildschirm “Create”.

   Sie müssen die Schaltfläche Browse zum Auswählen eines Verzeichnisses verwenden — das Eingeben eines neuen Verzeichnisnamens reicht nicht aus. Nach Auswahl des Verzeichnisses aktiviert Agent Builder die Schaltfläche Create wieder.

3. Nehmen Sie Änderungen vor.

   Mit diesem Verfahren können Sie den für den Ressourcentyp generierten Codetyp ändern. Wenn Sie zum Beispiel zunächst eine ksh-Version eines Ressourcentyps erstellen, dann aber feststellen, dass Sie eine C-Version benötigen, können Sie den vorhandenen ksh-Ressourcentyp laden, die Sprache für die Ausgabe in C ändern und Agent Builder eine C-Version des Ressourcentyps erstellen lassen.

4. Erstellen Sie den geklonten Ressourcentyp.

   Wählen Sie Create aus, um den Ressourcentyp zu erstellen. Wählen Sie Next, um den Bildschirm “Configure” zu öffnen. Wählen Sie Configure aus, um den Ressourcentyp zu konfigurieren und dann Cancel, um den Vorgang zu beenden.

Bearbeiten des generierten Quellcodes

Um den Prozess für die Erstellung eines Ressourcentyps einfach zu halten, beschränkt Agent Builder die Anzahl der Eingaben. Dadurch werden natürlich auch die Einsatzmöglichkeiten für den generierten Ressourcentyp eingeschränkt. Um daher komplexere Funktionen wie zum Beispiel Validierungsprüfungen für zusätzliche Eigenschaften hinzuzufügen oder von Agent Builder nicht vorgegebene Parameter einzustellen, müssen Sie den generierten Quellcode oder die RTR-Datei ändern.

Die Quelldateien befinden sich im Verzeichnis Installationsverzeichnis/RT_Name/src. Agent Builder bettet an den Stellen im Quellcode, an denen Sie Code hinzufügen können, Kommentare ein. Diese Kommentare haben für C-Code folgende Form:

/* Vom Benutzer hinzugefügter Code -- BEGIN vvvvvvvvvvvvvvv */
/* Vom Benutzer hinzugefügter Code -- END   ^^^^^^^^^^^^^^^ */

Diese Kommentare sind in Korn-Shell-Code identisch; bis auf das Pfundzeichen (#), mit dem die Kommentarzeile beginnt.

Zum Beispiel deklariert RT_Name.h alle Dienstprogrammroutinen, welche die verschiedenen Programme verwenden. Am Ende der Deklarationenliste befinden sich Kommentare, mit denen Sie weitere Routinen deklarieren können, die Sie einem der Codes hinzugefügt haben können.

Agent Builder generiert auch das Makefile im Verzeichnis Installationsverzeichnis/RT_Name/src mit entsprechenden Zielen. Verwenden Sie den make-Befehl, um den Quellcode neu zu kompilieren und den make pkg-Befehl zur Neugenerierung des Ressourcentyppakets.

Die RTR-Datei befindet sich im Verzeichnis Installationsverzeichnis/ RT_Name/etc. Sie können die RTR-Datei mit einem Standard-Textverarbeitungsprogramm bearbeiten (siehe Einstellen der Ressourcen- und Ressourcentypeigenschaften für weitere Informationen zur RTR-Datei und Anhang A für Informationen zu Eigenschaften).

Verwenden der Befehlszeilenversion von Agent Builder

Die Befehlszeilenversion von Agent Builder besteht aus demselben Zwei-Schritte-Prozess wie die grafische Benutzeroberfläche. Anstatt die Informationen auf der grafischen Benutzeroberfläche einzugeben, übergeben Sie Parameter an die Befehle scdscreate( 1HA) und scdsconfig(1HA).

Führen Sie folgende Schritte aus, um die Befehlszeilenversion von Agent Builder zu verwenden.

1. Erstellen Sie mit dem Befehl scdscreate eine Sun Cluster-Ressourcentypvorlage, um eine Anwendung mit hoher Verfügbarkeit (HA) oder Skalierbarkeit auszustatten.

2. Verwenden Sie scdsconfig, um die mit scdscreate erstellte Ressourcentypvorlage zu konfigurieren.

3. Ändern Sie die Verzeichnisse in das pkg-Unterverzeichnis im Arbeitsverzeichnis.

4. Verwenden Sie den Befehl pkgadd(1M), um die mit scdscreate erstellten Pakete zu installieren.

5. Falls gewünscht, können Sie den generierten Quellcode bearbeiten.

6. Führen Sie das Start-Skript aus.

Verzeichnisstruktur

Agent Builder erstellt eine Verzeichnisstruktur, in der alle für den Zielressourcentyp erstellten Dateien abgelegt werden. Im Bildschirm Create geben Sie das Arbeitsverzeichnis an. Sie müssen für jeden weiteren entwickelten Ressourcentyp ein eigenes Installationsverzeichnis angeben. Unter dem Arbeitsverzeichnis erstellt Agent Builder ein Unterverzeichnis, dessen Name eine Verkettung aus dem Herstellernamen und dem Ressourcentypnamen ist (aus dem Bildschirm Create). Wenn Sie zum Beispiel SUNW als Herstellername angeben und einen Ressourcentyp mit dem Namen ftp erstellen, erstellt Agent Builder ein Verzeichnis mit dem Namen SUNWftp unter dem Arbeitsverzeichnis.

Unter diesem Unterverzeichnis erstellt und füllt Agent Builder die in der folgenden Tabelle aufgelisteten Verzeichnisse aus.

Ausgabe

Dieser Abschnitt beschreibt die von Agent Builder generierte Ausgabe.

Quell- und Binärdateien

Ressourcentyp-Manager (RGM)—der Ressourcengruppen und damit auch Ressourcen auf einem Cluster verwaltet—arbeitet mit einem Rückmeldemodell. Wenn spezifische Ereignisse auftreten, wie zum Beispiel ein Knotenversagen, ruft RGM die Ressourcentypmethoden für jede der auf dem betroffenen Knoten ausgeführten Ressourcen auf. RGM ruft zum Beispiel die Stop-Methode auf, um eine auf dem betroffenen Knoten ausgeführte Ressource zu stoppen. Dann ruft das Programm die Start-Methode der Ressource auf, um sie auf einem anderen Knoten neu zu starten. (Weitere Informationen zu diesem Modell finden Sie unter RGM-Modell, Rückmeldemethoden und der Online-Dokumentation unter rt_callbacks( 1HA).

Zur Unterstützung dieses Modells generiert Agent Builder im Verzeichnis Installationsverzeichnis/RT_Name/bin acht ausführbare Programme (C) bzw. Skripts (ksh), die als Rückmeldemethoden dienen.

Streng genommen ist das Programm RT_Name_probe, das einen Fehler-Monitor implementiert, kein Rückmeldeprogramm. RGM ruft RT_Name_probe nicht direkt auf, sondern ruft RT_Name_monitor_start und RT_Name_monitor_stop, auf, um den Fehler-Monitor durch Aufrufen von RT_Name_probe zu starten und zu stoppen.

Die acht von Agent Builder generierten Methoden sind folgende:

• RT_Name_monitor_check

• RT_Name_monitor_start

• RT_Name_monitor_stop

• RT_Name_probe

• RT_Name_svc_start

• RT_Name_svc_stop

• RT_Name_update

• RT_Name_validate

Spezifische Informationen zu jeder dieser Methoden finden Sie in der Online-Dokumentation unter rt_callbacks( 1HA).

Im Verzeichnis Installationsverzeichnis/RT_Name/src (C-Ausgabe) generiert Agent Builder die folgenden Dateien:

• Eine Header-Datei (RT_Name.h).

• Eine Quelldatei (RT_Name.c), die den für alle Methoden gemeinsamen Code enthält.

• Eine Objektdatei (RT_Name.o) für den gemeinsamen Code.

• Quelldateien (*.c) für jede der Methoden.

• Objektdateien (*.o) für jede der Methoden.

Agent Builder verknüpft die RT_Name.o-Datei mit jeder der .o-Dateien der Methode, um die ausführbaren Dateien im Verzeichnis Installationsverzeichnis/RT_Name/bin zu erstellen.

Für ksh-Ausgabe sind die Installationsverzeichnis /Rt_Name/bin- und Installationsverzeichnis/Rt_Name/src-Verzeichnisse identisch—beide enthalten die acht ausführbaren Skripts, die den sieben Rückmeldemethoden und der PROBE-Methode entsprechen.

Die ksh-Ausgabe enthält zwei kompilierte Dienstprogramme (gettime und gethostnames), die von bestimmten Rückmeldemethoden zum Abrufen der Zeit und zum Testen benötigt werden.

Sie können den Quellcode bearbeiten und den make-Befehl zum Neukompilieren des Codes ausführen. Anschließend führen Sie den make pkg-Befehl aus, um ein neues Paket zu generieren. Als Unterstützung für die Änderung des Quellcodes bettet Agent Builder Kommentare an denjenigen Stellen im Quellcode ein, an denen Code hinzugefügt werden kann. Siehe Bearbeiten des generierten Quellcodes.

Dienstprogrammskripts und Online-Dokumentation

Nach dem Generieren eines Ressourcentyps und Installieren des entsprechenden Pakets auf einem Cluster müssen Sie noch eine Instanz (Ressource) des Ressourcentyps auf einem Cluster ausführen können. Hierzu werden gewöhnlich Verwaltungsbefehle oder SunPlex-Manager eingesetzt. Zur Vereinfachung generiert Agent Builder jedoch ein angepasstes Dienstprogrammskript für diesen Zweck (das Start-Skript), sowie Skripts zum Stoppen und Entfernen einer Ressource aus dem Zielressourcentyp. Diese drei Skripts befinden sich im Verzeichnis Installationsverzeichnis/RT_Name/util und führen folgende Aufgaben aus:

• Start-Skript — Registriert den Ressourcentyp und erstellt die erforderlichen Ressourcengruppen und Ressourcen. Es erstellt auch die Netzwerkadressressourcen (LogicalHostname bzw. SharedAddress), mit denen die Anwendung mit den Clients im Netzwerk kommunizieren kann.

• Stop-Skript — Stoppt und deaktiviert die Ressource.

• Remove-Skript — Macht die Aktion des Start-Skripts rückgängig; das heißt, es stoppt die Ressourcen, Ressourcengruppen und den Zielressourcentyp und entfernt sie aus dem System.

Sie können das Remove-Skript nur für eine Ressource verwenden, die mit dem entsprechenden Start-Skript gestartet wurde, da diese Skripts interne Konventionen für die Namensgebung für Ressourcen und Ressourcengruppen verwenden.

Agent Builder benennt diese Skripts, indem der Anwendungsname an den Skriptnamen angehängt wird. Wenn der Anwendungsname zum Beispiel ftp lautet, heißen die Skripts startftp, stopftp und removeftp.

Agent Builder stellt im Verzeichnis Installationsverzeichnis/RT_Name/man/man1m Online-Dokumentation für jedes der Dienstprogrammskripts bereit. Lesen Sie diese Online-Dokumentation vor dem Starten der Skripts, da sie die Parameter enthält, die Sie in das Skript übertragen müssen.

Zum Anzeigen der Online-Dokumentation geben Sie den Pfad zum man-Verzeichnis an, indem Sie die Option -M mit dem man-Befehl verwenden. Wenn zum Beispiel SUNW der Hersteller und ftp der Anwendungsname ist, verwenden Sie folgenden Befehl, um die startftp(1M)-Online-Dokumentation anzuzeigen:

man -M Installationsverzeichnis/SUNWftp/man startftp

Die Dienstprogrammskripts der Online-Dokumentation stehen auch dem Cluster-Verwalter zur Verfügung. Wenn ein von Agent Builder generiertes Paket auf einem Cluster installiert ist, wird die Online-Dokumentation für die Dienstprogrammskripts im Verzeichnis /opt/RT_Name/man abgelegt. Verwenden Sie z. B. folgenden Befehl, um die Online-Dokumentation zu startftp(1M) anzuzeigen:

man -M /opt/SUNWftp/man startftp

Unterstützungsdateien

Agent Builder legt Unterstützungsdateien, wie pkginfo, postinstall, postremove und preremove im Verzeichnis Installationsverzeichnis/RT_Name/etc ab. Dieses Verzeichnis enthält auch die Ressourcentyp-Registrierungsdatei (RTR-Datei), welche die Ressourcen- und Ressourcentypeigenschaften deklariert, die dem Zielressourcentyp zur Verfügung stehen, und Eigenschaftswerte initialisiert, wenn eine Ressource bei einem Cluster registriert wird (weitere Informationen finden Sie unter Einstellen der Ressourcen- und Ressourcentypeigenschaften). Die RTR-Datei erhält den Namen Herstellername.Ressourcentypname—z. B. SUNW.ftp.

Sie können diese Datei mit einem Standard-Textverarbeitungsprogramm bearbeiten und Änderungen vornehmen, ohne den Quellcode neu zu kompilieren. Sie müssen jedoch das Paket mit dem make pkg-Befehl neu zusammenstellen.

Paketverzeichnis

Das Verzeichnis Installationsverzeichnis/RT_Name/pkg enthält ein Solaris-Paket. Der Paketname ist eine Verkettung des Herstellernamens mit dem Anwendungsnamen, zum Beispiel SUNWftp. Das Makefile im Verzeichnis Installationsverzeichnis/RT_Name/src unterstützt die Erstellung eines neuen Pakets. Wenn Sie zum Beispiel Änderungen an den Quelldateien vornehmen und den Code neu kompilieren, oder wenn Sie Änderungen an den Paket-Dienstprogrammskripts vornehmen, verwenden Sie den make pkg-Befehl, um ein neues Paket zu erstellen.

Wenn Sie ein Paket aus einem Cluster entfernen, kann der pkgrm-Befehl fehlschlagen, wenn Sie versuchen, den Befehl auf mehr als einem Knoten aus gleichzeitig auszuführen. Sie können dieses Problem auf zwei Arten lösen:

• Führen Sie das Skript removeRT_Name auf einem Cluster-Knoten aus, bevor Sie pkgrm auf einem Knoten ausführen.

• Führen Sie pkgrm auf einem der Knoten im Cluster aus. Dadurch wird die erforderliche Bereinigung ausgeführt. Führen Sie dann pkgrm auf den restlichen Knoten aus; bei Bedarf auch gleichzeitig.

Wenn pkgrm fehlschlägt, weil Sie die Ausführung auf mehreren Knoten gleichzeitig versuchen, führen Sie den Befehl noch einmal auf einem Knoten und dann auf den restlichen Knoten aus.

Die rtconfig-Datei

Wenn Sie C- oder ksh-Quellcode generieren, generiert Agent Builder eine Konfigurationsdatei rtconfig, welche die an den Bildschirmen “Create” und “Configure” eingegebenen Informationen enthält. Wenn Sie Agent Builder vom Arbeitsverzeichnis für einen vorhandenen Ressourcentyp aus starten bzw. wenn Sie einen vorhandenen Ressourcentyp im Menü “File” über den Befehl Load Resource Type laden, liest Agent Builder die rtconfig-Datei und füllt die Bildschirme “Create” und “Configure” mit den für den vorhandenen Ressourcentyp bereitgestellten Informationen aus. Diese Funktion ist nützlich, wenn Sie einen vorhandenen Ressourcentyp klonen möchten (siehe Klonen eines vorhandenen Ressourcentyps).

Navigieren in Agent Builder

Das Navigieren in Agent Builder ist einfach und intuitiv. Agent Builder ist ein Assistent, der aus zwei Schritten mit jeweils zugehörigem Bildschirm (Bildschirme “Create” und “Configure”) besteht. So geben Sie Informationen in jedem Bildschirm ein:

• Geben Sie Informationen in ein Feld ein.

• Durchsuchen Sie die Verzeichnisstruktur, und wählen Sie eine Datei bzw. ein Verzeichnis aus.

• Aktivieren Sie eines der sich gegenseitig ausschließenden Optionsfelder — zum Beispiel Scalable oder Failover.

• Aktivieren/Deaktivieren Sie ein Kontrollkästchen. Wenn Sie zum Beispiel Network Aware aktivieren, wird die Basisanwendung als Anwendung mit Netzwerkunterstützung identifiziert. Ein deaktiviertes Kontrollkästchen identifiziert dagegen eine Anwendung ohne Netzwerkunterstützung.

Mit den Schaltflächen unten auf jedem Bildschirm können Sie die Aufgabe beenden, zum nächsten bzw. vorherigen Bildschirm gehen oder Agent Builder beenden. Agent Builder kann diese Schaltflächen entsprechend aktivieren bzw. deaktivieren (abgeblendet darstellen).

Wenn Sie zum Beispiel die Felder ausgefüllt und die gewünschten Optionen auf dem Bildschirm “Create” aktiviert haben, klicken Sie unten im Bildschirm auf Create. Die Schaltflächen Previous und Next sind abgeblendet dargestellt, da kein vorheriger Bildschirm vorhanden ist und Sie nicht zum nächsten Schritt weitergehen können, bevor dieser Schritt beendet ist.

Agent Builder zeigt Fortschrittsmeldungen im Ausgabeprotokollbereich unten auf dem Bildschirm an. Wenn Agent Builder die Ausführung fertig gestellt hat, wird eine Erfolgsmeldung angezeigt, bzw. eine Warnmeldung, die zum Einsehen des Ausgabeprotokolls auffordert. Die Schaltfläche Next ist hervorgehoben. Falls es sich um den letzten Bildschirm handelt, ist nur die Schaltfläche Cancel hervorgehoben.

Sie können jederzeit Cancel wählen, um Agent Builder zu beenden.

Schaltfläche “Browse”

In bestimmte Agent Builder-Felder können Sie Informationen eingeben oder auf die Schaltfläche Browse klicken, um die Verzeichnisstruktur zu durchsuchen und eine Datei oder ein Verzeichnis auszuwählen.

Wenn Sie auf Browse klicken, wird ein Bildschirm entsprechend der folgenden Abbildung angezeigt.

Doppelklicken Sie auf einen Ordner, um ihn zu öffnen. Wenn Sie eine Datei markieren, wird der Name im Feld File name angezeigt. Klicken Sie auf Select, wenn Sie die gewünschte Datei gefunden und markiert haben.

Wenn Sie nach einem Verzeichnis suchen, markieren Sie es, und wählen Sie die Schaltfläche Open aus. Wenn keine Unterverzeichnisse vorhanden sind, schließt Agent Builder das Suchfenster und setzt den Namen des markierten Verzeichnisses in das entsprechende Feld. Wenn das Verzeichnis Unterverzeichnisse hat, klicken Sie auf die Schaltfläche “Close”, um das Suchfenster zu schließen und zum vorherigen Bildschirm zurückzukehren. Agent Builder setzt den Namen des markierten Verzeichnisses in das entsprechende Feld.

Die Symbole in der oberen rechten Ecke des Bildschirms haben folgende Funktionen:

Menüs

Agent Bilder verfügt über ein Menü “File” und ein Menü “Edit”.

Menü “File”

Das Menü “File” verfügt über zwei Befehle:

• Load Resource Type — Lädt einen vorhandenen Ressourcentyp. Agent Builder stellt einen Suchbildschirm bereit, von dem aus Sie das Arbeitsverzeichnis für einen vorhandenen Ressourcentyp auswählen. Wenn ein Ressourcentyp in dem Verzeichnis vorhanden ist, von dem aus Sie Agent Builder starten, lädt Agent Builder automatisch den Ressourcentyp. Der Befehl Load Resource Type ermöglicht das Starten von Agent Builder von einem beliebigen Verzeichnis aus und die Auswahl eines vorhandenen Ressourcentyps als Vorlage für das Erstellen eines neuen Ressourcentyps (siehe Klonen eines vorhandenen Ressourcentyps).

• Exit — Beendet Agent Builder. Sie können das Tool auch beenden, indem Sie im Bildschirm “Create” oder “Configure” auf Cancel klicken.

Menü “Edit”

Das Menü “Edit” enthält Befehle zum Löschen und Speichern des Ausgabeprotokolls:

• Clear Output Log — Löscht die Informationen im Ausgabeprotokoll. Jedes Mal, wenn Sie “Create” oder “Configure” auswählen, hängt Agent Builder an das Ausgabeprotokoll Statusmeldungen an. Wenn Sie wiederholt Änderungen am Quellcode vornehmen, die Ausgabe in Agent Builder neu generieren und die Statusmeldungen trennen möchten, können Sie die Protokolldatei vor jeder Verwendung speichern und löschen.

• Save Log File — Speichert das Ausgabeprotokoll in einer Datei. Agent Builder stellt einen Suchbildschirm bereit, in dem Sie ein Verzeichnis auswählen und einen Dateinamen angeben können.

Cluster Agent Module für Agent Builder

Cluster Agent Module für Agent Builder ist ein NetBeans^TM-Modul. Damit können die Benutzer des Sun Java Studio-Produkts (früher Sun ONE Studio) mithilfe einer integrierten Entwicklungsumgebung Ressourcentypen oder Datendienste für die Sun Cluster-Software erstellen. Das Cluster Agent Module verfügt über eine bildschirmbasierte Benutzeroberfläche für die Beschreibung der Art von Ressourcentyp, die erstellt werden soll.

Die Sun Java Studio-Dokumentation documentation enthält Informationen darüber, wie das Sun Java Studio-Produkt eingerichtet, installiert und verwendet wird.

Installieren und Konfigurieren von Cluster Agent Module

Cluster Agent Module wird bei der Installation der Sun Cluster-Software installiert. Das Sun Cluster-Installationstool legt die Cluster Agent Module-Datei scdsbuilder.jar in /usr/cluster/lib/scdsbuilder ab. Um Cluster Agent Module zusammen mit der Sun Java Studio-Software zu verwenden, müssen Sie eine symbolische Verknüpfung zu dieser Datei erstellen.

Die Sun Cluster- und Sun Java Studio-Produkte sowie Java ^TM 1.4 müssen auf dem System, auf dem Cluster Agent Module ausgeführt werden soll, installiert und verfügbar sein.

1. Sollen alle Benutzer oder nur Sie selbst berechtigt sein, Cluster Agent Module zu verwenden?

   • Um alle Benutzer zu aktivieren, müssen Sie als Superbenutzer angemeldet sein bzw. eine äquivalente Rolle haben und die symbolische Verknüpfung im globalen Modulverzeichnis erstellen:

     # cd /opt/s1studio/ee/modules # ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar

     ---

     Hinweis –

     Wenn Sie die Sun Java Studio-Software in einem anderen Verzeichnis als /opt/s1studio/ee installiert haben, müssen Sie diesen Verzeichnispfad durch den von Ihnen verwendeten Pfad ersetzen.

     ---

   • Wenn Sie nur sich selbst als Benutzer aktivieren möchten, erstellen Sie die symbolische Verknüpfung in Ihrem modules-Unterverzeichnis:

     % cd ~your-home-dir/ffjuser40ee/modules % ln -s /usr/cluster/lib/scdsbuilder/scdsbuilder.jar

2. Stoppen Sie die Sun Java Studio-Software und starten Sie sie erneut.

Starten von Cluster Agent Module

Die folgenden Schritte beschreiben, wie Cluster Agent Module über die Sun Java Studio-Software gestartet wird.

1. Wählen Sie im Menü “File” von Sun Java Studio die Option “New”, oder klicken Sie auf der Symbolleiste auf das entsprechende Symbol.

   Der Bildschirm “New Wizard” wird angezeigt.

2. Führen Sie im Fenster “Select a Template” gegebenenfalls einen Bildlauf nach unten aus, und klicken Sie auf den Schlüssel neben dem Ordner “Other”:

   Das Menü “Other” wird geöffnet.

3. Wählen Sie im Menü “Other” die Option “Sun Cluster Agent Builder” aus, und klicken Sie auf “Next”.

   Cluster Agent Module für Sun Java Studio wird gestartet. Der erste Bildschirm “New Wizard - Sun Cluster Agent Builder” wird angezeigt.

Verwenden von Cluster Agent Module

Cluster Agent Module wird genauso wie die Agent Builder-Software verwendet. Die Benutzeroberflächen sind identisch. Die folgende Abbildung zeigt, dass zum Beispiel der Bildschirm “Create” in der Agent Builder-Software und der erste Bildschirm “New Wizard - Sun Cluster Agent Builder” im Cluster Agent Module die gleichen Felder und die gleiche Auswahl enthalten.

Abbildung 9–4 Bildschirm “Create” in der Agent Builder-Software

Abbildung 9–5 Bildschirm “New Wizard - Sun Cluster Agent Builder” in Cluster Agent Module

Unterschiede zwischen Cluster Agent Module und Agent Builder

Trotz der Ähnlichkeiten zwischen Cluster Agent Module und Agent Builder bestehen einige kleine Unterschiede:

• In Cluster Agent Module wird der Ressourcentyp erst dann erstellt und konfiguriert, nachdem Sie im zweiten Bildschirm “New Wizard - Sun Cluster Agent Builder” auf “Finish” geklickt haben. Der Ressourcentyp wird nicht erstellt, wenn Sie im ersten Bildschirm “New Wizard - Sun Cluster Agent Builder” auf “Next” klicken.

  In Agent Builder wird der Ressourcentyp sofort erstellt, wenn Sie im Bildschirm “Create” auf “Create” klicken, und konfiguriert, wenn Sie im Bildschirm “Configure” auf “Configure” klicken.

• Die Informationen, die im Fenster “Output Log” in Agent Builder angezeigt werden, sind im Sun Java Studio-Produkt in einem eigenen Ausgabefenster enthalten.