DrupalEd Install Instructions CONTENTS OF THIS FILE --------------------- * Requirements * Optional requirements * Installation <-- IF YOU READ NOTHING ELSE, READ THIS!!! * Drupal administration * Cron Tasks * More Information REQUIREMENTS ------------ Drupal requires: 1. a web server(Apache recommended) 2. PHP4 (4.4.x or greater) or PHP5 (recommended) -- for more info see http://www.php.net 3. MySQL (http://www.mysql.com/) 4.1 (5 recommended). For more detailed information about Drupal requirements, see "Requirements" (http://drupal.org/requirements) in the Drupal Handbook. Guidelines for setting up a server environment with a variety of operating systems and in special cases are available in the Drupal handbook (http://drupal.org/node/260) OPTIONAL REQUIREMENTS --------------------- - To use XML-based services such as the Blogger API, Jabber, and RSS syndication, you will need PHP's XML extension. This extension is enabled by default. - If you want support for clean URLs, you'll need mod_rewrite and the ability to use local .htaccess files. Clean URL support is fairly straigntforward using Apache, and more complex using IIS. INSTALLATION ------------ 1. CREATE THE DRUPAL DATABASE Drupal requires access to a database in order to be installed. Your database user will need sufficient privileges to run Drupal. Additional information about privileges, and instructions to create a database using the command line are available in INSTALL.mysql.txt (for MySQL) or INSTALL.pgsql.txt (for PostgreSQL). To create a database using PHPMyAdmin or a web-based control panel consult the documentation or ask your webhost service provider. Take note of the username, password, database name and hostname as you create the database. You will enter these items in the install script. 2. RUN THE INSTALL SCRIPT The install script will set the base URL, connect Drupal to the database, and create tables in the database. To run the install script point your browser to the base url of your website (i.e. http://www.example.com). You will be presented with the "Database Configuration" page. The install script will attempt to write-protect the settings.php after updating it with the information you provide in the installation routine. If you make manual changes to that file later, be sure to protect it again after making your modifications. Failure to remove write permissions to that file is a security risk. The default location for the settings.php file is at sites/default/settings.php, but it may be in another location if you use the multi-site setup, as explained below. 3. RESET THE DATABASE Once you have installed the core Drupal install, using phpMyAdmin (or your database admin tool) DROP ALL tables in your database. Restore the tables by importing oa_drupaled.sql (included with this file). 4. LOG IN TO THE SITE The admin user (UID1) is username "admin", password "ineedachange". Once you have logged in to the new site, CHANGE THE ADMIN PASSWORD. To change the admin password, navigate to http://yoursite.com/?q=user/1/edit 5. ENJOY! No instructions needed. DRUPAL ADMINISTRATION --------------------- Use your administration panel to enable and configure services. For example: General Settings administer > site configuration > site information Enable Modules administer > site configuration > modules Set User Permissions administer > users management > access control Configure Themes administer > site building > themes For more information on configuration options, read the instructions which accompany the different configuration settings and consult the various help pages available in the administration panel. Community-contributed modules and themes are available at http://drupal.org/. CRON TASKS ------------------------- Many Drupal modules (such as the search functionality) have periodic tasks that must be triggered by a cron job. To activate these tasks, call the cron page by visiting http://www.example.com/cron.php --this will pass control to the modules and the modules will decide if and what they must do. Most systems support the crontab utility for scheduling tasks like this. The following example crontab line will activate the cron tasks automatically on the hour: 0 * * * * wget -O - -q http://www.example.com/cron.php More information about the cron scripts are available in the admin help pages and in the Drupal handbook at drupal.org. Example scripts can be found in the scripts/ directory. MORE INFORMATION ---------------- For platform specific configuration issues and other installation and administration assistance, please consult the Drupal handbook at http://drupal.org/handbook. You can view the wide range of other support options available at http://drupal.org/support.