Projekt

Allgemein

Profil

Prodat Mobile Installieren » Historie » Revision 11

Revision 10 ([E] Rocco Kreutz, 07.03.2023 11:32) → Revision 11/32 ([E] Rocco Kreutz, 07.03.2023 11:59)

h1. FredaV2 Installieren 

 Momentan wird FredaV2 als ZIP und nicht als Setup ausgerollt.  

 * FredaV2 ist ein Windows Service, ein Web-Server 
 * Er muss daher auf einem Rechner installiert werden, welcher von allen Geräten erreicht werden kann, welche den Dienst benutzen wollen (Browser) 
 * Vorzugsweise, sollte dies mittels Domain im Intranet möglich sein 

 

 h3. Beispiel 

 * Im Beispiel wird FredaV2 DIREKT auf Laufwerk P:\ installiert 
 * Die ZIP dazu direkt im Laufwerk P: entpacken {{collapse(Aufklappen) 
 !clipboard-202303071049-gxi4d.png! 
 }} 
 * Unter files/dms/ werden die aus dem DMS geholten Dokumente gesichert, damit nicht jedesmal beim DMS angefragt werden muss 
 * Alle anderen (originären) Ordner sind Bibliotheken 
 ** Auch wenn es möglich ist die Dateien unter ext-7.5.1, uni-1.90.0.1563, unipackages-7.5.1, unim-1.90.0.1563 selber zu bearbeiten, um eigene Anpassungen am Layout zu erzielen, ist davon STRIKT abzuraten 
 ** Dasselbe gilt für alle mitgelieferten CSS/JS Dateien im Ordner files 
 ** In der Config ist es möglich eigene CSS/JS Dateien einzubinden 
 *** Diese müssen im Ordner files liegen oder in einem darunter liegenden Ordner 
 * Konfigurieren: 
 ** Die rot umrandeten Einträge müssen auf die eigenen Werte konfiguriert werden 
 ** Die blauen sind wahrscheinlich OK, könnten aber ebenfalls nötig sein 
 *** Falls der Server mehr als 1 NIC besitzt und der Freda-Service nur auf einer bestimmten NIC/IP laufen soll 
 ** {{collapse(manifest.json) 
 !clipboard-202303071047-gl92i.png! 
 }}  
 ** {{collapse(server.config.json) 
 !clipboard-202303071036-uwqol.png! 
 }}  
 *** Die mitgelieferten cert.key, cert.pem, chain.cer Dateien sind reine Dummy-Dateien (zur Veranschaulichung) 
 *** Siehe dazu "Zertifikate für das eigene Intranet":https://redmine.prodat-sql.de/projects/prodat-v12-public/wiki/Zertifikate_f%C3%BCr_das_eigene_Intranet 
 * Wenn alles konfiguriert wurde und die Zertifikats-Dateien vorhanden sind, kann der Dienst installiert werden 
 ** cmd öffnen 
 ** Nach P:/ wechseln 
 ** FredaService.exe /INSTALL {{collapse(ausführen) 
 !clipboard-202303071116-ukau5.png! 
 }}  
 ** Für Silent Installationen (Batch/CMD): FredaService.exe /INSTALL /SILENT 
 ** Service deinstallieren: FredaService.exe /UNINSTALL 
 ** Im Service Manager unter Windows erscheint der Service dann folgendermassen (jedoch NOCH NICHT gestartet !)  
 ** Im Bild wurde der Service nicht unter P:\ installiert ! {{collapse(Aufklappen) 
 !clipboard-202303071121-evhjr.png!  
 }} 
 * Die mitgelieferte Freda.Exe ist eine normale Anwendung, kein Service 
 ** Damit lässt sich schnell die Konfiguration testen, ohne dass man jedesmal erst den Service stoppen und wieder starten muss 
 ** Dazu einfach die Exe ausführen 
 ** Logs/Brwoser checken 
 ** Rechts unten in der Taskleiste (evtl. im Versteckten Bereich) auf das schwarze Prodat-Logo rechtsklicken und Shutdown wählen 
 ** Damit ist der WebServer wieder beendet 
 ** Wenn alles passt, den Service wieder starten (über die Windows-Service Verwaltung) 


 Der Service legt verschiedene Ordner während der Laufzeit an: 
 * {{collapse(Aufklappen) 
 !clipboard-202303071133-ryao7.png! 
 }} 
 * /files 
 ** Config: Paths/FilesFolder 
 * /files/dms/<dms-dokument-id>/ 
 ** Liegt IMMER unter <Config: Paths/FilesFolder>/dms 
 ** DMS-Dokumente 
 ** Dieser Ordner wird speziell behandelt, Zugriff für die Clients (Browser) ist nur innerhalb einer gültigen Session und gültigem Login möglich 
 ** Alle Dateien in diesem Ordner werden als DMS-Dokumente behandelt und unterliegen damit der Prodat-Rechte Überprüfung 
 ** Daher mqacht es keinen Sinn hier eigene Bilder abzulegen, welche evtl. über eigene CSS/JS Dateien aufgerufen werden 
 * /Administration 
 ** FredaV2 benutzt intern denselben Code (Daten-Klassen, Backend) wie Prodat, daher wird dieser Ordner angelegt aber nicht benutzt 
 * /cache/* 
 ** Config: Paths/CacheFolder 
 ** Hier legt der Service verschiedene (per Sesssion) Dateien ab, welche innerhalb einer Session oder global zwischen Sessions gemeinsam genutzt werden 
 ** Beim normalen beenden wird der komplette Ordner sofort aufgeräumt 
 * /log 
 ** Log des Services/Anwendung (Freda.exe) 
 ** Im Moment wird da noch zuviel reingeschrieben, das wird in Zukunft weit weniger 
 ** Wird nicht automatisch aufgeräumt 
 * /temp 
 ** Config: ProdatPaths/* wird derzeit noch nicht berücksichtigt 
 ** Hier wird für jede Session ein Verzeichniss angelegt, welches dem @<DESKTOP-Prodat-Installationsverzeichniss>\Temp@m entspricht {{collapse(Aufklappen) 
 !clipboard-202303071159-rczbu.png! 
 }}