BACKEND VARA-Objekte

Als Entwickler und Objektdesigner definieren Sie BACKEND VARA-Objekte, um einen Befehl auf einem Betriebssystem (Windows oder UNIX) auszuführen und liefern das Ergebnis in Form von Werten, die in Spalten dargestellt werden. Sie können die Befehle für verschiedene Betriebssysteme, Systemnamen und Versionen in einem BACKEND VARA-Objekt speichern. Wenn das VARA-Objekt aufgelöst wird, wird automatisch der richtige Befehl des betreffenden Agenten ausgewählt und ausgeführt.

Hinweise:

Sie benötigen eine bestimmte Berechtigung, um BACKEND VARA-Objekte zu erstellen und zu ändern.
Die VAR_TIMEOUT (UC_HOSTCHAR_DEFAULT - Host-Charakteristik) und BACKENDVAR_MAX_ROWS in den UC_SYSTEM_SETTINGS - Systemweite Einstellungen sind auch für BACKEND VARA-Objekte verfügbar.
PromptSet-Variablen werden in ausgewählten Feldern für Variablen des Typs BACKEND, EXEC, DATEILISTE, SEC_SQLI, SEC_SQL, SQLI, SQL, und XML unterstützt. Die Verwendung von PromptSet-Variablen ist notwendig, wenn die Funktion Dynamisch aktualisieren (Combobox-Prompts) verwendet wird.
PromptSet-Variablen werden in ausgewählten Feldern für Variablen des Typs BACKEND, EXEC, DATEILISTE, SEC_SQLI, SEC_SQL, SQLI, SQL, und XML unterstützt. Die Verwendung von PromptSet-Variablen ist notwendig, wenn die Funktion Dynamisch aktualisieren (Combobox-Prompts) verwendet wird.

Dieses Thema beinhaltet Folgendes:

BACKEND VARA-Objekte definieren

Eine BACKEND VARA-Objektdefinition besteht aus den folgenden Seiten:

Seite „Allgemein“
Variablen

Hier legen Sie die objektspezifischen Einstellungen fest. Einige Abschnitte dieser Seite gelten für alle VARA-Objekte und werden für all diese in eigenen Themen beschrieben:
- Variablen-Einstellungen, siehe unten
- Parameter
- Datentypen und Formatierung
- Scriptzugriff
- Mandant-0-VARA-Objekte in anderen Mandanten
- Vorschau, siehe unten
Seite „Versionsmanagement“
Seite „Dokumentation“

Abschnitt „Variablen-Einstellungen“

Geben Sie an, wie das VARA-Objekt auf das Zielsystem zugreifen soll, von dem es die Werte abruft.

Agent

Der Agent, in dem der Befehl ausgeführt wird.
Agent der Aufgabe bevorzugen

Verwendet den Agenten der Aufgabe, die das VARA-Objekt verwendet. Wenn die Aufgabe keinen Agenten hat (wie z. B. in Script-Objekten), wird der Agent des VARA-Objekts verwendet. Wenn weder das VARA-Objekt noch die Aufgabe einen Agenten hat, tritt ein Fehler auf.
Login

Login (LOGIN) Objekt, das dem VARA-Objekt den Zugriff auf das Zielbetriebssystem ermöglicht.
Login der Aufgabe bevorzugen

Verwendet den Login der Aufgabe, die das VARA-Objekt verwendet.

Wenn der Aufgabe kein Login-Objekt zugeordnet ist (z. B. in Script-Objekten), wird das dem VARA-Objekt zugeordnete Login verwendet. Wenn weder das VARA-Objekt noch die Aufgabe ein Login-Objekt hat, tritt ein Fehler auf.

Hinweise:

Folgendes gilt für die Attribute Agent und Login:

Wenn Sie die Funktion Dynamisch aktualisieren (Combobox-Prompts) für Combobox-Prompts verwenden, können Sie hier PromptSet-Variablen hinzufügen. Wenn Sie Prompt Set-Variablen in einem dynamischen Variablenobjekt verwenden, gibt die Funktion Vorschau einen Fehler zurück. Der Grund hierfür ist, dass PromptSet-Variablen im dynamischen Variablenobjekt nicht existieren. Die PromptSet-Variablen werden jedoch aufgelöst, wenn Objekte, die PromptSet beinhalten, ausgeführt werden.
Die mitgelieferten Vordefinierte BACKEND VARA-Objekte (Vorlagen) für Backend VARA-Objekte verwenden die Prompt Set-Variablen &AGENT# für ihren angegebenen Agenten und &LOGIN# für ihre Anmeldung.

Seite „Kommandos“

BACKEND VARA-Objekte führen genau einen Befehl auf den Zielbetriebssystemen aus. Dies gilt sowohl für Windows als auch für Unix. Sie geben den Befehl auf dieser Seite ein:

OS Name

Name des Betriebssystems auf dem der Agent läuft. Verwenden Sie den Wert, der in der Spalte Perspektive „Administration“ (Seite Agenten, Spalte Software) angezeigt wird.

Das Platzhalterzeichen „*“ kann verwendet werden.
Version

Version des Agenten, die in der Spalte Perspektive „Administration“ (Seite Agenten, Spalte Software) angezeigt wird.
Kommando

Bei Windows werden nur Powershell-Kommandos unterstützt.

Wenn Sie die Funktion Dynamisch aktualisieren (Combobox-Prompts) für Combobox-Prompts verwenden, können Sie hier PromptSet-Variablen hinzufügen. Wenn Sie Prompt Set-Variablen in einem dynamischen Variablenobjekt verwenden, gibt die Funktion Vorschau einen Fehler zurück. Der Grund hierfür ist, dass PromptSet-Variablen im dynamischen Variablenobjekt nicht existieren. Die PromptSet-Variablen werden jedoch aufgelöst, wenn Objekte, die PromptSet beinhalten, ausgeführt werden.
Spaltenformat

Legt fest, wie das Ergebnis in Spalten aufgeteilt werden soll. Verwenden Sie die folgende Syntax:

Spaltenname : Startposition ( Länge ) [;Spaltenname:Startposition(Länge) . . .]

Wobei:
- Spaltenname = Name der Spalte, benutzerdefiniert
- Startposition = Position des Zeichens, an dem die Spalte beginnt.
- Länge = Anzahl der Zeichen, die die Größe der Spalte bestimmt.
Wichtig!
- Das Semikolon (;) ist nur zwischen mehreren Spaltenangaben zu verwenden! Am Ende der gesamten Definition ist kein Semikolon erforderlich.
- Es ist zumindest eine Werte-Spalte zu definieren.
Beispiel:

process:1(20);pid:25(10)

Das vorherige Beispiel teilt die Ausgabe des Befehls in zwei Spalten auf. Die Spalte Script beginnt beim ersten Zeichen und ist 20 Zeichen lang. „pid“ beginnt bei Zeichen 25 und besitzt eine Länge von 10 Zeichen.

Hinweise:

Windows
- Die Befehle sind keine Batch-Zeilen. Sie müssen ein bestimmtes Programm definieren, das ausgeführt werden soll.
  
  Beispiele:
  
  Verzeichnis auflisten: cmd /c dir C:\temp
  
  Ping: ping localhost -n 10
- Der Rückgabewert wird automatisch auf 1 gesetzt, wenn ein Befehl zu einem Fehler führt. In diesem Fall bricht das Script ab, wenn Sie das VARA-Objekt in einem Script verwenden. Um dies zu vermeiden, können Sie & set ERRORLEVEL=0 am Ende des Windows-Befehls anhängen. Zum Beispiel:
  
  cmd /c dir /b /o:d C:\temp\*.xml & set ERRORLEVEL=0
  
  Das Kommando listet Dateien eines Verzeichnisses auf. Der Rückgabewert ist allerdings immer 0, unabhängig davon, ob Dateien gefunden wurden oder nicht. Auf diese Weise können Sie sicherstellen, dass die Aufgaben, die dieses VARA-Objekt verwenden, nicht abgebrochen werden.
Unix

Der Benutzer im Login-Objekt muss das Recht zur Ausführung des Kommandos besitzen.
Windows und Unix

In den Spalten OS-Name und Version können Sie nach den Namen (z. B. einem bestimmten UNIX-Derivat) und der OS-Version filtern. Die passende Zeile für den angegebenen Agenten wird automatisch verwendet, wenn das VARA-Objekt ausgeführt wird. Es wird dabei der erste Eintrag verwendet, der auf Betriebssystem, OS-Namen und Version des Agenten zutrifft!
Linux

Root-Rechte sind für den chkconfig und runlevel Befehl erforderlich.

Vorschau

Sie können den Befehl auf dem definierten Computer ausführen und die Ergebnisse testen.

Vordefinierte BACKEND VARA-Objekte (Vorlagen)

Vordefinierte BACKEND VARA-Objekte werden im Mandant 0 im Ordner UC _RB_VARIABLES ausgeliefert. Sie können für die Funktion Dynamisch aktualisieren (Combobox-Prompts) verwendet werden. Der festgelegte Agent ist der Variablenname &AGENT# und deren Login ist &LOGIN#. Achten Sie darauf, diese Namen für die PromptSet-Variablen der gewünschten Elemente zu verwenden.

Objektname	Betriebssystem	Funktion	Spalten
UC_RB_VARA_PROCESSLIST	Windows, Linux, AIX, SunOS, HP-UX	Listet die aktiven Prozesse auf. Die maximale Länge der Prozess-ID kann abhängig vom jeweiligen UNIX-System unterschiedlich sein. Passen Sie gegebenenfalls die Spaltenlänge im Variablenobjekt an.	Prozess-ID Prozessname
UC_RB_VARA_SERVICES_PAUSED	Windows, Linux, AIX, SunOS, HP-UX	Listet alle pausierten Dienste auf.	Servicename
UC_RB_VARA_SERVICES_RUNNING	Windows, Linux, AIX, SunOS, HP-UX	Listet alle gestarteten Dienste auf.	Servicename
UC_RB_VARA_SERVICES_STOPPED	Windows, Linux, AIX, SunOS, HP-UX	Listet alle gestoppten Dienste auf.	Servicename
UC_RB_VARA_USERLIST	Windows, Linux, AIX, SunOS, HP-UX	Listet alle Benutzer des Betriebssystems auf. Windows: Für Windows gilt dazu die Voraussetzung, dass Active Directory für PowerShell auf dem jeweiligen Rechner installiert ist!	Benutzer(Konto)-Name

Siehe auch: