Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,090 of 9,090 pages
About the help in other languages
All help pages

Upgrade mit der Konsole: exp:upgrade

Diese Anleitung erklärt ./console exp:upgrade: den einen Befehl, der die Datenbank und die Einstellungen einer Installation von Exponential 6.0 auf den Stand des Codes bringt, den sie ausführt. Er zeigt zuerst, was er…

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/guides/upgrading-with-the-console.md

On this page

This page is a translation. Read the English original

Upgrade mit der Konsole: exp:upgrade

Diese Anleitung erklärt ./console exp:upgrade: den einen Befehl, der die Datenbank und die Einstellungen einer Installation von Exponential 6.0 auf den Stand des Codes bringt, den sie ausführt. Er zeigt zuerst, was er ändern würde, macht eine Sicherung, führt die Schritte der Reihe nach aus, zeichnet auf, was er getan hat, und prüft, ob die Site danach noch antwortet. Er ersetzt die Liste aus SQL-Dateien, Update-Skripten und Setup-Befehlen im Abschnitt „Upgrading“ eines Releases; diese Liste bleibt im Changelog als Referenz, und jeder Punkt nennt den Schritt, der ihn erledigt.

Sie richtet sich an Administratoren, die eine Installation aktualisieren, und an alle, die Upgrades aus einer Deployment-Pipeline ausführen. Alles Folgende wurde am 29. Oktober 2026 auf SQLite-, MariaDB- und PostgreSQL-Datenbanken ausgeführt.

Anleitungen · Siehe auch: Upgrade, Die Upgrade-Prüfung, Upgrade-Schritte für Erweiterungen, Migrationen, Migrationen: der Einstieg, Bereitstellung, Changelog 6.0.15

Kurz

./console exp:upgrade:status            # was erledigt ist, was offen ist; nichts wird geändert
./console exp:upgrade                   # Probelauf: was jeder offene Schritt ändern würde
./console exp:upgrade --apply           # Sicherung, dann jeder offene Schritt, dann Deploy und Prüfung

Führen Sie die Befehle im Wurzelverzeichnis der Installation als der Benutzer aus, unter dem der Webserver läuft (als root mit --allow-root-user). Ohne --apply wird nie etwas geschrieben.

Die Stufen

Ein Upgrade besteht aus fünf Stufen, die immer in dieser Reihenfolge laufen. Jede ist ein eigener Befehl, und exp:upgrade führt alle in einem Aufruf aus.

#StufeBefehlWas sie tut
1codeexp:upgrade:codeder Git-Checkout der Installation (und jeder --repos-Checkout) auf --to oder seinen Upstream gebracht, nur Fast-Forward, über git_manager
2librariesexp:upgrade:librariesvendor/ enthält, was composer.lock nennt (composer install, oder vorher --update benannter Pakete), mit Sicherheitsprüfung
3databaseexp:upgrade:databasedie Tabellen, Spalten, Indizes und Zeilen, die das Release braucht, auf jeder Datenbank-Engine
4scriptsexp:upgrade:scriptsdie PHP-Upgrade-Schritte: die Update-Skripte und die Setup-Befehle, über ihre Klassen
5finishexp:upgrade:finishexp:velocity deploy --kernel (Autoloads, Caches, PHP-FPM, Velocity), danach ein Abruf der Startseite

Eine spätere Stufe schreibt nicht, solange eine frühere offene Schritte hat (--force-order führt sie trotzdem aus): Richtlinien werden nicht in eine Datenbank geschrieben, der die Tabellen dafür fehlen. Die Abschluss-Stufe hat nur dann Arbeit, wenn der Lauf etwas geändert hat oder wenn Sie exp:upgrade:finish allein ausführen.

Jeder Schritt und sein Zustand

Jede Stufe besteht aus Schritten. ./console exp:upgrade:steps listet sie in der Reihenfolge auf, in der sie laufen; jeder Schritt hat eine ID, die sich nie ändert, etwa 6.0.15-user-audit-table.

Ein Schritt sieht immer in der Installation selbst nach, nie nur in einer Aufzeichnung: Eine Tabelle, die er anlegt, wird im Katalog der Datenbank gesucht, eine Richtlinie in der Rolle. Was Sie von Hand mit der SQL-Update-Datei oder einem alten Skript erledigt haben, zählt.

ZustandBedeutet
donevorhanden, und exp:upgrade hat es ausgeführt (die Aufzeichnung sagt wann und wie lange)
not-neededvorhanden ohne exp:upgrade (eine neue Installation oder von Hand erledigt), oder nicht für diese Installation (eine andere Engine, eine nicht installierte Funktion)
pendingfehlt: der Schritt hat Arbeit
failedfehlt, und der letzte Versuch ist gescheitert; die Meldung steht in der Aufzeichnung
unknownlässt sich nicht feststellen; der Grund wird angezeigt, ein Lauf überspringt den Schritt und macht weiter
$ ./console exp:upgrade:status
Exponential upgrade: status
Code 6.0.15stable, database sqlite, version 6.0.15stable

Stage database     pending (1 pending)
  pending     6.0.15-migration-tables              missing: table exp_migration, table exp_migration_run
  not-needed  6.0.15-upgrade-record-table          in place: no table expupgrade_step
  not-needed  6.0.15-user-password-hash-width      not for sqlite
  not-needed  6.0.15-trash-columns                 in place: ezcontentobject_trash.trashed, ...
  ...
Stage scripts      not-needed
  not-needed  6.0.15-editor-policies               in place
  ...
Summary: 1 pending, 0 done, 29 not needed, 0 failed, 0 unknown
PASS

So sieht eine Installation aus, die von Hand aktualisiert wurde: alles ist not-needed außer den Aufzeichnungstabellen, die mit exp:upgrade selbst neu sind.

Der Probelauf

./console exp:upgrade (oder der Befehl einer Stufe) ohne --apply listet für jeden offenen Schritt auf, was er ändern würde: das SQL, das er auf dieser Engine ausführen würde, die Richtlinien, die er hinzufügen würde, die Zeilen, die er anlegen würde. Er schreibt nichts und nimmt keine Sperre. --dry-run wird als dasselbe angenommen; --apply zusammen mit --dry-run ist ein Bedienfehler (Exit-Code 2).

Stage database     pending (1 pending)
  pending     6.0.15-migration-tables              missing: table exp_migration, table exp_migration_run
              would create table exp_migration, exp_migration_run: CREATE TABLE exp_migration ( ... PRIMARY KEY ( source, migration_id ) ); ...

Ausführen

./console exp:upgrade --apply
  1. Die Sperre var/<site>/upgrade.lock wird genommen: Ein zweiter Lauf zur selben Zeit endet mit Exit-Code 1. Es ist dieselbe Sperre, die ein Lauf von Migrationen nimmt, sodass ein Upgrade und ein Migrationslauf nie gleichzeitig schreiben.
  2. Vor dem ersten Schreiben wird ein Sicherungspunkt angelegt (siehe unten), der Punkt zum Zurückrollen; scheitert er, wird nichts geändert.
  3. Die offenen Schritte laufen der Reihe nach. Nach jedem sieht der Schritt erneut in der Installation nach; nur wenn seine Wirkung jetzt da ist, wird er als done aufgezeichnet.
  4. Der erste Schritt, der scheitert, beendet den Lauf (Exit-Code 1). Die Schritte danach werden als nicht ausgeführt gelistet. Beheben Sie die Ursache und starten Sie den Befehl erneut: Was erledigt ist, wird nicht zweimal erledigt, und ein halb ausgeführter Schritt wird vervollständigt.
  5. Die Abschluss-Stufe stellt die Änderungen bereit und ruft die Startseite von [SiteSettings] SiteURL (oder jede --url) ab.
  6. Die Installation wird geprüft (siehe unten). Scheitert der Lauf oder die Prüfung, endet der Befehl mit Exit-Code 1 und listet die Sicherungspunkte, die neuesten zuerst, jeden mit dem Befehl, der darauf zurückrollt; mit --rollback-on-fail rollt er sofort auf den Sicherungspunkt aus Schritt 2 zurück. Besteht sie, legt --post-caption einen Sicherungspunkt des geprüften Stands an, den „letzten guten“ für das nächste Upgrade.

Was läuft, wählen Sie mit --stages=database,scripts, --only=<Schritt-ID> und --skip=<Schritt-ID> (als Komma-Liste oder wiederholt). --no-deploy schließt nur mit den Autoloads der Erweiterungen und den INI-, Template- und Inhalts-Caches ab, wenn Sie später selbst bereitstellen.

Hat die Code-Stufe den Code bewegt, laufen die Stufen danach in einem neuen PHP-Prozess mit denselben Optionen: Der Prozess, der begonnen hat, hat die alten Klassen und die alte Liste der Schritte geladen, der neue liest den neuen Code. Der Bericht beider ist ein Bericht, und er sagt es.

Die Code-Stufe

./console exp:upgrade:code --to=v6.0.16                 # Probelauf: holt (fetch), listet die kommenden Commits
./console exp:upgrade --apply --to=v6.0.16              # das ganze Upgrade auf dieses Release
./console exp:upgrade:code --apply --repos=extension/myext

Der Git-Checkout der Installation wird auf --to (einen Tag, einen Branch oder einen Commit) gebracht oder, ohne die Option, auf den Upstream seines Branches, über git_manager (extension/git_manager), nur per Fast-Forward. Die Submodule, die die Installation aufzeichnet, folgen. --repos nennt weitere Checkouts in der Installation, jeder geht auf seinen eigenen Upstream oder --to. Ein Checkout wird verweigert, wenn:

  • er lokale Änderungen in versionierten Dateien hat;
  • er Commits hat, die dem Ziel fehlen (kein Fast-Forward);
  • der Prozess nicht sein Eigentümer ist (führen Sie das Upgrade als der Benutzer aus, dem die Dateien gehören, sudo -u <Eigentümer>).

exp:upgrade:status liest die Remote-Tracking-Refs, wie der letzte Fetch sie hinterlassen hat. Probelauf und Lauf holen zuerst, nur die Refs, nie das Arbeitsverzeichnis, und nur als Eigentümer. Der Sicherungspunkt vor dem ersten Schreiben enthält die Commits, auf denen jeder Checkout stand (code.json). Ohne git_manager, oder wenn die Installation kein Git-Checkout ist, gilt die Stufe nicht: Aktualisieren Sie den Code, wie es Upgrade, Teil C, beschreibt.

Die Bibliotheken-Stufe

./console exp:upgrade:libraries                         # Probelauf: die abweichenden Pakete, die Prüfung
./console exp:upgrade:libraries --apply
./console exp:upgrade:libraries --apply --update=guzzlehttp/guzzle

6.0.15-libraries-install vergleicht composer.lock mit dem, was laut vendor/composer/installed.json installiert ist, und führt composer install aus, mit den Dev-Paketen nur, wenn vendor/ sie hatte. 6.0.15-libraries-update führt vorher composer update <Pakete> --with-dependencies aus, nur für die mit --update genannten Pakete; committen Sie danach die neue composer.lock. composer audit läuft vor und nach der Installation und meldet Sicherheitshinweise und aufgegebene Pakete; es hält den Lauf nie an (--no-audit überspringt es). --composer= nennt das Composer-Programm oder composer.phar.

Die Installation wird verweigert, und nichts wird installiert, wenn:

  • Composer lokale Änderungen in vendor/ meldet (composer status);
  • ein Paket, das sie ändern würde, ein eigener Git-Checkout ist (eine Erweiterung, die per Git und nicht per Composer aktualisiert wird: bewegen Sie sie stattdessen mit der Code-Stufe und --repos=);
  • der Prozess nicht der Eigentümer der Installation ist.

--allow-vendor-changes installiert über die ersten beiden hinweg.

Auf dem Weg zu 6.0.15 tauscht diese Stufe auch die Bibliotheken des Kernels aus: Die composer.lock des Releases nennt die expcomponents (se7enxweb/expcomponents-*, den Fork der Zeta Components durch Exponential) statt zetacomponents/*, daher entfernt composer install jedes Ursprungspaket und installiert seinen Fork. Der Probelauf zeigt beides. Die Klassen sind dieselben; siehe Upgrade-Hinweise: der Wechsel zu expcomponents.

Sicherungspunkte

Ein Sicherungspunkt (Caption) ist ein sicherer Zeitpunkt: die vollständige Sicherung von git_manager (extension/git_manager, der Datenbankabzug und der Speicher unter var/) im Sicherungsordner von git_manager, mit dem, was exp:upgrade in seinem Ordner upgrade/ hinzufügt:

Im SicherungspunktWas es ist
sql_<Sicherungspunkt>.tar.gz, dump.jsondie Datenbank: MySQL und MariaDB mysqldump, PostgreSQL pg_dump --clean, SQLite eine konsistente Kopie (VACUUM INTO), MongoDB mongodump; Oracle hat keinen (Export mit expdp)
var_<Sicherungspunkt>.tar.gzder Speicher unter var/ (ohne die VarExcludeDirs von git_manager)
upgrade/settings/overridedie Einstellungs-Overrides
upgrade/libraries/composer.json, composer.lock, vendor/composer/installed.json
upgrade/code.jsonder Commit des Checkouts der Installation und jedes --repos-Checkouts
upgrade/caption.jsondie Bezeichnung, die Art (pre, post, safety, manual), die Versionen (Datenbank, Code, Erweiterungen), die Engine, die Tabellen
upgrade/checksums.jsondie SHA-256-Prüfsumme jeder Datei des Sicherungspunkts

exp:upgrade --apply legt einen Sicherungspunkt pre mit der Bezeichnung upgrade <von>→<nach> <Zeit> pre an, bevor es irgendetwas schreibt, und zeichnet ihn im Bericht und in der Aufzeichnung auf (exp_migration, vor dem Schritt 6.0.15-migration-tables in expupgrade_step). Ohne git_manager, oder mit einem git_manager, der die Engine nicht sichern kann (ein älterer sichert nur MySQL), legt exp:upgrade den Sicherungspunkt selbst in var/backup/upgrade/<Zeit>/ an (die Datenbank, kein Speicher) und sagt warum. --no-caption (dasselbe wie --no-backup) schreibt ohne einen; auf einer Installation, deren Einstellungen sie als Produktion ausweisen (site.ini [AdminEnvironment] Level=production, oder Level=auto mit EXP_ENV gleich prod, production oder live), wird das mit Exit-Code 2 verweigert, außer zusätzlich ist --force-no-caption angegeben.

./console exp:upgrade:captions                                  # jeder Sicherungspunkt, neueste zuerst, mit dem Befehl zum Zurückrollen
./console exp:upgrade:captions --verify=2026-10-29_10-15-00     # Prüfsummen, und der Abzug in eine Wegwerf-Datenbank eingespielt
./console exp:upgrade:captions --prune                          # was die Aufbewahrungs-Einstellungen freigeben
./console exp:upgrade:captions --prune --apply

Die Liste zeigt auch die eigenen Sicherungspunkte von git_manager. --verify prüft jede Prüfsumme und spielt den Datenbankabzug in eine Wegwerf-Datenbank ein (SQLite: eine Kopie und PRAGMA integrity_check; MySQL, MariaDB und PostgreSQL: eine Datenbank <Name>_capverify_<pid>, mit dem Konto der Installation angelegt, geladen, gezählt und gelöscht; ein MySQL-Abzug mit --databases wird ohne sein CREATE DATABASE und USE geladen, damit er nie die laufende Datenbank erreicht). --prune behält die neuesten CaptionKeep (10), jeden Sicherungspunkt, der jünger als CaptionKeepDays (90) ist, und die Sicherungspunkte pre und post der letzten CaptionKeepUpgrades (3) Upgrades, alles in upgrade.ini [UpgradeSettings]; es entfernt nur Sicherungspunkte von exp:upgrade, die eigenen von git_manager folgen dessen MaxBackups.

Das Passwort der Verbindung erreicht ein Dump-Werkzeug in einer Datei, die nur ihr Eigentümer lesen kann (MySQL, MongoDB), oder in seiner Umgebung (PostgreSQL), nie auf einer Befehlszeile, und jede Datei eines Sicherungspunkts kann nur ihr Eigentümer lesen. ./console exp:upgrade:backup macht weiterhin die Datenbanksicherung von exp:upgrade für sich allein, ohne Sicherungspunkt.

Die Prüfung nach dem Upgrade

./console exp:upgrade:verify --after
./console exp:upgrade:verify --after --url=https://www.example.com/,https://www.example.com:8080/ --no-tests

Am Ende von exp:upgrade --apply wird die Installation geprüft, in einem neuen Prozess, damit der neue Code geprüft wird (--no-verify überspringt das):

PrüfungBesteht, wenn
stepskein Schritt abweicht (als erledigt aufgezeichnet, Wirkung fehlt) und keiner gescheitert ist
urlsjede Rauchprobe-Adresse mit 200 bis 399 antwortet: upgrade.ini [UpgradeSettings] SmokeURL[], sonst velocity.ini [DeploySettings] WarmUpURL[] (die Adressen von Apache und Velocity), sonst die Startseite und die Anmeldeseite von SiteURL; --url hat Vorrang
testsdie PHPUnit-Testsuite upgrade-smoke besteht (schnell, ohne Datenbank); übersprungen, wo PHPUnit nicht installiert ist, oder mit --no-tests
errorlogkeine neue Zeile eines fatalen Fehlers in var/log/error.log und dem Fehlerprotokoll der Site seit dem Start des Laufs
autoloadjede registrierte Schritt-Klasse lädt, und die Autoload-Arrays sind lesbar

Eine Prüfung, die nicht laufen kann, sagt warum und lässt die Prüfung nicht scheitern.

Zurückrollen

./console exp:upgrade:rollback                                          # die Sicherungspunkte
./console exp:upgrade:rollback 2026-10-29_10-15-00                      # was ein Zurückrollen darauf wiederherstellt
./console exp:upgrade:rollback 2026-10-29_10-15-00 --apply
./console exp:upgrade:rollback 2026-10-29_10-15-00 --apply --parts=database,settings
./console exp:upgrade:finish --apply                                    # live machen

Ein Zurückrollen ist nie automatisch (außer mit --rollback-on-fail) und läuft nie ohne --apply. Mit --apply legt es zuerst einen Sicherungspunkt safety des aktuellen Stands an, damit sich das Zurückrollen selbst rückgängig machen lässt, indem man auf diesen zurückrollt (--no-caption überspringt ihn, auf Produktion ohne --force-no-caption verweigert). Dann stellt es die Teile wieder her, die der Sicherungspunkt enthält, in dieser Reihenfolge, und prüft danach erneut (--no-verify überspringt das):

TeilStellt wieder her
databaseSQLite: die Kopie über die Backup-API von SQLite zurückgeschrieben; MySQL und MariaDB: der Abzug über mysql; PostgreSQL: der Abzug über psql. Tabellen, die nach dem Sicherungspunkt entstanden, werden gelöscht. MongoDB und Oracle: von Hand (mongorestore --drop, impdp)
storagevar/ aus dem Archiv von git_manager über das der Installation entpackt (später hinzugekommene Dateien bleiben)
settingssettings/override über das der Installation zurückkopiert (später hinzugekommene Dateien bleiben)
librariescomposer.json und composer.lock zurückkopiert, dann composer install (verweigert bei Paketen, die eigene Git-Checkouts sind, wie in der Bibliotheken-Stufe)
codejeder Checkout aus code.json zurück auf seinen Commit (git reset --keep, verweigert bei lokalen Änderungen in den Dateien, die es zurückbewegen würde)

Ein verschlüsselter Sicherungspunkt (die GPG-Option von git_manager) muss zuerst mit git_manager entschlüsselt werden.

Engines

Die Datenbank-Schritte werden aus dem Kernel-Schema (share/db_schema.dba) geschrieben, denselben Definitionen, aus denen eine neue Installation angelegt wird, von der Schema-Klasse der jeweiligen Engine: MySQL und MariaDB, PostgreSQL, SQLite und Oracle über die Erweiterung ezoracle. MongoDB erhält die Collections; Spalten und Indizes gibt es dort nicht. Nach der Datenbank-Stufe entspricht das Schema dem einer neuen Installation (geprüft auf SQLite, MariaDB und PostgreSQL, mit einem gewollten Extra auf MySQL: dem Volltextindex des Audit-Index).

Zwei Schritte gelten nicht für jede Engine: die Breite von ezuser.password_hash (SQLite speichert keine Länge) und die Tabelle des Benutzer-Auditprotokolls (nicht auf MongoDB, wo die Audit-Dateien jedes Ereignis behalten).

Der eindeutige Index auf ezuser.login wird nur angelegt, wenn kein Login zu zwei Konten gehört. Solange es Duplikate gibt, ist der Schritt unknown, und der Lauf macht weiter; lösen Sie sie mit ./console exp:user-login-check auf und starten Sie erneut.

Prüfen und die Aufzeichnung

exp:upgrade zeichnet jeden ausgeführten Schritt auf: den Schritt, seine Stufe und Version, erledigt oder gescheitert, wann, wie lange, den Systembenutzer, der ihn ausgeführt hat, die Engine, die Prüfsumme des Schritt-Codes und die letzte Meldung. Die Aufzeichnung ist die der Migrationen, exp_migration (eine Zeile je Schritt, als Migration der Quelle kernel) und exp_migration_run; der erste Schritt der Stufe database, 6.0.15-migration-tables, legt beide Tabellen an. Schritte, die davor laufen (die Stufen code und libraries eines ersten Laufs), werden nicht aufgezeichnet; ihr Zustand kommt weiter aus der Installation selbst, und der Lauf meldet für sie not recorded.

Die ältere Tabelle expupgrade_step. Eine Vorabversion von 6.0.15 führte diese Aufzeichnung in einer eigenen Tabelle, expupgrade_step. Keine veröffentlichte Version hatte sie, und eine neue Installation bekommt sie nie. Auf einer Installation, die sie noch hat, löst der Schritt 6.0.15-upgrade-record-table (direkt nach 6.0.15-migration-tables) sie ab:

  1. er kopiert jede Zeile, die exp_migration noch nicht hat (eine Zeile, die exp_migration schon hat, ist neuer und bleibt);
  2. er prüft, dass jede Zeile von expupgrade_step jetzt in exp_migration steht, und bricht mit erhaltener Tabelle ab, wenn eine fehlt;
  3. er löscht die Tabelle (auf MongoDB die Collection; auf Oracle DROP TABLE ... PURGE).

Der Schritt ist nur offen, solange die Tabelle besteht. Der Probelauf listet jede Zeile, die er kopieren würde, die Prüfung und die Anweisung DROP TABLE auf und ändert nichts; ein zweiter Lauf findet nichts zu tun. exp:upgrade liest expupgrade_step nie: bis der Schritt gelaufen ist, zählen ihre noch nicht kopierten Zeilen einfach nicht als aufgezeichnet.

$ ./console exp:upgrade:database
  pending     6.0.15-upgrade-record-table          missing: the table expupgrade_step is still there (2 row(s) not in exp_migration yet)
              copy the row 6.0.15-trash-columns of expupgrade_step into exp_migration
              copy the row caption:20261031-120000-pre of expupgrade_step into exp_migration
              check that every row of expupgrade_step is in exp_migration
              drop table expupgrade_step: DROP TABLE expupgrade_step;

Die SQL-Update-Dateien update/database/<engine>/6.0/dbupdate-6.0.0-6.0.15.sql tun dasselbe in reinem SQL: Sie legen expupgrade_step leer an, wenn sie fehlt, kopieren ihre Zeilen, die exp_migration nicht hat, und löschen sie, sodass sie auf jeder Installation und mehrmals laufen können.

Die Sicherungspunkte von exp:upgrade und die der Migrationsläufe (Arten migration-pre, migration-post, migration-failure) sind eine Liste: exp:upgrade:captions zeigt beide, und jedes der beiden Zurückrollen kann jeden wiederherstellen (Zurücknehmen und Sicherungspunkte).

Die Schritte unter den Migrationen

Jeder Upgrade-Schritt ist auch eine Migration der Quelle kernel, mit der Schritt-ID als Migrations-ID. Die Migrationsbefehle und Setup > Migrationen zeigen und führen daher auch die Schritte des Kernels aus:

WoWas es mit den Schritten tut
./console exp:migration:status, Setup > Migrationen, der Dashboard-Blocklistet jeden Schritt zuerst, vor den Migrationen der Site und der Erweiterungen, mit dem Zustand, den exp:upgrade:status ihm gibt
./console exp:migration:migrate --apply, Ausführen in Setup > Migrationenführt zuerst die ausstehenden Schritte der Stufen database und scripts aus, dann die Migrationen, in einem Lauf unter einer Sperre und einem Sicherungspunkt
eine Migrationsdateidarf einen Schritt in requires nennen (requires: 6.0.15-migration-tables); sie läuft dann nach ihm

Ein Migrationslauf überlässt die Stufen code, libraries und finish dem Befehl exp:upgrade: ein ausstehender Schritt dieser Stufen (oder ein optionaler Schritt) wird als deferred (zurückgestellt) gelistet, eine Warnung nennt den Befehl, der ihn ausführt (./console exp:upgrade:code --apply ...), und eine Migration, die ihn verlangt, wartet. Nach einem Migrationslauf, der Schritte ausgeführt hat, macht ./console exp:upgrade:finish --apply sie wirksam (Deploy, Caches, Smoke-Test). Ein Schritt behält, was ihn zum Schritt macht: sein Zustand kommt aus detect(), es gibt keinen Prüfsummenschutz auf seine Klassendatei, keine Transaktion um ihn, und er hat kein down() (ein Sicherungspunkt stellt ihn wieder her).

Beide Befehle schreiben dieselbe Aufzeichnung: ein Schritt, den ein Migrationslauf ausgeführt hat, ist in exp:upgrade:status done, und umgekehrt. Jeder Befehl behält seine eigene Regel für Sicherungspunkte: exp:upgrade hält an, wenn kein Sicherungspunkt angelegt werden kann, und lehnt --no-caption auf Produktion ab, ein Migrationslauf warnt und macht weiter; exp:upgrade stellt nur mit --rollback-on-fail wieder her, ein Migrationslauf von sich aus.

Was Sie für eine eigene Änderung schreiben, einen Upgrade-Schritt oder eine Migration: Upgrade-Schritt oder Migration?. Alles über Migrationen, mit Rezepten und Hilfe für jede Zielgruppe: Migrationen. Nicht zu verwechseln mit dem Umzug einer Site: Migrationen oder Umzug einer Site.

./console exp:upgrade:verify sieht für jeden Schritt erneut nach und meldet Abweichungen: einen Schritt, den die Aufzeichnung als erledigt führt, dessen Wirkung aber jetzt fehlt (eine Tabelle gelöscht, eine Richtlinie von Hand entfernt). Findet er welche, endet er mit Exit-Code 1. Führen Sie ihn nach einer Wiederherstellung oder aus der Überwachung aus.

Jeder ausgeführte Schritt wird außerdem in var/log/upgrade.log geschrieben, und in das Auditprotokoll: system.upgrade.step für jeden ausgeführten oder gescheiterten Schritt, system.upgrade.backup für die Sicherung, system.upgrade.run am Ende eines Laufs mit --apply, system.upgrade.rollback für ein Zurückrollen, system.upgrade.caption für einen angelegten, geprüften oder aufgeräumten Sicherungspunkt, system.upgrade.verify für die Prüfung nach dem Upgrade (das Audit).

In einer Pipeline

./console exp:upgrade:status --fail-on-pending        # Exit-Code 1, wenn etwas offen ist
./console exp:upgrade --apply --format=json > upgrade.json

--format=json schreibt die Maschinenausgabe exp-upgrade/1: die Installation (Engine, Datenbankversion, Code-Version), die Sicherung, jede Stufe mit jedem Schritt (id, stage, version, state, detail, action, plan, messages, duration_ms, record, drift), eine Zusammenfassung und den Exit-Code.

Exit-CodeBedeutet
0nichts offen, oder alles ausgeführt
1ein Schritt ist gescheitert, die Prüfung nach dem Upgrade ist gescheitert, die Sperre oder der Sicherungspunkt wurde verweigert, eine Stufe kam außer der Reihe, oder mit --fail-on-pending sind Schritte offen; exp:upgrade:verify: Abweichungen oder eine gescheiterte Prüfung; exp:upgrade:captions --verify: eine geänderte Datei oder ein Abzug, der sich nicht einspielen lässt
2Bedienfehler (ein unbekannter Optionswert, eine unbekannte Stufe, ein unbekannter Schritt, ein unbekannter Sicherungspunkt oder ein unbekannter Teil; --apply mit --dry-run; --no-caption oder --no-backup auf Produktion ohne --force-no-caption)
3die Datenbank ist nicht erreichbar
4interner Fehler

Die Schritte von 6.0.15

SchrittStufeErsetzt
6.0.15-code-updatecodegit pull von Hand, über git_manager, nur Fast-Forward
6.0.15-libraries-updatelibrariescomposer update <Paket> von Hand (nur mit --update)
6.0.15-libraries-installlibrariescomposer install von Hand, mit composer audit
6.0.15-migration-tablesdatabase(neu) die Aufzeichnung der Migrationen und Upgrades, exp_migration und exp_migration_run
6.0.15-upgrade-record-tabledatabase(neu) nur auf einer Installation einer Vorabversion von 6.0.15: die Zeilen ihrer Tabelle expupgrade_step nach exp_migration kopiert, dann die Tabelle gelöscht
6.0.15-sqlite-composite-keysdatabase(neu) nur SQLite: eine Tabelle, die share/db_schema.dba über mehrere Spalten schlüsselt (ezcontentobject_attribute über id und version ...), die Datenbank aber nur über id (eine Installation aus einer älteren kernel/sql/sqlite/schema.sql), wird mit dem Schlüssel der .dba neu aufgebaut, Zeilen und Indizes bleiben erhalten
6.0.15-user-password-hash-widthdatabaseezuser.password_hash in der SQL-Update-Datei auf 255 verbreitert
6.0.15-trash-columnsdatabaseezcontentobject_trash.trashed, trashed_by, trashed_via und ihr Index
6.0.15-pdf-export-footerdatabaseezpdf_export.show_footer, footer_text
6.0.15-rss-opml-podcastdatabaseezrss_export.opml_head, podcast_head, Tabelle ezrss_export_opml_item
6.0.15-order-statusesdatabasedie Bestellstatus 4 bis 17
6.0.15-audit-index-tablesdatabaseupdate/common/scripts/6.0/createaudittables.php (Tabellen)
6.0.15-bookmark-foldersdatabaseLesezeichenordner: Spalten, Index, Tabelle expbookmark_folder
6.0.15-bookmark-view-tabledatabasecreatebookmarkviewtable.php
6.0.15-bookmark-view-columnsdatabaseexpbookmark_view.module_name, view_name, view_parameters und ihr Index (createbookmarkviewtable.php)
6.0.15-mail-preference-tablesdatabasedie fünf Tabellen expmail_*
6.0.15-api-key-tabledatabasecreateapikeytable.php
6.0.15-transfer-run-tabledatabasecreatetransferruntable.php
6.0.15-data-table-tablesdatabaseexp_data_connection, exp_secret, exp_data_sync*
6.0.15-user-session-tabledatabasecreateusersessiontable.php; auch expuser_session_info, die Geräte der Sitzungen
6.0.15-oauth-pkce-columnsdatabaseezprest_authcode.code_challenge, code_challenge_method
6.0.15-passkey-tabledatabasecreatepasskeytable.php
6.0.15-help-content-tablesdatabaseexphelp_help_id, exphelp_feedback
6.0.15-order-siteaccess-columndatabaseezorder.siteaccess
6.0.15-user-audit-tabledatabasecreateuseraudittable.php
6.0.15-user-login-unique-indexdatabase./console exp:user-login-check --fix-index
6.0.15-contentobject-modified-indexdatabaseder Index ezcontentobject_modified (Dashboard > Neue Inhalte)
6.0.15-static-publish-tablesdatabaseexp_static_run, exp_static_page (statisches Veröffentlichen)
6.0.15-url-mapdatabaseexp_url_redirect, exp_urlmap_batch, exp_urlmap_batch_item (Import von URL-Zuordnungen: der BC-Hinweis)
6.0.15-migration-deploy-tablesdatabaseexp_migration_deploy, exp_migration_deploy_host (Auslieferungen von Migrationen an Gegenstellen)
6.0.15-kernel-tablesdatabase(neu) jede weitere Tabelle des Kernel-Schemas (share/db_schema.dba), die der Datenbank fehlt, leer angelegt: einer über viele Versionen aktualisierten Datenbank kann eine alte fehlen (ezapprove_items, wo das Genehmigungs-Workflow-Ereignis nie lief), und die Stufe scripts braucht sie
6.0.15-active-extension-tablesdatabase(neu) die Tabellen jeder aktiven Erweiterung mit einer share/db_schema.dba (ezstarrating, ezgmaplocation, eztags ...), wo sie fehlen; keine Daten geladen
6.0.15-site-versiondatabaseezsite_data ezpublish-version auf 6.0.15 gesetzt
6.0.15-missing-user-settingsscriptscreatemissingusersettings.php
6.0.15-trash-records-to-columnsscriptsmovetrashrecords.php (die Datei bleibt erhalten)
6.0.15-anonymous-public-policiesscriptsbin/php/addanonymouspublicpolicies.php
6.0.15-editor-policiesscriptsbin/php/addeditorpolicies.php --apply
6.0.15-member-managementscriptsbin/php/addmembermanagement.php --apply
6.0.15-user-approvalscriptsbin/php/adduserapproval.php
6.0.15-help-read-policyscriptsbin/php/addexphelpreadpolicy.php
6.0.15-help-class-metadatascripts./console exp:help:content classes --apply (das Attribut Meta Data über xrowmetadata ab 1.4.24; Titelfelder mit mindestens 255 Zeichen)
6.0.15-oauth-authorize-policyscriptsbin/php/addoauthauthorizepolicy.php
6.0.15-order-siteaccess-backfillscriptsbin/php/expbackfillordersiteaccess.php --apply
6.0.15-bookmark-view-fillscriptsdie zerlegte Adresse älterer Lesezeichen von Systemseiten (createbookmarkviewtable.php)
6.0.15-finish-deployfinish./console exp:velocity deploy --kernel
6.0.15-finish-smokefinishein Abruf der Startseite

Die Setup-Befehle laufen mit ihren Standardoptionen. Brauchen Sie eine andere Option (etwa addeditorpolicies --keep-content-wildcard oder addanonymouspublicpolicies --skip=user/register, damit die Registrierung geschlossen bleibt), überspringen Sie den Schritt (--skip=6.0.15-editor-policies) und führen Sie den Befehl selbst aus; der Schritt meldet dann, was noch fehlt.

Keine Schritte, weil sie nicht die Datenbank oder die Einstellungen betreffen: die Crontab (bin/php/installcrontab.php), die Befehle für Hilfe als Inhalt (exp:help:content install, build-manuals, ebooks) und eine Prüfung der Umgebungsvariablen für den Demo-Modus. Das Changelog listet sie auf.

Erweiterungen

Eine Erweiterung fügt eigene Schritte mit ExtensionStepList[] in ihrer settings/upgrade.ini.append.php hinzu; sie laufen mit denen des Kernels, nach Stufe und Version. Upgrade-Schritte für Erweiterungen zeigt, wie.

Die Tabellen einer Erweiterung brauchen keinen eigenen Schritt: 6.0.15-active-extension-tables legt für jede Erweiterung, die aktiv ist (global oder in einem Siteaccess) und eine share/db_schema.dba mitbringt, die Tabellen dieser Datei an, die der Datenbank fehlen, auf jeder Engine, so wie eine neue Installation nach ihrem Site-Paket. Nichts wird gelöscht oder geändert, und keine share/db_data.dba wird geladen. Siehe Erweiterungen einer neuen Installation.

Das Versprechen

Die Befehlsnamen (exp:upgrade und exp:upgrade:*), ihre Optionen, die Exit-Codes, die Zustände der Schritte und die Ausgabe exp-upgrade/1 bleiben dauerhaft: Optionen und Schlüssel der Ausgabe können hinzukommen, nichts wird umbenannt oder entfernt. Ein Test im Kernel vergleicht sie mit einem Schnappschuss.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x