Drumbeat/Website/Install: Difference between revisions

Drumbeat/Website/Install (view source)

Revision as of 13:49, 19 February 2010

348 bytes added , 19 February 2010

no edit summary

Gerv

Account confirmers, Anti-spam team, Confirmed users, Bureaucrats and Sysops emeriti

4,925

edits

@@ Line 9: / Line 9: @@
 * MySQL 5 (mysql-server)
 * Mail server (e.g. postfix)
+ sudo apt-get install php5 apache2 mysql-server postfix
 == Configuration ==
@@ Line 24: / Line 26: @@
 * PHP MySQL support (php5-mysql)
 * libgd2 for image manipulation - (XXXphp5-gd module + dependencies? Or is it built-in?)
-* curl support for feeds (XXX module? Isn't it built-in?)
+* curl support for feeds (php5-curl module? Isn't it built-in?)
 * pecl module "uploadprogress" for enhanced ajax uploads (XXXwhere to find and how to install? Install php-pear and then run a pear command?)
 * sendmail support (XXXphp-mail module? Or is it built-in?)
@@ Line 63: / Line 65: @@
 Edit <tt>$DRUPAL_ROOT/sites/default/settings.php</tt>:
-# Update $db_url['default'] & $db_url['mozcrm_civicrm'] database connection strings ('default' is for the Drupal database, the other is for CiviCRM).
+# Update <tt>$db_url['default']</tt> and <tt>$db_url['mozcrm_civicrm']</tt> database connection strings ('default' is for the Drupal database, the other is for CiviCRM).
-# Check the correct memcached port is specified.
+# Check the correct memcached port is specified in the <tt>memcache_servers</tt> array.
 # Right at the bottom of the file, the domain module include path must be updated to be "<tt>$DRUPAL_ROOT/sites/all/modules/contrib/domain/settings.inc</tt>".
 Edit <tt>$DRUPAL_ROOT/sites/default/civicrm.settings.php</tt>:
-# Update the database connection string for the Drupal database CIVICRM_UF_DSN.
+# Update the database connection string for the Drupal database (<tt>CIVICRM_UF_DSN</tt>).
-# Update the database connection string for the CiviCRM database CIVICRM_DSN.
+# Update the database connection string for the CiviCRM database (<tt>CIVICRM_DSN</tt>).
-# Update the CiviCRM root path $civicrm_root to be "<tt>$DRUPAL_ROOT/sites/all/modules/civicrm</tt>".
+# Update the CiviCRM root path <tt>$civicrm_root</tt> to be "<tt>$DRUPAL_ROOT/sites/all/modules/civicrm</tt>".
-# Update the CiviCRM template folder CIVICRM_TEMPLATE_COMPILEDIR to be "<tt>$DRUPAL_ROOT/sites/default/files/civicrm/templates_c/</tt>".
+# Update the CiviCRM template folder <tt>CIVICRM_TEMPLATE_COMPILEDIR</tt> to be "<tt>$DRUPAL_ROOT/sites/default/files/civicrm/templates_c/</tt>".
-Make these two files read only ($APACHE_USER is the user your Apache runs as, "<tt>www-data</tt>" on Ubuntu):
+Make these two files read only ($USER is your user, and $APACHE_USER is the user your Apache runs as, "<tt>www-data</tt>" on Ubuntu):
-   chmod 0400 settings.php civicrm.settings.php
+  cd $DRUPAL_ROOT/sites/default/
-   sudo chown $APACHE_USER settings.php civicrm.settings.php
+   chmod 0640 settings.php civicrm.settings.php
+   sudo chown $USER:$APACHE_USER settings.php civicrm.settings.php
 Edit <tt>$DRUPAL_ROOT/sites/default/files/civicrm/upload/Config.IDS.ini</tt>:
@@ Line 84: / Line 87: @@
 # Make it read-only, and readable by the apache user only:
-   chmod 0400 Config.IDS.ini
+  cd $DRUPAL_ROOT/sites/default/files/civicrm/upload/
-   sudo chown $APACHE_USER Config.IDS.ini
+   chmod 0440 Config.IDS.ini
+   sudo chown $USER:$APACHE_USER Config.IDS.ini
-Verify that the following files & folders exist and are apache user writeable and other users readable:
+Verify that the following files & folders exist and are writeable by the apache user and readable by everyone else:
 # $DRUPAL_ROOT/sites/default/files/ (and all subfolders)
 # $DRUPAL_ROOT/cache/
+  cd $DRUPAL_ROOT
+  mkdir cache
+  chmod -R 0664 cache sites/default/files
+  sudo chown -R $USER:$APACHE_USER cache sites/default/files
 == View Site ==
@@ Line 104: / Line 113: @@
 to see your installation working.
-XXX This will depend on your /etc/host configuration. All the required steps are at http://groups.drupal.org/node/6266  [booker]
+XXX This will depend on your /etc/host configuration. All the required steps are at http://groups.drupal.org/node/6266  [booker] - Paul - can we integrate the appropriate steps, or give a simple recipe? That URL seems fairly complex... - Gerv
 Access
@@ Line 118: / Line 127: @@
 Log in to the site as “admin”. (XXX password in default db?)
-# Go to http://$SITE/admin/build/domain/settings and set the Primary domain name to the Mozillians domain name. Save.
+# Go to <tt>http://$SITE/admin/build/domain/settings</tt> and set the Primary domain name to the Mozillians domain name. Save.
-# Go to http://$SITE/admin/build/domain/edit/2 and set the DOMAIN name to $SITE. Save. When using the drumbeat domain name, the site should now appear in the drumbeat theme.
+# Go to <tt>http://$SITE/admin/build/domain/edit/2</tt> and set the DOMAIN name to $SITE. Save. When using the drumbeat domain name, the site should now appear in the drumbeat theme.
-# Next flush the cache - click “Flush all caches” on the Drupal icon menu (should be http://$SITE/admin_menu/flush-cache). (XXX isn't this broken?)
+# Next flush the cache - click “Flush all caches” on the Drupal icon menu (should be <tt>http://$SITE/admin_menu/flush-cache</tt>). (XXX isn't this broken?)
 Now CiviCRM configuration which can be tricky, because it stores more path related settings in the database from the UI, which breaks links in the CiviCRM configuration screens.
-# Check http://$SITE/civicrm/admin/setting/path?reset=1 full paths are correct.
+# Check <tt>http://$SITE/civicrm/admin/setting/path?reset=1</tt> full paths are correct.
-# Check http://$SITE/civicrm/admin/setting/url?reset=1 paths are correct. Use the Drumbeat domain.
+# Check <tt>http://$SITE/civicrm/admin/setting/url?reset=1</tt> paths are correct. Use the Drumbeat domain.
-# Setup donation Payment Processors admin/paymentProcessor?reset=1 XXXNot for testing, I presume?
+# Setup donation Payment Processors <tt>http://$SITE/civicrm/admin/paymentProcessor?reset=1</tt> XXXNot for testing, I presume?
-Google Maps API key - for geolocating users. Add it at http://$SITE/admin/settings/gmap
+Google Maps API key - for geolocating users. Add it at <tt>http://$SITE/admin/settings/gmap</tt>
-Flickr API key - for Flickr widget. Add it at http://$SITE/admin/settings/flickr
+Flickr API key - for Flickr widget. Add it at <tt>http://$SITE/admin/settings/flickr</tt>
 Enable the “Simple Mail” module to provide mail functionality
-# http://$SITE/admin/build/modules. Save right at the bottom.
+# <tt>http://$SITE/admin/build/modules</tt>. Save right at the bottom.
-# http://$SITE/admin/settings/site-information and ensure site email is correct.
+# <tt>http://$SITE/admin/settings/site-information</tt> and ensure site email is correct.
-Setup timezone at http://$SITE/admin/settings/date-time
+Setup timezone at <tt>http://$SITE/admin/settings/date-time</tt>
-Drumbeat specific settings are configurable at http://$SITE/admin/settings/drumbeat
+Drumbeat specific settings are configurable at <tt>http://$SITE/admin/settings/drumbeat</tt>
-Finally check the status reports http://$SITE/admin/reports/status . You can safely ignore the SWFObject message.
+Finally check the status reports <tt>http://$SITE/admin/reports/status</tt>. You can safely ignore the SWFObject message.
 === Drupal cronjob ===
-Add the following line to /etc/crontab
 Run:
@@ Line 156: / Line 163: @@
 XXX the cron.php file will also need to be unreachable from over the web [booker] - in which case, we should fix the default .htaccess so this is true - Gerv.
-=== Drupal file upload folder ===
-Set permissions on the $DRUPAL_ROOT/sites/default/files directory (replace $DRUPAL_ROOT and $USER with appropriate values):
- cd $DRUPAL_ROOT/sites/default/
- sudo chown -R $USER:www-data files
- sudo chmod -R g+w files
 === Troubleshooting ===
-If you can't see it...
-''To be added''
 I'll be happy to assist anyone who wishes to help out with Drumbeat [booker]