test

Sun Cluster Entwicklerhandbuch Datendienste für Solaris OS

C-Funktionen

C-Funktionen werden in C-Programmimplementierungen der Rückmeldemethoden für Ressourcentypen eingesetzt, die Dienste unter RGM-Steuerung des Clusters darstellen. Sie können diese Funktionen zu folgenden Zwecken einsetzen:

Hinweis –

Dieser Abschnitt enthält zwar kurze Beschreibungen der C-Funktionen. Als maßgebliche Referenz für diese Funktionen wird jedoch auf die einzelnen Seiten der (3HA)-Online-Dokumentation verwiesen. Für jede Funktion ist eine gleichnamige Seite in der Online-Dokumentation vorhanden, sofern nicht anders angegeben. Informationen zu Ausgabeargumenten und Rückgabecodes der C-Funktionen finden Sie in der Online-Dokumentation unter scha_calls(3HA).

Ressourcenfunktionen

Diese Funktionen greifen auf Informationen über eine von RGM verwaltete Ressource zu bzw. geben den vom Monitor festgestellten Zustand der Ressource an.

scha_resource_open(), scha_resource_get () und scha_resource_close()

Zusammen greifen diese Funktionen auf Informationen über eine von RGM verwaltete Ressource zu. Die scha_resource_open()-Funktion initialisiert den Zugriff auf eine Ressource und gibt ein Handle für scha_resource_get() zurück, womit auf die Ressourceninformationen zugegriffen wird. Die scha_resource_close()-Funktion invalidiert das Handle und gibt den für die Rückgabewerte von scha_resource_get() zugewiesenen Speicherplatz frei.

Eine Ressource kann durch eine Cluster-Rekonfiguration oder einen Verwaltungsbefehl geändert werden, nachdem scha_resource_open() das Handle für die Ressource zurückgegeben hat. In diesem Fall können die von scha_resource_get() über das Handle abgerufenen Informationen falsch sein. Im Fall einer Cluster-Rekonfiguration oder einer Verwaltungsaktion an einer Ressource gibt RGM den Fehlercode scha_err_seqid an scha_resource_get() zurück, um anzugeben, dass sich die Ressourceninformationen geändert haben könnten. Diese Meldung gibt keinen schwerwiegenden Fehler an; die Funktion gibt Erfolg zurück. Sie können die Meldung ignorieren und die zurückgegebenen Informationen akzeptieren, oder das aktuelle Handle schließen und ein neues Handle zum Zugreifen auf Ressurceninformationen öffnen.

Eine gemeinsame Online-Dokumentationsseite beschreibt diese drei Funktionen. Auf diese Seite können Sie über jede der einzelnen Funktionen, scha_resource_open(3HA), scha_resource_get(3HA) oder scha_resource_close(3HA) zugreifen.

scha_resource_setstatus()

Stellt die Status- und Status_msg-Eigenschaften einer Ressource unter RGM-Steuerung ein. Der Ressourcen-Monitor verwendet diese Funktion, um den Ressourcenzustand anzugeben.

Hinweis –

scha_resource_setstatus()ist zwar für einen Ressourcen-Monitor besonders nützlich, kann jedoch von jedem beliebigen Programm aufgerufen werden.

Ressourcentypfunktionen

Diese Funktionen greifen gemeinsam auf Informationen über einen bei RGM registrierten Ressourcentyp zu.

scha_resourcetype_open(), scha_resourcetype_get(), scha_resourcetype_close()

Die Funktion scha_resourcetype_open() initialisiert den Zugriff auf eine Ressource und gibt ein Handle für scha_resourcetype_get() zurück, womit auf die Ressourcentypinformationen zugegriffen wird. Die Funktion scha_resourcetype_close() invalidiert das Handle und gibt den für die Rückgabewerte von scha_resourcetype_get() zugewiesenen Speicherplatz frei.

Ein Ressourcentyp kann durch eine Cluster-Rekonfiguration oder einen Verwaltungsbefehl geändert werden, nachdem scha_resourcetype_open() das Ressourcentyp-Handle zurückgegeben hat. In diesem Fall können die von scha_resourcetype_get () über das Handle abgerufenen Informationen falsch sein. Im Fall einer Cluster-Rekonfiguration oder einer Verwaltungsaktion an einem Ressourcentyp gibt RGM den Fehlercode scha_err_seqid an scha_resourcetype_get() zurück, um anzugeben, dass sich die Ressourcentypinformationen geändert haben könnten. Diese Meldung gibt keinen schwerwiegenden Fehler an; die Funktion gibt Erfolg zurück. Sie können die Meldung ignorieren und die zurückgegebenen Informationen akzeptieren, oder das aktuelle Handle schließen und ein neues Handle zum Zugreifen auf Ressourcentypinformationen öffnen.

Eine gemeinsame Online-Dokumentationsseite beschreibt diese drei Funktionen. Auf diese Seite können Sie über jede der einzelnen Funktionen, scha_resourcetype_open(3HA), scha_resourcetype_get(3HA) oder scha_resourcetype_close(3HA) zugreifen.

Ressourcengruppenfunktionen

Mit diesen Funktionen können Sie auf Informationen über eine Ressourcengruppe zugreifen bzw. sie neu starten.

scha_resourcegroup_open(3HA), scha_resourcegroup_get(3HA) und scha_resourcegroup_close(3HA)

Zusammen greifen diese Funktionen auf eine von RGM verwaltete Ressourcengruppe zu. Die Funktion scha_resourcegroup_open() initialisiert den Zugriff auf eine Ressourcengruppe und gibt ein Handle für scha_resourcegroup_get() zurück, womit auf die Ressourcengruppeninformationen zugegriffen wird. Die Funktion scha_resourcegroup_close() invalidiert das Handle und gibt den für die Rückgabewerte von scha_resourcegroup_get() zugewiesenen Speicherplatz frei.

Eine Ressourcengruppe kann durch eine Cluster-Rekonfiguration oder eine Verwaltungsaktion geändert werden, nachdem scha_resourcegroup_open() das Ressourcengruppen-Handle zurückgegeben hat. In diesem Fall können die von scha_resourcegroup_get() über das Handle abgerufenen Informationen falsch sein. Im Fall einer Cluster-Rekonfiguration oder einer Verwaltungsaktion an einer Ressourcengruppe gibt RGM den Fehlercode scha_err_seqid an scha_resourcegroup_get() zurück, um anzugeben, dass sich die Ressourcengruppeninformationen geändert haben könnten. Diese Meldung gibt keinen schwerwiegenden Fehler an; die Funktion gibt Erfolg zurück. Sie können die Meldung ignorieren und die zurückgegebenen Informationen akzeptieren, oder das aktuelle Handle schließen und ein neues Handle zum Zugreifen auf Ressourcengruppeninformationen öffnen.

scha_control( 3HA)

Fordert den Neustart einer Ressourcengruppe unter RGM-Steuerung bzw. die Verschiebung zu einem anderen Knoten an.

Cluster-Funktionen

Diese Funktionen greifen auf Informationen über einen Cluster zu bzw. geben diese zurück.

scha_cluster_open(3HA), scha_cluster_get(3HA), scha_cluster_close(3HA)

Diese Funktionen greifen gemeinsam auf Informationen über einen Cluster zu, wie Knotennamen, IDs, Zustand, Cluster-Name, Ressourcengruppe usw.

Ein Cluster kann — durch Rekonfiguration oder eine Verwaltungsaktion — geändert werden, nachdem scha_cluster_open() das Cluster-Handle zurückgegeben hat. In diesem Fall können die von scha_cluster_get() über das Handle abgerufenen Informationen falsch sein. Im Fall einer Cluster-Rekonfiguration oder einer Verwaltungsaktion an einem Cluster gibt RGM den Fehlercode scha_err_seqid an scha_cluster_get() zurück, um anzugeben, dass sich die Cluster-Informationen geändert haben könnten. Diese Meldung gibt keinen schwerwiegenden Fehler an; die Funktion gibt Erfolg zurück. Sie können die Meldung ignorieren und die zurückgegebenen Informationen akzeptieren, oder das aktuelle Handle schließen und ein neues Handle zum Zugreifen auf Cluster-Informationen öffnen.

scha_cluster_getlogfacility(3HA)

Gibt die Nummer der Systemprotokollierung zurück, die als Cluster-Protokoll verwendet wird. Verwendet den von der Solaris-Funktion syslog() zurückgegebenen Wert zum Aufzeichnen von Ereignissen und Statusmeldungen im Cluster-Protokoll.

scha_cluster_getnodename(3HA)

Gibt den Namen des Cluster-Knotens zurück, auf dem die Funktion aufgerufen wird.

Dienstprogrammfunktion

Diese Funktion konvertiert einen Fehlercode in eine Fehlermeldung.

scha_strerror( 3HA)

Überträgt einen Fehlercode — zurückgegeben von einer der scha_-Funktionen — in die entsprechende Fehlermeldung. Verwenden Sie diese Funktion mit logger, um Meldungen im Systemprotokoll (syslog) zu protokollieren.