Merge branch 'master' of gitlab.com:agaric/sites/geo

README.md

@@ -27,7 +27,7 @@ ddev . drush -y site:install minimal --existing-config
 ```
 
 
-## Running the migration.
+## Running the migration in development
 
 Put the D7 files in the following location:
 ```
@@ -60,3 +60,34 @@ Once the files are in the correct place and the database has been created we can
 ```
 ddev . drush mim --group="migrate_drupal_7_geo"
 ```
+
+
+## Running the migration on the hosted instance
+
+1. Ensure the files you need are uploaded to the server. Obtain the latest from the prior site: database, and files. Upload these to the server (e.g. `scp *.gz geo_live@drutopia.org:`) and we'll extract them there.
+1. If a deployment has been performed already, it must be moved out of the way by removing existing databases. Log into the server (`ssh geo_live@drutopia.org`) and remove the database(s):
+   - Start the mysql client (logged into geo_live): `mysql`
+   - Drop the drupal db: `drop database geo_live;`
+   - Drop the migration source db: `drop database geo_legacy;`
+   - Exit mysql by typing `ctrl+d`
+1. Extract the uploaded files (still on server):
+   - Unzip the uploaded database file (this expects there to be only ONE such file): `gunzip *.mysql.gz`
+   - Rename the database file: `mv *.mysql geo_legacy.sql`
+   - Read the db source into the proper database: `mysql geo_legacy < geo_legacy.sql`
+   - Unpack the files, but first cd to where they go (again, there should only be ONE file ending in .tar.gz in home): `cd site/d7/sites/default/files/` and untar: `tar xzf ~/*.tar.gz` (this will take a minute/two).
+   - The server side is ready! Log off by typing `ctrl+d`
+1. Now perform a deployment with drutopia_hosting. This will install the site using the minimal profile and existing config:
+   - `ahoy deploy-build news`
+   - `ahoy deploy-site geo_live`
+1. Return to the server (`ssh geo_live@drutopia.org`) and run the migration:
+   - `drush mim --group="migrate_drupal_7_geo"`
+
+## Post go-live tasks
+
+1. Remove all d7 files: `rm -rf site/d7` and `rm geo_legacy.sql`, etc.
+1. Change the site settings in hosting:
+   - config_import -> True
+   - php_settings_code -> blank
+1. Change the news build settings in hosting:
+   - remove custom build commands (i.e. sed)
+1. At this point, the deploy should be typical (deploy-build/deploy-site as normal)