OpenKM6.2.5的安裝和配置詳細過程（附啟動失敗原因）

繼上文“解決OpenKM啟動失敗的詳細歷程”過后，這幾天一直在使用OpenKM，OpenKM使用起來很簡單，但是一些相關配置什么的中文資料較少，且有的資料欠缺正確性，存在誤導性，下面就簡單將配置過程和使用功能介紹下，給自己也給大家以后用的時候有個正確的參考。

下面以最新版6.2.5為例進行介紹，不同版本的配置和使用可能有所出入，僅供參考。

 

1. 簡單介紹

①開源電子文檔管理系統，作為文檔版本控制系統來組織和共享文檔。
②基於Web界面（6以上版本基於Tomcat，6以下版本基於JBoss），可對文件進行共享，設置安全級別權限，審計和調查企業的文件和登記冊等等。可以通過名稱，內容，關鍵字等來搜索文檔。

③ 三個版本 ： Community ， Cloud ， Professional （ 版本對比 ），總體上說只有Community版是免費的，當然功能也最少，適合於一般使用；Professional版可適用一個月，功能最強大，當然也是最貴的；Cloud版是雲服務，按需收費，功能介於兩者之間。由於我用的比較簡單，因此使用的是Community版即可。

2. 安裝登錄

① 安 裝：建議去官網 下載 （目前最新版是 6.2.5 ），注意 安裝路徑不能有中文和空格（詳見：解決OpenKM啟動失敗的詳細歷程）。

② 登錄：
打開桌面的“Start OpenKM”圖標啟動Tomcat后，輸入“http://localhost:8080/OpenKM/”打開OpenKM登錄界面如下：



默認用戶名為okmAdmin，默認密碼為admin，登錄進去后首頁面如下：

③ 在線文檔： http:// wiki.openkm.com/index.php/Main_Page

所有的配置與使用都有在線文檔，如果有什么問題可以進行搜索找到相應解決方案。

3. 簡單配置

3.1 漢化

如果英語真的爛到無法接受或看到英語就頭疼的人，那么就漢化下吧，建議普通用戶使用原版英文版的，沒什么看不懂的單詞。

漢化方法：首先在http://wiki.openkm.com/index.php/Language_Packs下載中文包.sql文件，在管理員用戶登錄進入管理界面的語言項里面，將下載來的sql包添加進去，先瀏覽文件再add new translation，重啟openkm，登錄時選擇simplified chinese即可，如下圖所示：

3.2 配置文件預覽功能

這就需要安裝相應的預覽插件了，即swftool和openoffice（辦公插件）：

swftool下載地址：http://www.swftools.org/

openoffice下載地址：http://www.openoffice.org/zh-cn/

在管理界面中配置config相關選項：

（1）system.openoffice.path的值（value）為C:\\Program Files (x86)\\OpenOffice.org 3，如下：

（2）system.swftools.pdf2swf的值（value）為E:\\Program Files\\SWFTools\\pdf2swf -T 9 -f ${fileIn} -o ${fileOut}，如下：

注：黃色背景是相關軟件的安裝路徑，因人而異，大家改成自己的安裝路徑即可。

3.3 配置OpenKM的服務器地址

根據訪問地址也知道OpenKM的默認服務器地址為localhost，如果想要改成具體的地址以供外界訪問該怎么辦呢？這時就需要按如下方法修改：
（1）在OpenKM安裝路徑下的\tomcat\conf 目錄里找到server.xml文件，打開它，然后找到<Connector port="8080" address="0.0.0.0" protocol="HTTP/1.1"這一行；
（2）將address="0.0.0.0"改成你所需要的IP地址，如address="221.12.2.131"，然后保存即可。若需要改變端口號，可根據需要修改，其他不需要修改。

3.4 基於角色的權限管理

OpenKM的權限管理是基於角色的，可以控制用戶對文件的讀寫及可視，默認有兩個角色：ROLE_ADMIN和ROLE_USER，如果是管理員用戶其角色就是ROLE_ADMIN，,如果是普通用戶其角色就是ROLE_USER，可以添加角色、添加相應角色的用戶。

3.4.1 添加角色

進入管理界面中的“Users”選項，然后點擊右上角的“Role list”標簽進入如下界面：

點擊上面的“+”可以添加角色，也可以修改已有的角色，簡單的使用有默認的兩個角色就已足夠。

3.4.2 添加用戶

進入管理界面中的“Users”選項，然后點擊右上角的“User list”標簽（默認就是該界面）進入如下界面：

同樣可以點擊上面的“+”添加用戶，填寫相應的Id，密碼，所屬角色等，如下圖所示：

3.4.3 分配權限

對每個文件都可以設置相關的讀寫權限，每個文件下面都有一個“Security”列，如下圖所示：

可以針對整個角色（左邊的Role列）進行設置，也可以針對每個用戶（右邊的User列）進行設置，點擊Update后進入設置界面進行設置即可。

3.5  配置郵件服務器

OpenKM有時候需要發送郵件給用戶（例如修改了某個非常重要的文件，那么可以發送郵件通知想要通知的用戶，管理員和普通用戶都有權限開啟郵件通知功能），那么就必須檢查email配置是否正確，具體配置方法如下：

在OpenKM安裝路徑下的\tomcat\conf 目錄里找到server.xml文件，打開它，然后找到<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"這一行，

默認的郵件配置是這樣的：

<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"
            mail.smtp.host="localhost" mail.from="[e-mail]"/>

顯然這是沒有配置的，

修改\conf\server.xml文件：

<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"
    mail.smtp.auth="true"
    mail.smtp.host="smtp.163.com"
    mail.smtp.user="<username>"
    password="<password>"
    mail.smtp.from="<sender email>"
    mail.smtp.starttls.enable="true"/>

這是簡單的配置，更詳細的配置如下（以gmail為例）：

<Resource name="mail/OpenKM" auth="Container" type="javax.mail.Session"
    mail.transport.protocol="smtp"
    mail.smtp.auth="true"
    mail.smtp.host="smtp.gmail.com"
    mail.smtp.port="465"
    mail.smtp.user="<username>"
    password="<password>"
    mail.smtp.from="<sender email>"
    mail.smtp.quitwait="false"
    mail.smtp.starttls.enable="true"
    mail.smtp.socketFactory.class="javax.net.ssl.SSLSocketFactory"
    mail.debug="true"/>

如果Tomcat啟動錯誤的話請使用參數 mail.smtp.quitwait="false" 。

然后通過系統管理界面的utilities選項的check email功能測試配置是否正確，如下圖所示：

如果正確，則相應配置各個用戶的email，具體配置方法及應用實例如下：

1. 點開管理界面的Users選項，如下可看Mail列，點擊后面的編輯，設置成相應用戶能接收消息的郵箱地址即可

注：這里有兩個問題需要注意：

（1）okmAdmin用戶的email最好與上面步驟在server.xml文件里設置的郵件服務器相同，如果不同也可以接收，但是其他用戶收到 郵件的發送方l地址就不是郵件服務器地址，而是在這里設置的地址，並標明是通過XXX（指郵件服務器地址的域名，如通過163.com發送）發送的，這樣 沒必要；

（2）大家應該注意到后面還有信封樣式的圖標，這也是設置，但我目前不知道這個設置是干嘛的，若誰知道希望不吝賜教。

2. 配置好了過后，我們來試試“郵件通知”這個功能，回到主桌面，隨便上傳個文件，然后右鍵試試其中的編輯功能Edit，這時會提示你下載編輯的文件到本地做修改，在本地修改完成后，在Update上去（文件名不能修改），這時會發現出現這樣一個界面：

開啟通知功能后，設置通知信息（郵件內容）及需要通知的用戶：

然后Upload即可，然后相關用戶就會收到你發送的郵件通知了，像下面這樣：

3.6. 文檔存在位置

在OpenKM安裝目錄下的tomcat下的repository文件夾里，如：E:\openkm-6.2.5-community\tomcat\repository，里面的datastore存儲了一些數據，不過都是媒體文件，不易讀，我們知道數據存放位置就好。

注：所有的配置完成需要重啟Start OpenKM（即重啟Tomcat）再登陸才能生效。

4. 簡單使用

配置好了過后，使用起來就非常的簡單了，就跟資源管理器差不多，這估計也是為什么選擇它的原因吧—使用簡單，具體使用方法就不廢話了，下面列舉一些我常用的功能吧（注意：OpenKM的功能不僅限於此）。

 

• 新建目錄、上傳單個文檔和壓縮文檔、預覽文件（Office、PDF等）；
• 修改文檔：必須選“Edit”后修改並鎖定，下載到本地編輯。在修改人未“Update”前，其他人無法修改此文檔，若取消修改即可；
• 版本控制：可以對已Update文件還原到歷史版本；
• 強大的搜索功能（若少於三個漢字需加空格）；
• 個人臨時文檔存放（My documents）：供臨時存放從公共文檔區復制到個人文檔區存放的必須的文檔。
• 重命名，復制，添加書簽，刪除(回收站)，上鎖、解鎖、下載等操作；
• 批量導入導出文件夾：管理員操作Repository import/export。
• ……
  

附：

如果你開啟不了Tomcat，顯示下列錯誤：
Error occurred during initialization of VM
Could not reserve enough space for object heap
……
如下圖所示：



那是因為你的JVM已經在其它地方開啟了還沒關閉，比如你當時打開了Eclipse，我的就是這種情況，關閉Eclipse再開啟OpenKM即可。此時再打開Eclipse也是沒有任何問題的。