This worked for me to upgrade TurnKey Linux 11.3 / vTiger CRM from 5.2.1 to 5.3.0. Before doing the upgrade, it is highly recommended that a backup of the system be made using TKLBAM or the methods built into vtiger. Or make an image of the hard drive with CloneZilla or something similar so that it can be put back if something goes wrong.
1. Log into the local console or a remote terminal through ssh as root.
NOTE: Using ssh is easier since the commands can be copy & pasted.
2. Change to the web home directory:
3. Download the 521 to 530 patch file:
4. Unzip the patch file with overwrite:
unzip -o vtigercrm-521-530-patch.zip
5. Open the Apache sites file:
6. Fix the file:
Change "AllowOverride All" to "AllowOverride None"
Delete "order allow,deny"
Delete "allow from all"
Save it. (Ctrl-X, Y, Enter)
7. Make the install.php file read-write:
chmod 777 install.php
8. Reboot the server:
9. With a browser, go to the server web site:
<server ip address>
10. Left click "Migrate"
11. If all Pre Installation Checks are OK (green), left click "Next"
12. Fill in the System Configuration page:
Previous Installation Version *: 5.2.1
Admin Username *: admin
Admin Password: <server admin password>
Database Name for Migration: vtigercrm
13. On the Pre-Migration Tools page:
Left click the "Fix Now" link to change to the Innodb engine
Left click the "Next" button
14. On the Confirm Configuration Settings page, left click the "Next" button
15. On the Optional Modules page:
Uncheck all of the language packs (Assuming that English is used)
Left the click the "Next" button
16. Verify that all updates have a "success" result. Left click the "Next" button
17. Cleanup (back in the root terminal):
mv install.php install.php.org
mv install install.org
18. Left click the "Finish" button
19. Login as user "admin" with password "admin"
NOTE: All user passwords are changed to the user's name.
20. Change the admin password back to something secure:
Left click the "Settings" menu item
Left click the "Users" icon
Left click the "admin" user name
Left click the "Change Password" button
Hope this works for others. This method was created using hints and procedures detailed on the vtiger.com forums. As well as a lot of trial and error.