ServiceManager - Dialogprogramm

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.

Diese Seite beinhaltet Folgendes:

Übersicht

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. Weitere Informationen finden Sie unter CAPKI - Sicherung des ServiceManagers. 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.

Wenn die Mandanten-Zertifizierung im ServiceManager aktiviert ist, benötigt der Mandant ein Zertifikat für die Authentifizierung. Die Zertifikat- und Schlüsseldateien werden im Abschnitt [CAPKI] der INI-Datei des ServiceManager-Dialogprogramms zugewiesen. Weitere Informationen finden Sie unter CAPKI - Sicherung des ServiceManagers.

Beispiel

In diesem Beispiel befinden sich die Zertifikat- und Schlüsseldateien im Verzeichnis .\bin des ServiceManagers – Dialog-Programm.

[CAPKI]

certificate=C:\Automic\Automation.Platform\ ServiceManagerDialog\bin\<certificatefilename>.pem

key=C:\Automic\Automation.Platform\ ServiceManagerDialog\bin\<keyfilename>.pem

;chain=

trusted_cert_folder=.\trusted

Einige Zertifikate benötigen möglicherweise ein vorläufiges Zertifikat für die Validierung, wenn die Signaturzertifizierungsstelle nicht direkt vertrauenswürdig ist. Verwenden Sie den Parameter chain=<Kettendateiname> im Abschnitt [CAPKI] der INI-Datei, um auf den Speicherort des vorläufigen Zertifikats zu verweisen.

Wenn die Mandantenzertifizierung aktiviert ist und der Mandant kein Zertifikat besitzt oder die Zertifikatsvalidierung fehlschlägt, wird die Verbindung beendet. In diesem Fall schreibt der ServiceManager einen entsprechenden Log-Eintrag und gibt eine Fehlermeldung an den Mandanten zurück.

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 den Namen 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 ServiceManager auf einem Windows-Server ausgeführt wird, ist das Definieren der Port-Nummer 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.
Dienst

Name des Service

Sie können einen beliebigen Namen auswählen und ihn jederzeit ändern.

Wichtig! Der Servicename von allen Serverprozessen ä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. Weitere Informationen finden Sie unter Serverprozesse.

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 werden angehalten.
Sofort Einzelprozess: Ein einzelner Prozess wird angehalten.
Abnormal: 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 (siehe Serverprozesse). 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=Wert;SystemStop=Wert"

Zulässige Werte:
- StartMode=: NORMAL (default) für einen regulären Start und COLD für einen Kaltstart
- SystemStop=: NORMAL (default) bedeutet, dass der Mandantenstatus unverändert bleibt, und YES, dass alle Mandanten gestoppt werden
  
  Wichtig! Sie können ein oder beide Argument(e) 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
Domäne

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 angefü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. Weitere Informationen finden Sie unter SMD-Datei einrichten.

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. Als Systemadministrator können Sie ein Passwort angeben, um zu verhindern, dass die Dienste ohne Berechtigung gestartet, beendet oder geändert werden. Alle Services, die zur Umgebung des ServiceManagers gehören, können geschützt werden.

Es gibt drei verschiedene Berechtigungsebenen:

Lesen

Ermöglicht es Ihnen, den Status der Dienste zu überwachen.
Lesen und Ausführen

Ermöglicht es Ihnen, Befehle auszuführen, wie z. B. das Starten und Anhalten von Diensten und das Überwachen des Status der Dienste.
Lesen, Ausführen und Verwalten

Ermöglicht es Ihnen, die Konfiguration des ServiceManagers zu bearbeiten, Befehle auszuführen und den Status der Dienste zu überwachen.

Wichtig! Sie benötigen die Zugriffsebene Lesen, Ausführen und Verwalten, um Passwörter festzulegen oder zu ändern.

Um ein Passwort einzugeben, wählen Sie im Systemmenü die Option Passwort eingeben, und legen Sie das Passwort fest. Aktualisieren Sie die Ansicht (F5), um die Prozessliste anzuzeigen. Nachdem ein Passwort festgelegt wurde, muss es nicht für jeden Dienst definiert werden, und es wird angewendet, bis das ServiceManager-Dialogprogramm beendet wird.

Das System warnt Sie nicht, wenn Sie das falsche Passwort verwenden. Es wird lediglich die Meldung Zugriff verweigert angezeigt.

Sie können auch die Berechtigungsebene ändern, um den Zugriff auf die Dienste zu beschränken. Wählen Sie dazu im Systemmenü die Option Passwort ändern, und wählen Sie die Berechtigungsebene aus der Dropdown-Liste Berechtigung aus.

Hinweis: Die Passwörter müssen von der höchsten Ebene abwärts festgelegt werden, da nur ein Benutzer mit Administratorrechten diese Aktionen ausführen kann. Jeder Versuch, ein Passwort in der falschen Reihenfolge zu definieren oder zu löschen, wird abgelehnt.

Im Gegensatz zu früheren Versionen des ServiceManagers werden die Passwörter nicht verschlüsselt, sondern in der INI-Datei des ServiceManagers als Hash-Dateien gespeichert, siehe Service Manager Service.

Beim Start überprüft der ServiceManager , ob die INI-Datei noch ein Zugriffspasswort hat, das im Parameter password= gespeichert ist. Wenn dies der Fall ist, wandelt der ServiceManager das Passwort in einen Hash um und löscht den alten Passworteintrag aus der INI-Datei. Das alte Passwort wird als neues Lesen, Ausführen und Verwalten- sowie als neues Lesen und Ausführen-Passwort festgelegt. Auf diese Weise wird sichergestellt, dass die Benutzer über dieselbe Berechtigungsebene verfügen, bevor Sie das Passwort ändern, und nicht eine höhere oder niedrigere. Die Passwörter für die Berechtigungsebene Lesensind nicht standardmäßig festgelegt.

Wichtig! Wenn Ihr ServiceManager passwortgeschützt ist, müssen Sie das UC_SMGR_LOGINS--VARA-Objekt definieren, das auf Ihrem Systemmandanten 0000 verfügbar ist. Andernfalls können Sie die Agenten und/oder Serverprozesse aus Sicherheitsgründen nicht starten. Das in UC_SMGR_LOGINS verwendete Passwort darf maximal 16 Zeichen lang sein. Weisen Sie dem UC_SMGR_LOGINS-Objekt den bzw. die relevanten Agenten und/oder Serverprozesse zu. Wenn Sie Serverprozesse zuweisen, müssen Sie in den Feldern Agent/Name und Typ auf der Login-Seite immer das Sternsymbol (*) verwenden. Weitere Informationen finden Sie unter UC_SMGR_LOGINS und Login

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: