More From This User
INSTALLing Drupal
How to install Drupal on your shiny server.
// $Id: INSTALL.txt,v 1.39 2007/01/08 11:59:16 dries Exp $CONTENTS OF THIS FILE---------------------* Changes* Requirements* Optional requirements* Installation* Drupal administration* Customizing your theme(s)* Multisite Configuration* More InformationCHANGES-------As of Drupal 5.0 installation has been automated by an install script. It is nolonger necessary to manually edit the "settings.php" file, and database tablesare created automatically.REQUIREMENTS------------Drupal requires a web server, PHP4 (4.3.3 or greater) or PHP5(http://www.php.net/) and either MySQL (http://www.mysql.com/) or PostgreSQL(http://www.postgresql.org/). The Apache web server and MySQL database arerecommended; other web server and database combinations such as IIS andPostgreSQL have been tested to a lesser extent. When using MySQL, version 4.1or greater is recommended to assure you can safely transfer the database.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 operatingsystems 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 RSSsyndication, you will need PHP's XML extension. This extension is enabled bydefault.- If you want support for clean URLs, you'll need mod_rewrite and the abilityto use local .htaccess files.INSTALLATION------------1. DOWNLOAD DRUPALYou can obtain the latest Drupal release from http://drupal.org/. The filesare in .tar.gz format and can be extracted using most compression tools. On atypical Unix command line, use:wget http://drupal.org/files/projects/drupal-x.x.tar.gz
tar -zxvf drupal-x.x.tar.gzThis will create a new directory drupal-x.x/ containing all Drupal filesand directories. Move the contents of that directory into a directory withinyour web server's document root or your public HTML directory:mv drupal-x.x/* drupal-x.x/.htaccess /var/www/html2. CREATE THE DRUPAL DATABASEDrupal requires access to a database in order to be installed. Your databaseuser will need sufficient privileges to run Drupal. Additional informationabout privileges, and instructions to create a database using the commandline 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 consultthe documentation or ask your webhost service provider.Take note of the username, password, database name and hostname as youcreate the database. You will enter these items in the install script.3. RUN THE INSTALL SCRIPTThe install script will set the base URL, connect Drupal to the database, andcreate 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 "DatabaseConfiguration" page.The install script will attempt to write-protect the settings.php afterupdating it with the information you provide in the installation routine.If you make manual changes to that file later, be sure to protect it againafter making your modifications. Failure to remove write permissions tothat file is a security risk. The default location for the settings.phpfile is at sites/default/settings.php, but it may be in another locationif you use the multi-site setup, as explained below.4. CONFIGURE DRUPALWhen the install script succeeds, you will be directed to the "Welcome" page.In "step one" click "create the first account" which will become the mainadministrator account with total control. Login as the administrator andcomplete the initial configuration steps on the "Welcome" page.Consider creating a "files" subdirectory in your Drupal installationdirectory. This subdirectory stores files such as custom logos, user avatars,and other media associated with your new site. The sub-directory requires"read and write" permission by the Drupal server process. You can changethe name of this subdirectory at "administer > site configuration > filesystem".5. CRON TASKSMany Drupal modules (such as the search functionality) have periodic tasksthat must be triggered by a cron job. To activate these tasks, call the cronpage 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. Thefollowing example crontab line will activate the cron tasks automatically onthe hour:0 * * * * wget -O - -q http://www.example.com/cron.phpMore information about the cron scripts are available in the admin help pagesand in the Drupal handbook at drupal.org. Example scripts can be found in thescripts/ directory.DRUPAL ADMINISTRATION---------------------A new installation of Drupal defaults to a very basic configuration with only afew active modules and minimal user access rights.Use your administration panel to enable and configure services. For example:General Settings administer > site configuration > site informationEnable Modules administer > site configuration > modulesSet User Permissions administer > users management > access controlConfigure Themes administer > site building > themesFor more information on configuration options, read the instructions whichaccompany the different configuration settings and consult the various helppages available in the administration panel.Community-contributed modules and themes are available at http://drupal.org/.CUSTOMIZING YOUR THEME(S)-------------------------Now that your installation is running, you will want to customize the look ofyour site. Several sample themes are included and more can be downloaded fromdrupal.org.Simple customization of your theme can be done using only CSS. Further changesrequire understanding the phptemplate engine that is now part of Drupal. Seehttp://drupal.org/handbook/customization to find out more.MULTISITE CONFIGURATION-----------------------A single Drupal installation can host several Drupal-powered sites, each withits own individual configuration.Additional site configurations are created in subdirectories within the 'sites'directory. Each subdirectory must have a 'settings.php' file which specifies theconfiguration settings. The easiest way to create additional sites is to copythe 'default' directory and modify the 'settings.php' file as appropriate. Thenew directory name is constructed from the site's URL. The configuration forwww.example.com could be in 'sites/example.com/settings.php' (note that 'www.'should be omitted if users can access your site at http://example.com/).Sites do not have to have a different domain. You can also use subdomains andsubdirectories for Drupal sites. For example, example.com, sub.example.com,
of 00
INSTALLing Drupal
How to install Drupal on your shiny server.
7,580 Reads
Info and Rating
| Category: | Uncategorized. |
| Rating: | (2 Ratings) |
| Upload Date: | 03/30/2007 |
| Copyright: | Attribution Non-commercial |
| Tags: |
Leave a Comment