====== YMS in OpenPlotter ======

Getestet mit den aktuell stabilen Versionen von
[[https://openmarine.net/openplotter|OpenPlotter]] v3 und v4.

Alle folgenden Kommandos als ''root'' ausführen.

===== 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 'pi'@'localhost' IDENTIFIED VIA unix_socket;
GRANT SELECT, INSERT, UPDATE, DELETE ON yms.* TO 'pi'@'localhost';

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
</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/yms
mkdir /var/local/yms/thumb
chown -R www-data /var/local/yms
chmod -R 750 /var/local/yms

groupadd yms
usermod -aG yms www-data
usermod -aG yms pi
chgrp yms /var/local/yms
chgrp yms /var/local/yms/thumb
chmod -R 770 /var/local/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>
  - ''./install.sh'' ausführen
  - Im Benutzermenü ist das neue Programm jetzt unter "Büro" 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