How To Migrate EasyApache 4 Profiles Between cPanel Servers

EasyApache is a convenient utility on cPanel servers which allows you to manage much of the important software that powers your web server. It manages your installations of Apache, PHP, and many PHP extensions and modules.
A common issue encountered while migrating websites between servers is differences in the environment on the destination server. For example, you may be migrating a website that uses the mbstring PHP extension, but that extension is not installed on the new server. So, after you migrate the website, it breaks due to the missing extension and you’re left finishing off a stressful server migration by digging around and troubleshooting all of these residual issues.
Of course, there is no way to completely eliminate this problem, but if you are running EasyApache 4, it is a simple matter to migrate your profile from one server to another. This will ensure that your target server has the same Apache and PHP packages available.

What If My Old Server Is Still Running EasyApache 3?

Although not covered under the scope of this guide, there is a migration process from EasyApache 3 to EasyApache 4, and it is very well documented.
If you are running EasyApache 3 and plan to migrate to a server with EasyApache 4 installed, your best bet is to upgrade the old server first so that you can iron out any issues with the EasyApache 4 upgrade separate from the migration.

cPanel Server Migration Tutorial

1. On the old server, convert your existing settings to a Profile.

    1. Login to your WHM panel and navigate to Software > EasyApache 4.
    2. You will see at the top a section labeled “Currently Installed Packages”. In this section, click “Convert to profile” to create a profile from your existing settings.How to migrate EasyApache 4 profiles between cPanel servers.
    3. Enter a name and filename for your profile that will be meaningful to you, and then click the “Convert” button.How to migrate EasyApache 4 profiles between cPanel servers.
    4. Now your profile will be created!How to migrate EasyApache 4 profiles between cPanel servers.

2. Download your profile from the old server.

1. Scroll down within the EasyApache 4 interface, and your new profile is most likely at the bottom. You can identify it based upon what you named it when you created it.
2. Click the “Download” button to download a copy of the profile on to your computer.How to migrate EasyApache 4 profiles between cPanel servers.

3. Upload your profile to the new server.

1. On the new server, login to your WHM panel and navigate to Software > EasyApache 4.
2. Toward the top, you will find a button that says “Upload a profile”. Click that button to begin the upload process.How to migrate EasyApache 4 profiles between cPanel servers.
3. Browse for the json file on your computer which you downloaded from the old server. This will be the filename you entered while creating that profile in step 2c above.
4. Click the Upload button to upload this profile to your new server.How to migrate EasyApache 4 profiles between cPanel servers.

4. Provision the profile on the new server.

1. Now that you’ve uploaded the profile, scroll down in EasyApache, and you should find your new profile toward the bottom. You can identify it based upon the name that you entered in step 2c above.
2. Click the “Provision” button to apply this profile to your new server.How to migrate EasyApache 4 profiles between cPanel servers.
3. EasyApache 4 will go through the provisioning steps and install all of the software and modules which were copied over from the old server.

You’re done!

Now your new server should have the same PHP versions and modules available, which should greatly reduce your likelihood of encountering any migration headaches!
Sound like a bit too much? Explore GigeNET’s managed services.

Don’t forget to share this blog post.

About the author

Recent articles