IR系統安裝手冊 - Linux版本

一、事前準備

在安裝IR前，先準備以下所需要環境與工具：

• Java SDK 1.6（Java 6.0）
• MySQL 5.x
• Jakarta Tomcat 5.x, 6.x, 7.x 或 JBoss 4.0
• Jakarta Ant

若您的系統已經有妥善的安裝環境，可以直接跳過本部份至第二部份「安裝IR」。

安裝Java Development Kit

請至以下網址下載Sun Java Development Kit 6.0。只需要下載一般版本，不需下載附Netbeans版本或附Java EE版本：
http://java.sun.com/javase/downloads/index_jdk6.jsp

若你下載的是自動解壓的.bin版本，解壓後的放置目錄會在：

/usr/java/jdk1.6.x

若需設定JAVA_HOME變數，請輸入：

export JAVA_HOME=/usr/java/jdk1.6.x

安裝Jakarta Ant

請至以下網址下載Jakarta Ant：
http://ant.apache.org/

把檔案解壓縮到欲放置的目錄，把$ant_path/bin加入系統的path裡（$ant_path為解壓後放置的目錄）。輸入：

export PATH=$PATH:$ant_path/bin

或是在/usr/bin裡加入連結到ant目錄的symbolic link：

ln -s $ant_path/ant/bin /usr/bin/ant

安裝MySQL

請至以下網站下載MySQL Community Server 5.0：
http://dev.mysql.com/downloads/mysql/5.0.html

詳細的安裝方法請參閱：
http://dev.mysql.com/doc/refman/5.0/en/

因為NTUR的需要，需在/etc/my.cnf（linux）裡加入以下參數，此兩項參數可設定MySQL的table名稱只支援小寫字母（在linux系統下可避免因大小寫而找不到table的情況）及把utf-8設為預設的編碼，在[mysqld]部份加入：

lower_case_table_names=1
default-character-set=utf8
log_bin_trust_routine_creators = 1

然後登入MySQL，建立IR所需要的schema與帳號，在Command Line Mode裡輸入：

#cd $mysql_home/bin
#mysql -u root -p<Password>

$mysql_home為MySQL安裝的目錄；root為登入的帳號，在第一次安裝後，一般能使用的只有root帳號；<Password>為該帳號的密碼（需把 "<" 與 ">" 去掉）。登入後會出現：

Welcome to the MySQL monitor.  Commands end with ; or \g.
Your MySQL connection id is 93414 to server version: 5.0.27-standard-log

Type 'help;' or '\h' for help. Type '\c' to clear the buffer.

mysql>

建立schema：

mysql> CREATE DATABASE dspace DEFAULT CHARACTER SET utf8;

接著建立IR系統連線帳號，並分配權限：

mysql> CREATE USER 'dspace'@'localhost' IDENTIFIED BY '<password>';
mysql> GRANT ALL PRIVILEGES ON dspace.* TO 'dspace'@'localhost';
mysql> FLUSH PRIVILEGES;

mysql> exit

離開後可使用新建的dspace帳號，測試是否能正常登入。

安裝Tomcat

若您想以JBoss作為您的Web Container，下載網址與檔案路徑請參考下面的「安裝JBoss」。

Tomcat 5.x下載網址：
http://tomcat.apache.org/download-55.cgi

安裝後修改server.xml，讓系統可以處理UTF-8的URI，Tomcat 5.x的設定檔路徑為（$tomcat為Tomcat的安裝路徑）：

$tomcat_home/conf/server.xml

在Connector的地方加入URIEncoding="UTF-8"：

<Connector port="8080"
    maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
    enableLookups="false" redirectPort="8443" acceptCount="100"
    connectionTimeout="20000" disableUploadTimeout="true"
    URIEncoding="UTF-8" />

重新起動Tomcat讓設定生效。

安裝JBoss

JBoss 4.x下載網址：
http://labs.jboss.com/jbossas/downloads/

JBoss 4.0.x的設定檔路徑為（$jboss_home為JBoss的安裝路徑，$server為使用的伺服器名稱）：

$jboss_home/server/$server/deploy/jbossweb-tomcat50.sar/server.xml

JBoss 4.2.x的設定檔路徑為：

$jboss_home/server/$server/deploy/jboss-web.deployer/server.xml

二、安裝IR

請至以下網址下載最新版本的IR程式：
http://ir.org.tw/

編輯設定檔

解壓縮後，修改$ir_src/config/dspace.cfg的設定，安裝所必要的參數如下（$ir_src為解壓縮後的目錄）：

• server.os -- 系統安裝的平台，目前支援Windows與Linux，分別參數為windows與linux
• locale.default -- 預設語言，即使用者在沒有選擇語言時所顯示的語言，預設為zh-TW
• dspace.dir -- IR安裝的目錄，例如：d:/ir_home，此目錄為置放主要系統的地方。

註：指定IR欲安裝的目錄後，系統會自動於該路徑產生相關檔案。

• dspace.wardir -- Web Container的deploy目錄（即置放網頁程式的地方），例如Tomcat的deploy目錄：$tomcat_home/webapps（$tomcat_home為Tomcat安裝的目錄）
• dspace.url -- IR網站的url，若安裝後的網址為http://www.xxx.edu.tw/ir請輸入包含/ir的部份，以免有些功能會出現問題。 (RC2以前版本請將ir改為dspace)
• dspace.hostname -- IR網站的hostname
• db.url -- 資料庫伺服器的位置，格式為jdbc:mysql://$hostname:$port/dspace
• db.username -- 連線資料庫使用的帳號，該帳號需有可存取db.url裡所設定的資料庫的權限
• db.password -- 連線資料庫使用的帳號（db.username）的密碼
• mail.server -- 郵件伺服器的網址，如smtp.xxx.edu.tw。使用者註冊新帳號時系統會寄出確認郵件，若此沒有設定此參數，註冊新帳號時會出現錯誤。
• mail.server.username -- 若郵件伺服器需使用帳號密碼，需設定此參數。
• mail.server.password -- 若郵件伺服器需使用帳號密碼，需設定此參數。
• mail.smtps-- 若郵件伺服器需使SSL，需將此參數設定為true，否則不需設定。

• handle.prefix --建議使用人事行政局的機關代碼前九碼數字，以與不同單位區別，不建議使用系統預設值。(機關代碼查詢系統)

註：dspace.dir和dspace.wardir請勿使用同一個目錄。dspace.dir需要獨立於Tomcat或是Jboss的目錄，而dspace.wardir則視Tomcat的安裝路徑或設定而定。

ANT安裝指令

設定完成後，就可以進行安裝了。先進入$ir_src，輸入ant fresh_install。

cd $ir_src
ant fresh_install

執行後會出現安裝成功的訊息，如果安裝不成功，請再次檢查JDK，Jakarta Ant跟MySQL的設定是否正常。安裝正常後，使用瀏覽器連到dspace.url所設定的網址，應能出現TAIR網頁。

設定管理者帳號

安裝後需要產生一個管理者帳號，供管理系統之用（$ir_home為IR系統安裝目錄）：

cd $ir_home/bin
./dsrun org.dspace.administer.CreateAdministrator

輸入後會出現以下畫面，輸入相關的資料，請注意您所輸入的密碼會出現在螢幕上：

 

 

網站名稱設定

建議於安裝完成後可以重新設定您所需要的系統URL名稱，在tomcat或jboss的server.xml檔案裡增加以下第一行設定:

      .......
	<Context path="" docBase="ir" debug="0" reloadable="true" />
      </Host>

(RC2以前版本請將ir改為dspace)

(path=""表示將系統設定在url根目錄。)
更改完成後，請記得回頭修正$DSPACE_HOME/config/dspace.cfg下之dspace.url設定後，重起jboss或tomcat後即可生效。

三、安裝FAQ

請看NTUR安裝常見問題集(FAQ)

若需對安裝後的系統進行一些介面或文字的客製化，請參考系統客製化手冊。