Middleware installieren

Aus PPwiki
Version vom 29. Dezember 2020, 11:45 Uhr von Schreur (Diskussion | Beiträge) (Konfigurierung vereinfacht)
Wechseln zu: Navigation, Suche

Die Middleware besteht aus 2 Teilen. Ein Windows Service der die eigentliche Arbeit übernimmt (PATMiddlewareAndroidService.exe) und einem kleinen Konfigurationsprogramm (PATMiddlewareAndroid.exe). Beide wurden unter aktuellen Windows Servern jeweils 32 und 64 Bit getestet.

Beide Programme liegen entsprechend dem Plug-Plant Standard im Ordner P:\CDS\Programme\app.

1 Lizenzierung

Middleware 01.png

In diesem Ordner wird ebenfalls die Lizenzdatei ppp.lic benötigt. Diese Lizenzdatei muss von Plug-Plant angefordert werden und ist individuell für jeden PC/Server, auf dem die Middleware Software installiert wird.

Um diese Datei zu generieren, benötigen wir einen Computerabhängigen Schlüssel. Dieser kann über das Konfigurationsprogramm (1) im Reiter Lizensierung (2) generiert (3) werden.

Die nun zugesandte Datei wird in den Ordner „Middleware“ eingefügt.

2 Service installieren

Nun wird eine „Windows Eingabeaufforderung Admin“ benötigt. Dort wird im entsprechenden Ordner der Service mit folgendem Befehl installiert:

PATMiddlewareAndroidService.exe /install

3 Freigabe in Windows Firewall

Nachdem im Konfigurationsprogramm die Datenbankeinstellungen angepasst worden sind, empfiehlt es sich die PATMiddlewareAndroidService.exe in der Windowsfirewall freizugeben. Dazu wird in "Eingehende Regeln" der Port 10723 als PPApp_Port_10723 zugefügt.

4 Dienst starten

Middleware 03.png

Anschließend wird der Dienst als Administrator gestartet. Dies geschieht entweder über das Konfigurations-Programm (siehe Abbildung) oder per Kommandozeile mittels

net start patService

Wichtig: Als Speicherort der CSV-Dateien (3) ist unbedingt P:\CDS\PAT\Scan anzugeben!

Damit ist die Einrichtung der Middleware abgeschlossen.

Bei der Fehlermeldung "ORA-28040: Kein übereinstimmendes Athentifizierungs-Protokoll" muss entsprechend dieser Anweisung vorgegangen werden.
Kommt nicht in der Maske die Meldung Service ist gestartet, wurde der Dienst nicht als Administrator gestartet. Hier hilft nur: abbrechen und erneut "als Administrator" den Dienst starten. 


Möglicherweise kann der Dienst nicht gestartet werden. Dann in "PAT - Wartung - Def.Settings2 - Service" den Haken bei Druckjob läuft manuell entfernen. Anschließend erneut "als Administrator" den Dienst starten.

4.1 Konfigurierung vereinfacht

Middleware 03+.png

Mittlerweile ist das Konfigurieren über eine zusätzliche Datei ppma_config deutlich vereinfacht. Der Datenbank-Name sowie der Pfad müssen entsprechend angepasst werden.

Das Programm muss nicht mehr zwingend als Administrator ausgeführt werden.


5 Weitere Installationen

5.1 Views für die Middleware

Unter Zusatzmodule\PlugPlant\PP_APP\Middleware befindet sich die Datei Views_Tabellen_Trigger_Prozeduren_fuer_PP_Apps.sql. Mit dieser Datei können neuere Tabellen, Views und Trigger als Script ergänzt werden.

5.2 Trigger für Auto-Move?

In PAT-Produktion werden die neuen Standorte in eine Moving-List eingetragen und nach dem Umstellen aktualisiert. Soll das so beibehalten werden?

Einfacher ist es, mit einem weiteren Trigger nachträglich die Standorte per Scanner oder Tablet zu erfassen und bei der Aktualisierung der Daten einzutragen. Dazu muss der Trigger TPP_AUTO_MOVE installiert werden.

Dies ist mit jedem Kunden individuell abzuklären.

6 Deinstallation bzw. Update der Middleware

6.1 Update

Sollte es einmal notwendig sein die Middleware zu tauschen, müssen Sie den Dienst stoppen. Danach können Sie die PATMiddlewareAndroidService.exe austauschen. Um den Service zu stoppen nutzen Sie entweder das Konfigurationsprogramm oder den Kommandozeilenbefehl

net stop patService

6.2 Deinstallation

Zum kompletten Entfernen des Services geben Sie folgenden Befehl in die Windows Eingabeaufforderung ein (administrative Eingabeaufforderung benötigt):

PatMiddlewareAndroidService.exe /uninstall