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