安装 Moodle:修订间差异

来自MoodleDocs
跳转至:导航、​搜索
 
(未显示2个用户的13个中间版本)
第1行: 第1行:
{{Template:Installing Moodle}}
{{Template:Installing Moodle}}
''This page explains how to install Moodle. If you are an expert and/or in a hurry try [[Installation Quickstart]].''
'' 这个页面解释了如何进行 Moodle 的安装,如果你是技术高手或者有相当的技术经验,请参看页面 [[ 快速安装 Moodle 指南]] ''


If you just want to try Moodle on a standalone machine there are 'one-click' installers for Windows (see [[Complete install packages for Windows]]) and for OSX (see [[Complete Install Packages for Mac OS X]]). These are unsuitable for production servers.
如果你希望在独立机器上运行 Moodle ,Moodle 提供了一键安装程序,请参看 [[Windows 完整程序安装包]] [[Mac OS X 完整程序安装包]] 。请注意上面 2 个安装包并不适用服务器上安装的情况。


==需求 ==
==需求 ==
Moodle主要是在Linux上使用[[Apache]]、[[MySQL]]及[[PHP]] 开发(有時也被 称为LAMP 平台)。
Moodle主要是在Linux上使用[[Apache]]、[[MySQL]]及[[PHP]] 開發(有時也被 稱為LAMP 平台)。


 如果你 怀 疑 LAMP 平台的安全性,LAMP 其 是目前最安全和最流行的 合。
 如果你 疑 LAMP 平台的安全性,LAMP 其 是目前最安全和最流行的 合。


 同 也有其他的一些 选择 - 查看下面 接中的 件部分:
 同 也有其他的一些 選擇 - 查看下面 接中的 件部分:


Moodle 安 的基本需求如下:
Moodle 安 的基本需求如下:


=== 硬件 === 
=== 硬件 === 
* 磁 :160MB 是程序安 的最小空 。你也可能需要存 你自己的 料的 ,5GB 实际 使用空 基本上 用了。
* 磁 :160MB 是程序安 的最小空 。你也可能需要存 你自己的 料的 ,5GB 的實際 使用空 基本上 用了。
* 份空 :至少 实际运 行的程序和 数据 相同的存 ,如果能 够进 份,那就更加理想。
* 份空 :至少 實際運 行的程序和 數據 相同的存 ,如果能 夠進 份,那就更加理想。
存:256MB 的 最小 存, 烈建 使 用 1GB 以上 。Moodle 的基本使用情 是: 1G 的 存能 持 10 到 20 的'' 并发''用 。但是 这个 你的系 硬件和 件配置有很大的 关系 。 ' 并发'的意思 器同 存中 理的能力,例如用 在某一 个时间点内与 统进 行交互,而不是指登 的用 户数 量。
存:256MB 的 最小 存, 烈建 使 用1GB 以上 。 Moodle 的基本使用情 是: 1G 的 存能 持10 到20 的'' 並發''用 。但是 這個 你的系 硬件和 件配置有很大的 關係 。 ' 並發'的意思 器同 存中 理的能力,例如用 在某一 個時間點內與 統進 行交互,而不是指登 的用 戶數 量。


===  件===
===  件===
* 操作系 (!).通常用 于运 行下面的 软软 件, 选择 么样 的操作系 通常根 你的技 能力和 实际 况来决 。Linux 和 Windows 是最常 选择 (同 也有很好的技 支持)。如果你可以自由 选择 操作系 ,Linux 是最佳的方案。 Moodle  测试了 Debian, Ubuntu, CentOS, RedHat, Windows 7/2012  和 Mac OS X 的兼容性。
* 操作系 (!).通常用 於運 行下面的 軟軟 件, 選擇 麼樣 的操作系 通常根 你的技 能力和 實際 況來決 。 Linux 和Windows 是最常 選擇 (同 也有很好的技 支持)。 如果你可以自由 選擇 操作系 ,Linux 是最佳的方案。 Moodle  測試了Debian, Ubuntu, CentOS, RedHat, Windows 7/2012  和Mac OS X 的兼容性。
* Web 服 器, 主要使用[[Apache]] 。Moodle 有完全 测试 (或者支持)[[IIS]],[http://www.lighttpd.net/ lightttpd],[http://nginx.org/ nginx],[http://www.cherokee-project.com/ cherokee], zeus 和 [http://litespeedtech.com/ LiteSpeed],但 是 Moodle 应该 在上面的服 器上正常工作。除此之外,如果你 选择 使用其 他 WEB 器的 ,Moodle  将会终 止安 装过 程。同 你的服 器也配置 PHP 。WEB 器使用什 版本 不重要,但是 请尽 量使用最新版。
*Web 服 器, 主要使用[[Apache]] 。 Moodle 有完全 測試 (或者支持)[[IIS]],[http://www.lighttpd.net/ lightttpd],[http://nginx.org/ nginx],[http://www.cherokee-project .com/ cherokee], zeus 和[http://litespeedtech.com/ LiteSpeed ​​],但 是Moodle 應該 在上面的服 器上正常工作。除此之外,如果你 選擇 使用其 他WEB 器的 ,Moodle  將會終 止安 裝過 程。同 你的服 器也配置 PHP 。 WEB 器使用什 版本 不重要,但是 請盡 量使用最新版。
* [[PHP]] -  前的最低版本是5.3.3。你需要 的 PHP 一系列 展,[[PHP]]  面列出了所有需要安 展。如果一些必 失的 ,安 程序 在安 装环 境校 候提示您修 复并 阻止您 入下一步。
* [[PHP]] -  前的最低版本是5.3.3。你需要 的PHP 一系列 展,[[PHP]]  面列出了所有需要安 展。如果一些必 失的 ,安 程序 在安 裝環 境校 候提示您修 復並 阻止您 入下一步。
数据库。MySQL 和 PostgreSQL 是主要使用的 开发数据库 这2个数据库进 行了主要的兼容性 测试 ,相 的技 也是最全面的 。Oracle 和 MSSQL 都能 被完全的支持(注意,一些可 的插件可能 有在 这 2 个数据库 行兼容性 测试 ),但是相 的文 与 Moodle 的文件 没有 MySQL/PostgreSQL  这么 全面 。MySQL 能提供更多的文 ,PostgreSQL 能提供更好的 定性。你需要在系 中安 装 PHP 支持你 选择 数据库
數據庫。 MySQL 和PostgreSQL 是主要使用的 開發數據庫 這2個數據庫進 行了主要的兼容性 測試 ,相 的技 也是最全面的 。 Oracle 和MSSQL 都能 被完全的支持(注意,一些可 的插件可能 有在 這2 個數據庫 行兼容性 測試 ),但是相 的文 與Moodle 的文件 沒有MySQL/PostgreSQL  這麼 全面 。 MySQL 能提供更多的文 ,PostgreSQL 能提供更好的 定性。你需要在系 中安 裝PHP 支持你 選擇 數據庫
** [[MySQL]] - 最低版本 5.1.33
** [[MySQL]] - 最低版本 5.1.33
** [[MariaDB]] - 最低版本 5.3.5
** [[MariaDB]] - 最低版本 5.3.5
第28行: 第28行:
** [[MSSQL]] - 最低版本 9.0
** [[MSSQL]] - 最低版本 9.0
** [[Oracle]] - 最低版本 10.2
** [[Oracle]] - 最低版本 10.2
访问 Moodle 使用的 浏览 器最低版本要求 :Firefox 4, Internet Explorer 8, Safari 5, Google Chrome 11, Opera 9
訪問Moodle 使用的 瀏覽 器最低版本要求 :Firefox 4, Internet Explorer 8, Safari 5, Google Chrome 11, Opera 9


== 配置你的服 器 ==
== 配置你的服 器 ==


 如果你希望 评估 Moodle ,你也可以在桌面 中安 装 Moodle
 如果你希望 評估Moodle ,你也可以在桌面 中安 裝Moodle


 有很多方法 你的服 件, 这个 选择 器的不同而不同。一些 接和指向 在 [[安 AMP]] 中。
 有很多方法 你的服 件, 這個 選擇 器的不同而不同。一些 接和指向 在 [[安 AMP]] 中。


 如果你使用 虚拟 器,服 器需要的一些 应该 经帮 你安 好了。尤其是在共享服 器上,你需要知道如何修 改 PHP 的配置,例如如何修改最大上 文件大小限制。
 如果你使用 虛擬 器,服 器需要的一些 應該 經幫 你安 好了。尤其是在共享服 器上,你需要知道如何修 改PHP 的配置,例如如何修改最大上 文件大小限制。


 不同服 器的配置可能有非常大的不同。
 不同服 器的配置可能有非常大的不同。


== 下 和拷 你的文件到正 位置 ==
== 下 和拷 你的文件到正 位置 ==


'''重要: 有很多地方可以 获得 Moodle 的源代 ,但是我 到 Moodle 的官方 网站 moodle.org 上去下 源代 。如果你遇到任何 问题 ,你通常能 够获 得更好的支持。'''
'''重要: 有很多地方可以 獲得Moodle 的源代 ,但是我 到Moodle 的官方 網站moodle.org 上去下 源代 。如果你遇到任何 問題 ,你通常能 夠獲 得更好的支持。 '''


 你有 2  个选择
 你有 2  個選擇
从 http://moodle.org/downloads  站上下 你需要的版本,然 ...
從http://moodle.org/downloads  站上下 你需要的版本,然 ...
* '''或者'''  从  Git 码仓库 中直接下 源代 (推 荐开发 使用 这个 方式, 这个 方式 你更新程序更加 简单 ):
* '''或者'''  從Git 碼倉庫 中直接下 源代 (推 薦開發 使用 這個 方式, 這個 方式 你更新程序更加 簡單 ):
<pre>
<pre>
$ git clone -b MOODLE_25_STABLE git://git.moodle.org/moodle.git 
$ git clone -b MOODLE_25_STABLE git://git.moodle.org/moodle.git 
</pre>
</pre>
... 这个过 将会 换到 Moodle 的 2.5  定分支(最新的每 周构 建), 且拷 完整 的 Moodle 码仓库 多 GIT 问题请参 面[[Git for Administrators]]。
... 這個過 將會 換到Moodle 的2.5  定分支(最新的每 週構 建), 且拷 完整 的Moodle 碼倉庫 。更 多GIT 問題請參 面[[Git for Administrators]]。


 不管你 用何 方式, 你完全 获得 Moodle ,你 应该 在你的 器或者服 器上看到一 叫'''moodle'''的目 这个 中有一系列的文件和目
 不管你 用何 方式, 你完全 獲得Moodle ,你 應該 在你的 器或者服 器上看到一 叫'''moodle'''的目 這個 中有一系列的文件和目


 你可以 个 Moodle 你 Web 器的文 下,在 这种 下你的 访问 地址 :'''<nowiki>http://yourwebserver.com/moodle</nowiki>'''。
 你可以 個Moodle 你Web 器的文 下,在 這種 下你的 訪問 地址 :'''<nowiki>http://yourwebserver.com/moodle</nowiki>'''


 或者你也可以直接拷 贝 Moodle 中的 容到你 的 Web 器文 下, 这样 你的 访问网 址就 得更加 '''<nowiki>http://yourwebserver.com</nowiki>'''。
 或者你也可以直接拷 貝Moodle 中的 容到你 的Web 器文 下, 這樣 你的 訪問網 址就 得更加 '''<nowiki>http://yourwebserver.com</nowiki>'''


  你不太明白的 候, 查看你 系统 和WEB服 器的相 。 
  你不太明白的 候, 查看你 係統 和WEB服 器的相


:''小提示:'' 如果你下 载 Moodle 程序到你本地 上然 到你的服 器上的 请尽 量上 传压缩 文件到服 器上解 查你的文件'文件管理器')。如果你 用的 是 FTP 传当个 文件, 注意查 看 FTP 的日 ,可能有部分文件在上 失。
:''小提示:'' 如果你下 載Moodle 程序到你本地 上然 到你的服 器上的 請盡 量上 傳壓縮 文件到服 器上解 查你的文件'文件管理器')。如果你 用的 是FTP 傳當個 文件, 注意查 看FTP 的日 ,可能有部分文件在上 失。


* '''保 护 Moodle 文件:''' 保 护 Moodle 程序文件不可以 被 WEB 器的用 户随 意更改是非常重要的。例如 在  Unix/Linux 操作系 下(使 用 root 行下面的命令:
* '''保 護Moodle 文件:''' 保 護Moodle 程序文件不可以 被WEB 器的用 戶隨 意更改是非常重要的。例如 在Unix/Linux 操作系 下(使 用root 行下面的命令:
<pre>
<pre>
# chown -R root /path/to/moodle
# chown -R root /path/to/moodle
# chmod -R 0755 /path/to/moodle
# chmod -R 0755 /path/to/moodle
</pre>
</pre>
 (文件的所有 权为 administrator/superuser 用 ,也只 有 administrator/superuser 用 限,但是其他用 是可以 的)
 (文件的所有 權為administrator/superuser 用 ,也只 有administrator/superuser 用 限,但是其他用 是可以 的)


==  建空 数据库 ==
==  建空 數據庫 ==


 下一步需要 为你 Moodle 装实 建一 新的空 数据库 。你需要 的 Moodle 装实 例找到或者 置下面的信息:nformation for use during the final installation stage:
 下一步需要 為你Moodle 裝實 建一 新的空 數據庫 。你需要 的Moodle 裝實 例找到或者 置下面的信息:nformation for use during the final installation stage:
* '''dbhost''' -  数据库 的服 器地址。很有可能是''localhost''如果 的 Web 器和 数据库 器在同一台 器上,否 你需要在 这里设 数据库 器的名
* '''dbhost''' -  數據庫 的服 器地址。很有可能是''localhost''如果 的Web 器和 數據庫 器在同一台 器上,否 你需要在 這裡設 數據庫 器的名
* '''dbname''' -  数据库 ,你 建的 数据库 的名 ,比如 ''moodle'' 
* '''dbname''' -  數據庫 ,你 建的 數據庫 的名 ,比如''moodle''
* '''dbuser''' -  数据库 ,能 够访问 Moodle 数据库 数据库 名。不要使用 root 和超 账号 建一 个账号 ,只 这个账号 所需要的最低 限就可以
* '''dbuser''' -  數據庫 ,能 夠訪問Moodle 數據庫 數據庫 名。不要使用 root 和超 賬號 建一 個賬號 ,只 這個賬號 所需要的最低 限就可以
* '''dbpass''' -  数据库 使用的密
* '''dbpass''' -  數據庫 使用的密


 如果你 的 Moodle 使用的是 虚拟 ,你可以通 过网页 工具 访问 的配置信息,如果你不知道如何配置, 请询问 你的系 管理 。更多 详细 信息,可以通 过单击 下面的 数据库 类来获 得:
 如果你 的Moodle 使用的是 虛擬 ,你可以通 過網頁 工具 訪問 的配置信息,如果你不知道如何配置, 請詢問 你的系 管理 。更多 詳細 信息,可以通 過單擊 下面的 數據庫 類來獲 得:
* [[MySQL]]
* [[MySQL]]
* [[PostgreSQL]]
* [[PostgreSQL]]
第83行: 第83行:
* [[Oracle]]
* [[Oracle]]


==  建(''moodledata'')  数据 ==
==  建(''moodledata'')  數據 ==


Moodle 需要一 录来 所有的文件,包括系 的文件, 临时数据 会话数据 等。
Moodle 需要一 錄來 所有的文件,包括系 的文件, 臨時數據 會話數據 等。


Web 服 器需要 这个 具有 限。在大型 的 Moodle 装实 例中, 这个 越大越好。
Web 服 器需要 這個 具有 限。在大型 的Moodle 裝實 例中, 這個 越大越好。


'''重要::'''  这个 一定不要放置 在 Web 器下, 话说 这个 不能通 过网页访问 到。如果 网页 访问 这个 将会导 致非常 重的安全漏洞。如果你使用的 是 Linux 操作系 ,也 不要 将这个 放置 到 root 账号 下和你 的 Moodle 程序文件目 。Moodle 在安 将会进 行校 ,如 果 Moodle 发现 了文件, 将会 阻止安 装继续进 行。
'''重要::'''  這個 一定不要放置 在Web 器下, 話說 這個 不能通 過網頁訪問 到。如果 網頁 訪問 這個 將會導 致非常 重的安全漏洞。如果你使用的 是Linux 操作系 ,也 不要 將這個 放置 到root 賬號 下和你 的Moodle 程序文件目 。 Moodle 在安 將會進 行校 ,如 果Moodle 發現 了文件, 將會 阻止安 裝繼續進 行。


  这里 是一 个Unix/Linux 的配置示例,在 建此目 候需要 '''所有人'''都可以 访问 这种 是因 为 Moodle 器不是共享服 器。 你的服 器管理 取得 联系来确 定何 种访问权 限更加合 ,同 也需 要 Web 器用 可以 访问 些文件。
  這裡 是一 個Unix/Linux 的配 ​​ 置示例,在 建此目 候需要 '''所有人'''都 ​​ 可以 訪問 這種 是因 為Moodle 器不是共享服 器。 你的服 器管理 取得 聯繫來確 定何 種訪問權 限更加合 ,同 也需 要Web 器用 可以 訪問 些文件。
<pre>
<pre>
# mkdir /path/to/moodledata
# mkdir /path/to/moodledata
第97行: 第97行:
</pre>
</pre>


 如果你的服 器能 持 ACL ,推 荐采 用下面的授 方式,例如你 的 Apache 器用 户 www-data:
 如果你的服 器能 持ACL ,推 薦採 用下面的授 方式,例如你 的Apache 器用 戶www-data:
<pre>
<pre>
# chmod -R +a "www-data allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
# chmod -R +a "www-data allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
</pre>
</pre>
 如果你 计划从 命令行中 执行 PHP 本,你需要 为当 前用 户设 置同 限:
 如果你 計劃從 命令行中 執行PHP 本,你需要 為當 前用 戶設 置同 限:
<pre>
<pre>
$ sudo chmod -R +a "`whoami` allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
$ sudo chmod -R +a "`whoami` allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata
第108行: 第108行:
==== Web 目录中配置 moodledata 安全性 ====
==== Web 目录中配置 moodledata 安全性 ====


 如果你使用的是 虚拟 配置的 站,你 法配置 'moodledata'的安全性。你也 可以在'moodledata'目 中使用 .htaccess 文件 控制 访问权 限。 这种 不是 所有系 都是有效的, 你的 虚拟 管理 取得 联系 求他 助。
 如果你使用的是 虛擬 配置的 站,你 法配置'moodledata'的安全性。你也 可以在'moodledata'目 中使用.htaccess 文件 控制 訪問權 限。 這種 不是 所有系 都是有效的, 你的 虛擬 管理 取得 聯繫 求他 助。


  建的文件叫做 .htaccess, 这个 文件只需要有下面的 容就可以了:
  建的文件叫做.htaccess, 這個 文件只需要有下面的 容就可以了:
<pre>
<pre>
order deny,allow
order deny,allow
第133行: 第133行:
# chown -R root /path/to/moodle
# chown -R root /path/to/moodle
</pre>
</pre>
  你可能需要被询问到一些 页中没 讨论到 其他设置,如果你也不十分确定配置的信息 ,请 单击确定 使用 默认配置就可以了。
chowns 命令允许脚 写入新文件 config.php file。更多 关脚本 使用 ,请使用 下面的命令:
<pre>
<pre>
# php install.php --help
# php install.php --help
</pre>
</pre>


You will be asked for other settings that have not been discussed on this page - if unsure just accept the defaults. For a full discussion see [[Administration via command line]]
你可能需要被询问到一些本页中没有讨论到的其他设置,如果你也不十分确定配置的信息,请单击确定使用默认配置就可以了。
 
完整版本,请查看 [[Administration via command line]]
 
=== 基于网页安装工具 ===
使用你的网页浏览器导航到你的 Moodle 网站主页面就可以使用 Web 方式运行安装脚本了。
 
安装进程将会使用一些页面来完成安装进程。你会被要求同意许可协议,查看数据库中被创建的表,提供管理账号信息和网站的细节信息。
 
数据库的创建将会需要一些时间,这里请耐心等待。


=== Web based installer ===
当数据库创建完成后,你将会看到 Moodle 的前台和后台界面。这时候,你可以使用 Moodle 提供的界面创建一个新的用户。
To run the web installer script, just go to your Moodle's main URL using a web browser.


The installation process will take you through a number of pages. You should be asked to confirm the copyright, see the database tables being created, supply administrator account details and supply the site details. The database creation can take some time - please be patient. You should eventually end up at the Moodle front page with an invitation to create a new course.
很多时候,你需要下载新的 config.php 文件然后到上传到你的 Moodle 安装实例中,请参照屏幕的提示。


It is very likely that you will be asked to download the new config.php file and upload it to your Moodle installation - just follow the on-screen instructions.
== 最终配置 ==


==Final configuration==
=== Moodle 的内部设置 ===
在 Moodle 站点管理员界面中有一系列的配置页面(可以从'设置' 块中访问 '网站管理'区)。


=== Settings within Moodle ===
这里有一些重要的系统设置,你需要进行检查。
There are a number of options within the Moodle Site Administration screens (accessible from the 'Site administration' tab in the 'Settings' block. Here are a few of the more important ones that you will probably want to check:
* '' 设置> 网站管理 > 插件> 消息输出 > 邮件'' :配置你自己的 SMTP 邮件服务器和授权信息,这样你的 Moodle 安装实例可以向外发送电子邮件。Moodle 网站的支持人员也可以设置这个界面。
* ''Settings > Site administration > Plugins > Message Outputs > Email'': Set your smtp server and authentication if required (so your Moodle site can send emails). The support contact for your site is also set on this page.
* '' 设置> 网站管理 > 服务器 > 系统路径'' : 设置你系统的 du, dot aspell 执行文件的路径。
* ''Settings > Site administration > Server > System paths'': Set the paths to du, dot and aspell binaries.
* '' 设置> 网站管理 > 服务器 > HTTP'' :如果你的服务器运行在防火墙后,你可能需要在 'Web 代理' 块配置你的代理服务器。
* ''Settings > Site administration > Server > HTTP'': If you are behind a firewall you may need to set your proxy credentials in the 'Web proxy' section.
* '' 设置> 网站管理 > 区域 > 更新时区'' :运行这个可以将你配置的时区信息写入到系统中。
* ''Settings > Site administration > Location > Update timezones'': Run this to make sure your timezone information is up to date.


=== Remaining tasks ===
=== 余下的任务 ===


* '''Configure Cron''': Moodle's background tasks (e.g. sending out forum emails and performing course backups) are performed by a script which you can set to execute at specific times of the day. This is known as a cron script. Please refer to the [[Cron|Cron instructions]].
* ''' 配置定时任务''': Moodle 的后台任务,比如社区外发电子邮件和进行课程备份时通过脚本来执行的,你可以设置你的脚本执行时间和间隔。这个就是我们常说的定时任务,请参看[[Moodle 定时任务指南]]
* '''Set up backups''': See [[Site backup]] and [[Automated course backup]].
* ''' 配置备份''' :查看 [[Moodle 站点备份]] [[Moodle 自动课程备份]].
* '''Check mail works''': [[Add a new user|Create a test user]] with a valid email address and [[message|send them a message]]. Do they receive an email copy of the message? If not, check the settings in ''Settings > Site administration > Plugins > Message outputs > Email''. Don't be tempted to skip this step (clue: email is used to recover lost passwords, including the administrator password when you forget it!)
* ''' 检查邮件能否正常工作''' :使用一个有效的电子邮件地址在你的 Moodle 安装实例中[[Moodle 添加用户 | 添加测试用户]] 。查看这个用户能否正常的接收到系统发出的电子邮件。如果不能,请查看电子邮件的配置。电子邮件的配置信息位于 [ 设置> 网站管理 > 插件> 消息输出 > 邮件]。请在系统正常运行前,确保电子邮件功能是能够正常使用的,因为系统是通过电子邮件功能向用户提供找回密码服务的。如果你是系统管理员,但是你也忘记了密码,你需要用电子邮件功能来找回你的密码。
* '''Secure your Moodle site''': Read the [[Security recommendations]].
* ''' 增强 Moodle 网站安全性''': 请阅读 [[Security recommendations]] 的相关内容。


=== Installation is complete :) ===
=== 安装已经完成了 :) ===


* Create a new course: You can now [[Adding a new course|create a new course]] and have a play ;-)
* 创建新的课程:现在你可以开始 [[Adding a new course| 创建一个新的课程]] ;-)


=== If something goes wrong... ===
=== 如果安装的时候出现错误了... ===


Here are some things you should try...
你可以尝试下面的一些操作...


* Check the [[Installation FAQ]]
* 参考 [[Installation FAQ]]
* Check your file permissions carefully. Can your web server read (but not write) the Moodle program files? Can your web server read and write your Moodle data directory?
* 小心检查你的文件权限。你的操作系统运行用户能否正常读取(不是写入)Moodle 程序文件?你的操作系统运行用户能否正常读取和写入 Moodle 的数据目录:
* Check your database permissions. Have you set up your database user with the correct rights and permissions for your configuration (especially if the web server and database server are different machines)?
* 检查你的数据库权限。你的数据库用户是否已经具有了正常的数据库操作权限,当数据库和程序运行在不同服务器上的时候尤其需要注意这种情况。
* If you are having trouble creating a [[Configuration file]] (config.php), you can do it manually by copying config-dist.php (in the root of the Moodle program directory) to config.php, editing it and setting your database/site options there. Installation will continue from the right place.
* 当你的 Moodle 安装程序不能创建(config.php) [[Moodle 配置文件]] ,你可以手动拷贝 config-dist.php 文件为 config.php,然后再尝试编辑文件中有关数据库的配置信息部分。config-dist.php Moodle 安装程序的根目录下。安装程序便可以继续进行了。
* Once you have a config.php (see previous tip) you can edit it to turn on debugging (in section 8). This may give you extra information to help track down a problem. If you have access, check your web server error log(s).
* 当你已经有了 config.php 文件,你可以编辑这个文件来让 Moodle 程序输出调试信息。 Moodle 程序输出的调试信息可以向你提供更加详细的程序运行状态,以便于你查找问题在哪里。如果你具有服务器的访问权限,你也可以查看 Web 服务器的错误信息。
* Re-check your php.ini / .htaccess settings. Are they appropriate (e.g. memory_limit), did you edit the correct php.ini / .htaccess file and (if required) did you re-start the web server after making changes?
* 重新检查 php.ini / .htaccess 文件的设置。这里有些技术参数可能需要修改,比如 memory_limit ,你是否已经调整了 php.ini / .htaccess 文件的技术参数设置?记住,每次调整后需要重启服务器使设置生效。
* Did you include any non-core (optional) plugins, themes or other code before starting the installation script? If so, remove it and try again (it may be broken or incompatible).
* 在你进行系统安装之前,你是否选择了任何非核心插件,主题和代码?如果你已经选择了,请移除这些配置然后重试,这是因为有些插件可能存在错误或者不兼容的情况。
* Explain your problem in the [http://moodle.org/mod/forum/view.php?id=28 Installation problems forum]. '''PLEASE''' list your software versions; explain what you did, what happened and what error messages you saw (if any); explain what you tried. There is no such thing as 'nothing', even a blank page is something!
* 提交你的问题到[http://moodle.org/mod/forum/view.php?id=28 Moodle 安装问题] ''' ''' 列出你当前运行的软件版本,解释你是怎么进行安装的,发生了什么情况,你看见了什么样的错误信息,你进行了怎样的尝试。尽管系统有可能出现白屏,但是这不是没有原因的,请尽量找到错误信息。
* 你也可以提交问题到 OSS 计算技术 [[http://www.ossez.com/forum-54-1.html http://www.ossez.com/forum-54-1.html]]的 Moodle 相关板块,在这里我们将会向你提供中文帮助。


== Platform specific instructions ==
== 特定平台的安装 ==


'''Note:''' Much of this information is provided by the community. It may not have been checked and may be out of date. Please read in conjunction with the above installation instructions.
''' 注意''' 通常社区能够提供更多的相关信息。下面的内容可能没有经过验证,也有可能已经过时了,请结合上面的内容一同阅读。


* [[Windows installation]]
* [[Windows installation]]

2014年10月1日 (三) 06:56的最新版本

这个页面解释了如何进行 Moodle 的安装,如果你是技术高手或者有相当的技术经验,请参看页面 快速安装 Moodle 指南

如果你希望在独立机器上运行 Moodle,Moodle 提供了一键安装程序,请参看 Windows 完整程序安装包Mac OS X 完整程序安装包。请注意上面 2 个安装包并不适用服务器上安装的情况。

需求

Moodle主要是在Linux上使用ApacheMySQLPHP开发(有时也被称为LAMP平台)。

如果你怀疑 LAMP 平台的安全性,LAMP 其实是目前最安全和最流行的组合。

同时也有其他的一些选择 - 查看下面链接中的软件部分:

Moodle 安装的基本需求如下:

硬件

  • 磁盘空间:160MB 是程序安装的最小空闲磁盘空间。你也可能需要存储你自己的资料的话,5GB的实际使用空间基本上够用了。
  • 备份空间:至少与你实际运行的程序和数据相同的存储空间,如果能够进行远程备份,那就更加理想。
  • 内存:256MB 的内存为最小内存,强烈建议使用1GB 以上内存。 Moodle 的基本使用情况是: 1G 的内存能够支持10 到20 个的并发用户。但是这个也与你的系统硬件和软件配置有很大的关系。 '并发'的意思为服务器同时在内存中处理的能力,例如用户在某一个时间点内与系统进行交互,而不是指登录系统的用户数量。

软件

  • 操作系统(!).通常用于运行下面的软软件,选择什么样的操作系统通常根据你的技术能力和实际情况来决定。 Linux 和Windows 是最常见的选择(同时也有很好的技术支持)。 如果你可以自由选择操作系统的话,Linux 是最佳的方案。 Moodle 测试了Debian, Ubuntu, CentOS, RedHat, Windows 7/2012 和Mac OS X 的兼容性。
  • Web 服务器, 主要使用Apache。 Moodle 没有完全测试(或者支持)IISlightttpdnginx.com/ cherokee, zeus 和LiteSpeed​​,但是Moodle 应该能够在上面的服务器上正常工作。除此之外,如果你选择使用其他WEB 服务器的话,Moodle 将会终止安装过程。同时你的服务器也配置 PHP。 WEB 服务器使用什么版本并不重要,但是请尽量使用最新版。
  • PHP - 当前的最低版本是5.3.3。你需要为你的PHP 安装一系列扩展,PHP 页面列出了所有需要安装的扩展。如果一些必须的扩展丢失的话,安装程序会在安装环境校验的时候提示您修复并阻止您进入下一步。
  • 数据库。 MySQL 和PostgreSQL 是主要使用的开发数据库,这2个数据库进行了主要的兼容性测试,相关的技术文档也是最全面的。 Oracle 和MSSQL 都能够被完全的支持(注意,一些可选的插件可能没有在这2 个数据库中进行兼容性测试),但是相关的文档和与Moodle 相关的文件没有MySQL/PostgreSQL 这么全面。 MySQL 能提供更多的文档,PostgreSQL 能提供更好的稳定性。你需要在系统中安装PHP 的扩展来支持你选择的数据库。
  • 访问Moodle 使用的浏览器最低版本要求为:Firefox 4, Internet Explorer 8, Safari 5, Google Chrome 11, Opera 9

配置你的服务器

如果你希望评估Moodle,你也可以在桌面计算机中安装Moodle。

有很多方法来安装你的服务器软件,这个根据你选择服务器的不同而不同。一些链接和指向将在 安装 AMP 中。

如果你使用虚拟服务器,服务器需要的一些软件应该已经帮你安装好了。尤其是在共享服务器上,你需要知道如何修改PHP 的配置,例如如何修改最大上传文件大小限制。

不同服务器的配置可能有非常大的不同。

下载和拷贝你的文件到正确位置

重要: 有很多地方可以获得Moodle 的源代码,但是我们建议你到Moodle 的官方网站moodle.org 上去下载源代码。如果你遇到任何问题,你通常能够获得更好的支持。

你有 2 个选择:

  • 从http://moodle.org/downloads 网站上下载你需要的版本,然后解压...
  • 或者 从Git 代码仓库中直接下载源代码(推荐开发人员使用这个方式,这个方式让你更新程序更加简单):
$ git clone -b MOODLE_25_STABLE git://git.moodle.org/moodle.git 

...这个过程将会切换到Moodle 的2.5 稳定分支(最新的每周构建),并且拷贝完整的Moodle 代码仓库。更多GIT 的问题请参考页面Git for Administrators

不管你采用何种方式,当你完全获得Moodle 代码以后,你应该能够在你的机器或者服务器上看到一个叫moodle的目录,这个目录中有一系列的文件和目录。

你可以将整个Moodle 目录拷贝到你Web 服务器的文档目录下,在这种情况下你的网站访问地址为:http://yourwebserver.com/moodle

或者你也可以直接拷贝Moodle 中的内容到你的Web 服务器文档目录下,这样你的访问网址就变得更加简化为http://yourwebserver.com

当你不太明白的时候,请查看你系统和WEB服务器的相关文档。

小提示: 如果你下载Moodle 安装程序到你本地计算机上然后上传到你的服务器上的话,请尽量上传压缩文件到服务器上解压(检查你的文件'文件管理器')。如果你采用的是FTP 上传当个文件,请注意查看FTP 的日志,可能有部分文件在上传的时候丢失。
  • 保护Moodle 文件: 保护Moodle 程序文件不可以被WEB 服务器的用户随意更改是非常重要的。例如在Unix/Linux 操作系统下(使用root)执行下面的命令:
# chown -R root /path/to/moodle
# chmod -R 0755 /path/to/moodle

(文件的所有权为administrator/superuser 用户,也只有administrator/superuser 用户有写入权限,但是其他用户是可以读的)

创建空数据库

下一步需要为你Moodle 安装实例创建一个新的空数据库。你需要为你的Moodle 安装实例找到或者设置下面的信息:nformation for use during the final installation stage:

  • dbhost - 数据库的服务器地址。很有可能是localhost如果的Web 服务器和数据库服务器在同一台机器上,否则你需要在这里设置数据库服务器的名称
  • dbname - 数据库名称,你创建的数据库的名称,比如moodle
  • dbuser - 数据库用户,能够访问Moodle 数据库的数据库用户名。不要使用 root 和超级用户的账号。创建一个账号,只赋予这个账号所需要的最低权限就可以
  • dbpass - 数据库用户使用的密码

如果你的Moodle 站点使用的是虚拟主机服务,你可以通过网页工具访问相关的配置信息,如果你不知道如何配置,请询问你的系统管理员。更多详细信息,可以通过单击下面的数据库分类来获得:

创建(moodledata) 数据目录

Moodle 需要一个目录来存储所有的文件,包括系统上传的文件,临时数据,会话数据等。

Web 服务器需要这个目录具有写入权限。在大型的Moodle 安装实例中,这个目录越大越好。

重要:: 这个目录一定不要放置在Web 服务器下,换句话说,这个目录不能通过网页访问到。如果网页能访问到这个目录的话,将会导致非常严重的安全漏洞。如果你使用的是Linux 操作系统的话,也请不要将这个目录放置到root 账号目录下和你的Moodle 安装程序文件目录下。 Moodle 在安装的时候将会进行校验,如果Moodle 发现了文件,将会阻止安装继续进行。

这里是一个Unix/Linux 的配​​置示例,在创建此目录的时候需要设置权限为所有人都​​可以访问。这种情况是因为Moodle 服务器不是共享服务器。与你的服务器管理员取得联系来确定何种访问权限更加合适,同时也需要Web 服务器用户可以访问到这些文件。

# mkdir /path/to/moodledata
# chmod 0777 /path/to/moodledata

如果你的服务器能够支持ACL,推荐采用下面的授权方式,例如你的Apache 服务器用户www-data:

# chmod -R +a "www-data allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata

如果你计划从命令行中执行PHP 脚本,你需要为当前用户设置同样的权限:

$ sudo chmod -R +a "`whoami` allow read,delete,write,append,file_inherit,directory_inherit" /path/to/moodledata

Web 目录中配置 moodledata 安全性

如果你使用的是虚拟主机配置的网站,你没有办法配置'moodledata'的安全性。你也许可以在'moodledata'目录中使用.htaccess 文件来控制访问权限。这种情况不是对所有系统都是有效的,与你的虚拟主机管理员取得联系,寻求他们的帮助。

创建的文件叫做.htaccess,这个文件只需要有下面的内容就可以了:

order deny,allow
deny from all

开始 Moodle 安装

现在是时候开始运行安装工具来创建数据库表和配置你的网站了。

Moodle 推荐使用命令行来进行安装。

如果因为什么原因你不能使用这种方式进行安装,例如你使用的 Windows 服务器,Moodle 也提供基于 Web 的安装方式。

命令行安装工具

最好使用你系统的 WEB 用户运行命令行安装工具。你需要知道这个是什么 - 查看你的系统管理文档(如:Ubuntu/Debian 是 'www-data',Centos 是 'apache')

  • 使用命令行安装工具的示例(使用 root 进行,但是 'www-data'是你的 Web 用户):
# chown www-data /path/to/moodle
# cd /path/to/moodle/admin/cli
# sudo -u www-data /usr/bin/php install.php
# chown -R root /path/to/moodle

chowns 命令允许脚本写入新文件 config.php file。更多有关脚本的使用,请使用下面的命令:

# php install.php --help

你可能需要被询问到一些本页中没有讨论到的其他设置,如果你也不十分确定配置的信息,请单击确定使用默认配置就可以了。

完整版本,请查看 Administration via command line

基于网页安装工具

使用你的网页浏览器导航到你的 Moodle 网站主页面就可以使用 Web 方式运行安装脚本了。

安装进程将会使用一些页面来完成安装进程。你会被要求同意许可协议,查看数据库中被创建的表,提供管理账号信息和网站的细节信息。

数据库的创建将会需要一些时间,这里请耐心等待。

当数据库创建完成后,你将会看到 Moodle 的前台和后台界面。这时候,你可以使用 Moodle 提供的界面创建一个新的用户。

很多时候,你需要下载新的 config.php 文件然后到上传到你的 Moodle 安装实例中,请参照屏幕的提示。

最终配置

Moodle 的内部设置

在 Moodle 站点管理员界面中有一系列的配置页面(可以从'设置' 块中访问 '网站管理'区)。

这里有一些重要的系统设置,你需要进行检查。

  • 设置> 网站管理 > 插件> 消息输出 > 邮件:配置你自己的 SMTP 邮件服务器和授权信息,这样你的 Moodle 安装实例可以向外发送电子邮件。Moodle 网站的支持人员也可以设置这个界面。
  • 设置> 网站管理 > 服务器 > 系统路径: 设置你系统的 du, dot 和 aspell 执行文件的路径。
  • 设置> 网站管理 > 服务器 > HTTP:如果你的服务器运行在防火墙后,你可能需要在 'Web 代理' 块配置你的代理服务器。
  • 设置> 网站管理 > 区域 > 更新时区:运行这个可以将你配置的时区信息写入到系统中。

余下的任务

  • 配置定时任务: Moodle 的后台任务,比如社区外发电子邮件和进行课程备份时通过脚本来执行的,你可以设置你的脚本执行时间和间隔。这个就是我们常说的定时任务,请参看Moodle 定时任务指南
  • 配置备份:查看 Moodle 站点备份Moodle 自动课程备份.
  • 检查邮件能否正常工作:使用一个有效的电子邮件地址在你的 Moodle 安装实例中 添加测试用户。查看这个用户能否正常的接收到系统发出的电子邮件。如果不能,请查看电子邮件的配置。电子邮件的配置信息位于 [设置> 网站管理 > 插件> 消息输出 > 邮件]。请在系统正常运行前,确保电子邮件功能是能够正常使用的,因为系统是通过电子邮件功能向用户提供找回密码服务的。如果你是系统管理员,但是你也忘记了密码,你需要用电子邮件功能来找回你的密码。
  • 增强 Moodle 网站安全性: 请阅读 Security recommendations 的相关内容。

安装已经完成了 :)

如果安装的时候出现错误了...

你可以尝试下面的一些操作...

  • 参考 Installation FAQ
  • 小心检查你的文件权限。你的操作系统运行用户能否正常读取(不是写入)Moodle 程序文件?你的操作系统运行用户能否正常读取和写入 Moodle 的数据目录:
  • 检查你的数据库权限。你的数据库用户是否已经具有了正常的数据库操作权限,当数据库和程序运行在不同服务器上的时候尤其需要注意这种情况。
  • 当你的 Moodle 安装程序不能创建(config.php) Moodle 配置文件,你可以手动拷贝 config-dist.php 文件为 config.php,然后再尝试编辑文件中有关数据库的配置信息部分。config-dist.php 在 Moodle 安装程序的根目录下。安装程序便可以继续进行了。
  • 当你已经有了 config.php 文件,你可以编辑这个文件来让 Moodle 程序输出调试信息。 Moodle 程序输出的调试信息可以向你提供更加详细的程序运行状态,以便于你查找问题在哪里。如果你具有服务器的访问权限,你也可以查看 Web 服务器的错误信息。
  • 重新检查 php.ini / .htaccess 文件的设置。这里有些技术参数可能需要修改,比如 memory_limit,你是否已经调整了 php.ini / .htaccess 文件的技术参数设置?记住,每次调整后需要重启服务器使设置生效。
  • 在你进行系统安装之前,你是否选择了任何非核心插件,主题和代码?如果你已经选择了,请移除这些配置然后重试,这是因为有些插件可能存在错误或者不兼容的情况。
  • 提交你的问题到Moodle 安装问题 列出你当前运行的软件版本,解释你是怎么进行安装的,发生了什么情况,你看见了什么样的错误信息,你进行了怎样的尝试。尽管系统有可能出现白屏,但是这不是没有原因的,请尽量找到错误信息。
  • 你也可以提交问题到 OSS 计算技术 [http://www.ossez.com/forum-54-1.html]的 Moodle 相关板块,在这里我们将会向你提供中文帮助。

特定平台的安装

注意 通常社区能够提供更多的相关信息。下面的内容可能没有经过验证,也有可能已经过时了,请结合上面的内容一同阅读。

See also