Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

--- yms_install [21.08.2026 09:52] – [Installation] thooge
+++ yms_install [28.09.2026 16:54] (aktuell) – [Standard-Voraussetzungen] Python mupdf bindings thooge
@@ Zeile 3: / Zeile 3: @@
 ===== Installation =====
-Die aktuell gültige Installationsanleitung befindet sich in der Datei ''INSTALL''.
+Die aktuell gültige manuelle Installationsanleitung befindet sich in der Datei ''INSTALL''.
 Diese bezieht sich allerdings nur auf die Anwendung an sich. Eine funktionsfähige
 Systemumgebung mit Datenbank- und Webserver wird vorausgesetzt.
-Hier die Schritte die aufbauend auf einem frisch installiertem RaspiOS erforderlich
+Das System kann in einer dedizierten Betriebsumgebung installiert werde, oder aber auch als Zusatzkomponente in ein bestehendes Betriebssystem. Folgende Umgebungen sind geprüft:
+  * Standard-Linux
+    * aus der Debian-Familie: Debian, Devuan, Ubuntu, Mint, etc.
+  * Raspberry RaspiOS
+  * Spezielles Marine-OS
+    * [[yms_openplotter|Openplotter]]
+    * [[yms_bbn|Bareboat Necessities (BBN Marine OS)]]
+    * [[OBP60P_install| OBP60P Bordcomputer]]
+Die Software an sich wird über Git bereitgestellt. Sie sollte im Kontext eines normalen
+Benutzers heruntergeladen werden:
+<code bash>
+git clone https://git.hoogi.de/thooge/YMS
+</code>
+Prinzipiell gibt es drei Arten YMS zu installieren
+  - Gar keine Installation
+    * Start direkt aus dem Git-Repository
+  - Installation unter ''/usr/local''
+    * Dies ist die neutrale Variante und sollte unter jeder beliebigen Linux-Distribution funktionieren
+    * Hilfsscripte ''install.sh'' und ''inst_apache.sh''
+  - Installation als Debian-Paket ''.deb''
+    * ''make deb'' ausführen und das erzeugte Paket mit ''dpkg -i'' einspielen
+Grundsätzlich ist die Vorgehensweise die folgende:
+  - Systemvoraussetzungen prüfen / schaffen
+    - Webserver mit PHP
+    - Datenbankserver
+  - Datenbank initalisieren
+  - Web-GUI installieren
+  - Native-GUI installieren
+Falls die native Benutzeroberfläche nicht installiert wird, z.B für ein Headless-System,
+kann ein Kennwort für den initialen Benutzer ''captain'' mit ''python genpass.py''
+erzeugt werden. Notwendige Änderungen an der Datenbank müssen dann über die MariaDB-Konsole
+vorgenommen werden.
+Installationssupport ist wie für alle anderen Open-Boat-Projekte auch über das
+Segeln-Forum zu bekommen.
+===== Standard-Voraussetzungen =====
+Hier die Schritte die aufbauend auf einem frisch installiertem Betriebssystem erforderlich
 sind:
   * MariaDB Datenbank: ''apt-get install mariadb-server''
-  * Webserver, entweder Apache oder Lighttpd
+  * Webserver, entweder Apache, nginx oder Lighttpd
     * Apache mit PHP-Modul<code>
 apt-get install apache2 libapache2-mod-php
+</code>
+    * nginx mit php-fpm<code>
+TBD
 </code>
     * Lighttpd mit php-fpm:<code>
@@ Zeile 23: / Zeile 69: @@
   * PHP-Module<code>
 apt-get install php-mysql php-xml
+</code>
+  * Internationalisierung<code>
+apt-get install gettext
 </code>
   * PDF Werkzeuge (MuPDF)
     * '' apt-get install mupdf-tools''
   * Lokales, natives Frontend
-    * Python
+    * Python<code>
+apt-get install python3-bcrypt python3-mysqldb python3-fitz python3-pyudev
+</code>
     * GTK<code>
 apt-get install python3-gi gir1.2-gtk-3.0 gir1.2-rsvg-2.0
@@ Zeile 59: / Zeile 110: @@
 Die maximale Dokumentgröße muß in ''g_doc_maxsize'' angegeben, sowie
 zusätzlich in der PHP-Konfiguration (''php.ini'') eingestellt werden.
+==== Native-GUI ====
+Die Anwendung für den Bordcomputer kann direkt mit einem Installationsscript eingerichtet werden,
+nachdem die Web-GUI funktionsfähig ist:
+<code>
+./install.sh
+</code>
+Die Native-Gui greift auf den selben Datenbestand zu wie die Web-GUI.
+===== Debian Paket =====
+Die Erstellung eines Debian-Pakets ist vorbereitet.
+Voraussetzung:
+<code bash>
+apt-get install gettext debhelper-compat
+</code>
+Paket erstellen:
+<code bash>
+make deb
+</code>