FAQ 常见问题
系统安装
创建数据库失败？
1、查看数据库引擎是否是innodb，如果不是则设置为innodb为默认引擎：
1 )查看mysql存储引擎情况： mysql>show engines。 InnoDB | YES，说明此mysql数据库服务器支持InnoDB引擎。
2 )设置InnoDB为默认引擎：在配置文件my.ini中的 [mysqld] 下面加入default-storage-engine=INNODB
3 ) 重启mysql服务器
4 )登录mysql数据库，mysql>show engines。如果出现 InnoDB |DEFAULT，则表示设置InnoDB为默认引擎成功。
如果引擎为innodb还有问题，查看app 文件夹有没有写权限,如果没有写入权限会导致数据库的配置文件不能写入,然后将localhost和127.0.0.1都试着安装一下。实在不行，给edusoho整个文件夹加上777权限。
2、在my.cnf文件中添加或者修改以下变量：
在[mysqld]下修改或添加
max_allowed_packet = 100M(也可以设置自己需要的大小)
重启mysql
本地视频播放优化解决方案
如果【管理后台】-【教育云】-【云视频】没有开启，网站又没有做过其他视频的开发，那上传的视频都属于本地视频，本地视频一般在app/data/udisk目录下，视频越多，网站服务器也得随之扩容，本地视频无切片播放功能，故需要较长时间加载后才能播放，以及本地视频浏览器兼容性较弱，以下，是一些优化方案：
1、确定视频格式编码符合要求
本地视频格式：MP4，且必须是H264编码；
如果编码不确定，用“格式工厂”重新转码输出MP4再上传测试。
2、格式编码正确，但加载速度很慢怎么办？
慢很可能是因为MP4文件没有加入Hint，导致每次要等MP4文件下载完全后才能播放。给MP4文件加入索引，也就是Hint，可以边播放边下载。
如何加索引，目前来说，基本上只有一个软件有此功能。mediacoder 这是一个国外的软件。
3、本地视频的最终解决方案
可使用EduSoho教育云视频（收费），支持mp4, avi, flv, wmv, mov, m4v, mpg，还有视频弹题、视频水印、视频指纹、字幕等功能。
云视频在网校【管理后台】-【教育云】-【云视频】中开启。
详细介绍：http://open.edusoho.com/show/cloud/video
4、如何使用mediacoder?
1）转换时选择容器属性：
2）选择二次混流，点击选项，出现这样的界面：
选择 hint the file for rtp/rtsp 。
大功告成！
（感谢热心网友提供）
如何安装EduSoho？
请务必配置好环境，然后根据教程一步步检查，若安装出现问题，先核对环境，注意环境配置必须与教程课时名称一致哦~
http://www.qiqiuyu.com/course/explore/install
500错误是什么原因？
500 代表着服务器处理异常，因此需要找出服务报的异常。
如何找出异常？
根据框架提供的机制，只需要在web/app.php中将开发模式打开，就可以看到具体异常。
$kernel = new AppKernel('prod', false);
改成
$kernel = new AppKernel('prod', true);
如果以上方法无效，错误页面还是没有信息，将true改回false
然后按照方法二执行：
进入目录edusoho/app/data
创建一个名为dev.lock的空文件
然后回到报错的页面，打开浏览器的调试模式，
在原来的路由里面紧跟着域名后面加上/app_dev.php，其余不变
如：假如你报错页面的url路由地址是：www.edusoho.com/group
将其改为www.edusoho.com/app_dev.php/group即可看到报错信息
注: 遇到500错误时，千万不要问500错误怎么解决，是什么原因，就像生病了生什么病得根据症状判断，查找错误日志去判断，可以到EduSoho云应用开发QQ群跟开发者沟通： 89120595；
只有把精确的错误日志发布才能更好的让别人帮助你，提高沟通效率。
视频上传不了或者视频太大不能上传
1、服务器上传的目录被限制了访问，尤其是虚拟主机：这个目录位于 edusoho/app/data/udisk
这种情况一般不会出现，因为安装的时候已经检测过。
2、PHP限制了上传大小
找到php.ini，修改下列参数，重启php-fpm或者apache
post_max_size ＝ 300M
upload_max_filesize ＝ 300M
memory_limit ＝ 300M
3、web服务器（Nginx,Apache）限制了上传大小
Nginx: 打开nginx.conf
并在http{}字段里添加 client_max_body_size 300M;
Apache:
/etc/httpd/conf.d/php.conf (不同系统位置有所不同)
LimitRequestBody 300M
安装后首页打开正常，出现图片不能显示、文件无法上传、静态资源(js、css文件)404怎么解决？
问题出现原因: EduSoho资源和静态文件保存在edusoho/web目录下,edusoho/web是访问目录，如果没有在nginx或者Apache配置里面把根目录定位到web目录下，会出现图片不能显示、文件无法上传（或上传卡住）、默认页面404（小组、课程、班级等页面）等问题。
需要在nginx或者Apache配置里面把根目录定位到web目录下
解决办法：
root 配置到项目web目录下 如：/home/howzhi/workspace/www/edusoho/web;
location指向web下的app.php（开发环境下是app_dev.php）
location / {
index app.php;
try_files $uri @rewriteapp;
}
解决办法(以nginx配置为例)：
需要将root 配置到项目web目录下,如：/home/howzhi/workspace/www/edusoho/web;
将location指向web下的app.php（开发环境下是app_dev.php）
上述两处配置具体配置文件内容:
root /home/howzhi/workspace/www/edusoho/web;
location / {
index app.php;
try_files $uri @rewriteapp;
}
修改nginx配置内容后需重启nginx服务!!!
在官方教程中的配置:
提示浏览器不能播放当前视频。
本地视频出现当前浏览器不能播放的原因：
1、视频格式编码不是MP4，H264编码，如果不清楚格式编码，用格式工厂重新转码输出MP4，H264编码；
2、视频太大或者网络太慢，本地视频没有切片播放功能，加载完全时才能播放，如果在固定时间内没有加载完全，就会出现不能播放提示。
本地视频播放优化解决方案：http://www.qiqiuyu.com/faq/714/detail
说明：
若需要解决格式和切片问题，可以使用EduSoho教育云视频（收费），支持mp4, avi, flv, wmv, mov, m4v, mpg，还有视频弹题、视频水印、视频指纹、字幕等功能。
云视频在网校【管理后台】-【教育云】-【云视频】中开启。
详细介绍：http://open.edusoho.com/show/cloud/video
Apache2.2和2.4的配置区别
apache2.2配置文件：
<VirtualHost *:80>
ServerName domain.tld ServerAlias www.domain.tld
DocumentRoot /var/www/project/web <Directory /var/www/project/web> # enable the .htaccess rewrites AllowOverride All Order allow,deny Allow from All </Directory> ErrorLog /var/log/apache2/project_error.log CustomLog /var/log/apache2/project_access.log combined </VirtualHost>
apache2.4和2.2稍有不同，如果您是2.4，将<Directory>节点修改为：
<Directory /var/www/project/web> # enable the .htaccess rewrites AllowOverride All Require all granted </Directory>
注意！！！涉及到路径的地方请按照安装教程，修改为自己的路径。
如何处理500 Internal Server Error？
500 代表着服务器处理异常，因此需要找出服务报的异常。
如何找出异常？
根据框架提供的机制，只需要在web/app.php中将开发模式打开，就可以看到具体异常。
$kernel = new AppKernel('prod', false);
改成
$kernel = new AppKernel('prod', true);
如果以上方法无效，错误页面还是没有信息，将true改回false
然后按照方法二执行：
进入目录edusoho/app/data
创建一个名为dev.lock的空文件
然后回到报错的页面，打开浏览器的调试模式，
在原来的路由里面紧跟着域名后面加上/app_dev.php，其余不变
如：假如你报错页面的url路由地址是：www.edusoho.com/group
将其改为www.edusoho.com/app_dev.php/group即可看到报错信息
注: 遇到500错误时，千万不要问500错误怎么解决，是什么原因，就像生病了生什么病得根据症状判断，查找错误日志去判断，可以到EduSoho云应用开发QQ群跟开发者沟通： 89120595；
只有把精确的错误日志发布才能更好的让别人帮助你，提高沟通效率。
为什么安装后网址有/web/app.php？
问题出现原因: EduSoho的访问目录是edusoho/web，如果没有在nginx或者Apache配置里面把根目录定位到edusoho/web目录下，会出现/web的情况,需要将根目录定位到edusoho/web目录下。
解决办法(以nginx配置为例)：
需要将root 配置到项目web目录下,如：/home/howzhi/workspace/www/edusoho/web;
将location指向web下的app.php（开发环境下是app_dev.php）
上述两处配置具体配置文件内容:
修改nginx配置内容后需重启nginx服务!!!
root /home/howzhi/workspace/www/edusoho/web;
location / {
index app.php;
try_files $uri @rewriteapp;
}
在官方教程中的配置:
二次开发注意事项
修改之后不能不能不能不能不能直接升级系统版本！
升级会将修改内容覆盖，导致报错。
1.模版修改
修改完毕要删除 /app/cache下的缓存文件
2.程序修改
Edusoho使用Symfony2.2 + 自主研发的服务容器，如果没有php及Symfony的知识，也就不具备二次开发的能力，建议您不要在程序上做修改，以免造成网站无法运行。
3.EduSoho不能在WINDOWS下调试？
在windows下调试需要开启Symfony的debug模式，具体操作请参考Symfony文档和php debug相关知识。
如何查看错误日志和运行日志？
ubuntu系统下：
1.nginx错误日志地址：
默认是在/var/log/nginx/目录下，
每个人的配置不一样，如果不在上述目录，则需要根据自己nginx的配置文件来定位错误日志的位置，nginx配置文件地址：/etc/nginx/sites-enabled/edusoho
2.apache错误日志地址：
默认是在/var/log/apache2/目录下，
每个人的配置不一样，如果不在上述目录，则需要根据自己apache的配置文件来定位错误日志的位置，apache配置文件地址：/etc/apache2/sites-enabled/edusoho.conf
CentOS系统下：
1.nginx错误日志地址：
默认是在/var/log/nginx/目录下，
每个人的配置不一样，如果不在上述目录，则需要根据自己nginx的配置文件来定位错误日志的位置，nginx配置文件地址：/etc/nginx/conf.d/edusoho.conf
2.apache错误日志地址：
默认是在/var/log/httpd/目录下，
每个人的配置不一样，如果不在上述目录，则需要根据自己apache的配置文件来定位错误日志的位置，apache配置文件地址：/etc/httpd/conf/httpd.conf
windows集成环境下：
自己找一下面板上设置的错误日志名字和地址，然后去查看一下即可；
除了web服务器日志
我们系统还有自己记录的日志，地址在edusoho/app/logs/
与教育云api有关的错误日志在Cloud.log
其余日志均在prod.log
安装：CentOS 7+Nginx+PHP+MySql+EduSoho
安装教程地址：
课时8：http://www.qiqiuyu.com/course/20
安装后登录操作出现404错误。
EduSoho访问目录是edusoho/web，如果没有在nginx或者Apache配置里面把根目录定位到web目录下，会出现图片不能显示、文件无法上传（或上传卡住）、默认页面404（小组、课程、班级等页面）等问题。
登录后跳转页面出现404，请务必检查是否配置根目录。
解决办法：
root 配置到项目web目录下 如：/home/howzhi/workspace/www/edusoho/web;
location指向web下的app.php（开发环境下是app_dev.php）
location / {
index app.php;
try_files $uri @rewriteapp;
}
如何修改视频上传大小（本地视频）？
1、PHP限制了上传大小
找到php.ini，修改下列参数，重启php-fpm或者apache
post_max_size ＝ 300M
upload_max_filesize ＝ 300M
memory_limit ＝ 300M
2、web服务器（Nginx,Apache）限制了上传大小
Nginx: 打开nginx.conf
并在http{}字段里添加 client_max_body_size 300M;
Apache:
/etc/httpd/conf.d/php.conf (不同系统位置有所不同)
LimitRequestBody 300M
网站安装后空白如何处理？
网站空白很可能是报500错误了，需要查看报错信息去分析原因，才能对症解决。
进入目录edusoho/app/data创建一个名为dev.lock的空文件，
然后回到报错的页面，打开浏览器的调试模式，
在原来的路由里面紧跟着域名后面加上/app_dev.php，其余不变，
如：假如你报错页面的url路由地址是：www.edusoho.com/group
将其改为www.edusoho.com/app_dev.php/group
即可看到报错信息，然后根据错误日志去分析具体原因。
能否帮助安装EduSoho？
开源版ES不提供安装服务，但是提供安装说明，安装需要一些技术基础，如果是希望正式使用的站点，建议找他人帮助安装。
安装教程：http://www.qiqiuyu.com/course/20
如果仅是测试体验，建议使用官网的一键试用版本，只要有手机号一分钟即可注册试用，包含所有商业功能。
或者联系官网在线客服，申请测试账号。
一键试用：http://www.edusoho.com/product/system
如何打开调试模式？
进入目录edusoho/app/data
创建一个名为dev.lock的空文件
然后回到报错的页面，打开浏览器的调试模式，
在原来的路由里面紧跟着域名后面加上/app_dev.php，其余不变
如：假如你报错页面的url路由地址是：www.edusoho.com/group
将其改为www.edusoho.com/app_dev.php/group即可看到报错信息
ES网站迁移，怎么做？
迁移教程：
课时1：http://www.qiqiuyu.com/course/331
提示403网站正在升级中，请稍后访问！
原因：管理后台有人点击了升级系统或升级插件的按钮，系统或插件还没有升级完成，网站不能访问；
解决办法：等系统或插件升级成功再访问网站即可，升级大约需要2~5分钟；
说明：如果5分钟后仍然没有升级成功，网站还是显示403，,可以进入edusoho/app/data目录，查看是否存在一个upgrade.lock文件，如果存在，手动删除即可。
