Changes between Version 7 and Version 8 of InstallDrupal

Timestamp:

Jan 14, 2013, 10:41:17 PM (12 years ago)

Author:

tristano

Comment:

--

InstallDrupal

@@ -9 +9 @@
 3. Import a working copy of the BOINC database to MySQL, granting permissions for SELECT, INSERT, UPDATE, and DELETE to an appropriate user (e.g. boinc) on boinc_db_name@localhost. Alternatively, hook into a "live" database for testing on an existing dev platform.
 
-4. Import the pre-configured Drupal database and grant permissions for SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE_TMP_TABLE, and LOCK_TABLES to an appropriate user (e.g. drupal_boinc) on drupal_db_name@localhost.
+4. ~~Import the pre-configured Drupal database and~~ grant permissions for SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER, CREATE_TMP_TABLE, and LOCK_TABLES to an appropriate user (e.g. drupal_boinc) on drupal_db_name@localhost.
 
 5. Edit the dbconfig.php file in sites/default/ of the web root so that db variables are appropriate for the Drupal database and boinc_db variables likewise allow access to the BOINC database.
 
 Basic functionality should now be in place. Create an account and then set its uid to 1 in the Drupal users table for unlimited admin access in Drupal. 
+
+= Configure System Features =
+
+The Drupal integration system contains a number of //Features//, which are custom meta packages that provide some specific type of functionality. These might be as simple as providing text for a single link or menu, or as complex as pulling together community contributed modules, custom code, site configurations, and content in order to significantly enhance the site wide experience. 
+
+The purpose of Features is to allow for simple deployment of modules and configurations. Rather than install each Drupal module by hand and "replay" any configurations that are required, enabling a Feature automatically satisfies all dependencies required for its logical function and sets default configurations as appropriate. Deployment of Features is best handled on the command line by using drush.
+
+== Drush Setup ==
+
+Drush is a Drupal shell program that provides a command line interface to Drupal and is thus scriptable. While some Linux distributions may have a drush package in their repositories, it is best to get the current package via pear (if php-pear is not installed, install it using the appropriate methods for the distribution):
+{{{
+# pear channel-discover pear.drush.org
+# pear install drush/drush
+}}}
+
+Note: If channel-discover fails, try running "pear upgrade" first.
+
+== Enable BOINC Features ==
+
+The Features module must be enabled, if it isn't already, or corresponding drush extensions will not be available:
+{{{
+# drush en features
+}}}     
+The memory_limit setting for the PHP command line interface may need to be increased beyond the default for drush to function
+Once drush is set up, BOINC features can be enabled by first creating symbolic links in sites/all/modules/features-enabled pointing back to the feature module under sites/all/features and then using the following drush command:
+{{{
+# drush en [feature...]
+}}}
+This will automatically determine which additional features or modules are required and prompt for installation thereof. In some cases, it may be necessary to then force an update from file for all features to revert any "overrides" that exist (if any functionality provided by a feature already existed in the site database, it will need to be "reverted" to what is provided by the feature):
+{{{
+# drush fr-all
+}}}
+This command will ensure that all changes in code are applied to the site database. Similarly, when feature code is changed in git, a specific feature or set of features can be updated with the drush fr [feature] command.
+
+== Manual Changes Required ==
+
+=== URL Aliases ===
+
+Required URL aliases include:
+
+* account -> dashboard
+* account/dashboard -> dashboard
+
+=== Menu Configuration ===
+
+Ensure that the Account menu is present and correct. It should contain the following menu items:
+
+* Dashboard
+* Profile
+* Account Info
+* Preferences
+
+If "Dashboard" does not exist, it should be created with the same path as the parent (account/dashboard).
+
+Disable "My bookmarks," which is created by the Flag module, but is not used.
 
 = Importing BOINC data =