UNA 10 Upgrade Help
The post by Andrew was getting really long and difficult to follow so, I figured I would start a discussion topic instead to try and help those who are having issues with upgrading to UNA 10 Beta. This is JUST regarding the updating and not any other issues.
First and foremost - BACK YOUR SITE AND DATABASE UP BEFORE DOING THIS UPGRADE.
Next: Go into Studio and see what version is displaying in the Dashboard.
If you are showing 9.0.0 you MUST upgrade to 9.0.1 FIRST before doing this upgrade. If you see 9.0.0 as your version number then like me and other, your inc/classes/BxDolUpgrader.php already has /beta/ in the URL. Not sure how this happened since I downloaded UNA 9.0 from the homepage here.
To upgrade from 9.0.0 to 9.0.1 you will need to edit the inc/classes/BxDolUpgrader.php file and remove the /beta/ from the URL so it looks like this:
protected $_sUrlVersionCheck = 'https://v.una.io/';
Go back into your Dashboard and check to see if you now see a 9.0.1 is available. If you do not see it, clear your cache and refresh the page.
If you see it, click the button to upgrade to 9.0.1. You should receive an email once the update is successful. Note: The module upgrades WILL FAIL and that is OK right now.
Once you are now at 9.0.1, you will need to edit the inc/classes/BxDolUpgrader.php again and add /beta/ to the URL like this:
protected $_sUrlVersionCheck = 'https://v.una.io/beta/';
Go back into your Dashboard and check to see if you now see a 10.0.0-B1 is available. If you do not see it, clear your cache and refresh the page.
If you see the option, Click to upgrade to 10.0.0-B1. Your modules will again try to update and this time, it should be successful.
IMPORTANT: Your cron job must be setup properly in order for the upgrade to occur. If you do not have access to your cron job setup, you will need to consult with your hosting company. If you do have access to your cron job setup, you should be able to tell how often the cron job runs. This will help you know when the upgrade should be completed as well as receiving the email once it is done.
You can check to see when your cron job last ran by going into Studio > Dashboard > click the arrow next to Server Tools and click Server Audit. Scroll down until you see Last cron jobs execution
You can also force your cron job to run by doing the following (need FTP access):
- Go into your /periodic folder via FTP
- rename your .htaccess file to something like .htaccess.bak
- In your browser, go to this URL: http://www.mysite.com/periodic/cron.php or use https:// if you are running SSL. This page will be blank BUT you will see that it looks like it is "loading". This is expected. Once finishes spinning, you will know it finished. Go back into your Dashboard and see if the Upgrade was successful.
- Remember to remove the .bak after you have tested.
EDIT 6/27/2019: Adding this info since some member have ran into the issue where they could not do the Upgrade due to files being modified
If you have very minor modifications and you want update script to overwrite it then you can enable the following setting:
Studio > Settings > System > Site Settings > Force auto-update, even if some files were modified
it will make updates to work if less than 5% of files are modified.
If more than 5% of files are modified then it's better to merge changes manually to avoid problems with the update.
Another option if more than 5% of files are modified is to overwrite any changes you've made in source code, then you need to change the following line in inc/classes/BxDolInstallerUtils.php file:
Then try to upgrade UNA or modules as usual.