|Automated Installer for CiviCRM 4.2 on Drupal 7.x|
This page provides instructions for using the web-based Automated Installer. This is the recommended installation method.
If you are upgrading from v3.1, v3.2, v3.3, v3.4, v4.1 or a prior version of v4.2 - use these instructions
Before beginning the install process, please verify that your server meets all the requirements for CiviCRM 4.2.
- Drupal 7.x : CiviCRM 4.2 is built to run under Drupal 7 (or Drupal 6) and is not compatible with either Drupal 5.
- PHP 5.3+ : Starting with the 1.9 release, CiviCRM will NOT run on PHP4 servers. (more info...).
- MySQL 5.1.x or higher with INNODB support : CiviCRM is compatible with the current generally available MySQL release. Trigger permission is required to enable logging and multi-lingual support. SUPER privileges are required in MySQL 5.1 if binary logging is enabled.
- PCRE with Unicode properties support (more info).
- MAMP XCache in-compatibility* - Several people have reported "white screen of death" trying to run CiviCRM 4 with MAMP's XCache enabled (check MAMP > Preferences > PHP > Cache).
1. Server Requirements
CiviCRM for Drupal has been developed and tested by our team on the following 'recommended' platforms:
- Apache 2.1
- PHP 5.3
- MySQL 5.x with InnoDB enabled
- Drupal 7.x
2. Drupal Installed
The automated installer requires Drupal 7.x.. If you do not have the required version of Drupal installed, refer to:
Verify Drupal Database Settings
You will need to know the database settings for your Drupal installation prior to running the CiviCRM installer:
You can look up these values in your Drupal settings.php file (located by default in your <drupal_root>/sites/default directory)
In the above example:
Drupal Database Name
Database User Name
Database User Password
3. Tell Drupal where to find the CiviCRM 4.2 Module
Unlike earlier versions of Drupal, you do not need to download and upload modules - you just tell Drupal where to find it!
- As administrator in Drupal, go to Modules, click on Install New Module, and it will ask you to fill in the URL of the module. It will then fetch it and install it for you. You will need to enable the Update Manager module in the drupal modules page to see the Install New Module link.
- The current link is http://sourceforge.net/projects/civicrm/files/civicrm-latest/4.2.x/civicrm-4.2.x-drupal.tar.gz/download. You will need to replace 4.2.x with the current minor version number. You may need to remove '/download' for the automated installer to work.
- Hit the Install Button.
- Do NOT proceed to "activate" the module - that will happen automatically in step 5.
4. If Using Localization, install the localisation files
See the CiviCRM Localisation page about how to install files for running CiviCRM in languages other than American English.
5. Run the Installer
The installer will verify that you've downloaded the correct version of CiviCRM, and will check your server environment to make sure it meets CiviCRM requirements. It will then create and populate a database for CiviCRM as well as create your CiviCRM settings file (civicrm.settings.php).
- Login to your Drupal site with Administrator level permissions.
- Point your web browser to the following URL:
6. Review Permissions
Note that Drupal tries to create the /files/ directory (and make it writeable), but only when saving admin/settings. Same holds for /temp directory, and a /uploads/ directory in the CiviCRM module root. On a brand-new Drupal install, this directory may be missing. Even on an existing installation, if file permissions are not set properly, the directory may be missing. If enabling the civicrm module generates errors regarding the files directory, you must create it (writeable) manually. Refer to Step 2 for instructions on directories to create and permissions to set.
* Go to Administer » User management » Permissions
- *- Verify that the Roles that you want to have access to CiviCRM have the appropriate permissions checked. CiviCRM is installed with a number of fixed permissions (such as "edit contacts" and "administer CiviCRM").
|Permissions for the Anonymous Role|
Many sites want anonymous visitors to have access to certain CiviCRM functionality. These permissions are enabled during installation for the Anonymous role. You should review them and modify if needed based on your requirements:
- access all custom data : If you plan on collecting "custom" data from visitors in standalone forms or as they make a contribution - enable this permission.
- access CiviMail subscribe/unsubscribe pages : If you are planning on using CiviMail, enable this permission to allow anonymous users to subscribe and unsubscribe from mailing lists via the web.
- access uploaded files : If you plan on allowing visitors to upload or view photos or other files - enable this permission.
- make online contributions : If you plan on soliciting online contributions from visitors, enable this permission for the "anonymous" role.
- profile listings and forms : If you plan on collecting name and address or other information from visitors, enable this permission for the "anonymous" role.
- view event info and register for events : If you plan to use CiviEvent and want to allow un-authenticated visitors to view event information and register for events online - enable these permissions for the "anonymous" role.
- view event participants : Enable this permission to allow anonymous users to access participant listing pages for events.
Once installed, CiviCRM keeps your Drupal Users synchronized with corresponding CiviCRM contact records. The 'rule' is that there will be a matched contact record for each Drupal user record. Conversely, only contacts who are authenticated users of your site will have corresponding Drupal user records.
When CiviCRM is installed on top of an existing Drupal site, a special CiviCRM Administrative feature allows you to automatically create CiviCRM contacts for all existing Drupal users:
- Login to your Drupal site with an administrator-level login
- Click the CiviCRM link in the main navigation block
- If your Drupal site makes use of the db_prefix setting (in settings.php - cf. Step 2, above), in de top bar click Administer » System Settings » CMS Database Integration, and update the box for the Drupal Users Table Name so that it includes the prefix.
- Click Administer in the menu bar
- Click Users and Permissions from the drop-down menu, then select Synchronize Users to Contacts
8. Review the Configuration Checklist
The Configuration Checklist provides a convenient way to work through the settings that need to be reviewed and configured for a new site. You can link to this checklist from the installation success page AND you can visit it at any time from Administer » Administration Console » Configuration Checklist.
9. Test-drive CiviCRM
There should now be a CiviCRM link in your Drupal menu. Click that link and the CiviCRM Menu, Shortcuts, Search and New Individual Blocks should appear.
You can now explore CiviCRM end-user features and begin configuring CiviCRM for your site/organization needs. Refer to the Administrator Guide for information on configuration tasks and options. Tips for creating CiviCRM Profiles (forms), custom data fields and programming custom data manipulation are included in the Drupal installation and configuration example document.
Review the Installation and Configuration Trouble-shooting section of our wiki for help with problems you may encounter during the installation.
You can often find solutions to your issue by searching the installation support section of the community forum OR the community mailing list archives, and you can check out the Installation section of our FAQs.
If you don't find an answer to your problem in those places, the next step is to post a support request on the forum.