SMD-Datei einrichten

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

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

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

Syntax

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

Syntax

Beschreibung/Format

Dienst

Name des Dienstes.

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 aufgelistet 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 Dienstes 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=
usw.

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 Startparameter - ServiceManager -sm definieren können.
Befehl = Der vollständige Startbefehl eines WP (Pfad und Dateiname) mit dem Startmodusparameter (-parm).

Zum Starten des WP in einem bestimmten Modus müssen Sie den folgenden Parameter anhängen:
-parm"StartMode=Wert;SystemStop=Wert"
Die zulässigen Werte für StartMode= sind "NORMAL" (regulärer Start) und "COLD" (Kaltstart).
Die zulässigen Werte für SystemStop= sind "NORMAL" (der Mandantenstatus bleibt gleich) und "YES" (alle Mandanten werden gestoppt).

Beispiel:
Im Folgenden finden Sie einen Auszug aus einer SMD-Datei, der die Definition eines Dienstes 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"

DEFINE WP2;*WP_STARTCMD;*SRV_STARTPATH;START1=(Kaltstart,*WP_STARTCMD_COLD);START2=(Systemstopp,*WP_STARTCMD_STOP);START3=(Kaltstart mit Systemstopp,*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. gibt SRV_STARTPATH den Pfad an, in dem sich der ServiceManager befindet). Stellen Sie sicher, dass die Variablenpfade mit Ihrem Installationsziel übereinstimmen.

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

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

Beispiel

! Variablen
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 -Xmx2G -jar ucsrvjp.jar -I*SRV_STARTPATH\ucsrv.ini -svc%port%
VAR JCP_STARTCMD;java -Xrs -Xmx2G -jar ucsrvjp.jar -I*SRV_STARTPATH\ucsrv.ini -svc%port% -cp
VAR REST_STARTCMD;java -Xrs -Xmx2G -jar ucsrvjp.jar -I*SRV_STARTPATH\ucsrv.ini -svc%port% -rest
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 JCP;*JCP_STARTCMD;*SRV_STARTPATH
DEFINE REST;*REST_STARTCMD;*SRV_STARTPATH
DEFINE CP1;*CP_STARTCMD;*SRV_STARTPATH
DEFINE CP2;*CP_STARTCMD;*SRV_STARTPATH

! Windows-Agenten
DEFINE WIN01;*OWN\..\..\Agents\Windows\bin\UCXJWX6.exe;*OWN\..\..\Agents\Windows\bin\

! Datenbankagenten
DEFINE DATABASE-AGENT01;java -Xrs -Xmx1G -jar *OWN\..\..\Agents\sql\bin\ucxjsqlx.jar;*OWN\..\..\Agents\sql\bin
DEFINE DATABASE-SERVICE01;java -Xrs -Xmx1G -jar *OWN\..\..\Agents\sql_service\bin\ucxjsqlx.jar -service;*OWN\..\..\Agents\sql_service\bin\

Siehe auch: