Insitutional Repository(IR)的安裝及設定
的安裝及設定
的安裝及設定 :
的安裝及設定
IR 的安裝設定是參考http://femto.cs.uiuc.edu/~sbond/dspace/及台大 IR 機構典藏計畫網站提 供的技術資料。安裝 IR 系統需要使用到以下幾個套件︰JDK、MySQL、Apache-Ant 及 Apache-Tomcat。 作業系統 作業系統 作業系統 作業系統︰︰︰︰Fedora/Linux 必要套件的安裝 必要套件的安裝 必要套件的安裝 必要套件的安裝︰︰︰︰ 1. 建立 dspace 使用者 在安裝過程中，大多數的時候都使用 dspace 這個帳號。 #su - #useradd dspace 2. 安裝 JDK 從 java 網站下載JDK 5.0 Update 13並執行安裝(必須使用 5.0 版，JDK 6.0 無法進行 IR 的安裝)。接著建立/etc/profile.d/java-jdk.sh 這個檔案，加入以下的內容︰ #!/bin/shJAVA_HOME=`ls -td /usr/java/jdk* | head -1` if [ -d ${JAVA_HOME} ]
then
export JAVA_HOME
export PATH=${JAVA_HOME}/bin:$PATH fi
以上這個 script 是設定 JAVA_HOME 環境變數指到 JDK 安裝目錄，並且把 JDK 的 bin 目錄加入到 PATH 路徑中。
3. 安裝Apache ANT
這個工具是用來編譯 DSpace 以提供給 Apache-Tomcat 執行，其功能類似 make。我的 安 裝 是 將 其 解 壓 縮 在 /home/dspace/ant 目 錄 下 ， 並 在 dspace 使 用 者 的 bashrc(/home/dspace/.bashrc)檔中加入以下一行︰ export ANT_HOME=/home/dspace/ant 4. 安裝Apache Tomcat 下載最 新版 Tomcat， 解壓縮 到/home/dspace/目錄下，並為解壓縮後的目錄(例︰ tomcat6.0.16)設定一個連結符號︰/home/dspace/tomcat。 $ ln -s /home/dspace/tomcat6.0.16 /home/dspace/tomcat 在 dspace 使用者的 bashrc(/home/dspace/.bashrc)檔中加入以下一行︰ export CATALINA_HOME=/home/dspace/tomcat
5. 安裝 MySQL
直接安裝作業系統發佈的 MySQL 套件 # yum install mysql-server
設定上述安裝的套件 設定上述安裝的套件 設定上述安裝的套件 設定上述安裝的套件︰︰︰︰ 1. 測試 tomcat 是否可以正確執行︰ # su - dspace $ /home/dspace/tomcat/bin/startup.sh 透過網頁瀏覽器連線到 http://140.117.120.62:8080，如果系統中有設定防火牆，請開啟 8080 及 8443 這 2 個連接埠。若連線成功表示 tomcat 已正確啟動。 2. 開啟 Tomcat 設定檔/home/dspace/tomcat/conf/server.xml，找到以下字串，並加入粗體 字部份︰
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000"
redirectPort="8443" URIEncoding="UTF-8" /> 加入 URIEncoding="UTF-8"可使 IR 支援中文搜尋。 3. 設定 MySQL︰
開啟/etc/my.cnf 檔，在[mysqld]中加入以下字串︰ # force mysql to use lower case for table name lower_case_table_names=1
# force mysql to use utf8 as default connection charset default-character-set=utf8
設定MySQL管理者(root)密碼(舊密碼︰123456，新密碼︰456789)︰ #mysqladmin -uroot -p123456 password 456789
如果先前已設定密碼但是忘記了，可使用以下方法重設︰ # /etc/init.d/mysql stop
# mysqld_safe --user=mysql --skip-grant-tables --skip-networking & # mysql -u root mysql
mysql> UPDATE user SET Password=PASSWORD('newpassword') where USER='root'; mysql> FLUSH PRIVILEGES;
mysql> quit
接著在MySQL建立IR資料庫 - dspace︰ #mysql -uroot -p
mysql> CREATE DATABASE dspace DEFAULT CHARACTER SET utf8; 在MySQL中建立 dspace 使用者，並允許存取 MySQL 中的 dspace 資料庫 mysql> CREATE USER 'dspace'@'localhost' IDENTIFIED BY '<password>'; mysql> GRANT ALL PRIVILEGES ON dspace.* TO 'dspace'@'localhost'; mysql> FLUSH PRIVILEGES;
安裝 安裝 安裝 安裝 IR︰︰︰ ︰ 在完成前述步驟後，我們已經準備好安裝 IR 的準備工作，接著開始 IR 的安裝。 1. 切換到 dspace 使用者，下載 IR 至/home/dspace/下，並解壓縮之。 # su - dspace $ wget -c http://url_to_download_address/ntur-source.zip $ unzip ntur-source.zip 2. 修改 ntur-source/config/dspace.cfg 檔的下列設定︰ dspace.dir = /home/dspace/ntur_nsysu dspace.wardir = /home/dspace/tomcat/webapps dspace.url = https://140.117.120.62:8080/dspace dspace.hostname = 140.117.120.62
dspace.name = National Sun Yat-sen University Institutional Repository dspace.shortname = NSYSUIR
db.name = mysql
db.url = jdbc:mysql://localhost:3306/dspace db.driver = org.gjt.mm.mysql.Driver
db.username = dspace
db.password = <password used in mysql setup above> mail.server=mail.nsysu.edu.tw
mail.from.address = dspace-noreply@sunir.lib.nsysu.edu.tw feedback.recipient = <my email address>
mail.admin = <my email address> alert.recipient = <my email address> 3. 接著使用 ANT 編譯及安裝 IR︰
a. 第一次安裝 -
安裝 IR 程式、編譯 war、建立資料庫 $ cd /home/dspace/ntur-source/
程式會自動在 MySQL 建立資料表、安裝 IR 的程式至 /home/dspace/ntur_nsysu 目 錄 中 ， 並 編 譯 及 複 製 dspace.war 及 dspace-oai.war 兩 個 檔 案 至 /home/dspace/tomcat/webapps 目錄。 b. 若非第一次安裝 (千萬不可使用 ant fresh_install 安裝，否則已存在的資料將全被清 除) i. 安裝或更新 IR 程式至 dspace.dir，並編譯新的 war 檔，但使用已經存在的資料庫 $ cd /home/dspace/ntur-source/ $ ant update ii. 僅重編 war 檔 $ cd /home/dspace/ntur-source/ $ ant build_wars 4. 建立一個 IR 的管理者帳號︰ $ /home/dspace/ntur_nsysu/bin/create-administrator
5. 停止 tomcat，並清除 webapps 中的 dspace 及 dspace-oai 兩個目錄，再重新啟動之。 $ /home/dspace/tomcat/bin/shutdown.sh $ cd /home/dspace/tomcat/webapps $ rm -rf dspace dspace-oai $ /home/dspace/tomcat/bin/startup.sh 6. 最後透過網頁瀏覽器連線 http://140.117.120.62:8080/dspace/即可開啟 IR 介面。 系統設定 系統設定 系統設定 系統設定︰︰︰︰ 為了確保系統每次開機均會自動啟動 MySQL 及 Tomcat，需做以下的設定︰ For MySQL︰ # /sbin/chkconfig mysqld on For Tomcat︰ 建立/etc/init.d/tomcat_dspace 這個檔案，並輸入以下內容︰ #!/bin/bash #
# tomcat Startup script for the Apache-Tomcat HTTP Server #
# chkconfig: - 71 19
# description: Start up the Tomcat servlet engine. # Source function library.
if [ -x /etc/rc.d/init.d/functions ]; then . /etc/rc.d/init.d/functions
fi RETVAL=$? CATALINA_HOME=/home/dspace/tomcat TOMCAT_USER=dspace start () { if [ -f $CATALINA_HOME/bin/startup.sh ]; then echo $"Starting Tomcat"
if [ -x /etc/rc.d/init.d/functions ]; then
daemon --user $TOMCAT_USER $CATALINA_HOME/bin/startup.sh else
/bin/su $TOMCAT_USER -c $CATALINA_HOME/bin/startup.sh fi
fi }
stop () {
if [ -f $CATALINA_HOME/bin/shutdown.sh ]; then echo $"Stopping Tomcat"
if [ -x /etc/rc.d/init.d/functions ]; then
daemon --user $TOMCAT_USER $CATALINA_HOME/bin/shutdown.sh else
/bin/su $TOMCAT_USER -c $CATALINA_HOME/bin/shutdown.sh fi fi } case "$1" in start) start ;; stop) stop ;; restart) stop start ;; *)
echo $"Usage: $0 {start|stop|restart}" exit 1
;; esac
exit $RETVAL
# chmod +x /etc/init.d/tomcat_dspace 將之加入到啟動程序中︰
# /sbin/chkconfig --add tomcat_dspace # /sbin/chkconfig tomcat_dspace on
