Community Documentation

How Do I Run the Dev Version of Panopoly?

Last updated May 16, 2013. Created by populist on August 7, 2012.
Edited by pfrenssen, esmerel. Log in to edit this page.

If you want to start developing off the latest and greatest Panopoly code, here are some steps to get going:

  1. Clone the Git Repository - Panopoly is controlled by a Drupal install profile that can all be downloaded to your web root using this command:

    git clone --recursive --branch 7.x-1.x http://git.drupal.org/project/panopoly.git profiles/panopoly;
  2. Build Panopoly with Drush Make - To build a version of Drupal core with the appropriate Panopoly and contrib modules in the Panopoly profile folder, you will need to be using Drush version 5 and run this command from your web root:

    drush make --prepare-install --no-gitinfofile --contrib-destination=profiles/panopoly profiles/panopoly/build-panopoly.make
  3. Prepare the Panopoly Install - There are a few things you need to do to get Drupal + Panopoly running smoothly. This will include creating and appropriately permissioning a your settings.php and files directory (which drush make --prepare-install often does), as well as granting permission for the webserver to write to the modules, libraries, and themes directories which can be accomplished with:

    chmod 770 sites/all/modules sites/all/themes
  4. Install Panopoly - If everything above worked, you would then just hit your website at install.php and install Panopoly! You can also use Drush to install with this command:

    drush site-install --db-url=mysql://USER:PASS@localhost/DATABASE panopoly

If you want to update to the latest development version, from your web root just use git to update your profile checkout and then use drush to rebuild the make file and run update.php using this command:

cd profiles/panopoly && git pull && cd ../.. && drush make --no-gitinfofile --contrib-destination=profiles/panopoly profiles/panopoly/build-panopoly.make
drush updatedb

Comments

How do I update to a newer

How do I update to a newer development version?

To upgrade to the newest version

First you need to update all of your git checkouts:

cd profiles/panopoly && git pull && cd .. && cd ..; cd sites/all/modules; cd panopoly_admin && git pull && cd ..; cd panopoly_core && git pull && cd ..; cd panopoly_demo && git pull && cd ..; cd panopoly_faq && git pull && cd ..; cd panopoly_images && git pull && cd ..; cd panopoly_magic && git pull && cd ..; cd panopoly_news && git pull && cd ..; cd panopoly_pages && git pull && cd ..; cd panopoly_search && git pull && cd ..; cd panopoly_theme && git pull && cd ..; cd panopoly_users && git pull && cd ..; cd panopoly_widgets && git pull && cd ..; cd panopoly_wysiwyg && git pull && cd .. && cd .. && cd .. && cd ..;

And then you need to rebuild with drush make:

drush make -y profiles/panopoly/build-panopoly.make

Upgrading made easier

The upgrading process has now been made easier and it is no longer necessary to use git checkouts to manage the modules. Now just build the base distribution from Drupal.org using the instructions above and to upgrade you just need to run drush make again.

Are there submodules in the

Are there submodules in the panopoly repo? Does --recursive actually do anything in the git clone command?

No Git Submodules

Panopoly is packaged normally from drupal.org and doesn't involve any formal git submodules, but does bundle a number of existing contrib modules as per Drupal.org's distribution packaging described at http://drupal.org/node/647374.

so the --recursive in the

so the --recursive in the instructions can be removed, correct?

Git Syntax Parity with Drupal.org

You are right the --recursive option is not needed. It is just included for consistency with how Drupal.org's version control instructions work - http://drupal.org/project/panopoly/git-instructions.

Sorry to be daft, but...

Is there no way to build a panopoly distribution (not just profile) with a single command?

As an example, building openacademy is done using
drush make build-openacademy-dev.make. This will build out an entire distribution with the openacademy profile.

In contrast, the same command on panopoly will build a working site that is missing the panopoly profile. The panopoly contrib modules will be inside the sites folder.

To Build the Entire Distribution In One Command

Panopoly works like other distributions and can be fully built from Drush Make:

drush make --no-gitinfofile profiles/panopoly/build-panopoly.make

Unless you have provided alternative configuration for drush make this will build Panopoly's modules, themes, and libraries in sites/all/modules but you can configure Drush to place them elsewhere if you like.

You can also download a fully built version (from Drupal.org) by running this command:

drush dl panopoly

Has anyone tried this recently?

I get several errors not being able to clone modules from their git.drupal.org repositories. Very new to Git and Drush so it coul dbe something simple, but I followed the exact commands listed above.

-Finn

Page status

No known problems

Log in to edit this page

About this page

Audience
Programmers
Drupal’s online documentation is © 2000-2013 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License. Comments on documentation pages are used to improve content and then deleted.
nobody click here