====== YMS in BBN Marine OS ======

Homepage: https://github.com/bareboat-necessities/lysmarine_gen

Getestete Version: ''lysmarine-bbn-full-bookworm_2025-05-18-r1441-raspios-arm64.img.xz''

Alle folgenden Kommandos als ''root'' ausführen.
Root wird man nach Installation des System-Images in einer Konsole mit ''sudo -i''.
Das Initialkennwort lautet ''changeme''.

===== Web-GUI =====

  - Datenbankserver installieren<code>
apt-get install mariadb-server
</code>
  - Webserver installieren<code>
apt-get install apache2 libapache2-mod-php php-mysql php-xml
</code>
  - Zusätzliche Werkzeuge installieren<code>
apt-get install python3-mysqldb python3-bcrypt mupdf-tools pwgen
</code>
  - Quellen von YMS herunterladen<code>
git clone https://git.hoogi.de/thooge/YMS.git
cd YMS
</code>
  - Kennwort für Web-GUI-System erzeugen, wird im nächsten Schritt für die Anlage des Benutzers benötigt:<code>
pwgen -s 16 1
</code>
  - Datenbankbenutzer konfigurieren<code>
mariadb
CREATE DATABASE yms;

CREATE USER 'ymsweb'@'localhost' IDENTIFIED BY '********';
GRANT SELECT, INSERT, UPDATE, DELETE ON yms.* TO 'ymsweb'@'localhost';

exit
</code>
  - Datenbank initialisieren<code>
mariadb yms < db/mariadb.sql
mariadb yms < db/minimal.sql

optional

mariadb yms < db/generic.sql
</code>
  - Web-GUI installieren<code>
./inst_apache.sh
</code>
  - Kennwort in die Konfigurationsdatei ''config.inc'' eintragen<code>
nano /var/www/html/config.inc
</code>
  - Dateiablage einrichten<code>
mkdir /var/local/lib/yms
mkdir /var/local/lib/yms/thumb
chown -R www-data /var/local/lib/yms
chmod -R 750 /var/local/lib/yms

groupadd yms
usermod -aG yms www-data
usermod -aG yms user
chgrp yms /var/local/lib/yms
chgrp yms /var/local/lib/yms/thumb
chmod -R 770 /var/local/lib/yms
</code>
  - Test: Browser öffnen und //localhost// aufrufen

===== Native-GUI =====

Die Web-GUI muß zuvor installiert worden sein.

  - Abhängigkeiten installieren<code>
apt-get install gettext gir1.2-rsvg-2.0
</code>
  - Datenbankbenutzer konfigurieren<code>
mariadb
CREATE USER 'user'@'localhost' IDENTIFIED VIA unix_socket;
GRANT SELECT, INSERT, UPDATE, DELETE ON yms.* TO 'user'@'localhost';
exit
</code>
  - ''./install.sh'' ausführen
  - Wechseln von ''root'' zurück zum normalen Benutzer ''user''<code>
exit
newgrp yms
</code>
  - Im Benutzermenü ist das neue Programm jetzt unter "Office" zu finden
    * Beim ersten Start erscheint eine Fehlermeldung, eine Stardardkonfigurationsdatei wird angelegt
    * Die Konfigurationsdatei anpassen:
      * ''user''- und ''pass''-Zeilen löschen
      * unter ''host'' eintragen: ''socket''
  - Beim Start nach Konfigurationsanpassung sollte die GUI erscheinen