教学资源管理系统安装手册.docx

1、教学资源管理系统安装手册教学资源管理系统安装手册Doc Version 2.0 作者: 杨鸿奋一功能描述二环境需求 Redhat Linux 7.0或以上；支持zh_CN编码: 已安装好了MySQL3.23.52或以上版本； 足够的硬盘分区空间(最小5G, 推荐50G), 可以容纳教师上传的所有教学资源的极限容量.三安装步骤0. 检查和设置Linux的Locale编码, 硬盘分区空间: 资源管理3.1版要求采用zh_CN的locale进行安装, 如果采用en_US的locale进行安装, 则在在线编辑器的某部分可能会出现中文问题. 所以如果你安装的linux不支持zh_CN编码,请立即先重新安

2、装linux确保其支持zh_CN编码.相应地启动Resin的时候必须相应地设置环境变量LANG=zh_CN, 否则页面上应当出现中文的地方可能会出现乱码.检查的步骤是:(a) 在Shell下面执行locale a|grep zh_CN 命令, 如果有输出zh_CN, 则表示本机支持zh_CN的locale, 则以下安装步骤中应当选用zh_CN的locale, 请记住, 并继续进行步骤b, 否则表明本机不支持zh_CN的locale, 可以尝试按以下步骤让系统支持zh_CN编码：1） 检查是否存在目录：/usr/share/i18n/locales2） 如果存在，则使用下面的命令让系统支持zh_

3、CN编码cd /usr/share/i18n/locales localedef -i zh_CN -f GB2312 zh_CN如果做了上两步以后仍不能支持zh_CN，则请重新安装Linux系统确保其支持zh_CN编码.如果本机既不支持en_US也不支持zh_CN的locale, 即使勉强继续安装, 安装好后也无法解决页面上的中文乱码问题, 所以这时应当停止安装本资源管理系统, 重新安装Linux操作系统确保其能支持zh_CN的locale才能继续安装资源管理系统. (b)在Shell下面执行env| grep LANG命令, 看env| grep LANG的输出是否是LANG=zh_CN,

4、 例如:woocemdv2 resin-2.1.10$ env |grep LANGLANG=zh_CN env| grep LANG命令的输出正确, 则Locale编码无问题, 进入步骤d,否则继续进行步骤c. (c) Locale编码有问题, 则: vi /etc/sysconfig/i18n把LANG=”改成LANG=”zh_CN” 存盘退出.然后要退出Shell再重新登陆才能生效.检查修改是否生效的方法是, 在Shell命令行下输入命令locale, 例如:woocemdv2 lib$ localeLANG=zh_CNLC_CTYPE=zh_CNLC_NUMERIC=zh_CNLC_T

5、IME=zh_CNLC_COLLATE=zh_CNLC_MONETARY=zh_CNLC_MESSAGES=zh_CNLC_PAPER=zh_CNLC_NAME=zh_CNLC_ADDRESS=zh_CNLC_TELEPHONE=zh_CNLC_MEASUREMENT=zh_CNLC_IDENTIFICATION=zh_CNLC_ALL=上面的输出表明locale的修改已生效, 正确地设成了zh_CN.(d) 指定一个分区作为资源管理系统所安装到的硬盘分区, 其空闲空间必须足够大(最小5G, 推荐50G), 足以容纳教师上传的所有教学资源的极限容量, 建议把该分区指定为/usr 01. 获取序

6、列号:在linux命令行下执行/sbin/ifconfig -a在类似其下的输出当中: 以系统显示的第一块网卡的地址为准eth0 Link encap:Ethernet HWaddr 00:90:27:A7:8B:4F inet addr:202.116.9.54 Bcast:202.116.9.127 Mask:255.255.255.128 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:37349726 errors:0 dropped:0 overruns:0 frame:4 TX packets:34351703

7、 errors:0 dropped:0 overruns:0 carrier:0 其中HWaddr后面的00:90:27:A7:8B:4F就是本机的网卡硬件地址, 将此网卡硬件地址报告给产品发布人员, 产品发布人员将回馈一个安装序列号, 请记下此安装序列号.1. 安装java运行环境把安装包中的j2re-1_4_2_01-linux-i586.bin拷贝到一临时目录, cd到该临时目录下面.chmod +x j2re-1_4_2_01-linux-i586.bin./j2re-1_4_2_01-linux-i586.bin 会出现sun jdk的许可协议内容, 直接按q退出查看许可协议内容后,

8、出现提示:Do you agree to the above license terms? yes or no输入yes回车, 很快解包完毕.mv j2re1.4.2_01 /usr/local/如果linux系统是以前未考虑资源管理系统的时候即安装的,那么可能要把linux系统原有的jdk1.3(如果有的话, 如果没有则直接进行下一步)换成现在装的jdk1.4vi /etc/profile.d/java_sdk.sh (如果有的话)把root=/opt/IBMJava2-131注释掉, 换成root=/usr/local/ j2re1.4.2_01vi /etc/profile.d/java

9、_jre.sh(如果有的话)把root=/opt/IBMJava2-131注释掉, 换成root=/usr/local/ j2re1.4.2_012. 安装数据库文件:(1) 确定mysql数据库的数据库文件的存储位置: 一般有两种可能, /usr/local/var/下面或者/usr/local/mysql/var/下面(把一切东西安装在/usr/local/mysql/下面的情况).(2) 把安装包中的erms-db.tgz拷贝到一临时目录, tar xvzf erms-db.tgz解压之, 然后将解压出来的erms目录拷贝到(1)中所获知的目录位置, 例如: cp r erms /usr

10、/local/var/(3) 登陆mysql命令行， 执行以下sql语句： grant all privileges on erms.* to mdvermslocalhost identified by mdv,123;flush privileges;3. 创建和指定一个目录作为资源的存放目录 在前面步骤0的(d)步骤所指定的分区下面创建, 一般可设置为/usr/disk .4. 安装Resin:把安装包中的erms-setup.tgz拷贝到一临时目录, 然后解压后将其拷贝到前面步骤0的(d)步骤所指定的分区下面.5. 根据前面的安装设定和系统实际情况修改配置: vi /usr/local

11、/resin-2.1.10/conf/config.xml(1) 验证和改好资源存放目录的设置:根据步骤3的设定相应改好这里: /usr/disk/(2) 填入安装序列号: 将第0步所获得的安装序列号填在这里和的中间. (3) 验证网页模板路径(如步骤4中所设的Resin目录不同则相应改变这里) /usr/local/resin-2.1.10/doc/erms/ 存盘退出vi.6. 设置环境变量: vi /etc/profile在export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC的之前加上: : JAVA_HOME=/usr/loca

12、l/j2re1.4.2_01 PATH=$PATH:$JAVA_HOME/bin RESIN_HOME=/usr/local/resin-2.1.10然后再在export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC的后面加上JAVA_HOME,ERMS_CONF_PATH成为: export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC JAVA_HOME存盘退出vi然后要退出linux的shell再重新登陆才能使以上的环境变量生效.7. 修改页面上和具体客户相关的信息: cd /usr/

13、local/resin-2.1.10/doc/erms/ vi teach_res.htm 查找广东迈达威科技发展有限公司 版权所有等, 分别改成由具体客户决定的信息. 存盘退出.8. 验证java命令是否可用: 在命令行敲入java命令, 如果显示类似下面的信息: Usage: java -options class args. (to execute a class) or java -jar -options jarfile args. (to execute a jar file)where options include: -client to select the client V

14、M -server to select the server VM -hotspot is a synonym for the client VM deprecated The default VM is client. -cp -classpath set search path for application classes and resources -D= set a system property则是正常的, 可继续下面的步骤. 如果有类似下面的错误信息: rootmdv4 resin-2.1.6# javaError: failed /usr/local/j2sdk1.4.0_01

15、/jre/lib/i386/client/libjvm.so, because libstdc+-libc6.1-1.so.2: cannot open shared object file: No such file or directory则需要把安装光盘里的other目录下面的libstdc+-libc6.1-1.so.2拷贝到/usr/lib/ 下面: cp libstdc+-libc6.1-1.so.2 /usr/lib/9. 设置开机自启动: 在/etc/rc.d/rc.local中加入: LANG=zh_CN JAVA_HOME=/usr/local/j2re1.4.2_01 P

16、ATH=$PATH:$JAVA_HOME/bin RESIN_HOME=/usr/local/resin-2.1.10 export JAVA_HOME PATH RESIN_HOME LANG $RESIN_HOME/bin/httpd.sh start java -jar $RESIN_HOME/lib/UploadServer.jar 1234&然后再重启机器.重启机器之后, 立即尝试: http:/(本机域名或IP):8080/erms/ 进入系统主界面 http:/(本机域名或IP):8080/erms/admin/login.htm 进入资源管理系统的总后台管理入口 总后台管理入口

17、可以以初始用户名system, 密码12345 进入, 进入后为安全性起见请立即自行修改密码. http:/(本机域名或IP):8080/erms/servlet/erms.admin.ShowLib 进入库管理入口如果发现不能访问页面或页面有错误, 则按以下步骤解决问题. 四启动与停止服务(1)手工启动服务: cd /usr/local/resin-2.1.10/bin/ ./httpd.sh start (启动资源管理系统的主服务程序) java -jar ./lib/UploadServer.jar 1234& (启动多文件上载服务器) A.查看资源管理系统是否正在运行的方法: wooc

18、emdv4 resin-2.1.10$ ps ax|grep resin15616 pts/0 S 0:00 sh -c /usr/local/j2re1.4.2_01/bin/java -Dresin.hom15617 pts/0 S 0:01 /usr/local/j2re1.4.2_01/bin/java -Dresin.home=/home/15618 pts/0 S 0:00 /usr/local/j2re1.4.2_01/bin/java -Dresin.home=/home/15619 pts/0 S 0:00 /usr/local/j2re1.4.2_01/bin/java -

19、Dresin.home=/home/15620 pts/0 S 0:00 /usr/local/j2re1.4.2_01/bin/java -Dresin.home=/home/15621 pts/0 S 0:00 /usr/local/j2re1.4.2_01/bin/java -Dresin.home=/home/15622 pts/0 S 0:00 /usr/local/j2re1.4.2_01/bin/java -Dresin.home=/home/15623 pts/0 S 0:00 /usr/local/j2re1.4.2_01/bin/java -Dresin.home=/hom

20、e/15624 pts/0 S 0:00 /usr/local/j2re1.4.2_01/bin/java -Dresin.home=/home/ ps ax|grep resin 所看到的java -Dresin.home=/home/ 是resin的各服务进程,表明Resin服务正在运行, 如果看不到这样的进程则表明Resin服务没有启动起来. B.查看多文件上载服务器是否正在运行:woocemdv2 resin-2.1.10$ ps ax|grep UploadServer14817 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414

21、818 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414819 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414820 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414821 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414822 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414823 pts/3 S 0:00 jav

22、a -jar ./lib/UploadServer.jar 123414824 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414825 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414826 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 123414827 pts/3 S 0:00 java -jar ./lib/UploadServer.jar 1234能看到java -jar ./lib/UploadServer.jar 1234这些

23、进程则表明多文件上载服务器正在运行, 反之则未有运行. 如果Resin的启动有问题, 则tail -f /usr/local/resin-2.1.10/log/stderr.log一般即可查找到启动失败的原因并解决之, 参看下面的第五部分”常见问题及解答”可查找解决办法. 如果自己不能解决,则必须将stderr.log发给开发部.(2)停止Web服务:注意必须是启动Resin的同一用户身份, 例如以mdv用户身份启动, 就必须以mdv用户身份停止(此时用root用户身份停止也不适合).cd /usr/local/resin-2.1.10/bin/./httpd.sh stop五常见问题及解答1

24、. 访问系统主界面时，出现：500 Servlet Exceptionjavax.servlet.ServletException: sorry,initialize application failjava.io.FileNotFoundException:nullconfig.xml (No such file or directory)解决方法:用env命令查看环境变量ERMS_CONF_PATH有没有生效.并且, 查看的时候必须是启动resin时的那用户, 例如, 以mdv用户身份启动Resin的, 则必须在mdv用户身份下查看环境变量ERMS_CONF_PATH有没有生效.2. 启动

25、UploadServer的时候提示:提示：rootyc classesjava UploadServer 1234&1 861rootyc classes# org.jdom.JDOMException: Error on line 32: End of entity not allowed; an end tag is missing.答: config.xml改得不对, 改了之后config.xml文件中的 和 之间不成对. , 请正确改好config.xml3. 安装后打开首页出现“java.sql.SQLException: Cannot connect to MySQL server

26、 on localhost:3306. Is there a MySQL server running on the machine/port you are trying to connect to? (.UnknownHostException)”事实上，mysql已经在运行，我用portscan扫描，也可以看到3306这个端口.答: 首先重启一次resin看看. 如果问题依旧, 则ping localhost, 看localhost是否指向本机. 若ping localhost不通, 则必须做以下设置: vi /etc/hosts, 在里面加上一行: 127.0.0.1 localhos

27、t localhost.localdomain (注意不能断开成两行) 使localhost能够正确指向本机.4. 访问资源管理系统首页时出现这个提示，原因是什么？java.sql.SQLException: Server configuration denies access to data source答: 这是安装中比较常见的问题, 首先重启一次resin看看. 如果问题依旧再尝试重启mysql. 若问题仍存在,则首先检查config.xml里的数据库设置用户名,密码等是否有误, 然后进mysql数据库,use mysql;select * from user;检查mysql的用户权限和

28、config.xml中的设置进行比较.例如, 如果本机的hostname为yc , config.xml里的数据库连接字符串里面是写IP而不是写localhost的话, 比如jdbc:mysql:/202.116.9.103:3306/erms?而select * from user 看到的记录如下: | localhost | root | 1b13bcb03d50bfe1 | Y| yc | root | | Y同时在config.xml里之间是设为| localhost | root |1b13bcb03d50bfe1 | 该记录所对应的密码, 那么访问资源管理系统首页时将出现以上的错误提示. 因为IP被反向解析成主机名yc, mysql将匹配到| yc | root |这条记录, 而这条记录的password字段和| localhost | root |那条记录不一样, 为空, 所以匹配的结果自然是没有权限, 拒绝访问, 解决的办法是只要将| yc | root |这条记录的password字段update成和| localhost | root |这条记录一样就可以了.