open edx: ubuntu 16.04原生native 安装部署

1. 引言

openedx作为哈佛大学等美国顶尖大学推出的在线教育平台，在全世界有着广泛的应用。相较于同类的基于php的moodle,openedx核心代码基于python的django框架。现在，openedx在国内越来越普及，有成熟的商业化产品（清华的学堂在线），也有面向各大院校的免费教育产品（edustack）。openedx虽然强大，但相关代码复杂性高，文档不够完整等缺陷导致了实际安装，部署时会有各种问题。相较于今天要说的ubuntu原生代码安装，如果想要本地测试的话建议下载官网的虚拟镜像（需要事先安装vitural box或vmware虚拟机软件，然后使用vagrant这一命令行的自动化部署工具启动）。这一方法是速度最快，出错率最低的方案（当然了，相应的代价就是需要消耗月10G左右的存储空间）；在结合官方文档对openedx代码结构，功能有了一定熟悉后，下面就开始实际的系统部署工作（都是一些走过的坑，前事不忘，后事之师）。

---

2. 系统准备

准备好一个满足要求的ubuntu系统（现金就允许两个版本：12.04和16.04）。openedx 对版本限的很死，其自动化脚本会首先自动检测系统版本，如果不匹配就直接跳出安装。笔者这里采取的是阿里云的EC2云服务器，阿里云上的ubuntu开源镜像没有12.04,只有14.04和16.04,因此就选择了16.04版本，并将内存升到4G。下面是官方的硬件要求（16.04对应的openedx版本是 Ficus）：

• Ubuntu 16.04 amd64 (oraclejdk required). It may seem like other versions of Ubuntu will be fine, but they are not. Only 16.04 is known to work.

• Minimum 8GB of memory

• At least one 2.00GHz CPU or EC2 compute unit
• Minimum 25GB of free disk, 50GB recommended for production servers

要求还挺高，不过笔者内存只用了4G的，貌似也能正常运行。

---

3. 更新系统

下面按照要求要更新下ubuntu系统软件，因为下面要从pip，github下载和安装一堆东西，所以希望系统软件都是最新的，操作也很简单。

sudo apt-get update -ysudo apt-get upgrade -ysudo reboot

---

4. 开始自动化安装

先来看下官方的流程：

# 1. Set the OPENEDX_RELEASE variable:export OPENEDX_RELEASE=the-tag/you-want-to-install# 2. Bootstrap the Ansible installation:wget https://raw.githubusercontent.com/edx/configuration/$OPENEDX_RELEASE/util/install/ansible-bootstrap.sh -O - | sudo bash# 3. (Optional) If this is a new installation, randomize the passwords:wget https://raw.githubusercontent.com/edx/configuration/$OPENEDX_RELEASE/util/install/generate-passwords.sh -O - | bash# 4. Install Open edX:wget https://raw.githubusercontent.com/edx/configuration/$OPENEDX_RELEASE/util/install/sandbox.sh -O - | bash

前三步都是准备工作，比较简单。注意下这里的版本，笔者采用的是：

export OPENEDX_RELEASE=open-release/ficus.2

注意这里使用的版本是ficus.2而不是ficus.3,笔者一开始也是用3，但始终无法成功，换成2后可以，可能推测是兼容性问题。
openedx的版本在https://openedx.atlassian.net/wiki/display/DOC/Open+edX+Releases，是以英文字母顺序来推进的，A，B，C。。。。F，笔者这里最新的是Ficus。另外，可以将export放到／etc/profile或是~/.bashrc，这样每次想要重新运行都可以避免重复操作。

---

5.注意事项

上述流程中最慢，最耗时的就是就是上面第4步。安装过程中自动化脚本要执行非常多的task，其中会在几个地方会有一些卡，例如checkout edxapp github repo或是pip install requirements等地方，尽量耐心等待，有时跟github和pip的网络连接有关。全部安装完后将可以在浏览器中输入服务器地址看到openedx的lms前台。

原文链接：https://openedx.atlassian.net/wiki/display/OpenOPS/Native+Open+edX+Ubuntu+16.04+64+bit+Installation