Pyre – Installation
http://evo-git/py/pyre/blob/master/tutorial-doc/README.md
Pyre ist keine Standalone-Software sondern besteht aus mehreren Softwarepaketen und einigen Konfigurationsschritten die am Ende in EvoApps und ePZE eingebaut werden.
1. Installation von Python
Python Version 3.8 oder höher. Sinnvoll ist eine Custominstallation bei der der Installationspath selbst gewählt und nicht automatisch vergeben wird.
Hintergrund ist, dass der Installationspath bei automatische Führung im Benutzerverzeichnis des Installationsbenutzers liegt, und je nach Kundenkonfiguration und Berechtigung des Windows-Servers kann dann diese Ordner nicht für andere Benutzer erreichbar sein kann.
Path bei automatischer Installation c:\Users\<Username>\appdata\… (versteckter Ordner im Userverzeichnis)
Empfohlen: z.B. c:\Python38
2. Installation von wkhtmltopdf.exe
Dieses Softwarepaket kann aus dem Internet heruntergeladen werden. https://wkhtmltopdf.org/
Empehlenswert ist der Standardinstallationspath der vom Programm vorgeschlagen wird.
3. SIS-Paket pyre
In SFA-HOME wird das Paket entpackt und mit Ordnername pyre betitelt.
Aktuelle PYRE-Dateien befinden sich aktuell auf dem Entwicklungsserver Tasmania oder auf dem A1 Demo-Server von GHI.
Anschließend wird mit Ausführung von python.exe setup.py install die Installation abgeschlossen.
4. Environmentvariablen
Es sind für die in den ersten Schritten installierten Softwarepakete Environmentvariablen in der Windows-Sytemsteuerung zu setzen.
SFA_PY <SFA_HOME>/pyre
SFALOG <SFA_HOME>\log\pyre
WKHTMLTOPDF_LOCATION C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe (Oder den alternativen Installationspath der bei der Installation angegeben wurde)
PATH:
- Kontrolle ob <SFA_HOME>/bin im Path enthalten ist und gegebenenfalls ergänzen. Ohne dieser Einstellung funktioniert PZE nicht.
- Kontrolle ob <Python_Home> und <Python_Home>/Scripts im PATH liegen. Sonst hinzufügen.
<SFA_HOME> muss immer als absoluter PATH angegeben.
5. Setzen der Properties
Das Standardprogramm zum ausführen der Listen muss durch PYRE ersetzt werden.
- KLASSE: sisworld.sfa.appservlet.runLgl
- ATTRIBUTE:runLglCommand
- VALUE:python C:\SisWorld\SFA\$SFA_VERSION$\pyre\RunLGL.py $SFA_VERSION$
- BESCHREIBUNG: PYRE
6. Konfiguration von pyre
Für PYRE muss die Datenbankverbindung eingerichtet werden. Dazu findet sich im Ordner <SFA_HOME>/pyre die Datei pyre_cfg.yml. Zunächst wird diese eine Ebene höher kopiert unter <SFA_HOME> und anschliessend editiert.
Der Eintrag
dns: (DESCRIPTION=(ADDRESS=(PROTOCOL=TCP)(HOST=sisevodemo3)(PORT=1521))(CONNECT_DATA=(SERVER=DEDICATED)(SERVICE_NAME=XEPDB1)))
entspricht den Daten der ORACLE_LISTENER.ora- oder ORACLE_TNSNAMES.ora-Dateien, und dort können die korrekten Daten gelesen und hier eingefügt werden.
7. Neustart des ganzen Servers, um alle Änderungen zu übernehmen.
8. ISSUES bei der Installation
Pyre befindet sich in der Entwicklung und es können immer Sideeffects auftreten die hier noch nicht beschrieben wurden.
A. Fehlende Python-Packete in setup.py.
Es hat sich gezeigt das nicht alle Pakete die für pyre in setup.py enthalten sind. Abhängig vom Entwicklungsstatus müssen diese ergänzt werden.
Es gibt Logfiles für die Ausführung von PYRE die Hinweise geben welche Pakete fehlen und diese müssen anschließend nachinstalliert werden.