主要是参考官方教程

本地环境：ubuntu12.04

###准备工作：

我所采用的版本为：VirtualBox v4.3.10 ， Vagrant 1.6.2

另外需要注意 ， 得有足够大的剩余磁盘空间(建议剩余20G以上)

###开始安装

  • mkdir fullstack
  • cd fullstack
  • curl -L https://raw.githubusercontent.com/edx/configuration/master/vagrant/release/fullstack/Vagrantfile > Vagrantfile (这一步耗时很久,需要下载接近5G的包)
  • 安装ruby和gem
  • vagrant plugin install vagrant-hostsupdater (该命令如果失败,cd ..之后再执行该命令)
  • vagrant up
    完成以上步骤后edx就跑起来了,可通过以下两种方式访问:
  • http://192.168.33.10/ lms(学生系统)
  • http://192.168.33.10:18010 cms(课件制作系统)

###管理edx

参考官方文档

首先需要登陆系统(登陆到虚拟机):

  • cd fullstack
  • vagrant ssh.

之后再执行其他操作.

###安装主题 我使用斯坦福开源的主题,之后自己定制.

vi /edx/app/edx_ansible/server-vars.yml , 添加以下内容:

1
2
3
4

edxapp_use_custom_theme: true
edxapp_theme_name: 'stanford'
edxapp_theme_source_repo: 'git://github.com/Stanford-Online/edx-theme.git'
edxapp_theme_version: 'HEAD'

之后进行更新

1

sudo /edx/bin/update edx-platform master

以上命令会将系统更新至github上的最新版本.需要耗费一些时间.如果出错基本是网络的原因,重新执行以上命令,或等待网络较好时执行.
此外在执行以上命令时更换pip的源能加快速度.
更换pip的源:

  • cd ~/
  • mkdir .pip
  • vi pip.conf 加入以下内容:
1
2

[global]
index-url = http://mirrors.bistu.edu.cn/pypi/simple

###定制前台 本质上是修改主题包.
主题包的位置:/edx/app/edxapp/themes

###本地化(汉化) 参考这里:

  • sudo apt-get install transifex-client
  • vi ~/.transifexrc,加入以下内容:(注意:user,pass是www.transifex.com网站的用户名和密码,需要先注册)
1
2
3
4
5

[https://www.transifex.com]
hostname = https://www.transifex.com
username = user
password = pass
token =
  • chmod o+rw ~/.transifexrc
  • sudo -u edxapp bash
  • source /edx/app/edxapp/edxapp_env
  • cd /edx/app/edxapp/edx-platform
  • vi lms/envs/common.py 加入 LANGUAGE_CODE = 'zh_CN'
  • vi cms/envs/common.py 加入 LANGUAGE_CODE = 'zh_CN'
  • tx pull -a
  • rake i18n:generate
  • rake lms:gather_assets:aws
  • rake cms:gather_assets:aws
  • exit
  • sudo /edx/bin/supervisorctl -c /edx/etc/supervisord.conf restart edxapp: 需要等一短时间再访问,否则可能出现502错误.