Documentation for Upgrading [#2565923]

I'm loving the new docs at http://devshop.readthedocs.org/en/latest !

I was hunting through and trying to find documentation on upgrading to the latest version of devshop, and couldn't find it on devshop.readthedocs.org. Lets add upgrade instructions to the official docs.

It may make sense to drop a new nav menu item in the docs below "Installing DevShop" titled "Updating DevShop". See screenshot attached about the nav location I'm describing, just above "Changing Hostname".

Working with Jon at DrupalCon LA, I believe it's as simple as cloning the latest code and dropping it into:

/var/aegir/devmaster-0.x

Then running update.php on your devshop installation.

Jon if you get a chance to read this, please let me know if I'm off on my above assumption in the upgrade process.

Comment	File	Size	Author
	upgrade-position.png	4.51 KB	jamesdixon

Support from Acquia helps fund testing for Drupal Acquia logo

Comments

Comment #1

9 September 2015 at 20:00

jamesdixon created an issue. See original summary.

Comment #2

Jon Pugh

he/him

English

Newburgh, NY

CreditAttribution: Jon Pugh at ThinkDrop commented 9 September 2015 at 20:27

Excellent!

Happy to have your help. Please create a fork of the devshop project over at https://github.com/opendevshop/devshop and submit a pull request for this documentation!

Putting it underneath the installation instructions makes perfect sense.

As for the docs themselves...

What you've described would be part of what I would call the "manual" update process. There's a bit more to it that that:

Manually replace the drupal codebase at /var/aegir/devmaster-0.x with an updated devmaster stack. You can use the build-devmaster.make file to create a newer drupal site.
Run drush @hostmaster updb and drush @hostmaster cc all
Update drush command projects at /var/aegir/.drush/commands
Run the ansible playbook again to ensure any new packages or other features are installed.

This is a terrible, hacky but effective method for upgrading a devshop server.

I am working on the "devshop upgrade" command that will do it all for you in a sane way, but it's not ready yet.

I'll take this as a sign that it needs to be ready.

Let's work on this! Post your PR!

Thanks!
Jon

Comment #3

Jon Pugh

he/him

English

Newburgh, NY

CreditAttribution: Jon Pugh at ThinkDrop commented 10 September 2015 at 03:08

Status:

Active

» Needs review

Hi james,
I've gone ahead and created the Upgrading documentation page after a sprint tonight to finish the `devshop upgrade` command and a new devshop release!

Please go through the instructions at http://devshop.readthedocs.org/en/latest/upgrading/#upgrading-from-pre-040 (note the section on how to upgrade a pre-0.4.0 server).

Please let me know if these instructions are sufficient!! Would love to know that your upgrade goes ok.

Thanks,
Jon