Howto: Upgrading from 8.4.2 to 9.0.2 when your extensions break the upgrade

[ssweber]

Hello,
I just went through fixing my install to the latest 9.0.2. In logs it said "Your EspoCRM version (8.4.2) is not supported. Required version: 9.0.1." I finally realized that since my extensions were not compatible with 9.0, the upgrade script never did it's work.

Steps:

• Restore your backup of v2.14.3
• Upgrade to 9.0, Upgrade-script will error out on your extension
• Go to Repair -> Enable Recovery Mode
• In Terminal, you'll need to first run the following commands:

mkdir -p /run/espocrm/cache/application
chmod -R 777 /run/espocrm/cache
chown -R www-data:www-data /run/espocrm/cache

• In Terminal, use button to upload new extensions to /app/data, and then upgrade with php command.php extension --file=/app/data/YOUR-EXTENSION.zip
• Then toggle out of Recovery Mode. Upgrade script will now complete
• Then update to 9.0.1, update again to 9.0.2.

Enjoy!