Drupal Quick Install Guide

Drupal Application Installation Instructions
The System requirements can be found here: https://open.umich.edu/wiki/Install/Upgrade_Documentation. Things you must pay attention to on this list: . Apache 2 web server must be used . Php 5.2 must be used! . MySQL 5.0 or a greater version must be used . Application depends on Apache SOLR . Java Runtime is required for SOLR . phpmyadmin (optional) ensures necessary extensions get installed! see the notes below "Web Server Configuration" While the current distribution uses the Pressflowfor the core Drupal runtime, other Drupal distributions can be used to support this application.

Before installing this application, check the target system for the required levels of software!

For the purpose of constructing this document, the open.umich drupal software was installed on a Ubuntu 9.10 system.

Database installation
Create a database & permit the "oerpublisher" user access to this database. While I normally use the "phpmyadmin" web tool for this sort of thing, I have included the commands that can be used from a terminal window (of course, this assumes you have the necessary MySQL access): mysql -u root -p mysql> create database oerpublish; mysql> grant all on oerpublish.* to oerpublisher@localhost identified by "sillypassword";

Note: The above command grants the account (oerpublisher@localhost) all the permissions on employees database and sets the password to sillypassword. You should choose an appropriate password.

The database to import is found here Database and should be downloaded. You can import it using the phpmyadmin web tool, but I have included the command(s) that can be used from a terminal window: . wget http://www-personal.umich.edu/~bdr/open-michigan/open-michigan.sql.gz    . gunzip open-michigan/open-michigan.sql.gz     . mysql -u root -p -h localhost oerpublish < open-michigan.sql

Install the Application
Download the application from here. The contents should be extracted and placed in the web server DocumentRoot directory, which is often /var/www/html. It would be prudent to backup the web server DocumentRoot directory before extracting this application. The file permissions need to be set to the user and group that used by the web server (for this example, we will use "apache" for the user and "apache" for the group). You may need to run these commands as "sudo". Here is an example of commands what can be run from a terminal window: . cp -r /var/www/html /var/www/html-backup   (backup DocumentRoot) . cd /var/www/html . wget http://www-personal.umich.edu/~bdr/open-michigan/open-michigan.tar.gz    .  tar -zxf open-michigan.tar.gz    (extract the application) . chown -R apache:apache     (set user/group to the web server)

This application must be configured to use the database that was imported. The Drupal settings.php file must be altered. This is found in the DocumentRoot/sites/default/settings.php (/var/www/html/sites/default/settings.php in our example). In this file the following entries must be changed: $db_url = 'mysql://oerpublisher:sillypassword@localhost/oerpublish'; where sillypassword is replaced with the password you assigned to oerpublisher during the database installation. $base_url = 'http://www.sillyschool.edu' ; // NO trailing slash! where www.sillyschool.edu is replaced with the DNS for this web server. Note: if you have installed a web certificate and wish to have all web access be secured with SSL, then you must also change the "http://" to "https://".

Install Apache SOLR
Download the solr application from here. The contents should be extracted and placed in /var/www - here are commands that can be run from a terminal window to perform the install (again, your system may require you to run these commands as "sudo"): . cd /var/www . wget http://www-personal.umich.edu/~bdr/open-michigan/solr.open-michigan.tar.gz     .  tar -zxf solr.open-michigan.tar.gz

The Apache SOLR service needs to be setup to run as a service. Here is advice on how to do this on a on RHEL/CentOS system -> RHEL/CentOS. Here is a pointer to assist you in doing this on an Ubuntu server -> Ubuntu. Here is a web page that will provide insight on using Apache SOLR with a Drupal Application -> SOLR/Drupal

NOTE: if the SOLR service is not running, the "search" function for the Drupal application will not work correctly!

Web Server Configuration Changes
Make sure that your web server is configured to permit php scripts to run in the DocumentRoot. Below is are configuration parameters that work:

 Options -Indexes FollowSymLinks AllowOverride All Order Allow,Deny Allow from all 

 Options -Indexes FollowSymLinks MultiViews AllowOverride All Order allow,deny allow from all 

Note: Be sure that the "Rewrite" module is installed and enabled for the Apache web server.

Note: Make sure that php is permitted to run large scripts. Please locate and change the php.ini file used by the web server as follows: ;memory_limit = 16M     ; Maximum amount of memory a script may consume (16MB) memory_limit = 64M ;

Note: I noticed that sometimes the target system is missing the necessary MySQL php extension(s). When I installed "phpmyadmin", which is dependent on the same extensions, the missing extensions were installed. Even if you choose to disable phpmyadmin, installing it simplifies the installation of the necessary MySQL php extensions.

The web server should now be restarted.

Test Application
Point your web browser at the web server "http://www.yourwebservername.edu". You may need to "refresh" the web browser several times to before you see the following web page:

When you click on the other links or on the buttons ( Find, Share, Connect) you should be presented with other web pages.

To explore the capability of the Drupal "super-administrator" point your web browser at  http://www.youservername.com/user/login 

Use this Username: backend Use this Password: backend2010

Note: you should change this password ASAP!

You should now be presented with a web page that contains the black bar with the administrator menu items at the top of that page.

Default Users
Here are the following users that come with the application.

The password for each user listed above is the Username with '2010' appended. (backend/backend2010, publisher/publisher2010). It is suggested that all of these passwords be changed immediately.