Das ServiceManager Dialogprogramm ist eine grafische User Interface, mit der Administratoren Komponenten starten und stoppen können. Es ermöglicht Ihnen, Ihr Automation Engine-System von einem zentralen Punkt aus zu überwachen.
Das Dialogprogramm zeigt die Zustände aller Komponenten in Ihrer ServiceManager-Umgebung an. Es bietet auch Zugriff auf ServiceManager, die auf anderen Computern im Netzwerk ausgeführt werden. Daher können Sie systemweit auf Windows und UNIX-basierte Automation Engine-Programme zugreifen. Der Zugriff auf Remote-Computer erfordert Zugriffsrechte, die ebenfalls überprüft werden.
Sie können mit dem ServiceManager eine sichere Verbindung (TLS 1.2) herstellen, aber dennoch unsichere Verbindungen zu älteren ServiceManagern unterstützen. Für sichere Verbindungen müssen Sie CAPKI auf demselben Computer installiert haben, auf dem Sie das ServiceManager-Dialogprogramm installiert haben. Wenn keine sichere Verbindung hergestellt werden kann, werden Sie in einer Meldung aufgefordert, zu bestätigen, ob Sie mit einer unsicheren Verbindung fortfahren möchten oder nicht. Das ServiceManager-Dialogprogramm zeigt den Status Ihrer Verbindung an, der Sicher, Nicht sicher oder Nicht verbunden sein kann.
ServiceManager-Fenster
Der Inhalt des Dialogprogramms wird periodisch aktualisiert. Bis auf den Computernamen sind alle Felder, die im Fenster angezeigt werden, leer, wenn auf dem ausgewählten Computer kein ServiceManager aktiv ist. Die Felder sind auch leer, wenn Sie nicht über die notwendigen Zugriffsrechte für den ausgewählten Computer verfügen. In diesem Fall wird eine Fehlermeldung angezeigt.
Das Fenster zeigt die folgenden Informationen an:
-
Computername
Eingabefeld für den Namen des Computers, auf dem der ServiceManager installiert ist
Sie können auch aus vorhandenen Einträgen auswählen.
Sie können die Portnummer des ServiceManagers angeben (z. B. PC01:8871).
Hinweis: Unter UNIX ist die Angabe der Portnummer für den ServiceManager obligatorisch. Wenn Windows auf demselben Computer wie der ServiceManager läuft, ist die Definition der Portnummer optional.
-
Phrase
Eingabefeld für die ServiceManager-Umgebung
Dies ist die Umgebung, die in der Definitionsdatei und bei der Ausführung eines Befehls verwendet wird.
Wenn der Computername ausgewählt wurde, wird die ServiceManager-Umgebung angezeigt. Über die Dropdown-Liste können Sie zwischen ServiceManager-Umgebungen wechseln, wenn mehr als eine verfügbar ist.
-
Service
Name des Service
Sie können einen beliebigen Namen auswählen und ihn jederzeit ändern.
Wichtig! Der Servicename von allen Serverprozesse ändert sich beim Start des Service. Der angezeigte Name hat das Format UC4 <server process type>-Server [AUTOMIC#<server process type and connection order>], gefolgt von der Anzahl der Verbindungen zu anderen Prozessen. Der Servicename, den Sie ihnen zugewiesen haben, wird beim Beenden des Service wieder angezeigt.
Beispiel
UC4 WP-Server [AUTOMIC#WP003] - 2 Connections
Dies ist der Arbeitsprozess, der als dritter gestartet wurde und zwei Verbindungen zu anderen Prozessen hat.
-
Status
Status des Service
-
Startzeitpunkt
Startzeit des Service
Während der Inbetriebnahmephase wird die verbleibende Wartezeit in Sekunden angezeigt.
-
Laufzeit
Aktuelle Laufzeit des aktiven Service
-
ProcID
Prozessnummer des aktiven Service
-
CPU-Zeit
Aktuell genutzte CPU-Zeit des aktiven Service
Über das Kontextmenü können Sie einen Service starten, beenden, auf- und abwärts bewegen, duplizieren, löschen und umbenennen. Sie können auch auf die Eigenschaften des Service zugreifen, um seine Definition zu ändern. Sie können den Service mit oder ohne eine definierte Methode starten. Es gibt auch drei Möglichkeiten, einen Service zu beenden (stoppen):
-
Herunterfahren (AE-System): Alle Serverprozesse stoppen.
-
Immediately single process: Ein einzelner Prozess stoppt.
-
Anormal: Der Service wird vom ServiceManager durch einen Systemaufruf (Kill) sofort gestoppt.
Hinweis: Dieser Befehl sollte nur verwendet werden, wenn die Versuche des Service, sich selbst zu stoppen, nicht erfolgreich waren.
Komponenten hinzufügen
Sie müssen dieser Tabelle Komponenten hinzufügen, damit sie vom Dialogprogramm angezeigt werden können. Standardmäßig enthält die Tabelle einige Einträge wie Arbeits- und Kommunikationsprozesse.
Die angezeigten Komponenten entsprechen dem von Ihnen ausgewählten Computer und der Phrase. Um eine neue Zeile hinzuzufügen, klicken Sie mit der rechten Maustaste auf einen vorhandenen Tabelleneintrag, und wählen Sie Duplizieren. Im Dialog Eigenschaften können Sie den Startpfad eingeben und weitere Parameter definieren. Es zeigt die folgenden Informationen an:
-
Kommando
Dateiname des Programms mit den vollständigen Pfadangaben
Wenn Sie die standardmäßige INI-Datei nicht zum Starten verwenden möchten, können Sie den Namen und den Pfad einer anderen Datei angeben. Trennen Sie diese Definition vom Pfad und Dateinamen durch ein Leerzeichen.
Beispiel
C:\AUTOMIC\Agents\win\bin\UCXJWI3.exe C:\AUTOMIC\ini\win\UCXJWI3.ini
Hinweise:
- Java-Agenten benötigen den Parameter -I vor dem INI-Dateipfad.
- Java-Agenten (SAP, JMX, Datenbanken und Rapid Automation) müssen über die JAR-Datei gestartet werden.
- Für Serverprozesse gibt es eine zusätzliche Anzeigemöglichkeit. Geben Sie den Parameter -svc%port% und den Namen des Serverprozesses sowie die Anzahl der angezeigten Verbindungen zusätzlich zum Servicenamen ein.
Das Textfeld unter Befehl kann verwendet werden, um mehrere Startmethoden für Serverprozesse zu definieren. Markieren und klicken Sie mit der rechten Maustaste auf die oberste Zeile des Textfeldes und verwenden Sie den Befehl Insert, um Zeilen einzufügen. Der Name, den Sie der ausgewählten Startmethode zuweisen, wird im Kontextmenü angezeigt. Verwenden Sie die Parameter -parm"StartMode=value;SystemStop=Value", um eine Startmethode zu definieren, die einen Kaltstart ausführt:
Parameter
-parm"StartMode= value ;SystemStop=Value"
Erlaubte Werte:
-
StartMode=: NORMAL (Standard) für einen regelmäßigen Start und COLD für einen Kaltstart
-
SystemStop=: NORMAL (Standard) bedeutet, dass der Mandantenstatus unverändert bleibt und YES, um alle Mandanten zu stoppen
Wichtig! Sie können ein oder beide Argumente angeben. Beide Argumente sind auch in der INI-Datei verfügbar, wobei jedoch die im ServiceManager-Dialogprogramm angegebenen Werte Priorität haben.
Sie können auch den Dateinamen, den Pfad zur INI-Datei und den Startparameter -svc%port% eingeben.
-
Startpfad
Das Arbeitsverzeichnis des Programms
-
Anmelden als
Benutzer-ID, die für die Verarbeitung verwendet wird
Wichtig! UNIX ignoriert diese Einstellung und das Programm startet immer mit der Benutzer-ID des ServiceManagers.
-
Benutzername
-
Passwort
Das Passwort ist verschlüsselt
-
Domain
Benutzerdomäne, erforderlich, wenn der Benutzer kein lokaler Benutzer ist
-
Automatischer Start beim Systemstart
Wenn dieses Kontrollkästchen aktiviert ist, wird der Service beim Start des Systems automatisch gestartet. Wird der Dienst nur temporär benötigt (z. B. für Tests), kann das Programm über das Kontextmenü gestartet und gestoppt werden.
-
Sekundenverzögerung
Wartezeit in Sekunden, während der die Inbetriebnahme verzögert wird
Wenn der Service in der ersten Zeile des Dialogprogramms erscheint, ist der angezeigte Wert die Wartezeit auf den Start des ersten Service nach der Aktivierung des ServiceManagers. In anderen Fällen stellt es die Zeitverzögerung bis zum Start des Service dar, der in der Zeile über ihm aufgeführt ist.
Tipp: Es wird empfohlen, Pausen zwischen den Prozessstarts einzufügen, um dem System Zeit zu geben, diese Starts auszuführen.
Wichtig! Die Befehlsdatei Phrase.SMD wird automatisch erstellt, wenn Eigenschaften zum ersten Mal geändert werden. Der Dateiname entspricht der ServiceManager-Umgebung. Ändern Sie diese Datei nicht manuell.
Komponenten verwalten
Sie können den Serviceauftrag über das Kontextmenü ändern. Bitte beachten Sie, dass diese Aktion auch die Startreihenfolge beeinflusst.
Hinweis: Das ServiceManager Dialogprogramm wird als eigenständige Komponente angeboten, da der direkte Zugriff auf wichtige Services, wie die Automation Engine, die operativen Aktivitäten beeinflussen kann.
Das ServiceManager Dialogprogramm ist über das Systemmenü passwortgeschützt. Alle Services, die zur Umgebung des ServiceManagers gehören, können geschützt werden. Wählen Sie im Systemmenü den Eintrag Passwort ändern. Geben Sie ein Passwort an und alle Services einer Phrase sind gegen unbefugtes Starten, Beenden oder Ändern geschützt. Nach korrekter Eingabe (Enter Password) muss das Passwort nicht mehr für jeden einzelnen Service angegeben werden. Dies gilt bis zum Beenden des ServiceManager Dialogprogramms. Das Passwort wird verschlüsselt im Parameter password= in der INI-Datei des ServiceManagers gespeichert.
Windows-Agenten Falls das ServiceManager-Dialogprogramm nicht auf dem gleichen Computer wie der Agent gespeichert ist, benötigt der Windows-Benutzer, mit dem der Agent gestartet wurde, das Anmelderecht Zugriff auf diesen Computer über das Netzwerk. Andernfalls kann der Agent nicht starten.
Die Services, die gestartet werden sollen, sind in der Definitionsdatei Phrase.SMD (standardmäßig UC4.SMD) aufgeführt. Der Dateiname entspricht der ServiceManager-Umgebung. Eine manuelle Beeinflussung dieser Datei ist nur in Ausnahmefällen erforderlich, da ihr Inhalt bei einer Änderung des Dialogprogramms automatisch angepasst wird. Weitere Informationen finden Sie unter SMD-Datei einrichten.
Siehe auch: