New Eagle3D versions are delivered by the ARN Smart update server to installations with an active licence. You install them from the panel with one button. Eagle3D backs up the database and every file it changes before it writes anything.
Where to find it: Settings → Update (administrators). When a new version is available, the sidebar also shows Update available: v… with a link to this screen.
Before you start
- Make sure the licence is active. See Activate your Eagle3D licence.
- The PHP
zipextension must be installed, andapp/storagemust be writable. Settings → Update shows a warning ifzipis missing. - Back up your data. Open Settings → Backup, click Back Up Now and download the file. Also keep a copy of the
.envfile and theuploadsfolder; they are not part of the database backup. See Back up and restore your data. - Choose a quiet moment. The system is in maintenance mode for a few seconds during the update.
Install an update
- Open Settings → Update. Installed version shows your current version.
- Click Check for Updates. If a new version exists, Eagle3D shows New version available, the Package size and the Release notes. A mandatory update is marked "This update is marked as mandatory."
- Read the release notes, then click Install Update and confirm.
- Eagle3D downloads and verifies the package and writes the files ("Downloading and verifying the package, writing files..."), then applies the database steps ("Files written. Applying database steps...").
- When the message "Update complete. Installed version: …" appears, the update is finished.
Eagle3D also checks for updates in the background, at most every 12 hours, while an administrator uses the panel.
What the updater does for you
- It checks the package against its SHA-256 checksum and the signed update information from the ARN Smart server, and stops if they do not match.
- It backs up the database and every file that will change before installing. If writing a file fails, the files already written are put back from that backup. If the server stops the update while it writes (for example at a time limit), the old files are put back when the update lock ends, after at most 10 minutes.
- When all files are written, the first request that runs with the new version finishes the database steps, even if the browser never got the answer (for example after a proxy timeout). The page then shows "No reply from the server; checking the result of the update..." and follows the update instead of reporting it as failed.
- It never touches your settings file (
.env), your data or your backups. - After the update, the Last update card shows the old and new version, the date, the number of files and the backups taken. Eagle3D reports the new version to the ARN Smart server ("Reported to the ARN server").
If an update step is not finished
If Settings → Update shows "An update step (database) is not finished yet. Press the button to complete it.", click Complete Update. This applies the remaining database steps with the new version.
Installations on an earlier 1.0.x version can update directly to 2.0.0.
If the update fails
| Message | What to do |
|---|---|
| An active license is required for updates. | Activate or renew the licence first. |
| The PHP "zip" extension is missing on this server; updates cannot be installed. | Enable the zip extension in your hosting panel. |
| Could not reach the ARN update server. | Check that your server can open outgoing HTTPS connections, then try again. |
| Another update is in progress. Try again in a few minutes. | Wait a few minutes; the lock ends by itself. |
| The package SHA-256 does not match; the file is corrupt or modified. Aborted. | Nothing was changed. Try again later; if it repeats, contact support. |
| A file could not be written; changes were rolled back | Check the file permissions of the application folder. |
| A file could not be written and these files could not be rolled back: … | The site stays in maintenance mode, and Eagle3D tries to put the files back again when the update lock ends. If it does not open again, restore the named files from the backup in app/storage/updates that the message names, or contact support. |
Update with an update package
If ARN Smart support gives you an Eagle3D update package (a ZIP file) instead:
- Back up as described above.
- Extract the package into the application folder and let it replace the existing files. The package does not contain
.env,.htaccess,web.config, theinstallfolder orapp/storage, so your settings, data and backups stay in place. - Sign in as an administrator and open Settings → Update.
- If the screen shows that an update step is not finished, click Complete Update.
- Check Installed version and the version in the footer of the panel.
Use the built-in updater whenever you can; it verifies the package and can roll back on its own.
Language files and updates
Updates replace the twelve language files that come with Eagle3D (ar, de, el, en, es, fa, fr, he, it, nl, ru, tr). A language file you added under a new name is not touched; do not give your own file one of these codes, or an update will overwrite it. See Business profile, country, currency and language.