Jump to content

Upgrading Open Atrium


rev.dennis
 Share

Recommended Posts

Here are the instructions and any hiccups or notes in regards to upgrading Open Atrium


 


This is the recommended way of updating a standard Open Atrium distribution to ensure that Drupal core files are updated along with the Open Atrium distribution:


0) Backup


Before starting the upgrade you should backup your all your code and your database. This is essential, so you can roll-back if something goes wrong during the update!



# cp -avr /var/www/oa/ /var/www/oaBACKUP

1) Save the /sites directory


The /sites directory contains all your site-specific customisation. So save this directory so that we can re-upload it in a later step.



# cp -avr /var/www/oa/sites/ /var/www/oaBACKUP/

2) Download the new files


Download the latest version of Open Atrium from project page: https://www.drupal.org/project/openatrium


 


3) Upload the new files


Replace the site's entire codebase with the new files. Do this by deleting the entire contents of the web root directory - the directory Open Atrium is installed in - completely, and then upload all the new files in their place.


Note: Do not simply copy the new files on top of the old ones. This will not delete old files that are no longer used and this could cause issues. You should have your old web root backed-up just in case!



# rm -rf /var/www/oa/
# tar -zxvf openatrium-7.x-2.23-core.tar.gz -C /var/www/
# mv /var/www/openatrium-7.x-2.23/ /var/www/oa/

4) Replace the /sites directory


Move or copy the /sites folder you saved in step 1 into the /sites folder of your new code.



# cp -avr /var/www/oaBACKUP/sites/ /var/www/oa/

Don't forget to correct permissions (not sure this is correct thing to do but I did it)



# chown -R www-data:www-data /var/www
# chmod -R g+rw /var/www

5) Run updates


Run update.php on your site:



http://youropenatriumsite.com/update.php

Or with drush: drush updb


This will perform essential tasks to bring your database up-to-date with the latest version (if there are any).


 


6) Clear caches


Clear the Drupal cache at: Admin - Configuration - Development - Performance - Clear all caches


Or with drush: drush cc all


Note: If you get errors then you may need to rebuild your registry. This is sometimes necessary if modules have moved around during the update. You can rebuild your registry with or without drush by following the instructions on the project page: https://www.drupal.org/project/registry_rebuild


 


7) Revert features


Take extra caution here.


drush fra -y (Read notes first)

This command is required to update all of Open Atrium's features to the latest version. Running it will revert and overwrite any existing features, including any changes that you may have made to Open Atrium's configuration. It is therefore very important to capture any customization using Features Override before attempting to upgrade. This command can be run at any other time to restore Open Atrium's features to their default settings (Eg: if someone has inadvertently tampered with any Views or layouts within Open Atrium).


 


8) Done


Your site is now up-to-date. Test it out!


---


Advanced notes


Updating the latest -dev version (for expert Drupal devs)

If you built your site using "git" and "drush" then you can use these same tools to update your site. First, save a copy of your Drupal sites/ directory as this will be overwritten by the update process. Next, go to the "openatrium" folder where you initially used "git" to fetch the Open Atrium repository. Use "git pull" to retrieve the latest version of the distribution. Then run the ./build.sh or ./build-dev.sh script exactly as before. Instead of pointing these scripts to your root web directory, you can point them to a temp directory in case the installation fails. The build.sh scripts delete everything in the target directory so building to a temp directory prevents your current web site from being lost if the build fails. Once the build is successful you can move the temporary directory in place of your web root, then restore the /sites directory that you previously saved.


If you just need to make a quick update of a specific open atrium module, you can also just go to that module directory and use "git pull origin" to pull in the latest changes without rebuilding the entire distribution.


Link to comment
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.

 Share

×
×
  • Create New...