Administratorhandbuch > Installation > Neu-Installation > ServiceManager (Windows) installieren

ServiceManager (Windows) installieren

In diesem Dokument finden Sie den Ablauf der Hotfix Installation für den ServiceManager (Windows).

Installieren Sie den ServiceManager sowie dessen Dialogprogramm unbedingt in jeweils eigene Verzeichnisse (z.B: C:\AUTOMIC\SERVICEMANAGER\BIN und C:\AUTOMIC\SERVICEMANAGERDIALOG\BIN).

Ausgelieferte Dateien

Die Dateien des ServiceManagers sind auf zwei verschiedenen Verzeichnissen der AE-CD verteilt. Die Dateien für den Dienst des ServiceManagers befinden sich im Verzeichnis IMAGE:SERVICEMANAGER\WINDOWS.

Dateiname	Beschreibung
UCYBSMGR.EXE	ServiceManager
UCYBSMGR.INI	Initialisierungsdatei für ServiceManager
UC4.SMD	Definitionsdatei für zu startende AE-Dienste
ZU00132.DLL	Laufzeitbibliothek für gemeinsame Funktionen
SETUP.EXE	Installationsprogramm

Das Verzeichnis IMAGE:SERVICEMANAGERDIALOG\WINDOWS enthält die Dateien für das Dialog- und das Kommandozeilenprogramm des ServiceManagers.

Dateiname	Beschreibung
UCYBSMDI.EXE	Dialogprogramm des ServiceManagers
UCYBSMDI.INI	Initialisierungsdatei für das Dialogprogramm
UCYBSMCL.EXE	Kommandozeilenprogramm für den ServiceManager
SETUP.EXE	Installationsprogramm

Weitere Dateien aus diesen Unterverzeichnissen sind Bestandteil des Installationsprogramms und des AE-Laufzeitsystems. Siehe: Knowledge Base.

Ablauf

Auf dem entsprechenden Rechner (Server-Rechner oder Host).

	1.	Microsoft Visual C++ 2010 Redistributable Package installieren

Ist das Package bereits in der erforderlichen Version vorhanden, kann dieser Installationsschritt entfallen. Ob und in welcher Version es vorhanden ist, sehen Sie in der Systemsteuerung -> Software.

Host (32-Bit)
Das Package aus dem Verzeichnis IMAGE:CRTS\WINDOWS\X86 installieren.

Host (64-Bit)
Das Package aus dem Verzeichnis IMAGE:CRTS\WINDOWS\X64 bzw. IMAGE:CRTS\WINDOWS\IA64 installieren.

	2.	ServiceManager installieren

Host (32-Bit)
Starten des Programms SETUP.EXE im passenden Unterverzeichnis von IMAGE:SERVICEMANAGER\WINDOWS\X86.
Anpassen der INI-Datei UCYBSMGR.INI an die Systemumgebung.
Passen Sie die Definitionsdatei (SMD-Datei) entsprechend an.

Host (64-Bit)
Starten des Programms SETUP.EXE im passenden Unterverzeichnis von IMAGE:SERVICEMANAGER\WINDOWS\X64 bzw. IMAGE:SERVICEMANAGER\WINDOWS\IA64.
Anpassen der INI-Datei UCYBSMGR.INI an die Systemumgebung.
Passen Sie die Definitionsdatei (SMD-Datei) entsprechend an.

	3.	Dialog- und Kommandozeilenprogramm des ServiceManagers installieren

Host (32-Bit)
Starten des Programms SETUP.EXE im passenden Unterverzeichnis von IMAGE:SERVICEMANAGERDIALOG\WINDOWS\X86.
Anpassen der INI-Datei UCYBSMDI.INI an die Systemumgebung.
Die Programme können auch auf Rechnern installiert werden, auf denen kein ServiceManager läuft. Somit kann der ServiceManager von diesen Stationen aus bedient werden.

Host (64-Bit)

Starten des Programms SETUP.EXE im passenden Unterverzeichnis von IMAGE:SERVICEMANAGERDIALOG\WINDOWS\X64 bzw. IMAGE:SERVICEMANAGERDIALOG\WINDOWS\IA64.
Anpassen der INI-Datei UCYBSMDI.INI an die Systemumgebung.
Die Programme können auch auf Rechnern installiert werden, auf denen kein ServiceManager läuft. Somit kann der ServiceManager von diesen Stationen aus bedient werden.

	4.	ServiceManager als Dienst installieren

Öffnen eines MS-DOS-Fensters.
Starten des Programms UCYBSMGR.EXE mit Kommando:

UCYBSMGR[.EXE] -install Phrase[-iPfad und Name der INI-Datei]

Dadurch wird der ServiceManager als Dienst in Windows eingetragen. Als Phrase kann eine selbst gewählte Zeichenfolge verwendet werden.
Kontrollieren Sie in der Systemsteuerung - Verwaltung - Dienste, dass der Dienst richtig eingetragen ist. Der hier vermerkte Name setzt sich wie folgt zusammen: "Automic ServiceManager [Phrase]"
Setzen Sie, wenn gewünscht, die Startart auf "Automatisch".
Standardmäßig lautet der Name der Phrase "UC4". Falls Sie eine andere Bezeichnung gewählt haben, ist in der INI-Datei UCYBSMGR.INI die folgende Sektion anzupassen:

[Destination Phrase]
deffile=Pfad zur SMD-Datei
cmdfile=Pfad zur SMC-Datei

Beispiel:

[Destination UC4PROD]
deffile=C:\AUTOMIC\SMgr\bin\UC4PROD.smd
cmdfile=C:\AUTOMIC\SMgr\bin\UC4PROD.smc

Starten Sie den Dienst.

Es ist möglich, den ServiceManager mehrfach als Dienst zu installieren. Dadurch können verschiedene ServiceManager-Umgebungen aufgebaut werden, beispielsweise für ein Test- und ein Produktivsystem. Mehrere solche Dienste werden durch den Namen der ServiceManager-Umgebung (Standard ist UC4) unterschieden.

Achten Sie darauf, den ServiceManager-Dienst unter einem Windows-Benutzer zu starten, der Administrator-Berechtigungen besitzt. Grund dafür ist, dass mit dem ServiceManager Komponenten gestartet werden, die wiederum Prozesse für unterschiedliche Benutzer starten können sollen.

	5.	Dienste mit dem ServiceManager starten

Damit die Automation Engines (Programm UCSRVCP.EXE und UCSRVWP.EXE) als Dienst lauffähig sind, muss die ODBC-Datenquelle als System-DSN (Data Source Name) angelegt sein.

Starten Sie das Dialogprogramm des ServiceManagers.
Wählen Sie den Computer und die ServiceManager-Umgebung (Phrase).
Sie sehen nun die vorgesehenen Dienste, aber im Status "Stopped".
Durch die rechte Maustaste auf eine Zeile können Sie: * den Dienst starten oder* dessen Eigenschaften ändern (automatischer Start mit Start des Systems, Verzögerung beim Start usw.).

Mögliche Probleme

Es werden nicht alle ServiceManager-Umgebungen (Phrasen) angezeigt:
Wollen Sie mehr als einen ServiceManager im Dialogprogramm auswählbar machen, so ist ein Portnummernbereich anzugeben. Tragen Sie diesen in der INI-Datei des Dialogprogrammes ein. Beachten Sie jedoch, dass der Bereich nicht mehr als 10 Portnummern umfassen darf.
Es werden nicht alle Dienste angezeigt:
Achten Sie auf korrekte Angaben in der Definitionsdatei (SMD-Datei). Jeder Dienst muss durch eine eigene Zeile repräsentiert werden. Tragen Sie auch den Pfad der SMD-Datei in der INI-Datei des ServiceManagers ein.
Ein Dienst lässt sich nicht starten:

Überprüfen Sie den Pfad in den Eigenschaften des Dienstes auf Fehler (aufzurufen über das Kontextmenü im Dialogprogramm).
Bei einer Automation Engine auf UNIX ist darauf zu achten, dass sich die Datei "syntax.bin" im selben Verzeichnis wie die ini-Datei befindet.

Grundsätzlich ist es immer hilfreich, in der Log-Datei des ServiceManagers nachzusehen (Standardname der aktuellsten: SMgr_LOGG_00.txt), die im Temp-Ordner abgelegt wird. In ihr sind nähere Informationen zu den Vorgängen protokolliert.

ServiceManager deinstallieren

In Einzelfällen kann es notwendig sein, eine bestimmte ServiceManager-Umgebung (Phrase) zu deinstallieren.

Öffnen eines MS-DOS-Fensters.
Starten des Programms UCYBSMGR.EXE mit der Anweisung:
UCYBSMGR -remove Phrase
Dadurch wird die ServiceManager-Umgebung als Dienst unter Windows deinstalliert.
Kontrollieren Sie über die Systemsteuerung - Verwaltung - Dienste, dass der Dienst richtig entfernt wurde.

Siehe auch:

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support