Cloud Platform
Upgrading to Cloud Platform
This page applies only to Cloud Classic. To access the content of this page, select Cloud Classic from the version list in the left sidebar.
Before planning to upgrade from Cloud Classic to Cloud Platform, ensure that you see the information in the following sections:
The upgrade process starts with your non-production environments and consists of the following steps. Acquia owns most of the upgrade process for your application. However, there are a couple of steps that might require your team's action.
| Step # | Description | Customer action |
|---|---|---|
| 1 | Acquia notifies the customer team through a Support ticket that the application is ready to be upgraded to Cloud Platform. | Based on Acquia's update, make the changes to make your platform compatible to be upgraded to Cloud Platform. For more information, see Additional changes for Cloud Platform readiness. |
Acquia strongly recommends that you immediately test your non-production environments as soon as they are upgraded to Cloud Platform. This not only ensures that any technical issues can be investigated and resolved quickly with the help of the Acquia Support team, but it also reduces the risk of delays or undesired behavior with your production environment upgrade.
After you upgrade to Cloud Platform, Acquia recommends that you test your production environment as soon as possible. This ensures that all aspects of your application and Cloud Platform function as expected. Additionally, enabling New Relic Application Performance Monitoring (APM) can help with monitoring the application's performance post-upgrade.
When testing your environments through automated tests or manual inspection, review the application behavior that depends on the following:
Custom logic in htaccess files
Image software such as ffmpeg, ImageMagick, or webp
System libraries
Shell scripts or tools such as curl or wget
Scheduled tasks or cron jobs
Cloud hooks
Custom scripts or commands that run on the SSH pod
In addition, you must monitor application performance in New Relic after the upgrade and compare that with prior performance.
When testing your environments, the following practices are recommended:
Verify that cron jobs are both running as expected and logging as expected, keeping in mind that Cloud Platform has a new directory for cron logs and custom logs that must be routinely pruned to prevent unnecessary growth of your file system:
Cloud Platform/shared/logsIf you discover any technical issues after your environments are upgraded to Cloud Platform, create a Support ticket and ensure you select an appropriate level of urgency. In the ticket description, include steps to reproduce the problem and a clear summary of how the environment behaved prior to upgrade.
The upgrade process starts with your non-production environments and consists of the following steps. Acquia owns most of the upgrade process for your application. However, there are a couple of steps that might require your team's action.
| Step # | Description | Customer action |
|---|---|---|
| 1 | Acquia notifies the customer team through a Support ticket that the application is ready to be upgraded to Cloud Platform. | Based on Acquia's update, make the changes to make your platform compatible to be upgraded to Cloud Platform. For more information, see Additional changes for Cloud Platform readiness. |
| 2 | Acquia updates the existing Support ticket to share the upgrade scheduling details for the non-production environment. Typically, this happens 2 weeks prior to customer's non-production environment upgrade. | NA |
| 3 | Acquia upgrades the non-production environment on the scheduled date and time. Acquia triggers automated processes that deploy your code, databases, files, and environment settings to the Cloud Platform infrastructure. This ensures that your infrastructure can be tested by Acquia's automated tooling. During this process, your file system and databases are placed in the read-only mode to prevent the possibility of data loss. However, your site might appear to be online to unauthenticated traffic if cached content is available through Varnish or your CDN. After Acquia's automated tests are complete, Acquia cuts over traffic to the Cloud Platform version of your environment and restores full access to your files and databases if the upgrade is successful. Otherwise, Acquia restores access to your files and databases on your Cloud Classic infrastructure and reschedules the upgrade for a later date and time. | NA |
| 4 | Acquia updates the Support ticket to confirm that the upgrade was successful. | NA |
| 5 | Customers must test the non-production environment. | Test the non-production environment to ensure everything works as expected. For information on what to test after the upgrade, see Testing your environments upgrading to Cloud Platform. |
| 6 | Acquia creates a new Support ticket to share the upgrade scheduling details for the production environment. Typically, this happens 2 weeks prior to the production environment upgrade. | NA |
| 7 | Acquia upgrades the production environment on the scheduled date and time. Acquia follows a similar process to that of non-production. However, environments with larger file systems and databases might require the use of advanced upgrade tooling. In such cases, there is a pre-sync process prior to the start of the testing and cutover process. Similar to the upgrade on your non-production environment, no visible impact to you or your end users is expected until the final process begins. | NA |
| 8 | Acquia updates the existing Support ticket to confirm that the upgrade was successful. | If you face any technical issues after upgrading to Cloud Platform, file a Support ticket. For more information, see Technical issues after upgrading to Cloud Platform. |
Acquia strongly recommends that you immediately test your non-production environments as soon as they are upgraded to Cloud Platform. This not only ensures that any technical issues can be investigated and resolved quickly with the help of the Acquia Support team, but it also reduces the risk of delays or undesired behavior with your production environment upgrade.
After you upgrade to Cloud Platform, Acquia recommends that you test your production environment as soon as possible. This ensures that all aspects of your application and Cloud Platform function as expected. Additionally, enabling New Relic Application Performance Monitoring (APM) can help with monitoring the application's performance post-upgrade.
When testing your environments through automated tests or manual inspection, review the application behavior that depends on the following:
Custom logic in htaccess files
Image software such as ffmpeg, ImageMagick, or webp
System libraries
Shell scripts or tools such as curl or wget
Scheduled tasks or cron jobs
Cloud hooks
Custom scripts or commands that run on the SSH pod
In addition, you must monitor application performance in New Relic after the upgrade and compare that with prior performance.
When testing your environments, the following practices are recommended:
Verify that cron jobs are both running as expected and logging as expected, keeping in mind that Cloud Platform has a new directory for cron logs and custom logs that must be routinely pruned to prevent unnecessary growth of your file system:
/shared/logsIf you discover any technical issues after your environments are upgraded to Cloud Platform, create a Support ticket and ensure you select an appropriate level of urgency. In the ticket description, include steps to reproduce the problem and a clear summary of how the environment behaved prior to upgrade.
| 2 |
| Acquia updates the existing Support ticket to share the upgrade scheduling details for the non-production environment. Typically, this happens 2 weeks prior to customer's non-production environment upgrade. |
| NA |
| 3 | Acquia upgrades the non-production environment on the scheduled date and time. Acquia triggers automated processes that deploy your code, databases, files, and environment settings to the Cloud Platform infrastructure. This ensures that your infrastructure can be tested by Acquia's automated tooling. During this process, your file system and databases are placed in the read-only mode to prevent the possibility of data loss. However, your site might appear to be online to unauthenticated traffic if cached content is available through Varnish or your CDN. After Acquia's automated tests are complete, Acquia cuts over traffic to the Cloud Platform version of your environment and restores full access to your files and databases if the upgrade is successful. Otherwise, Acquia restores access to your files and databases on your Cloud Classic infrastructure and reschedules the upgrade for a later date and time. | NA |
| 4 | Acquia updates the Support ticket to confirm that the upgrade was successful. | NA |
| 5 | Customers must test the non-production environment. | Test the non-production environment to ensure everything works as expected. For information on what to test after the upgrade, see Testing your environments upgrading to Cloud Platform. |
| 6 | Acquia creates a new Support ticket to share the upgrade scheduling details for the production environment. Typically, this happens 2 weeks prior to the production environment upgrade. | NA |
| 7 | Acquia upgrades the production environment on the scheduled date and time. Acquia follows a similar process to that of non-production. However, environments with larger file systems and databases might require the use of advanced upgrade tooling. In such cases, there is a pre-sync process prior to the start of the testing and cutover process. Similar to the upgrade on your non-production environment, no visible impact to you or your end users is expected until the final process begins. | NA |
| 8 | Acquia updates the existing Support ticket to confirm that the upgrade was successful. | If you face any technical issues after upgrading to Cloud Platform, file a Support ticket. For more information, see Technical issues after upgrading to Cloud Platform. |
If this content did not answer your questions, try searching or contacting our support team for further assistance.
If this content did not answer your questions, try searching or contacting our support team for further assistance.