aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorcash <cash@36083f99-b078-4883-b0ff-0f9b5a30f544>2010-02-03 12:52:15 +0000
committercash <cash@36083f99-b078-4883-b0ff-0f9b5a30f544>2010-02-03 12:52:15 +0000
commit77882dbadc7782e5d1269a075ea1f0e64ae2daa5 (patch)
treebb86dbc193aae85f3829d3f3cc383391e1bae406
parent0161af3ec3653bb006c81f2467674a32d10786a2 (diff)
downloadelgg-77882dbadc7782e5d1269a075ea1f0e64ae2daa5.tar.gz
elgg-77882dbadc7782e5d1269a075ea1f0e64ae2daa5.tar.bz2
updated install instructions to encourage more use of the wiki instructions/troubleshooting and discourage setting data directory to 777 as default
git-svn-id: http://code.elgg.org/elgg/trunk@3900 36083f99-b078-4883-b0ff-0f9b5a30f544
-rw-r--r--INSTALL.txt41
1 files changed, 29 insertions, 12 deletions
diff --git a/INSTALL.txt b/INSTALL.txt
index 0d4ca80a3..2e84d76bd 100644
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -1,3 +1,9 @@
+The latest version of this document is available at:
+[http://docs.elgg.org/wiki/Installation]
+
+Installation Troubleshooting is available at:
+[http://docs.elgg.org/wiki/Troubleshooting]
+
ELGG INSTALLATION INSTRUCTIONS
@@ -55,10 +61,13 @@ We recommend that this folder is called data, and is stored outside
of your document root. For example, if Elgg is installed in
/home/elgg/html/, you might create it in /home/elgg/data.
-Once this folder has been created, you'll need to make sure Elgg has
-permission to write to it. This shouldn't be a problem on Windows-
-based servers, but if your server runs Linux or a UNIX variant,
-you'll need to type something like:
+Once this folder has been created, you'll need to make sure that your
+web server has permission to write to it. This shouldn't be a problem
+on Windows-based servers, but if your server runs Linux or a UNIX variant,
+you'll need to figure out what user Apache runs under. For Debian-based
+distros, it is usually www-data and for RedHat, it is often apache. If
+cannot figure out what the ownership and permissions should be, you can
+set the permissions for world access (though not recommended):
chmod 777 /home/elgg/data/
@@ -98,7 +107,8 @@ Once you've performed these steps, visit your Elgg site in your web
browser. Elgg will take you through the rest of the installation
process from there.
-A note on settings and .htaccess
+
+A note on settings.php and .htaccess
The Elgg installer will try and create two files for you:
@@ -106,15 +116,22 @@ The Elgg installer will try and create two files for you:
your installation
* .htaccess, which allows Elgg to generate dynamic URLs
-If these files can't be automatically generated, for example because
-you don't have the correct directory permissions, Elgg will tell you
-how to create them. If, for some reason, this won't work, you will
-need to:
+If your web server does not have permission to create these files, you
+will need to either
+
+1. Change the permissions on the directory where you are installing
+ Elgg and the engine directory and try again.
+
+2. Follow the instructions that Elgg gives you to create them.
+
+3. Copy engine/settings.example.php to engine/settings.php, open
+ it up in a text editor and fill in your database details. Then
+ copy /htaccess_dist to /.htaccess
- * Copy engine/settings.example.php to engine/settings.php, open
- it up in a text editor and fill in your database details
- * Copy /htaccess_dist to /.htaccess
The latest version of this document is available at:
[http://docs.elgg.org/wiki/Installation]
+
+Installation Troubleshooting is available at:
+[http://docs.elgg.org/wiki/Troubleshooting]