[{TableOfContents title=FAQ問題}]

!!!__系統建置、安裝及升級__\\

!Q1. 應採購何種等級的伺服器以供NTUR使用？
請至「[臺灣各大學建置機構典藏系統軟硬體規範書|http://ntur.lib.ntu.edu.tw/handle/246246/48040]」下載機構典藏系統軟硬體規範書，並參考第五頁之附錄。

!Q2. 我應如何進行NTUR的版本升級？
#請至「[下載NTUR系統]」下載新版本的NTUR程式。
#下載後把檔案解壓縮至暫存目錄（不可直接放到安裝目的地的目錄中），把上一版本的dspace.cfg放到剛解壓後暫存目錄的config/目錄裡（如果之前有更新過一些檔案，也記得要放到相對的目錄裡，例如logo圖檔等）
#然後在暫存目錄裡輸入：
{{{ant update}}}
%%(color:red)
註：請勿在更新時使用{{ant fresh_install}}，有可能會造成資料流失，請務必注意。
%%

!Q3. 更新NTUR時會否覆蓋之前修改的news與license？
update套件並不會覆蓋news與license，使用ant update在config目錄會覆蓋的只有以下檔案：
#. config/language-packs目錄﹝介面語言包﹞
#. config/emails目錄﹝寄送給使用者的各式email範本﹞
#. config/input-forms.xml*﹝系統某些輸入表單的設定檔﹞
%%(color:red)
註：提醒若不慎使用ant fresh_install，有可能會把DB裡的資料也一併清空。
%%

!Q8. 在 Unix/Linux 的平台安裝時會出現 MySQL 找不到資料表的問題？
因在Windows環境下，table的名稱並沒有大小寫的區別。但是在 Unix/Linux 系統下，table的大小寫是有區別的。所以為免這類情況發生，可以在my.cnf檔裡加入以下參數，讓MySQL自動把table名稱全換成小寫：
{{{lower_case_table_names=1}}}

!Q9. 在安裝後，當要新增/修改社群或是使用者時，若欄位輸入中文儲存後，網頁上卻顯示為「?」？
若欄位輸入中文儲存後，網頁上卻顯示「?」，有可能是資料庫的編碼的問題。

可以在mysql的設定檔my.cnf（Windows系統為my.ini）裡加入
{{{default-character-set=utf8}}}
把default資料庫連線設成支援utf8。

另外在建立dspace的資料庫時，可能需要使用：
{{{CREATE DATABASE dspace DEFAULT CHARACTER SET utf8;}}}


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

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


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

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


!Q46. 安裝步驟至 ant fresh_install時為何會出現"build.xml:89 No supported regular expression matcher found"? %%(color:silver)(2009/09/30)%%

使用RedHat系列(CentOS, Fedora, Mandriva)標準套件安裝時,雖已安裝ant,mysqld及tomcat5,但仍須安裝%%(color:red)ant-apache-regexp%% 套件,可使用以下指令安裝
{{{yum install ant-apache-regexp}}}


!!!__系統設定、使用說明__\\

!Q4. 我應如何對IR系統進行客製化？
可參考[系統客製化手冊|IRCustomize]。

!Q5. 如何使用pdfbox以外的文件parser？
NTUR內建是使用開放原始碼的套件pdfbox，另有支援另一套商業套件PDFTextStream（v.2.X)，這是經過測試正確率較高的parser，若需使用需做以下設定：
#把PDFTextStream-X.X.X.jar放到 $DSPACE_HOME/lib/ 裡。
#把從Snowtide收到的 .license 檔放到 $DSPACE_HOME/config/ 裡。
#在 $DSPACE_HOME/config/dspace.cfg 裡加入
{{{filter.org.dspace.app.mediafilter.PDFFilter.classname = com.snowtide.pdf.PDFTextStream}}}
%%(color:red)
啟用parser license之後,必須手動執行索引指令,將pdf等格式的檔案parse出txt純文字檔供搜尋。%%
{{{
dsrun org.dspace.app.mediafilter.MediaFilterManager
}}}

!Q13. 如何設定檢視資料時顯示的欄位?
您可以到%%(color:blue)config/dspace.cfg %% 裡設定:
{{{
1. webui.itemdisplay.default: 設定瀏覽單筆資料時顯示的簡單欄位。
2. webui.itemlist.columns: 設定瀏覽結果列表顯示的欄位（建議在3個欄位以內）。
(多值以逗號分隔，設定完成後需重起系統)
}}}
%%(color:red)欄位名稱必須是全路徑且確有此欄位 %%，例如：dc.relation。

!Q19. NTUR上傳欄位對應說明

%%(color=red)上傳的欄位必須與系統的欄位對應（請參考上傳流程之欄位說明），否則即無法成功上傳。%%

|欄位名稱|欄位說明|填寫說明
|title*|題名| 
|creator*|作者| 
|date*|日期|文件發展或創作日期。請依循範例格式著錄：2007-01-01(yyyy-MM-dd)
|relation|關聯|期刊或會議 (含期刊或會議名稱、卷期、日期、頁數、會議地點)。表示方式：期刊名稱 卷(期)，頁數
|description:abstract|摘要| 
|subject|關鍵詞|主題或關鍵詞
|contributor|貢獻者|作者所屬的系所或單位
|publisher|出版者|請依循著錄格式: 地點：學校及系所或單位
|language|語言|請依照 ISO 639標準 著錄作品語言
|description:note|附註| 
|sys_filename|文件檔案|請將文件數位檔案放在與書目資料檔案同一層的目錄，或者您必須於詮釋資料之此欄位註記檔案所在之相對路徑。(若有多個檔案請以;分號分隔)
|sys_hyperlink|外部連結|若您希望在打開文件檔案時，連結到外部網頁，請在此欄位提供URL。(若有多個檔案，請提供不同的連結，並以;分號分隔)

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


!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, 
%%(color:red)
                            dc.identifier.uri(link), ==>將指定的欄位後面加上(link)即可
%%
                            dc.description.abstract, dc.description, dc.relation\\ 


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

目前安裝系統中webroot下多了一個robots.txt檔案，該檔案是防止網路spider抓取網頁進行索引。
若您想要讓搜尋引擎搜尋到您網站的資料，
請將robots.txt檔案刪除，
或將檔案內容
{{{
Disallow:
}}}
這行中之"/"符號刪去即可\\
\\
更改設定後，必須等搜尋引擎的spider下一次再來巡訪網頁後，才能查詢到喔。\\
可參考[Google對於索引網站的相關說明|http://www.google.com.tw/support/webmasters/bin/answer.py?answer=34397&ctx=sibling]


!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
}}}

編輯說明:
%%(color:red)
[[搜尋欄位1]:[[顯示欄位名稱1], [[搜尋欄位2]:[[顯示欄位名稱2]...\\
title:metadata.dc.title,author:metadata.dc.creator\\
%%
\\
1.搜尋欄位:
%%(color:red)
請以$DSPACE_HOME/config/dspace.cfg中的search.index.*欄位為準。若搜尋欄位沒有建立索引，是查詢不到的。
%%
\\
2.顯示欄位:必須在語言檔中有對應才能正確煩示,例/metadata.dc.*。\\
3.欄位之間請以,(逗號)做分隔。\\


!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. 與學校計中系統帳號介接方式？該如何要求計中協助處理？%%(color:silver)(2008/07/25)%%

本系統有提供SSO API,\\
因為各校方式不同,可能需要先了解各校計中的處理方式(例如台大使用的是web service),\\
再決定要撰寫什麼樣的中介程式(需各校自行配合計中撰寫),\\
最後得到dspace介接程式所需的資料(通常是user id或email)並呼叫NTUR SSO API,以完成單一簽入。\\
API呼叫方式請參考[文件|http://ir.org.tw/attach/%E6%8A%80%E8%A1%93%E6%94%AF%E6%8F%B4%E6%96%87%E4%BB%B6/NTUR_SSO.pdf]



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

請在tomcat或jboss的server.xml檔案裡增加以下第一行設定:
{{{
　　　......
　　　　　　<Context path="" docBase="dspace" debug="0" reloadable="true" />
      </Host>
}}}
(path=""表示將系統設定在url根目錄。)\\
%%(color:red) 更改完成後，請記得回頭修正$DSPACE_HOME/config/dspace.cfg下之dspace.url設定，而後請重新啟動tomcat或jboss即可生效。%% 


!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
}}}
3. 重起系統後，即可開始Google之統計追踪。
4. 請登入Google帳號後，確認狀態為 "追蹤狀態：  接收資料"，才表示統計狀態正確。
%%(color:red) 
請注意：首頁右上角之造訪人數與Google統計結果有些許出入乃屬正常現象。由於Google統計資料會較即時更新一些Spider等資訊，所以結果會較精確。
%% 


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

在$DSPACE_HOME/config/dspace.cfg檔裡設定:\\
{{{
webui.browse.default=author
#title、date、author擇一設定
}}}
若不設定,預設為依title排序。


!Q39. 如何修改系統的handle id? %%(color:silver)(2009/03/23)%%

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

* 歩驟2: 若資料庫中已有資料，需進到資料庫中，以下列指令做資料全域更新：\\
{{{
mysql> update handle set handle=replace(handle,'[[old_handle]/','[[new_handle]/');
例：
mysql> update handle set handle=replace(handle,'987654321/','307265000/');
}}}

!Q40. 如何自行修改語言對應檔? %%(color:silver)(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
..............
}}}
若網頁上顯示???xxx.xxx.xxx.xxxx???之不明訊息，表示未在語言檔中找到對應的設定，您可自行在各國語言檔中加入\\
%%(color:green)
xxx.xxx.xxx.xxxx=[[顯示值]]%%
* 由於Java程序中讀取Property文件的時候使用的是Unicode編碼方式，若您是修改中文的語言檔，請注意必須進行轉碼。若您有安裝JAVA程式，您可以在[[JAVA_HOME]]/bin/下找到簡易的轉碼程式native2ascii.exe來使用：（以DOS模式執行）
{{{
C:\j2sdk1.4.2_04\bin>native2ascii
中文測試　　##打入欲轉碼的文字後按ENTER
\u4e2d\u6587\u6e2c\u8a66　　　##轉碼後的文字
}}}
請將轉碼後的文字，貼在*.properties檔作為值即可

\\
\\
%%(color:green)
請注意：
* 若您直接在安裝後的檔案修改，而後又執行安裝更新，您更改後的語言檔將會被覆蓋，請自行備份。
* 修改後的部分請回報系統開發單位，我們將會在下次發佈之新版加上，以免產生安裝檔與貴校版本資料不同步。
%%
%%(color:red)
* 更改語言檔後，請重起web server方能生效。
%%


!Q42.如何調整mysql可使用的記憶體大小?%%(color:silver)(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\\
}}}
%%(color:green)
請注意:
* "可使用記憶體"不表示該台機器的記憶體總量, 因為還會有別的程式需要使用。
%%
%%(color:red)
* 若欲更改為my-large.ini, my-huge.ini, 請勿直接將範例檔覆蓋原有設定, 因為原本已加入一些其他設定如max_connections, 所以請將[mysqld]段相關的設定值抄過來即可。
%%
* 更改完畢後請重新啟動mysql。
%%


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

整批上傳的工作目錄:%%(color:red)[[dspace_home]]/job%%，\\
其下有幾個資料夾：
*todo：待做的job，系統監控程式每隔數分鐘會來此讀取執行
*doing：正在進行的job
*log：依月份放置job做完的結果，成功完成者會置於此(檔案內容即為執行過程的log)
*hang：隔一段時間都沒有跑完的job
\\ 
上傳以及做索引等動作的命令，都會依此架構執行。\\
檔案是以時間命名+動作以及類別名稱，檔案的內容則為執行的指令。\\
\\
若發現送出的job很久沒有跑，可以依序到todo=>doing=>hang=>目錄進行檢查。\\
如果有很多job都卡在todo目錄中，表示系統監控程式未正常執行，\\
建議可以重起tomcat後再觀察系統是否有將job讀走。



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

系統建立索引的欄位,可以在%%(color:red)[[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
}}}
%%(color:red)
設定格式為: search.index.[[n]] = [[欄位代表名稱(英文)]]:[[欄位全路徑(需和後台管理介面中著錄的欄位名稱一模一樣)]]
%%
\\
若需要增加其他欄位,請依序著錄於下,並重起系統後,以手動重建索引 (dsrun org.dspace.search.DSIndexer)。
\\
手動建立索引之方法請參見Q27。


!Q47. 外部連結提示訊息能否關閉? (RC3版新增功能) %%(color:silver)(2009/10/13)%%

可在dspace.cfg中設定webui.bitstream.external-link.alert = false 以關閉alert。

!Q48. Linux主機若出現IOException: Too many openfiles應如何處理? %%(color:silver)(2010/01/19)%%

開檔的部分是因為系統在紀錄及檢查造訪者ip等動作, 都是利用檔案的方式進行。\\\
Linux系統預設開檔上限預設為1024，需加大開檔上限，詳細方法可參閱[相關文件|http://www.javaeye.com/topic/240389]
\\建議可以
{{{cat /proc/sys/fs/file-max}}}
或
{{{ulimit –a}}}
看看目前的值。


!Q49. 如何透過透過 LDAP 進行 SSO 登入?(感謝法鼓佛教學院提供) %%(color:silver)(2010/03/30)%%

在dspace.cfg中進行以下設定:
{{{
#以下為取代為原有設定
plugin.sequence.org.dspace.eperson.AuthenticationMethod = \
org.dspace.eperson.LDAPAuthentication

webui.ldap.autoregister = true
#以下為新增之設定
ldap.enable = true
ldap.provider_url = ldap://ldap.example.edu.tw:389/ [^]
ldap.id_field = uid
ldap.object_context = dc=example,dc=edu,dc=tw
ldap.search_context = dc=example,dc=edu,dc=tw
ldap.email_field = mail
ldap.surname_field = sn
ldap.givenname_field = givenName
ldap.phone_field = telephoneNumber
}}}

設定完成，重新啟動 dspace即可。

!Q55. 社群和類別的顯示可以排序嗎? %%(color:silver)(2011/04/19)%%

可以的，請到社群/類別的編輯頁面，在"代碼"欄位輸入文字或數字，系統會將同層的社群或類依代碼排序。\\
[{Image src='community_sort.jpg'}]

!Q56. 如何設定Tomcat使用port 80??%%(color:silver)(2011/06/09)%%
Windows：\\
將Tomcat設定檔server.xml參數port改為80\\
{{{
<Connector port="80"
    maxThreads="150" minSpareThreads="25" maxSpareThreads="75"
    enableLookups="false" redirectPort="8443" acceptCount="100"
    connectionTimeout="20000" disableUploadTimeout="true"
    URIEncoding="UTF-8" />
}}}

Linux：\\
1.確定httpd服務有安裝

2.在Tomcat設定檔AJP協定的部分加上 URIEncoding="UTF-8"，以避免中文亂碼。\\
{{{
<Connector port="8009"
enableLookups="false" redirectPort="8443" protocol="AJP/1.3" URIEncoding="UTF-8" />
}}}

3.vim /etc/httpd/conf.d/proxy_ajp.conf 
{{{
ProxyPass /ir/ ajp://domainname:8009/ 
}}}
將domainname的部分換成ir主機\\

4.重新啟動httpd服務

!Q57. 可否自訂email給使用者的信函內容??%%(color:silver)(2011/06/24)%%

可以，但是截至RC4版並未提供可以設定的管理介面，必須手動於檔案中設定。\\
檔案位置：[DSPACE_HOME]/config/emails目錄下\\
{{{
register - 使用者註冊後發送的密碼設定信
change_password - 更改密碼信
feedback - 使用者回饋訊息通知信(管理者)　
internal_error - 系統內部錯誤通知信(管理者) 
job_complete - 後台背景批次處理工作完成通知信(管理者)
submit_archive -　單筆上傳成功進入系統通知信
submit_batch　- 整批上傳通知信
submit_reject - 審核不通過通知信
}}}
檔案內容主要參照語言設定檔，
所以%%(color:green)若欲更改內容，需要依@[]括號中的參數至語言檔中修改。%%\\
\\語言檔的修改方式請參見Q40。\\
\\
%%(color:green)注意事項：
* 非必要請勿更動email設定檔。
* 更改語言檔後，請重起web server方能生效。
* 更改部分請自行備份，於下版更新後需手動再修正一次。
%%

!!!__異常及錯誤__\\

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

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

\\(2)請檢查上傳之欄位標示是否正確（上傳檔案metadata的第一列）。若無此欄位名稱，則整批資料將無法上傳。
%%(color:red)
若要檢查系統整批上傳功能是否會正常運作，請先下載範例檔batch_example.zip測試。%%
若執行範例檔仍有問題，則為系統問題，請依下列方式檢查，或洽IR開發小組。\\
\\(3)由於系統採用背景Job排程式處理，系統會在有空時批次進行上傳工作，平均每筆資料約需耗時5-10秒進入系統。\\
   亦即若您上傳100筆資料，系統可能需花費500-1000秒全部處理完畢，請耐心等待，若處理完畢後您將會收到一封email通知。\\
　　若您過了很久仍未收到，可能是該工作執行有誤，且將可能導致後面的Job堵塞無法執行。\\
　　您可以到$DSPACE_HOME/todo這個資料夾裡觀看有沒有待做的Job，資料夾裡面每個檔案代表一個待做的Job（檔名為上傳時間）。
   若資料夾裡積了很多檔案未做，表示有異常現象，建議您可手動刪除工作檔案（可從第一個未做的Job開始刪），以清除有問題的工作。\\
　　清除後請先以範例檔案測試看看，若仍無反應，請重起tomcat，再重複測試看看。
\\(4)正常情況下，做完的Job會到$DSPACE_HOME/done這個資料夾中。


!Q7. 為什麼首頁上的「上傳/下載」排行沒有辦去出現資料？
先檢查系統裡是否有資料，若確定有資料存在，檢查{{dspace.cfg}}裡的{{dspace.url}}是否跟網站的URL相符。如安裝後的網址若為{{http://www.xxx.edu.tw/dspace}}請輸入包含{{/dspace}}的部份。若還是有問題，請連絡IR開發小組。
※資料上傳至出現於排行榜約需一天的時間。


!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問題)
此問題將在Beta3版解決。或請手動更新已安裝於系統中的[$webapps/[[$WEBROOT]]/jscript/ajax.js.jsp|http://ir.lib.ntu.edu.tw/attach/NTURInstallFAQ/ajax.js.jsp]檔案，再重起系統後，即可解決。


!Q12. 為什麼會出現mysql資料表寫不進去的錯誤訊息?
若您的網頁出現類似以下的錯誤訊息
{{{
javax.servlet.ServletException: Can't create/write to file 'x:\\xxxxxx\Temp\#sql_xxx.MYI (Errcode: 17)
.....
}}}
可能是mySQL跟常駐型防毒軟體相衝的問題%%(color:blue)(目前發現容易發生此情形的防毒軟體會McAfee)%%，防毒程式可能在檢查時會咬著.MYI檔，讓mySQL不能讀寫。

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

作法是修改my.ini檔，在〔mysqld〕那區加入：
{{{
tmpdir="C:/Program Files/MySQL/tmp/" 
}}}
把目錄改成想要的目錄，設定防毒軟體不檢查該目錄，重起mySQL即可。

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

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

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


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

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

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


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

通常是伺服器使用的記憶體不足的問題，以致系統能處理的檔案太小。若使用的伺服器為Tomcat，可設定環境變數CATALINA_OPTS為：
{{{
-Xms256m -Xmx1024m
}}}
-Xms為伺服器會使用的最低記憶體大小，-Xmx為伺服器能使用的最大記憶體大小，可自行因硬體設備而調整。設定環境變數後重起Tomcat即可。\\
(也可以視系統狀況設定更大的值)\\

另外，在dspace.cfg檔案中也可設定上傳檔案大小上限：
{{{
# Maximum size of uploaded files in bytes, negative setting will result in no limit being set
# 512Mb
upload.max = 536870912
}}}
但仍不是很建議一次上傳超過100MB大小的檔案，
執行時間可能會很久，也可能會影響系統效能。

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

更新方式：

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

%%(color:red)
(在下版release之前，必須手動更新，且請勿再做ant update，否則新更新的檔案會被覆蓋。)
%%

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

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

!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)時，顯示出來是用什麼方式來做排列的呢？
先按code排，再按社群名稱的ASCII CODE排。
# code: 可以自行編列單位代碼，但目前尚未完成介面，必須去資料庫設定(資料表:community、欄位:code)


!Q22. 為什麼我的系統檢索後分類的３個頁籤排版會亂掉？(Beta3版問題)
請下載[tab.css]檔案，置於[dspace_home]/tab下，覆蓋原有檔案即可。

!Q29. 使用者註冊完後，無法發送email給使用者，應如何處理？%%(color:silver)(2008/08/05)%%
可能有多個原因會引致此問題，若發生不能寄送email給註冊使用者，應先檢查email設定是否正常，郵件伺服器是否有限制ntur主機的郵件寄送權限，若所有設定皆正常，請查看是否以下原因引起問題：

__1. 於log檔出現：javax.mail.MessagingException: 501 Syntax: HELO hostname__\\
系統在寄送email時找不到ntur伺服器的主機名稱, 此問題比較容易發生於linux主機。\\
主機名稱設定方式因各版本而異，一般來說設定檔為/etc/hosts，加入伺服器名稱, 如下（若伺服器名稱為servername）:\\
{{{
127.0.0.1       localhost.localdomain   localhost   servername
}}}
此設定需要reload hostname或是重開機才能生效.

__2. 於log檔出現：javax.mail.NoSuchProviderException: smtp__\\

linux系統中可能安裝多套java,系統使用舊版的java套件(gcj-1.4.2),導致mail無法使用\\
解決方式: 執行以下範例指令,指定系統使用NTUR系統所提供的javamail.jar套件,而不要使用系統舊版本JAVA所提供的javamail.jar\\
(此為範例，jar檔所在路徑仍需視伺服器配置之實際狀況)
{{{
/usr/sbin/alternatives --install /usr/share/java/javamail.jar javamail /var/lib/tomcat5/webapps/[[$WEBROOT]]/WEB-INF/lib/mail.jar 4290
}}}

__3. 於log檔出現：javax.mail.MessagingException: Can't send command to SMTP host;
  nested exception is: javax.net.ssl.SSLHandshakeException: sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target
__\\

需先確認所使使用的mail server是否有採用TLS加密。java中需設定相信此加密的public key,tomcat才能正常與mail server溝通，若有採用TLS加密,請提供public key以進行設定\\
mail server採用TLS加密, java中需設定相信此加密的public key,tomcat才能正常與mail server溝通,已將key加入,指令為:
(此為範例，keystore所在路徑仍需視伺服器配置之實際狀況)\\
{{{
/usr/java/jdk1.5.0_22/bin/keytool -import -alias localhost -keystore /usr/java/jdk1.5.0_22/jre/lib/security/cacerts -file /etc/ssl/certs/ssl-cert-snakeoil.pem
}}}
若確定server並無使用TLS加密，系統中仍出現下列錯誤訊息，請下載[Email.class]\\
放到webapps/[[$WEBROOT]]/WEB-INF/classes/org/dspace/core 下\\ 
蓋掉原有的Email.class\\ 
重起系統後，請再測試是否解決問題

__4. 於log檔出現：com.sun.mail.smtp.SMTPSendFailedException: 501 Username and sender address mismatched
\\
若在dspace.cfg裡有設定寄送email的帳密, 在mail.from.address需設定相同的寄送帳號。
例如:
{{{
mail.server.username = library
mail.server.password = library
mail.from.address = library@xxx.xxx.xxx.xxx
}}}

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

更新方式： 

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

%%(color:red) 
(在下版release之前，必須手動更新，且請勿再做ant update，否則新更新的檔案會被覆蓋。) 
%% 


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

原因為系統中缺少[ant.jar|http://ir.org.tw/attach/NTURInstallFAQ/ant.jar]檔案，\\
請下載後放入安裝目錄下的lib資料夾，\\
再執行一次ant update，\\
重起tomcat或jboss即可。


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

通常是伺服器使用的記憶體不足的問題，以致系統能處理的檔案太小。
\\
若使用的伺服器為Tomcat，可設定環境變數CATALINA_OPTS為：
{{{
-Xms256m -Xmx1024m
}}}
若您是使用catalina.sh指令啟動tomcat系統，您可在catalina.sh檔案啟始段加上以下設定：
{{{
JAVA_OPTS="-Xms256m -Xmx2048m"
}}}
-Xms為伺服器會使用的最低記憶體大小，-Xmx為伺服器能使用的最大記憶體大小，可自行因硬體設備而調整。設定環境變數後重起Tomcat即可。\\
\\
%%(color:red)
若您是使用windows系統，請在$TOMCAT/bin目錄下執行tomcat5w.exe，於介面中的"Java tab"設定(如下圖)。若您設定的最大可用記憶體超過系統可允許的值，tomcat將無法重新啟動，請設小一點的值。
%%
[{Image src='memory_setting.jpg'}]

%%(color:green) 
最小可用之記憶體也不建議調得太大,以免影響系統中其他應用系統之使用。\\
最大可用記憶體也可以視系統狀況設定更大的值，但建議請勿超出系統記憶體容量的1/2。\\
例如系統有4G RAM，可設定-Xms256m -Xmx1024m)\\
但windows xp 32 單一支應用程式 所可以配置到的記憶體有 2G的限制,所以設定請小於2048M。\\ 
%%
\\
若您安裝的tomcat沒有catalina.bat或startup.bat或tomcat5w.ext，可依下列程序設定記憶體參數：
{{{
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. 為什麼線上人數一直很多，但似乎卻沒有這麼多人使用系統?　%%(color:silver)(2008/12/03)%%

系統線上人數之計算是辨認session的數量（並非登入之使用者），使用者連結網頁後即開起一個session，而一個session通常會維持2-3小時，若使用者離開瀏覽頁，系統session仍會存在。因此此計算方式僅為大約之計數，會有些許誤差的狀況。\\
另外，由於有spider會定期造訪，若欲避免計數spider之計數，請下載[spider安裝包|http://ir.org.tw/Wiki.jsp?page=%E4%B8%8B%E8%BC%89NTUR%E7%B3%BB%E7%B5%B1#section-_E4_B8_8B_E8_BC_89NTUR_E7_B3_BB_E7_B5_B1-Spider_E9_81_8E_E6_BF_BE_E5_8C_85]置於系統指定處，重起後可過濾部分spider。


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

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


!Q41. 網頁中某些部分為什麼會顯示%%(color:green)???xxx.xxx.xxxxx.xxx???%%之類的訊息？ %%(color:silver)(2009/04/09)%%

有下列二種可能的原因：

* 安裝新版後cache,請依Q38方式處理 
* 您定義在config檔裡的的欄位名稱未在語言檔中設定，建議您可暫時將名稱%%(color:green)xxx.xxx.xxxxx.xxx
%%
及欲出現的對應字串，自行加在語言檔中(方式請見Q40)，但請同時回報開發小組，以免在下版更新時，漏失您修改後的訊息。


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

若您使用LINUX系統，建議可以下載使用[系統狀態監控小程式|http://ir.org.tw/Wiki.jsp?page=%E4%B8%8B%E8%BC%89NTUR%E7%B3%BB%E7%B5%B1#section-_E4_B8_8B_E8_BC_89NTUR_E7_B3_BB_E7_B5_B1-_E7_B3_BB_E7_B5_B1_E7_8B_80_E6_85_8B_E7_9B_A3_E6_8E_A7_E8_BC_94_E5_8A_A9_E5_B0_8F_E7_A8_8B_E5_BC_8F_E5_83_85linux_E4_B8_BB_E6_A9_9F_E9_81_A9_E7_94_A8]。\\
若為windows系統，手動重起Tomcat或所使用之其他Web Container服務。

!Q50. 為什麼執行搜尋等動作後，畫面會一片空白?%%(color:silver)(2010/04/07)%%

可能是系統的索引檔案異常，導致相關動作產生錯誤。請重建索引，步驟如下：
\\
(1)停止tomcat服務
\\
(2)將[[DSPACE_HOME]]/search下的所有現有檔案刪除。
\\
(3)啟動tomcat服務
\\
(4)手動或以管理介面執行索引第二歩 
{{{
dsrun org.dspace.search.DSIndexer
}}}
建立索引需一段時間，建立的過程中可以進行查詢（但查詢結果要到索引建立完畢後，才會完整）


!Q51. 若整批上傳無法將含有中文檔名的檔案正常上傳至系統，該如何調整系統設定?%%(color:silver)(2010/06/04)%%

請調整系統之環境變數設定:
\\
方法1:(Linux主機適用)
\\請將tomcat啟動時之LANG參數設定為zh_TW,
\\\
\\方法2:\\
請設定tomcat啟動時之file.encoding參數 
若您是使用catalina.sh指令啟動tomcat系統，您可在catalina.sh檔案啟始段加上以下設定：
{{{
JAVA_OPTS=-Dfile.encoding=[big5/UTF8] %JAVA_OPTS%\\
}}}
設定值建議先設為big5試試看,若還是為亂碼請改用utf-8。\\
\\
若您是使用windows系統，請在$TOMCAT/bin目錄下執行tomcat5w.exe，於介面中的"Java tab"設定(如下圖)。
\\
設定完成後,請重啟系統測試。

[{Image src='fileencoding_setting.jpg'}]

!Q52. 若收到的系統通知信是問號或亂碼，應如何解決?%%(color:silver)(2010/07/02)%%

若您是使用Linux主機，可能會遭遇此現象，\\
請將系統locale環境變數設為zh-TW.big5後，再啟動tomcat container：
{{{
> export LANG=zh_TW.big5
> export LC_ALL=zh_TW.big5
}}}
設定完畢後，可以打
{{{
> locale
}}}
檢視是否有設定成功。\\
通常在更改完環境變數並重起系統後，email亂碼問題即可消除。


!Q53. 若觀察IR伺服器上的CPU使用率一直很高(高於80%)，應如何調整?%%(color:silver)(2010/07/21)%%

正常情況下，IR運行在JAVA平台上，會吃掉一定的系統資源。\\
但若系統規格已足夠，而java.exe程序仍持續耗費很高的系統資源，請試試以下方式：\\
\\
1. 若很久沒重起系統，請先重起系統看看。(tomcat)\\
\\
2. 若重起系統後，CPU還是馬上被吃掉很多資源，則：\\
請下載[MessageManager.class]\\ 
放到webapps/[[$WEBROOT]]/WEB-INF/classes/org/dspace/core 下\\ 
蓋掉原有的MessageManager.class\\ 
重起系統後，請觀察後續情況是否有改善 


!Q54. 系統突然很慢或沒有反應，該如何處理??%%(color:silver)(2010/12/13)%%

請在dspace.log或tomcat/logs中觀察是否該時間點有重覆出現下列錯誤訊息：\\
* %%(color:green)Too many connections%%

這是因為 mysql 預設的 connection 數量用完了(預設是100個), 瞬間 loading 過高最會發生
\\
解決方式:\\
1.用編輯器開啟:my.ini(windows)或my.cnf(linux) 中的 max_connections=100 參數, 將它改為 max_connections=300或更高\\
2. 存檔後重新啟動MySQL 服務
* %%(color:green)Too many open files%%
通常在linux主機中會發生，IR瞬間同時開啟的檔案個數超過系統預設。\\
解決方式:\\
以root身分修改file-max檔案(路徑通常在/proc/sys/fs下)，將數字調整到10000以上。


!Q55. Tomcat無法正常啟動，該如何處理??%%(color:silver)(2011/05/19)%%

狀況1：\\
請檢查Tomact的log檔，出現：\\
{{{
...
org.apache.catalina.core.StandardContext start
SEVERE: Error in dependencyCheck
java.util.jar.JarException: Section should start with a Name header: unexpected '^@'
...
}}}
請先確認Tomcat的jvm版本設定與主機java版本是否相符。