Frapp ERPNext upgrade from V14 to Version 15 - Ubnutu

( commands are in blue letters )

Note: You need NOT upgrade Ubuntu from 20+ to 22+ for upgrading ERPNext to Version 15. EPRNext and Frappe 15 works both on Ubuntu 20+ and 22+ )

1- Take backup. ( Should I explain that !!! )

( Taking sql backup directly - mysqldump -u username -p db_name > backup_db_dump.sql )

2- Make sure you don't have any customization those are not committed.

cd /opt/bench/frappe-bench/apps/erpnext

git status

Refresh index: 100% (6953/6953), done.

On branch version-14

Your branch is up to date with 'upstream/version-14'.

nothing to commit, working tree clean

/opt/bench/frappe-bench/apps/frappe

git status

On branch version-14

Your branch is up to date with 'upstream/version-14'.

nothing to commit, working tree clean

3-Check python version

python3 -V

Python 3.8.10 ( needs to be upgraded to 3.10 )

4-check node version.

node --version

v12.22.12 ( needs to be upgraded to v20 ( Minimum)

5-Check pip or pip3 version

pip3 --version

20.2 ( needs to be upgrade to 22.x )

6- Upgrade python ( IF required )

sudo apt install software-properties-common

sudo add-apt-repository ppa:deadsnakes/ppa

sudo apt install python3.10

sudo update-alternatives --remove python3 /usr/bin/python3.8

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1

Confirm python version upgrade by

python3.10 --version

Python 3.10.6

python3 -V

Python 3.10.6

7 - Upgrade PIP ( if required )

curl -sS https://bootstrap.pypa.io/get-pip.py | python3.10

pip3 install --upgrade pip

sudo apt-get remove python3-apt -y

sudo apt-get install python3-apt -y

pip install html5lib

python3.10 -m pip install --upgrade pip

check PIP verison and confirm.

pip --version

pip 22.2.2 from /home/erpnext/.local/lib/python3.10/site-packages/pip (python 3.10)

pip3 --version

pip 22.2.2 from /home/erpnext/.local/lib/python3.10/site-packages/pip (python 3.10)

8- Upgrade Node

--------------Node 21 installation ---------

sudo apt install -y ca-certificates curl gnupg

sudo mkdir -p /etc/apt/keyrings

curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg

echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_21.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list

sudo apt update

sudo apt install nodejs -y

Check node version and confirm

node --version

v21.1.0

9- Upgrade NPM ( If required )

npm upgrade

sudo npm install 16

sudo npm install -g npm@8.19.1

check npm version and confirm

npm --version

( Need minimum 10 )

--------------------

12- Change git upstream from V14 to V15

bench switch-to-branch version-15 frappe erpnext --upgrade ( And whatever apps you want to upgrade like hrms, payments etc )

source env/bin/activate

pip3 install pydantic

pip3 install --upgrade redis

bench update --requirements

bench --site yoursite.erpgulf.com migrate

bench update

sudo service supervisor restart

Check the version now

bench version

A full installation document published here https://cloud.erpgulf.com/blog/support-forum/installing-erpnext-version-15-on-ubuntu-23+

Also we published a six part series of Frappe installation with all conceptual details here https://youtu.be/RU9lXV1sTlI

-------------

Note 1: *

If you face problem with nginx because of log type error ( log type main not found or something like that )

vvim /etc/nginx/nginx.conf and add following on http section.

log_format main '$remote_addr - $remote_user [$time_local] "$request" ' '$status $body_bytes_sent "$http_referer" ' '"$http_user_agent" "$http_x_forwarded_for"';



-----------------------

Often you may need to recreate env file

1- delete env directory from the frappe-bench directory

2- run: bench setup env

3- run: bench setup requirements

4- go to common_site_config.json and remove “maintenance mode”:1

----------------

Map Python with new version

vim ~/.bashrc

alias python=python3.11

alias python3=python3.11

alias python3.8=python3.11

---

sudo update-alternatives --install /usr/bin/python python /usr/bin/python3.10 1

sudo update-alternatives --install /usr/bin/python3 python3 /usr/bin/python3.10 1

use it other folder and copy env to original frappe-bench sudo pip3 install frappe-bench  

Upgrade to python 3.10 help https://discuss.frappe.io/t/how-to-upgrade-to-python-3-10/92222/15