install.lock: wohin damit und wie man damit aktualisiert
Die Datei install.lock schließt die Installationsseiten von Dolibarr. Der richtige Ordner, die Falle mit htdocs und upgrade.unlock, um ohne Löschen zu aktualisieren.
Nach einer Installation zeigt die Startseite von Dolibarr den Administratoren:
Achtung, nach Abschluss der Installation müssen Sie die Installations- und Migrationstools durch Hinzufügen der Datei install.lock im Verzeichnis /var/www/documents deaktivieren. Die Nichterstellung dieser Datei stellt ein schwerwiegendes Sicherheitsrisiko dar.
Der angezeigte Pfad ist Ihr Dokumentenordner. Genau dort gehört die Datei hin.
Warum der Assistent sie nicht anlegt
Ohne diese Datei kann jeder /install/ auf Ihrem Server öffnen und den Assistenten erneut starten.
Trotzdem legt der Web-Assistent sie nicht an: Auf der Testinstanz gab es nach dem letzten Schritt
keine install.lock.
Das ist gewollt, und der Code erklärt es: Eine vom Assistenten angelegte Datei gehörte dem Webserver, der sie also auch löschen könnte. Dolibarr bittet Sie deshalb, sie selbst anzulegen, mit einem anderen Konto.
Anlegen
Der Dokumentenordner steht in der Zeile $dolibarr_main_data_root Ihrer conf.php. Auf einem
Linux-Server:
sudo touch /pfad/zu/documents/install.lock
sudo chmod 444 /pfad/zu/documents/install.lockDie Datei darf leer bleiben. Mit sudo angelegt, gehört sie root: Der Webserver kann sie lesen,
aber nicht löschen. Laden Sie die Startseite neu: Die Warnung ist verschwunden.
Beim offiziellen Docker-Image dolibarr/dolibarr legt das Startskript sie selbst in
/var/www/documents/ an, am Ende der automatischen Installation, die mit einer MariaDB- oder
MySQL-Datenbank standardmäßig aktiv ist.
Was die Installationsseiten danach zeigen
Jede Seite unter /install/ zeigt nun:
Die Installations-/Upgrade-Seiten wurden aus Sicherheitsgründen deaktiviert (durch das Vorhandensein einer Datei install.lock im Dokumenten-Verzeichnis).
Das ist das erwartete Verhalten.
Die Falle mit htdocs
Dolibarr akzeptiert auch eine install.lock im Wurzelverzeichnis von htdocs/: Die
Installationsseiten sind dann ebenfalls geschlossen. Die Warnung auf der Startseite prüft aber nur
den Dokumentenordner. Auf der Testinstanz war die Installation mit der Datei nur in htdocs/
gesperrt, die Warnung aber weiterhin sichtbar. Legen Sie sie in den Dokumentenordner.
Aktualisieren, ohne sie zu löschen
Für ein Update müssen Sie install.lock nicht entfernen. Legen Sie daneben eine Datei
upgrade.unlock an:
sudo touch /pfad/zu/documents/upgrade.unlockDie Update-Seiten öffnen sich wieder, die Seiten einer Neuinstallation bleiben geschlossen: Auf der
Testinstanz wurde die Prüfseite angezeigt, die Seite der Erstkonfiguration nicht. Löschen Sie
upgrade.unlock nach dem Update.
Die vollständige Methode, vorher, währenddessen und danach, steht in Dolibarr Update: Checkliste und Versionen 16 bis 24.
install.lock löschen oder upgrade.unlock anlegen?
Die Meldung der geschlossenen Seiten nennt beides: „müssen Sie im Dokumentenverzeichnis von Dolibarr
die Datei install.lock entfernen (oder eine Datei upgrade.unlock für das Upgrade erstellen)“.
Wählen Sie für ein Update immer upgrade.unlock: Es öffnet nur das Update, während das Löschen von
install.lock auch eine Neuinstallation wieder öffnet.