Internal migrations with Acquia Ready

When your website needs to be migrated to a new infrastructure in Acquia Cloud, our Acquia Ready team can take the burden off of your team and move your code, database, and files for you as part of Acquia Ready Migration services offering.


For information about how Acquia Ready can help you migrate a website into Acquia Cloud from another hosting provider, see External migrations with Acquia Ready .

Migration considerations

  • Your sitegroup name(s) will change during this process.
  • The IP address of your load balancer will change, and a Domain Name Server (DNS) change will be required.
  • Any Elastic IPs assigned to your website will change.
  • Any domains attached to your old sitegroup must be added to the Domains page for your new infrastructure.
  • Any SSL certificates attached to your old sitegroup must be re-uploaded on your new infrastructure.
  • Your old and new applications will coexist for a time during the migration process.
  • Upon successful migration, Acquia will deprovision your old sitegroup and subscription.

General Procedure

Acquia Ready will need to provision your new sitegroup on your new infrastructure. Previously used sitegroup names cannot be reused. Your chosen sitegroup name must be 20 characters or less, all lower case, and can contain only alphanumeric characters.

The migration process is typically divided into two parts: the Initial migration and the Final migration. Depending on your needs, an intermediate migration step may also be included. The duration of the migration process will depend on how much time you will need to test your website on Acquia Cloud. The initial migration focuses on copying your code, database, and files to your new subscription, whereas the final migration is a sync of your website’s database and files, including any changes that occurred since the initial migration.

Prerequisites for migration

The prerequisite for the initial migration is a code freeze. If a code freeze cannot be put in place before the initial migration, an intermediate migration will be required before the final sync. The website should remain in code freeze until after the final migration and the domain name system (DNS) switch to Acquia Cloud are completed.

The prerequisite for the final migration is a content freeze. The time required for the Customer Onboarding Engineer to perform your initial migration will provide a guideline for estimating the duration of your final migration.

Migration Call

To coordinate the engagement, Acquia Ready will schedule an introductory migration call to discuss the process, access requirements for the engineer handling your migration, and the timelines that you should expect.

Initial Migration

In preparation for the initial migration, you will need to coordinate the timeframe of a code freeze with your development team, as any code changes committed to your current production website after the initial migration will be disregarded. Acquia will perform an initial migration of your website’s code, files, and databases to Acquia Cloud. After the initial migration is completed, any new development work should be performed only on Acquia Cloud.

Quality Assurance

After the initial migration is completed, you must perform quality assurance (QA) and regression testing on Acquia Cloud using an alternate domain. You may choose to set up a DNS record for this alternate domain for testing purposes. You can also simulate a DNS change locally by modifying the hosts file on your local machine.

During QA testing, you must review all critical website functionality, including public functions, themes, and related media assets to verify that everything is working correctly:

  • Verify administrative functions - Creating content, creating users, administering permissions, and other administrative functions
  • Verify business critical functions - Form submissions and third party integrations
  • Validate themes - Images, CSS, and cross-browser compatibility
  • Validate risk areas (possible regressions due to changes made through the migration process) - Upgraded contributed modules and new modules

Acquia Ready cannot proceed with final migration until you sign off on testing.

During your QA testing, you should also add any needed custom domains or SSL certificates to your new Acquia Cloud subscription.

Intermediate Migration

If you cannot implement a website code freeze before the initial migration, your Customer Onboarding Engineer may perform an extra intermediate migration later in the migration process, after you have put a code freeze in place.

Content Freeze

Your Customer Onboarding Engineer will inform you regarding how long the initial migration took and, based on that information, will provide an estimate of time required for the final migration. You should put a content freeze into effect shortly before the final migration, and keep the content freeze in place throughout both the final migration process and final testing, until the DNS switch is complete. You will coordinate the transfer of any domain names with Acquia.

Final Migration

Your Customer Onboarding Engineer will conduct the final data migration. This final migration contains the final sync of your files and database, to ensure all content changes made on your current production website after the initial migration are brought over to your new sitegroup on Acquia Cloud.

Final Testing and DNS switch

After the final migration, you must perform final QA testing to verify that the newly-migrated website is working correctly. If your tests are successful, you will need to repoint your domain names to your load balancers or elastic load balancers. Your Acquia Ready team can provide DNS records if necessary. After the DNS switch is completed, your code freeze and content freeze are over and your website is live on your new subscription!

Migration Schedule

If interested, ask your Customer Onboarding Manager for an editable version of the below plan that can help you track the milestones and progress.

Activity Notes Owner
Provisioning new sitegroup You will be notified when your Acquia Cloud subscription is ready for use. Acquia Ready
Migration call Your Customer Onboarding Manager will schedule the call and provide dial-in details. Both your project manager and technical lead should attend. Acquia Ready/ Customer
Code freeze You need to notify Acquia when your code freeze is in place so that Acquia can conduct the initial migration. Any code changes committed after the initial migration will be disregarded. Customer
Initial Migration Acquia will perform an initial migration of code, files, and databases. This initial migration will help with estimates regarding the time needed for the content freeze and final migration. Upon completion, Acquia will notify you to begin QA testing. Acquia Ready
Install Acquia Connector Acquia will install Acquia Connector as part of the initial migration. Acquia Ready
Install Acquia Search (if applicable) If applicable, Acquia will install Acquia Search as part of the initial migration. Acquia Ready
Provide benchmark for final migration Based on the time of the initial migration, Acquia will be able to forecast how much time should be anticipated for content freeze/final migration. Acquia Ready
SSL upload (if applicable) If you will be using an SSL certificate for your website, you should install it on Acquia Cloud on your subscription’s SSL page. Acquia Ready team may provide instructions and additional assistance with this step, if required. Customer
QA Testing You must test the website on the new infrastructure to verify that nothing was missed during the migration, and nothing is broken on the website after the migration. Load testing is recommended during this time. Customer
Intermediate Migration Optional step Acquia Ready
Website Review During your team’s testing, Acquia will perform a basic review of your existing Drupal website configuration, module selection, and code for potential availability risks. Acquia Ready
Content freeze A content freeze should be put in place shortly before the final migration, and continue throughout the entire final migration process and final testing period, until the DNS switch is complete. Customer
Final Migration Acquia will perform a final sync of your website’s database and files. Upon completion, Acquia will notify you to test your production website before cutting over DNS records. Acquia Ready
Final testing After final migration is complete, you will conduct final testing (30-60 minutes) to ensure that your website is fully migrated and that no content is missing. Customer
DNS switch After final testing is completed, you can switch DNS to point to your newly-migrated website. Customer

Contact supportStill need assistance? Contact Acquia Support

Acquia: Think Ahead

53 State Street, 10th Floor
Boston, MA 02109
United States
Phone: 888-922-7842

Map: Google Maps
View other locations