UserInterface installieren

UserInterface installieren

UserInterface installieren (Windows)

---

UserInterface (UNIX) installieren

Hier finden Sie eine Anleitung für die Neuinstallation eines UserInterface.

Das UserInterface der Automation Engine wurde vollständig in Java programmiert. Damit ist auf den Rechnern, auf denen das UserInterface installiert werden soll, Java 2 JRE (Java Runtime Environment) erforderlich.

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 Automation Engine Systems. Damit sind keine Datenbank-Schnittstellen erforderlich.

Installieren Sie das UserInterface unbedingt in ein eigenes Verzeichnis.

Voraussetzung

• Gültige Benutzerkennung für die Installation (AE)

Ausgelieferte Dateien

Die Dateien des UserInterfaces befinden sich im Verzeichnis IMAGE:USERINTERFACE\UNIX. Die einzelnen Dateien sind in der Datei ucdj.tar.gz zusammengefasst.

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

	2.	UserInterface installieren

• Admin-Rechner und/oder Benutzer-Rechner
• Anmelden unter der Benutzerkennung "AE".
• Anlegen eines Verzeichnisses für das UserInterface (Standardwert: /opt/globalDC).
• Datei ucdj.tar.gz aus IMAGE:UserInterface/<Unix-Plattform> nach /opt/globalDC mit ftp binär übertragen.
• Entpacken der übertragenen tar-Datei im aktuellen Verzeichnis (/opt/globalDC).
  gzip -d ucdj.tar.gz oder gunzip ucdj.tar.gz
  tar xvf ucdj.tar
  
  (Linux: tar -zxvf ucs???.tar.gz).

	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.
• Datei uc4config.xml wie folgt anpassen:
• Eintragung des Verbindungs- und Systemnamens im Parameter <connection name="name" system="system">.
• Angabe der Verbindungsdaten zum Kommunikationsprozess (DNS-Name oder die 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 Verwendung der 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
• Der folgende Befehl führt das Start-Script aus:
  
  chmod +x ucdj.sh

Mögliche Probleme

Während der Installation:

• Zu wenig Speicherplatz:
  
  Benötigt werden ungefähr 20 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