Q1. 應採購何種等級的伺服器以供NTUR使用？

Q2. 我應如何進行NTUR的版本升級？

1. 請至「下載NTUR系統」下載新版本的NTUR程式。
2. 下載後把檔案解壓縮至暫存目錄（不可直接放到安裝目的地的目錄中），把上一版本的dspace.cfg放到剛解壓後暫存目錄的config/目錄裡（如果之前有更新過一些檔案，也記得要放到相對的目錄裡，例如logo圖檔等）
3. 然後在暫存目錄裡輸入：

ant update

Q3. 更新NTUR時會否覆蓋之前修改的news與license？

1. . config/language-packs目錄﹝介面語言包﹞
2. . config/emails目錄﹝寄送給使用者的各式email範本﹞
3. . config/input-forms.xml*﹝系統某些輸入表單的設定檔﹞

Q4. 我應如何對IR系統進行客製化？

Q5. 如何使用pdfbox以外的文件parser？

1. 把PDFTextStream-X.X.X.jar放到 $DSPACE_HOME/lib/ 裡。
2. 把從Snowtide收到的 .license 檔放到 $DSPACE_HOME/config/ 裡。
3. 在 $DSPACE_HOME/config/dspace.cfg 裡加入

filter.org.dspace.app.mediafilter.PDFFilter.classname = com.snowtide.pdf.PDFTextStream

dsrun org.dspace.app.mediafilter.MediaFilterManager

Q6. 為什麼我整批上傳後等待很久上傳的檔案還沒有出現在系統裡？

請檢查下列部分: (1) 因NTUR的整批上傳機制是以呼叫系統外部程式的方式進行的，所以在安裝時需註明安裝的作業系統，在config/dspace.cfg裡加入：

server.os = linux

server.os = win

(2)請檢查上傳之欄位標示是否正確（上傳檔案metadata的第一列）。若無此欄位名稱，則整批資料將無法上傳。

Q7. 為什麼首頁上的「上傳/下載」排行沒有辦去出現資料？

Q8. 在 Unix/Linux 的平台安裝時會出現 MySQL 找不到資料表的問題？

lower_case_table_names=1

Q9. 在安裝後，當要新增/修改社群或是使用者時，若欄位輸入中文儲存後，網頁上卻顯示為「?」？

可以在mysql的設定檔my.cnf（Windows系統為my.ini）裡加入

default-character-set=utf8

另外在建立dspace的資料庫時，可能需要使用：

CREATE DATABASE dspace DEFAULT CHARACTER SET utf8;

Q10. 從首頁點選某個社群或類別後，再點選左方的「依作者瀏覽」，會出現內部系統錯誤?(Beta2問題)

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

$mysql_home為MySQL安裝的目錄；dspace為登入的帳號，<Password>為該帳號的密碼（需把 "<" 與 ">" 去掉）。登入後，請在mysql>提示符號後執行以下指令:

alter view `dspace`.`communityitemsbyauthor` as select `dspace`.`community2item`.`community_id` 
AS community_id`,`dspace`.`itemsbyauthor`.* from (`dspace`.`itemsbyauthor` join 
`dspace`.`community2item`) where (`dspace`.`itemsbyauthor`.`item_id` = `community2item`.`item_id`);

alter view `dspace`.`collectionitemsbyauthor` as select `dspace`.`collection2item`.`collection_id` 
AS collection_id`,`dspace`.`itemsbyauthor`.* from (`dspace`.`itemsbyauthor` join 
`dspace`.`collection2item`) where (`dspace`.`itemsbyauthor`.`item_id` = `dspace`.`collection2item`.`item_id`);

執行後，若出現

Query OK, x rows affected (xxxxx sec)%%

Q11. 為什麼電腦執行dspace之後，系統容易當機?(Beta2問題)

Q12. 為什麼會出現mysql資料表寫不進去的錯誤訊息?

javax.servlet.ServletException: Can't create/write to file 'x:\\xxxxxx\Temp\#sql_xxx.MYI (Errcode: 17)
.....

解決方法可以把讓目錄從防毒軟體的檢查清單移除（exclude），若該目錄是與其他程式共用，而不想完全把該目錄完全移離防毒軟體的監控，可把mysql的暫存目錄（temp）設定到別的目錄，跟其他程式使用的暫存區分開。

作法是修改my.ini檔，在〔mysqld〕那區加入：

tmpdir="C:/Program Files/MySQL/tmp/" 

Q13. 如何設定檢視資料時顯示的欄位?

1. webui.itemdisplay.default: 設定瀏覽單筆資料時顯示的簡單欄位。
2. webui.itemlist.columns: 設定瀏覽結果列表顯示的欄位（建議在3個欄位以內）。

Q14. 如果在瀏覽社群與類別列表時版面亂掉，該怎麼辦?(Beta3版問題)

此為Beta3版以前的bug，將於Beta4版改正。 若您欲先行修改，請下載此檔案community-list.jsp

將其置於{$webapps}/dspace下，覆蓋原有檔案（不必重起系統即可生效)

Q15. 為什麼中英文切換後,畫面一片空白?(Beta3版以前問題,且採用Tomcat)

若為Beta3以前的版本,且使用tomcat,將可能會產生此錯誤。 我們會在Beta4版改正。 若您欲先行修改，請下載此檔案header-default.jsp

將其置於{$webapps}/dspace/layout下，覆蓋原有檔案（不必重起系統即可生效)

Q16. 為什麼我整批上傳時檔案超過特定大小系統會出現錯誤訊息？

通常是伺服器使用的記憶體不足的問題，以致系統能處理的檔案太小。若使用的伺服器為Tomcat，可設定環境變數CATALINA_OPTS為：

-Xms256m -Xmx1024m

另外，在dspace.cfg檔案中也可設定上傳檔案大小上限：

# Maximum size of uploaded files in bytes, negative setting will result in no limit being set
# 512Mb
upload.max = 536870912

Q17. 刪除類別會出現錯誤訊息？(Beta3版錯誤)

更新方式：

請下載WorkflowItem.class
放到webapps/dspace/WEB-INF/classes/org/dspace/workflow 下
蓋掉原有的WorkflowItem.class
然後重起系統即可

Q18. 為什麼我裝了最新版後，連結IR網頁還是容易當機，或是右方上下傳排行榜無法跑出結果？(Beta3版問題)

可能為單位本身的防火牆限制設定比較嚴格造成的系統死結。
針對此問題我們已做出相應的程式修正，請下載
TopDownload1.jsp及TopUpload1.jsp
放到webapps/dspace/statistics下（蓋掉原有的程式）
不需重起系統即可生效。

Q19. NTUR上傳欄位對應說明

若您希望特別註明每個欄位的著錄語言，請在欄位名稱的後面加上"="及語言代碼。例如：title=zh-TW

Q20. 為何瀏覽類別或社群時，會出現重複的文件(文件編號也一樣)?

若把同一文件加入多個類別(collection)可能會出現此情況。
請手動執行以下資料庫更新的script:
view_200805.sql

執行方式：

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

$mysql_home為MySQL安裝的目錄；dspace為登入的帳號，<Password>為該帳號的密碼（需把 "<" 與 ">" 去掉）。登入後，請在mysql>提示符號後執行view_200805.sql中的指令，執行後，若出現

Query OK, x rows affected (xxxxx sec)%%

Q21. 在瀏覽社群(community)時，顯示出來是用什麼方式來做排列的呢？

1. code: 可以自行編列單位代碼，但目前尚未完成介面，必須去資料庫設定(資料表:community、欄位:code)

Q22. 為什麼我的系統檢索後分類的３個頁籤排版會亂掉？(Beta3版問題)

Q23. 為什麼我執行ant update後，顯示升級成功，但首頁上方顯示的仍是舊的版本號?

更新後程式已是新的， 但有時tomcat會有嚴重cache的現象，尤其是首頁上方banner以及左方menu若仍是舊的版本，
請將tomcat/work目錄整個移除(該目錄為存放編繹過之jsp) 即可自動強迫系統重新編繹。

Q24. 要如何才能將Metadata欄位內容變成hyperlink?(感謝清大提供解答)

請修改dpsace_home/config/dspace.cfg

webui.itemdisplay.default = dc.title, dc.title.alternative, dc.creator, dc.contributor.*,
dc.subject, dc.date(date), dc.date.issued(date), dc.publisher,

Q25. 要如何才能讓搜尋引擎搜尋到IR網站的資料?

目前安裝系統中webroot下多了一個robots.txt檔案，該檔案是防止網路spider抓取網頁進行索引。 若您想要讓搜尋引擎搜尋到您網站的資料， 請將robots.txt檔案刪除， 或將檔案內容

Disallow:

Q26. 如何自行設定進階檢索的欄位?

此功能於RC1版後會新增，若需馬上使用請下載advanced.jsp檔案,放到webapps/$WEBROOT/search/下, 覆蓋原有檔案。

請於$DSPACE_HOME/config/dspace.cfg中加入設定:

webui.search.advanced.columns:ANY:jsp.search.advanced.type.keyword, author:metadata.dc.creator, title:metadata.dc.title, keyword:jsp.search.advanced.type.subject, abstract:metadata.dc.description.abstract, identifier:metadata.dc.identifier, language:metadata.dc.language

編輯說明:

Q27. 如何手動進行索引?

使用command line的方式手動執行以下三個執行檔：

以下是目前要先用人工建索引的方法: 到command line cd dspace_home/bin 分別執行以下三行指令:

dsrun org.dspace.app.mediafilter.MediaFilterManager
dsrun org.dspace.browse.InitializeBrowse
dsrun org.dspace.search.DSIndexer

各執行檔執行內容說明如下：
1. MediaFilterManager是檔案的parser, 會把word, pdf等檔案parse成文字檔, 再靠3去索引。
2. InitializeBrowse 這是資料庫裡的索引, 也會處理作者權威的部分。
3. DSIndexer 是lucene全文檢索用的索引, 它除了索引資料庫欄位之外, 也會索引檔案內的全文

Q28. 與學校計中系統帳號介接方式？該如何要求計中協助處理？(2008/07/25)

本系統有提供SSO API,
因為各校方式不同,可能需要先了解各校計中的處理方式(例如台大使用的是web service),
再決定要撰寫什麼樣的中介程式(需各校自行配合計中撰寫),
最後得到dspace介接程式所需的資料(通常是user id或email)並呼叫NTUR SSO API,以完成單一簽入。
API呼叫方式請參考文件

Q29. 使用者註冊完後，無法發送email給使用者，應如何處理？(2008/08/05)

1. 於log檔出現：javax.mail.MessagingException: 501 Syntax: HELO hostname
系統在寄送email時找不到ntur伺服器的主機名稱, 此問題比較容易發生於linux主機。
主機名稱設定方式因各版本而異，一般來說設定檔為/etc/hosts，加入伺服器名稱, 如下（若伺服器名稱為servername）:

127.0.0.1       localhost.localdomain   localhost   servername

Q30. 為什麼首頁右方"上載"排行顯示正常，但"下載"排行卻無法顯示？

更新方式：

請下載Browse.class
放到webapps/dspace/WEB-INF/classes/org/dspace/browse 下
蓋掉原有的Browse.class
然後重起系統，並刪除$DSPACE_HOME/reports/TopDownload*.html後，重新連結網頁即可。

Q31. 若要將安裝的dspace系統網址設在網站根目錄下，應如何設定?

請在tomcat或jboss的server.xml檔案裡增加以下第一行設定:

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

Q32. 如何置入Google Analytics統計分析功能？

1. 您可以自行申請Google帳號，並登錄IR系統網址，取得網頁內容ID(如UA-973381-1)。
2. 請在$DSPACE_HOME/config/dspace.cfg中設定上述ID

webui.counter.statistics.type = google
webui.counter.statistics.param = UA-973381-1

Q33. 如何設定使用者預設瀏覽的依據(依title瀏覽、依作者瀏覽、或依日期瀏覽)？(RC1版新功能)

在$DSPACE_HOME/config/dspace.cfg檔裡設定:

webui.browse.default=author
#title、date、author擇一設定

Q34. 安裝RC1版本，執行整批上傳時出現錯誤？ (2008/11/05)

原因為系統中缺少ant.jar檔案，
請下載後放入安裝目錄下的lib資料夾，
再執行一次ant update，
重起tomcat或jboss即可。

Q35. 若系統運行一段時間後無法連線，且tomcat或jboss的log裡出現java.lang.OutOfMemoryError: Java heap space，應如何避免此狀況?　(2008/11/25)

通常是伺服器使用的記憶體不足的問題，以致系統能處理的檔案太小。
若使用的伺服器為Tomcat，可設定環境變數CATALINA_OPTS為：

-Xms256m -Xmx1024m

JAVA_OPTS="-Xms256m -Xmx2048m"

1. 打開DOS視窗，到目錄 %TOMCAT_HOME%/bin/ ，執行指令 service install 按下Enter
2. 鍵入 tomcat5 //IS//Tomcat5 按Enter
3. 到Windows的service 可以看見多一個「Apache Tomcat」的service
4. 欲改變起始及最大配置記憶體，可用以下指令 
tomcat5 //US//Tomcat5 --JvmMs=256 --JvmMx=2048

Q36. 為什麼線上人數一直很多，但似乎卻沒有這麼多人使用系統?　(2008/12/03)

系統線上人數之計算是辨認session的數量（並非登入之使用者），使用者連結網頁後即開起一個session，而一個session通常會維持2-3小時，若使用者離開瀏覽頁，系統session仍會存在。因此此計算方式僅為大約之計數，會有些許誤差的狀況。
另外，由於有spider會定期造訪，若欲避免計數spider之計數，請下載spider安裝包置於系統指定處，重起後可過濾部分spider。

Q37. 為什麼上傳/下載排行的數字與實際資料筆數不同?　(2008/12/04)

考量系統效能，首頁之上傳/下載排行採固定時間產生靜態頁面(cache)的方式執行，原則上約每日更新一次。
若您欲取得最新資料，請手動刪除$DSPACE_HOME/cache/$year-month/TopUpload*.html及TopDownload*.html檔案後，
重新連結首頁，即可更新至最即時的資料。

Q38. 如何判斷目前安裝的版本?若安裝了新版以後，畫面與同一版本的其他學校不同，該怎麼辦? (2009/03/12)

可以從網頁右上方的版本字樣判斷目前安裝的版本。
若確定安裝了新版，畫面仍是舊的沒有改變，可能是web container的cache問題。此時可以手動清除cache:
以tomcat為例，請直接刪除tomcat目錄下的work目錄，刪除後再連結一次網頁，即可強迫取得最新畫面。

Q39. 如何修改系統的handle id? (2009/03/23)

• 步驟1:　修改[DSPACE_HOME]/config/dspace.cfg中之handle.prefix
  • 建議使用人事行政局的機關代碼前九碼數字，以與不同單位區別，不建議使用系統預設值。(機關代碼查詢系統)

• 歩驟2: 若資料庫中已有資料，需進到資料庫中，以下列指令做資料全域更新：
  

mysql> update handle set handle=replace(handle,'[[old_handle]/','[[new_handle]/');
例：
mysql> update handle set handle=replace(handle,'987654321/','307265000/');

Q40. 如何自行修改語言對應檔? (2009/04/09)

• 語言對應檔放置位置：
  • 若您尚未安裝，請修改[安裝檔目錄]]/config/language-packs/*.properties
  • 若您已安裝，請修改[WEBROOT]]/WEB-INF/classes/*.properties

• 語言對應檔結構：*.properties
  • *.properties，星號檔案命名表各國語言。
  • properties檔案內容結構為：　[property name]=[顯示值]

#Created by JInto - www.guh-software.de
#Fri Mar 09 14:45:46 CST 2007
itemlist.dc.contributor.*=Contributor(s)
itemlist.dc.contributor.author=Contributor(s)
itemlist.dc.creator=Author(s)
itemlist.dc.creator.*=Creator
itemlist.dc.date=Date
itemlist.dc.date.defense=Defense Date
itemlist.dc.date.issued=Issue Date
itemlist.dc.title=Title
itemlist.dc.type=Type
itemlist.dc.type.*=Type
..............

• 由於Java程序中讀取Property文件的時候使用的是Unicode編碼方式，若您是修改中文的語言檔，請注意必須進行轉碼。若您有安裝JAVA程式，您可以在[JAVA_HOME]]/bin/下找到簡易的轉碼程式native2ascii.exe來使用：（以DOS模式執行）

C:\j2sdk1.4.2_04\bin>native2ascii
中文測試　　##打入欲轉碼的文字後按ENTER
\u4e2d\u6587\u6e2c\u8a66　　　##轉碼後的文字

Q41. 網頁中某些部分為什麼會顯示???xxx.xxx.xxxxx.xxx???(2009/04/09)

有下列二種可能的原因：

• 安裝新版後cache,請依Q38方式處理
• 您定義在config檔裡的的欄位名稱未在語言檔中設定，建議您可暫時將名稱xxx.xxx.xxxxx.xxx

Q42.如何調整mysql可使用的記憶體大小?(2009/04/13)

可調整將mysql config檔參數:

LINUX系統設定檔位置:/etc/my.cnf\\
windows系統設定檔位置: [[MYSQL_HOME]/my.ini

my-small.ini 可使用記憶體不足64M\\
my-medium.ini 可使用記憶體128M左右 mysql内存在32-64左右  #安裝初始設定應是依據此檔\\
my-large.ini 可使用記憶體大於512M\\
my-huge.ini 可使用記憶體1-2G\\

• 更改完畢後請重新啟動mysql。

Q43. IR系統有時會掛掉，怎麼辦?

若您使用LINUX系統，建議可以下載使用系統狀態監控小程式。
若為windows系統，手動重起Tomcat或所使用之其他Web Container服務。

Q44. 如何監控整批上傳及索引等批次程序? (2009/07/08)

整批上傳的工作目錄:[dspace_home]]/job，
其下有幾個資料夾：

• todo：待做的job，系統監控程式每隔數分鐘會來此讀取執行
• doing：正在進行的job
• log：依月份放置job做完的結果，成功完成者會置於此(檔案內容即為執行過程的log)
• hang：隔一段時間都沒有跑完的job

Q45. 為什麼用全文檢索查詢不到某些欄位? (2009/09/15)

系統建立索引的欄位,可以在[dspace_home]]/config/dspace.cfg

search.index.1 = author:dc.contributor.*
search.index.2 = author:dc.creator.*
search.index.3 = title:dc.title.*
search.index.4 = publisher:dc.publisher.*
search.index.5 = keyword:dc.subject.*
search.index.6 = abstract:dc.description.abstract
search.index.7 = date:dc.date
search.index.8 = language:dc.language

yum install ant-apache-regexp

cat /proc/sys/fs/file-max

ulimit –a

Attachments

Browse.class		51577 bytes
TopDownload1.jsp		2197 bytes
TopUpload1.jsp		2091 bytes
WorkflowItem.class		7643 bytes
advanced.jsp		10630 bytes
ajax.js.jsp		2701 bytes
ant.jar		1009603 bytes
community-list.jsp		17079 bytes
header-default.jsp		29139 bytes
memory_setting.jpg		53337 bytes
ntur-b4-patch-20080620.zip		52154 bytes
tab.css		1812 bytes
view_200805.sql		6121 bytes