Neue Eagle3D-Versionen werden vom ARN Smart Update-Server an Installationen mit aktiver Lizenz ausgeliefert. Sie installieren sie im Panel mit einem Klick. Eagle3D sichert die Datenbank und jede Datei, die es ändert, bevor es etwas schreibt.
So finden Sie es: Einstellungen → Aktualisierung (Administratoren). Wenn eine neue Version verfügbar ist, zeigt die Seitenleiste außerdem Update verfügbar: v… mit einem Link zu dieser Seite.
Bevor Sie beginnen
- Stellen Sie sicher, dass die Lizenz aktiv ist. Siehe Ihre Eagle3D-Lizenz aktivieren.
- Die PHP-Erweiterung
zipmuss installiert undapp/storagebeschreibbar sein. Einstellungen → Aktualisierung zeigt eine Warnung, wennzipfehlt. - Sichern Sie Ihre Daten. Öffnen Sie Einstellungen → Backup, klicken Sie auf Jetzt sichern und laden Sie die Datei herunter. Bewahren Sie außerdem eine Kopie der Datei
.envund des Ordnersuploadsauf; sie sind nicht Teil des Datenbank-Backups. Siehe Daten sichern und wiederherstellen. - Wählen Sie einen ruhigen Zeitpunkt. Während des Updates ist das System für einige Sekunden im Wartungsmodus.
Ein Update installieren
- Öffnen Sie Einstellungen → Aktualisierung. Installierte Version zeigt Ihre aktuelle Version.
- Klicken Sie auf Nach Updates suchen. Gibt es eine neue Version, zeigt Eagle3D Neue Version verfügbar, die Paketgröße und die Versionshinweise. Ein Pflicht-Update ist mit „Dieses Update ist als verpflichtend markiert.“ gekennzeichnet.
- Lesen Sie die Versionshinweise, klicken Sie dann auf Update installieren und bestätigen Sie.
- Eagle3D lädt das Paket herunter, prüft es und schreibt die Dateien („Paket wird heruntergeladen und geprüft, Dateien werden geschrieben...“) und führt dann die Datenbankschritte aus („Dateien geschrieben. Datenbankschritte werden ausgeführt...“).
- Sobald die Meldung „Update abgeschlossen. Installierte Version: …“ erscheint, ist das Update fertig.
Eagle3D sucht außerdem im Hintergrund nach Updates, höchstens alle 12 Stunden, während ein Administrator das Panel nutzt.
Was der Updater für Sie erledigt
- Er prüft das Paket anhand seiner SHA-256-Prüfsumme und der signierten Update-Informationen vom ARN Smart Server und bricht ab, wenn sie nicht übereinstimmen.
- Vor der Installation sichert es die Datenbank und jede Datei, die sich ändern wird. Schlägt das Schreiben einer Datei fehl, werden die bereits geschriebenen Dateien aus dieser Sicherung wiederhergestellt. Bricht der Server das Update während des Schreibens ab (zum Beispiel wegen eines Zeitlimits), werden die alten Dateien wiederhergestellt, sobald die Update-Sperre endet, spätestens nach 10 Minuten.
- Sind alle Dateien geschrieben, schließt die erste Anfrage, die mit der neuen Version läuft, die Datenbankschritte ab, auch wenn der Browser nie eine Antwort erhalten hat (zum Beispiel nach einem Proxy-Timeout). Die Seite zeigt dann „No reply from the server; checking the result of the update...“ und verfolgt das Update, statt es als fehlgeschlagen zu melden.
- Er verändert niemals Ihre Einstellungsdatei (
.env), Ihre Daten oder Ihre Backups. - Nach der Aktualisierung zeigt die Karte Letzte Aktualisierung die alte und die neue Version, das Datum, die Anzahl der Dateien und die erstellten Sicherungen. Eagle3D meldet die neue Version an den ARN Smart Server („An den ARN-Server gemeldet“).
Wenn ein Aktualisierungsschritt nicht abgeschlossen ist
Wenn unter Einstellungen → Aktualisierung die Meldung „Ein Aktualisierungsschritt (Datenbank) ist noch nicht abgeschlossen. Klicken Sie auf die Schaltfläche, um ihn abzuschließen.“ erscheint, klicken Sie auf Aktualisierung abschließen. Dadurch werden die verbleibenden Datenbankschritte mit der neuen Version ausgeführt.
Installationen mit einer früheren Version 1.0.x können direkt auf 2.0.0 aktualisiert werden.
Wenn die Aktualisierung fehlschlägt
| Meldung | Was zu tun ist |
|---|---|
| Für Aktualisierungen ist eine aktive Lizenz erforderlich. | Aktivieren oder verlängern Sie zuerst die Lizenz. |
| Die PHP-Erweiterung „zip“ fehlt auf diesem Server; Aktualisierungen können nicht installiert werden. | Aktivieren Sie die Erweiterung zip in Ihrem Hosting-Panel. |
| Der ARN-Aktualisierungsserver ist nicht erreichbar. | Prüfen Sie, ob Ihr Server ausgehende HTTPS-Verbindungen aufbauen kann, und versuchen Sie es erneut. |
| Eine andere Aktualisierung läuft gerade. Versuchen Sie es in einigen Minuten erneut. | Warten Sie einige Minuten; die Sperre endet von selbst. |
| Der SHA-256-Wert des Pakets stimmt nicht überein; die Datei ist beschädigt oder verändert. Abgebrochen. | Es wurde nichts geändert. Versuchen Sie es später erneut; tritt der Fehler wiederholt auf, wenden Sie sich an den Support. |
| Eine Datei konnte nicht geschrieben werden; die Änderungen wurden rückgängig gemacht | Prüfen Sie die Dateiberechtigungen des Anwendungsordners. |
| A file could not be written and these files could not be rolled back: … | Die Website bleibt im Wartungsmodus, und Eagle3D versucht erneut, die Dateien wiederherzustellen, sobald die Update-Sperre endet. Wird sie nicht wieder erreichbar, stellen Sie die genannten Dateien aus der in der Meldung genannten Sicherung in app/storage/updates wieder her oder wenden Sie sich an den Support. |
Aktualisierung mit einem Aktualisierungspaket
Wenn Ihnen der ARN Smart Support stattdessen ein Eagle3D-Aktualisierungspaket (eine ZIP-Datei) gibt:
- Erstellen Sie wie oben beschrieben eine Sicherung.
- Entpacken Sie das Paket in den Anwendungsordner und lassen Sie die vorhandenen Dateien ersetzen. Das Paket enthält weder
.env,.htaccess,web.config, den Ordnerinstallnochapp/storage, sodass Ihre Einstellungen, Daten und Sicherungen erhalten bleiben. - Melden Sie sich als Administrator an und öffnen Sie Einstellungen → Aktualisierung.
- Wenn angezeigt wird, dass ein Aktualisierungsschritt nicht abgeschlossen ist, klicken Sie auf Aktualisierung abschließen.
- Prüfen Sie die Installierte Version und die Version in der Fußzeile des Panels.
Verwenden Sie nach Möglichkeit die integrierte Aktualisierungsfunktion; sie prüft das Paket und kann Änderungen selbstständig rückgängig machen.
Sprachdateien und Aktualisierungen
Aktualisierungen ersetzen die zwölf Sprachdateien, die mit Eagle3D geliefert werden (ar, de, el, en, es, fa, fr, he, it, nl, ru, tr). Eine Sprachdatei, die Sie unter einem neuen Namen hinzugefügt haben, bleibt unberührt; geben Sie Ihrer eigenen Datei keinen dieser Codes, sonst wird sie bei einer Aktualisierung überschrieben. Siehe Unternehmensprofil, Land, Währung und Sprache.