教學資源管理系統(tǒng)安裝手冊.doc

教學資源管理系統(tǒng)安裝手冊Doc Version 2.0 作者: 楊鴻奮一功能描述二環(huán)境需求l Redhat Linux 7.0或以上；支持zh_CN編碼: l 已安裝好了MySQL3.23.52或以上版本；l 足夠的硬盤分區(qū)空間(最小5G, 推薦50G), 可以容納教師上傳的所有教學資源的極限容量.三安裝步驟0. 檢查和設置Linux的Locale編碼, 硬盤分區(qū)空間: 資源管理3.1版要求采用zh_CN的locale進行安裝, 如果采用en_US的locale進行安裝, 則在在線編輯器的某部分可能會出現(xiàn)中文問題. 所以如果你安裝的linux不支持zh_CN編碼,請立即先重新安裝linux確保其支持zh_CN編碼.相應地啟動Resin的時候必須相應地設置環(huán)境變量LANG=zh_CN, 否則頁面上應當出現(xiàn)中文的地方可能會出現(xiàn)亂碼.檢查的步驟是:(a) 在Shell下面執(zhí)行l(wèi)ocale a|grep zh_CN 命令, 如果有輸出zh_CN, 則表示本機支持zh_CN的locale, 則以下安裝步驟中應當選用zh_CN的locale, 請記住, 并繼續(xù)進行步驟b, 否則表明本機不支持zh_CN的locale, 可以嘗試按以下步驟讓系統(tǒng)支持zh_CN編碼：1） 檢查是否存在目錄：/usr/share/i18n/locales2） 如果存在，則使用下面的命令讓系統(tǒng)支持zh_CN編碼cd /usr/share/i18n/localeslocaledef -i zh_CN -f GB2312 zh_CN如果做了上兩步以后仍不能支持zh_CN，則請重新安裝Linux系統(tǒng)確保其支持zh_CN編碼.如果本機既不支持en_US也不支持zh_CN的locale, 即使勉強繼續(xù)安裝, 安裝好后也無法解決頁面上的中文亂碼問題, 所以這時應當停止安裝本資源管理系統(tǒng), 重新安裝Linux操作系統(tǒng)確保其能支持zh_CN的locale才能繼續(xù)安裝資源管理系統(tǒng). (b)在Shell下面執(zhí)行env| grep LANG命令, 看env| grep LANG的輸出是否是LANG=zh_CN, 例如:woocemdv2 resin-2.1.10$ env |grep LANGLANG=zh_CN env| grep LANG命令的輸出正確, 則Locale編碼無問題, 進入步驟d,否則繼續(xù)進行步驟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_TIME=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) 指定一個分區(qū)作為資源管理系統(tǒng)所安裝到的硬盤分區(qū), 其空閑空間必須足夠大(最小5G, 推薦50G), 足以容納教師上傳的所有教學資源的極限容量, 建議把該分區(qū)指定為/usr 00. 獲取序列號:在linux命令行下執(zhí)行/sbin/ifconfig -a在類似其下的輸出當中: 以系統(tǒng)顯示的第一塊網(wǎng)卡的地址為準eth0 Link encap:Ethernet HWaddr 00:90:27:A7:8B:4F inet addr:4 Bcast:27 Mask:28 UP BROADCAST RUNNING MULTICAST MTU:1500 Metric:1 RX packets:37349726 errors:0 dropped:0 overruns:0 frame:4 TX packets:34351703 errors:0 dropped:0 overruns:0 carrier:0 其中HWaddr后面的00:90:27:A7:8B:4F就是本機的網(wǎng)卡硬件地址, 將此網(wǎng)卡硬件地址報告給產(chǎn)品發(fā)布人員, 產(chǎn)品發(fā)布人員將回饋一個安裝序列號, 請記下此安裝序列號.1. 安裝java運行環(huán)境把安裝包中的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 會出現(xiàn)sun jdk的許可協(xié)議內(nèi)容, 直接按q退出查看許可協(xié)議內(nèi)容后,出現(xiàn)提示:Do you agree to the above license terms? yes or no輸入yes回車, 很快解包完畢.mv j2re1.4.2_01 /usr/local/如果linux系統(tǒng)是以前未考慮資源管理系統(tǒng)的時候即安裝的,那么可能要把linux系統(tǒng)原有的jdk1.3(如果有的話, 如果沒有則直接進行下一步)換成現(xiàn)在裝的jdk1.4vi /etc/profile.d/java_sdk.sh (如果有的話)把root=/opt/IBMJava2-131注釋掉, 換成root=/usr/local/ j2re1.4.2_01vi /etc/profile.d/java_jre.sh(如果有的話)把root=/opt/IBMJava2-131注釋掉, 換成root=/usr/local/ j2re1.4.2_012. 安裝數(shù)據(jù)庫文件:(1) 確定mysql數(shù)據(jù)庫的數(shù)據(jù)庫文件的存儲位置: 一般有兩種可能, /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/local/var/(3) 登陸mysql命令行， 執(zhí)行以下sql語句： grant all privileges on erms.* to mdvermslocalhost identified by mdv,123;flush privileges;3. 創(chuàng)建和指定一個目錄作為資源的存放目錄 在前面步驟0的(d)步驟所指定的分區(qū)下面創(chuàng)建, 一般可設置為/usr/disk .mkdir /usr/diskchown nobody.nobody /usr/disk4. 安裝Resin:把安裝包中的erms-setup.tgz拷貝到一臨時目錄, 然后解壓后將其拷貝到前面步驟0的(d)步驟所指定的分區(qū)下面. tar xvzf erms-setup.tgz mv resin-2.1.10 /usr/local/5. 根據(jù)前面的安裝設定和系統(tǒng)實際情況修改配置: vi /usr/local/resin-2.1.10/conf/config.xml(1) 驗證和改好資源存放目錄的設置:根據(jù)步驟3的設定相應改好這里: /usr/disk/(2) 填入安裝序列號: 將第0步所獲得的安裝序列號填在這里和的中間. (3) 驗證網(wǎng)頁模板路徑(如步驟4中所設的Resin目錄不同則相應改變這里) /usr/local/resin-2.1.10/doc/erms/ 存盤退出vi.6. 設置環(huán)境變量: vi /etc/profile在export PATH USER LOGNAME MAIL HOSTNAME HISTSIZE INPUTRC的之前加上: : JAVA_HOME=/usr/local/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再重新登陸才能使以上的環(huán)境變量生效.7. 修改頁面上和具體客戶相關的信息: cd /usr/local/resin-2.1.10/doc/erms/ vi teach_res.htm 查找廣東邁達威科技發(fā)展有限公司 版權(quán)所有等, 分別改成由具體客戶決定的信息. 存盤退出.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 VM -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則是正常的, 可繼續(xù)下面的步驟. 如果有類似下面的錯誤信息: rootmdv4 resin-2.1.6# javaError: failed /usr/local/j2sdk1.4.0_01/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 PATH=$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/ 進入系統(tǒng)主界面 http:/(本機域名或IP):8080/erms/admin/login.htm 進入資源管理系統(tǒng)的總后臺管理入口 總后臺管理入口可以以初始用戶名system, 密碼12345 進入, 進入后為安全性起見請立即自行修改密碼. http:/(本機域名或IP):8080/erms/servlet/erms.admin.ShowLib 進入庫管理入口如果發(fā)現(xiàn)不能訪問頁面或頁面有錯誤, 則按以下步驟解決問題. 四啟動與停止服務(1)手工啟動服務: cd /usr/local/resin-2.1.10/bin/ ./httpd.sh start (啟動資源管理系統(tǒng)的主服務程序) java -jar ./lib/UploadServer.jar 1234& (啟動多文件上載服務器) A.查看資源管理系統(tǒng)是否正在運行的方法: woocemdv4 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 -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=/home/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 123414818 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 java -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這些進程則表明多文件上載服務器正在運行, 反之則未有運行. 如果Resin的啟動有問題, 則tail -f /usr/local/resin-2.1.10/log/stderr.log一般即可查找到啟動失敗的原因并解決之, 參看下面的第五部分”常見問題及解答”可查找解決辦法. 如果自己不能解決,則必須將stderr.log發(fā)給開發(fā)部.(2)停止Web服務:注意必須是啟動Resin的同一用戶身份, 例如以mdv用戶身份啟動, 就必須以mdv用戶身份停止(此時用root用戶身份停止也不適合).cd /usr/local/resin-2.1.10/bin/./httpd.sh stop五常見問題及解答1. 訪問系統(tǒng)主界面時，出現(xiàn)：500 Servlet Exceptionjavax.servlet.ServletException: sorry,initialize application failjava.io.FileNotFoundException:nullconfig.xml (No such file or directory)解決方法:用env命令查看環(huán)境變量ERMS_CONF_PATH有沒有生效.并且, 查看的時候必須是啟動resin時的那用戶, 例如, 以mdv用戶身份啟動Resin的, 則必須在mdv用戶身份下查看環(huán)境變量ERMS_CONF_PATH有沒有生效.2. 啟動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. 安裝后打開首頁出現(xiàn)“java.sql.SQLException: Cannot connect to MySQL server on localhost:3306. Is there a MySQL server running on the machine/port you are trying to connect to? (.UnknownHostException)”事實上，mysql已經(jīng)在運行，我用portscan掃描，也可以看到3306這個端口.答: 首先重啟一次resin看看. 如果問題依舊, 則ping localhost, 看localhost是否指向本機.