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

exp:expmigrationheal

Self-healing before a migration run: a stale run lock, missing migration folders, file modes, caches (what a deploy may fix on a remote).

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/commands/expmigrationheal.md

On this page

exp:expmigrationheal

Self-healing before a migration run: a stale run lock, missing migration folders, file modes, caches (what a deploy may fix on a remote).

Script bin/php/expmigrationheal.php, code in kernel/private/classes/commands/expmigrationheal.php. Run it from the installation root, as the user the web server runs as:

./console exp:expmigrationheal --help
./console exp:migration:heal --help
php bin/php/expmigrationheal.php --help

Help text

Self-healing before a migration run
The fixes a deploy may make on a remote before it runs the migrations there ([RemoteSettings] SelfHeal[]
of the source), each only when named: stale-lock (a run lock whose process is gone and that is older than
--stale-lock-age, held on this host by this user), paths (the missing migration folders), modes (the
permissions of [FileSettings] on the migration folders and var/<site>/migration, only added), caches (ini
and template-override). What cannot be fixed safely is only reported. Without --apply it lists what it
would do.

./console exp:migration:heal --fix=stale-lock,paths,modes
./console exp:migration:heal --fix=stale-lock --stale-lock-age=3600 --apply --format=json

Options

OptionValueHelp
--fixrequiredThe fixes: stale-lock, paths, modes, caches (a comma list or repeated)
--stale-lock-agerequiredSeconds from which a held run lock whose process is gone counts as stale (default 7200)
--applyMake the changes (the default is a dry run that lists them and changes nothing)
--dry-runThe default, accepted for scripts that pass it: list what would change, change nothing
--formatrequiredtext (default) or json (the machine output exp-migration/1)

Read from the option definitions in the code (startup(), getOptions(), options() or ezcConsoleOption). Every script also takes the standard options of the script framework (--help, --siteaccess, --debug, --quiet, --allow-root-user ...).


Generated by ./console exp:help:examples from bin/php/expmigrationheal.php, kernel/private/classes/commands/expmigrationheal.php. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.

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