SMD-Datei einrichten

Das folgende Dokument beschreibt die Definitionsdatei des Service Managers (standardmäßig UC4.SMD), die die Services definiert, die automatisch erstellt werden sollen.

Die Definitionsdatei enthält alle Start-Parameter für die Automation Engine-Services. Jeder Service wird in einer eigenen Zeile dargestellt und beginnt mit dem Schlüsselwort DEFINE. Die einzelnen Start-Parameter sind durch Semikolon getrennt, und kommentierende Zeilen beginnen mit einem Ausrufezeichen.

Hinweis: Diese Datei wird automatisch angepasst, wenn Sie Änderungen im Dialogprogramm ServiceManager vornehmen. Manuelle Eingriffe sind nicht erforderlich.

Syntax

DEFINE Service; Komponente INI-Datei; Arbeitsverzeichnis [; -svc%port%] [; LOGON=(Benutzername, Passwort, Domain )] [; Start1=() ; Start2=(); Start3=() etc.]

Syntax

Beschreibung/Format

Service

Servicename.

Leerzeichen.

Komponente

Pfad und Dateiname des Automation Engine-Programms, das gestartet werden soll.

Sie können absolute oder relative Pfadangaben verwenden: „*OWN“ bedeutet, dass das Programm im Verzeichnis des aufrufenden ServiceManagers aufgeführt sein muss.

Agenten für SAP, JMX, Datenbanken und Rapid Automation erfordern einen Java-Aufruf.
Zum Beispiel: java -jar ucxjr3x.jar

Java-Agenten: Geben Sie auch den Java-Pfad an, da der ServiceManager unter UNIX nicht alle Umgebungsvariablen liest.
Beispiel: /usr/java/latest/bin/java -jar ucxjsqlx.jar

 

Fügen Sie ein Leerzeichen zwischen den Parametern Komponente und INI-Datei ein.

INI-Datei

Name der INI-Datei, die verwendet werden soll.

Sie können auch einen absoluten oder relativen Pfad angeben (relativ bezieht sich auf das zu startende Programm).

Arbeitsverzeichnis

Arbeitsverzeichnis für das Programm, das gestartet werden soll.

Wenn es sich bei dem zu startenden Programm um einen Java-basierten Agenten (SAP, Datenbanken, JMX, Rapid Automation) handelt, muss das Arbeitsverzeichnis der Pfad zur JAR-Datei sein.

-svc%port%

Zusätzliche Anzeigeoption für Serverprozesse.

Bei Angabe dieses Start-Parameters zeigt das Dialogprogramm ServiceManager neben dem Namen des Service auch den Namen des Serverprozesses und die Anzahl der Verbindungen an.

LOGON=

Logindaten für das Automation Engine-Programm.

Dieser Parameter gilt nur für den ServiceManager unter Windows.

Start1=
Start2=
etc.

Mehrere Startmethoden für einen Serverprozess (WP).

Syntax
START1=( Name, Befehl)
START2=( Name, Befehl)
START3=( Name, Befehl)

Name = Der Name des Startmodus, den Sie mit der Option Start-Parameter - ServiceManager -sm definieren können.
Befehl = Der vollständige Startbefehl eines WP (Pfad und Dateiname) mit dem Startmodusparameter(-parm).

Um das WP mit einem bestimmten Modus zu starten, müssen Sie den folgenden Parameter anhängen:
-parm"StartMode=value;SystemStop=value"
Die zulässigen Werte für StartMode= sind „NORMAL“ (normaler Start) und „COLD“ (Kaltstart).
Die zulässigen Werte für SystemStop= sind „NORMAL“ (der Mandantenstatus bleibt gleich) und „YES“ (alle Mandanten werden gestoppt).

Zum Beispiel:
Im Folgenden finden Sie einen Auszug aus einer SMD-Datei, der die Definition eines Service enthält, mit dem Sie einen WP mit einem anderen Startmodus starten können.

VAR SRV_STARTPATH;*OWN\..\..\Server\bin

VAR WP_STARTCMD;*SRV_STARTPATH\UCsrvwp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%

VAR WP_STARTCMD_COLD;*WP_STARTCMD -parm"StartMode=Cold"

VAR WP_STARTCMD_STOP;*WP_STARTCMD -parm"SystemStop=Yes"

VAR WP_STARTCMD_COLDSTOP;*WP_STARTCMD -parm"StartMode=Cold;SystemStop=Yes"

EFINE WP2;*WP_STARTCMD;*SRV_STARTPATH;START1=(Kaltstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Kaltstart mit Systemstop,*WP_STARTCMD_COLDSTOP)

Sie können Variablen strukturieren, um ihre Lesbarkeit zu erhöhen, da die einzelnen Zeilen sehr lang sein können.

Beispiel

VAR Name der Variablen;Wert der Variablen

Der obere Teil der Definitionsdatei enthält die Variablendefinitionen (z.B. SRV_STARTPATH gibt den Pfad an, in dem sich der Service Manager befindet). Stellen Sie sicher, dass die variablen Pfade mit Ihrem Installationsziel übereinstimmen.

Der zweite Teil der Datei listet die Services auf, die der Definitionsdatei hinzugefügt werden. Diese Zeilen beginnen mit einer DEFINE-Syntax, gefolgt von der Destination und dem Service. Beachten Sie, dass das Ziel mit dem in der INI-Datei definierten Ziel übereinstimmen muss.

Innerhalb einer DEFINE-Zeile können Sie eine Variable einfügen, indem Sie ein „*“ gefolgt vom Variablennamen angeben.

Beispiel

! Variables
VAR SRV_STARTPATH;*OWN\..\..\AutomationEngine\bin

VAR CP_STARTCMD;*SRV_STARTPATH\UCsrvcp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%

VAR WP_STARTCMD;*SRV_STARTPATH\UCsrvwp.exe *SRV_STARTPATH\ucsrv.ini -svc%port%

VAR JWP_STARTCMD;java -Xrs -Xmx512M -jar ucsrvjp.jar -I*SRV_STARTPATH\ucsrv.ini -svc%port%

VAR WP_STARTCMD_COLD;*WP_STARTCMD -parm"StartMode=Cold"

VAR WP_STARTCMD_STOP;*WP_STARTCMD -parm"SystemStop=Yes"

VAR WP_STARTCMD_COLDSTOP;*WP_STARTCMD -parm"StartMode=Cold;SystemStop=Yes"

! Services
DEFINE WP1;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

DEFINE WP2;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

DEFINE WP3;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

DEFINE WP4;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

DEFINE WP5;*WP_STARTCMD;*SRV_STARTPATH;START1=(Coldstart,*WP_STARTCMD_COLD);START2=(Systemstop,*WP_STARTCMD_STOP);START3=(Coldstart with Systemstop,*WP_STARTCMD_COLDSTOP)

DEFINE JWP;*JWP_STARTCMD;*SRV_STARTPATH

DEFINE CP1;*CP_STARTCMD;*SRV_STARTPATH

DEFINE CP2;*CP_STARTCMD;*SRV_STARTPATH

! Windows agents
DEFINE WIN01;*OWN\..\..\AgentWin\bin\UCXJWI3.exe;*OWN\..\..\AgentWin\bin\


! Database agenta
DEFINE DATABASE-AGENT01;java -jar -Xmx256M *OWN\..\..\Agents\sql\bin\ucxjsqlx.jar;*OWN\..\..\Agents\sql\bin

DEFINE DATABASE-SERVICE01;java -jar -Xmx256M *OWN\..\..\Agents\sql\bin\ucxjsqlx.jar -service -i*OWN\..\..\AutomationEngine\bin\ucsrv.ini;*OWN\..\..\Agents\sql\bin\

Siehe auch: