IR系統安裝手冊 - Linux版本
Table of Contents
一、事前準備
在安裝IR前，先準備以下所需要環境與工具：
- Java SDK 1.5（Java 5.0）
- MySQL 5.0
- Jakarta Tomcat 5.x 或 JBoss 4.0
- Jakarta Ant
若您的系統已經有妥善的安裝環境，可以直接跳過本部份至第二部份「安裝IR」。
安裝Java Development Kit
請至以下網址下載Sun Java Development Kit 5.0。只需要下載一般版本，不需下載附Netbeans版本或附Java EE版本：
http://java.sun.com/javase/downloads/index_jdk5.jsp
若你下載的是自動解壓的.bin版本，解壓後的放置目錄會在：
/usr/java/jdk1.5.x
若需設定JAVA_HOME變數，請輸入：
export JAVA_HOME=/usr/java/jdk1.5.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.xmlJBoss 4.2.x的設定檔路徑為：
$jboss_home/server/$server/deploy/jboss-web.deployer/server.xml
二、安裝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，此目錄為置放主要系統的地方。
- 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 -- 若郵件伺服器需使用帳號密碼，需設定此參數。
- handle.prefix --建議使用人事行政局的機關代碼前九碼數字，以與不同單位區別，不建議使用系統預設值。(機關代碼查詢系統)
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)若需對安裝後的系統進行一些介面或文字的客製化，請參考系統客製化手冊。