diff options
author | Dries Buytaert <dries@buytaert.net> | 2008-07-18 07:24:29 +0000 |
---|---|---|
committer | Dries Buytaert <dries@buytaert.net> | 2008-07-18 07:24:29 +0000 |
commit | d8aacc5de273da3b2d20ae8063bc8da4e57ae097 (patch) | |
tree | 667741f8f53b59fb0a94ec5f666ca0fde8eef8dc /INSTALL.txt | |
parent | 18cd9c79fc1cbf704741333740e267b800af0adf (diff) | |
download | brdo-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.txt | 40 |
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. |