forked from Elgg/Elgg
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathINSTALL.txt
113 lines (75 loc) · 3.93 KB
/
INSTALL.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
The latest version of the installation instructions is available at:
[http://docs.elgg.org/wiki/Installation]
Installation Troubleshooting is available at:
[http://docs.elgg.org/wiki/Troubleshooting]
COOPFUNDING INSTALLATION INSTRUCTIONS
TECHNICAL REQUIREMENTS
Elgg runs on a combination of the Apache web server, MySQL database
system and the PHP interpreted scripting language. This is the most
popular web server environment in the world. (Coopfunding can also run on
other web servers such a nginx and IIS, but requires further configuration).
Due to Coopfunding's advanced functionality, there are some extra
configuration requirements:
* The Apache web server needs to be installed with the following
modules:
o mod_rewrite
o PHP
* MySQL 5+.
* PHP 5.2+ needs to be installed as an Apache module
with the following libraries:
o GD (for graphics processing such as avatar cropping)
o Multibyte String support (for internationalization)
It is recommended that you increase the memory available to PHP
threads beyond the standard 8 or 12M, and increase the maximum
uploaded filesize (which defaults to 2M). In both cases, this can be
found in your php.ini.
INSTALLING COOPFUNDING
Before you begin, make sure you have read Coopfunding's technical
requirements. If you discover problems after following these
instructions, check out the troubleshooting page at
[http://docs.elgg.org/wiki/Troubleshooting].
1. Upload Coopfunding
Unzip Coopfunding and upload it to your site's document root.
2. Create a data folder
Coopfunding needs a special folder to store uploaded files, including
profile icons and photos. You will need to create this for it.
We recommend that this folder is called data, and is stored outside
of your document root. For example, if Coopfunding is installed in
/home/coopfunding/html/, you might create it in /home/coopfunding/data.
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 you
cannot figure out what the ownership and permissions should be, you can
set the permissions for world access (though not recommended):
chmod 777 /home/coopfunding/data/
If you use a graphical client to upload files, you can usually set
this by right or shift-clicking on the folder and selecting
'properties'.
3. Create a database
Using your database administration tool of choice (if you're unsure
about this, ask your system administrator), create a new database for
Coopfunding. Make sure you know the username and password necessary to
access this.
4. Visit your Coopfunding site
Once you've performed these steps, visit your Coopfunding site in your web
browser. Coopfunding will take you through the rest of the installation
process from there.
A note on settings.php and .htaccess
The Coopfunding installer will try and create two files for you:
* engine/settings.php, which contains the database settings for
your installation
* .htaccess, which allows Coopfunding to generate dynamic URLs
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
Coopfunding and the engine directory and try again. Remember to change the
permissions back to the original values after installation is complete.
2. 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
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]