Ok, I finally got a path to updating from v10 to v11.
Thank you to @kolate_sambhaji for the clues. While I may have preferred a direct update method, his method is the ONLY thing that has worked so far.
Here is his brief set of instructions again:
To be fair to those that are new to ERPNext, the short list of steps above are not a real representation of the actual work that will be required.
There really is more to consider, such as:
- maybe you need to get this done on your current server in order to keep the same ip address
- maybe you have multiple tenants on a multi-tenant server that all need to be updated to v11
- maybe you fear losing everything on the live server
To get past these issues, the best bet is to create a new server to do all of this updating work. If it works the way you expect, then you can always move your DNS pointers to the new site when you are satisfied that it works correctly as a v11 site.
If your current live serve is only supporting one site, then after this update process, you could even take the opportunity to completely strip the original server down and reinstall a fresh operating system. Then you would install the default v11 with the easy install method and just restore your updated database and files form the temporary update site. This would give you a fresh v11 server back on the old ip address with all of your data.
If you run a multi-tenant servrer as your current live server, then by performing the update process for each tenant one at a time, you have the ability to move your sites as you have time without having to rush them all at once. Just move the DNS pointers for each site to the new server location as each one is completed.
Regardless of how you approach the update, as long as you create a separate server to do the work, you will not have to worry about accidentally destroying your working live sites.
So, in an effort to document this process as best as I can, I will detail the steps you need to do for each site here:
1.) Create a fresh and updated server (I used Ubuntu 18.04 LTS)
2.) Use the instructions for the “Easy Install” to install default latest v11
3.) Login to the new v11 as Administrator and complete the setup wizard to create a dummy site.
4.) After setup wizard is done, logout and close the browser.
5.) Open a ssh session to the server using your default user account
6.) run the following commands:
cd frappe-bench/sites
nano currentsite.txt (delete the site1.local entry and save the file as empty)
cd .. (this takes you back to frappe-bench)
bench config dns_multitenant on
bench new-site [your.site.name] (enter the actual URL for site you want to update)
bench setup nginx
sudo service nginx restart
bench --site [your.site.name] install-app erpnext
7.) At this point you need to open a new browser and login to the new site as Administrator and complete the setup wizard again.
8.) Once you have completed the setup wizard for the site that will become your updated installation, logout and close the browser again.
9.) Copy the latest backup of your live site to your new server (it will be restored to the update site later)
10.) Use scp to move all of the files in the /public/files and /private/files directories from your live site to the same locations on the new server in the update site.
11.) Use the following command to restore the live backup to your update site:
sudo bench --force --site [your.site.name] restore /path/to/your/backup.sql
12.) In the ssh session for your update site, run the following commands:
bench --site [your.site.name] migrate
cd sites/[your.site.name]
nano site_config.json (use the "encryption_key" line from live server to replace this one)
cd ~/frappe-bench
bench setup nginx
sudo service nginx restart
13.) At this point you should open a fresh browser and log into the update site to test your migration to v11.
The above set of instructions is not detailed like my tutorials, but it is pretty complete and based on my experience doing this on an Ubuntu 18.04 LTS server.
Hopefully this has been helpful to someone else that is dreading the upgrade process.
Is it perfect? Probably not, but it is repeatable.
As always… Your mileage may vary!
BKM