README 3.97 KB
Newer Older
Nigel McNie committed
1 2 3
Mahara Readme
-------------

4 5 6 7 8 9 10 11 12 13 14
Thanks for downloading Mahara!

SUPPORT: The best ways of obtaining support are:

 * http://manual.mahara.org/ - the Mahara online manual
 * http://www.mahara.org/forums - the Mahara project forums
 * #mahara on freenode (IRC) - live chat with other users and developers

INSTALLATION:

To install, please follow the instructions here:
Nigel McNie committed
15

16
  https://wiki.mahara.org/System_Administrator%27s_Guide/Installing_Mahara
Nigel McNie committed
17

18 19
UPGRADING:

20
Mahara 15.04 supports direct upgrades from previous Mahara versions 1.1.0 and later.
21
To upgrade an existing Mahara installation, follow the instructions here:
22

23
  https://wiki.mahara.org/System_Administrator%27s_Guide/Upgrading_Mahara
24

25
SYSTEM REQUIREMENTS:
26

27 28 29 30
The system requirements for the most recent version of Mahara are here:

  https://wiki.mahara.org/index.php/System_Administrator%27s_Guide/Requirements

31
Mahara 15.04 requires:
32 33 34 35 36 37 38 39 40 41

 * Database:
 ** Postgres 8.3 or later
 ** or MySQL 5.1 or later

 * Web Server: Mahara is only officially supported on Apache 2 or later,
   although it will probably run in any web server with the proper PHP
   extensions.

 * PHP 5.3 or later, with the following extensions:
42
 ** curl
43 44
 ** gd (including Freetype support)
 ** json
45
 ** ldap
46 47 48
 ** libxml
 ** mbstring
 ** mcrypt
49 50 51 52 53
 ** mime_magic; or fileinfo
 ** pgsql; or mysqli; or mysql
 ** session
 ** SimpleXML
 ** bz2 (optional)
54
 ** imagick (optional)
55
 ** openssl and xmlrpc (optional; for networking support)
56
 ** zip (optional)
57
 ** zlib (optional)
58
 ** adodb (optional; improves performance)
59 60 61 62 63 64 65 66 67 68
 ** ... and ensure that the magic_quotes and register_globals settings are off.

 * OS: Mahara is only officially supported on Debian (5.0/"Lenny" or later) and
   Ubuntu (10.04/"Lucid Lynx" or later), however it will probably run in any
   OS with a suitable web server
 ** For zip/unzip support, the command-line "zip" and "unzip" utilities must
    be installed

 * Web Browser: Mahara should be accessible in any modern web browser with
   Javascript support. However, it is only actively tested in the most recent
69 70
   versions of Firefox, Chrome, Safari, and Opera; and the Microsoft-supported
   versions of Internet Explorer (IE). For Mahara 15.04, these versions are:
71 72 73 74
 ** Firefox - 24.0
 ** Chrome - 34.0
 ** Safari - 6.0
 ** Opera - 17.0
75 76 77 78 79
 ** IE - 11 and Edge

Mahara will still work with Internet Explorer 9 and 10, but we recommend to use a
supported version of Internet Explorer or a different browser to have all
functionality available as well as all necessary security updates for the browser.
Nigel McNie committed
80

81
TRANSLATIONS: You can get language packs from:
82

83
  https://wiki.mahara.org/Download_Mahara
84

85 86
MOODLE: Documentation on integrating Mahara with Moodle can be found in the
3.1MB PDF here:
87

88
  https://wiki.mahara.org/images/d/d5/Mahoodle.pdf
89 90

  -- the Mahara Development Team
91 92 93 94 95


Copyright notice
----------------

96
Copyright (C) 2006-2015 Catalyst IT and others; see:
97
https://wiki.mahara.org/index.php/Contributors
98 99 100

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
101
the Free Software Foundation, version 3 or later of the License.
102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Additional permission under GNU GPL version 3 section 7:

If you modify this program, or any covered work, by linking or
combining it with the OpenSSL project's OpenSSL library (or a
modified version of that library), containing parts covered by the
terms of the OpenSSL or SSLeay licenses, the Mahara copyright holders
grant you additional permission to convey the resulting work.
Corresponding Source for a non-source form of such a combination
shall include the source code for the parts of OpenSSL used as well
as that of the covered work.