Drumbeat/Website/Install

Draft-template-image.png THIS PAGE IS A WORKING DRAFT Pencil-emoji U270F-gray.png
The page may be difficult to navigate, and some information on its subject might be incomplete and/or evolving rapidly.
If you have any questions or ideas, please add them as a new topic on the discussion page.

Packages To Install

(Debian/Ubuntu package names in brackets)

  • PHP 5.2 (php5)
  • Apache 2.x (apache2)
  • MySQL 5 (mysql-server)
  • ... any more? XXX
  • memcached (memcached) XXX?
  • php5-memcache 2.2.5 (php5-memcache) - not 3.x, which Ubuntu 9.10 ships

XXX Can people do without memcached for single-user testing? I would say for the vast majority of bugs not having memcache will not make much difference, only if your fixing memcache specific problems or running performance test will it be necessary to have it installed. [booker] Is it complex to set up? no, you have to sudo aptitude install memcached .. and then .. sudo aptitude install php5-memcache and open port 11211 for localhost (going from memory) [booker]


XXX Where do people get the older version of php5-memcache?

Configuration

PHP 5.2

XXX where do these changes go?

  • config tweaks: memory_limit = 128M, max_execution_time = 300, upload_max_filesize = 8M (or your preference - affects file uploads to the site) How do you install this stuff? Need to modify php.ini using sudo nano /etc/php5/apache2/php.ini if your editor of choice is nano and then restart apache with sudo /etc/init.d/apache2 reload [booker]
  • libgd2 for image manipulation - (XXXphp5-gd module + dependencies?)
  • pecl module "uploadprogress" for enhanced ajax uploads (XXXwhere to find and how to install?)
  • sendmail support (XXXphp-mail module? Sendmail itself? Is this needed for everyone?) currently i use postfix, easy to setup with sudo aptitude install postfix [booker]

Apache 2

  • Enable mod_rewrite for clean urls:
sudo a2enmod rewrite 

MySQL 5

XXX Where is all this configured?

  • mysqli connection method
  • innodb
  • 1x database for drupal, 1x database for civicrm
  • Modify connection strings in {Drupal root}/sites/default/settings.php and {Drupal root}/sites/default/civicrm.settings.php

XXX modify from what to what?

Get Code

This includes our own copies of Drupal, various Drupal modules, and CiviCRM. Run this command:

svn co http://svn.mozilla.org/projects/crm/trunk /var/www/drumbeat.org

Or, if you have Mozilla SVN write access:

svn co svn+ssh://svn.mozilla.org/projects/crm/trunk /var/www/drumbeat.org
svn co https://svn.mozilla.org/projects/crm/trunk /var/www/drumbeat.org (alternative)

XXX Is this the right directory to check out into? Or do we say to put it elsewhere and use a symlink? perhaps instead of /var/www/drumbeat.org we could have [local directory] [booker]

Additional Configuration

Install Sample Database

  • XXX - need to make this available

Drupal cronjob

Add the following line to /etc/crontab (XXX or is there a better way in modern OSes?)

10 * * * * wget -q -O /dev/null http://{drumbeat_site_url}/cron.php

XXXWhat's the slash do? i have deleted the / as it is an error [booker]

boost module

Boost module maintains a page cache here, which dramatically improves performance for anonymous users. Modify the "cache" folder in the Drupal root apache writeable, other readable. Copy the settings generated at http://{drumbeat_staging_url}/admin/settings/performance/boost-rules into {Drupal root}/.htaccess over the existing #Boost rules section.

Drupal file upload folder

  • modify "sites/default/files" from the Drupal root apache writeable, other readable. Something like .. sudo chown -R USER:www-data files .. then .. sudo chmod -R g+w files [booker]

Web UI settings

XXX Does everyone need these for local testing, or can they do without? these keys will need to be removed in the sanitized version of the database - if i recall correctly you have to create some localhost keys for flickr [booker]

  • GMap api key - for geo locating. Configure @ admin/settings/gmap
  • Flickr API key - for flickr widget. Configure @ admin/settings/flickr

View Site

Access

http://localhost/drumbeat.org/

to see your installation working.

This will depend on your /etc/host configuration. All the required steps are at http://groups.drupal.org/node/6266 [booker]

Troubleshooting

If you can't see it...

To be added

ill be happy to assist anyone who wishes to helpout with Drumbeat [booker]

Optional Pieces

Memcached

  • /usr/bin/memcached -m 2048 -p 11210 -u {apache user} -l 127.0.0.1
  • Check settings in {Drupal root}/sites/default/settings.php match (port)

Apache Solr

XXX Is this optional, or not? XXX Will 1.2 do? That's what Ubuntu packages...

  • download 1.4 tarball
  • extract to /opt/solr
  • copy over schema.xml and solrconfig.xml from SVN to /opt/solr/example/solr/conf/
  • cd /opt/solr/example
  • java -jar start.jar

Extra Bits (???)

  • Moving CiviCRM database from staging to live. Clear the CiviCRM configuration from the database - which is rebuilt automatically from {Drupal root}/sites/default/civicrm.settings.php
UPDATE `mozcrm_civicrm`.`civicrm_domain` SET `config_backend` = NULL WHERE `civicrm_domain`.`id` =1 LIMIT 1 ;