Benutzerdefinierte Prozeduren

Beim Ausführen von Lua-Skripten erhält der Administrator den Zugriff auf das ganze Dateisystem innerhalb des Server-Verzeichnisses und auf einige Systembefehle auf dem Rechner mit dem installierten Server.

Um den Zugriff auf die benutzerdefinierten Prozeduren zu verwehren, deaktivieren Sie für den entsprechenden Administrator das Recht Server- und Repository-Konfiguration bearbeiten (weitere Details finden Sie unter Administratoren und administrative Gruppen).

Um die Ausführung häufiger Aufgaben des Dr.Web Servers zu vereinfachen und automatisieren, können Sie verschiedene benutzerdefinierte Prozeduren verwenden. Diese Prozeduren basieren auf Lua-Skripten.

Benutzerdefinierte Prozeduren befinden sich im folgenden Unterverzeichnis vom Installationsverzeichnis des Servers:

Unter Windows: var\extensions

Unter FreeBSD: /var/drwcs/extensions

Unter Linux: /var/opt/drwcs/extensions

Nach der Installation des Servers befinden sich in diesem Unterverzeichnis vorinstallierte benutzerdefinierte Prozeduren.

Benutzerdefinierte Prozeduren sollten über das Verwaltungscenter bearbeitet werden.

So konfigurieren Sie die Ausführung benutzerdefinierter Prozeduren

1.Wählen Sie im Hauptmenü des Verwaltungscenters den Punkt Administration aus.

2.Wählen Sie im nächsten Fenster den Punkt des Verwaltungsmenüs Benutzerdefinierte Prozeduren. Das Fenster zur Konfiguration benutzerdefinierter Prozeduren erscheint.

Baumstruktur von Prozeduren

Die Prozeduren werden in der Baumansicht angezeigt. Gruppen von Prozeduren und die dazu gehörenden benutzerdefinierten Prozeduren stellen die Knoten dieser Baumstruktur dar.

Ursprünglich hat die Baumstruktur von Prozeduren folgende vordefinierte Gruppen:

Examples of the hooks. Diese Gruppe enthält die Vorlagen aller verfügbaren benutzerdefinierten Prozeduren. Anhand dieser Vorlagen können Sie Ihre eigenen benutzerdefinierten Prozeduren anlegen. Die Prozeduren in den Vorlagen selbst lassen sich nicht bearbeiten und ausführen.

IBM Syslog. Diese Gruppe enthält die Vorlagen der Prozeduren, die für die Integration mit dem IBM Tivoli-System notwendig sind. Ereignisse, die den aktivierten Prozeduren entsprechen, werden im Format Syslog geschrieben.

Alle Ereignisse werden in eine Datei unter dem folgenden Pfad protokolliert:

Für Windows:
var\export\tivoli\syslog\drwcs_syslog.log

Für FreeBSD:
/var/drwcs/export/tivoli/syslog/drwcs_syslog.log

Für Linux:
/var/opt/drwcs/export/tivoli/syslog/drwcs_syslog.log

IBM W7Log. Diese Gruppe enthält die Vorlagen der Prozeduren, die für die Integration mit dem IBM Tivoli-System notwendig sind. Ereignisse, die den aktivierten Prozeduren entsprechen, werden im Format IBM W7Log XML protokolliert.

Für jedes Ereignis wird eine einzelne Datei unter dem folgenden Pfad erstellt:

Für Windows:
var\export\tivoli\w7log\<Ereignisname>_<unix_timestamp>

Für FreeBSD:
/var/drwcs/export/tivoli/w7log/<Ereignisname>_<unix_timestamp>

Für Linux:
/var/opt/drwcs/export/tivoli/w7log/<Ereignisname>_<unix_timestamp>

Die Darstellung des Symbols eines Elements in der Struktur hängt vom Typ oder Status dieses Elements ab (s. die Tabelle unten).

Symbole der Elemente in der Baumstruktur der Prozeduren

Symbol

Erläuterung

Gruppen von Prozeduren

Gruppe von Prozeduren, für welche die Ausführung von Prozeduren erlaubt ist.

Gruppe von Prozeduren, für welche die Ausführung von Prozeduren verboten ist.

Prozeduren

Prozedur, für welche die Ausführung erlaubt ist.

Prozedur, für welche die Ausführung verboten ist.

Elemente in der Baumstruktur verwalten

Auf der Symbolleiste sind folgende Elemente zur Verwaltung der Objekte in der Baumstruktur verfügbar:

. Dropdown-Liste, mit der Sie ein Element zur Baumstruktur der Prozeduren hinzufügen können. Verwenden Sie dafür die folgenden Optionen:

Prozedur hinzufügen. Mit dieser Option fügen Sie eine neue benutzerdefinierte Prozedur hinzu.

Gruppe von Prozeduren hinzufügen. Mit dieser Option erstellen Sie eine neue benutzerdefinierte Gruppe von Prozeduren.

Ausgewählte Objekte löschen. Mit dieser Option löschen Sie eine in der Baumstruktur von Prozeduren ausgewählte benutzerdefinierte Prozedur bzw. Gruppe von Prozeduren.

Ausführen der Prozedur erlauben. Die gleiche Aktion kann im Prozeduren-Editor durch Aktivierung des Kontrollkästchens Ausführen der Prozedur erlauben durchgeführt werden. Siehe dazu auch Prozeduren aktivieren.

Ausführen der Prozedur verbieten. Die gleiche Aktion kann im Prozeduren-Editor durch Deaktivierung des Kontrollkästchens Ausführen der Prozedur erlauben durchgeführt werden. Siehe dazu auch Prozeduren aktivieren.

Gruppen von Prozeduren verwalten

So erstellen Sie eine neue Gruppe

1.Wählen Sie in der Symbolleiste Gruppe von Prozeduren hinzufügen.

2.Legen Sie im angezeigten Dialogfeld folgende Parameter fest:

Aktivieren Sie das Kontrollkästchen Ausführen der Prozedur erlauben, um die Prozeduren, die in diese Gruppe aufgenommen werden, zu aktivieren. Siehe dazu auch Prozeduren aktivieren.

Geben Sie im Feld Gruppenname einen Namen für die neue Gruppe an.

3.Klicken Sie auf die Schaltfläche Speichern.

So ändern Sie die Reihenfolge der Gruppen

1.Ziehen Sie einfach die Gruppe der Prozeduren per Drag-and-drop an die gewünschte Position.

2.Die Reihenfolge, in der die Prozeduren ausgeführt werden, wird automatisch nach der Änderung der Reihenfolge der Gruppen angepasst: Als erste werden also die Prozeduren aus der in der Struktur höher stehenden Gruppen ausgeführt.

So verschieben Sie eine Prozedur in eine andere Gruppe

1.Wählen Sie die gewünschte Prozedur aus der Baumstruktur.

2.Wählen Sie im angezeigten Eigenschaftenfenster die Gruppe aus der Dropdown-Liste Übergeordnete Gruppe, in welche die Prozedur verschoben werden soll.

3.Klicken Sie auf die Schaltfläche Speichern.

Prozeduren verwalten

So fügen Sie eine Prozedur hinzu

1.Wählen Sie in der Symbolleiste Prozedur hinzufügen.

2.Legen Sie im angezeigten Dialogfeld folgende Parameter fest:

Aktivieren Sie das Kontrollkästchen Ausführen der Prozedur erlauben, um die Prozedur zu aktivieren. Siehe dazu auch Prozeduren aktivieren.

Wählen Sie in der Dropdown-Liste Übergeordnete Gruppe die Gruppe aus, in welche die zu erstellende Prozedur aufgenommen werden soll. Nachträglich können Sie die Prozedur in eine andere Gruppe verschieben (s. oben).

Wählen Sie in der Dropdown-Liste Prozedur den gewünschten Typ der Prozedur aus. Der Typ der Prozedur bestimmt die Aktion, für welche die Prozedur aufgerufen werden soll.

Geben Sie in das Feld Text der Prozedur das Lua-Skript ein, das beim Aufruf der Prozedur ausgeführt werden soll.
Im Unterbereich Informationen über die Prozedur werden das Ereignis, für das diese Prozedur aufgerufen wird, Informationen über die Verfügbarkeit der Datenbank des Servers für diese Prozedur sowie die Listen der Eingabeparameter und zurückgegebenen Werte für diesen Typ der Prozedur angegeben.

3.Klicken Sie auf die Schaltfläche Speichern.

So bearbeiten Sie eine Prozedur

1.Wählen Sie die Prozedur aus der Baumstruktur, die Sie bearbeiten wollen.

2.Im rechten Fensterteil werden die Eigenschaften der ausgewählten Prozedur angezeigt. Bearbeitet werden können alle Parameter (außer Prozedur), die bei der Erstellung der Prozedur festgelegt wurden. Dieser Parameter lässt sich nach der Erstellung der Prozedur nicht bearbeiten, da er das Ereignis bestimmt, für das die Prozedur aufgerufen werden soll.

3.Klicken Sie auf die Schaltfläche Speichern.

Prozeduren aktivieren

Durch Aktivierung einer Prozedur oder Gruppe von Prozeduren bewirken Sie, dass die Prozedur bei Eintritt des Ereignisses ausgeführt wird.

So aktivieren Sie eine Prozedur oder Gruppe von Prozeduren

1.Wählen Sie die Prozedur oder Gruppe aus, die Sie aktivieren wollen.

2.Führen Sie eine der folgenden Aktionen durch:

Klicken Sie in der Symbolleiste auf Ausführen der Prozedur erlauben.

Aktivieren Sie im rechts befindlichen Bereich der Eigenschaften des ausgewählten Objekts das Kontrollkästchen Ausführen der Prozedur erlauben, falls es deaktiviert ist. Klicken Sie auf Speichern.

Hinweise zur Aktivierung von Prozeduren

Damit die Prozedur bei Eintritt des Ereignisses ausgeführt werden kann, müssen folgende Voraussetzungen erfüllt sein:

a)Die Prozedur muss aktiviert sein.

b)Die Gruppe, der die Prozedur angehört, muss aktiviert sein.

Falls die Gruppe deaktiviert ist, können die darin befindlichen Prozeduren nicht ausgeführt werden, selbst wenn sie aktiviert sind.

Falls die Gruppe aktiviert ist, können nur die Prozeduren ausgeführt werden, die selbst aktiviert sind.