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

UserInterface installieren (Windows)

Hier finden Sie eine Anleitung für die Neuinstallation des UserInterface (Windows).

Aus Performancegründen sollten die UserInterfaces stets auf der lokalen Festplatte installiert werden. Eine Netzwerkinstallation ist des Weiteren nicht empfehlenswert, da dies bei Ausfällen eventuell einen Absturz des UserInterfaces zur Folge haben kann.

Die Kommunikation der UserInterfaces erfolgt ausschließlich über die Kommunikationsprozesse des AE-Systems. Damit sind keine Datenbank-Schnittstellen (ODBC, OCI oder CLI) erforderlich.

Installieren Sie das UserInterface unbedingt in ein eigenes Verzeichnis (z.B: C:\AUTOMIC\USERINTERFACE).

Ausgelieferte Dateien

Die Dateien des UserInterfaces befinden sich im Verzeichnis IMAGE:USERINTERFACE\WINDOWS.

Dateiname	Beschreibung
UCDJ.EXE	Startprogramm zum Aufruf des UserInterfaces
UCDJ.INI	Aufrufoptionen für das Startprogramm
UCDJ.BAT	Batch-Datei zum Aufruf des UserInterfaces
UCDJ.JAR	UserInterface in Java
UC4CONFIG.XML	Konfigurationsdatei für Verbindungen zu den Automation Engine Systemen
LOGIN_DAT.XML	Konfigurationsdatei für Benutzeranmeldungen am Automation Engine System
UC.MSL	Meldungsbibliothek
CALLHTMLHELP.DLL, CALLHTMLHELPIA64.DLL, CALLHTMLHELPX64.DLL, UC4DOCREF.PROPERTIES, UC4MSGREF.PROPERTIES	Dateien für den Aufruf der F1-Hilfe
CONFIGREF.CLASS	Konfigurationsklasse
SYNTHETICA.JAR, SYNTHETICAADDONS.JAR, UC4LOOKANDFEEL.JAR, ATTACHLAYOUT.JAR, SWINGX.JAR, SWING-WORKER-1.2.JAR	Layout der Oberfläche
UC4.WAV	WAV-Datei, die beim Start des UserInterfaces (Anzeige Splash-Screen) abgespielt wird.
SETUP.EXE	Installationsprogramm
UCXJPS84.JAR	Datei mit speziellen Java-Klassen für die PeopleSoft-Forms
AE-RA.JAR	RA-Framework
INTELLISENSE.JAR	Datei für die Autovervollständigungsfunktion des Script-Editors

Ablauf

	1.	Java Runtime Environment (JRE) installieren

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

Admin-Rechner und/oder Benutzer-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 das Java Runtime Environment verwendet, das 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 die AE dieses nicht benötigt, können Sie es in der Systemsteuerung deaktivieren.

	2.	UserInterface installieren

Admin-Rechner und/oder Benutzer-Rechner
Starten des Programms SETUP.EXE im Verzeichnis IMAGE:USERINTERFACE\WINDOWS.
Es werden alle Dateien, die für den Betrieb des UserInterfaces nötig sind, in das angegebene Verzeichnis kopiert. Das Default-Verzeichnis ist C:\AUTOMIC\USERINTERFACE\BIN.

	3.	Anpassen der Konfigurationsdateien

Admin-Rechner und/oder Benutzer-Rechner
Die meisten Werte in den Konfigurationsdateien werden vom UserInterface versorgt. Dennoch sind folgende Angaben unumgänglich.
Passen Sie die uc4config.xml-Datei an.

Eintragung des Verbindungs- und Systemnamens im Parameter <connection name="name" system="system">.
Angabe der Verbindungsdaten zum Kommunikationsprozess (DNS-Name oder TCP/IP-Adresse des Rechners, auf dem jener läuft, sowie die Portnummer). Die Informationen können Sie der INI-Datei der Automation Engine entnehmen (Sektion [PORTS]).

	4.	Nutzung der ERP Forms (optional)

Admin-Rechner und/oder Benutzer-Rechner

PeopleSoft:
Für die Verwendungder PS ERP Forms werden der PeopleSoft Java Object Adapter und spezielle Java-Klassen (UCXJPS84.jar) benötigt.
Passen Sie in der INI-Datei des UserInterfaces den Eintrag "classpath" entsprechend an (psjoa.jar).

Beispiel:

[ENVIRONMENT]
classpath=.;.\psjoa.jar;.\ucdj.jar;.\UCXJPS84.jar

	5.	Starten des UserInterfaces

Admin-Rechner und/oder Benutzer-Rechner

Verwenden Sie entweder die Datei UCDJ.EXE oder UCDJ.BAT, um das UserInterface auszuführen.

Der Java-Anwendung UCDJ.JAR sollte immer ausreichend Speicher zur Verfügung stehen. Ansonsten kann es zum Stillstand des UserInterface kommen. Erhöhen Sie dazu den Wert des Java-Startparameters -Xmx in der Datei UCDJ.INI (beim Aufruf über UCDJ.EXE) oder UCDJ.BAT empfohlenerweise auf 1024MB.

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

Mögliche Probleme

Während der Installation:

Zu wenig Speicherplatz:

Benötigt werden ungefähr 30 MB. Zur Verfügung stehender Speicherplatz wird vom Installationsprogramm geprüft.

Beim Programmstart:

Keine Verbindung zum Automation Engine System:

Einträge in der Datei uc4config.xml prüfen:

Tragen Sie den Namen des Automation Engine Systems ein, zu dem sich das UserInterface verbinden soll. Weiters ist die korrekte Angabe des Ports und des Rechnernamens bzw. der IP-Adresse auf dem sich der Kommunikationsprozess befindet wichtig.

Automation Engine System läuft nicht.

Stellen Sie sicher, dass die Serverprozesse aktiv sind!

Empfohlene Parametrisierung für Citrix

Java muss auf dem Citrix-Server lokal installiert sein
Für jedes verwendete UserInterface sollte mindestens der Speicher verfügbar sein, der beim Java-Aufruf in der INI-Datei (ucdj.ini) angegeben wurde.
Beispiel: cmd="javaw" -Xmx512m ...
Um sicherzustellen, dass die korrekte Java-Version verwendet wird, kann in der INI-Datei der absolute Java-Pfad angegeben werden.
Beispiel: cmd="C:\Program Files\Java\jre\bin\javaw" -Xmx512m ...
Die Log-/Trace-Dateien sowie die Konfigurationsdateien uc4config.xml und login_dat.xml sollten benutzerspezifisch getrennt werden (siehe unten).
Folgender Java-Parameter kann das Speichermanagement der JVM optimieren:
-XX:+UseConcMarkSweepGC

UserInterface Log- und Trace-Dateien benutzerspezifisch trennen

In der uc4config.xml können Umgebungsvariablen verwendet werden, um die Log-/Trace-Dateien abhängig vom jeweiligen Betriebssystem-Benutzer an unterschiedlichen Stellen abzulegen.

Beispiele der entsprechenden Sektion der uc4config.xml (Windows):

Die Log- und Trace-Dateien werden im Verzeichnis des Windows-Benutzers erstellt, welches die temporären Anwendungsdaten speichert. Im Dateinamen wird der Name des Benutzers eingesetzt.

<logging count="10">%APPDATA%/temp/UCDJ_LOG_##_%USERNAME%.TXT</logging>
<trace count="10" tcp="3" xml="0">%APPDATA%/temp/UCDJ_TRC_##_%USERNAME%.TXT</trace>

In diesem Beispiel werden die Log- und Trace-Dateien im UserInterface-Temp-Ordner abgelegt und enthalten ebenfalls den Namen des Windows-Benutzers:

<logging count="10">../temp/UCDJ_LOG_##_%USERNAME%.TXT</logging>
<trace count="10" tcp="3" xml="0">../temp/UCDJ_TRC_##_%USERNAME%.TXT</trace>

Benutzerspezifischer UserInterface-Start

Die Konfigurationsdateien uc4config.xml und login_dat.xml müssen für jeden OS-Benutzer vorhanden sein, der das UserInterface verwendet. Am besten mit einem sprechenden Namen, wie zum Beispiel uc4config_TEST.xml und login_dat_TEST.xml.

Option 1:

Das UserInterface mit den Startparametern -I und -J aufrufen, wobei der Benutzername wieder dynamisch über Umgebungsvariablen eingesetzt werden kann.

Beispiel: Startkommando für das UserInterface unter Windows
C:\AUTOMIC\UserInterface\bin\UCDJ.EXE -J"-OC:\AUTOMIC\UserInterface\bin\login_dat_%USERNAME%.xml –IC:\AUTOMIC\UserInterface\bin\uc4config_%USERNAME%.xml"

Option 2:

Der Aufruf des UserInterfaces bleibt gleich, die Spezifizierung der benutzerabhängigen Konfigurationsdateien erfolgt in der INI-Datei. Dazu sind Umgebungsvariablen für den Java-Aufruf in der INI-Datei (cmd=...) zu verwenden.

Beispiel der Sektion der INI-Datei:

[GLOBAL]
cmd="javaw" -Xmx512m com.uc4.ucdf.UCDialogFactory -U%User% -I./uc4config_%USERNAME%.xml -O./login_dat_%USERNAME%.xml

Soll nicht nur der Name, sondern auch der Pfad zu den XML-Dateien vom Benutzer abhängen, so ist eine eigene Umgebungsvariable für den Pfad vor dem Startkommando zu definieren. Beispiel:

INI-Datei:

[GLOBAL]
cmd="javaw" -Xmx256m com.uc4.ucdf.UCDialogFactory -U%User% -I%UI_XML%/UC4CONFIG_%USERNAME%.xml -O%UI_XML%/login_dat_%USERNAME%.xml

Aufruf des UserInterface:

Set UI_XML=C:\UI_XML_Files
C:\AUTOMIC\UserInterface\bin\UCDJ.EXE -F0 -IUCDJ_individualized.ini

Siehe auch:

Konfiguration des Debuggers für eventuelle Programmabbrüche

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