FreePBX v17 Migration Steps

[gregarican (Greg Kujawa)]

I have referred back to helpful posts about the process involved. In my case, I have a production v16 AWS EC2 instance, where the upgrade path involves launching a new v17 AWS EC2 instance and restoring the v16 backup files there. This AWS FreePBX implementation is provided by The Web Machine, so it includes bundled software update functionality (i.e. - SmartUpgrade). Another one-off is that we are using FOP2 in production.

To try and consolidate things and plan for the migration, below are the steps I have mapped out. If any of y’all experts on here and take a peek and let me know if it looks like a solid plan. I’m not sure if the FOP2 service has to be stopped in order to copy the config files. I suppose if it does then I will need to add those steps to my game plan.

1. Launch a web browser to v16. Username is admin and password is the Instance ID.
2. Create a new full backup job of v16 in Backup/Restore (feel free to uncheck the CDR and CEL modules to leave those potentially large DBs behind if you don’t need them).
3. From a WinSCP session to v16, copy the /usr/local/fop2 folder to a local backup folder.
4. From a SSH session to v16, issue the ‘/usr/local/fop2/fop2_server --revoke’ command. The license code is {licenseCode}.
5. Gracefully shut down the v16 instance.
6. Dissociate the {staticIP} Elastic IP from the v16 instance.
7. From the AWS console, launch a new v17 instance — Instance Type: m5a.xlarge, SG: {sg-XXXXX}, VPC ID: {vpc-XXXXX}, Subnet ID: {subnet-XXXXX} settings.
8. From a SSH session to v17, run ‘SmartUpgrade --auto’ to ensure it is fully up-to-date, and reboot it.
9. From a SSH session to v17, issue the ‘wget -O - http://download.fop2.com/install_fop2.sh | bash’ command.
10. Associate the {staticIP} Elastic IP to the v17 instance.
11. Launch a web browser to v17. Username is admin and password is the Instance ID. Restore your backup file to the v17 instance.
12. From a WinSCP session to v17, copy the local backup folder to /usr/local/fop2.
13. From a SSH session to v17, issue the ‘/usr/local/fop2/fop2_server --register’ command. The license code is {licenseCode}.