Mercurial > defr > drupal > core

comparison INSTALL.txt @ 7:fff6d4c8c043 6.3

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Drupal 6.3
author Franck Deroche <webmaster@defr.org>
date Tue, 23 Dec 2008 14:30:28 +0100
parents c1f4ac30525a
children
comparison
equal deleted inserted replaced
6:2cfdc3c92142 7:fff6d4c8c043
1 // $Id: INSTALL.txt,v 1.61.2.2 2008/02/07 20:46:56 goba Exp $ 1 // $Id: INSTALL.txt,v 1.61.2.4 2008/07/09 19:15:59 goba Exp $
2 2
3 CONTENTS OF THIS FILE 3 CONTENTS OF THIS FILE
4 --------------------- 4 ---------------------
5 5
6 * Requirements 6 * Requirements
26 26
27 For detailed information on how to configure a test server environment using 27 For detailed information on how to configure a test server environment using
28 a variety of operating systems and web servers, see "Local server setup" 28 a variety of operating systems and web servers, see "Local server setup"
29 (http://drupal.org/node/157602) in the Drupal handbook. 29 (http://drupal.org/node/157602) in the Drupal handbook.
30 30
31 OPTIONAL REQUIREMENTS 31 OPTIONAL TASKS
32 --------------------- 32 --------------
33 33
34 - To use XML-based services such as the Blogger API and RSS syndication, 34 - To use XML-based services such as the Blogger API and RSS syndication,
35 you will need PHP's XML extension. This extension is enabled by default. 35 you will need PHP's XML extension. This extension is enabled by default.
36 36
37 - To use Drupal's "Clean URLs" feature on an Apache web server, you will need 37 - To use Drupal's "Clean URLs" feature on an Apache web server, you will need
72 other languages from the start. Check whether a released package of the 72 other languages from the start. Check whether a released package of the
73 language desired is available for this Drupal version at 73 language desired is available for this Drupal version at
74 http://drupal.org/project/translations and download the package. Extract 74 http://drupal.org/project/translations and download the package. Extract
75 the contents to the same directory where you extracted Drupal into. 75 the contents to the same directory where you extracted Drupal into.
76 76
77 2. GRANT WRITE PERMISSIONS ON CONFIGURATION FILE 77 2. CREATE THE CONFIGURATION FILE AND GRANT WRITE PERMISSIONS
78 78
79 Drupal comes with a default.settings.php file in the sites/default 79 Drupal comes with a default.settings.php file in the sites/default
80 directory. The installer will create a copy of this file filled with 80 directory. The installer uses this file as a template to create your
81 the details you provide through the install process, in the same 81 settings file using the details you provide through the install process.
82 directory. Give the web server write privileges to the sites/default 82 To avoid problems when upgrading, Drupal is not packaged with an actual
83 directory with the command (from the installation directory): 83 settings file. You must create a file named settings.php. You may do so
84 by making a copy of default.settings.php (or create an empty file with
85 this name in the same directory). For example, (from the installation
86 directory) make a copy of the default.settings.php file with the command:
87
88 cp sites/default/default.settings.php sites/default/settings.php
89
90 Next, give the web server write privileges to the sites/default/settings.php
91 file with the command (from the installation directory):
92
93 chmod o+w sites/default/settings.php
94
95 So that the files directory can be created automatically, give the web server
96 write privileges to the sites/default directory with the command (from the
97 installation directory):
84 98
85 chmod o+w sites/default 99 chmod o+w sites/default
86 100
87 3. CREATE THE DRUPAL DATABASE 101 3. CREATE THE DRUPAL DATABASE
88 102
115 to create the files directory and grant the web server write privileges to it: 129 to create the files directory and grant the web server write privileges to it:
116 130
117 mkdir sites/default/files 131 mkdir sites/default/files
118 chmod o+w sites/default/files 132 chmod o+w sites/default/files
119 133
120 The install script will attempt to write-protect the sites/default 134 The install script will attempt to write-protect the settings.php file and
121 directory after creating the settings.php file. If you make manual 135 the sites/default directory after saving your configuration. However, you
122 changes to that file later, be sure to protect it again after making 136 may need to manually write-protect them using the commands (from the
123 your modifications. Failure to remove write permissions to that file 137 installation directory):
124 is a security risk. Although the default location for the settings.php 138
139 chmod a-w sites/default/settings.php
140 chmod a-w sites/default
141
142 If you make manual changes to the file later, be sure to protect it again
143 after making your modifications. Failure to remove write permissions to that
144 file is a security risk. Although the default location for the settings.php
125 file is at sites/default/settings.php, it may be in another location 145 file is at sites/default/settings.php, it may be in another location
126 if you use the multi-site setup, as explained below. 146 if you use the multi-site setup, as explained below.
127 147
128 5. CONFIGURE DRUPAL 148 5. CONFIGURE DRUPAL
129 149
180 200
181 Changing the file system path after files have been uploaded may cause 201 Changing the file system path after files have been uploaded may cause
182 unexpected problems on an existing site. If you modify the file system path 202 unexpected problems on an existing site. If you modify the file system path
183 on an existing site, remember to copy all files from the original location 203 on an existing site, remember to copy all files from the original location
184 to the new location. 204 to the new location.
185 205
186 Some administrators suggest making the documentation files, especially 206 Some administrators suggest making the documentation files, especially
187 CHANGELOG.txt, non-readable so that the exact version of Drupal you are 207 CHANGELOG.txt, non-readable so that the exact version of Drupal you are
188 running is slightly more difficult to determine. If you wish to implement 208 running is slightly more difficult to determine. If you wish to implement
189 this optional security measure, use the following command from a shell or 209 this optional security measure, use the following command from a shell or
190 system prompt (while in the installation directory): 210 system prompt (while in the installation directory):