Fehlermeldungen während der Paketinstallation

Während der Installation der benötigten Pakete, kommt es zu einer Meldung, dass Abhängigkeiten mit dem ‘libdvd-pkg’ Paket nicht aufgelöst werden können:

Eine Rekonfiguration des Pakets schafft Abhilfe:

sudo dpkg-reconfigure libdvd-pkg

Fehlermeldungen in Zusammenhang mit der Dockerumgebung

Fehler “starting opencaching-webserver .. error” oder “Starting webserver ... error”

Vermutlich läuft im Hintergrund bereits ein anderer Webservice auf Port 80.

Prüfen kann man das mit:

netstat -tanp | grep :80

Zum Beispiel ein apache2-Webserver kann gestoppt werden mit:

sudo systemctl stop apache2

Damit der apache2 nach einem Rechnerneustart nicht erneut aktiviert wird, kann man ihn generell deaktivieren:

sudo systemctl disable apache2

Alternativ lässt sich auch eine Override-Datei für die betroffenen Ports verwenden, was allerdings weitere Komplikationen mit sich führen kann (wie beispielsweise eine nicht funktionierende OKAPI). Aus diesem Grund sollte nach Möglichkeit das Stoppen der Standard-Services für Apache und einen Datenbank-Server vorgezogen werden.

Fehler “W: GPG error: https://dl.yarnpkg.com/debian stable InRelease: The following signatures were invalid: EXPKEYSIG“

Nach dem Ausführen von ./psh.phar docker:start kommt der Fehler. Hier ist das Zertifikat veraltet. Folgender Befehl löscht das Docker-Image.

docker-compose build --pull

Mit einen erneuten ./psh.phar docker:start läuft es wieder durch.

Fehler “ERROR: for opencaching-mariadb Cannot start service mariadb: driver failed programming external connectivity on endpoint opencaching-mariadb [..] Error starting userland proxy: listen tcp 0.0.0.0:3306: bind: address already in use”

Wenn beim docker:start diese Fehlermeldung kommt, läuft im Hintergrund bereits ein anderer Webservice (z.B. mysql) auf Port 3306.

Prüfen kann man das mit:

netstat -tanp | grep :3306

Zum Beispiel ein mysql-Webserver kann gestoppt werden mit:

sudo mysqladmin -u root shutdown

Fehler "The stream or file "/application/htdocs/var/logs/dev/dev.log" could not be opened: failed to open stream: Permission denied" oder ähnlich

Hier scheint der Webserver keine Zugriffsberechtigung auf bestimmte Pfade/Dateien zu haben.

Von einem Ändern der Zugriffsberechtigungen, z. B. mittels sudo chmod -R 777 ./var/log, sollte aus Sicherheitsgründen Abstand genommen werden.

Helfen kann, die Befehlsfolge

./psh.phar docker:ssh
./psh.phar docker:init
exit

ein weiteres Mal auszuführen.

Falls dies weiterhin keinen Erfolg bringt, können folgende Schritte zum Ändern der Zugriffsberechtigungen angewandt werden:

1. Ermitteln der ID des Containers oc-server3_php-fpm mittels sudo docker ps.

2. Öffnen einer Shell im Container: sudo docker exec -it 45b6e4994fac /bin/bash, wobei 45b6e4994fac die ID des Containers ist.

3. In der Container-Shell chmod -R 777 /application/htdocs/var/logs/dev/ ausführen.

4. Die Container-Shell regulär mittels exit verlassen.

Host-Mismatch bei Aufruf der OKAPI mit Port-Override

Falls in einer Override-Datei Ports überschrieben werden (siehe oben), funktioniert die OKAPI möglicherweise nicht richtig - stattdessen erscheint ein Hinweis auf einen Port-Mismatch. Dies kann auf folgende Art und Weise behoben werden:

1. Ermitteln der ID des Containers oc-server3_php-fpm mittels sudo docker ps.

2. Öffnen einer Shell im Container: sudo docker exec -it 45b6e4994fac /bin/bash, wobei 45b6e4994fac die ID des Containers ist.

3. Im Container einen Editor installieren, beispielsweise nano. Da der Container auf Ubuntu basiert, funktioniert dies mittels apt-get update && apt-get install nano.

4. Die passende Konfigurationsdatei mittels des Editors im Container öffnen, beispielsweise mittels nano /application/htdocs/config2/settings.inc.php.

5. Setzen von $dev_baseurl = 'http://docker.team-opencaching.de:2200'; und anschließendes Speichern der Datei. Hierbei ist 2200 der Port, der statt Port 80 für den Webserver in der Override-Datei konfiguriert worden ist.

Während docker:init kommt es im Abschnitt (3/31) zu einer Meldung “> mysql -uroot -proot -hmariadb -e "DROP DATABASE IF EXISTS opencaching" ERROR 2005 (HY000): Unknown MySQL server host 'mariadb' (-3).“

Abhilfe: ./psh.phar docker:init darf nicht außerhalb des Dockercontainers aufgerufen werden.

Während docker:init kommt es im Abschnitt (13/31) zu einer Meldung “PHP Fatal error: .. __toString() must not throw an exception ..“

Die Ursache ist nicht bekannt. Hier hilft aktuell nur ein Workaround, in dem die Exception im Script auskommentiert wird.

Hierzu in der Datei ../htdocs/vendor/symfony/symfony/src/Symfony/Component/DependencyInjection/Compiler/AutowirePass.php die Zeile 236 throw new AutoWiringFailedException auskommentieren. Die Datei ist allerdings erst während des ersten Ausführens von docker:init vorhanden.

Siehe auch: OCC-90 - Getting issue details... STATUS

Docker Services neu initialisieren, z.B. bei “W: GPG error: stable InRelease: The following signatures were invalid: EXPKEYSIG 23E7166788B63E1E Yarn Packaging <yarn@dan.cx>“

Treten während eines docker:init neue, merkwürdige und nicht näher spezifizierbare Fehler auf, kann es helfen, die Dockercontainer neu zu initialisieren mittels:

docker-compose build --pull

z.B. bei Update auf Symfony 5.2 kommt während docker:start-clean der Fehler ”mv: cannot stat '/root/.symfony/bin/symfony': No such file or directory
Service 'webserver' failed to build: The command '/bin/sh -c mv /root/.symfony/bin/symfony /usr/local/bin/symfony' returned a non-zero code: 1"

In diesem Fall in der Datei docker/httpd/Dockerfile die fehlerverursachende Zeile

RUN mv /root/.symfony/bin/symfony /usr/local/bin/symfony

auskommentieren und docker:start-clean erneut laufen lassen.

Während docker:start-clean: "\Doctrine\Common\Persistence\Mapping\Driver\MappingDriverChain()" not found

Dies ist ein Fehler in einem der doctrine/* Pakete (vermutlich doctrine/persistence) in bestimmten Paketversionen. Hier hilft, die Datei /htdocs/vendor/doctrine/doctrine-bundle/Resources/config/orm.xml Zeile 32 zu editieren:

<parameter key="doctrine.orm.metadata.driver_chain.class">Doctrine\Common\Persistence\Mapping\Driver\MappingDriverChain</parameter>

zu

<parameter key="doctrine.orm.metadata.driver_chain.class">Doctrine\Persistence\Mapping\Driver\MappingDriverChain</parameter>

Allerdings muss dies zum richtigen Zeitpunkt passieren. Nachdem docker:start-clean aufgerufen wurde, kurz warten, bis die Pakete heruntergeladen wurden und noch bevor Abschnitt 13/32 anfängt, muss die Datei korrigiert und gespeichert worden sein.

Meldung “DEPRECATED: The legacy builder is deprecated and will be removed in a future release. Install the buildx component to build images with BuildKit: https://docs.docker.com/go/buildx/ “

Scheinbar ändern sich beim lokal installierten Docker ein paar Pakete. Genaueres wurde noch nicht eruiert. Ggf. hier mal weiterstöbern: https://docs.docker.com/engine/install/ubuntu/

Fehlermeldungen beim Zugriff auf die Datenbank

Fehlermeldung “ERROR 2002 (HY000): Can't connect to local MySQL server through socket '/var/run/mysqld/mysqld.sock' (2)”

Es wurde vergessen, den Namen der Datenbank in der Kommandozeile zu übergeben.

mysql -uroot -proot -hmariadb opencaching

Fehlermeldungen beim Zugriff auf die Testserverdomain

Vorgehen zum Anlegen eines weiteren Benutzers (betrifft Legacy-Testsystem)

Zuerst via http://docker.team-opencaching.de/register.php einen neuen Nutzer registrieren. Zwar kommt dann die Meldung, dass der Aktivierungscode per Mail zugsandt wurde, dies passiert aber nie. Der Aktivierungscode muss aus der Test-Datenbank ausgelesen werden.
Der Code steht in Tabelle user im Feld activation_code.

Mit http://docker.team-opencaching.de/activation.php gelangt man zur Account-Aktivierungsseite. Hier die E-Mail-Adresse und den aus der DB kopierten Aktivierungscode eingeben. Der Account ist nun aktiviert, aber falls der Login nicht funktioniert: siehe hier auf der Seite weiter unten.

Der neu angelegte Benutzer kann sich nicht einloggen und wird immer wieder ohne Meldung auf die Login-Seite geleitet (betrifft Legacy-Testsystem)

Die exakte Ursache ist nicht bekannt. Abhilfe kann geschaffen werden, wenn beim entsprechenden User in der Datenbank in der Tabelle user das Feld permanent_login_flag auf 1 gesetzt wird.

Beim Anlegen des zweiten Cachelistings kommt eine Fehlermeldung (betrifft Legacy-Testsystem)

Bei einer leeren Datenbank funktioniert das Setzen und Hochzählen der OC-Codes nicht. Es muss einmal ein OC-Code von Hand gesetzt werden.

Hierzu auf dem Testserver ein Listing anlegen. Dann für diesen Cache in der Datenbank in der Tabelle caches das Feld wp_oc auf einen initialen Wert ändern, z.B. OC1234.

Beim Erstellen/Speichern eines Cachelistings kommen mehrere  Fehlermeldungen, u.a. “Warning: A non-numeric value encountered in /app/htdocs/newcache.php on line 1025” (betrifft Legacy-Testsystem)

Zuerst muss geschaut werden, ob eventuell der vorige Abschnitt (“Beim Anlegen des zweiten Cachelistings kommt eine Fehlermeldung“) zutrifft. Wurden die dort beschriebenen Maßnahmen bereits umgesetzt, kommt es zwar trotzdem zur Fehlermeldung, das Listing wurde aber erfolgreich angelegt bzw. gespeichert.

Es kann kein Logbild hochgeladen werden (betrifft Legacy-Testsystem)

Sobald man ein Logbild hochladen möchte, erscheint eine Fehlermeldung

Warning: move_uploaded_file(): Unable to move '/tmp/phpGmSzpi' to '/application/htdocs/config2/../images/uploads/700770A6-C101-11EA-BA77-0242AC120005.jpg' in /application/htdocs/lib2/logic/picture.class.php on line 856

Abhilfe: (noch) keine Ahnung. Die Bilder wurden aber trotzdem hochgeladen.

Bei Anlegen/Editieren eines Listings funktioniert die Attributeauswahl nicht (betrifft Legacy-Testsystem)

Editiert man ein Listing, stehen nicht alle Attribute zur Verfügung bzw. es können nicht alle Attribute ausgewählt werden.

Abhilfe: (noch) keine Ahnung.

[gelöst] Die Übersetzungen funktionieren nicht. Meist wird nur Englischer Text angezeigt. (betrifft Legacy-Testsystem)

Die vorhandenen Fremdsprachen werden auf dem Testsystem nicht korrekt dargestellt. Meistens wird nur der Englische Text oder ein Mischmasch aus Englisch und eingestellter Sprache angezeigt.

Abhilfe: im docker:start Skript wurde eine fehlende Komponente ergänzt, welche nun automatisch mitinstalliert wird. Dadurch werden die Sprachdateien korrekt erzeugt und die Übersetzungen funktionieren.

Siehe auch: RED-1278 - Getting issue details... STATUS

Dieser Fehler sollte somit nicht mehr auftauchen.

Das Länderauswahlfeld rechts oben auf der Seite ist leer und funktioniert nicht. (betrifft Legacy-Testsystem)

Alle php-Dateien im Cacheverzeichnis htdocs/var/cache2 müssen gelöscht werden.

Unter Linux:

./psh.phar docker:stop
rm htdocs/var/cache2/*.inc.php
./psh.phar docker:start

[gelöst] Beim Löschen von Logs kommt eine Fehlermeldung “This log entry has been created on another Opencaching website. The cache can only be edited there.”

Auf dem Testserver werden die Logs laut Datenbank (Tabelle ‘cache_logs', Spalte ‘nodes') als 'node=5’ gespeichert, obwohl es laut Tabelle 'nodes’ diese Ziffer gar nicht gibt.

Um Logs wieder über die normale Loglöschenfunktion löschen zu können, gibt es mehrere Möglichkeiten:

1. In der Datenbanktabelle ‘cache_logs’ den Eintrag in Spalte ‘nodes’ auf 4 ändern. (Dies entspricht der ‘Local Development’-Umgebung (siehe Tabelle ‘nodes’)).

2. in der Datei ‘/dev-ops/local.team-opencaching.de/templates/config2-settings.inc.tpl.php' den Eintrag ‘$opt['logic']['node']['id'] = 5;’ ändern auf '$opt['logic']['node']['id'] = 4;’ und das docker:init Script ausführen

3. der Pull Request https://github.com/OpencachingDeutschland/oc-server3/pull/830 behebt das Problem. Für bereits laufende Testserver einmalig das docker:init Script laufen lassen.

Es kann nicht auf die Domains docker.team-opencaching.de oder try.docker.team-opencaching.de zugegriffen werden.

Normalerweise sollte der Zugriff nach Installation der Testumgebung automatisch funktionieren. Sollte das nicht der Fall sein, kann mittels Anpassung der hosts-Datei ein Workaround geschaffen werden:

127.0.0.1	docker.team-opencaching.de
127.0.0.1	try.docker.team-opencaching.de

Abschalten von “NOTICE”-Meldungen. (Legacy)

Aufgrund diverser Updates werden vormals ignorierte Probleme nun mit einer “NOTICE”-Meldung kenntlich gemacht. Um die Meldungen zu unterdrücken, kann in das error_reporting Level geändert werden.

Beispiele für Fehlermeldungen:

Notice: Undefined index: error_password_not_ok in /app/htdocs/var/cache2/smarty/compiled/..
Notice: Trying to get property 'value' of non-object in /app/..

Abhilfe:

Bis Smarty 3.x: In der Datei /htdocs/vendor/smarty/smarty/libs/Smarty.class.php die Zeile mit $error_reporting ändern auf den nachfolgenden Code. Die Änderung ist nicht git-relevant und geht nach jedem “./psh.phar docker:start-clean” verloren.

public $error_reporting = E_ALL & ~E_NOTICE;

Ab Smarty 3.x und 4.x: In der Datei /htdocs/lib2/common.inc.php die obere Zeile (PHP_DEBUG_ON) mit $error_reporting ändern auf den nachfolgenden Code. Die Änderung ist permanent und muss vor einem Commit rückgängig gemacht werden, da sie sonst im github Repository landet.

ini_set('error_reporting', E_ALL & ~E_NOTICE);