Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: Generalizing this document

Things to ask before you begin

alice freda (Unlicensed), can you help write this?See /wiki/spaces/KALA/pages/627933245 article for things to look out for when migrating websites to Pantheon.

Create the pantheon site (and set proper upstream)

The first step is to create a new site on Pantheon, or to have the client create it if they have an account and want to be the owner from the beginning.

If the client wants to use the standard drop-8 upstream for easy upgrading, you will need to collapse the acuqia Acquia file structure down so there is not a nested docroot.

...

Do whatever it takes to get the old code in the new repository. (and maybe add more details here)

Set up the pantheon.yml file

We need to add a pantheon.yml file to configure the environment to match what it was at acquia. 

...

Available drush versions are at: https://pantheon.io/docs/drush-versions/#configure-drush-version

Sync the files directory

You can use these instructions for Manually transferring drupal files with rsync.

...

NOTE: The pantheon storage doesn't actually seem to preserve times when rsyncing, so if you are rsyncing against a previously uploaded files directory, you should use use --size-only flag to ignore the dates and see what changes based on file size.

Set up config directory

Since we are using a nested web root, the config directory can be in the root code directory, and not in the pantheon default of sites/default/config. Add the following to settings.php.

Code Block
titlesettings.php
/**
 * Use config sync directory in the code root.
 */
if (isset($_ENV['PANTHEON_ENVIRONMENT'])) {
  $config_directories = array(
    CONFIG_SYNC_DIRECTORY => $_SERVER['HOME'] .'/code/config/default',
  );
}

APC, redis, and solr

The pantheon_advanced_page_cache module should be installed. There is no configuration, it just starts working when enabled.

Follow the instructions to set up redis at: https://pantheon.io/docs/redis/

Remove Acquia modules

The acquia connector and acquia search modules should be uninstalled after db import. When you are sure that there will be no re-import of the db, you can also remove the two modules from the git repository.

Protect default drupal files

You can add lines to the pantheon.yml files to keep files such as /core/CHANGELOG.txt from being visible.

Set up domain redirects

At a minimum, you will want to redirect any non-https traffic to the https version of the site, so follow the instructions at: https://pantheon.io/docs/redirects/

...

After the site is launched, you can remove that second condition so that the pantheon platform address gets forwarded to the primary domain.

Domains

Look in the acquia site for the domains that are linked to their current site, and recreate any needed ones on the pantheon side.

The https certificates need to be pre-provisioned before the dns cutover to prevent an hour or so of non-secure warning. This involves uploading some verification files to acquia.

Load Testing

Pantheon likes to do load testing on the production environment before the domain switchover, so let them know that they can do that when things are ready.

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@23154b
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ( "php" , "acquia" , "pantheon" , "drush" , "configuration" ) and type = "page" and space = "KALA"
labelsacquia pantheon configuration drush php

...