summaryrefslogtreecommitdiff
path: root/INSTALL.txt
diff options
context:
space:
mode:
authorDries Buytaert <dries@buytaert.net>2008-07-18 07:24:29 +0000
committerDries Buytaert <dries@buytaert.net>2008-07-18 07:24:29 +0000
commitd8aacc5de273da3b2d20ae8063bc8da4e57ae097 (patch)
tree667741f8f53b59fb0a94ec5f666ca0fde8eef8dc /INSTALL.txt
parent18cd9c79fc1cbf704741333740e267b800af0adf (diff)
downloadbrdo-d8aacc5de273da3b2d20ae8063bc8da4e57ae097.tar.gz
brdo-d8aacc5de273da3b2d20ae8063bc8da4e57ae097.tar.bz2
- Patch #225880 by pwolanin, webchick, keith.smith, et al: fixed non-writability of settings.php.
Diffstat (limited to 'INSTALL.txt')
-rw-r--r--INSTALL.txt40
1 files changed, 30 insertions, 10 deletions
diff --git a/INSTALL.txt b/INSTALL.txt
index ed91c08bf..1b4325e83 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -73,13 +73,27 @@ INSTALLATION
http://drupal.org/project/translations and download the package. Extract
the contents to the same directory where you extracted Drupal into.
-2. GRANT WRITE PERMISSIONS ON CONFIGURATION FILE
+2. CREATE THE CONFIGURATION FILE AND GRANT WRITE PERMISSIONS
Drupal comes with a default.settings.php file in the sites/default
- directory. The installer will create a copy of this file filled with
- the details you provide through the install process, in the same
- directory. Give the web server write privileges to the sites/default
- directory with the command (from the installation directory):
+ directory. The installer uses this file as a template to create your
+ settings file using the details you provide through the install process.
+ To avoid problems when upgrading, Drupal is not packaged with an actual
+ settings file. You must create a file named settings.php. You may do so
+ by making a copy of default.settings.php (or create an empty file with
+ this name in the same directory). For example, (from the installation
+ directory) make a copy of the default.settings.php file with the command:
+
+ cp sites/default/default.settings.php sites/default/settings.php
+
+ Next, give the web server write privileges to the sites/default/settings.php
+ file with the command (from the installation directory):
+
+ chmod o+w sites/default/settings.php
+
+ So that the files directory can be created automatically, give the web server
+ write privileges to the sites/default directory with the command (from the
+ installation directory):
chmod o+w sites/default
@@ -116,11 +130,17 @@ INSTALLATION
mkdir sites/default/files
chmod o+w sites/default/files
- The install script will attempt to write-protect the sites/default
- directory after creating the settings.php file. 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. Although the default location for the settings.php
+ The install script will attempt to write-protect the settings.php file and
+ the sites/default directory after saving your configuration. However, you
+ may need to manually write-protect them using the commands (from the
+ installation directory):
+
+ chmod a-w sites/default/settings.php
+ chmod a-w sites/default
+
+ If you make manual changes to the file later, be sure to protect it again
+ after making your modifications. Failure to remove write permissions to that
+ file is a security risk. Although the default location for the settings.php
file is at sites/default/settings.php, it may be in another location
if you use the multi-site setup, as explained below.