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

Dienstprogramme (Windows) installieren

Hier finden Sie eine Anleitung für die Neuinstallation der Dienstprogramme (Windows).

Ausgelieferte Dateien

Die Dateien für die Dienstprogramme (Windows) befinden sich im Verzeichnis IMAGE:UTILITY\WINDOWS.

*G.EXE - Java-Loader für das Dienstprogramm
*.EXE - Programm für den Batchaufruf
*.BAT: Batchdatei für das Dienstprogramm

Dateiname	Beschreibung
UCYBARBR.EXE	AE Archive Browser (searches the archive files)
UCYBCHNG.EXE	AE DB Change (edits exported data)
UCYBDBRR.EXE	AE DB Revision Report (creates revision reports)
UCYBDBCC.JAR	AE DB Client Copy (copies and deletes clients)
UCYBDBAR.JAR	AE DB Archive (archives the database)
UCYBDBLD.JAR	AE DB Load (Laden der Datenbank)
UCYBDBRE.JAR	AE DB Reorg (reorganizes the database)
UCYBDBUN.JAR	AE DB Unload (Entladen der Datenbank)
UCYBDBRT.EXE	AE DB Reporting Tool (creates object queries)
UCYBREPG.EXE (requires 32bit Java), UCYBREPG.JAR	AE DB Reporting Tool (graphical interface for creating the query files)
UCYBLGMX.EXE	AE.LogMix (combines log and trace files)
UC.MSL	Message library
UC4LAF.JAR	Archive for layout files
*.INI	Initialization files for the utilities
CALLHTMLHELP.DLL, CBLRTSS.DLL, UCCACHE.DLL, UCDBUP.DLL, UCSBEPM.DLL, UCUCLI.DLL, UCUDB32.DLL, UCUOCI.DLL, UCUODBC.DLL, UCYBCLICPY.DLL, UCYDBARCHIVE.DLL, UCYDBREORG.DLL, UCYBDBLD.DLL, UCYBDBUN.DLL, UCZU01.DLL, ZU00132.DLL, ZUXML1.DLL	Libraries of the utilities
COMDLG32.OCX, MSCOMCTL.OCX, RICHTX32.OCX	ActiveX Controls
SETUP.EXE	Installationsprogramm

Bitte beachten Sie, dass ab Automation Engine Version 8.00A die Dateinamen der Dienstprogramme komplett auf Kleinschreibung umgestellt wurden.

Ablauf

	1.	Java Runtime Environment (JRE) installieren

Ist JRE bereits in der erforderlichen Version vorhanden, kann dieser Installationsschritt entfallen.

Admin-Rechner
Die Version der aktuellen Java Virtual Machine (VM) des Systems kann mit dem folgenden Kommando geprüft werden:

java -version

Sind mehrere Versionen von JRE oder Java SDK auf dem Rechner installiert, so ist bei der Einstellung von %PATH% bzw. $PATH darauf zu achten, dass die Reihenfolge der angegebenen Verzeichnisse relevant ist. Es wird die Java Runtime Umgebung verwendet, die in der Auflistung der Verzeichnisse zuerst gefunden wird.

Laden Sie das erforderliche Java Runtime Environment von der Seite http://java.sun.com herunter und installieren Sie es. Bei der Installation wird automatisch das Java Plug-in für Web-Browser installiert. Da AE dieses nicht benötigt, können Sie es in der Systemsteuerung deaktivieren.

	2.	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.

Admin-Rechner
Das Package aus dem Verzeichnis IMAGE:CRTS installieren.

	3.	Installieren der Dienstprogramme

Admin-Rechner
Starten des Programms SETUP.EXE im passenden Unterverzeichnis von IMAGE:UTILITY\WINDOWS.
Installieren Sie die Dienstprogramme unbedingt in ein eigenes Verzeichnis (z.B: C:\AUTOMIC\UTILITIES).

	4.	Anpassen der INI-Dateien an die Systemumgebung

Admin-Rechner

Die INI-Dateien tragen den selben Namen wie die zugehörigen Dienstprogramme. Passen Sie die enthaltenen Einträge Ihren Bedürfnissen an:

AE DB Archive: UCYBDBAR.ini

AE.DB Change: UCYBCHNG.ini

AE DB Client Copy: UCYBDBCC.ini

AE DB Load: UCYBDBLD.ini

AE DB Reorg: UCYBDBRE.ini

AE DB Reporting Tool: UCYBDBRT.ini

AE DB Revision Report: UCYBDBRR.ini

AE DB Unload: UCYBDBUN.ini

Fast alle Utilities benötigen Verbindunginformationen zur AE-Datenbank. Tragen Sie diese in die INI-Dateien ein. Wir empfehlen, einen eigenen Datenbank-Benutzer für AE anzulegen, und auf keinen Fall den Benutzer "sa" zu verwenden! Das zugehörige Passwort kann mit dem Programm UCYBCRYP.EXE verschlüsselt werden.
Rufen Sie das Programm über die Kommandozeile mit folgenden Parametern auf:

UCYBCRYP[.EXE] -p -nPasswort
Es wird eine Datei mit dem Namen Passwort.ucc im Verzeichnis des Programmes erzeugt, die das verschlüsselte Kennwort enthält.

	5.	Aufrufen der DLLs von einem selbst gewählten Pfad (optional)

Admin-Rechner
Eine Änderung des Pfades für die DLLs der Dienstprogramme kann durch einen Eintrag in den Umgebungsvariablen durchgeführt werden (Systemsteuerung -> System). Geben Sie die Variable JAVA_LIBRARY_PATH und den gewünschten Pfad ein. Die Bibliotheken werden künftig von diesem Verzeichnis aus geladen.
Alternativ dazu kann auch der Parameter "-Djava.library.path=Pfad" in den INI-Dateien verwendet werden. Tragen Sie diesen in der Zeile "cmd=" der Sektion [GLOBAL] ein.

Beispiel:

cmd="javaw" -Djava.library.path=..\libraries -jar -cp .;.\UC4LAF.jar UCYBDBAr.jar

	6.	Starten der Dienstprogramme

Admin-Rechner
Die Dienstprogramme können über folgende drei Arten aufgerufen werden:

*G.EXE: Normaler Start des Dienstprogrammes ("G" steht für GUI).
*.EXE: Programm, dem für Batchaufrufe Startparameter übergeben werden können.
*.BAT: Batchdatei für das Dienstprogramm

Um die Dienstprogramme via *.EXE-Datei ausführen zu können, muss eine 32-Bit Microsoft Visual C-Runtime Library installiert sein.

Siehe auch:

Konfiguration des Debuggers für eventuelle Programmabbrüche

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