IR(Institutional Repository)之安裝--Linux版

ㄧ. 安裝前之準備

1. JDK (jdk-1_5_0_22-linux-i586-rpm.bin)
2. Jakarta Ant (apache-ant-1.8.1-bin.tar.gz)
3. MySQL (mysql-5.0.56.tar.gz)
4. Tomcat (apache-tomcat-6.0.29.tar.gz)
5. IR主程式 (ntur-rc32-201001-new.zip)

二. 安裝流程


   1. 安裝JDK
　　雖然Linux下已經安裝JDK了，不過以防萬一，這邊還是再將JDK安裝一次


　　首先可能會遇到的第一個問題，bin檔要如何解開？
　　進入終端機下，輸入
　　# ./jdk-1_5_0_22-linux-i586-rpm.bin
　　就會解壓縮產生jdk-1_5_0_22-linux-i586.rpm


　　# rpm -ivh  jdk-1_5_0_22-linux-i586.rpm
　　就可以把rpm的檔解開了


　　最後在設定環境變數就可以了，環境變數到最後一起設定！
 
   2. 安裝Ant
　　將下載下來的檔案解壓縮即可，
　　至於如何解壓tar.gz的檔案，
　　# tar zxvf xxx.tar.gz


   3. 安裝Tomcat
　　將檔案解壓縮後放到/opt下


   4. 設定環境變數
　　開啟/etc/profile，在最後加上設定的環境變數，
　　這邊需要設定的環境變數有
　　PATH  CLASSPATH  CATALINA_HOME  JAVA_HOME
　　PATH = JDK跟JRE的bin資料夾位置：$PATH  (Linux是以"："作為路徑的分隔)     
　　CLASSPATH = JDK跟JRE的lib資料夾位置    
　　CATALINA_HOME = Tomcat的資料夾安裝位置
　　JAVA_HOME = JDK的資料夾安裝位置
　　最後再加上export PATH CLASSPATH CATALINA_HOME JAVA_HOME
　　登出後再開啟瀏覽器，在網址列打上http://localhost:8080測試看有無成功。


   5. 安裝MySQL


　　(1)安裝MySQL


　　　於 /usr/local 目錄下解開：　

# cd /usr/local
# tar zxvf mysql-5.0.56.tar.gz
# cd mysql-5.0.56

　　　設定 configure 安裝選項，選擇安裝目錄 （prefix）以及支援中文 Big5 碼（with-charset=big5）：

# ./configure --prefix=/usr/local/mysql \
#--with-charset=big5

　　　開始編譯並安裝：

# make
# make install
# scripts/mysql_install_d 

　　　最後一個步驟是用來產生 MySQL grant tables（會建立一個 mysql 資料庫和一些 tables，用來管理使用 MySQL 的授權資訊，也就是使用者有哪些使用資料庫的權限）。

　　(2) 啟動MySQL

# /usr/local/mysql-5.0.56/share/mysql.server start

如果要停止服務的話，

# /usr/local/mysql/bin/mysqladmin shutdown

　　(3) 其他組態修改
　　　因為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

　　　$mysql_home為MySQL安裝的目錄；

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

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 '';
mysql> GRANT ALL PRIVILEGES ON dspace.* TO 'dspace'@'localhost';
mysql> FLUSH PRIVILEGES;
mysql> exit

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

三. 安裝IR

　1. 編輯設定檔

　　解壓縮後，修改$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的安裝路徑或設定而定。

　2. ANT安裝指令

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

cd $ir_src
ant fresh_install

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