OpenKM 6.3 安裝及配置

OpenKM 是一個(gè)開源的電子文檔管理系統(tǒng) (DMS)，基于 Tomcat+J2EE+Ajax web (GWT)+Jackrabbit (lucene) 等技術(shù)開發(fā)，可以在線預(yù)覽Office、圖片、PDF等文檔。由于相關(guān)中文資料較少，本篇文章主要基于官方文檔和Wiki進(jìn)行安裝和配置。

1. 運(yùn)行環(huán)境

2. 準(zhǔn)備工作

2.1 安裝 jdk

OpenKM 僅能在 Java 1.8 環(huán)境中運(yùn)行
https://docs.openkm.com/kcenter/view/okm-6.3-com/hardware-and-software-requirements.html

2.2 安裝數(shù)據(jù)庫

由于 OpenKM 使用的是 Hibernate，所以可以支持 MySQL/PostgreSQL/Oracle/SQL server 等多種數(shù)據(jù)庫，這里使用 MySQL。

  1. 檢查數(shù)據(jù)庫引擎
show engines;

| InnoDB | DEFAULT | Supports transactions, row-level locking, and foreign keys  | YES | YES | YES |

如果查詢結(jié)果如上表示是 InnoDB；若不是，則需要修改 MySQL 配置文件 (C:\ProgramData\MySQL\MySQL Server 5.6\my.ini)
修改或添加：

default-storage-engine=INNODB
  1. 創(chuàng)建數(shù)據(jù)庫
    這里使用 root 用戶，不再創(chuàng)建新用戶
DROP DATABASE IF EXISTS okmdb;
CREATE DATABASE okmdb DEFAULT CHARACTER SET utf8 DEFAULT COLLATE utf8_bin;
GRANT ALL ON okmdb.* TO root@localhost WITH GRANT OPTION;

2.3 安裝 OpenOffice

選擇自定義


修改安裝路徑為C:\Program\OpenOffice4

2.4 安裝 SWFTools

修改安裝路徑為C:\Program\SWFTools

3. 安裝 OpenKM

  1. 將openkm-6.3.2-community-tomcat-bundle.zip內(nèi) tomcat 文件夾解壓到 D 盤根目錄并改名為 tomcatOpenKM；
    如果解壓遇到錯(cuò)誤，是因?yàn)?license 文件夾與 LICENSE 文件重名導(dǎo)致，保留 LICENSE 文件即可；

  2. 將D:\tomcatOpenKM\bin\win-x64中文件復(fù)制到D:\tomcatOpenKM\bin中 (如果操作系統(tǒng)為32位，則復(fù)制的文件來自D:\tomcatOpenKM\bin\win-x86文件夾)；

  3. 分別修改D:\tomcatOpenKM\bin中tomcat7.exe和tomcat7w.exe為tomcat7OpenKM.exe和tomcat7OpenKMw.exe；

  4. 打開D:\tomcatOpenKM\bin\service.bat，替換全部tomcat7為tomcat7OpenKM；

  5. 打開 cmd，切換目錄到D:\tomcatOpenKM\bin，

# 安裝 tomcat 服務(wù)；
service.bat install

# 修改 JVM 參數(shù)
tomcat7OpenKM //US//tomcat7OpenKM ++JvmOptions="-XX:+UseConcMarkSweepGC"
tomcat7OpenKM //US//tomcat7OpenKM ++JvmOptions="-Djava.awt.headless=true"
tomcat7OpenKM //US//tomcat7OpenKM ++JvmOptions="-Dlog4j.configuration=file:///%CATALINA_HOME%/conf/log4j.properties"
tomcat7OpenKM //US//tomcat7OpenKM ++JvmOptions="-Dfile.encoding=utf-8"
tomcat7OpenKM //US//tomcat7OpenKM ++JvmOptions="-Dmail.mime.ignoreunknownencoding=true"
  1. 不執(zhí)行修改 JVM 參數(shù)命令，也可以打開tomcat7OpenKMw.exe手動(dòng)修改；

    在 Java Options 中添加：
-XX:+UseConcMarkSweepGC
-Djava.awt.headless=true
-Dlog4j.configuration=file:///%CATALINA_HOME%/conf/log4j.properties
-Dfile.encoding=utf-8
-Dmail.mime.ignoreunknownencoding=true
  1. 添加 Path 環(huán)境變量D:\tomcatOpenKM\lib\sigar;D:\tomcatOpenKM\bin;

4. OpenKM 啟動(dòng)前配置

  1. 修改"D:\tomcatOpenKM\OpenKM.cfg" 
# hibernate 方言
hibernate.dialect=org.hibernate.dialect.MySQL5InnoDBDialect
# 當(dāng)為 create 時(shí)，啟動(dòng)服務(wù)會創(chuàng)建 OpenKM 所有數(shù)據(jù)庫表
# 啟動(dòng)后，OpenKM 會自動(dòng)修改該項(xiàng)為 none
hibernate.hbm2ddl=create

# Initial configuration - Windows
system.imagemagick.convert=D:/tomcatOpenKM/bin/convert.exe
# OpenOffice 安裝目錄
system.openoffice.path=C:/Program/OpenOffice4
# SWFTools 安裝目錄
system.swftools.pdf2swf=C:/Program/SWFTools/pdf2swf.exe -T 9 -f ${fileIn} -o ${fileOut}
  1. 修改"D:\tomcatOpenKM\conf\server.xml"中數(shù)據(jù)庫配置：
<Resource name="jdbc/OpenKMDS" auth="Container" type="javax.sql.DataSource"
    maxActive="100" maxIdle="30" maxWait="10000" validationQuery="select 1"
    username="root" password="123456" driverClassName="com.mysql.jdbc.Driver"
    url="jdbc:mysql://192.168.1.146:3306/okmdb?autoReconnect=true&amp;useUnicode=true&amp;characterEncoding=UTF8"/>

注意 validationQuery 中不要出現(xiàn)不存在的 table；

  1. 啟動(dòng) tomcatOpenKM 服務(wù)，日志在"D:\tomcatOpenKM\logs\catalina.log"中；
    如果出現(xiàn)Specified key was too long; max key length is 767 bytes錯(cuò)誤，修改 MySQL 配置文件添加innodb_large_prefix=on

  2. 當(dāng)日志出現(xiàn)以下內(nèi)容時(shí)，OpenKM已啟動(dòng)完成：

2018-08-11 10:00:19,035 [Thread-21] INFO  org.apache.coyote.http11.Http11AprProtocol- Stopping ProtocolHandler ["http-apr-0.0.0.0-80"]
2018-08-11 10:00:19,128 [Thread-21] INFO  org.apache.coyote.ajp.AjpAprProtocol- Stopping ProtocolHandler ["ajp-apr-127.0.0.1-8009"]
  1. 配置默認(rèn)擴(kuò)展：
INSERT INTO OKM_EXTENSION (EXT_UUID, EXT_NAME) VALUES ('808e7a42-2e73-470c-ba23-e4c9d5c3a0f4', 'Live Edit');
INSERT INTO OKM_EXTENSION (EXT_UUID, EXT_NAME) VALUES ('58392af6-2131-413b-b188-1851aa7b651c', 'HTML Editor 4');
INSERT INTO OKM_PROFILE_MSC_EXTENSION (PEX_ID, PEX_EXTENSION) VALUES (1, '808e7a42-2e73-470c-ba23-e4c9d5c3a0f4');
INSERT INTO OKM_PROFILE_MSC_EXTENSION (PEX_ID, PEX_EXTENSION) VALUES (1, '58392af6-2131-413b-b188-1851aa7b651c');

5. OpenKM 啟動(dòng)后配置

  1. 打開http://你的IP/OpenKM，管理員賬號 okmAdmin 密碼 admin，登錄；


    進(jìn)入 Administration -> Language，選擇漢化 sql 文件，點(diǎn)擊 Add new translation，退出后選擇 simplified Chinese 登錄即可使用漢化后的 OpenKM；

  2. 進(jìn)入 管理面板 -> Configuration


    修改system.openoffice.path為C:/Program/OpenOffice4，修改system.swftools.pdf2swf為C:/Program/SWFTools/pdf2swf.exe -T 9 -f ${fileIn} -o ${fileOut}；

  3. 默認(rèn)的字體很小，進(jìn)入 管理面板 -> Profiles，修改 Web skin 為 Medium font；


6. 文檔預(yù)覽效果




ps：若出現(xiàn)無法預(yù)覽，檢查瀏覽器是否啟用了 Flash


參考：
OpenKM KnowledgeCenter
https://docs.openkm.com/kcenter/view/okm-6.3-com
OpenKM Documentation
https://www.openkm.com/wiki/index.php/Main_Page

最后編輯于 ：
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成，瀏覽時(shí)請結(jié)合常識與多方信息審慎甄別。
平臺聲明：文章內(nèi)容（如有圖片或視頻亦包括在內(nèi)）由作者上傳并發(fā)布，文章內(nèi)容僅代表作者本人觀點(diǎn)，簡書系信息發(fā)布平臺，僅提供信息存儲服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

友情鏈接更多精彩內(nèi)容