Ensuring your ERPNext system stays current is crucial for tapping into the latest features, improvements, and security enhancements. In this guide, we’ll steer you through the upgrade process from ERPNext version 14 to the more advanced version 15. The good news is that there’s no need to update your Ubuntu OS from version 22.04 to 23. However, it’s imperative to have Node.js version 18 or higher installed—a key step in this upgrade journey. Follow these straightforward instructions to maintain the agility and optimization of your ERP system, guaranteeing it operates at its peak efficiency.
Prerequisites: Prepare for a Smooth Upgrade
- Backup Your Database: Before embarking on the upgrade journey, safeguard your data by creating a recent backup of your ERPNext database. This precautionary step ensures you can restore your system in the event of any unforeseen issues during the upgrade process.
- Check Custom Apps: If your ERPNext instance includes custom apps or scripts, it’s essential to verify their compatibility with ERPNext version 15. Take a moment to review the release notes and documentation for any specific instructions or considerations regarding customizations.
Navigate to Bench Directory
This is very important. Ensure you have node 18 and later. In this guide, we will switch from node version 16 to version 18.
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
wget -qO- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
nvm install 18
nvm alias default 18
Switch to Version 15
bench switch-to-branch version-15 frappe erpnext --upgrade
Run a migrate
bench migrate command is crucial for managing database migrations in the frappe framework. Database migrations are changes to the structure of the database schema, and these changes may include creating new tables, modifying existing tables, or adding new fields to existing tables. The
bench migrate command facilitates the application of these changes to ensure that your database schema stays synchronized with the codebase.
bench --site [YOUR SITE] migrate
Restart the supervisor
Supervisor is commonly used to manage the Gunicorn processes, which are responsible for serving the web application. When you make changes to your Frappe or ERPNext setup, such as updating the codebase or applying migrations, restarting the relevant processes is often necessary to apply these changes.
sudo supervisorctl restart all
Verify the upgrade
This command should return version 15.X. Sometimes the update may be scheduled and therefore take a couple of minuted to complete. Ensure a seamless transition by checking your ERPNext site for proper functionality. Be vigilant for any errors during the upgrade process.
Sometimes you may get the below popup after the upgrade:
Failed to get method for command erpnext.e_commerce.doctype.e_commerce_settings.e_commerce_settings.is_cart_enabled with No module named ‘erpnext.e_commerce.doctype.e_commerce_settings.e_commerce_settings’
This can be resolved by running the below command: