Erpnext patching & updates

is there a standardised procedure for keeping erpnext software patched and up to date - for instance on a linux system i would update all repositories and then upgrade everything - this can generally be accomplished with a couple of commands. I ask the question because I have an instance at v13.24.0 and another instance at v13.29.0 and i would like to keep everything up to date and consistant (and importantly understand how that is achieved and how ive managed to get distinct code levels without trying!)

The short answer is you run this command:

bench update

Now here’s the longer explanation. This command does a lot of small tasks. Tasks you “could” do yourself manually, in your console. There’s no magic here: Bench is just saving you some keystrokes. Here is the general idea of what happens when you run that command.

For each App you have installed (Frappe, ERPNext, others):

  1. A 'git pull' command is executed in your App’s root directory. Your local code and files are updated, based on whatever is currently in GitHub/GitLab for your git ‘branch’.
  2. Python packages are installed/updated based on the new contents of the App’s 'requirements.txt' file. Updates are (mostly) made from PyPi.org repositories.
  3. Node.js packages are installed/updated, based on the new contents of the App’s 'package.json' files. (using the yarn package manager)
  4. JS and CSS assets are “rolled up” (minified, concatenated, bundled) to create new asset files.
  5. Based on DocType schema definitions inside .json text files, your MariaDB SQL database’s schema is updated (tables, columns, indexes)
  6. If it exists, “patch code” is run. By “patch code”, I mean scripts that update your SQL database’s existing records, based on the new schema and requirements from step 5.

If everything goes well, then that’s it. You’re on the newest minor and patch version.

To upgrade a major version (e.g. v13 → v14), we used to type this command:

bench update --upgrade

Does this command still work today? I have no idea. The official documentation never explains how to upgrade. :man_facepalming:

I tried to answer this for myself, by running bench update --help. However, the '--upgrade' flag is gone. There’s a --force flag, but I’m reluctant to say that’s the answer (in most CLI I’ve seen, --force is a suffix usually reserved for doing something potentially breaking.)

So who knows.

Hopefully this information helps, @alpresidente. I stopped using ‘bench update’ years ago, so I’m not an expert. Hopefully someone else can chime in about the major version upgrades.

4 Likes

Major version upgrades are done through github branches, so the command would be bench switch-to-branch version-1*. Without doing that, your site will always stay on the same major version but accept minor version updates.

with a few repeats of “bench update” and some reboots ive been able to get the code levels the same on 2 instances. I do get the following errors although “bench setup requirements” seems to run without fault - both instances now at:
ERPNext: v13.31.1 (version-13)
Frappe Framework: v13.30.0 (version-13)
…which i think is current

UNRESOLVED_IMPORT : ‘vue/dist/vue.js’ is imported by …/erpnext/erpnext/public/js/hub/vue-plugins.js, but could not be resolved – treating it as an external dependency
Cannot find some dependencies. You may have to run “bench setup requirements” to install them.

UNRESOLVED_IMPORT : ‘vue/dist/vue.js’ is imported by …/erpnext/erpnext/public/js/hub/marketplace.js, but could not be resolved – treating it as an external dependency
Cannot find some dependencies. You may have to run “bench setup requirements” to install them.

MISSING_GLOBAL_NAME : No name was provided for external module ‘vue/dist/vue.js’ in output.globals – guessing ‘Vue’
:heavy_check_mark: Built js/marketplace.min.js
Browserslist: caniuse-lite is outdated. Please run:
npx browserslist@latest --update-db
:heavy_check_mark: Built css/erpnext-web.css
:heavy_check_mark: Built css/marketplace.css
:heavy_check_mark: Built css-rtl/marketplace.css
:heavy_check_mark: Built css-rtl/erpnext-web.css
:heavy_check_mark: Built css/erpnext.css
:heavy_check_mark: Built css-rtl/erpnext.css